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

# 身份验证 API
<a name="auth-apis"></a>

以下 API 使您能够管理 Amazon Location Service 的 API 密钥。使用这些操作来创建密钥、配置限制、轮换密钥和监控密钥清单。
+ **CreateKey**：创建具有指定限制和可选有效期的新 API 密钥。返回用于对后续 API 请求进行身份验证的密钥值。有关更多信息，请参阅[CreateKey](https://docs.aws.amazon.com/location/latest/APIReference/API_geoapikeys_CreateKey.html)《*亚马逊定位服务 API 参考*》。
+ **DescribeKey**：检索现有 API 密钥的详细信息，包括其限制、到期时间和密钥值。有关更多信息，请参阅[DescribeKey](https://docs.aws.amazon.com/location/latest/APIReference/API_geoapikeys_DescribeKey.html)《*亚马逊定位服务 API 参考*》。
+ **UpdateKey**：修改现有 API 密钥的限制、到期时间或描述。使用此操作可以收紧权限、延长或设置到期时间或停用密钥。有关更多信息，请参阅[UpdateKey](https://docs.aws.amazon.com/location/latest/APIReference/API_geoapikeys_UpdateKey.html)《*亚马逊定位服务 API 参考*》。
+ **DeleteKey**：永久删除 API 密钥。您只能删除至少 90 天处于非活动状态的密钥。有关更多信息，请参阅[DeleteKey](https://docs.aws.amazon.com/location/latest/APIReference/API_geoapikeys_DeleteKey.html)《*亚马逊定位服务 API 参考*》。
+ **ListKeys**：返回您的账户和地区中的 API 密钥列表，包括密钥名称、状态和到期日等元数据。有关更多信息，请参阅[ListKeys](https://docs.aws.amazon.com/location/latest/APIReference/API_geoapikeys_ListKeys.html)《*亚马逊定位服务 API 参考*》。

## 常见使用案例
<a name="auth-apis-common-use-cases"></a>

以下是 API 密钥管理操作的常见用例。
+ **为地图应用程序创建密钥**：创建仅限于在默认地图提供程序资源上`geo-maps:*`执行操作的密钥，适用于仅呈现地图的网页。
+ **为地图和地点创建密钥**：通过在单个按键中指定多个允许的操作和资源，创建同时允许地图渲染和地理编码的密钥。
+ **轮换 API 密钥**：创建新密钥，更新您的应用程序以使用它，然后使用将旧密钥的过期日期设置为过去的日期，从而停用`UpdateKey`旧密钥。
+ **添加域名限制**：使用基于反向链接的客户端限制，更新现有密钥以限制特定网络域的使用。
+ **审计密钥清单**：列出账户中的所有密钥，用于识别未使用或即将`ListKeys`到期的密钥以进行清理。
+ **撤销泄露的密钥**：使用更新密钥的状态以立即停用密钥`UpdateKey`，然后在使用 90 天后将其删除。`DeleteKey`