本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 驗證 APIs
<a name="auth-apis"></a>

下列 APIs 可讓您管理 Amazon Location Service 的 API 金鑰。使用這些操作來建立金鑰、設定限制、輪換金鑰和監控您的金鑰庫存。
+ **CreateKey**：建立具有指定限制和選用過期的新 API 金鑰。傳回用於驗證後續 API 請求的金鑰值。如需詳細資訊，請參閱《*Amazon Location Service API 參考*》中的 [CreateKey](https://docs.aws.amazon.com/location/latest/APIReference/API_geoapikeys_CreateKey.html)。
+ **DescribeKey**：擷取現有 API 金鑰的詳細資訊，包括其限制、過期和金鑰值。如需詳細資訊，請參閱《*Amazon Location Service API 參考*》中的 [DescribeKey](https://docs.aws.amazon.com/location/latest/APIReference/API_geoapikeys_DescribeKey.html)。
+ **UpdateKey**：修改現有 API 金鑰的限制、過期或描述。使用此操作來加強許可、延長或設定過期，或停用金鑰。如需詳細資訊，請參閱《*Amazon Location Service API 參考*》中的 [UpdateKey](https://docs.aws.amazon.com/location/latest/APIReference/API_geoapikeys_UpdateKey.html)。
+ **DeleteKey**：永久刪除 API 金鑰。您只能刪除已處於非作用中狀態至少 90 天的金鑰。如需詳細資訊，請參閱《*Amazon Location Service API 參考*》中的 [DeleteKey](https://docs.aws.amazon.com/location/latest/APIReference/API_geoapikeys_DeleteKey.html)。
+ **ListKeys**：傳回您帳戶和區域中 API 金鑰的清單，包括中繼資料，例如金鑰名稱、狀態和過期。如需詳細資訊，請參閱《*Amazon Location Service API 參考*》中的 [ListKeys](https://docs.aws.amazon.com/location/latest/APIReference/API_geoapikeys_ListKeys.html)。

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

以下是 API 金鑰管理操作的常見使用案例。
+ **建立映射應用程式的金鑰**：建立僅限於預設映射提供者資源上`geo-maps:*`動作的金鑰，適用於僅轉譯映射的網頁。
+ **建立映射和位置的金鑰**：在單一金鑰中指定多個允許的動作和資源，以建立允許映射轉譯和地理編碼的金鑰。
+ **輪換 API 金鑰**：建立新的金鑰、更新您的應用程式以使用它，然後使用 將其過期設定為過去日期來停用舊金鑰`UpdateKey`。
+ **新增網域限制**：更新現有金鑰，以使用以參考者為基礎的用戶端限制，將用量限制為特定 Web 網域。
+ **稽核金鑰庫存**：使用 列出帳戶中的所有金鑰`ListKeys`，以識別未使用的或即將過期的金鑰以進行清除。
+ **撤銷洩露的金鑰**：使用 更新其狀態，然後在 90 天後使用 將其刪除`UpdateKey`，以立即停用金鑰`DeleteKey`。