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.
CreateAccountCustomization
Crée Amazon QuickSight personnalisations pour l'actuelRégion AWS. Actuellement, vous pouvez ajouter un thème personnalisé par défaut à l'aide de laCreateAccountCustomizationouUpdateAccountCustomizationOpération d'API. Pour personnaliser davantage Amazon QuickSight en supprimant Amazon QuickSightdes exemples de ressources et de vidéos pour tous les nouveaux utilisateurs, voirPersonnalisation d'Amazon QuickSightdans leAmazon QuickSight Guide de l'utilisateur .
Vous pouvez créer des personnalisations pour votreAWSou, si vous spécifiez un espace de noms, pour un compte QuickSight Espace de noms à la place. Les personnalisations qui s'appliquent à un espace de noms remplacent toujours celles qui s'appliquent à unAWS. Pour savoir quelles personnalisations s'appliquent, utilisez leDescribeAccountCustomizationOpération d'API.
Avant d'utiliser leCreateAccountCustomizationOpération API pour ajouter un thème comme espace de noms par défaut, assurez-vous de partager d'abord le thème avec l'espace de noms. Si vous ne le partagez pas avec l'espace de noms, le thème n'est pas visible par vos utilisateurs, même si vous en faites le thème par défaut. Pour vérifier si le thème est partagé, affichez les autorisations actuelles à l'aide de la
DescribeThemePermissions
Opération d'API. Pour partager le thème, accordez des autorisations à l'aide de la
UpdateThemePermissions
Opération d'API.
Syntaxe de la demande
POST /accounts/AwsAccountId/customizations?namespace=Namespace HTTP/1.1
Content-type: application/json
{
"AccountCustomization": {
"DefaultEmailCustomizationTemplate": "string",
"DefaultTheme": "string"
},
"Tags": [
{
"Key": "string",
"Value": "string"
}
]
}Paramètres de demande URI
La demande utilise les paramètres URI suivants.
- AwsAccountId
-
L'ID pour leAWSque vous souhaitez personnaliser Amazon QuickSight pour.
Contraintes de longueur : Longueur fixe de 12.
Modèle :
^[0-9]{12}$Obligatoire : Oui
- Namespace
-
L'Amazon QuickSight dans lequel vous souhaitez ajouter des personnalisations.
Contraintes de longueur : Longueur maximale de 64.
Modèle :
^[a-zA-Z0-9._-]*$
Corps de la demande
Cette demande accepte les données suivantes au format JSON.
- AccountCustomization
-
L'Amazon QuickSight les personnalisations que vous ajoutez dans leRégion AWS. Vous pouvez ajouter ces éléments à unAWScompte et un QuickSight espace de noms.
Par exemple, vous pouvez ajouter un thème par défaut en définissant
AccountCustomizationsur le thème de minuit :"AccountCustomization": { "DefaultTheme": "arn:aws:quicksight::aws:theme/MIDNIGHT" }. Vous pouvez également ajouter un thème personnalisé en spécifiant"AccountCustomization": { "DefaultTheme": "arn:aws:quicksight:us-west-2:111122223333:theme/bdb844d0-0fe9-4d9d-b520-0fe602d93639" }.Type : objet AccountCustomization
Obligatoire : Oui
- Tags
-
Liste des balises que vous souhaitez associer à cette ressource.
Type : Array deTagobjets
Membres du tableau : Nombre minimum de 1 élément. Nombre maximum de 200 éléments.
Obligatoire : Non
Syntaxe de la réponse
HTTP/1.1 Status
Content-type: application/json
{
"AccountCustomization": {
"DefaultEmailCustomizationTemplate": "string",
"DefaultTheme": "string"
},
"Arn": "string",
"AwsAccountId": "string",
"Namespace": "string",
"RequestId": "string"
}Eléments de réponse
Si l'action aboutit, le service renvoie la réponse HTTP suivante.
- Status
-
Le statut HTTP de la requête.
Les données suivantes sont renvoyées au format JSON par le service.
- AccountCustomization
-
L'Amazon QuickSight les personnalisations que vous ajoutez dans leRégion AWS.
Type : objet AccountCustomization
- Arn
-
L'Amazon Resource Name (ARN) pour la personnalisation que vous avez créée pour cet élémentAWS.
Type : Chaîne
- AwsAccountId
-
L'ID pour leAWSque vous souhaitez personnaliser Amazon QuickSight pour.
Type : Chaîne
Contraintes de longueur : Longueur fixe de 12.
Modèle :
^[0-9]{12}$ - Namespace
-
Espace de noms associé à la personnalisation que vous créez.
Type : Chaîne
Contraintes de longueur : Longueur maximale de 64.
Modèle :
^[a-zA-Z0-9._-]*$ - RequestId
-
LeAWSID de demande pour cette opération.
Type : Chaîne
Erreurs
Pour plus d'informations sur les erreurs communes à toutes les actions, consultezErreurs courantes.
- 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 HTTP Status : 401
- ConflictException
-
La mise à jour ou la suppression d'une ressource peut entraîner un état incohérent.
HTTP Status HTTP Status : 409
- InternalFailureException
-
Une défaillance interne s'est produite.
HTTP Status HTTP Status : 500
- InvalidParameterValueException
-
La valeur d'un ou de plusieurs paramètres n'est pas valide.
HTTP Status HTTP Status : 400
- ResourceExistsException
-
La ressource spécifiée existe déjà.
HTTP Status HTTP Status : 409
- ResourceNotFoundException
-
Une ou plusieurs ressources sont introuvables.
HTTP Status HTTP Status : 404
- ResourceUnavailableException
-
Cette ressource n'est pas disponible actuellement.
HTTP Status HTTP Status : 503
- ThrottlingException
-
L'accès est limité.
HTTP Status HTTP Status : 429
Voir aussi
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 :
