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à.
ListUserGroups
Elenca l'Amazon QuickSight gruppi che un Amazon QuickSight è un membro di.
Sintassi della richiesta
GET /accounts/AwsAccountId
/namespaces/Namespace
/users/UserName
/groups?max-results=MaxResults
&next-token=NextToken
HTTP/1.1
Parametri della richiesta URI:
La richiesta utilizza i seguenti parametri URI.
- AwsAccountId
-
LaAWSID account in cui si trova l'utente. Attualmente, si utilizza l'ID per ilAWSaccount che contiene il tuo Amazon QuickSight conto.
Limitazioni di lunghezza: Lunghezza fissa di 12.
Modello:
^[0-9]{12}$
Campo obbligatorio: Sì
- MaxResults
-
Numero massimo di risultati da restituire da questa richiesta.
Intervallo valido: Valore minimo di 1. valore massimo pari a 100.
- Namespace
-
Lo spazio dei nomi. Attualmente, è necessario impostare questo su
default
.Limitazioni 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.
- UserName
-
Amazon QuickSight il nome utente per cui si desidera elencare le appartenenze a un gruppo.
Limitazioni di lunghezza: Lunghezza minima pari a 1.
Modello:
[\u0020-\u00FF]+
Campo obbligatorio: Sì
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 a questo articolo. 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
- 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: