CreateAnalyzer - IAM Access Analyzer

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

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 物件

注意:這個對象是一個聯集。只能指定或返回此對象的一個成員。

必要:否

tags

要套用至分析器的索引鍵值對陣列。

類型:字串到字串映射

必要:否

type

要建立的分析器類型。僅支援ACCOUNTORGANIZATIONACCOUNT_UNUSED_ACCESS、、和ORGANIZATION_UNUSED_ACCESS分析器。每個區域每個帳戶只能建立一個分析器。每個區域最多可以為每個組織建立 5 個分析器。

類型:字串

有效值:ACCOUNT | ORGANIZATION | ACCOUNT_UNUSED_ACCESS | ORGANIZATION_UNUSED_ACCESS

必要:是

回應語法

HTTP/1.1 200 Content-type: application/json { "arn": "string" }

回應元素

如果動作成功,則服務傳回 HTTP 200 回應。

服務會傳回下列 JSON 格式的資料。

arn

要求所建立之分析器的 ARN。

類型:String

模式:[^:]*:[^:]*:[^:]*:[^:]*:[^:]*:analyzer/.{1,255}

錯誤

如需所有動作常見錯誤的資訊,請參閱常見錯誤

AccessDeniedException

您沒有足夠存取權可執行此動作。

HTTP 狀態碼:403

ConflictException

衝突例外狀況錯誤。

HTTP 狀態碼:409

InternalServerException

內部伺服器錯誤。

HTTP 狀態碼:500

ServiceQuotaExceededException

服務報價遇到錯誤。

狀態碼:

ThrottlingException

節流限制超過錯誤。

HTTP 狀態碼:429

ValidationException

驗證異常錯誤。

HTTP 狀態碼:400

另請參閱

如需在其中一個特定語言 AWS SDK 中使用此 API 的詳細資訊,請參閱下列內容: