

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

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

Verifica se l'accesso specificato non è consentito da una politica.

## Sintassi della richiesta
<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"
}
```

## Parametri della richiesta URI:
<a name="API_CheckAccessNotGranted_RequestParameters"></a>

La richiesta non utilizza parametri URI.

## Corpo della richiesta
<a name="API_CheckAccessNotGranted_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [access](#API_CheckAccessNotGranted_RequestSyntax) **   <a name="accessanalyzer-CheckAccessNotGranted-request-access"></a>
Un oggetto di accesso contenente le autorizzazioni che non devono essere concesse dalla politica specificata. Se vengono specificate solo azioni, IAM Access Analyzer verifica l'accesso per eseguire almeno una delle azioni su qualsiasi risorsa inclusa nella policy. Se vengono specificate solo risorse, IAM Access Analyzer verifica l'accesso per eseguire qualsiasi azione su almeno una delle risorse. Se vengono specificate sia le azioni che le risorse, IAM Access Analyzer verifica l'accesso per eseguire almeno una delle azioni specificate su almeno una delle risorse specificate.  
Tipo: matrice di oggetti [Access](API_Access.md)  
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 1 elemento.  
Obbligatorio: sì

 ** [policyDocument](#API_CheckAccessNotGranted_RequestSyntax) **   <a name="accessanalyzer-CheckAccessNotGranted-request-policyDocument"></a>
Il documento di policy JSON da utilizzare come contenuto per la policy.  
Tipo: stringa  
Obbligatorio: sì

 ** [policyType](#API_CheckAccessNotGranted_RequestSyntax) **   <a name="accessanalyzer-CheckAccessNotGranted-request-policyType"></a>
Il tipo di politica. Le politiche di identità concedono le autorizzazioni ai responsabili IAM. Le politiche di identità includono politiche gestite e in linea per ruoli, utenti e gruppi IAM.  
Le politiche relative alle risorse concedono le autorizzazioni sulle AWS risorse. Le policy relative alle risorse includono policy di fiducia per i ruoli IAM e policy di bucket per i bucket Amazon S3.  
Tipo: String  
Valori validi: `IDENTITY_POLICY | RESOURCE_POLICY`   
Obbligatorio: sì

## Sintassi della risposta
<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"
}
```

## Elementi di risposta
<a name="API_CheckAccessNotGranted_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [message](#API_CheckAccessNotGranted_ResponseSyntax) **   <a name="accessanalyzer-CheckAccessNotGranted-response-message"></a>
Il messaggio che indica se l'accesso specificato è consentito.  
Tipo: String

 ** [reasons](#API_CheckAccessNotGranted_ResponseSyntax) **   <a name="accessanalyzer-CheckAccessNotGranted-response-reasons"></a>
Una descrizione del ragionamento del risultato.  
Tipo: matrice di oggetti [ReasonSummary](API_ReasonSummary.md)

 ** [result](#API_CheckAccessNotGranted_ResponseSyntax) **   <a name="accessanalyzer-CheckAccessNotGranted-response-result"></a>
Il risultato della verifica se l'accesso è consentito. Se il risultato è`PASS`, la politica specificata non consente nessuna delle autorizzazioni specificate nell'oggetto di accesso. Se il risultato è`FAIL`, la politica specificata potrebbe consentire alcune o tutte le autorizzazioni nell'oggetto di accesso.  
Tipo: String  
Valori validi: `PASS | FAIL` 

## Errori
<a name="API_CheckAccessNotGranted_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).

 ** AccessDeniedException **   
Non disponi dell'autorizzazione di accesso sufficiente per eseguire questa operazione.  
Codice di stato HTTP: 403

 ** InternalServerException **   
Errore interno del server.    
 ** retryAfterSeconds **   
I secondi di attesa per riprovare.
Codice di stato HTTP: 500

 ** InvalidParameterException **   
Il parametro specificato non è valido.  
Codice di stato HTTP: 400

 ** ThrottlingException **   
Errore di limitazione superato.    
 ** retryAfterSeconds **   
I secondi di attesa per riprovare.
Codice di stato HTTP: 429

 ** UnprocessableEntityException **   
L'entità specificata non può essere elaborata.  
Codice di stato HTTP: 422

 ** ValidationException **   
Errore di eccezione di convalida.    
 ** fieldList **   
Un elenco di campi che non sono stati convalidati.  
 ** reason **   
Il motivo dell'eccezione.
Codice di stato HTTP: 400

## Vedi anche
<a name="API_CheckAccessNotGranted_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/accessanalyzer-2019-11-01/CheckAccessNotGranted) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/accessanalyzer-2019-11-01/CheckAccessNotGranted) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/accessanalyzer-2019-11-01/CheckAccessNotGranted) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/accessanalyzer-2019-11-01/CheckAccessNotGranted) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/accessanalyzer-2019-11-01/CheckAccessNotGranted) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/accessanalyzer-2019-11-01/CheckAccessNotGranted) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/accessanalyzer-2019-11-01/CheckAccessNotGranted) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/accessanalyzer-2019-11-01/CheckAccessNotGranted) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/accessanalyzer-2019-11-01/CheckAccessNotGranted) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/accessanalyzer-2019-11-01/CheckAccessNotGranted) 