ListGroups - Amazon QuickSight

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

ListGroups

Listet alle Benutzergruppen in Amazon QuickSight.

Anforderungssyntax

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

URI-Anfrageparameter

Die Anforderung verwendet die folgenden URI-Parameter.

AwsAccountId

Die -ID derAWSKonto, in dem sich die Gruppe befindet. Derzeit verwenden Sie die ID fürAWS-Konto QuickSight Konto.

Längenbeschränkungen: Feste Länge von 12.

Pattern: ^[0-9]{12}$

Erforderlich Ja

MaxResults

Die maximale Anzahl der auszugebenden Ergebnisse.

Gültiger Bereich: Der Mindestwert ist 1. Maximalwert 100.

Namespace

Der Namespace, aus dem Sie eine Liste von Gruppen erstellen möchten.

Längenbeschränkungen: Höchstlänge = 64 Zeichen.

Pattern: ^[a-zA-Z0-9._-]*$

Erforderlich Ja

NextToken

Ein Paginierungstoken, das in einer nachfolgenden Anforderung verwendet werden kann.

Anforderungstext

Der Anforderung besitzt keinen Anforderungstext.

Antwortsyntax

HTTP/1.1 Status Content-type: application/json { "GroupList": [ { "Arn": "string", "Description": "string", "GroupName": "string", "PrincipalId": "string" } ], "NextToken": "string", "RequestId": "string" }

Antwortelemente

Wenn die Aktion erfolgreich ist, sendet der Dienst die folgende HTTP-Antwort zurück.

Status

Der HTTP-Status der Anforderung.

Die folgenden Daten werden vom Service im JSON-Format zurückgegeben.

GroupList

Die Liste der Gruppen.

Type: ArrayGroupObjekte

NextToken

Ein Paginierungstoken, das in einer nachfolgenden Anforderung verwendet werden kann.

Type: String

RequestId

DieAWS-ID der Anforderung

Type: String

Fehler

Hinweise zu den Fehlern, die bei allen Aktionen auftreten, finden Sie unterHäufige Fehler.

AccessDeniedException

Sie haben keinen Zugriff. Die bereitgestellten Anmeldeinformationen konnten nicht überprüft werden. Sie sind möglicherweise nicht berechtigt, die Anforderung auszuführen. Stellen Sie sicher, dass Ihr Konto für die Nutzung von Amazon autorisiert ist QuickSight dass Ihre Richtlinien die korrekten Berechtigungen besitzen und dass Sie die richtigen Zugriffsschlüssel verwenden.

HTTP Status: 401

InternalFailureException

Es ist ein interner Fehler aufgetreten.

HTTP Status: 500

InvalidNextTokenException

Der NextToken-Wert ist nicht gültig.

HTTP Status: 400

InvalidParameterValueException

Ein oder mehrere Parameter haben einen Wert, der nicht gültig ist.

HTTP Status: 400

PreconditionNotMetException

Mindestens eine Vorbedingung ist nicht erfüllt.

HTTP Status: 400

ResourceNotFoundException

Mindestens eine Ressource kann nicht gefunden werden.

HTTP Status: 404

ResourceUnavailableException

Die Ressource ist derzeit nicht verfügbar.

HTTP Status: 503

ThrottlingException

Der Zugriff wird gedrosselt

HTTP Status: 429

Weitere Informationen finden Sie unter:

Weitere Informationen zur Verwendung dieser API in einem der sprachspezifischen AWS-SDKs finden Sie unter: