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

# CheckAccessNotGranted
<a name="API_CheckAccessNotGranted"></a>

Verifica se o acesso especificado não é permitido por uma política.

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

```
POST /policy/check-access-not-granted HTTP/1.1
Content-type: application/json

{
   "access": [ 
      { 
         "actions": [ "string" ],
         "resources": [ "string" ]
      }
   ],
   "policyDocument": "string",
   "policyType": "string"
}
```

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

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

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

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

 ** [access](#API_CheckAccessNotGranted_RequestSyntax) **   <a name="accessanalyzer-CheckAccessNotGranted-request-access"></a>
Um objeto de acesso contendo as permissões que não devem ser concedidas pela política especificada. Se somente ações forem especificadas, o IAM Access Analyzer verificará o acesso para realizar pelo menos uma das ações em qualquer recurso na política. Se somente os recursos forem especificados, o IAM Access Analyzer verificará o acesso para realizar qualquer ação em pelo menos um dos recursos. Se as ações e os recursos forem especificados, o IAM Access Analyzer verifica o acesso para realizar pelo menos uma das ações especificadas em pelo menos um dos recursos especificados.  
Tipo: matriz de objetos [Access](API_Access.md)  
Membros da Matriz: número mínimo de 0 itens. Número máximo de 1 item.  
Obrigatório: Sim

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

## Sintaxe da resposta
<a name="API_CheckAccessNotGranted_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_CheckAccessNotGranted_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_CheckAccessNotGranted_ResponseSyntax) **   <a name="accessanalyzer-CheckAccessNotGranted-response-message"></a>
A mensagem indicando se o acesso especificado é permitido.  
Tipo: string

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

 ** [result](#API_CheckAccessNotGranted_ResponseSyntax) **   <a name="accessanalyzer-CheckAccessNotGranted-response-result"></a>
O resultado da verificação para verificar se o acesso é permitido. Se o resultado for`PASS`, a política especificada não permite nenhuma das permissões especificadas no objeto de acesso. Se o resultado for`FAIL`, a política especificada poderá permitir algumas ou todas as permissões no objeto de acesso.  
Tipo: string  
Valores válidos: `PASS | FAIL` 

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