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
Elenca tutti i gruppi di utenti in Amazon QuickSight.
Sintassi della richiesta
GET /accounts/AwsAccountId/namespaces/Namespace/groups?max-results=MaxResults&next-token=NextToken HTTP/1.1
Parametri della richiesta URI:
La richiesta utilizza i seguenti parametri URI.
- AwsAccountId
-
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
-
Numero massimo di risultati da restituire.
Intervallo valido: Valore minimo di 1. valore massimo pari a 100.
- Namespace
-
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
-
Token di paginazione che è possibile utilizzare in una richiesta successiva.
Corpo della richiesta
La richiesta non ha un corpo della richiesta.
Sintassi della risposta
HTTP/1.1 Status
Content-type: application/json
{
"GroupList": [
{
"Arn": "string",
"Description": "string",
"GroupName": "string",
"PrincipalId": "string"
}
],
"NextToken": "string",
"RequestId": "string"
}Elementi di risposta
Se l'operazione riesce, il servizio restituisce la seguente risposta HTTP.
- Status
-
Lo stato HTTP della richiesta.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare Errori comuni.
- 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
NextTokennon è 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
Per ulteriori informazioni sull'utilizzo di questa API in uno degli SDK AWS specifici della lingua, consulta quanto segue:
