ListUserGroups - Amazon QuickSight

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 sudefault.

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.

GroupList

Elenco di gruppi a cui appartiene l'utente.

Type: Matrice diGroupoggetti

NextToken

Token di paginazione che è possibile utilizzare in una richiesta successiva.

Type: Stringa

RequestId

LaAWSID di richiesta per questa operazione.

Type: Stringa

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: