Method: projects.locations.memberships.create

Membuat Keanggotaan baru.

Saat ini hanya didukung untuk cluster GKE di Google Cloud. Untuk mendaftarkan cluster lain, ikuti petunjuknya di https://cloud.google.com/kubernetes-engine/enterprise/multicluster-management/connect/registering-a-cluster.

Permintaan HTTP

POST https://gkehub.googleapis.com/v1alpha/{parent=projects/*/locations/*}/memberships

URL menggunakan sintaks gRPC Transcoding.

Parameter jalur

Parameter
parent

string

Wajib. Induk (project dan lokasi) tempat Langganan akan dibuat. Ditentukan dalam format projects/*/locations/*.

Otorisasi memerlukan izin IAM berikut pada resource parent yang ditentukan:

  • gkehub.memberships.create

Parameter kueri

Parameter
membershipId

string

Wajib. ID yang dipilih klien untuk keanggotaan. membershipId harus berupa label DNS yang sesuai dengan RFC 1123 yang valid:

  1. Maksimal 63 karakter
  2. Harus terdiri dari karakter alfanumerik huruf kecil atau -
  3. Nama harus diawali dan diakhiri dengan karakter alfanumerik

Yang dapat dinyatakan sebagai ekspresi reguler: [a-z0-9]([-a-z0-9]*[a-z0-9])?, dengan panjang maksimum 63 karakter.

requestId

string

Opsional. ID permintaan untuk mengidentifikasi permintaan. Tetapkan ID permintaan unik sehingga jika Anda harus mencoba lagi permintaan, server akan mengetahui untuk mengabaikan permintaan tersebut jika sudah diselesaikan. Server akan menjamin setidaknya selama 60 menit setelah permintaan pertama.

Misalnya, pertimbangkan situasi saat Anda membuat permintaan awal dan waktu permintaan habis. Jika Anda membuat permintaan lagi dengan ID permintaan yang sama, server dapat memeriksa apakah operasi asli dengan ID permintaan yang sama diterima, dan jika demikian, akan mengabaikan permintaan kedua. Langkah ini mencegah klien membuat komitmen duplikat secara tidak sengaja.

ID permintaan harus berupa UUID yang valid dengan pengecualian bahwa nol UUID tidak didukung (00000000-0000-0000-0000-000000000000).

Isi permintaan

Isi permintaan memuat instance Membership.

Isi respons

Jika berhasil, isi respons memuat instance Operation yang baru dibuat.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk informasi selengkapnya, lihat Ringkasan Autentikasi.