UpdateThemePermissions - Amazon QuickSight

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.

UpdateThemePermissions

Met à jour les autorisations de ressources pour un thème. Les autorisations s'appliquent à l'action permettant d'accorder ou de révoquer des autorisations sur, par exemple"quicksight:DescribeTheme".

Les autorisations de thème s'appliquent par groupes. Les regroupements valides incluent les suivants pour les trois niveaux d'autorisation, à savoir les autorisations utilisateur, propriétaire ou aucune autorisation :

  • Utilisateur

    • "quicksight:DescribeTheme"

    • "quicksight:DescribeThemeAlias"

    • "quicksight:ListThemeAliases"

    • "quicksight:ListThemeVersions"

  • Propriétaire

    • "quicksight:DescribeTheme"

    • "quicksight:DescribeThemeAlias"

    • "quicksight:ListThemeAliases"

    • "quicksight:ListThemeVersions"

    • "quicksight:DeleteTheme"

    • "quicksight:UpdateTheme"

    • "quicksight:CreateThemeAlias"

    • "quicksight:DeleteThemeAlias"

    • "quicksight:UpdateThemeAlias"

    • "quicksight:UpdateThemePermissions"

    • "quicksight:DescribeThemePermissions"

  • Pour ne spécifier aucune autorisation, omettez la liste des autorisations.

Syntaxe de la demande

PUT /accounts/AwsAccountId/themes/ThemeId/permissions HTTP/1.1 Content-type: application/json { "GrantPermissions": [ { "Actions": [ "string" ], "Principal": "string" } ], "RevokePermissions": [ { "Actions": [ "string" ], "Principal": "string" } ] }

Paramètres de demande URI

La demande utilise les paramètres URI suivants.

AwsAccountId

ID duAWScompte contenant le thème.

Contraintes de longueur : Longueur fixe de 12.

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

Obligatoire : Oui

ThemeId

ID du thème.

Contraintes de longueur : Longueur minimale de 1. Longueur maximale de 2048.

Modèle : [\w\-]+

Obligatoire : Oui

Corps de la demande

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

GrantPermissions

Une liste des autorisations de ressources à accorder pour le thème.

Type : Tableau deResourcePermissionobjets

Membres du tableau : Nombre maximal de 100 éléments.

Obligatoire : Non

RevokePermissions

Une liste des autorisations de ressources à révoquer du thème.

Type : Tableau deResourcePermissionobjets

Membres du tableau : Nombre maximal de 100 éléments.

Obligatoire : Non

Syntaxe de la réponse

HTTP/1.1 Status Content-type: application/json { "Permissions": [ { "Actions": [ "string" ], "Principal": "string" } ], "RequestId": "string", "ThemeArn": "string", "ThemeId": "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.

Permissions

La liste résultante des autorisations de ressources pour le thème.

Type : Tableau deResourcePermissionobjets

Membres du tableau : Nombre minimum de 1 élément. Nombre maximum de 64 éléments.

RequestId

LeAWSID de demande pour cette opération.

Type : Chaîne

ThemeArn

ARN (Amazon Resource Name) du thème.

Type : Chaîne

ThemeId

ID du thème.

Type : Chaîne

Contraintes de longueur : Longueur minimale de 1. Longueur maximale de 2048.

Modèle : [\w\-]+

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 Code état état état 401

InternalFailureException

Une défaillance interne s'est produite.

HTTP Status Code état état état 500

InvalidParameterValueException

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

HTTP Status Code état état état 400

ResourceNotFoundException

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

HTTP Status Code état état état 404

ThrottlingException

L'accès est limité.

HTTP Status Code état état état 429

UnsupportedUserEditionException

Cette erreur indique que vous appelez une opération portant sur un Amazon QuickSightabonnement dont l'édition n'inclut pas la prise en charge de cette opération. Amazon Amazon Amazon Amazon QuickSight Les éditions actuellement disponibles pour Amazon Edition actuellement disponibles pour Amazon Edition et Toutes les opérations et fonctionnalités ne sont pas disponibles dans chaque édition.

HTTP Status Code état état état 403

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 :