创建账号（推荐） - CreateAccountV2
功能介绍
创建一个账号，不携带手机号邮箱联系方式，生成的账号将自动成为调用此接口的账号所属组织的成员。此操作只能由组织的管理账号调用。组织云服务将在新账号中创建所需的服务关联委托和账号访问委托。
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
- 如果使用身份策略授权，当前API调用无需身份策略权限。
URI
POST /v2/organizations/accounts
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Security-Token |
否 |
String |
如果正在使用临时安全凭据，则此header是必需的，该值是临时安全凭据的安全令牌（会话令牌）。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
name |
是 |
String |
账号名称。 |
|
agency_name |
否 |
String |
委托名称 |
|
description |
否 |
String |
描述信息。 |
|
tags |
否 |
Array of TagDto objects |
要绑定到新创建的账号的标签列表。 |
响应参数
状态码：202
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
create_account_status |
CreateAccountStatusDto object |
包含有关在组织中创建账号的CreateAccount请求的状态。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
account_id |
String |
如果账号创建成功，则为新账号的唯一标识符（ID）。 |
|
account_name |
String |
账号名称 |
|
completed_at |
String |
创建账号和完成请求的日期和时间。 |
|
created_at |
String |
请求创建账号的日期和时间。 |
|
id |
String |
请求的唯一标识符（ID）。您可以从创建账号的初始CreateAccount请求的响应中获得此值。 |
|
state |
String |
创建账号的异步请求的状态，in_progress：处理中，succeeded：成功，failed：失败。 |
|
failure_reason |
String |
error.1000 查询用户身份信息失败 error.2000 创建账号失败 error.2001 创建账号名称冲突 error.3000 创建资源账号失败 error.3001 手机号超过系统允许同手机号码注册账号的最大数量 error.4000 创建birth token失败 error.5000 创建服务关联委托失败 error.6000 创建委托失败 error.6001 查询权限信息失败 error.6002 绑定权限信息失败 error.7000 主子账号绑定财务委托关系失败 error.7001 实名认证数量超过最大限制 error.7002 查询主子账号绑定财务委托关系失败 error.0000 系统错误 |
|
failure_detail_msg |
failure_detail_msg object |
请求失败详细原因 |
请求示例
创建账号
POST https://{hostname}/v2/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 |
错误码
请参见错误码。
