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.

# ListUserGroups
<a name="API_ListUserGroups"></a>

Répertorie Amazon QuickSight groupes qu'un Amazon QuickSight l'utilisateur est membre du.

## Syntaxe de la demande
<a name="API_ListUserGroups_RequestSyntax"></a>

```
GET /accounts/AwsAccountId/namespaces/Namespace/users/UserName/groups?max-results=MaxResults&next-token=NextToken HTTP/1.1
```

## Paramètres de demande URI
<a name="API_ListUserGroups_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [AwsAccountId](#API_ListUserGroups_RequestSyntax) **   <a name="QS-ListUserGroups-request-AwsAccountId"></a>
LeAWSID de compte dans lequel se trouve l'utilisateur. 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

 ** [MaxResults](#API_ListUserGroups_RequestSyntax) **   <a name="QS-ListUserGroups-request-MaxResults"></a>
Nombre maximal de résultats à renvoyer pour cette demande.  
Plage valide : Valeur minimale est 1. Valeur maximale fixée à 100.

 ** [Namespace](#API_ListUserGroups_RequestSyntax) **   <a name="QS-ListUserGroups-request-Namespace"></a>
Espace de noms. Actuellement, vous devez définir cette valeur sur`default`.  
Contraintes de longueur : Longueur maximale de 64.  
Modèle : `^[a-zA-Z0-9._-]*$`   
Obligatoire : Oui

 ** [NextToken](#API_ListUserGroups_RequestSyntax) **   <a name="QS-ListUserGroups-request-NextToken"></a>
Jeton de pagination qui peut être utilisée dans une demande de pagination.

 ** [UserName](#API_ListUserGroups_RequestSyntax) **   <a name="QS-ListUserGroups-request-UserName"></a>
Amazon QuickSight nom d'utilisateur pour lequel vous souhaitez répertorier les appartenances aux groupes.  
Contraintes de longueur : Longueur minimale de 1.  
Modèle : `[\u0020-\u00FF]+`   
Obligatoire : Oui

## Corps de la requête
<a name="API_ListUserGroups_RequestBody"></a>

La demande n'a pas de corps de requête.

## Syntaxe de la réponse
<a name="API_ListUserGroups_ResponseSyntax"></a>

```
HTTP/1.1 Status
Content-type: application/json

{
   "GroupList": [ 
      { 
         "Arn": "string",
         "Description": "string",
         "GroupName": "string",
         "PrincipalId": "string"
      }
   ],
   "NextToken": "string",
   "RequestId": "string"
}
```

## Eléments de réponse
<a name="API_ListUserGroups_ResponseElements"></a>

Si l'action aboutit, le service renvoie la réponse HTTP suivante.

 ** [Status](#API_ListUserGroups_ResponseSyntax) **   <a name="QS-ListUserGroups-response-Status"></a>
Le statut HTTP de la requête.

Les données suivantes sont renvoyées au format JSON par le service.

 ** [GroupList](#API_ListUserGroups_ResponseSyntax) **   <a name="QS-ListUserGroups-response-GroupList"></a>
Liste des groupes dont l'utilisateur est membre.  
Type : Tableau de[Group](API_Group.md)objets

 ** [NextToken](#API_ListUserGroups_ResponseSyntax) **   <a name="QS-ListUserGroups-response-NextToken"></a>
Jeton de pagination qui peut être utilisée dans une demande de pagination.  
Type : Chaîne

 ** [RequestId](#API_ListUserGroups_ResponseSyntax) **   <a name="QS-ListUserGroups-response-RequestId"></a>
LeAWSID de demande pour cette opération.  
Type : Chaîne

## Erreurs
<a name="API_ListUserGroups_Errors"></a>

Pour plus d'informations sur les erreurs communes à toutes les actions, consultez[Erreurs courantes](CommonErrors.md).

 ** 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

 ** PreconditionNotMetException **   
Une ou plusieurs conditions préalables ne sont pas remplies.  
HTTP Status Code : 400

 ** 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
<a name="API_ListUserGroups_SeeAlso"></a>

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 :
+  [Interface de ligne de commande AWS](https://docs.aws.amazon.com/goto/aws-cli/quicksight-2018-04-01/ListUserGroups) 
+  [AWS SDK pour .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/quicksight-2018-04-01/ListUserGroups) 
+  [Kit AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/quicksight-2018-04-01/ListUserGroups) 
+  [Kit AWS SDK pour Go](https://docs.aws.amazon.com/goto/SdkForGoV1/quicksight-2018-04-01/ListUserGroups) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/quicksight-2018-04-01/ListUserGroups) 
+  [AWSKits SDK pour JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/quicksight-2018-04-01/ListUserGroups) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/quicksight-2018-04-01/ListUserGroups) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/quicksight-2018-04-01/ListUserGroups) 
+  [Kit SDK AWS pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/quicksight-2018-04-01/ListUserGroups)