更新时间:2026-07-07 GMT+08:00
分享

校验DB账号 - AccountVerify

功能介绍

此接口用于校验DB账号

调用方法

请参见如何调用API。

URI

POST /v4/passwd/legality

请求参数

表1 请求Body参数

参数

是否必选

参数类型

描述

accountDescription

否

String

账号描述

accountName

否

String

账号名称

accountStatus

否

Integer

账号状态

accountType

否

Integer

账号类型

osAccountSshConfig

否

Array of osAccountSshConfig objects

SSH配置对象

complexityId

否

String

复杂度ID

componentId

否

String

组件ID

componentName

否

String

组件名称

deviceId

否

String

设备ID

groups

否

Array of strings

用户组列表

id

否

String

账号ID

ip

否

String

IP地址

lastPasswdChange

否

Long

上次密码变更时间

operationType

否

Long

操作类型

passwdExpires

否

Long

密码过期时间

passwdNew

否

String

新密码

region

否

String

区域

registerStatus

否

Long

注册状态

relativeAccount

否

Array of Map<String,> objects

关联账号列表

status

否

Integer

状态

subComponentName

否

String

子组件名称

urlValid

否

String

URL有效性

usedScene

否

String

使用场景

visible

否

Integer

可见性

表2 osAccountSshConfig

参数

是否必选

参数类型

描述

isSupportSshLogin

否

Boolean

是否支持SSH登录

switchFrom

否

String

切换来源

switchCommand

否

String

切换命令

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

resultCode

String

结果码,00000000 表示成功,00000001 表示失败

errMsg

String

结果信息,SUCCESS 表示成功,FAILED 表示失败

状态码:400

表4 响应Body参数

参数

参数类型

描述

error_code

String

参数解释

接口调用失败错误码

取值范围

不涉及

error_msg

String

参数解释

接口调用失败错误信息

取值范围

不涉及

状态码:500

表5 响应Body参数

参数

参数类型

描述

error_code

String

参数解释

接口调用失败错误码

取值范围

不涉及

error_msg

String

参数解释

接口调用失败错误信息

取值范围

不涉及

请求示例

校验DB账号

POST https://{endpoint}/v4/passwd/legality

{
  "accountDescription" : "测试账号",
  "accountName" : "test_user",
  "accountStatus" : 1,
  "accountType" : 1,
  "osAccountSshConfig" : {
    "isSupportSshLogin" : true,
    "switchFrom" : "root",
    "switchCommand" : "su - test_user"
  },
  "complexityId" : "complex_001",
  "componentId" : "comp_001",
  "componentName" : "组件A",
  "deviceId" : "dev_001",
  "groups" : [ "group1", "group2" ],
  "id" : "001",
  "ip" : "192.168.1.100",
  "lastPasswdChange" : 1719100000000,
  "operationType" : 1,
  "passwdExpires" : 1721700000000,
  "passwdNew" : "Passw0rd!@#",
  "region" : "cn-north-1",
  "registerStatus" : 1,
  "relativeAccount" : [ {
    "accountName" : "rel_user",
    "accountStatus" : 1,
    "passwdNew" : "RelPass0rd!@#",
    "id" : "002"
  } ],
  "status" : 1,
  "subComponentName" : "子组件A",
  "urlValid" : "true",
  "usedScene" : "production",
  "visible" : 1
}

响应示例

状态码:200

OK

{
  "resultCode" : "00000000",
  "errMsg" : "SUCCESS"
}

状态码:400

Bad Request

{
  "error_code" : "CLOUDTEST.00000001",
  "error_msg" : "返回的错误信息"
}

状态码:500

Internal Server Error

{
  "error_code" : "CLOUDTEST.00000001",
  "error_msg" : "返回的错误信息"
}

状态码

状态码

描述

200

OK

400

Bad Request

500

Internal Server Error

错误码

请参见错误码。

相关文档