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.
CreateGroup
Utilisation de l'CreateGroup
opération pour créer un groupe dans Amazon QuickSight. Vous pouvez créer jusqu'à 10 000 groupes par espace de noms. Si vous souhaitez créer plus de 10 000 groupes dans un espace de noms, contactez AWS Support.
La ressource d'autorisations estarn:aws:quicksight:<your-region>:<relevant-aws-account-id>:group/default/<group-name>
.
La réponse est un objet de groupe.
Syntaxe de la demande
POST /accounts/AwsAccountId
/namespaces/Namespace
/groups HTTP/1.1
Content-type: application/json
{
"Description": "string
",
"GroupName": "string
"
}
Paramètres de demande URI
La demande utilise les paramètres URI suivants.
- AwsAccountId
-
ID pour leAWScompte dans lequel se trouve le groupe. Actuellement, vous utilisez l'ID pourAWScompte qui contient votre Amazon QuickSight .
Contraintes de longueur : Longueur fixe de 12.
Modèle :
^[0-9]{12}$
Obligatoire : Oui
- Namespace
-
L'espace de noms dont vous souhaitez que le groupe fasse partie.
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.
- GroupName
-
Nom pour le groupe que vous souhaitez créer.
Type : Chaîne
Contraintes de longueur : Longueur minimale de 1.
Modèle :
[\u0020-\u00FF]+
Obligatoire : Oui
- Description
-
Description du groupe que vous souhaitez créer.
Type : Chaîne
Contraintes de longueur : Longueur minimale de 1. Longueur maximale de 512.
Obligatoire : Non
Syntaxe de la réponse
HTTP/1.1 Status
Content-type: application/json
{
"Group": {
"Arn": "string",
"Description": "string",
"GroupName": "string",
"PrincipalId": "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.
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.
HTTP Status Code : 401
- 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
- LimitExceededException
-
Une limite est dépassée.
HTTP Status Code : 409
- PreconditionNotMetException
-
Une ou plusieurs conditions préalables ne sont pas remplies.
HTTP Status Code : 400
- ResourceExistsException
-
La ressource spécifiée existe déjà.
HTTP Status Code : 409
- ResourceNotFoundException
-
Une ou plusieurs ressources n'ont pas pu être trouvées.
HTTP Status Code : 404
- ResourceUnavailableException
-
Cette ressource n'est pas disponible actuellement.
HTTP Status Code : 503
- ThrottlingException
-
L'accès est limité.
HTTP Status Code : 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 :