Package google.cloud.location

Indeks

Lokasi

Antarmuka abstrak yang menyediakan informasi terkait lokasi untuk layanan. Metadata khusus layanan disediakan melalui kolom Location.metadata.

GetLocation

rpc GetLocation(GetLocationRequest) returns (Location)

Mendapatkan informasi tentang lokasi.

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:

  • observability.locations.get

Untuk mengetahui informasi selengkapnya, lihat dokumentasi IAM.
ListLocations

rpc ListLocations(ListLocationsRequest) returns (ListLocationsResponse)

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 lokasi khusus project lainnya yang diaktifkan untuk project.

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

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:

  • observability.locations.list

Untuk mengetahui informasi selengkapnya, lihat dokumentasi IAM.

GetLocationRequest

Pesan permintaan untuk Locations.GetLocation.

Kolom
name

string

Nama resource untuk lokasi.

ListLocationsRequest

Pesan permintaan untuk Locations.ListLocations.

Kolom
name

string

Resource yang memiliki kumpulan lokasi, jika ada.
filter

string

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

int32

Jumlah hasil maksimum yang akan ditampilkan. Jika tidak ditetapkan, layanan akan memilih nilai default.
page_token

string

Token halaman yang diterima dari kolom next_page_token dalam respons. Kirim token halaman tersebut untuk menerima halaman berikutnya.
extra_location_types[]

string

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

ListLocationsResponse

Pesan respons untuk Locations.ListLocations.

Kolom
locations[]

Location

Daftar lokasi yang cocok dengan filter yang ditentukan dalam permintaan.
next_page_token

string

Daftar standar token halaman berikutnya.

Lokasi

Resource yang mewakili lokasi Google Cloud.

Kolom
name

string

Nama resource untuk lokasi, yang dapat bervariasi antar-implementasi. Contoh: "projects/example-project/locations/us-east1"
location_id

string

ID kanonis untuk lokasi ini. Contoh: "us-east1".
display_name

string

Nama yang mudah diingat untuk lokasi ini, biasanya nama kota terdekat. Contoh, "Tokyo".
labels

map<string, string>

Atribut lintas layanan untuk lokasi. Contoh

{"cloud.googleapis.com/region": "us-east1"}
metadata

Any

Metadata khusus layanan. Misalnya, kapasitas yang tersedia di lokasi tertentu.