本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
身份验证 API
以下 API 使您能够管理 Amazon Location Service 的 API 密钥。使用这些操作来创建密钥、配置限制、轮换密钥和监控密钥清单。
-
CreateKey:创建具有指定限制和可选有效期的新 API 密钥。返回用于对后续 API 请求进行身份验证的密钥值。有关更多信息,请参阅CreateKey《亚马逊定位服务 API 参考》。
-
DescribeKey:检索现有 API 密钥的详细信息,包括其限制、到期时间和密钥值。有关更多信息,请参阅DescribeKey《亚马逊定位服务 API 参考》。
-
UpdateKey:修改现有 API 密钥的限制、到期时间或描述。使用此操作可以收紧权限、延长或设置到期时间或停用密钥。有关更多信息,请参阅UpdateKey《亚马逊定位服务 API 参考》。
-
DeleteKey:永久删除 API 密钥。您只能删除至少 90 天处于非活动状态的密钥。有关更多信息,请参阅DeleteKey《亚马逊定位服务 API 参考》。
-
ListKeys:返回您的账户和地区中的 API 密钥列表,包括密钥名称、状态和到期日等元数据。有关更多信息,请参阅ListKeys《亚马逊定位服务 API 参考》。
常见使用案例
以下是 API 密钥管理操作的常见用例。
-
为地图应用程序创建密钥:创建仅限于在默认地图提供程序资源上
geo-maps:*执行操作的密钥,适用于仅呈现地图的网页。 -
为地图和地点创建密钥:通过在单个按键中指定多个允许的操作和资源,创建同时允许地图渲染和地理编码的密钥。
-
轮换 API 密钥:创建新密钥,更新您的应用程序以使用它,然后使用将旧密钥的过期日期设置为过去的日期,从而停用
UpdateKey旧密钥。 -
添加域名限制:使用基于反向链接的客户端限制,更新现有密钥以限制特定网络域的使用。
-
审计密钥清单:列出账户中的所有密钥,用于识别未使用或即将
ListKeys到期的密钥以进行清理。 -
撤销泄露的密钥:使用更新密钥的状态以立即停用密钥
UpdateKey,然后在使用 90 天后将其删除。DeleteKey