Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

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

Crée un aperçu des accès qui vous permet de prévisualiser les résultats d'IAM Access Analyzer pour votre ressource avant de déployer les autorisations de ressource.

## Syntaxe de la demande
<a name="API_CreateAccessPreview_RequestSyntax"></a>

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

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

## Paramètres de demande URI
<a name="API_CreateAccessPreview_RequestParameters"></a>

La demande n’utilise pas de paramètres URI.

## Corps de la demande
<a name="API_CreateAccessPreview_RequestBody"></a>

Cette demande accepte les données suivantes au format JSON.

 ** [analyzerArn](#API_CreateAccessPreview_RequestSyntax) **   <a name="accessanalyzer-CreateAccessPreview-request-analyzerArn"></a>
L'[ARN de l'analyseur de compte ](https://docs.aws.amazon.com/IAM/latest/UserGuide/access-analyzer-getting-started.html#permission-resources) utilisé pour générer l'aperçu des accès. Vous ne pouvez créer un aperçu d'accès que pour les analyseurs, quels que soient leur `Account` type et `Active` leur statut.  
Type : Chaîne  
Modèle : `[^:]*:[^:]*:[^:]*:[^:]*:[^:]*:analyzer/.{1,255}`   
Obligatoire : oui

 ** [clientToken](#API_CreateAccessPreview_RequestSyntax) **   <a name="accessanalyzer-CreateAccessPreview-request-clientToken"></a>
Un jeton client.  
Type : chaîne  
Obligatoire : non

 ** [configurations](#API_CreateAccessPreview_RequestSyntax) **   <a name="accessanalyzer-CreateAccessPreview-request-configurations"></a>
Configuration du contrôle d'accès pour votre ressource utilisée pour générer l'aperçu des accès. L'aperçu des accès inclut les résultats relatifs à l'accès externe autorisé à la ressource avec la configuration de contrôle d'accès proposée. La configuration doit contenir exactement un élément.  
Type : mappage de la chaîne à [Configuration](API_Configuration.md) l'objet  
Obligatoire : oui

## Syntaxe de la réponse
<a name="API_CreateAccessPreview_ResponseSyntax"></a>

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

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

## Eléments de réponse
<a name="API_CreateAccessPreview_ResponseElements"></a>

Si l’action aboutit, le service renvoie une réponse HTTP 200.

Les données suivantes sont renvoyées au format JSON par le service.

 ** [id](#API_CreateAccessPreview_ResponseSyntax) **   <a name="accessanalyzer-CreateAccessPreview-response-id"></a>
L'identifiant unique pour l'aperçu de l'accès.  
Type : Chaîne  
Modèle : `[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` 

## Erreurs
<a name="API_CreateAccessPreview_Errors"></a>

Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Types d'erreurs courants](CommonErrors.md).

 ** AccessDeniedException **   
Vous ne disposez pas d’un accès suffisant pour effectuer cette action.  
Code d’état HTTP : 403

 ** ConflictException **   
Une erreur d'exception de conflit.    
 ** resourceId **   
ID de la ressource.  
 ** resourceType **   
Type de ressource.
Code d’état HTTP : 409

 ** InternalServerException **   
Erreur de serveur interne.    
 ** retryAfterSeconds **   
Les secondes à attendre avant de réessayer.
Code d’état HTTP : 500

 ** ResourceNotFoundException **   
La ressource spécifiée est introuvable.    
 ** resourceId **   
ID de la ressource.  
 ** resourceType **   
Type de la ressource.
Code d’état HTTP :404

 ** ServiceQuotaExceededException **   
Le devis de service a rencontré une erreur.    
 ** resourceId **   
L'ID de la ressource.  
 ** resourceType **   
Type de ressource.
Code d'état HTTP : 402

 ** ThrottlingException **   
Erreur de dépassement de la limite d'étranglement.    
 ** retryAfterSeconds **   
Les secondes à attendre avant de réessayer.
Code d’état HTTP : 429

 ** ValidationException **   
Erreur d'exception de validation.    
 ** fieldList **   
Liste des champs qui n'ont pas été validés.  
 ** reason **   
La raison de l'exception.
Code d’état HTTP : 400

## Voir aussi
<a name="API_CreateAccessPreview_SeeAlso"></a>

Pour plus d'informations sur l'utilisation de cette API dans l'un des AWS kits SDK spécifiques à une langue, consultez les rubriques suivantes :
+  [AWS Interface de ligne de commande V2 ](https://docs.aws.amazon.com/goto/cli2/accessanalyzer-2019-11-01/CreateAccessPreview) 
+  [AWS SDK pour .NET V4 ](https://docs.aws.amazon.com/goto/DotNetSDKV4/accessanalyzer-2019-11-01/CreateAccessPreview) 
+  [AWS SDK pour C\+\+ ](https://docs.aws.amazon.com/goto/SdkForCpp/accessanalyzer-2019-11-01/CreateAccessPreview) 
+  [AWS SDK pour Go v2 ](https://docs.aws.amazon.com/goto/SdkForGoV2/accessanalyzer-2019-11-01/CreateAccessPreview) 
+  [AWS SDK pour Java V2 ](https://docs.aws.amazon.com/goto/SdkForJavaV2/accessanalyzer-2019-11-01/CreateAccessPreview) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/accessanalyzer-2019-11-01/CreateAccessPreview) 
+  [AWS SDK pour Kotlin ](https://docs.aws.amazon.com/goto/SdkForKotlin/accessanalyzer-2019-11-01/CreateAccessPreview) 
+  [AWS SDK pour PHP V3 ](https://docs.aws.amazon.com/goto/SdkForPHPV3/accessanalyzer-2019-11-01/CreateAccessPreview) 
+  [AWS SDK pour Python (Boto3) ](https://docs.aws.amazon.com/goto/boto3/accessanalyzer-2019-11-01/CreateAccessPreview) 
+  [AWS SDK pour Ruby V3 ](https://docs.aws.amazon.com/goto/SdkForRubyV3/accessanalyzer-2019-11-01/CreateAccessPreview)