翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# 認証 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:*`アクションに制限されたキーを作成します。これは、マップのみをレンダリングするウェブページに適しています。
+ **マップと場所のキーを作成する**: 1 つのキーで複数の許可されたアクションとリソースを指定することで、マップのレンダリングとジオコーディングの両方を許可するキーを作成します。
+ **API キーのローテーション**: 新しいキーを作成し、それを使用するようにアプリケーションを更新してから、 を使用して有効期限を過去の日付に設定して古いキーを非アクティブ化します`UpdateKey`。
+ **ドメイン制限の追加**: 既存のキーを更新して、リファラーベースのクライアント制限を使用して特定のウェブドメインの使用を制限します。
+ **監査キーインベントリ**: を使用してアカウントのすべてのキーを一覧表示`ListKeys`し、クリーンアップのために未使用または期限切れのキーを特定します。
+ **侵害されたキーを取り消す**: ステータスを に更新してすぐにキーを非アクティブ化し`UpdateKey`、 を使用して 90 日後に削除します`DeleteKey`。