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á.

# CheckNoNewAccess
<a name="API_CheckNoNewAccess"></a>

Verifica se um novo acesso é permitido para uma política atualizada em comparação com a política existente.

Você pode encontrar exemplos de políticas de referência e aprender como configurar e executar uma verificação de política personalizada para novos acessos no repositório de [amostras de verificações de políticas personalizadas do IAM Access Analyzer](https://github.com/aws-samples/iam-access-analyzer-custom-policy-check-samples) em. GitHub As políticas de referência nesse repositório devem ser passadas para o parâmetro de `existingPolicyDocument` solicitação.

## Sintaxe da Solicitação
<a name="API_CheckNoNewAccess_RequestSyntax"></a>

```
POST /policy/check-no-new-access HTTP/1.1
Content-type: application/json

{
   "existingPolicyDocument": "string",
   "newPolicyDocument": "string",
   "policyType": "string"
}
```

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

A solicitação não usa nenhum parâmetro de URI.

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

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

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

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

 ** [policyType](#API_CheckNoNewAccess_RequestSyntax) **   <a name="accessanalyzer-CheckNoNewAccess-request-policyType"></a>
O tipo de política a ser comparada. 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.  
Tipo: string  
Valores válidos: `IDENTITY_POLICY | RESOURCE_POLICY`   
Obrigatório: sim

## Sintaxe da resposta
<a name="API_CheckNoNewAccess_ResponseSyntax"></a>

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

{
   "message": "string",
   "reasons": [ 
      { 
         "description": "string",
         "statementId": "string",
         "statementIndex": number
      }
   ],
   "result": "string"
}
```

## Elementos de resposta
<a name="API_CheckNoNewAccess_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.

 ** [message](#API_CheckNoNewAccess_ResponseSyntax) **   <a name="accessanalyzer-CheckNoNewAccess-response-message"></a>
A mensagem indicando se a política atualizada permite novos acessos.  
Tipo: string

 ** [reasons](#API_CheckNoNewAccess_ResponseSyntax) **   <a name="accessanalyzer-CheckNoNewAccess-response-reasons"></a>
Uma descrição do raciocínio do resultado.  
Tipo: matriz de objetos [ReasonSummary](API_ReasonSummary.md)

 ** [result](#API_CheckNoNewAccess_ResponseSyntax) **   <a name="accessanalyzer-CheckNoNewAccess-response-result"></a>
O resultado da verificação de novos acessos. Se o resultado for`PASS`, nenhum novo acesso será permitido pela política atualizada. Se o resultado for`FAIL`, a política atualizada poderá permitir um novo acesso.  
Tipo: string  
Valores válidos: `PASS | FAIL` 

## Erros
<a name="API_CheckNoNewAccess_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

 ** InvalidParameterException **   
O parâmetro especificado é inválido.  
Código de status HTTP: 400

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

 ** UnprocessableEntityException **   
A entidade especificada não pôde ser processada.  
Código de status HTTP: 422

 ** 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_CheckNoNewAccess_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/CheckNoNewAccess) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/accessanalyzer-2019-11-01/CheckNoNewAccess) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/accessanalyzer-2019-11-01/CheckNoNewAccess) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/accessanalyzer-2019-11-01/CheckNoNewAccess) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/accessanalyzer-2019-11-01/CheckNoNewAccess) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/accessanalyzer-2019-11-01/CheckNoNewAccess) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/accessanalyzer-2019-11-01/CheckNoNewAccess) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/accessanalyzer-2019-11-01/CheckNoNewAccess) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/accessanalyzer-2019-11-01/CheckNoNewAccess) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/accessanalyzer-2019-11-01/CheckNoNewAccess)