Method: projects.locations.announcements.list

Mencantumkan Announcements untuk region dan project tertentu

Permintaan HTTP

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

URL menggunakan sintaks gRPC Transcoding.

Parameter jalur

Parameter
parent

string

Wajib. Nama resource lokasi yang akan dikueri untuk pengumuman. Nama resource adalah URI tanpa skema yang mengikuti konvensi di https://cloud.google.com/apis/design/resource_names. Contoh: projects/my-project/locations/us-west1-a

Otorisasi memerlukan izin IAM berikut pada parent resource yang ditentukan:

  • vmwareengine.announcements.list

Parameter kueri

Parameter
pageSize

integer

Jumlah maksimum pengumuman yang akan ditampilkan dalam satu halaman. Layanan mungkin menampilkan lebih sedikit dari nilai ini. Nilai maksimum dikonversi menjadi 1.000. Nilai default kolom ini adalah 500.
pageToken

string

Token halaman, yang diterima dari panggilan announcements.list sebelumnya. Berikan ini untuk mengambil halaman selanjutnya.

Saat melakukan penomoran halaman, semua parameter lain yang disediakan untuk announcements.list harus sesuai dengan panggilan yang memberikan token halaman.
filter

string

Ekspresi filter yang cocok dengan resource yang ditampilkan dalam respons. Ekspresi harus menentukan nama kolom, operator perbandingan, dan nilai yang ingin Anda gunakan untuk pemfilteran. Nilai harus berupa string, angka, atau boolean. Operator perbandingan harus berupa =, !=, >, atau <.

Misalnya, jika Anda memfilter daftar jalannya pengumuman, Anda dapat mengecualikan yang bernama example-announcement dengan menentukan name != "example-announcement".

Anda juga dapat memfilter kolom bertingkat.

Untuk memfilter beberapa ekspresi, berikan setiap ekspresi terpisah dalam tanda kurung. Contoh:

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

Secara default, setiap ekspresi adalah ekspresi AND. Namun, Anda dapat menyertakan ekspresi AND dan OR secara eksplisit. Contoh:

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

string

Mengurutkan hasil daftar berdasarkan urutan tertentu. Secara default, hasil yang ditampilkan diurutkan berdasarkan name dalam urutan menaik. Anda juga dapat mengurutkan hasil dalam urutan menurun berdasarkan nilai name menggunakan orderBy="name desc". Saat ini, hanya pengurutan berdasarkan name yang didukung.

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Pesan respons untuk VmwareEngine.ListAnnouncements

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "announcements": [
    {
      object (Announcement)
    }
  ],
  "nextPageToken": string,
  "unreachable": [
    string
  ]
}
Kolom
announcements[]

object (Announcement)

Daftar operasi pengumuman.
nextPageToken

string

Token yang dapat dikirim sebagai pageToken untuk mengambil halaman berikutnya. Jika kolom ini dihilangkan, tidak akan ada halaman berikutnya.
unreachable[]

string

daftar lokasi yang tidak dapat dijangkau

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.