Method: projects.locations.privateClouds.externalAddresses.list

Listet externe IP-Adressen auf, die VMware-Arbeitslast-VMs in einer bestimmten privaten Cloud zugewiesen sind.

HTTP-Anfrage

GET https://vmwareengine.googleapis.com/v1/{parent=projects/*/locations/*/privateClouds/*}/externalAddresses

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

Erforderlich. Der Ressourcenname der privaten Cloud, für die externe IP-Adressen abgefragt werden sollen. Ressourcennamen sind schemalose URIs, die den Konventionen unter https://cloud.google.com/apis/design/resource_names entsprechen. Beispiel: projects/my-project/locations/us-central1-a/privateClouds/my-cloud

Die Autorisierung erfordert folgende IAM-Berechtigung für die angegebene Ressource parent:

  • vmwareengine.externalAddresses.list

Suchparameter

Parameter
pageSize

integer

Die maximale Anzahl externer IP-Adressen, die auf einer Seite zurückgegeben werden sollen. Der Dienst gibt möglicherweise weniger als diesen Wert zurück. Der Höchstwert wird auf 1.000 festgelegt. Der Standardwert dieses Felds ist 500.
pageToken

string

Ein Seitentoken, das von einem vorherigen externalAddresses.list-Aufruf empfangen wurde. Geben Sie dieses an, um die nachfolgende Seite abzurufen.

Beim Paginieren müssen alle anderen für externalAddresses.list bereitgestellten Parameter mit dem Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat.
filter

string

Ein Filterausdruck, der mit den in der Antwort zurückgegebenen Ressourcen übereinstimmt. Im Ausdruck müssen der Feldname, ein Vergleichsoperator und der Wert angegeben werden, den Sie zum Filtern verwenden möchten. Der Wert muss ein String, eine Zahl oder ein boolescher Wert sein. Der Vergleichsoperator muss =, !=, > oder < sein.

Wenn Sie beispielsweise eine Liste von IP-Adressen filtern, können Sie die Adressen mit dem Namen example-ip ausschließen, indem Sie name != "example-ip" angeben.

Wenn Sie nach mehreren Ausdrücken filtern möchten, geben Sie jeden Ausdruck in Klammern an. Beispiel:

(name = "example-ip")
(createTime > "2021-04-12T08:15:10.40Z")

Standardmäßig ist jeder Ausdruck ein AND-Ausdruck. Sie können jedoch explizit AND- und OR-Ausdrücke einfügen. Beispiel:

(name = "example-ip-1") AND
(createTime > "2021-04-12T08:15:10.40Z") OR
(name = "example-ip-2")
orderBy

string

Sortiert Listenergebnisse in einer bestimmten Reihenfolge. Standardmäßig werden die zurückgegebenen Ergebnisse nach name in aufsteigender Reihenfolge sortiert. Sie können die Ergebnisse auch mit orderBy="name desc" in absteigender Reihenfolge nach dem name-Wert sortieren. Derzeit wird nur die Sortierung nach name unterstützt.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Antwortnachricht für VmwareEngine.ListExternalAddresses

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

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

object (ExternalAddress)

Eine Liste externer IP-Adressen.
nextPageToken

string

Ein Token, das als pageToken gesendet werden kann, um die nächste Seite abzurufen. Wenn dieses Feld weggelassen wird, gibt es keine nachfolgenden Seiten.
unreachable[]

string

Standorte, die bei einer aggregierten Abfrage mit Platzhaltern nicht erreicht werden konnten.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter Authentication Overview.