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.

# CreateTheme
<a name="API_CreateTheme"></a>

Crée un thème.

Un *thème* est un ensemble d'options de configuration pour la couleur et la mise en page. Les thèmes s'appliquent aux analyses et aux tableaux de bord. Pour de plus amples informations, veuillez consulter[Utilisation de thèmes dans Amazon QuickSight](https://docs.aws.amazon.com/quicksight/latest/user/themes-in-quicksight.html)dans le*Amazon QuickSight Guide de l'utilisateur*.

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

```
POST /accounts/AwsAccountId/themes/ThemeId HTTP/1.1
Content-type: application/json

{
   "BaseThemeId": "string",
   "Configuration": { 
      "DataColorPalette": { 
         "Colors": [ "string" ],
         "EmptyFillColor": "string",
         "MinMaxGradient": [ "string" ]
      },
      "Sheet": { 
         "Tile": { 
            "Border": { 
               "Show": boolean
            }
         },
         "TileLayout": { 
            "Gutter": { 
               "Show": boolean
            },
            "Margin": { 
               "Show": boolean
            }
         }
      },
      "UIColorPalette": { 
         "Accent": "string",
         "AccentForeground": "string",
         "Danger": "string",
         "DangerForeground": "string",
         "Dimension": "string",
         "DimensionForeground": "string",
         "Measure": "string",
         "MeasureForeground": "string",
         "PrimaryBackground": "string",
         "PrimaryForeground": "string",
         "SecondaryBackground": "string",
         "SecondaryForeground": "string",
         "Success": "string",
         "SuccessForeground": "string",
         "Warning": "string",
         "WarningForeground": "string"
      }
   },
   "Name": "string",
   "Permissions": [ 
      { 
         "Actions": [ "string" ],
         "Principal": "string"
      }
   ],
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ],
   "VersionDescription": "string"
}
```

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

La demande utilise les paramètres URI suivants.

 ** [AwsAccountId](#API_CreateTheme_RequestSyntax) **   <a name="QS-CreateTheme-request-AwsAccountId"></a>
ID duAWScompte dans lequel vous souhaitez stocker le nouveau thème.   
Contraintes de longueur : Longueur fixe : 12.  
Modèle : `^[0-9]{12}$`   
Obligatoire : Oui

 ** [ThemeId](#API_CreateTheme_RequestSyntax) **   <a name="QS-CreateTheme-request-ThemeId"></a>
Un ID pour le thème que vous souhaitez créer. L'ID du thème est unique parRégion AWSdans chaqueAWS.  
Contraintes de longueur : Longueur minimale de 1. Longueur maximale de 2048.  
Modèle : `[\w\-]+`   
Obligatoire : Oui

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

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

 ** [BaseThemeId](#API_CreateTheme_RequestSyntax) **   <a name="QS-CreateTheme-request-BaseThemeId"></a>
ID du thème duquel un thème personnalisé hérite. Tous les thèmes héritent de l'un des thèmes de départ définis par Amazon QuickSight. Pour obtenir la liste des thèmes de départ, utilisez`ListThemes`ou choisissez**Themes**depuis l'intérieur d'une analyse.   
Type : Chaîne  
Contraintes de longueur : Longueur minimale de 1. Longueur maximale de 2048.  
Modèle : `[\w\-]+`   
Obligatoire : Oui

 ** [Configuration](#API_CreateTheme_RequestSyntax) **   <a name="QS-CreateTheme-request-Configuration"></a>
Configuration du thème, qui contient les propriétés d'affichage du thème.  
Type : objet [ThemeConfiguration](API_ThemeConfiguration.md)  
Obligatoire : Oui

 ** [Name](#API_CreateTheme_RequestSyntax) **   <a name="QS-CreateTheme-request-Name"></a>
Un nom complet pour le thème.  
Type : Chaîne  
Contraintes de longueur : Longueur minimale de 1. Longueur maximale de 2048.  
Obligatoire : Oui

 ** [Permissions](#API_CreateTheme_RequestSyntax) **   <a name="QS-CreateTheme-request-Permissions"></a>
Un groupe valide d'autorisations de ressources à appliquer au nouveau thème.   
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_CreateTheme_RequestSyntax) **   <a name="QS-CreateTheme-request-Tags"></a>
Carte des paires clé-valeur pour la ou les balises de ressource que vous souhaitez ajouter à la ressource.  
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

 ** [VersionDescription](#API_CreateTheme_RequestSyntax) **   <a name="QS-CreateTheme-request-VersionDescription"></a>
Une description de la première version du thème que vous créez. À chaque fois`UpdateTheme`est appelée, une nouvelle version est créée. Chaque version du thème possède 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_CreateTheme_ResponseSyntax"></a>

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

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

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

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

 ** [Status](#API_CreateTheme_ResponseSyntax) **   <a name="QS-CreateTheme-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_CreateTheme_ResponseSyntax) **   <a name="QS-CreateTheme-response-Arn"></a>
ARN (Amazon Resource Name) du thème.  
Type : Chaîne

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

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

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

 ** [VersionArn](#API_CreateTheme_ResponseSyntax) **   <a name="QS-CreateTheme-response-VersionArn"></a>
ARN (Amazon Resource Name) du nouveau thème.  
Type : Chaîne

## Erreurs
<a name="API_CreateTheme_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 : 401

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

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

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

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

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

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

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