UpdateIAMPolicyAssignment - Amazon QuickSight
Syntaxe de la demandeParamètres de demande URICorps de la demandeSyntaxe 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.

UpdateIAMPolicyAssignment

Met à jour une attribution de stratégie IAM existante. Cette opération met uniquement à jour le ou les paramètres facultatifs spécifiés dans la demande. Cela remplace tous les utilisateurs inclus dansIdentities.

Syntaxe de la demande

PUT /accounts/AwsAccountId/namespaces/Namespace/iam-policy-assignments/AssignmentName HTTP/1.1
Content-type: application/json

{
   "AssignmentStatus": "string",
   "Identities": { 
      "string" : [ "string" ]
   },
   "PolicyArn": "string"
}

Paramètres de demande URI

La demande utilise les paramètres URI suivants.

AssignmentName

Le nom de l'affectation, également appelé règle. Ce nom doit être unique au sein d'unAWS.

Contraintes de longueur : Longueur minimale de 1.

Modèle : (?=^.{2,256}$)(?!.*\s)[0-9a-zA-Z-_.:=+@]*$

Obligatoire : Oui

AwsAccountId

ID duAWSqui contient l'attribution de stratégie IAM.

Contraintes de longueur : Longueur fixe de 12.

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

Obligatoire : Oui

Namespace

L'espace de noms de l'affectation.

Contraintes de longueur : Longueur maximale de 64.

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

Obligatoire : Oui

Corps de la demande

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

AssignmentStatus

Statut de la mission. Les valeurs possibles sont les suivantes :

  • ENABLED- Tout ce qui est spécifié dans cette affectation est utilisé lors de la création de la source de données.

  • DISABLED- Cette affectation n'est pas utilisée lors de la création de la source de données.

  • DRAFT- Cette affectation est un brouillon inachevé et n'est pas utilisée lors de la création de la source de données.

Type : Chaîne

Valeurs valides : ENABLED | DRAFT | DISABLED

Obligatoire : Non

Identities

Amazon QuickSight les utilisateurs, les groupes ou les deux auxquels vous souhaitez attribuer la stratégie.

Type : mappage de chaîne à tableau de chaînes

Contraintes de longueur : Longueur minimale de 1.

Modèle : [\u0020-\u00FF]+

Obligatoire : Non

PolicyArn

L'ARN pour que la politique IAM s'applique à Amazon QuickSight les utilisateurs et les groupes spécifiés dans cette affectation.

Type : Chaîne

Obligatoire : Non

Syntaxe de la réponse

HTTP/1.1 Status
Content-type: application/json

{
   "AssignmentId": "string",
   "AssignmentName": "string",
   "AssignmentStatus": "string",
   "Identities": { 
      "string" : [ "string" ]
   },
   "PolicyArn": "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.

AssignmentId

L'ID de l'affectation.

Type : Chaîne

AssignmentName

Nom de l'affectation ou de la règle.

Type : Chaîne

Contraintes de longueur : Longueur minimale de 1.

Modèle : (?=^.{2,256}$)(?!.*\s)[0-9a-zA-Z-_.:=+@]*$

AssignmentStatus

Statut de la mission. Les valeurs possibles sont les suivantes :

  • ENABLED- Tout ce qui est spécifié dans cette affectation est utilisé lors de la création de la source de données.

  • DISABLED- Cette affectation n'est pas utilisée lors de la création de la source de données.

  • DRAFT- Cette affectation est un brouillon inachevé et n'est pas utilisée lors de la création de la source de données.

Type : Chaîne

Valeurs valides : ENABLED | DRAFT | DISABLED

Identities

Amazon QuickSight les utilisateurs, les groupes ou les deux auxquels la stratégie IAM est attribuée.

Type : mappage de chaîne à tableau de chaînes

Contraintes de longueur : Longueur minimale de 1.

Modèle : [\u0020-\u00FF]+

PolicyArn

L'ARN de la politique IAM appliquée à Amazon QuickSight les utilisateurs et les groupes spécifiés dans cette affectation.

Type : Chaîne

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.

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

Code d'état HTTP : 401

ConcurrentUpdatingException

Une ressource se trouve déjà dans un état qui indique qu'une opération en cours doit être terminée avant qu'une nouvelle mise à jour puisse être appliquée.

Code d'état HTTP : 500

InternalFailureException

Une défaillance interne s'est produite.

Code d'état HTTP : 500

InvalidParameterValueException

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

Code d'état HTTP : 400

ResourceExistsException

La ressource spécifiée existe déjà.

Code d'état HTTP : 409

ResourceNotFoundException

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

Code d'état HTTP : 404

ThrottlingException

L'accès est limité.

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 :