翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
CreateAccessPreview
リソース権限をデプロイする前に、リソースの IAM Access Analyzer の結果をプレビューできるアクセスプレビューを作成します。
リクエストの構文
PUT /access-preview HTTP/1.1
Content-type: application/json
{
"analyzerArn": "string",
"clientToken": "string",
"configurations": {
"string" : { ... }
}
}URI リクエストパラメータ
リクエストでは URI パラメータを使用しません。
リクエストボディ
リクエストは以下の JSON 形式のデータを受け入れます。
- analyzerArn
-
アクセスプレビューの生成に使用されたアカウントアナライザーの ARN。タイプとステータスのあるアナライザーのアクセスプレビューのみを作成できます。
AccountActive型: 文字列
Pattern:
[^:]*:[^:]*:[^:]*:[^:]*:[^:]*:analyzer/.{1,255}必須：はい
- clientToken
-
クライアントトークン。
タイプ: 文字列
必須: いいえ
- configurations
-
アクセスプレビューの生成に使用されるリソースのアクセス制御設定。アクセスプレビューには、提案されたアクセス制御設定でリソースに許可された外部アクセスに関する結果が含まれます。構成には要素が 1 つだけ含まれている必要があります。
タイプ: Configuration オブジェクトマップへの文字列です。
必須: はい
レスポンスの構文
HTTP/1.1 200
Content-type: application/json
{
"id": "string"
}レスポンス要素
アクションが成功すると、サービスは HTTP 200 レスポンスを返します。
サービスから以下のデータが JSON 形式で返されます。
- id
-
アクセスプレビューのユニーク ID。
型: 文字列
パターン：
[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}
エラー
すべてのアクションに共通のエラーについては、「共通エラー」を参照してください。
- AccessDeniedException
-
このアクションを実行する十分なアクセス権限がありません。
HTTP ステータスコード: 403
- ConflictException
-
コンフリクト例外エラー。
HTTP ステータスコード: 409
- InternalServerException
-
内部サーバーエラー。
HTTP ステータスコード：500
- ResourceNotFoundException
-
指定したリソースが見つかりませんでした。
HTTP ステータスコード: 404
- ServiceQuotaExceededException
-
サービスクォートミートエラー。
HTTP ステータスコード: 402
- ThrottlingException
-
スロットリング制限超過エラー。
HTTP ステータスコード: 429
- ValidationException
-
検証例外エラー。
HTTP ステータスコード：400
その他の参照資料
言語固有の AWS SDK の 1 つでこの API を使用する方法の詳細については、以下を参照してください。
