创建账号
功能介绍
创建一个账号，生成的账号将自动成为调用此接口的账号所属组织的成员。此操作只能由组织的管理账号调用。组织云服务将在新账号中创建所需的服务关联委托和账号访问委托。
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
URI
POST /v1/organizations/accounts
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
X-Security-Token |
否 |
String |
如果正在使用临时安全凭据，则此header是必需的，该值是临时安全凭据的安全令牌（会话令牌）。 最小值：1 |
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
name |
是 |
String |
账号名称 最大长度：64 |
否 |
String |
邮箱 最小长度：1 最大长度：64 |
|
phone |
否 |
String |
手机号码 最小长度：1 最大长度：32 |
agency_name |
否 |
String |
委托名称 最小长度：1 最大长度：32 |
tags |
否 |
Array of TagDto objects |
要绑定到新创建的账号的标签列表。 |
响应参数
状态码： 202
参数 |
参数类型 |
描述 |
|---|---|---|
create_account_status |
CreateAccountStatusDto object |
包含有关在组织中创建账号的CreateAccount请求的状态。 |
参数 |
参数类型 |
描述 |
|---|---|---|
account_id |
String |
如果账号创建成功，则为新账号的唯一标识符（ID）。 最大长度：36 |
account_name |
String |
账号名称 最大长度：64 |
completed_at |
String |
创建账号和完成请求的日期和时间。 |
created_at |
String |
请求创建账号的日期和时间。 |
id |
String |
请求的唯一标识符（ID）。您可以从创建账号的初始CreateAccount请求的响应中获得此值。 最大长度：36 |
state |
String |
创建账号的异步请求的状态，in_progress：处理中，succeeded：成功，failed：失败。 最小长度：1 最大长度：64 |
failure_reason |
String |
如果请求失败，则说明失败原因。 |
请求示例
创建账号
POST https://{hostname}/v1/organizations/accounts
{
"name" : "C9Qzukfn6FIyxAmC3dQclrwZW34UDu_rPSRrCQ4aGFm0-r1zC2RDHt5oHA-aY21B",
"tags" : [ {
"key" : "keystring",
"value" : "valuestring"
} ]
}
响应示例
状态码： 202
Successful
{
"create_account_status" : {
"account_id" : "0a6d25d23900d45c0faac010e0fb4de0",
"account_name" : "paas_iam_573331",
"completed_at" : "2022-08-24T06:41:15Z",
"created_at" : "2022-08-24T06:41:15Z",
"id" : "h-awjp43m7bz3b8jgy5v61jrfwakt3og8w",
"state" : "in_progress",
"failure_reason" : "string"
}
}
状态码
状态码 |
描述 |
|---|---|
202 |
Successful |
错误码
请参见错误码。
