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

UpdateAnalysisPermissions

Met à jour les autorisations de lecture et d'écriture pour une analyse.

Syntaxe de la demande

PUT /accounts/AwsAccountId/analyses/AnalysisId/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.

AnalysisId

ID de l'analyse dont vous mettez à jour les autorisations. L'ID fait partie de l'URL d'analyse.

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

Modèle : [\w\-]+

Obligatoire : Oui

AwsAccountId

ID duAWSqui contient l'analyse dont vous mettez à jour les autorisations. Vous devez utiliser leAWScompte dans lequel se trouve l'analyse.

Contraintes de longueur : Longueur fixe de 12.

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

Obligatoire : Oui

Corps de la demande

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

GrantPermissions

Structure qui décrit les autorisations à ajouter et le principal auquel les ajouter.

Type : Tableau de tableau deResourcePermissionobjets

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

Obligatoire : Non

RevokePermissions

Structure qui décrit les autorisations à supprimer et le principal dont elles doivent être supprimées.

Type : Tableau de 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 { "AnalysisArn": "string", "AnalysisId": "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.

AnalysisArn

Amazon Resource Name (ARN) de l'analyse que vous avez mise à jour.

Type : Chaîne

AnalysisId

ID de l'analyse dont vous avez mis à jour les autorisations.

Type : Chaîne

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

Modèle : [\w\-]+

Permissions

Structure qui décrit les principaux et les autorisations au niveau des ressources sur une analyse.

Type : Tableau de 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

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.

HTTP Status Code : 409

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

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 Amazon Amazon QuickSight Les éditions actuellement disponibles pour la 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

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 :