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

# ValidatePolicy
<a name="API_ValidatePolicy"></a>

請求驗證政策並傳回問題清單。這些調查結果可協助您識別問題並提供可行的建議，以解決問題，並讓您能夠撰寫符合安全最佳實務的功能政策。

## 請求語法
<a name="API_ValidatePolicy_RequestSyntax"></a>

```
POST /policy/validation?maxResults=maxResults&nextToken=nextToken HTTP/1.1
Content-type: application/json

{
   "locale": "string",
   "policyDocument": "string",
   "policyType": "string",
   "validatePolicyResourceType": "string"
}
```

## URI 請求參數
<a name="API_ValidatePolicy_RequestParameters"></a>

請求會使用下列 URI 參數。

 ** [maxResults](#API_ValidatePolicy_RequestSyntax) **   <a name="accessanalyzer-ValidatePolicy-request-uri-maxResults"></a>
在回應中傳回的結果數目上限。

 ** [nextToken](#API_ValidatePolicy_RequestSyntax) **   <a name="accessanalyzer-ValidatePolicy-request-uri-nextToken"></a>
用於傳回結果分頁的字符。

## 請求主體
<a name="API_ValidatePolicy_RequestBody"></a>

請求接受採用 JSON 格式的下列資料。

 ** [locale](#API_ValidatePolicy_RequestSyntax) **   <a name="accessanalyzer-ValidatePolicy-request-locale"></a>
用於本地化問題清單的地區設定。  
類型：字串  
有效值:`DE | EN | ES | FR | IT | JA | KO | PT_BR | ZH_CN | ZH_TW`   
必要：否

 ** [policyDocument](#API_ValidatePolicy_RequestSyntax) **   <a name="accessanalyzer-ValidatePolicy-request-policyDocument"></a>
用作政策內容的 JSON 政策文件。  
類型：字串  
必要：是

 ** [policyType](#API_ValidatePolicy_RequestSyntax) **   <a name="accessanalyzer-ValidatePolicy-request-policyType"></a>
要驗證的政策類型。身分政策會將許可授予 IAM 主體。身分政策包括 IAM 角色、使用者和群組的受管和內嵌政策。  
資源政策會授予 AWS 資源的許可。資源政策包含 IAM 角色的信任政策，以及 Amazon S3 儲存貯體的儲存貯體政策。您可以提供一般輸入，例如身分政策或資源政策，或特定輸入，例如受管政策或 Amazon S3 儲存貯體政策。  
服務控制政策 SCPs) 是一種連接到組織、組織單位 AWS (OU) 或 帳戶的組織政策類型。  
類型：字串  
有效值:`IDENTITY_POLICY | RESOURCE_POLICY | SERVICE_CONTROL_POLICY | RESOURCE_CONTROL_POLICY`   
必要：是

 ** [validatePolicyResourceType](#API_ValidatePolicy_RequestSyntax) **   <a name="accessanalyzer-ValidatePolicy-request-validatePolicyResourceType"></a>
要連接到資源政策的資源類型。只有在政策類型為 時，才指定政策驗證資源類型的值`RESOURCE_POLICY`。例如，若要驗證要連接到 Amazon S3 儲存貯體的資源政策，您可以選擇`AWS::S3::Bucket`政策驗證資源類型。  
對於不支援為有效值的資源類型，IAM Access Analyzer 會執行套用至所有資源政策的政策檢查。例如，若要驗證要連接到 KMS 金鑰的資源政策，請勿指定政策驗證資源類型的值，IAM Access Analyzer 將執行適用於所有資源政策的政策檢查。  
類型：字串  
有效值:`AWS::S3::Bucket | AWS::S3::AccessPoint | AWS::S3::MultiRegionAccessPoint | AWS::S3ObjectLambda::AccessPoint | AWS::IAM::AssumeRolePolicyDocument | AWS::DynamoDB::Table`   
必要：否

## 回應語法
<a name="API_ValidatePolicy_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "findings": [ 
      { 
         "findingDetails": "string",
         "findingType": "string",
         "issueCode": "string",
         "learnMoreLink": "string",
         "locations": [ 
            { 
               "path": [ 
                  { ... }
               ],
               "span": { 
                  "end": { 
                     "column": number,
                     "line": number,
                     "offset": number
                  },
                  "start": { 
                     "column": number,
                     "line": number,
                     "offset": number
                  }
               }
            }
         ]
      }
   ],
   "nextToken": "string"
}
```

## 回應元素
<a name="API_ValidatePolicy_ResponseElements"></a>

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

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

 ** [findings](#API_ValidatePolicy_ResponseSyntax) **   <a name="accessanalyzer-ValidatePolicy-response-findings"></a>
IAM Access Analyzer 根據政策檢查套件傳回之政策中的調查結果清單。  
類型：[ValidatePolicyFinding](API_ValidatePolicyFinding.md) 物件陣列

 ** [nextToken](#API_ValidatePolicy_ResponseSyntax) **   <a name="accessanalyzer-ValidatePolicy-response-nextToken"></a>
用於傳回結果分頁的字符。  
類型：字串

## 錯誤
<a name="API_ValidatePolicy_Errors"></a>

如需所有動作常見錯誤的資訊，請參閱[常見錯誤類型](CommonErrors.md)。

 ** AccessDeniedException **   
您沒有足夠存取權可執行此動作。  
HTTP 狀態碼：403

 ** InternalServerException **   
內部伺服器錯誤。    
 ** retryAfterSeconds **   
等待重試的秒數。
HTTP 狀態碼：500

 ** ThrottlingException **   
限流限制超過錯誤。    
 ** retryAfterSeconds **   
等待重試的秒數。
HTTP 狀態碼：429

 ** ValidationException **   
驗證例外狀況錯誤。    
 ** fieldList **   
未驗證的欄位清單。  
 ** reason **   
例外狀況的原因。
HTTP 狀態碼：400

## 另請參閱
<a name="API_ValidatePolicy_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/accessanalyzer-2019-11-01/ValidatePolicy) 
+  [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/accessanalyzer-2019-11-01/ValidatePolicy) 
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/accessanalyzer-2019-11-01/ValidatePolicy) 
+  [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/accessanalyzer-2019-11-01/ValidatePolicy) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/accessanalyzer-2019-11-01/ValidatePolicy) 
+  [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/accessanalyzer-2019-11-01/ValidatePolicy) 
+  [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/accessanalyzer-2019-11-01/ValidatePolicy) 
+  [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/accessanalyzer-2019-11-01/ValidatePolicy) 
+  [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/accessanalyzer-2019-11-01/ValidatePolicy) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/accessanalyzer-2019-11-01/ValidatePolicy)