Deployments: list

Autorisierung erforderlich

Listet alle Bereitstellungen für ein bestimmtes Projekt auf. Jetzt testen

Anfrage

HTTP-Anfrage

GET https://www.googleapis.com/deploymentmanager/v2/projects/project/global/deployments

Parameter

Parametername Wert Beschreibung
Pfadparameter
project string Die Projekt-ID für diese Anfrage.
Optionale Suchparameter
filter string Ein Filterausdruck, der in der Antwort aufgeführte Ressourcen filtert. Der Ausdruck muss den Feldnamen, einen Vergleichsoperator und den Wert angeben, den Sie zum Filtern verwenden möchten. Der Wert muss ein String, eine Zahl oder ein boolescher Wert sein. Der Vergleichsoperator muss entweder =, !=, > oder < sein.

Wenn Sie beispielsweise Compute Engine-Instanzen filtern, können Sie Instanzen mit dem Namen example-instance ausschließen, indem Sie name != example-instance angeben.

Sie können auch verschachtelte Felder filtern. Sie können beispielsweise scheduling.automaticRestart = false angeben, um nur Instanzen einzubeziehen, die nicht für automatische Neustarts geplant sind. Sie können verschachtelte Felder verwenden, um nach Ressourcenlabels zu filtern.

Wenn Sie nach mehreren Ausdrücken filtern möchten, setzen Sie jeden Ausdruck in Klammern. Beispiel: (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake"). Standardmäßig ist jeder Ausdruck ein AND-Ausdruck. Sie können jedoch AND- und OR-Ausdrücke explizit einfügen. Beispiel: (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true).
maxResults unsigned integer Die maximale Anzahl der Ergebnisse, die pro Seite zurückgegeben werden soll. Wenn die Anzahl der verfügbaren Ergebnisse größer als maxResults ist, gibt die Compute Engine ein nextPageToken zurück, mit dem Sie die nächste Seite der Ergebnisse in nachfolgenden Listenanfragen abrufen können. Zulässige Werte sind 0 bis 500. (Standard: 500)
orderBy string Sortiert Listenergebnisse in einer bestimmten Reihenfolge. Die Ergebnisse sind standardmäßig nach Ressourcennamen alphanumerisch geordnet.

Mit orderBy="creationTimestamp desc" können Sie die Ergebnisse auch absteigend nach dem Erstellungszeitstempel sortieren. Die Ergebnisse werden dann anhand des Felds creationTimestamp in umgekehrter chronologischer Reihenfolge (neueste Ergebnisse zuerst) sortiert. Mit dieser Option können Sie Ressourcen wie Vorgänge so sortieren, dass der neueste Vorgang zuerst zurückgegeben wird.

Derzeit wird nur die Sortierung nach name oder creationTimestamp desc unterstützt.
pageToken string Gibt ein zu verwendendes Seiten-Token an. Legen Sie pageToken auf das nextPageToken fest, das von einer vorherigen Listenanfrage zurückgegeben wurde, um die nächste Ergebnisseite abzurufen.

Autorisierung

Diese Anfrage benötigt eine Autorisierung mit mindestens einem der folgenden Bereiche (weitere Informationen zu Authentifizierung und Autorisierung).

Bereich
https://www.googleapis.com/auth/ndev.cloudman.readonly
https://www.googleapis.com/auth/cloud-platform
https://www.googleapis.com/auth/ndev.cloudman
https://www.googleapis.com/auth/cloud-platform.read-only

Anfragetext

Mit dieser Methode keinen Anfragetext bereitstellen.

Antwort

Bei Erfolg gibt diese Methode einen Antworttext mit der folgenden Struktur zurück:

{
  "deployments": [
    deployments Resource
  ],
  "nextPageToken": string
}
Name der Eigenschaft Wert Beschreibung Hinweise
deployments[] list Nur Ausgabe. Die in dieser Antwort enthaltenen Bereitstellungen.
nextPageToken string Nur Ausgabe. Ein Token, mit dem eine abgeschnittene Listenanfrage weitergeführt wird.