Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# ListGroups
<a name="API_ListGroups"></a>

Elenca tutti i gruppi di utenti in Amazon QuickSight. 

## Sintassi della richiesta
<a name="API_ListGroups_RequestSyntax"></a>

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

## Parametri della richiesta URI:
<a name="API_ListGroups_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [AwsAccountId](#API_ListGroups_RequestSyntax) **   <a name="QS-ListGroups-request-AwsAccountId"></a>
L'ID delAWSconto in cui si trova il gruppo. Attualmente, si utilizza l'ID perAWSaccount che contiene il tuo Amazon QuickSight conto.  
Vincoli di lunghezza: Lunghezza fissa di 12.  
Modello: `^[0-9]{12}$`   
Campo obbligatorio: Sì

 ** [MaxResults](#API_ListGroups_RequestSyntax) **   <a name="QS-ListGroups-request-MaxResults"></a>
Numero massimo di risultati da restituire.  
Intervallo valido: Valore minimo di 1. valore massimo pari a 100.

 ** [Namespace](#API_ListGroups_RequestSyntax) **   <a name="QS-ListGroups-request-Namespace"></a>
Lo spazio dei nomi da cui si desidera creare un elenco di gruppi.  
Vincoli di lunghezza: La lunghezza massima è 64 caratteri.  
Modello: `^[a-zA-Z0-9._-]*$`   
Campo obbligatorio: Sì

 ** [NextToken](#API_ListGroups_RequestSyntax) **   <a name="QS-ListGroups-request-NextToken"></a>
Token di paginazione che è possibile utilizzare in una richiesta successiva.

## Corpo della richiesta
<a name="API_ListGroups_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_ListGroups_ResponseSyntax"></a>

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

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

## Elementi di risposta
<a name="API_ListGroups_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce la seguente risposta HTTP.

 ** [Status](#API_ListGroups_ResponseSyntax) **   <a name="QS-ListGroups-response-Status"></a>
Lo stato HTTP della richiesta.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [GroupList](#API_ListGroups_ResponseSyntax) **   <a name="QS-ListGroups-response-GroupList"></a>
L'elenco dei gruppi.  
Type: Matrice di[Group](API_Group.md)oggetti

 ** [NextToken](#API_ListGroups_ResponseSyntax) **   <a name="QS-ListGroups-response-NextToken"></a>
Token di paginazione che è possibile utilizzare in una richiesta successiva.  
Type: Stringa

 ** [RequestId](#API_ListGroups_ResponseSyntax) **   <a name="QS-ListGroups-response-RequestId"></a>
LaAWSID richiesta per questa operazione.  
Type: Stringa

## Errori
<a name="API_ListGroups_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** AccessDeniedException **   
Non hai l'accesso. Le credenziali fornite non possono essere convalidate. È possibile che non sei autorizzato a effettuare la richiesta. Assicurati che il tuo account sia autorizzato a utilizzare Amazon QuickSight , che le policy abbiano le autorizzazioni corrette e che siano utilizzate le chiavi di accesso corrette.  
Codice di stato HTTP: 401

 ** InternalFailureException **   
Si è verificato un errore interno.  
Codice di stato HTTP: 500

 ** InvalidNextTokenException **   
Il valore `NextToken` non è valido.  
Codice di stato HTTP: 400

 ** InvalidParameterValueException **   
Uno o più parametri hanno un valore non valido.  
Codice di stato HTTP: 400

 ** PreconditionNotMetException **   
Una o più precondizioni non sono soddisfatte.  
Codice di stato HTTP: 400

 ** ResourceNotFoundException **   
Uno o più risorse non sono state trovate.  
Codice di stato HTTP: 404

 ** ResourceUnavailableException **   
Questa risorsa al momento non è disponibile.  
Codice di stato HTTP: 503

 ** ThrottlingException **   
L'accesso è limitato.  
Codice di stato HTTP: 429

## Vedi anche
<a name="API_ListGroups_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in uno degli SDK AWS specifici della lingua, consulta quanto segue:
+  [Interfaccia a riga di comando AWS](https://docs.aws.amazon.com/goto/aws-cli/quicksight-2018-04-01/ListGroups) 
+  [SDK AWS per .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/quicksight-2018-04-01/ListGroups) 
+  [SDK AWS per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/quicksight-2018-04-01/ListGroups) 
+  [SDK AWS per Go](https://docs.aws.amazon.com/goto/SdkForGoV1/quicksight-2018-04-01/ListGroups) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/quicksight-2018-04-01/ListGroups) 
+  [AWSSDK per JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/quicksight-2018-04-01/ListGroups) 
+  [SDK AWS per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/quicksight-2018-04-01/ListGroups) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/quicksight-2018-04-01/ListGroups) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/quicksight-2018-04-01/ListGroups)