Method: projects.locations.list

Mencantumkan informasi tentang lokasi yang didukung untuk layanan ini.

Metode ini mencantumkan lokasi berdasarkan cakupan resource yang disediakan 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 khusus project lainnya yang diaktifkan untuk project.

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

Permintaan HTTP

GET https://gdchardwaremanagement.googleapis.com/v1alpha/{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 subset pilihan. Bahasa pemfilteran menerima string seperti "displayName=tokyo", dan didokumentasikan lebih detail di AIP-160.

pageSize

integer

Jumlah hasil maksimum yang akan ditampilkan. Jika tidak ditetapkan, layanan akan memilih nilai 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. Kolom 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 cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.

Izin IAM

Memerlukan izin IAM berikut pada resource name:

  • gdchardwaremanagement.locations.list

Untuk mengetahui informasi selengkapnya, baca dokumentasi IAM.