DescribeAccountCustomization - Amazon QuickSight
Syntaxe de la demandeParamètres de demande URICorps de la requêteSyntaxe de la réponseEléments de réponseErreursVoir aussi

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.

DescribeAccountCustomization

Décrit les personnalisations associées auAWScompte et Amazon Amazon QuickSight Espace de noms dans unRégion AWS. Amazon QuickSight évalue les personnalisations à appliquer en exécutant cette opération d'API avec leResolvedindicateur inclus.

Pour déterminer quelles personnalisations s'affichent lorsque vous exécutez cette commande, il peut être utile de visualiser la relation entre les entités impliquées.

  • AWS account- LeAWScompte existe en haut de la hiérarchie. Il a le potentiel d'utiliser tous lesRégions AWSetAWSservices de Lorsque vous vous abonnez à Amazon QuickSight, vous en choisissez unRégion AWSà utiliser comme région d'origine. C'est là que se trouve votre capacité SPICE gratuite. Vous pouvez utiliser Amazon QuickSight dans tous lesRégion AWS.

  • Région AWS - Dans chaqueRégion AWSoù vous vous connectez à Amazon QuickSightau moins une fois, Amazon QuickSight agit en tant qu'instance distincte du même service. Si vous avez un annuaire d'utilisateurs, il se trouve dans us-east-1, c'est-à-dire USA Est (Virginie du Nord). En règle générale, ces utilisateurs ont accès à Amazon QuickSight dans tousRégion AWS, sauf s'ils sont limités à un espace de noms.

    Pour exécuter la commande dans un autreRégion AWS, vous modifiez les paramètres de votre région. Si vous utilisez leAWS CLI, vous pouvez utiliser l'une des options suivantes :

  • Namespace- UN QuickSight namespace est une partition qui contient des utilisateurs et des ressources (sources de données, jeux de données, tableaux de bord, etc.). Pour accéder aux ressources qui se trouvent dans un espace de noms spécifique, les utilisateurs et les groupes doivent également faire partie du même espace de noms. Les personnes qui partagent un espace de noms sont complètement isolées des utilisateurs et des ressources des autres espaces de noms, même si elles se trouvent dans le mêmeAWSCompte etRégion AWS.

  • Applied customizations- Au sein d'unRégion AWS, un ensemble d'Amazon QuickSight les personnalisations peuvent s'appliquer à unAWScompte ou vers un espace de noms. Les paramètres que vous appliquez à un espace de noms remplacent ceux que vous appliquez à unAWS. Tous les paramètres sont isolés en un seulRégion AWS. Pour les appliquer dans d'autresRégions AWS, exécutez leCreateAccountCustomizationcommande dans chaqueRégion AWSdans laquelle vous souhaitez appliquer les mêmes personnalisations.

Syntaxe de la demande

GET /accounts/AwsAccountId/customizations?namespace=Namespace&resolved=Resolved HTTP/1.1

Paramètres de demande URI

La demande utilise les paramètres URI suivants.

AwsAccountId

ID pour leAWScompte que vous voulez décrire Amazon QuickSight personnalisations pour.

Contraintes de longueur : Longueur fixe de 12.

Modèle : ^[0-9]{12}$

Obligatoire Oui

Namespace

Amazon QuickSight espace de noms dans lequel vous souhaitez décrire Amazon QuickSight personnalisations pour.

Contraintes de longueur : Longueur maximale de 64.

Modèle : ^[a-zA-Z0-9._-]*$

Resolved

LeResolvedflag fonctionne avec les autres paramètres pour déterminer quelle vue d'Amazon QuickSight les personnalisations sont renvoyées. Vous pouvez ajouter cet indicateur à votre commande pour utiliser la même vue qu'Amazon QuickSight utilise pour identifier les personnalisations à appliquer à la console. Ignorez ce drapeau ou définissez-le surno-resolved, pour afficher les personnalisations configurées à différents niveaux.

Corps de la requête

La demande n'a pas de corps de requête.

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

Amazon QuickSight personnalisations qui existent dans la version actuelleRégion AWS.

Type : objet AccountCustomization

Arn

Amazon Resource Name (ARN) de la personnalisation associée à cetAWS.

Type : Chaîne

AwsAccountId

ID pour leAWScompte que vous décrivez.

Type : Chaîne

Contraintes de longueur : Longueur fixe de 12.

Modèle : ^[0-9]{12}$

Namespace

Amazon QuickSight espace de noms que vous décrivez.

Type : Chaîne

Contraintes de longueur : Longueur maximale de 64.

Modèle : ^[a-zA-Z0-9._-]*$

RequestId

LeAWSCode 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 article. 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 service, que vos stratégies ont les autorisations appropriées et que vous utilisez les bonnes clés d'accès.

Code d'état Code d'état HTTP 401

InternalFailureException

Une défaillance interne s'est produite.

Code d'état Code d'état HTTP 500

InvalidParameterValueException

La valeur d'un ou de plusieurs paramètres n'est pas valide.

Code d'état Code d'état HTTP 400

ResourceNotFoundException

Une ou plusieurs ressources n'ont pas pu être trouvées.

Code d'état Code d'état HTTP 404

ResourceUnavailableException

Cette ressource n'est pas disponible actuellement.

Code d'état Code d'état HTTP 503

ThrottlingException

L'accès est limité.

Code d'état Code d'état HTTP 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 :