Method: projects.locations.announcements.list

Listet Announcements für eine bestimmte Region und ein bestimmtes Projekt auf.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

Erforderlich. Der Ressourcenname des Standorts, für den Ankündigungen 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-west1-a

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

  • vmwareengine.announcements.list

Suchparameter

Parameter
pageSize

integer

Die maximale Anzahl von Ankündigungen, 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 announcements.list-Aufruf empfangen wurde. Geben Sie dieses an, um die nachfolgende Seite abzurufen.

Beim Paginieren müssen alle anderen für announcements.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 Ankündigungsläufen filtern, können Sie die Läufe mit dem Namen example-announcement ausschließen, indem Sie name != "example-announcement" angeben.

Sie können auch verschachtelte Felder filtern.

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

(name = "example-announcement")
(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 = "announcement-1") AND
(createTime > "2021-04-12T08:15:10.40Z") OR
(name = "announcement-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.ListAnnouncements

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

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

object (Announcement)

Eine Liste der Ankündigungsausführungen.
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

Liste der nicht erreichbaren Standorte

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter Authentication Overview.