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.
CreateIAMPolicyAssignment
Crée une affectation avec une stratégie IAM spécifiée, identifiée par son nom Amazon Resource Name (ARN). Cette attribution de stratégie est associée aux groupes ou utilisateurs spécifiés d'Amazon QuickSight. Les noms d'affectation sont uniques parAWS. Pour éviter d'écraser les règles dans d'autres espaces de noms, utilisez des noms d'affectation uniques.
Syntaxe de la demande
POST /accounts/AwsAccountId
/namespaces/Namespace
/iam-policy-assignments/ HTTP/1.1
Content-type: application/json
{
"AssignmentName": "string
",
"AssignmentStatus": "string
",
"Identities": {
"string
" : [ "string
" ]
},
"PolicyArn": "string
"
}
Paramètres de demande URI
La demande utilise les paramètres URI suivants.
- AwsAccountId
-
ID duAWScompte sur lequel vous souhaitez attribuer une stratégie IAM à Amazon QuickSight des utilisateurs ou des groupes.
Contraintes de longueur Longueur fixe de 12.
Modèle :
^[0-9]{12}$
Obligatoire Oui
- Namespace
-
L'espace de noms qui contient 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.
- AssignmentName
-
Le nom de l'affectation, également appelé règle. Il doit être unique au sein d'uneAWS.
Type : Chaîne
Contraintes de longueur Longueur minimale de 1.
Modèle :
(?=^.{2,256}$)(?!.*\s)[0-9a-zA-Z-_.:=+@]*$
Obligatoire Oui
- 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 Oui
-
- 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
-
Le nom de la mission. Ce nom doit être unique dans laAWS.
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
-
ARN de la stratégie IAM appliquée à Amazon QuickSight les utilisateurs et les groupes spécifiés dans cette affectation.
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 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 :