本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。 # API 参考账户管理 (`account`) 命名空间中的 API 操作允许您修改自己的 AWS 账户。每个都 AWS 账户支持包含账户信息的元数据，包括最多三个与该账户关联的备用联系人的信息。除此之外，还有与账户的[根用户](root-user.md)关联的电子邮件地址。您只能从与账户关联的以下联系人类型中指定一个类型。 + 账单联系人 + 操作联系人 + 安全联系人默认情况下，本指南中所述的 API 操作直接适用于调用此操作的账户。操作调用账户中的[身份](https://docs.aws.amazon.com/IAM/latest/UserGuide/id.html)通常是 IAM 角色或 IAM 用户，它必须拥有 IAM 策略应用的权限才能调用 API 操作。或者，您可以从 AWS Organizations 管理账户中的身份调用这些 API 操作 AWS 账户，并为任何组织成员指定账户 ID 号。 **API 版本** 本版《账户 API 参考》记录了 2021-02-01 版的账户管理 API。 **注意** 除了直接使用 API 之外，您还可以使用其中一个，它包含适用于各种编程语言和平台（Java AWS SDKs、Ruby、.NET、iOS、Android 等）的库和示例代码。它们 SDKs 提供了一种便捷的方式来创建对 Organizations 的编程 AWS 访问权限。例如，负责对请求 SDKs 进行加密签名、管理错误和自动重试请求。有关（包括如何下载和安装它们）的更多信息 AWS SDKs，请参阅[适用于 Amazon Web Services 的工具](https://console.aws.amazon.com/)。我们建议您使用 AWS SDKs 对账户管理服务进行编程 API 调用。但是，您也可以使用账户管理查询 API 直接调用账户管理的 Web 服务。要了解有关账户管理查询 API 的更多信息，请参阅《账户管理用户指南》中的 [通过提出 HTTP 查询请求来调用 API](query-requests.md)。组织支持所有操作的 GET 和 POST 请求。也就是说，API 不要求您使用某些操作的 GET 请求和其他操作的 POST 请求。然而，GET 请求受 URL 的大小限制。因此，对于需要更大规模的操作，请使用 POST 请求。 **签署请求** 向发送 HTTP 请求时 AWS，必须对请求进行签名，这样 AWS 才能识别谁发送了这些请求。您可以使用访问密钥（由 AWS 访问密钥 ID 和私有访问密钥组成）签署请求。我们强烈建议您不要为根账户创建访问密钥。拥有您的根账户的访问密钥的任何人都可以无限制地访问您账户中的所有资源。相反，应为具有管理权限的 IAM 用户创建访问密钥。另一种选择是，使用 AWS 安全令牌服务生成临时安全证书，然后使用这些证书签署请求。如需对请求进行签名，建议您使用签名版本 4。如果现有应用程序使用签名版本 2，则无需将其更新即可使用签名版本 4。但是，目前某些操作需要签名版本 4。需要版本 4 的操作的文档指出了这一要求。有关更多信息，请参阅 I *AM 用户指南*中的[签署 AWS API 请求](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-signing.html)。当您使用 AWS 命令行界面 (AWS CLI) 或其中一个 AWS SDKs 向其发出请求时 AWS，这些工具会自动使用您在配置工具时指定的访问密钥为您签署请求。 **对账户管理的支持和反馈** 我们欢迎您提供反馈。请将您的意见发送至 [feedback-awsaccounts@amazon.com](mailto://feedback-awsaccounts@amazon.com)，或将反馈和问题发布在[账户管理支持论坛](https://forums.aws.amazon.com/forum.jspa?forumID=219)上。有关 AWS 支持论坛的更多信息，请参阅[论坛帮助](https://forums.aws.amazon.com/help.jspa)。 **示例呈现方式** 作为对请求的响应，账户管理返回的 JSON 将以单个长字符串形式返回，不含换行符或格式化空格。为提高可读性，本指南中的示例同时显示了换行符和空格。当示例输入参数也会产生超出屏幕范围的长字符串时，我们会插入换行符以增强可读性。您应始终以单个 JSON 文本字符串的形式提交输入。 **记录 API 请求** 账户管理支持一项服务 CloudTrail，用于记录您 AWS 的 API 调用 AWS 账户并将日志文件传输到 Amazon S3 存储桶。通过使用收集的信息 CloudTrail，您可以确定哪些请求已成功向账户管理部门发出、谁发出了请求、何时发出等。有关账户管理及其支持的更多信息 CloudTrail，请参阅[使用记录 AWS 账户管理 API 调用 AWS CloudTrail](monitoring-cloudtrail.md)。要了解更多信息 CloudTrail，包括如何将其开启和查找日志文件，请参阅[AWS CloudTrail 用户指南](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/)。 # 操作支持以下操作： + [AcceptPrimaryEmailUpdate](API_AcceptPrimaryEmailUpdate.md) + [DeleteAlternateContact](API_DeleteAlternateContact.md) + [DisableRegion](API_DisableRegion.md) + [EnableRegion](API_EnableRegion.md) + [GetAccountInformation](API_GetAccountInformation.md) + [GetAlternateContact](API_GetAlternateContact.md) + [GetContactInformation](API_GetContactInformation.md) + [GetGovCloudAccountInformation](API_GetGovCloudAccountInformation.md) + [GetPrimaryEmail](API_GetPrimaryEmail.md) + [GetRegionOptStatus](API_GetRegionOptStatus.md) + [ListRegions](API_ListRegions.md) + [PutAccountName](API_PutAccountName.md) + [PutAlternateContact](API_PutAlternateContact.md) + [PutContactInformation](API_PutContactInformation.md) + [StartPrimaryEmailUpdate](API_StartPrimaryEmailUpdate.md) # AcceptPrimaryEmailUpdate 接受来自 [StartPrimaryEmailUpdate](API_StartPrimaryEmailUpdate.md) 的要求为指定账户更新主要电子邮件地址（也称为根用户电子邮件地址）的请求。 ## 请求语法 ``` POST /acceptPrimaryEmailUpdate HTTP/1.1 Content-type: application/json { "AccountId": "string", "Otp": "string", "PrimaryEmail": "string" } ``` ## URI 请求参数该请求不使用任何 URI 参数。 ## 请求正文请求接受采用 JSON 格式的以下数据。 ** [AccountId](#API_AcceptPrimaryEmailUpdate_RequestSyntax) ** 指定您要通过此操作访问或修改 AWS 账户的 12 位帐户 ID 号。要使用此参数，调用方必须具有[组织管理账户](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account)或委托管理员账户中的身份。指定账户 ID 必须是同一组织内的成员账户。组织必须[启用所有功能](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html)，且组织必须为账户管理服务启用[可信访问权限](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_integrate_services.html)，可选择分配[委托管理员](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin)账户。此操作只能由组织的管理账户或委托管理员账户为成员账户调用。管理账户无法指定自己的 `AccountId`。类型：字符串模式：`\d{12}` 是否必需：是 ** [Otp](#API_AcceptPrimaryEmailUpdate_RequestSyntax) ** 发送到 `StartPrimaryEmailUpdate` API 调用指定 `PrimaryEmail` 的 OTP 代码。类型：字符串模式：`[a-zA-Z0-9]{6}` 是否必需：是 ** [PrimaryEmail](#API_AcceptPrimaryEmailUpdate_RequestSyntax) ** 与指定账户一起使用的新的主要电子邮件地址。这必须与 `StartPrimaryEmailUpdate` API 调用中的 `PrimaryEmail` 一致。类型：字符串长度限制：最小长度为 5。长度上限为 64。是否必需：是 ## 响应语法 ``` HTTP/1.1 200 Content-type: application/json { "Status": "string" } ``` ## 响应元素如果此操作成功，则该服务将会发送回 HTTP 200 响应。服务以 JSON 格式返回以下数据。 ** [Status](#API_AcceptPrimaryEmailUpdate_ResponseSyntax) ** 检索已接受的主要电子邮件更新请求的状态。类型：字符串有效值：`PENDING | ACCEPTED` ## 错误有关所有操作的常见错误的信息，请参阅[常见错误类型](CommonErrors.md)。 ** AccessDeniedException ** 操作失败，调用身份没有所需的最低权限。 ** errorType ** API Gateway 填充到 `x-amzn-ErrorType` 响应标头的值。 HTTP 状态代码：403 ** ConflictException ** 由于资源的当前状态存在冲突，因此无法处理该请求。例如，如果尝试启用当前已禁用（处于“禁用”状态）的区域，或者尝试将账户的根用户电子邮件更改为已在使用的电子邮件地址，就会发生这种情况。 ** errorType ** API Gateway 填充到 `x-amzn-ErrorType` 响应标头的值。 HTTP 状态代码：409 ** InternalServerException ** 由于内部存在错误，操作失败 AWS。请稍后重新尝试操作。 ** errorType ** API Gateway 填充到 `x-amzn-ErrorType` 响应标头的值。 HTTP 状态代码：500 ** ResourceNotFoundException ** 操作失败，找不到指定的资源。 ** errorType ** API Gateway 填充到 `x-amzn-ErrorType` 响应标头的值。 HTTP 状态代码：404 ** TooManyRequestsException ** 操作失败，调用频率过高且超过了节流限制。 ** errorType ** API Gateway 填充到 `x-amzn-ErrorType` 响应标头的值。 HTTP 状态代码：429 ** ValidationException ** 操作失败，其中一个输入参数无效。 ** fieldList ** 检测到无效条目的字段。 ** message ** 通知您该请求中无效内容的消息。 ** reason ** 验证失败的原因。 HTTP 状态代码：400 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/AcceptPrimaryEmailUpdate) + [AWS 适用于.NET 的 SDK V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/AcceptPrimaryEmailUpdate) + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/AcceptPrimaryEmailUpdate) + [AWS 适用于 Go v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/AcceptPrimaryEmailUpdate) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/AcceptPrimaryEmailUpdate) + [AWS JavaScript V3 版软件开发工具包](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/AcceptPrimaryEmailUpdate) + [AWS 适用于 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/AcceptPrimaryEmailUpdate) + [AWS 适用于 PHP 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/AcceptPrimaryEmailUpdate) + [AWS Python 软件开发工具包](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/AcceptPrimaryEmailUpdate) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/AcceptPrimaryEmailUpdate) # DeleteAlternateContact 从中删除指定的备用联系人 AWS 账户。关于如何使用备用联系人操作的完整详细信息，请参阅[为您的 AWS 账户更新备用联系人](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-update-contact-alternate.html)。 **注意** 在更新由 AWS Organizations管理的备用联系人信息之前 AWS 账户，必须先启用 AWS 账户管理与 Organizations 之间的集成。有关更多信息，请参阅[对 AWS 账户管理启用可信的访问权限](https://docs.aws.amazon.com/accounts/latest/reference/using-orgs-trusted-access.html)。 ## 请求语法 ``` POST /deleteAlternateContact HTTP/1.1 Content-type: application/json { "AccountId": "string", "AlternateContactType": "string" } ``` ## URI 请求参数该请求不使用任何 URI 参数。 ## 请求正文请求接受采用 JSON 格式的以下数据。 ** [AccountId](#API_DeleteAlternateContact_RequestSyntax) ** 指定要通过此操作访问或修改的 AWS 账户的 12 位数账户 ID 号。如果未指定此参数，则默认为用于调用操作的身份的 AWS 帐户。要使用此参数，调用方必须具有[组织管理账户](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account)或委托管理员账户中的身份，并且指定的账户 ID 必须是同一组织中的成员账户。组织必须[启用所有功能](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html)，且组织必须为账户管理服务启用[可信访问权限](https://docs.aws.amazon.com/organizations/latest/userguide/services-that-can-integrate-account.html)，可选择分配[委托管理员](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin)账户。管理账户无法自行指定其 `AccountId`；它必须在不包括 `AccountId` 参数的情况下，在独立上下文中调用此操作。要对不是组织成员的账户调用此操作，不要指定此参数，请以属于要检索或修改其联系人的账户的身份调用此操作。类型：字符串模式：`\d{12}` 必需：否 ** [AlternateContactType](#API_DeleteAlternateContact_RequestSyntax) ** 指定要删除的备用联系人。类型：字符串有效值：`BILLING | OPERATIONS | SECURITY` 是否必需：是 ## 响应语法 ``` HTTP/1.1 200 ``` ## 响应元素如果此操作成功，则该服务会发送回带有空 HTTP 正文的 HTTP 200 响应。 ## 错误有关所有操作的常见错误的信息，请参阅[常见错误类型](CommonErrors.md)。 ** AccessDeniedException ** 操作失败，调用身份没有所需的最低权限。 ** errorType ** API Gateway 填充到 `x-amzn-ErrorType` 响应标头的值。 HTTP 状态代码：403 ** InternalServerException ** 由于内部存在错误，操作失败 AWS。请稍后重新尝试操作。 ** errorType ** API Gateway 填充到 `x-amzn-ErrorType` 响应标头的值。 HTTP 状态代码：500 ** ResourceNotFoundException ** 操作失败，找不到指定的资源。 ** errorType ** API Gateway 填充到 `x-amzn-ErrorType` 响应标头的值。 HTTP 状态代码：404 ** TooManyRequestsException ** 操作失败，调用频率过高且超过了节流限制。 ** errorType ** API Gateway 填充到 `x-amzn-ErrorType` 响应标头的值。 HTTP 状态代码：429 ** ValidationException ** 操作失败，其中一个输入参数无效。 ** fieldList ** 检测到无效条目的字段。 ** message ** 通知您该请求中无效内容的消息。 ** reason ** 验证失败的原因。 HTTP 状态代码：400 ## 示例 ### 示例 1 以下示例删除了其凭证用于调用操作的账户的安全备用联系人。 #### 示例请求 ``` POST / HTTP/1.1 X-Amz-Target: AWSAccountV20210201.DeleteAlternateContact { "AccountName":"MyAccount" } ``` #### 示例响应 ``` HTTP/1.1 200 OK Content-Type: application/json ``` ### 示例 2 以下示例删除了组织中指定成员账户的账单备用联系人。必须使用来自组织管理账户或账户管理服务的委托管理员账户的证书。 #### 示例请求 ``` POST / HTTP/1.1 X-Amz-Target: AWSAccountV20210201.DeleteAlternateContact { "AccountId":"123456789012", "AlternateContactType":"BILLING" } ``` #### 示例响应 ``` HTTP/1.1 200 OK Content-Type: application/json ``` ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/DeleteAlternateContact) + [AWS 适用于.NET 的 SDK V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/DeleteAlternateContact) + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/DeleteAlternateContact) + [AWS 适用于 Go v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/DeleteAlternateContact) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/DeleteAlternateContact) + [AWS JavaScript V3 版软件开发工具包](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/DeleteAlternateContact) + [AWS 适用于 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/DeleteAlternateContact) + [AWS 适用于 PHP 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/DeleteAlternateContact) + [AWS Python 软件开发工具包](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/DeleteAlternateContact) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/DeleteAlternateContact) # DisableRegion 禁用（选择退出）账户的特定区域。 **注意** 禁用区域的行为会移除对该区域内任何资源的所有 IAM 访问权限。 ## 请求语法 ``` POST /disableRegion HTTP/1.1 Content-type: application/json { "AccountId": "string", "RegionName": "string" } ``` ## URI 请求参数该请求不使用任何 URI 参数。 ## 请求正文请求接受采用 JSON 格式的以下数据。 ** [AccountId](#API_DisableRegion_RequestSyntax) ** 指定您要通过此操作访问或修改 AWS 账户的 12 位帐户 ID 号。如果未指定此参数，则默认为调用此操作使用的身份的亚马逊云科技账户。要使用此参数，调用方必须具有[组织管理账户](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account)或委托管理员账户中的身份。指定账户 ID 必须是同一组织内的成员账户。组织必须[启用所有功能](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html)，且组织必须为账户管理服务启用[可信访问权限](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_integrate_services.html)，可选择分配[委托管理员](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin)账户。管理账户无法指定自己的 `AccountId`。它必须在不包括 `AccountId` 参数的情况下，在独立上下文中调用此操作。要对不是组织成员的账户调用此操作，不要指定此参数。相反，请以属于要检索或修改其联系人的账户的身份调用此操作。类型：字符串模式：`\d{12}` 必需：否 ** [RegionName](#API_DisableRegion_RequestSyntax) ** 为给定区域名称指定区域代码（例如，`af-south-1`）。当您禁用某个区域时， AWS 会执行操作以在您的账户中停用该区域，例如销毁该区域中的 IAM 资源。对大多数账户而言，此过程需要几分钟时间，但也有可能要用数小时的时间。在禁用过程彻底完成之前，您无法启用该区域。类型：字符串长度限制：最小长度为 1。最大长度为 50。是否必需：是 ## 响应语法 ``` HTTP/1.1 200 ``` ## 响应元素如果此操作成功，则该服务会发送回带有空 HTTP 正文的 HTTP 200 响应。 ## 错误有关所有操作的常见错误的信息，请参阅[常见错误类型](CommonErrors.md)。 ** AccessDeniedException ** 操作失败，调用身份没有所需的最低权限。 ** errorType ** API Gateway 填充到 `x-amzn-ErrorType` 响应标头的值。 HTTP 状态代码：403 ** ConflictException ** 由于资源的当前状态存在冲突，因此无法处理该请求。例如，如果尝试启用当前已禁用（处于“禁用”状态）的区域，或者尝试将账户的根用户电子邮件更改为已在使用的电子邮件地址，就会发生这种情况。 ** errorType ** API Gateway 填充到 `x-amzn-ErrorType` 响应标头的值。 HTTP 状态代码：409 ** InternalServerException ** 由于内部存在错误，操作失败 AWS。请稍后重新尝试操作。 ** errorType ** API Gateway 填充到 `x-amzn-ErrorType` 响应标头的值。 HTTP 状态代码：500 ** TooManyRequestsException ** 操作失败，调用频率过高且超过了节流限制。 ** errorType ** API Gateway 填充到 `x-amzn-ErrorType` 响应标头的值。 HTTP 状态代码：429 ** ValidationException ** 操作失败，其中一个输入参数无效。 ** fieldList ** 检测到无效条目的字段。 ** message ** 通知您该请求中无效内容的消息。 ** reason ** 验证失败的原因。 HTTP 状态代码：400 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/DisableRegion) + [AWS 适用于.NET 的 SDK V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/DisableRegion) + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/DisableRegion) + [AWS 适用于 Go v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/DisableRegion) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/DisableRegion) + [AWS JavaScript V3 版软件开发工具包](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/DisableRegion) + [AWS 适用于 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/DisableRegion) + [AWS 适用于 PHP 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/DisableRegion) + [AWS Python 软件开发工具包](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/DisableRegion) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/DisableRegion) # EnableRegion 为账户启用（选择加入）特定区域。 ## 请求语法 ``` POST /enableRegion HTTP/1.1 Content-type: application/json { "AccountId": "string", "RegionName": "string" } ``` ## URI 请求参数该请求不使用任何 URI 参数。 ## 请求正文请求接受采用 JSON 格式的以下数据。 ** [AccountId](#API_EnableRegion_RequestSyntax) ** 指定您要通过此操作访问或修改 AWS 账户的 12 位帐户 ID 号。如果未指定此参数，则默认为调用此操作使用的身份的亚马逊云科技账户。要使用此参数，调用方必须具有[组织管理账户](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account)或委托管理员账户中的身份。指定账户 ID 必须是同一组织内的成员账户。组织必须[启用所有功能](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html)，且组织必须为账户管理服务启用[可信访问权限](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_integrate_services.html)，可选择分配[委托管理员](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin)账户。管理账户无法指定自己的 `AccountId`。它必须在不包括 `AccountId` 参数的情况下，在独立上下文中调用此操作。要对不是组织成员的账户调用此操作，不要指定此参数。相反，请以属于要检索或修改其联系人的账户的身份调用此操作。类型：字符串模式：`\d{12}` 必需：否 ** [RegionName](#API_EnableRegion_RequestSyntax) ** 为给定区域名称指定区域代码（例如，`af-south-1`）。在启用一个区域时， AWS 将执行操作以准备您在该区域内的账户，例如将您的 IAM 资源分发给该区域。对大多数账户而言，此过程需要几分钟时间，但也有可能要用数小时的时间。在此过程完成之前，您无法使用区域。此外，在启用过程彻底完成之前，您无法禁用该区域。类型：字符串长度限制：最小长度为 1。最大长度为 50。是否必需：是 ## 响应语法 ``` HTTP/1.1 200 ``` ## 响应元素如果此操作成功，则该服务会发送回带有空 HTTP 正文的 HTTP 200 响应。 ## 错误有关所有操作的常见错误的信息，请参阅[常见错误类型](CommonErrors.md)。 ** AccessDeniedException ** 操作失败，调用身份没有所需的最低权限。 ** errorType ** API Gateway 填充到 `x-amzn-ErrorType` 响应标头的值。 HTTP 状态代码：403 ** ConflictException ** 由于资源的当前状态存在冲突，因此无法处理该请求。例如，如果尝试启用当前已禁用（处于“禁用”状态）的区域，或者尝试将账户的根用户电子邮件更改为已在使用的电子邮件地址，就会发生这种情况。 ** errorType ** API Gateway 填充到 `x-amzn-ErrorType` 响应标头的值。 HTTP 状态代码：409 ** InternalServerException ** 由于内部存在错误，操作失败 AWS。请稍后重新尝试操作。 ** errorType ** API Gateway 填充到 `x-amzn-ErrorType` 响应标头的值。 HTTP 状态代码：500 ** TooManyRequestsException ** 操作失败，调用频率过高且超过了节流限制。 ** errorType ** API Gateway 填充到 `x-amzn-ErrorType` 响应标头的值。 HTTP 状态代码：429 ** ValidationException ** 操作失败，其中一个输入参数无效。 ** fieldList ** 检测到无效条目的字段。 ** message ** 通知您该请求中无效内容的消息。 ** reason ** 验证失败的原因。 HTTP 状态代码：400 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/EnableRegion) + [AWS 适用于.NET 的 SDK V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/EnableRegion) + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/EnableRegion) + [AWS 适用于 Go v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/EnableRegion) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/EnableRegion) + [AWS JavaScript V3 版软件开发工具包](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/EnableRegion) + [AWS 适用于 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/EnableRegion) + [AWS 适用于 PHP 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/EnableRegion) + [AWS Python 软件开发工具包](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/EnableRegion) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/EnableRegion) # GetAccountInformation 检索有关指定账户的信息，包括其账户名称、账户 ID 以及账户创建日期和时间。要使用此 API，IAM 用户必须拥有 `account:GetAccountInformation` IAM 权限。 ## 请求语法 ``` POST /getAccountInformation HTTP/1.1 Content-type: application/json { "AccountId": "string" } ``` ## URI 请求参数该请求不使用任何 URI 参数。 ## 请求正文请求接受采用 JSON 格式的以下数据。 ** [AccountId](#API_GetAccountInformation_RequestSyntax) ** 指定要通过此操作访问或修改的 AWS 账户的 12 位数账户 ID 号。如果未指定此参数，则默认为用于调用操作的身份的 AWS 帐户。要使用此参数，调用方必须具有[组织管理账户](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account)或委托管理员账户中的身份，并且指定的账户 ID 必须是同一组织中的成员账户。组织必须[启用所有功能](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html)，且组织必须为账户管理服务启用[可信访问权限](https://docs.aws.amazon.com/organizations/latest/userguide/services-that-can-integrate-account.html)，可选择分配[委托管理员](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin)账户。管理账户无法自行指定其 `AccountId`；它必须在不包括 `AccountId` 参数的情况下，在独立上下文中调用此操作。要对不是组织成员的账户调用此操作，不要指定此参数，请以属于要检索或修改其联系人的账户的身份调用此操作。类型：字符串模式：`\d{12}` 必需：否 ## 响应语法 ``` HTTP/1.1 200 Content-type: application/json { "AccountCreatedDate": "string", "AccountId": "string", "AccountName": "string" } ``` ## 响应元素如果此操作成功，则该服务将会发送回 HTTP 200 响应。服务以 JSON 格式返回以下数据。 ** [AccountCreatedDate](#API_GetAccountInformation_ResponseSyntax) ** 创建账户的日期和时间。类型：时间戳 ** [AccountId](#API_GetAccountInformation_ResponseSyntax) ** 指定您要通过此操作访问或修改 AWS 账户的 12 位帐户 ID 号。要使用此参数，调用方必须具有[组织管理账户](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account)或委托管理员账户中的身份。指定账户 ID 必须是同一组织内的成员账户。组织必须[启用所有功能](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html)，且组织必须为账户管理服务启用[可信访问权限](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_integrate_services.html)，可选择分配[委托管理员](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin)账户。此操作只能由组织的管理账户或委托管理员账户为成员账户调用。管理账户无法指定自己的 `AccountId`。类型：字符串模式：`\d{12}` ** [AccountName](#API_GetAccountInformation_ResponseSyntax) ** 账户的名称。类型：字符串长度限制：最小长度为 1。最大长度为 50。模式：`[ -;=?-~]+` ## 错误有关所有操作的常见错误的信息，请参阅[常见错误类型](CommonErrors.md)。 ** AccessDeniedException ** 操作失败，调用身份没有所需的最低权限。 ** errorType ** API Gateway 填充到 `x-amzn-ErrorType` 响应标头的值。 HTTP 状态代码：403 ** InternalServerException ** 由于内部存在错误，操作失败 AWS。请稍后重新尝试操作。 ** errorType ** API Gateway 填充到 `x-amzn-ErrorType` 响应标头的值。 HTTP 状态代码：500 ** TooManyRequestsException ** 操作失败，调用频率过高且超过了节流限制。 ** errorType ** API Gateway 填充到 `x-amzn-ErrorType` 响应标头的值。 HTTP 状态代码：429 ** ValidationException ** 操作失败，其中一个输入参数无效。 ** fieldList ** 检测到无效条目的字段。 ** message ** 通知您该请求中无效内容的消息。 ** reason ** 验证失败的原因。 HTTP 状态代码：400 ## 示例 ### 示例 1 以下示例检索其凭证用于调用操作的账户的账户信息。 #### 示例请求 ``` POST / HTTP/1.1 X-Amz-Target: AWSAccountV20210201.GetAccountInformation {} ``` #### 示例响应 ``` HTTP/1.1 200 OK Content-Type: application/json { "AccountId": "123456789012", "AccountName": "MyAccount", "AccountCreatedDate": "2020-11-30T17:44:37Z" } ``` ### 示例 2 以下示例检索了组织中指定成员账户的账户信息。必须使用来自组织管理账户或账户管理服务的委托管理员账户的证书。 #### 示例请求 ``` POST / HTTP/1.1 X-Amz-Target: AWSAccountV20210201.GetAccountInformation { "AccountId": "123456789012" } ``` #### 示例响应 ``` HTTP/1.1 200 OK Content-Type: application/json { "AccountId": "123456789012", "AccountName": "MyMemberAccount", "AccountCreatedDate": "2020-11-30T17:44:37Z" } ``` ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/GetAccountInformation) + [AWS 适用于.NET 的 SDK V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/GetAccountInformation) + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/GetAccountInformation) + [AWS 适用于 Go v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/GetAccountInformation) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/GetAccountInformation) + [AWS JavaScript V3 版软件开发工具包](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/GetAccountInformation) + [AWS 适用于 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/GetAccountInformation) + [AWS 适用于 PHP 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/GetAccountInformation) + [AWS Python 软件开发工具包](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/GetAccountInformation) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/GetAccountInformation) # GetAlternateContact 检索附加到的指定备用联系人。 AWS 账户关于如何使用备用联系人操作的完整详细信息，请参阅[为您的 AWS 账户更新备用联系人](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-update-contact-alternate.html)。 **注意** 在更新由 AWS Organizations管理的备用联系人信息之前 AWS 账户，必须先启用 AWS 账户管理与 Organizations 之间的集成。有关更多信息，请参阅[对 AWS 账户管理启用可信的访问权限](https://docs.aws.amazon.com/accounts/latest/reference/using-orgs-trusted-access.html)。 ## 请求语法 ``` POST /getAlternateContact HTTP/1.1 Content-type: application/json { "AccountId": "string", "AlternateContactType": "string" } ``` ## URI 请求参数该请求不使用任何 URI 参数。 ## 请求正文请求接受采用 JSON 格式的以下数据。 ** [AccountId](#API_GetAlternateContact_RequestSyntax) ** 指定要通过此操作访问或修改的 AWS 账户的 12 位数账户 ID 号。如果未指定此参数，则默认为用于调用操作的身份的 AWS 帐户。要使用此参数，调用方必须具有[组织管理账户](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account)或委托管理员账户中的身份，并且指定的账户 ID 必须是同一组织中的成员账户。组织必须[启用所有功能](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html)，且组织必须为账户管理服务启用[可信访问权限](https://docs.aws.amazon.com/organizations/latest/userguide/services-that-can-integrate-account.html)，可选择分配[委托管理员](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin)账户。管理账户无法自行指定其 `AccountId`；它必须在不包括 `AccountId` 参数的情况下，在独立上下文中调用此操作。要对不是组织成员的账户调用此操作，不要指定此参数，请以属于要检索或修改其联系人的账户的身份调用此操作。类型：字符串模式：`\d{12}` 必需：否 ** [AlternateContactType](#API_GetAlternateContact_RequestSyntax) ** 指定要检索的备用联系人。类型：字符串有效值：`BILLING | OPERATIONS | SECURITY` 是否必需：是 ## 响应语法 ``` HTTP/1.1 200 Content-type: application/json { "AlternateContact": { "AlternateContactType": "string", "EmailAddress": "string", "Name": "string", "PhoneNumber": "string", "Title": "string" } } ``` ## 响应元素如果此操作成功，则该服务将会发送回 HTTP 200 响应。服务以 JSON 格式返回以下数据。 ** [AlternateContact](#API_GetAlternateContact_ResponseSyntax) ** 包含指定备用联系人详细信息的结构。类型：[AlternateContact](API_AlternateContact.md) 对象 ## 错误有关所有操作的常见错误的信息，请参阅[常见错误类型](CommonErrors.md)。 ** AccessDeniedException ** 操作失败，调用身份没有所需的最低权限。 ** errorType ** API Gateway 填充到 `x-amzn-ErrorType` 响应标头的值。 HTTP 状态代码：403 ** InternalServerException ** 由于内部存在错误，操作失败 AWS。请稍后重新尝试操作。 ** errorType ** API Gateway 填充到 `x-amzn-ErrorType` 响应标头的值。 HTTP 状态代码：500 ** ResourceNotFoundException ** 操作失败，找不到指定的资源。 ** errorType ** API Gateway 填充到 `x-amzn-ErrorType` 响应标头的值。 HTTP 状态代码：404 ** TooManyRequestsException ** 操作失败，调用频率过高且超过了节流限制。 ** errorType ** API Gateway 填充到 `x-amzn-ErrorType` 响应标头的值。 HTTP 状态代码：429 ** ValidationException ** 操作失败，其中一个输入参数无效。 ** fieldList ** 检测到无效条目的字段。 ** message ** 通知您该请求中无效内容的消息。 ** reason ** 验证失败的原因。 HTTP 状态代码：400 ## 示例 ### 示例 1 以下示例检索其凭证用于调用操作的账户的安全备用联系人。 #### 示例请求 ``` POST / HTTP/1.1 X-Amz-Target: AWSAccountV20210201.GetAlternateContact { "AlternateContactType":"SECURITY" } ``` #### 示例响应 ``` HTTP/1.1 200 OK Content-Type: application/json { "AlternateContact":{ "Name":"Anika", "Title":"COO", "EmailAddress":"anika@example.com", "PhoneNumber":"206-555-0198", "AlternateContactType":"Security" } } ``` ### 示例 2 以下示例检索组织中指定成员账户的操作备用联系人。必须使用来自组织管理账户或账户管理服务的委托管理员账户的证书。 #### 示例请求 ``` POST / HTTP/1.1 X-Amz-Target: AWSAccountV20210201.GetAlternateContact { "AccountId":"123456789012", "AlternateContactType":"Operations" } ``` #### 示例响应 ``` HTTP/1.1 200 OK Content-Type: application/json { "AlternateContact":{ "Name":"Anika", "Title":"COO", "EmailAddress":"anika@example.com", "PhoneNumber":"206-555-0198", "AlternateContactType":"Operations" } } ``` ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/GetAlternateContact) + [AWS 适用于.NET 的 SDK V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/GetAlternateContact) + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/GetAlternateContact) + [AWS 适用于 Go v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/GetAlternateContact) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/GetAlternateContact) + [AWS JavaScript V3 版软件开发工具包](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/GetAlternateContact) + [AWS 适用于 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/GetAlternateContact) + [AWS 适用于 PHP 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/GetAlternateContact) + [AWS Python 软件开发工具包](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/GetAlternateContact) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/GetAlternateContact) # GetContactInformation 检索 AWS 账户的主要联系人信息。关于如何使用主要联系人操作的完整详细信息，请参阅[为您的 AWS 账户更新主要联系人](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-update-contact-primary.html)。 ## 请求语法 ``` POST /getContactInformation HTTP/1.1 Content-type: application/json { "AccountId": "string" } ``` ## URI 请求参数该请求不使用任何 URI 参数。 ## 请求正文请求接受采用 JSON 格式的以下数据。 ** [AccountId](#API_GetContactInformation_RequestSyntax) ** 指定您要通过此操作访问或修改 AWS 账户的 12 位帐户 ID 号。如果未指定此参数，则默认为调用此操作使用的身份的亚马逊云科技账户。要使用此参数，调用方必须具有[组织管理账户](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account)或委托管理员账户中的身份。指定账户 ID 必须是同一组织内的成员账户。组织必须[启用所有功能](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html)，且组织必须为账户管理服务启用[可信访问权限](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_integrate_services.html)，可选择分配[委托管理员](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin)账户。管理账户无法指定自己的 `AccountId`。它必须在不包括 `AccountId` 参数的情况下，在独立上下文中调用此操作。要对不是组织成员的账户调用此操作，不要指定此参数。相反，请以属于要检索或修改其联系人的账户的身份调用此操作。类型：字符串模式：`\d{12}` 必需：否 ## 响应语法 ``` HTTP/1.1 200 Content-type: application/json { "ContactInformation": { "AddressLine1": "string", "AddressLine2": "string", "AddressLine3": "string", "City": "string", "CompanyName": "string", "CountryCode": "string", "DistrictOrCounty": "string", "FullName": "string", "PhoneNumber": "string", "PostalCode": "string", "StateOrRegion": "string", "WebsiteUrl": "string" } } ``` ## 响应元素如果此操作成功，则该服务将会发送回 HTTP 200 响应。服务以 JSON 格式返回以下数据。 ** [ContactInformation](#API_GetContactInformation_ResponseSyntax) ** 包含与 AWS 账户相关的主要联系人信息的详细信息。类型：[ContactInformation](API_ContactInformation.md) 对象 ## 错误有关所有操作的常见错误的信息，请参阅[常见错误类型](CommonErrors.md)。 ** AccessDeniedException ** 操作失败，调用身份没有所需的最低权限。 ** errorType ** API Gateway 填充到 `x-amzn-ErrorType` 响应标头的值。 HTTP 状态代码：403 ** InternalServerException ** 由于内部存在错误，操作失败 AWS。请稍后重新尝试操作。 ** errorType ** API Gateway 填充到 `x-amzn-ErrorType` 响应标头的值。 HTTP 状态代码：500 ** ResourceNotFoundException ** 操作失败，找不到指定的资源。 ** errorType ** API Gateway 填充到 `x-amzn-ErrorType` 响应标头的值。 HTTP 状态代码：404 ** TooManyRequestsException ** 操作失败，调用频率过高且超过了节流限制。 ** errorType ** API Gateway 填充到 `x-amzn-ErrorType` 响应标头的值。 HTTP 状态代码：429 ** ValidationException ** 操作失败，其中一个输入参数无效。 ** fieldList ** 检测到无效条目的字段。 ** message ** 通知您该请求中无效内容的消息。 ** reason ** 验证失败的原因。 HTTP 状态代码：400 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/GetContactInformation) + [AWS 适用于.NET 的 SDK V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/GetContactInformation) + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/GetContactInformation) + [AWS 适用于 Go v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/GetContactInformation) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/GetContactInformation) + [AWS JavaScript V3 版软件开发工具包](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/GetContactInformation) + [AWS 适用于 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/GetContactInformation) + [AWS 适用于 PHP 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/GetContactInformation) + [AWS Python 软件开发工具包](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/GetContactInformation) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/GetContactInformation) # GetGovCloudAccountInformation 检索与指定标准 GovCloud 账户（如果存在）关联的账户的相关信息，包括 GovCloud 账户 ID 和状态。要使用此 API，IAM 用户必须拥有 `account:GetGovCloudAccountInformation` IAM 权限。 ## 请求语法 ``` POST /getGovCloudAccountInformation HTTP/1.1 Content-type: application/json { "StandardAccountId": "string" } ``` ## URI 请求参数该请求不使用任何 URI 参数。 ## 请求正文请求接受采用 JSON 格式的以下数据。 ** [StandardAccountId](#API_GetGovCloudAccountInformation_RequestSyntax) ** 指定要通过此操作访问或修改的 AWS 账户的 12 位数账户 ID 号。如果未指定此参数，则默认为用于调用操作的身份的 AWS 帐户。要使用此参数，调用方必须具有[组织管理账户](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account)或委托管理员账户中的身份，并且指定的账户 ID 必须是同一组织中的成员账户。组织必须[启用所有功能](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html)，且组织必须为账户管理服务启用[可信访问权限](https://docs.aws.amazon.com/organizations/latest/userguide/services-that-can-integrate-account.html)，可选择分配[委托管理员](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin)账户。管理账户无法自行指定其 `AccountId`；它必须在不包括 `AccountId` 参数的情况下，在独立上下文中调用此操作。要对不是组织成员的账户调用此操作，不要指定此参数，请以属于要检索或修改其联系人的账户的身份调用此操作。类型：字符串模式：`\d{12}` 必需：否 ## 响应语法 ``` HTTP/1.1 200 Content-type: application/json { "AccountState": "string", "GovCloudAccountId": "string" } ``` ## 响应元素如果此操作成功，则该服务将会发送回 HTTP 200 响应。服务以 JSON 格式返回以下数据。 ** [AccountState](#API_GetGovCloudAccountInformation_ResponseSyntax) ** 关联账户的 GovCloud 账户状态。类型：字符串有效值：`PENDING_ACTIVATION | ACTIVE | SUSPENDED | CLOSED` ** [GovCloudAccountId](#API_GetGovCloudAccountInformation_ResponseSyntax) ** 关联账户的 12 位数账户 ID GovCloud 号。类型：字符串模式：`\d{12}` ## 错误有关所有操作的常见错误的信息，请参阅[常见错误类型](CommonErrors.md)。 ** AccessDeniedException ** 操作失败，调用身份没有所需的最低权限。 ** errorType ** API Gateway 填充到 `x-amzn-ErrorType` 响应标头的值。 HTTP 状态代码：403 ** InternalServerException ** 由于内部存在错误，操作失败 AWS。请稍后重新尝试操作。 ** errorType ** API Gateway 填充到 `x-amzn-ErrorType` 响应标头的值。 HTTP 状态代码：500 ** ResourceNotFoundException ** 操作失败，找不到指定的资源。 ** errorType ** API Gateway 填充到 `x-amzn-ErrorType` 响应标头的值。 HTTP 状态代码：404 ** ResourceUnavailableException ** 操作失败，因为它指定的资源当前不可用。 ** errorType ** API Gateway 填充到 `x-amzn-ErrorType` 响应标头的值。 HTTP 状态代码：424 ** TooManyRequestsException ** 操作失败，调用频率过高且超过了节流限制。 ** errorType ** API Gateway 填充到 `x-amzn-ErrorType` 响应标头的值。 HTTP 状态代码：429 ** ValidationException ** 操作失败，其中一个输入参数无效。 ** fieldList ** 检测到无效条目的字段。 ** message ** 通知您该请求中无效内容的消息。 ** reason ** 验证失败的原因。 HTTP 状态代码：400 ## 示例 ### 示例 1 以下示例检索使用其凭证调用操作的账户的关联 GovCloud 账户信息。 #### 示例请求 ``` POST / HTTP/1.1 X-Amz-Target: AWSAccountV20210201.GetGovCloudAccountInformation {} ``` #### 示例响应 ``` HTTP/1.1 200 OK Content-Type: application/json { "GovCloudAccountId": "123456789012", "AccountState": "ACTIVE" } ``` ### 示例 2 以下示例检索组织中指定成员 GovCloud 账户的关联账户信息。必须使用来自组织管理账户或账户管理服务的委托管理员账户的证书。 #### 示例请求 ``` POST / HTTP/1.1 X-Amz-Target: AWSAccountV20210201.GetGovCloudAccountInformation { "StandardAccountId": "111111111111" } ``` #### 示例响应 ``` HTTP/1.1 200 OK Content-Type: application/json { "GovCloudAccountId": "123456789012", "AccountState": "ACTIVE" } ``` ### 示例 3 以下示例尝试检索未关联 GovCloud 账户的标准账户的关联 GovCloud 账户信息。 #### 示例请求 ``` POST / HTTP/1.1 X-Amz-Target: AWSAccountV20210201.GetGovCloudAccountInformation { "StandardAccountId": "222222222222" } ``` #### 示例响应 ``` HTTP/1.1 404 Content-Type: application/json { "message":"GovCloud Account ID not found for Standard Account - 222222222222." } ``` ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/GetGovCloudAccountInformation) + [AWS 适用于.NET 的 SDK V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/GetGovCloudAccountInformation) + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/GetGovCloudAccountInformation) + [AWS 适用于 Go v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/GetGovCloudAccountInformation) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/GetGovCloudAccountInformation) + [AWS JavaScript V3 版软件开发工具包](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/GetGovCloudAccountInformation) + [AWS 适用于 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/GetGovCloudAccountInformation) + [AWS 适用于 PHP 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/GetGovCloudAccountInformation) + [AWS Python 软件开发工具包](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/GetGovCloudAccountInformation) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/GetGovCloudAccountInformation) # GetPrimaryEmail 检索指定账户的主要电子邮件地址。 ## 请求语法 ``` POST /getPrimaryEmail HTTP/1.1 Content-type: application/json { "AccountId": "string" } ``` ## URI 请求参数该请求不使用任何 URI 参数。 ## 请求正文请求接受采用 JSON 格式的以下数据。 ** [AccountId](#API_GetPrimaryEmail_RequestSyntax) ** 指定您要通过此操作访问或修改 AWS 账户的 12 位帐户 ID 号。要使用此参数，调用方必须具有[组织管理账户](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account)或委托管理员账户中的身份。指定账户 ID 必须是同一组织内的成员账户。组织必须[启用所有功能](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html)，且组织必须为账户管理服务启用[可信访问权限](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_integrate_services.html)，可选择分配[委托管理员](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin)账户。此操作只能由组织的管理账户或委托管理员账户为成员账户调用。管理账户无法指定自己的 `AccountId`。类型：字符串模式：`\d{12}` 必需：是 ## 响应语法 ``` HTTP/1.1 200 Content-type: application/json { "PrimaryEmail": "string" } ``` ## 响应元素如果此操作成功，则该服务将会发送回 HTTP 200 响应。服务以 JSON 格式返回以下数据。 ** [PrimaryEmail](#API_GetPrimaryEmail_ResponseSyntax) ** 检索与指定账户关联的主要电子邮件地址。类型：字符串长度限制：最小长度为 5。长度上限为 64。 ## 错误有关所有操作的常见错误的信息，请参阅[常见错误类型](CommonErrors.md)。 ** AccessDeniedException ** 操作失败，调用身份没有所需的最低权限。 ** errorType ** API Gateway 填充到 `x-amzn-ErrorType` 响应标头的值。 HTTP 状态代码：403 ** InternalServerException ** 由于内部存在错误，操作失败 AWS。请稍后重新尝试操作。 ** errorType ** API Gateway 填充到 `x-amzn-ErrorType` 响应标头的值。 HTTP 状态代码：500 ** ResourceNotFoundException ** 操作失败，找不到指定的资源。 ** errorType ** API Gateway 填充到 `x-amzn-ErrorType` 响应标头的值。 HTTP 状态代码：404 ** TooManyRequestsException ** 操作失败，调用频率过高且超过了节流限制。 ** errorType ** API Gateway 填充到 `x-amzn-ErrorType` 响应标头的值。 HTTP 状态代码：429 ** ValidationException ** 操作失败，其中一个输入参数无效。 ** fieldList ** 检测到无效条目的字段。 ** message ** 通知您该请求中无效内容的消息。 ** reason ** 验证失败的原因。 HTTP 状态代码：400 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/GetPrimaryEmail) + [AWS 适用于.NET 的 SDK V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/GetPrimaryEmail) + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/GetPrimaryEmail) + [AWS 适用于 Go v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/GetPrimaryEmail) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/GetPrimaryEmail) + [AWS JavaScript V3 版软件开发工具包](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/GetPrimaryEmail) + [AWS 适用于 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/GetPrimaryEmail) + [AWS 适用于 PHP 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/GetPrimaryEmail) + [AWS Python 软件开发工具包](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/GetPrimaryEmail) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/GetPrimaryEmail) # GetRegionOptStatus 检索特定区域的选择加入状态。 ## 请求语法 ``` POST /getRegionOptStatus HTTP/1.1 Content-type: application/json { "AccountId": "string", "RegionName": "string" } ``` ## URI 请求参数该请求不使用任何 URI 参数。 ## 请求正文请求接受采用 JSON 格式的以下数据。 ** [AccountId](#API_GetRegionOptStatus_RequestSyntax) ** 指定您要通过此操作访问或修改 AWS 账户的 12 位帐户 ID 号。如果未指定此参数，则默认为调用此操作使用的身份的亚马逊云科技账户。要使用此参数，调用方必须具有[组织管理账户](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account)或委托管理员账户中的身份。指定账户 ID 必须是同一组织内的成员账户。组织必须[启用所有功能](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html)，且组织必须为账户管理服务启用[可信访问权限](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_integrate_services.html)，可选择分配[委托管理员](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin)账户。管理账户无法指定自己的 `AccountId`。它必须在不包括 `AccountId` 参数的情况下，在独立上下文中调用此操作。要对不是组织成员的账户调用此操作，不要指定此参数。相反，请以属于要检索或修改其联系人的账户的身份调用此操作。类型：字符串模式：`\d{12}` 必需：否 ** [RegionName](#API_GetRegionOptStatus_RequestSyntax) ** 为给定区域名称指定区域代码（例如，`af-south-1`）。此函数将返回您传递此参数的任何目标区域的状态。类型：字符串长度限制：最小长度为 1。最大长度为 50。是否必需：是 ## 响应语法 ``` HTTP/1.1 200 Content-type: application/json { "RegionName": "string", "RegionOptStatus": "string" } ``` ## 响应元素如果此操作成功，则该服务将会发送回 HTTP 200 响应。服务以 JSON 格式返回以下数据。 ** [RegionName](#API_GetRegionOptStatus_ResponseSyntax) ** 传入的区域代码。类型：字符串长度限制：最小长度为 1。最大长度为 50。 ** [RegionOptStatus](#API_GetRegionOptStatus_ResponseSyntax) ** 区域可能处于以下潜在状态之一（已启用、启用、已禁用、禁用、默认已启用）。类型：字符串有效值：`ENABLED | ENABLING | DISABLING | DISABLED | ENABLED_BY_DEFAULT` ## 错误有关所有操作的常见错误的信息，请参阅[常见错误类型](CommonErrors.md)。 ** AccessDeniedException ** 操作失败，调用身份没有所需的最低权限。 ** errorType ** API Gateway 填充到 `x-amzn-ErrorType` 响应标头的值。 HTTP 状态代码：403 ** InternalServerException ** 由于内部存在错误，操作失败 AWS。请稍后重新尝试操作。 ** errorType ** API Gateway 填充到 `x-amzn-ErrorType` 响应标头的值。 HTTP 状态代码：500 ** TooManyRequestsException ** 操作失败，调用频率过高且超过了节流限制。 ** errorType ** API Gateway 填充到 `x-amzn-ErrorType` 响应标头的值。 HTTP 状态代码：429 ** ValidationException ** 操作失败，其中一个输入参数无效。 ** fieldList ** 检测到无效条目的字段。 ** message ** 通知您该请求中无效内容的消息。 ** reason ** 验证失败的原因。 HTTP 状态代码：400 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/GetRegionOptStatus) + [AWS 适用于.NET 的 SDK V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/GetRegionOptStatus) + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/GetRegionOptStatus) + [AWS 适用于 Go v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/GetRegionOptStatus) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/GetRegionOptStatus) + [AWS JavaScript V3 版软件开发工具包](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/GetRegionOptStatus) + [AWS 适用于 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/GetRegionOptStatus) + [AWS 适用于 PHP 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/GetRegionOptStatus) + [AWS Python 软件开发工具包](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/GetRegionOptStatus) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/GetRegionOptStatus) # ListRegions 列出给定账户的所有区域及其各自的选择加入状态。也可以选择按 `region-opt-status-contains` 参数筛选此列表。 ## 请求语法 ``` POST /listRegions HTTP/1.1 Content-type: application/json { "AccountId": "string", "MaxResults": number, "NextToken": "string", "RegionOptStatusContains": [ "string" ] } ``` ## URI 请求参数该请求不使用任何 URI 参数。 ## 请求正文请求接受采用 JSON 格式的以下数据。 ** [AccountId](#API_ListRegions_RequestSyntax) ** 指定您要通过此操作访问或修改 AWS 账户的 12 位帐户 ID 号。如果未指定此参数，则默认为调用此操作使用的身份的亚马逊云科技账户。要使用此参数，调用方必须具有[组织管理账户](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account)或委托管理员账户中的身份。指定账户 ID 必须是同一组织内的成员账户。组织必须[启用所有功能](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html)，且组织必须为账户管理服务启用[可信访问权限](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_integrate_services.html)，可选择分配[委托管理员](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin)账户。管理账户无法指定自己的 `AccountId`。它必须在不包括 `AccountId` 参数的情况下，在独立上下文中调用此操作。要对不是组织成员的账户调用此操作，不要指定此参数。相反，请以属于要检索或修改其联系人的账户的身份调用此操作。类型：字符串模式：`\d{12}` 必需：否 ** [MaxResults](#API_ListRegions_RequestSyntax) ** 命令的输出中要返回的项目总数。如果可用的总项目数超过指定的值，则命令的输出中会提供 `NextToken`。要恢复分页，请在后续命令的 `starting-token` 参数中提供 `NextToken` 值。请勿直接在 AWS CLI 之外使用`NextToken`响应元素。有关用法示例，请参阅《* AWS 命令行界面用户指南》*中的[分页](https://docs.aws.amazon.com/cli/latest/userguide/pagination.html)。类型：整数有效范围：最小值为 1。最大值为 50。必需：否 ** [NextToken](#API_ListRegions_RequestSyntax) ** 用于指定从何处开始分页的令牌。这是先前截断的响应中的 `NextToken`。有关用法示例，请参阅《* AWS 命令行界面用户指南》*中的[分页](https://docs.aws.amazon.com/cli/latest/userguide/pagination.html)。类型：字符串长度限制：最小长度为 0。最大长度为 1000。必需：否 ** [RegionOptStatusContains](#API_ListRegions_RequestSyntax) ** 区域状态列表（启用、已启用、禁用、已禁用、默认已启用），用于筛选给定账户的区域列表。例如，传入值为“启用”时将仅返回区域状态为“启用”的区域列表。类型：字符串数组有效值：`ENABLED | ENABLING | DISABLING | DISABLED | ENABLED_BY_DEFAULT` 必需：否 ## 响应语法 ``` HTTP/1.1 200 Content-type: application/json { "NextToken": "string", "Regions": [ { "RegionName": "string", "RegionOptStatus": "string" } ] } ``` ## 响应元素如果此操作成功，则该服务将会发送回 HTTP 200 响应。服务以 JSON 格式返回以下数据。 ** [NextToken](#API_ListRegions_ResponseSyntax) ** 如果要返回更多数据，则会填充该数据。它应该传到的 `list-regions` 的请求参数 `next-token` 中。类型：字符串 ** [Regions](#API_ListRegions_ResponseSyntax) ** 这是给定账户的区域列表，或与 `filter` 参数中设置的筛选条件相匹配的区域列表（如果使用了筛选参数）。类型：[Region](API_Region.md) 对象数组 ## 错误有关所有操作的常见错误的信息，请参阅[常见错误类型](CommonErrors.md)。 ** AccessDeniedException ** 操作失败，调用身份没有所需的最低权限。 ** errorType ** API Gateway 填充到 `x-amzn-ErrorType` 响应标头的值。 HTTP 状态代码：403 ** InternalServerException ** 由于内部存在错误，操作失败 AWS。请稍后重新尝试操作。 ** errorType ** API Gateway 填充到 `x-amzn-ErrorType` 响应标头的值。 HTTP 状态代码：500 ** TooManyRequestsException ** 操作失败，调用频率过高且超过了节流限制。 ** errorType ** API Gateway 填充到 `x-amzn-ErrorType` 响应标头的值。 HTTP 状态代码：429 ** ValidationException ** 操作失败，其中一个输入参数无效。 ** fieldList ** 检测到无效条目的字段。 ** message ** 通知您该请求中无效内容的消息。 ** reason ** 验证失败的原因。 HTTP 状态代码：400 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/ListRegions) + [AWS 适用于.NET 的 SDK V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/ListRegions) + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/ListRegions) + [AWS 适用于 Go v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/ListRegions) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/ListRegions) + [AWS JavaScript V3 版软件开发工具包](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/ListRegions) + [AWS 适用于 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/ListRegions) + [AWS 适用于 PHP 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/ListRegions) + [AWS Python 软件开发工具包](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/ListRegions) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/ListRegions) # PutAccountName 更新指定账户的账户名称。要使用此 API，IAM 主体必须拥有 `account:PutAccountName` IAM 权限。 ## 请求语法 ``` POST /putAccountName HTTP/1.1 Content-type: application/json { "AccountId": "string", "AccountName": "string" } ``` ## URI 请求参数该请求不使用任何 URI 参数。 ## 请求正文请求接受采用 JSON 格式的以下数据。 ** [AccountId](#API_PutAccountName_RequestSyntax) ** 指定您要通过此操作访问或修改的 AWS 账户的 12 位数账户 ID 号。如果未指定此参数，则默认为用于调用操作的身份的 AWS 帐户。要使用此参数，调用方必须具有[组织管理账户](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account)或委托管理员账户中的身份，并且指定的账户 ID 必须是同一组织中的成员账户。组织必须[启用所有功能](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html)，且组织必须为账户管理服务启用[可信访问权限](https://docs.aws.amazon.com/organizations/latest/userguide/services-that-can-integrate-account.html)，可选择分配[委托管理员](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin)账户。管理账户无法自行指定其 `AccountId`；它必须在不包括 `AccountId` 参数的情况下，在独立上下文中调用此操作。要对不是组织成员的账户调用此操作，不要指定此参数，请以属于要检索或修改其联系人的账户的身份调用此操作。类型：字符串模式：`\d{12}` 必需：否 ** [AccountName](#API_PutAccountName_RequestSyntax) ** 账户的名称。类型：字符串长度限制：最小长度为 1。最大长度为 50。模式：`[ -;=?-~]+` 必需：是 ## 响应语法 ``` HTTP/1.1 200 ``` ## 响应元素如果此操作成功，则该服务会发送回带有空 HTTP 正文的 HTTP 200 响应。 ## 错误有关所有操作的常见错误的信息，请参阅[常见错误类型](CommonErrors.md)。 ** AccessDeniedException ** 操作失败，调用身份没有所需的最低权限。 ** errorType ** API Gateway 填充到 `x-amzn-ErrorType` 响应标头的值。 HTTP 状态代码：403 ** InternalServerException ** 由于内部存在错误，操作失败 AWS。请稍后重新尝试操作。 ** errorType ** API Gateway 填充到 `x-amzn-ErrorType` 响应标头的值。 HTTP 状态代码：500 ** TooManyRequestsException ** 操作失败，调用频率过高且超过了节流限制。 ** errorType ** API Gateway 填充到 `x-amzn-ErrorType` 响应标头的值。 HTTP 状态代码：429 ** ValidationException ** 操作失败，其中一个输入参数无效。 ** fieldList ** 检测到无效条目的字段。 ** message ** 通知您该请求中无效内容的消息。 ** reason ** 验证失败的原因。 HTTP 状态代码：400 ## 示例 ### 示例 1 以下示例为用于调用该操作的凭证所属账户更新名称。 #### 示例请求 ``` POST / HTTP/1.1 X-Amz-Target: AWSAccountV20210201.PutAccountName { "AccountName":"MyAccount" } ``` #### 示例响应 ``` HTTP/1.1 200 OK Content-Type: application/json ``` ### 示例 2 以下示例为组织中的指定成员账户更新账户名称。必须使用来自组织管理账户或账户管理服务的委托管理员账户的证书。 #### 示例请求 ``` POST / HTTP/1.1 X-Amz-Target: AWSAccountV20210201.PutAccountName { "AccountId": "123456789012", "AccountName": "MyMemberAccount" } ``` #### 示例响应 ``` HTTP/1.1 200 OK Content-Type: application/json ``` ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/PutAccountName) + [AWS 适用于.NET 的 SDK V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/PutAccountName) + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/PutAccountName) + [AWS 适用于 Go v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/PutAccountName) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/PutAccountName) + [AWS JavaScript V3 版软件开发工具包](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/PutAccountName) + [AWS 适用于 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/PutAccountName) + [AWS 适用于 PHP 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/PutAccountName) + [AWS Python 软件开发工具包](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/PutAccountName) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/PutAccountName) # PutAlternateContact 修改附加到的指定备用联系人。 AWS 账户关于如何使用备用联系人操作的完整详细信息，请参阅[为您的 AWS 账户更新备用联系人](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-update-contact-alternate.html)。 **注意** 在更新由 AWS Organizations管理的备用联系人信息之前 AWS 账户，必须先启用 AWS 账户管理与 Organizations 之间的集成。有关更多信息，请参阅[对 AWS 账户管理启用可信的访问权限](https://docs.aws.amazon.com/accounts/latest/reference/using-orgs-trusted-access.html)。 ## 请求语法 ``` POST /putAlternateContact HTTP/1.1 Content-type: application/json { "AccountId": "string", "AlternateContactType": "string", "EmailAddress": "string", "Name": "string", "PhoneNumber": "string", "Title": "string" } ``` ## URI 请求参数该请求不使用任何 URI 参数。 ## 请求正文请求接受采用 JSON 格式的以下数据。 ** [AccountId](#API_PutAlternateContact_RequestSyntax) ** 指定要通过此操作访问或修改的 AWS 账户的 12 位数账户 ID 号。如果未指定此参数，则默认为用于调用操作的身份的 AWS 帐户。要使用此参数，调用方必须具有[组织管理账户](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account)或委托管理员账户中的身份，并且指定的账户 ID 必须是同一组织中的成员账户。组织必须[启用所有功能](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html)，且组织必须为账户管理服务启用[可信访问权限](https://docs.aws.amazon.com/organizations/latest/userguide/services-that-can-integrate-account.html)，可选择分配[委托管理员](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin)账户。管理账户无法自行指定其 `AccountId`；它必须在不包括 `AccountId` 参数的情况下，在独立上下文中调用此操作。要对不是组织成员的账户调用此操作，不要指定此参数，请以属于要检索或修改其联系人的账户的身份调用此操作。类型：字符串模式：`\d{12}` 必需：否 ** [AlternateContactType](#API_PutAlternateContact_RequestSyntax) ** 指定要创建或更新的备用联系人。类型：字符串有效值：`BILLING | OPERATIONS | SECURITY` 是否必需：是 ** [EmailAddress](#API_PutAlternateContact_RequestSyntax) ** 为备用联系人指定电子邮件地址。类型：字符串长度限制：最小长度为 1。最大长度为 254。模式：`[\s]*[\w+=.#|!&-]+@[\w.-]+\.[\w]+[\s]*` 是否必需：是 ** [Name](#API_PutAlternateContact_RequestSyntax) ** 为备用联系人指定姓名。类型：字符串长度限制：最小长度为 1。长度上限为 64。是否必需：是 ** [PhoneNumber](#API_PutAlternateContact_RequestSyntax) ** 为备用联系人指定电话号码。类型：字符串长度限制：最小长度为 1。最大长度为 25。模式：`[\s0-9()+-]+` 是否必需：是 ** [Title](#API_PutAlternateContact_RequestSyntax) ** 为备用联系人指定职务。类型：字符串长度限制：最小长度为 1。最大长度为 50。是否必需：是 ## 响应语法 ``` HTTP/1.1 200 ``` ## 响应元素如果此操作成功，则该服务会发送回带有空 HTTP 正文的 HTTP 200 响应。 ## 错误有关所有操作的常见错误的信息，请参阅[常见错误类型](CommonErrors.md)。 ** AccessDeniedException ** 操作失败，调用身份没有所需的最低权限。 ** errorType ** API Gateway 填充到 `x-amzn-ErrorType` 响应标头的值。 HTTP 状态代码：403 ** InternalServerException ** 由于内部错误，操作失败 AWS。请稍后重新尝试操作。 ** errorType ** API Gateway 填充到 `x-amzn-ErrorType` 响应标头的值。 HTTP 状态代码：500 ** TooManyRequestsException ** 操作失败，调用频率过高且超过了节流限制。 ** errorType ** API Gateway 填充到 `x-amzn-ErrorType` 响应标头的值。 HTTP 状态代码：429 ** ValidationException ** 操作失败，其中一个输入参数无效。 ** fieldList ** 检测到无效条目的字段。 ** message ** 通知您该请求中无效内容的消息。 ** reason ** 验证失败的原因。 HTTP 状态代码：400 ## 示例 ### 示例 1 以下示例为其凭证用于调用操作的账户设置账单备用联系人。 #### 示例请求 ``` POST / HTTP/1.1 X-Amz-Target: AWSAccountV20210201.PutAlternateContact { "AlternateContactType": "Billing", "Name": "Carlos Salazar", "Title": "CFO", "EmailAddress": "carlos@example.com", "PhoneNumber": "206-555-0199" } ``` #### 示例响应 ``` HTTP/1.1 200 OK Content-Type: application/json ``` ### 示例 2 以下示例为组织的指定成员账户设置或改写账单备用联系人。必须使用来自组织管理账户或账户管理服务的委托管理员账户的证书。 #### 示例请求 ``` POST / HTTP/1.1 X-Amz-Target: AWSAccountV20210201.PutAlternateContact { "AccountId": "123456789012", "AlternateContactType": "Billing", "Name": "Carlos Salazar", "Title": "CFO", "EmailAddress": "carlos@example.com", "PhoneNumber": "206-555-0199" } ``` #### 示例响应 ``` HTTP/1.1 200 OK Content-Type: application/json ``` ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/PutAlternateContact) + [AWS 适用于.NET 的 SDK V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/PutAlternateContact) + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/PutAlternateContact) + [AWS 适用于 Go v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/PutAlternateContact) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/PutAlternateContact) + [AWS JavaScript V3 版软件开发工具包](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/PutAlternateContact) + [AWS 适用于 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/PutAlternateContact) + [AWS 适用于 PHP 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/PutAlternateContact) + [AWS Python 软件开发工具包](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/PutAlternateContact) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/PutAlternateContact) # PutContactInformation 更新 AWS 账户的主要联系人信息。关于如何使用主要联系人操作的完整详细信息，请参阅[为您的 AWS 账户更新主要联系人](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-update-contact-primary.html)。 ## 请求语法 ``` POST /putContactInformation HTTP/1.1 Content-type: application/json { "AccountId": "string", "ContactInformation": { "AddressLine1": "string", "AddressLine2": "string", "AddressLine3": "string", "City": "string", "CompanyName": "string", "CountryCode": "string", "DistrictOrCounty": "string", "FullName": "string", "PhoneNumber": "string", "PostalCode": "string", "StateOrRegion": "string", "WebsiteUrl": "string" } } ``` ## URI 请求参数该请求不使用任何 URI 参数。 ## 请求正文请求接受采用 JSON 格式的以下数据。 ** [AccountId](#API_PutContactInformation_RequestSyntax) ** 指定您要通过此操作访问或修改 AWS 账户的 12 位帐户 ID 号。如果未指定此参数，则默认为调用此操作使用的身份的亚马逊云科技账户。要使用此参数，调用方必须具有[组织管理账户](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account)或委托管理员账户中的身份。指定账户 ID 必须是同一组织内的成员账户。组织必须[启用所有功能](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html)，且组织必须为账户管理服务启用[可信访问权限](https://docs.aws.amazon.com/organizations/latest/userguide/services-that-can-integrate-account.html)，可选择分配[委托管理员](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin)账户。管理账户无法指定自己的 `AccountId`。它必须在不包括 `AccountId` 参数的情况下，在独立上下文中调用此操作。要对不是组织成员的账户调用此操作，不要指定此参数。相反，请以属于要检索或修改其联系人的账户的身份调用此操作。类型：字符串模式：`\d{12}` 必需：否 ** [ContactInformation](#API_PutContactInformation_RequestSyntax) ** 包含与 AWS 账户相关的主要联系人信息的详细信息。类型：[ContactInformation](API_ContactInformation.md) 对象是否必需：是 ## 响应语法 ``` HTTP/1.1 200 ``` ## 响应元素如果此操作成功，则该服务会发送回带有空 HTTP 正文的 HTTP 200 响应。 ## 错误有关所有操作的常见错误的信息，请参阅[常见错误类型](CommonErrors.md)。 ** AccessDeniedException ** 操作失败，调用身份没有所需的最低权限。 ** errorType ** API Gateway 填充到 `x-amzn-ErrorType` 响应标头的值。 HTTP 状态代码：403 ** InternalServerException ** 由于内部存在错误，操作失败 AWS。请稍后重新尝试操作。 ** errorType ** API Gateway 填充到 `x-amzn-ErrorType` 响应标头的值。 HTTP 状态代码：500 ** TooManyRequestsException ** 操作失败，调用频率过高且超过了节流限制。 ** errorType ** API Gateway 填充到 `x-amzn-ErrorType` 响应标头的值。 HTTP 状态代码：429 ** ValidationException ** 操作失败，其中一个输入参数无效。 ** fieldList ** 检测到无效条目的字段。 ** message ** 通知您该请求中无效内容的消息。 ** reason ** 验证失败的原因。 HTTP 状态代码：400 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/PutContactInformation) + [AWS 适用于.NET 的 SDK V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/PutContactInformation) + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/PutContactInformation) + [AWS 适用于 Go v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/PutContactInformation) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/PutContactInformation) + [AWS JavaScript V3 版软件开发工具包](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/PutContactInformation) + [AWS 适用于 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/PutContactInformation) + [AWS 适用于 PHP 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/PutContactInformation) + [AWS Python 软件开发工具包](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/PutContactInformation) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/PutContactInformation) # StartPrimaryEmailUpdate 启动为指定账户更新主要电子邮件地址的流程。 ## 请求语法 ``` POST /startPrimaryEmailUpdate HTTP/1.1 Content-type: application/json { "AccountId": "string", "PrimaryEmail": "string" } ``` ## URI 请求参数该请求不使用任何 URI 参数。 ## 请求正文请求接受采用 JSON 格式的以下数据。 ** [AccountId](#API_StartPrimaryEmailUpdate_RequestSyntax) ** 指定您要通过此操作访问或修改 AWS 账户的 12 位帐户 ID 号。要使用此参数，调用方必须具有[组织管理账户](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account)或委托管理员账户中的身份。指定账户 ID 必须是同一组织内的成员账户。组织必须[启用所有功能](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html)，且组织必须为账户管理服务启用[可信访问权限](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_integrate_services.html)，可选择分配[委托管理员](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin)账户。此操作只能由组织的管理账户或委托管理员账户为成员账户调用。管理账户无法指定自己的 `AccountId`。类型：字符串模式：`\d{12}` 是否必需：是 ** [PrimaryEmail](#API_StartPrimaryEmailUpdate_RequestSyntax) ** 在指定账户中使用的新的主要电子邮件地址（也称为根用户电子邮件地址）。类型：字符串长度限制：最小长度为 5。长度上限为 64。是否必需：是 ## 响应语法 ``` HTTP/1.1 200 Content-type: application/json { "Status": "string" } ``` ## 响应元素如果此操作成功，则该服务将会发送回 HTTP 200 响应。服务以 JSON 格式返回以下数据。 ** [Status](#API_StartPrimaryEmailUpdate_ResponseSyntax) ** 主要电子邮件更新请求的状态。类型：字符串有效值：`PENDING | ACCEPTED` ## 错误有关所有操作的常见错误的信息，请参阅[常见错误类型](CommonErrors.md)。 ** AccessDeniedException ** 操作失败，调用身份没有所需的最低权限。 ** errorType ** API Gateway 填充到 `x-amzn-ErrorType` 响应标头的值。 HTTP 状态代码：403 ** ConflictException ** 由于资源的当前状态存在冲突，因此无法处理该请求。例如，如果尝试启用当前已禁用（处于“禁用”状态）的区域，或者尝试将账户的根用户电子邮件更改为已在使用的电子邮件地址，就会发生这种情况。 ** errorType ** API Gateway 填充到 `x-amzn-ErrorType` 响应标头的值。 HTTP 状态代码：409 ** InternalServerException ** 由于内部存在错误，操作失败 AWS。请稍后重新尝试操作。 ** errorType ** API Gateway 填充到 `x-amzn-ErrorType` 响应标头的值。 HTTP 状态代码：500 ** ResourceNotFoundException ** 操作失败，找不到指定的资源。 ** errorType ** API Gateway 填充到 `x-amzn-ErrorType` 响应标头的值。 HTTP 状态代码：404 ** TooManyRequestsException ** 操作失败，调用频率过高且超过了节流限制。 ** errorType ** API Gateway 填充到 `x-amzn-ErrorType` 响应标头的值。 HTTP 状态代码：429 ** ValidationException ** 操作失败，其中一个输入参数无效。 ** fieldList ** 检测到无效条目的字段。 ** message ** 通知您该请求中无效内容的消息。 ** reason ** 验证失败的原因。 HTTP 状态代码：400 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/StartPrimaryEmailUpdate) + [AWS 适用于.NET 的 SDK V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/StartPrimaryEmailUpdate) + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/StartPrimaryEmailUpdate) + [AWS 适用于 Go v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/StartPrimaryEmailUpdate) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/StartPrimaryEmailUpdate) + [AWS JavaScript V3 版软件开发工具包](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/StartPrimaryEmailUpdate) + [AWS 适用于 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/StartPrimaryEmailUpdate) + [AWS 适用于 PHP 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/StartPrimaryEmailUpdate) + [AWS Python 软件开发工具包](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/StartPrimaryEmailUpdate) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/StartPrimaryEmailUpdate) # 其他 AWS 服务中的相关操作以下操作与命名空间相关 AWS 账户管理但属于 AWS Organizations 命名空间的一部分： + [CreateAccount](API_CreateAccount.md) + [CreateGovCloudAccount](API_CreateGovCloudAccount.md) + [DescribeAccount](API_DescribeAccount.md) # CreateAccount `CreateAccount`API 操作只能在由 AWS Organizations 服务管理的组织环境中使用。API 操作的定义见该服务的命名空间。有关更多信息，请参阅《AWS Organizations API Reference》**中的 [CreateAccount](https://docs.aws.amazon.com/organizations/latest/APIReference/API_CreateAccount.html)。 # CreateGovCloudAccount `CreateGovCloudAccount`API 操作只能在由 AWS Organizations 服务管理的组织环境中使用。API 操作的定义见该服务的命名空间。有关更多信息，请参阅《AWS Organizations API Reference》**中的 [CreateGovCloudAccount](https://docs.aws.amazon.com/organizations/latest/APIReference/API_CreateGovCloudAccount.html)。 # DescribeAccount `DescribeAccount`API 操作只能在由 AWS Organizations 服务管理的组织环境中使用。API 操作的定义见该服务的命名空间。有关更多信息，请参阅《AWS Organizations API Reference》**中的 [DescribeAccount](https://docs.aws.amazon.com/organizations/latest/APIReference/API_DescribeAccount.html)。 # 数据类型支持以下数据类型： + [AlternateContact](API_AlternateContact.md) + [ContactInformation](API_ContactInformation.md) + [Region](API_Region.md) + [ValidationExceptionField](API_ValidationExceptionField.md) # AlternateContact 此结构包含与 AWS 账户关联的备用联系人的详细信息 ## 内容 ** AlternateContactType ** 备用联系人的类型。类型：字符串有效值：`BILLING | OPERATIONS | SECURITY` 必需：否 ** EmailAddress ** 与此备用联系人关联的电子邮件地址。类型：字符串长度限制：最小长度为 1。最大长度为 254。模式：`[\s]*[\w+=.#|!&-]+@[\w.-]+\.[\w]+[\s]*` 必需：否 ** Name ** 与此备用联系人关联的姓名。类型：字符串长度限制：最小长度为 1。长度上限为 64。必需：否 ** PhoneNumber ** 与此备用联系人关联的电话号码。类型：字符串长度限制：最小长度为 1。最大长度为 25。模式：`[\s0-9()+-]+` 必需：否 ** Title ** 与此备用联系人关联的头衔。类型：字符串长度限制：最小长度为 1。最大长度为 50。必需：否 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/AlternateContact) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/AlternateContact) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/AlternateContact) # ContactInformation 包含与 AWS 账户关联的主要联系人信息的详细信息。 ## 内容 ** AddressLine1 ** 主要联系人地址中的第一行。类型：字符串长度限制：最小长度为 1。最大长度为 60。是否必需：是 ** City ** 主要联系人地址中的城市。类型：字符串长度限制：最小长度为 1。最大长度为 50。是否必需：是 ** CountryCode ** 主要联系人地址中的 ISO-3166 双字母国家/地区代码。类型：字符串长度限制：固定长度为 2。是否必需：是 ** FullName ** 主要联系人地址中的全名。类型：字符串长度限制：最小长度为 1。最大长度为 50。是否必需：是 ** PhoneNumber ** 主要联系人信息中的电话号码。该号码将经过验证，在某些国家/地区将检查是否激活。类型：字符串长度限制：最小长度为 1。最大长度为 20。模式：`[+][\s0-9()-]+` 是否必需：是 ** PostalCode ** 主要联系人地址中的邮政编码。类型：字符串长度限制：最小长度为 1。最大长度为 20。是否必需：是 ** AddressLine2 ** 主要联系人地址中的第二行（如有）。类型：字符串长度限制：最小长度为 1。最大长度为 60。必需：否 ** AddressLine3 ** 主要联系人地址中的第三行（如有）。类型：字符串长度限制：最小长度为 1。最大长度为 60。必需：否 ** CompanyName ** 与主要联系人信息关联的公司的名称（如有）。类型：字符串长度限制：最小长度为 1。最大长度为 50。必需：否 ** DistrictOrCounty ** 主要联系人地址中的地区或县（如有）。类型：字符串长度限制：最小长度为 1。最大长度为 50。必需：否 ** StateOrRegion ** 主要联系人地址中的州或地区。如果邮寄地址位于美国（US）境内，则此字段中的值可以是双字符州代码（例如 `NJ`），也可以是州的全名（例如 `New Jersey`）。以下国家/地区需填写此字段：`US`、`CA`、`GB`、`DE`、`JP`、`IN` 和 `BR`。类型：字符串长度限制：最小长度为 1。最大长度为 50。必需：否 ** WebsiteUrl ** 与主要联系人信息关联的网站的 URL（如有）。类型：字符串长度限制：最小长度为 1。最大长度为 256。必需：否 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/ContactInformation) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/ContactInformation) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/ContactInformation) # Region 这是一种表示给定账户的区域的结构，其中包括一个名称和选择加入状态。 ## 内容 ** RegionName ** 给定区域的区域代码（例如 `us-east-1`）。类型：字符串长度限制：最小长度为 1。最大长度为 50。必需：否 ** RegionOptStatus ** 区域可能处于以下潜在状态之一（已启用、启用、已禁用、禁用、默认已启用）。类型：字符串有效值：`ENABLED | ENABLING | DISABLING | DISABLED | ENABLED_BY_DEFAULT` 必需：否 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/Region) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/Region) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/Region) # ValidationExceptionField 输入未能满足 AWS 服务在指定字段中指定的限制。 ## 内容 ** message ** 验证异常的相关消息。类型：字符串是否必需：是 ** name ** 检测到无效条目的字段名称。类型：字符串必需：是 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/ValidationExceptionField) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/ValidationExceptionField) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/ValidationExceptionField) # 常见参数以下列表包含所有操作用于使用查询字符串对 Signature Version 4 请求进行签名的参数。任何特定于操作的参数都列在该操作的主题中。有关签名版本 4 的更多信息，请参阅 I *AM 用户指南*中的[签署 AWS API 请求](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-signing.html)。 **X-Amz-Algorithm** 您用于创建请求签名的哈希算法。条件：当您在查询字符串中而不是 HTTP 授权标头中包括身份验证信息时，请指定此参数。类型：字符串有效值：`AWS4-HMAC-SHA256` 必需：条件 **X-Amz-Credential** 凭证范围值，该值是一个字符串，其中包含您的访问密钥、日期、您要定位的区域、您请求的服务以及终止字符串（“aws4\$1request”）。值采用以下格式表示：*access\$1key*/*YYYYMMDD*/*region*/*service*/aws4\$1request。有关更多信息，请参阅 I *AM 用户指南*中的[创建已签名的 AWS API 请求](https://docs.aws.amazon.com/IAM/latest/UserGuide/create-signed-request.html)。条件：当您在查询字符串中而不是 HTTP 授权标头中包括身份验证信息时，请指定此参数。类型：字符串必需：条件 **X-Amz-Date** 用于创建签名的日期。格式必须为 ISO 8601 基本格式 (YYYYMMDD'T'HHMMSS'Z')。例如，以下日期时间是有效 X-Amz-Date值：`20120325T120000Z`。条件： X-Amz-Date 对所有请求而言是可选的；它可以用于覆盖对请求签名所使用的日期。如果日期标题以 ISO 8601 基本格式指定，则 X-Amz-Date不是必填项。使用 X-Amz-Date时，它总是会覆盖 Date 标题的值。有关更多信息，请参阅 I *AM 用户指南*中的 [AWS API 请求签名元素](https://docs.aws.amazon.com/IAM/latest/UserGuide/signing-elements.html)。类型：字符串必需：条件 **X-Amz-Security-Token** 通过调用 AWS Security Token Service (AWS STS) 获得的临时安全令牌。有关支持来自 AWS STS的临时安全凭证的服务列表，请参阅《IAM 用户指南》**中的[使用 IAM 的AWS 服务](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html)。条件：如果您使用的是中的临时安全证书 AWS STS，则必须包含安全令牌。类型：字符串必需：条件 **X-Amz-Signature** 指定从要签名的字符串和派生的签名密钥计算的十六进制编码签名。条件：当您在查询字符串中而不是 HTTP 授权标头中包括身份验证信息时，请指定此参数。类型：字符串必需：条件 **X-Amz-SignedHeaders** 指定作为规范请求的一部分包含的所有 HTTP 标头。有关指定签名标头的更多信息，请参阅 I *AM 用户指南*中的[创建已签名的 AWS API 请求](https://docs.aws.amazon.com/IAM/latest/UserGuide/create-signed-request.html)。条件：当您在查询字符串中而不是 HTTP 授权标头中包括身份验证信息时，请指定此参数。类型：字符串必需：条件 # 常见错误类型本节列出了此 AWS 服务可能返回的常见错误类型。并非所有服务都会返回此处列出的所有错误类型。对于特定于此服务的 API 操作的错误，请参阅该 API 操作的主题。 **AccessDeniedException** 您无权执行此操作。验证您的 IAM 策略是否包含所需的权限。 HTTP 状态代码：403 **ExpiredTokenException** 请求中包含的安全令牌已过期。申请新的安全令牌并重试。 HTTP 状态代码：403 **IncompleteSignature** 请求签名不符合 AWS 标准。确认您使用的是有效的 AWS 凭证，并且您的请求格式是否正确。如果您使用的是 SDK，请确保它是最新的。 HTTP 状态代码：403 **InternalFailure** 由于内部服务器问题，该请求现在无法处理。请稍后重试。如果问题仍然存在，请联系 Supp AWS ort。 HTTP 状态代码：500 **MalformedHttpRequestException** 无法处理请求正文。当无法使用指定的内容编码算法对请求正文进行解压缩时，通常会发生这种情况。验证内容编码标头是否与使用的压缩格式相匹配。 HTTP 状态代码：400 **NotAuthorized** 您无权执行此操作。验证您的 IAM 策略是否包含所需的权限。 HTTP 状态代码：401 **OptInRequired** 您的 AWS 账户需要订阅此服务。确认您已在账户中启用该服务。 HTTP 状态代码：403 **RequestAbortedException** 在返回响应之前，请求已中止。这通常发生在客户端关闭连接时。 HTTP 状态代码：400 **RequestEntityTooLargeException** 请求实体太大。请缩小请求正文的大小，然后重试。 HTTP 状态代码：413 **RequestTimeoutException** 请求超时。服务器未在预期的时间范围内收到完整的请求。请重试。 HTTP 状态代码：408 **ServiceUnavailable** 服务暂时不可用。请稍后重试。 HTTP 状态代码：503 **ThrottlingException** 您的请求率太高。收到此异常的 AWS SDKs 自动重试请求。请降低请求频率。 HTTP 状态代码：400 **UnknownOperationException** 无法识别该操作或操作。确认操作名称拼写正确，并且您使用的 API 版本是否支持该名称。 HTTP 状态代码：404 **UnrecognizedClientException** 您提供的 X.509 证书或 AWS 访问密钥 ID 不在我们的记录中。确认您使用的是有效的凭证，并且这些凭证尚未过期。 HTTP 状态代码：403 **ValidationError** 输入不符合要求的格式或限制。检查是否包含所有必需的参数以及值是否有效。 HTTP 状态代码：400 # 通过提出 HTTP 查询请求来调用 API 本节包含有关使用 AWS 账户管理查询 API 的一般信息。有关 API 操作和错误的详细信息，请参阅[API 参考](api-reference.md)。 **注意** 您可以使用其中一个，而不是直接调用 AWS 账户管理查询 API AWS SDKs。 AWS SDKs 由适用于各种编程语言和平台（Java、Ruby、.NET、iOS、Android 等）的库和示例代码组成。 SDKs 提供了一种便捷的方法来创建对 AWS 账户管理的编程访问权限，以及 AWS. 例如，负责处理诸如对请求 SDKs 进行加密签名、管理错误和自动重试请求之类的任务。有关信息 AWS SDKs，包括如何下载和安装它们，请参阅[适用于 Amazon Web Services 的工具](https://aws.amazon.com/tools)。使用 AWS 账户管理查询 API，您可以调用服务操作。查询 API 请求是 HTTPS 请求，必须包含用于指示要执行的操作的`Action`参数。 AWS 账户管理支持`GET`并`POST`请求所有操作。也就是说，API 不要求您对某些操作使用 `GET`，而对其他一些操作使用 `POST`。然而，`GET` 请求受 URL 的大小限制。尽管此限制与浏览器相关，不过通常为 2048 字节。因此，对于要求更高的查询 API 请求，您必须使用 `POST` 请求。响应是 XML 文档。有关响应的详细信息，请参阅 [API 参考](api-reference.md)中的各个操作页面。 **Topics** + [端点](#endpoints) + [必须使用 HTTPS](#IAMHTTPSRequired) + [签署 AWS 账户管理 API 请求](#SigVersion) ## 端点 AWS 账户管理有一个托管在美国东部（弗吉尼亚北部）的全球 API 终端节点 AWS 区域。有关所有服务的 AWS 终端节点和区域的更多信息，请参阅中的[区域和终端节点*AWS 一般参考*](https://docs.aws.amazon.com/general/latest/gr/rande.html)。 ## 必须使用 HTTPS 由于查询 API 会返回安全凭证等敏感信息，必须使用 HTTPS 对所有 API 请求加密。 ## 签署 AWS 账户管理 API 请求必须使用访问密钥 ID 和秘密访问密钥签署请求。我们强烈建议您不要将 AWS 根账户凭据用于 AWS 账户管理的日常工作。您可以将证书用于 AWS Identity and Access Management (IAM) 用户，也可以使用临时证书，例如用于 IAM 角色。要签署您的 API 请求，必须使用 AWS 签名版本 4。有关使用签名版本 4 的信息，请参阅 I *AM 用户指南*中的[签署 AWS API 请求](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-signing.html)。有关更多信息，请参阅下列内容： + [AWS 安全凭证](https://docs.aws.amazon.com/IAM/latest/UserGuide/security-creds.html)：提供有关可用于访问 AWS的凭证类型的一般信息。 + [IAM 中的安全最佳实践](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html) — 提供有关使用 IAM 服务来帮助保护您的 AWS 资源（包括 AWS 账户管理中的资源）的建议。 + [IAM 中的临时安全凭证](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp.html)：说明如何创建和使用临时安全凭证。