Method: projects.locations.list

Mencantumkan informasi tentang lokasi yang didukung untuk layanan ini.

Metode ini mencantumkan lokasi berdasarkan cakupan resource yang diberikan di kolom ListLocationsRequest.name:

  • Lokasi global: Jika name kosong, metode ini akan mencantumkan lokasi publik yang tersedia untuk semua project.
  • Lokasi khusus project: Jika name mengikuti format projects/{project}, metode ini akan mencantumkan lokasi yang terlihat oleh project tertentu tersebut. Hal ini mencakup lokasi publik, pribadi, atau lokasi khusus project lainnya yang diaktifkan untuk project.

Untuk penerapan gRPC dan library klien, nama resource diteruskan sebagai kolom name. Untuk panggilan layanan langsung, nama resource dimasukkan ke dalam jalur permintaan berdasarkan penerapan dan versi layanan tertentu.

Permintaan HTTP

GET https://ces.googleapis.com/v1beta/{name=projects/*}/locations

URL menggunakan sintaks gRPC Transcoding.

Parameter jalur

Parameter
name

string

Resource yang memiliki kumpulan lokasi, jika ada.

Parameter kueri

Parameter
filter

string

Filter untuk mempersempit hasil ke subkumpulan pilihan. Bahasa pemfilteran menerima string seperti "displayName=tokyo", dan didokumentasikan secara lebih mendetail di AIP-160.

pageSize

integer

Jumlah hasil maksimum yang akan ditampilkan. Jika tidak disetel, layanan akan memilih default.

pageToken

string

Token halaman yang diterima dari kolom nextPageToken dalam respons. Kirim token halaman tersebut untuk menerima halaman berikutnya.

extraLocationTypes[]

string

Opsional. Jangan gunakan kolom ini kecuali jika didokumentasikan secara eksplisit. Ini terutama untuk penggunaan internal.

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Pesan respons untuk Locations.ListLocations.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON
{
  "locations": [
    {
      object (Location)
    }
  ],
  "nextPageToken": string
}
Kolom
locations[]

object (Location)

Daftar lokasi yang cocok dengan filter yang ditentukan dalam permintaan.

nextPageToken

string

Daftar standar token halaman berikutnya.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.

Izin IAM

Memerlukan izin IAM berikut pada resource name:

  • ces.locations.list

Untuk mengetahui informasi selengkapnya, lihat dokumentasi IAM.