Method: organizations.locations.postures.list

Listet die neuesten Versionen aller Posture-Ressourcen in einer bestimmten Organisation und an einem bestimmten Standort auf.

HTTP-Anfrage

GET https://securityposture.googleapis.com/v1/{parent=organizations/*/locations/*}/postures

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

Pflichtangabe. Der Name der übergeordneten Ressource im Format organizations/{organization}/locations/global.

Abfrageparameter

Parameter
pageSize

integer

Die maximale Anzahl der Körperhaltungen, die zurückgegeben werden sollen. Der Standardwert ist 500.

Wenn Sie den Höchstwert von 1000 überschreiten, verwendet der Dienst den Höchstwert.
pageToken

string

Ein Paginierungstoken, das von einer vorherigen Anfrage zum Auflisten von Körperhaltungen zurückgegeben wurde. Geben Sie dieses Token an, um die nächste Ergebnisseite abzurufen.
filter

string

Optional. Ein Filter, der auf die Liste der Körperhaltungen angewendet werden soll, im Format, das in AIP-160: Filtern definiert ist.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Wenn der Vorgang erfolgreich ist, enthält der Antworttext Daten mit folgender Struktur:

JSON-Darstellung 
{
  "postures": [
    {
      object (Posture)
    }
  ],
  "nextPageToken": string,
  "unreachable": [
    string
  ]
}
Felder
postures[]

object (Posture)

Die Liste der Posture-Ressourcen.
nextPageToken

string

Ein Paginierungstoken. Rufen Sie die Methode mit diesem Token noch einmal auf, um die nächste Ergebnisseite abzurufen.
unreachable[]

string

Standorte, die vorübergehend nicht verfügbar waren und nicht erreicht werden konnten.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/cloud-platform

Weitere Informationen finden Sie in der Authentifizierungsübersicht.

IAM-Berechtigungen

Erfordert die folgende IAM-Berechtigung für die Ressource parent:

  • securityposture.postures.list

Weitere Informationen finden Sie in der IAM-Dokumentation.