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