

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

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

Enumera el Amazon QuickSight grupos que un Amazon QuickSight el usuario es miembro de.

## Sintaxis de la solicitud
<a name="API_ListUserGroups_RequestSyntax"></a>

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

## Parámetros de solicitud del URI
<a name="API_ListUserGroups_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [AwsAccountId](#API_ListUserGroups_RequestSyntax) **   <a name="QS-ListUserGroups-request-AwsAccountId"></a>
LaAWSID de cuenta en la que se encuentra el usuario. En la actualidad, utilizas el ID para elAWScuenta que contiene su Amazon QuickSight account.  
Restricciones de longitud Longitud fija de 12 caracteres.  
Patrón: `^[0-9]{12}$`   
Obligatorio: Sí

 ** [MaxResults](#API_ListUserGroups_RequestSyntax) **   <a name="QS-ListUserGroups-request-MaxResults"></a>
El número máximo de resultados que se devuelven en esta solicitud.  
Rango válido: Valor mínimo de 1. Valor máximo de 100.

 ** [Namespace](#API_ListUserGroups_RequestSyntax) **   <a name="QS-ListUserGroups-request-Namespace"></a>
El espacio de nombres. Actualmente, debe establecer esto en`default`.  
Restricciones de longitud La longitud máxima es 64.  
Patrón: `^[a-zA-Z0-9._-]*$`   
Obligatorio: Sí

 ** [NextToken](#API_ListUserGroups_RequestSyntax) **   <a name="QS-ListUserGroups-request-NextToken"></a>
Un token de paginación que se pueda utilizar en una solicitud posterior.

 ** [UserName](#API_ListUserGroups_RequestSyntax) **   <a name="QS-ListUserGroups-request-UserName"></a>
El Amazon QuickSight nombre de usuario para el que desea enumerar las pertenencias a grupos.  
Restricciones de longitud Longitud mínima de 1.  
Patrón: `[\u0020-\u00FF]+`   
Obligatorio: Sí

## Cuerpo de la solicitud
<a name="API_ListUserGroups_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<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"
}
```

## Elementos de respuesta
<a name="API_ListUserGroups_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve la siguiente respuesta HTTP.

 ** [Status](#API_ListUserGroups_ResponseSyntax) **   <a name="QS-ListUserGroups-response-Status"></a>
El estado HTTP de la solicitud.

El servicio devuelve los datos siguientes en formato JSON.

 ** [GroupList](#API_ListUserGroups_ResponseSyntax) **   <a name="QS-ListUserGroups-response-GroupList"></a>
La lista de grupos de los que es miembro el usuario.  
Type: Matriz de[Group](API_Group.md)objects

 ** [NextToken](#API_ListUserGroups_ResponseSyntax) **   <a name="QS-ListUserGroups-response-NextToken"></a>
Un token de paginación que se pueda utilizar en una solicitud posterior.  
Type: Cadena

 ** [RequestId](#API_ListUserGroups_ResponseSyntax) **   <a name="QS-ListUserGroups-response-RequestId"></a>
LaAWSID de solicitud de esta operación.  
Type: Cadena

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

Para obtener información sobre errores que son comunes a todas las acciones, consulte[Errores comunes](CommonErrors.md).

 ** AccessDeniedException **   
No tiene permiso de acceso. La credenciales proporcionadas no se pudieron validar. Es posible que no tenga autorización para realizar la solicitud. Asegúrese de que su cuenta esté autorizada para usar Amazon QuickSight , que las políticas tienen los permisos correctos y que está utilizando las claves de acceso correctas.  
Código de estado HTTP: 401

 ** InternalFailureException **   
Se produjo un error interno.  
Código de estado HTTP: 500

 ** InvalidParameterValueException **   
Uno o más parámetros tienen un valor que no es válido.  
Código de estado HTTP: 400

 ** PreconditionNotMetException **   
No se cumplen una o varias condiciones previas.  
Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No se encuentran uno o varios recursos de.  
Código de estado HTTP: 404

 ** ResourceUnavailableException **   
Este recurso no está disponible en este momento.  
Código de estado HTTP: 503

 ** ThrottlingException **   
El acceso está limitado.  
Código de estado HTTP: 429

## Véase también
<a name="API_ListUserGroups_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un lenguaje específico, consulte:
+  [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/quicksight-2018-04-01/ListUserGroups) 
+  [SDK de AWS para .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/quicksight-2018-04-01/ListUserGroups) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/quicksight-2018-04-01/ListUserGroups) 
+  [AWS SDK para Go](https://docs.aws.amazon.com/goto/SdkForGoV1/quicksight-2018-04-01/ListUserGroups) 
+  [SDK para Java V2 de AWS](https://docs.aws.amazon.com/goto/SdkForJavaV2/quicksight-2018-04-01/ListUserGroups) 
+  [AWSSDK para JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/quicksight-2018-04-01/ListUserGroups) 
+  [SDK de AWS para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/quicksight-2018-04-01/ListUserGroups) 
+  [SDK de AWS para Python](https://docs.aws.amazon.com/goto/boto3/quicksight-2018-04-01/ListUserGroups) 
+  [SDK de AWS para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/quicksight-2018-04-01/ListUserGroups) 