本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
通过提出 HTTP 查询请求来调用 API
本节包含有关使用查询 API 的一般信息AWS账户管理。有关 API 操作和错误的详细信息,请参阅 API 引用。
注意
而不是直接打电话给AWS账户管理查询 API,您可以使用其中一个AWS软件开发工具包。AWS 开发工具包中包含适用于各种编程语言和平台(Java、Ruby、.NET、iOS、Android 等)的库和示例代码。SDK 提供了一种创建编程访问权限的便捷方式AWS账户管理和AWS。例如,开发工具包执行以下类似任务:加密签署请求、管理错误以及自动重试请求。有关 AWS 开发工具包的信息(包括如何下载及安装),请参阅适用于 Amazon Web Services 的工具
使用查询 APIAWS账户管理,您可以调用服务操作。查询 API 请求是 HTTPS 请求,必须包含Action
用于指示要执行的操作的参数。AWS账户管理支持GET
和POST
请求所有操作。也就是说,API 不需要你使用GET
用于某些操作和POST
为了其他人。但是,GET
请求受到 URL 大小限制的约束。尽管此限制取决于浏览器,但典型限制为 2,048 字节。因此,对于需要更大尺寸的查询 API 请求,必须使用POST
请求。
响应是 XML 文档。有关响应的详细信息,请参阅 API 引用中的各个操作页面。
端点
AWS账户管理有一个托管在美国东部(弗吉尼亚北部)的单一全球 API 终端节点AWS 区域。
有关以下内容的更多信息AWS所有服务的终端节点和区域,请参阅区域和终端节点在AWS 一般参考。
必须使用 HTTPS
由于查询 API 可以返回安全证书等敏感信息,因此必须使用 HTTPS 加密所有 API 请求。
签署AWS账户管理 API 请求
必须使用访问密钥 ID 和秘密访问密钥签署请求。我们强烈建议您不要使用您的AWS用于日常工作的根账户证书AWS账户管理。您可以将凭证用于AWS Identity and Access Management(IAM) 用户或临时证书,例如您在 IAM 角色中使用的证书。
要对您的 API 请求进行签名,您必须使用 AWS 签名版本 4。有关 Signature Version 4 的信息,请参阅《IAM 用户指南》中的签署 AWS API 请求。
有关更多信息,请参阅下列内容:
-
AWS 安全凭证:提供有关可用于访问 AWS 的凭证类型的一般信息。
-
IAM 中的安全最佳实践— 提供有关使用 IAM 服务来帮助保护您的安全的建议AWS资源,包括中的资源AWS账户管理。
-
IAM 中的临时安全凭证:说明如何创建和使用临时安全凭证。