REST Resource: projects.locations.awsClusters

Resource: AwsCluster

Cluster Anthos yang berjalan di AWS.

Representasi JSON 
{
  "name": string,
  "description": string,
  "networking": {
    object (AwsClusterNetworking)
  },
  "awsRegion": string,
  "controlPlane": {
    object (AwsControlPlane)
  },
  "authorization": {
    object (AwsAuthorization)
  },
  "state": enum (State),
  "endpoint": string,
  "uid": string,
  "reconciling": boolean,
  "createTime": string,
  "updateTime": string,
  "etag": string,
  "annotations": {
    string: string,
    ...
  },
  "workloadIdentityConfig": {
    object (WorkloadIdentityConfig)
  },
  "clusterCaCertificate": string,
  "fleet": {
    object (Fleet)
  },
  "loggingConfig": {
    object (LoggingConfig)
  },
  "errors": [
    {
      object (AwsClusterError)
    }
  ],
  "monitoringConfig": {
    object (MonitoringConfig)
  },
  "binaryAuthorization": {
    object (BinaryAuthorization)
  }
}
Kolom
name

string

Nama resource ini.

Nama cluster diformat sebagai projects/<project-number>/locations/<region>/awsClusters/<cluster-id>.

Lihat Nama Resource untuk mengetahui detail selengkapnya tentang nama resource Google Cloud Platform.
description

string

Opsional. Deskripsi cluster ini yang dapat dibaca manusia. Tidak boleh lebih dari 255 byte berenkode UTF-8.
networking

object (AwsClusterNetworking)

Wajib. Konfigurasi jaringan seluruh cluster.
awsRegion

string

Wajib. Region AWS tempat cluster berjalan.

Setiap region Google Cloud mendukung subset region AWS terdekat. Anda dapat memanggil locations.getAwsServerConfig untuk mencantumkan semua region AWS yang didukung dalam region Google Cloud tertentu.
controlPlane

object (AwsControlPlane)

Wajib. Konfigurasi yang terkait dengan bidang kontrol cluster.
authorization

object (AwsAuthorization)

Wajib. Konfigurasi yang terkait dengan setelan RBAC cluster.
state

enum (State)

Hanya output. Status cluster saat ini.
endpoint

string

Hanya output. Endpoint server API cluster.
uid

string

Hanya output. ID unik global untuk cluster.
reconciling

boolean

Hanya output. Jika disetel, saat ini ada perubahan yang sedang berlangsung pada cluster.
createTime

string (Timestamp format)

Hanya output. Waktu saat cluster ini dibuat.

Menggunakan RFC 3339, dengan output yang dihasilkan akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Hanya output. Waktu saat cluster ini terakhir diperbarui.

Menggunakan RFC 3339, dengan output yang dihasilkan akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
etag

string

Memungkinkan klien melakukan operasi baca-ubah-tulis yang konsisten melalui kontrol serentak optimis.

Dapat dikirim pada permintaan update dan penghapusan untuk memastikan klien memiliki nilai terbaru sebelum melanjutkan.
annotations

map (key: string, value: string)

Opsional. Anotasi pada cluster.

Kolom ini memiliki batasan yang sama dengan anotasi Kubernetes. Ukuran total semua kunci dan nilai gabungan dibatasi hingga 256k. Kunci dapat memiliki 2 segmen: awalan (opsional) dan nama (wajib), yang dipisahkan dengan garis miring (/). Awalan harus berupa subdomain DNS. Nama harus terdiri dari maksimal 63 karakter, diawali dan diakhiri dengan alfanumerik, dengan tanda hubung (-), garis bawah (_), titik (.), dan alfanumerik di antaranya.

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
workloadIdentityConfig

object (WorkloadIdentityConfig)

Hanya output. Setelan Workload Identity.
clusterCaCertificate

string

Hanya output. Sertifikat x509 berenkode PEM untuk root of trust cluster.
fleet

object (Fleet)

Wajib. Konfigurasi armada.
loggingConfig

object (LoggingConfig)

Opsional. Konfigurasi logging untuk cluster ini.
errors[]

object (AwsClusterError)

Hanya output. Serangkaian error yang ditemukan di cluster.
monitoringConfig

object (MonitoringConfig)

Opsional. Konfigurasi pemantauan untuk cluster ini.
binaryAuthorization

object (BinaryAuthorization)

Opsional. Konfigurasi Otorisasi Biner untuk cluster ini.

AwsClusterNetworking

ClusterNetworking menentukan konfigurasi jaringan di seluruh cluster.

Cluster Anthos di AWS berjalan di satu VPC. Hal ini mencakup replika bidang kontrol dan node kumpulan node.

Representasi JSON 
{
  "vpcId": string,
  "podAddressCidrBlocks": [
    string
  ],
  "serviceAddressCidrBlocks": [
    string
  ],
  "perNodePoolSgRulesDisabled": boolean
}
Kolom
vpcId

string

