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

# CreateAccessPreview
<a name="API_CreateAccessPreview"></a>

Crea un'anteprima di accesso che ti consente di visualizzare in anteprima i risultati di IAM Access Analyzer per la tua risorsa prima di distribuire le autorizzazioni delle risorse.

## Sintassi della richiesta
<a name="API_CreateAccessPreview_RequestSyntax"></a>

```
PUT /access-preview HTTP/1.1
Content-type: application/json

{
   "analyzerArn": "string",
   "clientToken": "string",
   "configurations": { 
      "string" : { ... }
   }
}
```

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

La richiesta non utilizza parametri URI.

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

La richiesta accetta i seguenti dati in formato JSON.

 ** [analyzerArn](#API_CreateAccessPreview_RequestSyntax) **   <a name="accessanalyzer-CreateAccessPreview-request-analyzerArn"></a>
L'[ARN dell'analizzatore di account utilizzato per generare l'](https://docs.aws.amazon.com/IAM/latest/UserGuide/access-analyzer-getting-started.html#permission-resources)anteprima degli accessi. È possibile creare un'anteprima di accesso solo per gli analizzatori con un tipo e uno `Account` stato. `Active`  
Tipo: stringa  
Modello: `[^:]*:[^:]*:[^:]*:[^:]*:[^:]*:analyzer/.{1,255}`   
Obbligatorio: sì

 ** [clientToken](#API_CreateAccessPreview_RequestSyntax) **   <a name="accessanalyzer-CreateAccessPreview-request-clientToken"></a>
Un token client.  
▬Tipo: stringa  
Obbligatorio: no

 ** [configurations](#API_CreateAccessPreview_RequestSyntax) **   <a name="accessanalyzer-CreateAccessPreview-request-configurations"></a>
Configurazione del controllo degli accessi per la risorsa utilizzata per generare l'anteprima di accesso. L'anteprima dell'accesso include i risultati dell'accesso esterno consentito alla risorsa con la configurazione di controllo degli accessi proposta. La configurazione deve contenere esattamente un elemento.  
Tipo: mappa da stringa a [Configuration](API_Configuration.md) oggetto  
Obbligatorio: sì

## Sintassi della risposta
<a name="API_CreateAccessPreview_ResponseSyntax"></a>

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

{
   "id": "string"
}
```

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

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

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

 ** [id](#API_CreateAccessPreview_ResponseSyntax) **   <a name="accessanalyzer-CreateAccessPreview-response-id"></a>
L'ID univoco per l'anteprima dell'accesso.  
Tipo: stringa  
Modello: `[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` 

## Errori
<a name="API_CreateAccessPreview_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

 ** ConflictException **   
Un errore di eccezione in caso di conflitto.    
 ** resourceId **   
L'ID della risorsa.  
 ** resourceType **   
Il tipo di risorsa.
Codice di stato HTTP: 409

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

 ** ResourceNotFoundException **   
La risorsa specificata non è stata trovata.    
 ** resourceId **   
L'ID della risorsa.  
 ** resourceType **   
Il tipo di risorsa.
Codice di stato HTTP: 404

 ** ServiceQuotaExceededException **   
Errore relativo al preventivo di assistenza.    
 ** resourceId **   
L'ID della risorsa.  
 ** resourceType **   
Il tipo di risorsa.
Codice di stato HTTP: 402

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

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