本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。 # API 参考 账户管理 (`account`) 命名空间中的 API 操作允许您修改自己的 Amazon Web Services 账户。 每个都 Amazon Web Services 账户 支持包含账户信息的元数据，包括最多三个与该账户关联的备用联系人的信息。除此之外，还有与账户的[根用户](root-user.md)关联的电子邮件地址。您只能从与账户关联的以下联系人类型中指定一个类型。 + 账单联系人 + 操作联系人 + 安全联系人 默认情况下，本指南中所述的 API 操作直接适用于调用此操作的账户。操作调用账户中的[身份](https://docs.amazonaws.cn/IAM/latest/UserGuide/id.html)通常是 IAM 角色或 IAM 用户，它必须拥有 IAM 策略应用的权限才能调用 API 操作。或者，您可以从 Amazon Organizations 管理账户中的身份调用这些 API 操作 Amazon Web Services 账户 ，并为任何组织成员指定账户 ID 号。 **API 版本** 本版《账户 API 参考》记录了 2021-02-01 版的账户管理 API。 **注意** 除了直接使用 API 之外，您还可以使用其中一个，它包含适用于各种编程语言和平台（Java Amazon SDKs、Ruby、.NET、iOS、Android 等）的库和示例代码。它们 SDKs 提供了一种便捷的方式来创建对 Organizations 的编程 Amazon 访问权限。例如，负责对请求 SDKs 进行加密签名、管理错误和自动重试请求。有关（包括如何下载和安装它们）的更多信息 Amazon SDKs，请参阅[适用于 Amazon Web Services 的工具](https://console.amazonaws.cn/)。 我们建议您使用 Amazon SDKs 对账户管理服务进行编程 API 调用。但是，您也可以使用账户管理查询 API 直接调用账户管理的 Web 服务。要了解有关账户管理查询 API 的更多信息，请参阅《账户管理用户指南》中的 [通过提出 HTTP 查询请求来调用 API](query-requests.md)。组织支持所有操作的 GET 和 POST 请求。也就是说，API 不要求您使用某些操作的 GET 请求和其他操作的 POST 请求。然而，GET 请求受 URL 的大小限制。因此，对于需要更大规模的操作，请使用 POST 请求。 **签署请求** 向发送 HTTP 请求时 Amazon，必须对请求进行签名，这样 Amazon 才能识别谁发送了这些请求。您可以使用访问密钥（由 Amazon 访问密钥 ID 和私有访问密钥组成）签署请求。我们强烈建议您不要为根账户创建访问密钥。拥有您的根账户的访问密钥的任何人都可以无限制地访问您账户中的所有资源。相反，应为具有管理权限的 IAM 用户创建访问密钥。另一种选择是，使用 Amazon 安全令牌服务生成临时安全证书，然后使用这些证书签署请求。 如需对请求进行签名，建议您使用签名版本 4。如果现有应用程序使用签名版本 2，则无需将其更新即可使用签名版本 4。但是，目前某些操作需要签名版本 4。需要版本 4 的操作的文档指出了这一要求。有关更多信息，请参阅 I *AM 用户指南*中的[签署 Amazon API 请求](https://docs.amazonaws.cn/IAM/latest/UserGuide/reference_aws-signing.html)。 当您使用 Amazon 命令行界面 (Amazon CLI) 或其中一个 Amazon SDKs 向其发出请求时 Amazon，这些工具会自动使用您在配置工具时指定的访问密钥为您签署请求。 **对账户管理的支持和反馈** 我们欢迎您提供反馈。请将您的意见发送至 [feedback-awsaccounts@amazon.com](mailto://feedback-awsaccounts@amazon.com)，或将反馈和问题发布在[账户管理支持论坛](https://forums.aws.csdn.net/forum.jspa?forumID=219)上。有关 Amazon 支持论坛的更多信息，请参阅[论坛帮助](https://forums.aws.csdn.net/help.jspa)。 **示例呈现方式** 作为对请求的响应，账户管理返回的 JSON 将以单个长字符串形式返回，不含换行符或格式化空格。为提高可读性，本指南中的示例同时显示了换行符和空格。当示例输入参数也会产生超出屏幕范围的长字符串时，我们会插入换行符以增强可读性。您应始终以单个 JSON 文本字符串的形式提交输入。 **记录 API 请求** 账户管理支持一项服务 CloudTrail，用于记录您 Amazon 的 API 调用 Amazon Web Services 账户 并将日志文件传输到 Amazon S3 存储桶。通过使用收集的信息 CloudTrail，您可以确定哪些请求已成功向账户管理部门发出、谁发出了请求、何时发出等。有关账户管理及其支持的更多信息 CloudTrail，请参阅[使用记录 Amazon 账户管理 API 调用 Amazon CloudTrail](monitoring-cloudtrail.md)。要了解更多信息 CloudTrail，包括如何将其开启和查找日志文件，请参阅[Amazon CloudTrail 用户指南](https://docs.amazonaws.cn/awscloudtrail/latest/userguide/)。