Wajib. VPC yang terkait dengan cluster. Semua cluster komponen (yaitu bidang kontrol dan node pool) berjalan di satu VPC.

Kolom ini tidak dapat diubah setelah dibuat.
podAddressCidrBlocks[]

string

Wajib. Semua pod dalam cluster akan mendapatkan alamat IPv4 dari rentang ini. Hanya satu rentang yang didukung. Kolom ini tidak dapat diubah setelah dibuat.
serviceAddressCidrBlocks[]

string

Wajib. Semua layanan dalam cluster akan mendapatkan alamat IPv4 dari rentang ini. Hanya satu rentang yang didukung. Kolom ini tidak dapat diubah setelah dibuat.
perNodePoolSgRulesDisabled

boolean

Opsional. Nonaktifkan aturan grup keamanan subnet per node pool di grup keamanan bidang kontrol. Jika disetel ke benar (true), Anda juga harus memberikan satu atau beberapa grup keamanan yang memastikan kumpulan node dapat mengirim permintaan ke bidang kontrol di TCP/443 dan TCP/8132. Jika hal ini tidak dilakukan, kumpulan node mungkin tidak tersedia.

AwsControlPlane

ControlPlane menentukan parameter umum antara node bidang kontrol.

Representasi JSON 
{
  "version": string,
  "instanceType": string,
  "sshConfig": {
    object (AwsSshConfig)
  },
  "subnetIds": [
    string
  ],
  "securityGroupIds": [
    string
  ],
  "iamInstanceProfile": string,
  "rootVolume": {
    object (AwsVolumeTemplate)
  },
  "mainVolume": {
    object (AwsVolumeTemplate)
  },
  "databaseEncryption": {
    object (AwsDatabaseEncryption)
  },
  "tags": {
    string: string,
    ...
  },
  "awsServicesAuthentication": {
    object (AwsServicesAuthentication)
  },
  "proxyConfig": {
    object (AwsProxyConfig)
  },
  "configEncryption": {
    object (AwsConfigEncryption)
  },
  "instancePlacement": {
    object (AwsInstancePlacement)
  }
}
Kolom
version

string

Wajib. Versi Kubernetes yang akan dijalankan pada replika bidang kontrol (misalnya, 1.19.10-gke.1000).

Anda dapat mencantumkan semua versi yang didukung di region Google Cloud tertentu dengan memanggil locations.getAwsServerConfig.
instanceType

string

Opsional. Jenis instance AWS.

Jika tidak ditentukan, nilai default akan digunakan berdasarkan versi cluster.
sshConfig

object (AwsSshConfig)

Opsional. Konfigurasi SSH untuk cara mengakses mesin bidang kontrol yang mendasarinya.
subnetIds[]

string

Wajib. Daftar subnet tempat replika bidang kontrol akan berjalan. Replika akan disediakan di setiap subnet dan hingga tiga nilai dapat diberikan. Setiap subnet harus berada di Zona Ketersediaan (AZ) AWS yang berbeda.
securityGroupIds[]

string

Opsional. ID grup keamanan tambahan yang akan ditambahkan ke replika bidang kontrol. Anthos Multi-Cloud API akan otomatis membuat dan mengelola grup keamanan dengan aturan minimum yang diperlukan untuk cluster yang berfungsi.
iamInstanceProfile

string

Wajib. Nama atau ARN profil instance IAM AWS yang akan ditetapkan ke setiap replika bidang kontrol.
rootVolume

object (AwsVolumeTemplate)

Opsional. Konfigurasi terkait volume root yang disediakan untuk setiap replika bidang kontrol.

Volume akan disediakan di zona ketersediaan yang terkait dengan subnet yang sesuai.

Jika tidak ditentukan, setelan defaultnya adalah 32 GiB dengan jenis volume GP2.
mainVolume

object (AwsVolumeTemplate)

Opsional. Konfigurasi terkait volume utama yang disediakan untuk setiap replika bidang kontrol. Volume utama bertanggung jawab untuk menyimpan semua status etcd cluster.

Volume akan disediakan di zona ketersediaan yang terkait dengan subnet yang sesuai.

Jika tidak ditentukan, setelan defaultnya adalah 8 GiB dengan jenis volume GP2.
databaseEncryption

object (AwsDatabaseEncryption)

Wajib. ARN kunci AWS KMS yang digunakan untuk mengenkripsi rahasia cluster.
tags

map (key: string, value: string)

Opsional. Sekumpulan tag resource AWS untuk disebarkan ke semua resource AWS terkelola yang mendasarinya.

Tentukan maksimal 50 pasangan yang berisi alfanumerik, spasi, dan simbol (.+-=_:@/). Kunci dapat berisi hingga 127 karakter Unicode. Nilai dapat mencapai 255 karakter Unicode.

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
awsServicesAuthentication

object (AwsServicesAuthentication)

Wajib. Konfigurasi autentikasi untuk pengelolaan resource AWS.
proxyConfig

