View a markdown version of this page

身份验证 API - Amazon Location Service

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

身份验证 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