本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
ListAccessPreviewFindings
擷取指定存取預覽所產生的存取預覽調查結果清單。
請求語法
POST /access-preview/accessPreviewId HTTP/1.1
Content-type: application/json
{
"analyzerArn": "string",
"filter": {
"string" : {
"contains": [ "string" ],
"eq": [ "string" ],
"exists": boolean,
"neq": [ "string" ]
}
},
"maxResults": number,
"nextToken": "string"
}
URI 請求參數
請求會使用下列 URI 參數。
- accessPreviewId
-
存取預覽的唯一 ID。
模式:
[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}必要:是
請求主體
請求接受採用 JSON 格式的下列資料。
- analyzerArn
-
用於產生存取權的分析器 ARN。
類型:字串
模式:
[^:]*:[^:]*:[^:]*:[^:]*:[^:]*:analyzer/.{1,255}必要:是
- filter
-
篩選傳回問題清單的條件。
類型:字串到Criterion物件映射
必要:否
- maxResults
-
在回應中傳回的結果數目上限。
類型:整數
必要:否
- nextToken
-
用於傳回結果分頁的字符。
類型:字串
必要:否
回應語法
HTTP/1.1 200
Content-type: application/json
{
"findings": [
{
"action": [ "string" ],
"changeType": "string",
"condition": {
"string" : "string"
},
"createdAt": "string",
"error": "string",
"existingFindingId": "string",
"existingFindingStatus": "string",
"id": "string",
"isPublic": boolean,
"principal": {
"string" : "string"
},
"resource": "string",
"resourceControlPolicyRestriction": "string",
"resourceOwnerAccount": "string",
"resourceType": "string",
"sources": [
{
"detail": {
"accessPointAccount": "string",
"accessPointArn": "string"
},
"type": "string"
}
],
"status": "string"
}
],
"nextToken": "string"
}
回應元素
如果動作成功,則服務傳回 HTTP 200 回應。
服務會傳回下列 JSON 格式的資料。
- findings
-
符合指定篩選條件的存取預覽問題清單。
類型:AccessPreviewFinding 物件陣列
- nextToken
-
用於傳回結果分頁的字符。
類型:字串
錯誤
如需所有動作常見錯誤的資訊,請參閱常見錯誤。
- AccessDeniedException
-
您沒有足夠存取權可執行此動作。
HTTP 狀態碼:403
- ConflictException
-
衝突例外狀況錯誤。
- resourceId
-
資源的 ID。
- resourceType
-
資源類型。
HTTP 狀態碼:409
- InternalServerException
-
內部伺服器錯誤。
- retryAfterSeconds
-
等待重試的秒數。
HTTP 狀態碼:500
- ResourceNotFoundException
-
找不到指定的資源。
- resourceId
-
資源的 ID。
- resourceType
-
資源的類型。
HTTP 狀態碼:404
- ThrottlingException
-
限流限制超過錯誤。
- retryAfterSeconds
-
等待重試的秒數。
HTTP 狀態碼:429
- ValidationException
-
驗證例外狀況錯誤。
- fieldList
-
未驗證的欄位清單。
- reason
-
例外狀況的原因。
HTTP 狀態碼:400
另請參閱
如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊,請參閱下列內容: