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.

# CreateTemplate
<a name="API_CreateTemplate"></a>

Crée un modèle à partir d'un Amazon existant QuickSight une analyse ou un modèle. Vous pouvez utiliser le modèle résultant pour créer un tableau de bord.

UN*modèle*est une entité d'Amazon QuickSight qui encapsule les métadonnées requises pour créer une analyse et que vous pouvez utiliser pour créer un tableau de bord. Un modèle ajoute une couche d'abstraction en utilisant des espaces réservés pour remplacer l'ensemble de données associé à l'analyse. Vous pouvez utiliser des modèles pour créer des tableaux de bord en remplaçant des espaces réservés d'ensemble de données par des ensembles de données qui suivent la même structure que celle utilisée pour créer l'analyse source et le modèle.

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

```
POST /accounts/AwsAccountId/templates/TemplateId HTTP/1.1
Content-type: application/json

{
   "Name": "string",
   "Permissions": [ 
      { 
         "Actions": [ "string" ],
         "Principal": "string"
      }
   ],
   "SourceEntity": { 
      "SourceAnalysis": { 
         "Arn": "string",
         "DataSetReferences": [ 
            { 
               "DataSetArn": "string",
               "DataSetPlaceholder": "string"
            }
         ]
      },
      "SourceTemplate": { 
         "Arn": "string"
      }
   },
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ],
   "VersionDescription": "string"
}
```

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