object (AwsProxyConfig)

Opsional. Konfigurasi proxy untuk traffic HTTP(S) keluar.
configEncryption

object (AwsConfigEncryption)

Wajib. Enkripsi konfigurasi untuk data pengguna.
instancePlacement

object (AwsInstancePlacement)

Opsional. Penempatan yang akan digunakan pada instance bidang kontrol. Jika tidak ditentukan, tenancy default VPC akan digunakan.

AwsDatabaseEncryption

Konfigurasi terkait enkripsi secret lapisan aplikasi.

Representasi JSON 
{
  "kmsKeyArn": string
}
Kolom
kmsKeyArn

string

Wajib. ARN kunci AWS KMS yang digunakan untuk mengenkripsi rahasia cluster.

AwsServicesAuthentication

Konfigurasi autentikasi untuk pengelolaan resource AWS.

Representasi JSON 
{
  "roleArn": string,
  "roleSessionName": string
}
Kolom
roleArn

string

Wajib. Amazon Resource Name (ARN) dari peran yang akan diasumsikan Anthos Multi-Cloud API saat mengelola resource AWS di akun Anda.
roleSessionName

string

Opsional. ID untuk sesi peran yang diasumsikan.

Jika tidak ditentukan, setelan defaultnya adalah multicloud-service-agent.

AwsAuthorization

Konfigurasi yang terkait dengan setelan RBAC cluster.

Representasi JSON 
{
  "adminUsers": [
    {
      object (AwsClusterUser)
    }
  ],
  "adminGroups": [
    {
      object (AwsClusterGroup)
    }
  ]
}
Kolom
adminUsers[]

object (AwsClusterUser)

Opsional. Pengguna yang dapat melakukan operasi sebagai admin cluster. Managed ClusterRoleBinding akan dibuat untuk memberikan peran ClusterRole cluster-admin kepada pengguna. Hingga sepuluh pengguna admin dapat diberikan.

Untuk mengetahui info selengkapnya tentang RBAC, lihat https://kubernetes.io/docs/reference/access-authn-authz/rbac/#user-facing-roles
adminGroups[]

object (AwsClusterGroup)

Opsional. Grup pengguna yang dapat melakukan operasi sebagai admin cluster. Managed ClusterRoleBinding akan dibuat untuk memberikan ClusterRole cluster-admin kepada grup. Maksimal sepuluh grup admin dapat diberikan.

Untuk mengetahui info selengkapnya tentang RBAC, lihat https://kubernetes.io/docs/reference/access-authn-authz/rbac/#user-facing-roles

AwsClusterUser

Identitas subjek jenis pengguna untuk cluster AWS.

Representasi JSON 
{
  "username": string
}
Kolom
username

string

Wajib. Nama pengguna, misalnya my-gcp-id@gmail.com.

AwsClusterGroup

Identitas subjek jenis grup untuk cluster AWS.

Representasi JSON 
{
  "group": string
}
Kolom
group

string

Wajib. Nama grup, misalnya my-group@domain.com.

Negara bagian/Provinsi

Status siklus proses cluster.

Enum
STATE_UNSPECIFIED Belum ditetapkan.
PROVISIONING Status PROVISIONING menunjukkan bahwa cluster sedang dibuat.
RUNNING Status RUNNING menunjukkan bahwa cluster telah dibuat dan dapat digunakan sepenuhnya.
RECONCILING Status MENYAMAKAN menunjukkan bahwa beberapa pekerjaan sedang aktif dilakukan di cluster, seperti mengupgrade replika bidang kontrol.
STOPPING Status STOPPING menunjukkan bahwa cluster sedang dihapus.
ERROR Status ERROR menunjukkan bahwa cluster berada dalam status rusak yang tidak dapat dipulihkan.
DEGRADED Status DEGRADED menunjukkan bahwa cluster memerlukan tindakan pengguna untuk memulihkan fungsi penuh.

AwsClusterError

AwsClusterError menjelaskan error yang ditemukan di cluster AWS.

Representasi JSON 
{
  "message": string
}
Kolom
message

string

Deskripsi error yang mudah dipahami.

Metode

create
(deprecated)

 Membuat resource AwsCluster baru di project dan region Google Cloud Platform tertentu.

delete
(deprecated)

 Menghapus resource AwsCluster tertentu.

generateAwsAccessToken
(deprecated)

 Membuat token akses berjangka pendek untuk mengautentikasi ke resource AwsCluster tertentu.

generateAwsClusterAgentToken
(deprecated)

 Membuat token akses untuk agen cluster.

get
(deprecated)

 Menjelaskan resource AwsCluster tertentu.

getJwks
(deprecated)

 Mendapatkan komponen publik kunci penandatanganan cluster dalam format JSON Web Key.

list
(deprecated)

 Mencantumkan semua resource AwsCluster pada project dan region Google Cloud tertentu.

patch
(deprecated)

 Memperbarui AwsCluster.