UpdateDashboardPermissions - 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.

UpdateDashboardPermissions

Met à jour les autorisations de lecture et d'écriture sur un tableau de

Syntaxe de la demande

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

Paramètres de demande URI

La demande utilise les paramètres URI suivants.

AwsAccountId

ID duAWSqui contient le tableau de bord dont vous mettez à jour les autorisations.

Contraintes de longueur : Longueur fixe de 12.

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

Obligatoire : Oui

DashboardId

ID pour le tableau de bord.

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.

GrantLinkPermissions

Accorder des autorisations de lien à tous les utilisateurs d'un espace de noms.

Type : Tableau de chaînesResourcePermissionobjets

Membres du tableau : Nombre maximum de 2 éléments.

Obligatoire : Non

GrantPermissions

Les autorisations que vous souhaitez accorder sur cette ressource.

Type : Tableau de chaînesResourcePermissionobjets

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

Obligatoire : Non

RevokeLinkPermissions

Révoque les autorisations de lien de tous les utilisateurs d'un espace de noms défini.

Type : Tableau de chaînesResourcePermissionobjets

Membres du tableau : Nombre maximum de 2 éléments.

Obligatoire : Non

RevokePermissions

Les autorisations que vous souhaitez révoquer de cette ressource.

Type : Tableau de chaînesResourcePermissionobjets

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

Obligatoire : Non

Syntaxe de la réponse

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

DashboardArn

Amazon Resource Name (ARN) du tableau de bord.

Type : Chaîne

DashboardId

ID pour le tableau de bord.

Type : Chaîne

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

Modèle : [\w\-]+

LinkSharingConfiguration

Met à jour les autorisations d'un lien partagé vers Amazon QuickSight Tableau de bord.

Type : objet LinkSharingConfiguration

Permissions

Informations sur les autorisations sur le tableau de bord.

Type : Tableau de chaînesResourcePermissionobjets

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

RequestId

LeAWSL'ID de demande pour cette opération.

Type : Chaîne

Erreurs

Pour plus d'informations sur les erreurs communes à toutes les actions, consultezErreurs courantes.

ConflictException

La mise à jour ou la suppression d'une ressource peut entraîner un état incohérent.

Code d'état : 409

InternalFailureException

Une défaillance interne s'est produite.

Code d'état : 500

InvalidParameterValueException

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

Code d'état : 400

ResourceNotFoundException

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

Code d'état : 404

ThrottlingException

L'accès est limité.

Code d'état : 429

UnsupportedUserEditionException

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

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