本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
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。您只能為具有
Account類型和Active狀態的分析器建立存取預覽。類型：String
模式：
[^:]*:[^:]*:[^:]*:[^:]*:[^:]*:analyzer/.{1,255}必要：是
- clientToken
-
用戶端權杖。
類型：字串
必要：否
- configurations
-
用於產生存取預覽之資源的存取控制組態。存取預覽包括允許具有提議存取控制組態之資源的外部存取的發現項目。組態必須只包含一個元素。
類型：字串至Configuration物件對映
必要：是
回應語法
HTTP/1.1 200
Content-type: application/json
{
"id": "string"
}回應元素
如果動作成功，則服務傳回 HTTP 200 回應。
服務會傳回下列 JSON 格式的資料。
- id
-
存取預覽的唯一 ID。
類型：String
模式：
[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
-
服務報價遇到錯誤。
狀態碼：
- ThrottlingException
-
節流限制超過錯誤。
HTTP 狀態碼：429
- ValidationException
-
驗證異常錯誤。
HTTP 狀態碼：400
另請參閱
如需在其中一個特定語言 AWS SDK 中使用此 API 的詳細資訊，請參閱下列內容：
