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.
UpdateDataSetPermissions
Met à jour les autorisations sur un ensemble de données.
La ressource d'autorisations estarn:aws:quicksight:region:aws-account-id:dataset/data-set-id
.
Syntaxe de la demande
POST /accounts/AwsAccountId
/data-sets/DataSetId
/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
-
L'ID de compte AWS.
Contraintes de longueur : Longueur fixe de 12.
Modèle :
^[0-9]{12}$
Obligatoire Oui
- DataSetId
-
L'ID de l'ensemble de données dont vous voulez mettre à jour les autorisations. Cet ID est uniqueRégion AWSpour chaqueAWS.
Obligatoire Oui
Corps de la demande
Cette demande accepte les données suivantes au format JSON.
- GrantPermissions
-
Autorisations de ressources que vous voulez accorder à l'ensemble de données.
Type : Tableau deResourcePermissionobjets
Membres du tableau : Nombre minimum de 1 élément. Nombre maximum de 64 éléments.
Obligatoire Non
- RevokePermissions
-
Autorisations de ressources que vous voulez révoquer de l'ensemble de données.
Type : Tableau deResourcePermissionobjets
Membres du tableau : Nombre minimum de 1 élément. Nombre maximum de 64 éléments.
Obligatoire Non
Syntaxe de la réponse
HTTP/1.1 Status
Content-type: application/json
{
"DataSetArn": "string",
"DataSetId": "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.
- DataSetArn
-
Amazon Resource Name (ARN) de l'ensemble de données.
Type : Chaîne
- DataSetId
-
L'ID de l'ensemble de données dont vous voulez mettre à jour les autorisations. Cet ID est uniqueRégion AWSpour chaqueAWS.
Type : Chaîne
- RequestId
-
LeAWSID de la 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.
Code d'état Code : 401
- ConflictException
-
La mise à jour ou la suppression d'une ressource peut entraîner un état incohérent.
Code d'état Code : 409
- InternalFailureException
-
Une défaillance interne s'est produite.
Code d'état Code : 500
- InvalidParameterValueException
-
La valeur d'un ou de plusieurs paramètres n'est pas valide.
Code d'état Code : 400
- ResourceNotFoundException
-
Une ou plusieurs ressources n'ont pas pu être trouvées.
Code d'état Code : 404
- ThrottlingException
-
L'accès est limité.
Code d'état Code : 429
Exemples
Exemple
Cet exemple illustre une utilisation de UpdateDataSetPermissions.
Exemple de demande
POST /accounts/{AwsAccountId}/data-sets/{DataSetId}/permissions HTTP/1.1
Content-type: application/json
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 :