CreateAnalyzer - IAM Access Analyzer
リクエストの構文URI リクエストパラメータリクエストボディレスポンスの構文レスポンス要素エラー以下の資料も参照してください。

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

CreateAnalyzer

アカウントのアナライザーを作成します。

リクエストの構文

PUT /analyzer HTTP/1.1
Content-type: application/json

{
   "analyzerName": "string",
   "archiveRules": [ 
      { 
         "filter": { 
            "string" : { 
               "contains": [ "string" ],
               "eq": [ "string" ],
               "exists": boolean,
               "neq": [ "string" ]
            }
         },
         "ruleName": "string"
      }
   ],
   "clientToken": "string",
   "configuration": { ... },
   "tags": { 
      "string" : "string" 
   },
   "type": "string"
}

URI リクエストパラメータ

リクエストでは URI パラメータを使用しません。

リクエストボディ

リクエストは以下の JSON 形式のデータを受け入れます。

analyzerName

作成するアナライザーの名前。

型: 文字列

長さの制限: 最小長は 1 です。最大長は 255 です。

パターン: [A-Za-z][A-Za-z0-9_.-]*

必須: はい

archiveRules

アナライザー用に追加するアーカイブルールを指定します。アーカイブルールは、ルールに定義した条件を満たす結果を自動的にアーカイブします。

型: InlineArchiveRule オブジェクトの配列

必須: いいえ

clientToken

クライアントトークン。

型: 文字列

必須: いいえ

configuration

アナライザーの設定を指定します。アナライザーが未使用のアクセスアナライザーの場合、指定された範囲の未使用アクセスが設定に使用されます。アナライザーが外部アクセスアナライザーの場合、このフィールドは使用されません。

型: AnalyzerConfiguration オブジェクト

注:このオブジェクトは Union です。このオブジェクトのメンバーは 1 つだけ指定または取得できます。

必須: いいえ

tags

アナライザーに適用するキーと値のペアの配列。

型: 文字列間のマッピング

必須: いいえ

type

作成するアナライザーのタイプ。ACCOUNT、ORGANIZATIONACCOUNT_UNUSED_ACCESS、ORGANIZTAION_UNUSED_ACCESSおよびアナライザーのみがサポートされます。1 つのアカウント、1 つのリージョンにつき 1 つのアナライザーしか作成できません。1 つの組織、1 つのリージョンにつき最大 5 つのアナライザーを作成できます。

タイプ: 文字列

有効な値: ACCOUNT | ORGANIZATION | ACCOUNT_UNUSED_ACCESS | ORGANIZATION_UNUSED_ACCESS

必須: はい

レスポンスの構文

HTTP/1.1 200
Content-type: application/json

{
   "arn": "string"
}

レスポンス要素

アクションが成功すると、サービスは HTTP 200 レスポンスを返します。

サービスから以下のデータが JSON 形式で返されます。

arn

リクエストによって作成されたアナライザーの ARN。

型: 文字列

パターン: [^:]*:[^:]*:[^:]*:[^:]*:[^:]*:analyzer/.{1,255}

エラー

すべてのアクションに共通のエラーについては、「共通エラー」を参照してください。

AccessDeniedException

このアクションを実行する十分なアクセス権限がありません。

HTTP ステータスコード: 403

ConflictException

コンフリクト例外エラー。

HTTP ステータスコード: 409

InternalServerException

内部サーバーエラー。

HTTP ステータスコード: 500

ServiceQuotaExceededException

サービスクォートミートエラー。

HTTP ステータスコード: 402

ThrottlingException

スロットリング制限超過エラー。

HTTP ステータスコード: 429

ValidationException

検証例外エラー。

HTTP ステータスコード: 400

以下の資料も参照してください。

言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。