AcceptPrimaryEmailUpdate - AWS 账户管理
请求语法URI 请求参数请求体响应语法响应元素错误另请参阅

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

AcceptPrimaryEmailUpdate

接受来自StartPrimaryEmailUpdate的更新指定账户的主电子邮件地址（也称为 root 用户电子邮件地址）的请求。

请求语法

POST /acceptPrimaryEmailUpdate HTTP/1.1
Content-type: application/json

{
   "AccountId": "string",
   "Otp": "string",
   "PrimaryEmail": "string"
}

URI 请求参数

该请求不使用任何 URI 参数。

请求体

请求接受采用 JSON 格式的以下数据。

AccountId

指定您要通过此操作访问或修改 AWS 账户 的 12 位帐户 ID 号。要使用此参数，来电者必须是组织管理账户中的身份或委派的管理员账户。指定的账户 ID 必须是同一组织中的成员账户。组织必须启用所有功能，组织必须为账户管理服务启用可信访问权限，并可选择分配委派管理员帐户。

该操作只能从成员账号的管理账号或组织的委托管理员账号中调用。

注意

管理账户无法指定自己的账户AccountId。

类型：字符串

模式：^\d{12}$

必需：是

Otp

在 StartPrimaryEmailUpdate API 调用中发送到PrimaryEmail指定的 OTP 代码。

类型：字符串

模式：^[a-zA-Z0-9]{6}$

必需：是

PrimaryEmail

用于指定账户的新主电子邮件地址。这必须与 StartPrimaryEmailUpdate API 调用PrimaryEmail中的相匹配。

类型：字符串

长度限制：最小长度为 5。长度上限为 64。

必需：是

响应语法

HTTP/1.1 200
Content-type: application/json

{
   "Status": "string"
}

响应元素

如果此操作成功，则该服务将会发送回 HTTP 200 响应。

服务以 JSON 格式返回以下数据。

Status

检索已接受的主电子邮件更新请求的状态。

类型：字符串

有效值：PENDING | ACCEPTED

错误

有关所有操作的常见错误的信息，请参阅常见错误。

AccessDeniedException

操作失败，因为主叫身份没有所需的最低权限。

HTTP 状态代码：403

ConflictException

由于资源的当前状态存在冲突，无法处理该请求。例如，如果您尝试启用当前处于禁用状态（处于禁用状态）的区域，或者您尝试将账户的 root 用户电子邮件地址更改为已在使用的电子邮件地址，则会发生这种情况。

HTTP 状态代码：409

InternalServerException

由于内部错误，操作失败 AWS。请稍后重试您的操作。

HTTP 状态代码：500

ResourceNotFoundException

操作失败，因为它指定了找不到的资源。

HTTP 状态代码：404

TooManyRequestsException

该操作失败，因为调用频率过高且超过了油门限制。

HTTP 状态代码：429

ValidationException

操作失败，因为其中一个输入参数无效。

HTTP 状态代码：400

另请参阅

有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容：