As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

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

Solicita a validação de uma política e retorna uma lista das descobertas. As descobertas ajudam a identificar problemas e fornecem recomendações práticas para resolver o problema e permitem que você crie políticas funcionais que atendam às melhores práticas de segurança. 

## Sintaxe da Solicitação
<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"
}
```

## Parâmetros da Solicitação de URI
<a name="API_ValidatePolicy_RequestParameters"></a>

A solicitação usa os seguintes parâmetros de URI:

 ** [maxResults](#API_ValidatePolicy_RequestSyntax) **   <a name="accessanalyzer-ValidatePolicy-request-uri-maxResults"></a>
O número máximo de resultados a serem retornados na resposta.

 ** [nextToken](#API_ValidatePolicy_RequestSyntax) **   <a name="accessanalyzer-ValidatePolicy-request-uri-nextToken"></a>
Um token usado para paginação dos resultados retornados.

## Corpo da Solicitação
<a name="API_ValidatePolicy_RequestBody"></a>

A solicitação aceita os dados a seguir no formato JSON.

 ** [locale](#API_ValidatePolicy_RequestSyntax) **   <a name="accessanalyzer-ValidatePolicy-request-locale"></a>
O local a ser usado para localizar as descobertas.  
Tipo: string  
Valores válidos: `DE | EN | ES | FR | IT | JA | KO | PT_BR | ZH_CN | ZH_TW`   
Obrigatório: não

 ** [policyDocument](#API_ValidatePolicy_RequestSyntax) **   <a name="accessanalyzer-ValidatePolicy-request-policyDocument"></a>
O documento de política JSON a ser usado como conteúdo da política.  
Tipo: String  
Obrigatório: Sim

 ** [policyType](#API_ValidatePolicy_RequestSyntax) **   <a name="accessanalyzer-ValidatePolicy-request-policyType"></a>
O tipo de política a ser validada. As políticas de identidade concedem permissões aos diretores do IAM. As políticas de identidade incluem políticas gerenciadas e em linha para funções, usuários e grupos do IAM.  
As políticas de recursos concedem permissões sobre AWS os recursos. As políticas de recursos incluem políticas de confiança para funções do IAM e políticas de bucket para buckets do Amazon S3. Você pode fornecer uma entrada genérica, como política de identidade ou política de recursos, ou uma entrada específica, como política gerenciada ou política de bucket do Amazon S3.   
As políticas de controle de serviço (SCPs) são um tipo de política organizacional vinculada a uma AWS organização, unidade organizacional (OU) ou conta.  
Tipo: string  
Valores válidos: `IDENTITY_POLICY | RESOURCE_POLICY | SERVICE_CONTROL_POLICY | RESOURCE_CONTROL_POLICY`   
Obrigatório: Sim

 ** [validatePolicyResourceType](#API_ValidatePolicy_RequestSyntax) **   <a name="accessanalyzer-ValidatePolicy-request-validatePolicyResourceType"></a>
O tipo de recurso a ser anexado à sua política de recursos. Especifique um valor para o tipo de recurso de validação de política somente se o tipo de política for`RESOURCE_POLICY`. Por exemplo, para validar uma política de recursos a ser anexada a um bucket do Amazon S3, você pode `AWS::S3::Bucket` escolher o tipo de recurso de validação da política.  
Para tipos de recursos não suportados como valores válidos, o IAM Access Analyzer executa verificações de políticas que se aplicam a todas as políticas de recursos. Por exemplo, para validar uma política de recursos a ser anexada a uma chave KMS, não especifique um valor para o tipo de recurso de validação da política e o IAM Access Analyzer executará verificações de política que se aplicam a todas as políticas de recursos.  
Tipo: string  
Valores válidos: `AWS::S3::Bucket | AWS::S3::AccessPoint | AWS::S3::MultiRegionAccessPoint | AWS::S3ObjectLambda::AccessPoint | AWS::IAM::AssumeRolePolicyDocument | AWS::DynamoDB::Table`   
Obrigatório: não

## Sintaxe da resposta
<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"
}
```

## Elementos de resposta
<a name="API_ValidatePolicy_ResponseElements"></a>

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.

Os dados a seguir são retornados no formato JSON pelo serviço.

 ** [findings](#API_ValidatePolicy_ResponseSyntax) **   <a name="accessanalyzer-ValidatePolicy-response-findings"></a>
A lista de descobertas em uma política retornada pelo IAM Access Analyzer com base em seu conjunto de verificações de políticas.  
Tipo: matriz de objetos [ValidatePolicyFinding](API_ValidatePolicyFinding.md)

 ** [nextToken](#API_ValidatePolicy_ResponseSyntax) **   <a name="accessanalyzer-ValidatePolicy-response-nextToken"></a>
Um token usado para paginação dos resultados retornados.  
Tipo: string

## Erros
<a name="API_ValidatePolicy_Errors"></a>

Para obter informações sobre os erros que são comuns a todas as ações, consulte [Tipos de erro comuns](CommonErrors.md).

 ** AccessDeniedException **   
Você não tem acesso suficiente para executar esta ação.  
Código de status HTTP: 403

 ** InternalServerException **   
Erro interno do servidor.    
 ** retryAfterSeconds **   
Os segundos de espera para tentar novamente.
Código de status HTTP: 500

 ** ThrottlingException **   
Erro de limite de limitação excedido.    
 ** retryAfterSeconds **   
Os segundos de espera para tentar novamente.
Código de status HTTP: 429

 ** ValidationException **   
Erro de exceção de validação.    
 ** fieldList **   
Uma lista de campos que não foram validados.  
 ** reason **   
O motivo da exceção.
Código de Status HTTP: 400

## Consulte também
<a name="API_ValidatePolicy_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/accessanalyzer-2019-11-01/ValidatePolicy) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/accessanalyzer-2019-11-01/ValidatePolicy) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/accessanalyzer-2019-11-01/ValidatePolicy) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/accessanalyzer-2019-11-01/ValidatePolicy) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/accessanalyzer-2019-11-01/ValidatePolicy) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/accessanalyzer-2019-11-01/ValidatePolicy) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/accessanalyzer-2019-11-01/ValidatePolicy) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/accessanalyzer-2019-11-01/ValidatePolicy) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/accessanalyzer-2019-11-01/ValidatePolicy) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/accessanalyzer-2019-11-01/ValidatePolicy)