创建账号（推荐） - CreateAccountV2

功能介绍

创建一个账号，不携带手机号邮箱联系方式，生成的账号将自动成为调用此接口的账号所属组织的成员。此操作只能由组织的管理账号调用。组织云服务将在新账号中创建所需的服务关联委托和账号访问委托。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

如果使用角色与策略授权，具体权限要求请参见权限和授权项。
如果使用身份策略授权，当前API调用无需身份策略权限。

URI

POST /v2/organizations/accounts

请求参数

表1 请求Header参数
参数	是否必选	参数类型	描述
X-Security-Token	否	String	如果正在使用临时安全凭据，则此header是必需的，该值是临时安全凭据的安全令牌（会话令牌）。

表2 请求Body参数
参数	是否必选	参数类型	描述
name	是	String	账号名称。
agency_name	否	String	委托名称
description	否	String	描述信息。
tags	否	Array of TagDto objects	要绑定到新创建的账号的标签列表。

表3 TagDto
参数	是否必选	参数类型	描述
key	是	String	标签键的密钥标识符或名称。
value	是	String	与标签键关联的字符串值。您可以将标签的值设置为空字符串，但不能将标签的值设置为NULL。

响应参数

状态码：202

表4 响应Body参数
参数	参数类型	描述
create_account_status	CreateAccountStatusDto object	包含有关在组织中创建账号的CreateAccount请求的状态。

表5 CreateAccountStatusDto
参数	参数类型	描述
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	请求失败详细原因

表6 failure_detail_msg
参数	参数类型	描述
error_msg	String	透传错误码
encoded_authorization_message	String	透传鉴权失败信息

请求示例

创建账号

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"
  }
}