La demande utilise les paramètres URI suivants.

 ** [AwsAccountId](#API_CreateTemplate_RequestSyntax) **   <a name="QS-CreateTemplate-request-AwsAccountId"></a>
ID duAWScompte dans lequel se trouve le groupe. Vous utilisez cet ID pourAWScompte qui contient votre Amazon QuickSight .  
Contraintes de longueur : Longueur fixe de 12.  
Modèle : `^[0-9]{12}$`   
Obligatoire : Oui

 ** [TemplateId](#API_CreateTemplate_RequestSyntax) **   <a name="QS-CreateTemplate-request-TemplateId"></a>
ID du modèle que vous souhaitez créer. Ce modèle est unique parRégion AWS; dans chaqueAWS.  
Contraintes de longueur : Longueur minimale de 1. Longueur maximale de 2048.  
Modèle : `[\w\-]+`   
Obligatoire : Oui

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

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

 ** [SourceEntity](#API_CreateTemplate_RequestSyntax) **   <a name="QS-CreateTemplate-request-SourceEntity"></a>
L'entité que vous utilisez comme source lorsque vous créez le modèle. Dans`SourceEntity`, vous spécifiez le type d'objet que vous utilisez comme source :`SourceTemplate`pour un modèle ou`SourceAnalysis`pour une analyse. Ces deux éléments ont besoin d'un Amazon Resource Name (ARN). Pour`SourceTemplate`, spécifiez l'ARN du modèle source. Pour`SourceAnalysis`, spécifiez l'ARN de l'analyse de la source. Le`SourceTemplate`L'ARN peut contenir n'importe quelAWScompte et n'importe quel compte Amazon QuickSight-pris en chargeRégion AWS.   
Utilisation de l'`DataSetReferences`entité au sein`SourceTemplate`ou`SourceAnalysis`pour répertorier les jeux de données de remplacement pour les espaces réservés répertoriés dans l'original. Le schéma de chaque jeu de données doit correspondre à son espace réservé.   
Type : objet [TemplateSourceEntity](API_TemplateSourceEntity.md)  
Obligatoire : Oui

 ** [Name](#API_CreateTemplate_RequestSyntax) **   <a name="QS-CreateTemplate-request-Name"></a>
Nom d'affichage du modèle.  
Type : Chaîne  
Contraintes de longueur : Longueur minimale de 1. Longueur maximale de 2048.  
Obligatoire : Non

 ** [Permissions](#API_CreateTemplate_RequestSyntax) **   <a name="QS-CreateTemplate-request-Permissions"></a>
Une liste des autorisations de ressources à définir sur le modèle.   
Type : Array de[ResourcePermission](API_ResourcePermission.md)objets  
Membres du tableau : Nombre minimal de 1 élément. Nombre maximum de 64 éléments.  
Obligatoire : Non

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

 ** [VersionDescription](#API_CreateTemplate_RequestSyntax) **   <a name="QS-CreateTemplate-request-VersionDescription"></a>
Description de la version actuelle du modèle en cours de création. Cette opération d'API crée la première version du modèle. À chaque fois`UpdateTemplate`est appelée, une nouvelle version est créée. Chaque version du modèle conserve une description de la version dans le`VersionDescription`.  
Type : Chaîne  
Contraintes de longueur : Longueur minimale de 1. Longueur maximale de 512.  
Obligatoire : Non

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

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

{
   "Arn": "string",
   "CreationStatus": "string",
   "RequestId": "string",
   "TemplateId": "string",
   "VersionArn": "string"
}
```

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

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

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

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

 ** [Arn](#API_CreateTemplate_ResponseSyntax) **   <a name="QS-CreateTemplate-response-Arn"></a>
L'ARN du modèle.  
Type : Chaîne

 ** [CreationStatus](#API_CreateTemplate_ResponseSyntax) **   <a name="QS-CreateTemplate-response-CreationStatus"></a>
Le statut de création du modèle.  
Type : Chaîne  
Valeurs valides :` CREATION_IN_PROGRESS | CREATION_SUCCESSFUL | CREATION_FAILED | UPDATE_IN_PROGRESS | UPDATE_SUCCESSFUL | UPDATE_FAILED | DELETED` 

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

 ** [TemplateId](#API_CreateTemplate_ResponseSyntax) **   <a name="QS-CreateTemplate-response-TemplateId"></a>
ID du modèle.  
Type : Chaîne  
Contraintes de longueur : Longueur minimale de 1. Longueur maximale de 2048.  
Modèle : `[\w\-]+` 

 ** [VersionArn](#API_CreateTemplate_ResponseSyntax) **   <a name="QS-CreateTemplate-response-VersionArn"></a>
L'ARN du modèle, y compris les informations de version de la première version.  
Type : Chaîne

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

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

 ** AccessDeniedException **   
Vous n'avez pas accès à cet élément. Les informations d'identification fournies n'ont pas pu être validées. Il est possible que vous ne soyez pas autorisé à effectuer la demande. Assurez-vous que votre compte est autorisé à utiliser Amazon QuickSight , que vos stratégies ont les autorisations appropriées et que vous utilisez les bonnes clés d'accès.  
HTTP Status Code d'état HTTP 401

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

 ** InternalFailureException **   
Une défaillance interne s'est produite.  
HTTP Status Code d'état HTTP 500

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

 ** LimitExceededException **   
Une limite est dépassée.  
HTTP Status Code d'état HTTP 409

 ** ResourceExistsException **   
La ressource spécifiée existe déjà.   
HTTP Status Code d'état HTTP 409

 ** ResourceNotFoundException **   
Une ou plusieurs ressources n'ont pas pu être trouvées.  
HTTP Status Code d'état HTTP 404

 ** ThrottlingException **   
L'accès est limité.  
HTTP Status Code d'état 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 Amazon QuickSight a actuellement les éditions Standard et Enterprise Edition. Toutes les opérations et fonctionnalités ne sont pas disponibles dans chaque édition.  
HTTP Status Code d'état HTTP 403

## Voir aussi
<a name="API_CreateTemplate_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/CreateTemplate) 
+  [AWS SDK pour .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/quicksight-2018-04-01/CreateTemplate) 
+  [Kit AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/quicksight-2018-04-01/CreateTemplate) 
+  [Kit AWS SDK pour Go](https://docs.aws.amazon.com/goto/SdkForGoV1/quicksight-2018-04-01/CreateTemplate) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/quicksight-2018-04-01/CreateTemplate) 
+  [AWSKits SDK pour JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/quicksight-2018-04-01/CreateTemplate) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/quicksight-2018-04-01/CreateTemplate) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/quicksight-2018-04-01/CreateTemplate) 
+  [Kit SDK AWS pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/quicksight-2018-04-01/CreateTemplate)