Method: projects.locations.privateClouds.upgrades.list

Mencantumkan Upgrades yang lalu, sedang berlangsung, dan mendatang untuk cloud pribadi tertentu.

Permintaan HTTP

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

URL menggunakan sintaks gRPC Transcoding.

Parameter jalur

Parameter
parent

string

Wajib. Membuat kueri daftar Upgrades untuk nama resource cloud pribadi yang diberikan. 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/privateClouds/my-cloud

Otorisasi memerlukan izin IAM berikut pada parent resource yang ditentukan:

  • vmwareengine.upgrades.list

Parameter kueri

Parameter
pageSize

integer

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

string

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

Saat melakukan penomoran halaman, semua parameter lain yang disediakan untuk upgrades.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 upgrade, Anda dapat mengecualikan upgrade yang bernama example-upgrade1 dengan menentukan name != "example-upgrade1".

Anda juga dapat memfilter kolom bertingkat.

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

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

Jika berhasil, isi respons memuat data dengan struktur berikut:

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

object (Upgrade)

Daftar Upgrades.
nextPageToken

string

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

string

Daftar resource yang tidak dapat dijangkau.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.