调用EnrollAccount API注册新账号或纳管已有账号-云治理中心-阿里云-云治理中心(CGC)-阿里云帮助中心

通过账号工厂创建一个新的资源账号或者纳管一个已有的资源账号。

接口说明

通过该 API，您可以创建一个新的资源账号或者纳管一个已有的资源账号，并在该账号上应用账号基线。

注册账号是一个异步过程，创建完资源账号后，会在该账号上实施账号工厂基线。您可以通过 GetEnrolledAccount 查询账号详情，获取实施结果。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

governance:EnrollAccount

create

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
AccountNamePrefix	string	否	账号名称前缀。如果是新建资源账号，则该参数必填。如果是注册应用到已有账号，则该参数不需要填写。	test-account
DisplayName	string	否	账号显示名称。如果是新建资源账号，则该参数必填。如果是注册应用到已有账号，则该参数不需要填写。	test-account
FolderId	string	否	父资源夹 ID。如果是新建资源账号，该参数不填，则默认创建在 Root 资源夹下。如果是注册应用到已有账号，则该参数不需要填写。	fd-5ESoku****
PayerAccountUid	integer	否	结算账号 ID。如果是新建资源账号，该参数不填，则默认为自主结算。如果是注册应用到已有账号，则该参数不需要填写。	19534534552****
AccountUid	integer	否	注册账号 ID。如果是新建资源账号，则该参数不需要填写。如果是注册应用到已有账号，则该参数必填。	12868156179****
BaselineItems	array<object>	否	基线项配置数组。如果传递了该参数，那么基线项的配置将和指定账号基线进行合并。相同的基线项将以该参数的配置为准。建议您将该参数置空，通过`BaselineId`参数指定账号基线，通过现有基线将配置应用到账号上。
	object	否	基线项配置。
Config	string	否	基线项配置。	{\"Notifications\":[{\"GroupKey\":\"account_msg\",\"Contacts\":[{\"Name\":\"aa\"}],\"PmsgStatus\":1,\"EmailStatus\":1,\"SmsStatus\":1}]}
Name	string	否	基线项名称。	ACS-BP_ACCOUNT_FACTORY_VPC
Skip	boolean	否	是否跳过基线项。取值： false：不跳过。 true：跳过。	false
Version	string	否	基线项版本。	1.0
BaselineId	string	否	基线 ID。置空则默认使用系统默认基线。	afb-bp1durvn3lgqe28v****
ResellAccountType	string	否	成员的身份类型。取值： resell（默认值）：分销账号。创建的成员将自动与您的分销商建立分销关系，同时您需要使用管理账号为新成员付款。 non_resell：非分销账号。创建的成员为阿里云普通账号，与您当前的分销商无关联关系，该账号直接从阿里云购买资源，需自主付款。说明该参数仅支持国际站分销客户。	resell
RegionId	string	否	地域 ID。	cn-hangzhou
Tag	array<object>	否	标签列表，最多包含 20 个子项。
	object	否	标签列表。
Key	string	否	标签键。	tagKey
Value	string	否	标签值。	tagValue

返回参数

名称	类型	描述	示例值
	object	返回参数。
AccountUid	integer	注册账号 ID。	143165363236****
RequestId	string	请求 ID。	7071E5FA-515E-5F53-B335-B87D619C6A66

示例

正常返回示例

JSON格式

{
  "AccountUid": 0,
  "RequestId": "7071E5FA-515E-5F53-B335-B87D619C6A66"
}

错误码

HTTP status code	错误码	错误信息	描述
400	InvalidParameter	The specified parameter %s is not valid.	您的请求中存在参数缺失或者参数无效。
400	DeployConflict.Blueprint	The %s blueprint is being deployed. Please wait for its deployment to complete and try again.	您有正在实施的蓝图，请等待其实施完成后重试。
400	DependencyViolation.Blueprint	The %s blueprint has not been deployed. Please deploy the resource structure first.	您还没有实施相关依赖的蓝图，请先完成依赖蓝图的实施。
400	DependencyViolation.BaselineItem	The dependency of %s baseline item has not been configured. Please config %s first.	您还没有配置相关依赖的基线项，请先完成依赖基线项的配置。
400	IncorrectBlueprintStatus	The current status of the blueprint does not support this operation.	蓝图当前状态不支持该操作，请稍后重试。
500	InternalError	A system error occurred.	系统错误。
403	InvalidUser.NotResourceDirectoryMaster	The specified account is not a master account of resource directory.	当前账号必须是资源目录的管理账号。
404	InvalidUser.NotFound	The specified user does not exist.	用户不存在。
404	InvalidBlueprint.NotFound	The specified blueprint does not exist.	蓝图实例不存在。
404	InvalidBaselineItem.NotFound	The specified baseline item named %s does not exist.	指定的基线项不存在。
404	InvalidEnterpriseRealName.NotFound	The specified account has not passed enterprise real name verification. Please complete the verification for the account first.	当前账号未进行企业实名认证，请您先完成企业实名认证。

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。