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.

# CreateAnalysis
<a name="API_CreateAnalysis"></a>

Crée une analyse dans Amazon QuickSight.

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

```
POST /accounts/AwsAccountId/analyses/AnalysisId HTTP/1.1
Content-type: application/json

{
   "Name": "string",
   "Parameters": { 
      "DateTimeParameters": [ 
         { 
            "Name": "string",
            "Values": [ number ]
         }
      ],
      "DecimalParameters": [ 
         { 
            "Name": "string",
            "Values": [ number ]
         }
      ],
      "IntegerParameters": [ 
         { 
            "Name": "string",
            "Values": [ number ]
         }
      ],
      "StringParameters": [ 
         { 
            "Name": "string",
            "Values": [ "string" ]
         }
      ]
   },
   "Permissions": [ 
      { 
         "Actions": [ "string" ],
         "Principal": "string"
      }
   ],
   "SourceEntity": { 
      "SourceTemplate": { 
         "Arn": "string",
         "DataSetReferences": [ 
            { 
               "DataSetArn": "string",
               "DataSetPlaceholder": "string"
            }
         ]
      }
   },
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ],
   "ThemeArn": "string"
}
```

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

La demande utilise les paramètres URI suivants.

 ** [AnalysisId](#API_CreateAnalysis_RequestSyntax) **   <a name="QS-CreateAnalysis-request-AnalysisId"></a>
ID de l'analyse que vous créez. Cet ID s'affiche dans l'URL de l'analyse.  
Contraintes de longueur : Longueur minimale de 1. Longueur maximale de 2048.  
Modèle : `[\w\-]+`   
Obligatoire Oui

 ** [AwsAccountId](#API_CreateAnalysis_RequestSyntax) **   <a name="QS-CreateAnalysis-request-AwsAccountId"></a>
ID duAWScompte où vous créez une analyse.  
Contraintes de longueur : Longueur fixe de 12.  
Modèle : `^[0-9]{12}$`   
Obligatoire Oui

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

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

 ** [Name](#API_CreateAnalysis_RequestSyntax) **   <a name="QS-CreateAnalysis-request-Name"></a>
Nom descriptif de l'analyse que vous créez. Ce nom s'affiche pour l'analyse sur Amazon QuickSight console   
Type : Chaîne  
Contraintes de longueur : Longueur minimale de 1. Longueur maximale de 2048.  
Obligatoire Oui

 ** [SourceEntity](#API_CreateAnalysis_RequestSyntax) **   <a name="QS-CreateAnalysis-request-SourceEntity"></a>
Une entité source à utiliser pour l'analyse que vous créez. Cette structure de métadonnées contient des détails décrivant un modèle source et un ou plusieurs jeux de données.  
Type : objet [AnalysisSourceEntity](API_AnalysisSourceEntity.md)  
Obligatoire Oui

 ** [Parameters](#API_CreateAnalysis_RequestSyntax) **   <a name="QS-CreateAnalysis-request-Parameters"></a>
Les noms de paramètres et les valeurs de remplacement que vous souhaitez utiliser. Une analyse peut avoir n'importe quel type de paramètre, et certains paramètres peuvent accepter plusieurs valeurs.   
Type : objet [Parameters](API_Parameters.md)  
Obligatoire Non

 ** [Permissions](#API_CreateAnalysis_RequestSyntax) **   <a name="QS-CreateAnalysis-request-Permissions"></a>
Structure qui décrit les principaux et les autorisations au niveau des ressources sur une analyse. Vous pouvez utiliser le plugin`Permissions`structure pour accorder des autorisations en fournissant une liste deGestion des identités et des accès AWS(IAM) pour chaque entité répertoriée par Amazon Resource Name (ARN).   
Pour ne spécifier aucune autorisation, omettez`Permissions`.  
Type : Tableau de[ResourcePermission](API_ResourcePermission.md)objets  
Membres du tableau Nombre minimum de 1 élément. Nombre maximum de 64 éléments.  
Obligatoire Non

 ** [Tags](#API_CreateAnalysis_RequestSyntax) **   <a name="QS-CreateAnalysis-request-Tags"></a>
Contient une carte des paires clé-valeur pour la ou les balises de ressource affectées à l'analyse.  
Type : Tableau de[Tag](API_Tag.md)objets  
Membres du tableau Nombre minimum de 1 élément. Nombre maximum de 200 éléments.  
Obligatoire Non

 ** [ThemeArn](#API_CreateAnalysis_RequestSyntax) **   <a name="QS-CreateAnalysis-request-ThemeArn"></a>
L'ARN du thème à appliquer à l'analyse que vous créez. Pour voir le thème sur Amazon QuickSight , veillez à prendre connaissance de la section.  
Type : Chaîne  
Obligatoire Non

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

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

{
   "AnalysisId": "string",
   "Arn": "string",
   "CreationStatus": "string",
   "RequestId": "string"
}
```

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

Si l'action aboutit, le service renvoie la réponse HTTP suivante.

 ** [Status](#API_CreateAnalysis_ResponseSyntax) **   <a name="QS-CreateAnalysis-response-Status"></a>
Le statut HTTP de la requête.

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

 ** [AnalysisId](#API_CreateAnalysis_ResponseSyntax) **   <a name="QS-CreateAnalysis-response-AnalysisId"></a>
ID de l'analyse.  
Type : Chaîne  
Contraintes de longueur : Longueur minimale de 1. Longueur maximale de 2048.  
Modèle : `[\w\-]+` 

 ** [Arn](#API_CreateAnalysis_ResponseSyntax) **   <a name="QS-CreateAnalysis-response-Arn"></a>
ARN pour l'analyse.  
Type : Chaîne

 ** [CreationStatus](#API_CreateAnalysis_ResponseSyntax) **   <a name="QS-CreateAnalysis-response-CreationStatus"></a>
Statut de la création de l'analyse.   
Type : Chaîne  
Valeurs valides :` CREATION_IN_PROGRESS | CREATION_SUCCESSFUL | CREATION_FAILED | UPDATE_IN_PROGRESS | UPDATE_SUCCESSFUL | UPDATE_FAILED | DELETED` 

 ** [RequestId](#API_CreateAnalysis_ResponseSyntax) **   <a name="QS-CreateAnalysis-response-RequestId"></a>
LeAWSID de demande pour cette opération.  
Type : Chaîne

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

Pour plus d'informations sur les erreurs communes à toutes les actions, consultez[Erreurs courantes](CommonErrors.md).

 ** ConflictException **   
La mise à jour ou la suppression d'une ressource peut entraîner un état incohérent.  
HTTP : 409

 ** InternalFailureException **   
Une défaillance interne s'est produite.  
HTTP : 500

 ** InvalidParameterValueException **   
La valeur d'un ou de plusieurs paramètres n'est pas valide.  
HTTP : 400

 ** ResourceExistsException **   
La ressource spécifiée existe déjà.   
HTTP : 409

 ** ResourceNotFoundException **   
Une ou plusieurs ressources n'y sont pas trouvées.  
HTTP : 404

 ** ThrottlingException **   
L'accès est limité.  
HTTP : 429

 ** UnsupportedUserEditionException **   
Cette erreur indique que vous appelez une opération portant sur Amazon QuickSightabonnement dont l'édition n'inclut pas la prise en charge de cette opération. Amazon QuickSight dispose actuellement des éditions Standard Edition et Enterprise Edition. Toutes les opérations et fonctionnalités ne sont pas disponibles dans chaque édition.  
HTTP : 403

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

Pour plus d'informations sur l'utilisation de cette API dans l'un des kits SDK AWS spécifiques au langage, consultez les ressources suivantes :
+  [Interface de ligne de commande AWS](https://docs.aws.amazon.com/goto/aws-cli/quicksight-2018-04-01/CreateAnalysis) 
+  [AWS SDK pour .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/quicksight-2018-04-01/CreateAnalysis) 
+  [Kit AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/quicksight-2018-04-01/CreateAnalysis) 
+  [Kit AWS SDK pour Go](https://docs.aws.amazon.com/goto/SdkForGoV1/quicksight-2018-04-01/CreateAnalysis) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/quicksight-2018-04-01/CreateAnalysis) 
+  [AWSKits SDK JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/quicksight-2018-04-01/CreateAnalysis) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/quicksight-2018-04-01/CreateAnalysis) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/quicksight-2018-04-01/CreateAnalysis) 
+  [Kit SDK AWS pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/quicksight-2018-04-01/CreateAnalysis)