REST Resource: projects.locations.zones

Resource: Zone

Zona yang menyimpan serangkaian hardware.

Representasi JSON
{
  "name": string,
  "createTime": string,
  "updateTime": string,
  "labels": {
    string: string,
    ...
  },
  "displayName": string,
  "state": enum (State),
  "contacts": [
    {
      object (Contact)
    }
  ],
  "ciqUri": string,
  "networkConfig": {
    object (ZoneNetworkConfig)
  },
  "globallyUniqueId": string,
  "subscriptionConfigs": [
    {
      object (SubscriptionConfig)
    }
  ],
  "provisioningState": enum (ProvisioningState),
  "skipClusterProvisioning": boolean,
  "clusterIntentRequired": boolean,
  "clusterIntentVerified": boolean,
  "aiCapable": boolean
}
Kolom
name

string

ID. Nama zona ini. Format: projects/{project}/locations/{location}/zones/{zone}

createTime

string (Timestamp format)

Hanya output. Waktu saat zona ini dibuat.

Menggunakan RFC 3339 yang outputnya 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 zona ini terakhir diperbarui.

Menggunakan RFC 3339 yang outputnya 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".

labels

map (key: string, value: string)

Opsional. Label yang terkait dengan zona ini sebagai pasangan nilai kunci. Untuk mengetahui informasi selengkapnya tentang label, lihat Membuat dan mengelola label.

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

displayName

string

Opsional. Nama tampilan zona ini yang mudah dipahami.

state

enum (State)

Hanya output. Status saat ini untuk zona ini.

contacts[]

object (Contact)

Wajib. Kontak zona (nama, email, telepon). Bergantung pada urutan: kontak pertama dalam daftar adalah kontak utama, kontak kedua adalah kontak sekunder, dll.

ciqUri

string

Hanya output. Link ke sheet Customer Intake Questionnaire (CIQ) untuk zona ini.

networkConfig

object (ZoneNetworkConfig)

Opsional. Konfigurasi jaringan untuk zona ini.

globallyUniqueId

string

Hanya output. ID unik global yang dibuat untuk Zona Edge ini.

subscriptionConfigs[]

object (SubscriptionConfig)

Hanya output. Konfigurasi langganan untuk zona ini.

provisioningState

enum (ProvisioningState)

Hanya output. Status penyediaan untuk konfigurasi seperti alamat MAC.

skipClusterProvisioning

boolean

Opsional. Apakah akan melewati langkah penyediaan cluster selama pengaktifan pabrik. Jika benar, menunjukkan bahwa cluster Kubernetes akan dibuat setelah hardware zona diinstal di situs pelanggan.

clusterIntentRequired

boolean

Hanya output. Menunjukkan apakah maksud pengelompokan yang valid harus diberikan oleh pelanggan sebelum menerima pesanan. Jika benar, pesanan tidak dapat diterima hingga maksud pengelompokan ada. Hal ini digunakan untuk menerapkan validasi awal dan mencegah penundaan yang disebabkan oleh konfigurasi yang tidak ada.

clusterIntentVerified

boolean

Hanya output. Menunjukkan apakah maksud cluster yang diberikan telah berhasil diverifikasi. Flag ini memastikan maksud cluster ada sebelum pesanan dapat diterima.

aiCapable

boolean

Hanya output. Menunjukkan apakah zona ini untuk cluster Software Gemini di GDC.

Negara bagian/Provinsi

Status yang valid untuk zona.

Enum
STATE_UNSPECIFIED Status Zona tidak ditentukan.
ADDITIONAL_INFO_NEEDED Diperlukan informasi lebih lanjut dari pelanggan untuk melanjutkan proses.
PREPARING Google sedang menyiapkan Zona.
READY_FOR_CUSTOMER_FACTORY_TURNUP_CHECKS Pengaktifan pabrik berhasil.
CUSTOMER_FACTORY_TURNUP_CHECKS_STARTED Zona sedang menjalankan pemeriksaan aktivasi pabrik.
READY_FOR_SITE_TURNUP Zona siap untuk pengaktifan situs.
CUSTOMER_FACTORY_TURNUP_CHECKS_FAILED Zone gagal dalam pemeriksaan aktivasi pabrik.
ACTIVE Zona ini dapat digunakan.
CANCELLED Zona telah dibatalkan.

ZoneNetworkConfig

Konfigurasi jaringan untuk zona.

Representasi JSON
{
  "machineMgmtIpv4Range": string,
  "kubernetesNodeIpv4Range": string,
  "kubernetesControlPlaneIpv4Range": string,
  "managementIpv4Subnet": {
    object (Subnet)
  },
  "kubernetesIpv4Subnet": {
    object (Subnet)
  },
  "dnsIpv4Addresses": [
    string
  ],
  "kubernetesPrimaryVlanId": integer
}
Kolom
machineMgmtIpv4Range

string

Wajib. Blok alamat IPv4 untuk pengelolaan mesin. Harus berupa blok CIDR publik atau pribadi RFC1918 yang cukup besar untuk mengalokasikan setidaknya satu alamat per mesin di Zona. Harus dalam managementIpv4Subnet, dan tidak berdekatan dengan rentang alamat lain.

kubernetesNodeIpv4Range

string

Wajib. Blok alamat IPv4 untuk node Kubernetes. Harus berupa blok CIDR publik atau pribadi RFC1918 yang cukup besar untuk mengalokasikan setidaknya satu alamat per mesin di Zona. Harus dalam kubernetesIpv4Subnet, dan tidak berdekatan dengan rentang alamat lain.

kubernetesControlPlaneIpv4Range

string

Wajib. Blok alamat IPv4 untuk bidang kontrol Kubernetes. Harus berupa blok CIDR publik atau RFC1918 pribadi yang cukup besar untuk mengalokasikan setidaknya satu alamat per cluster di Zona. Harus dalam kubernetesIpv4Subnet, dan tidak berdekatan dengan rentang alamat lain.

managementIpv4Subnet

object (Subnet)

Wajib. Subnet IPv4 untuk jaringan pengelolaan.

kubernetesIpv4Subnet

object (Subnet)

Opsional. Subnet IPv4 untuk jaringan kubernetes. Jika tidak ditentukan, subnet kubernetes akan sama dengan subnet pengelolaan.

dnsIpv4Addresses[]

string

Opsional. Server nama DNS. Infrastruktur GDC akan me-resolve kueri DNS melalui IP ini. Jika tidak ditentukan, DNS Google akan digunakan.

kubernetesPrimaryVlanId

integer

Opsional. ID VLAN Kubernetes. Secara default, node kubernetes, termasuk jaringan kubernetes utama, berada di VLAN yang sama dengan jaringan pengelolaan mesin. Untuk tujuan segmentasi jaringan, keduanya dapat dipisahkan secara opsional.

Subnet

Merepresentasikan subnet.

Representasi JSON
{
  "addressRange": string,
  "defaultGatewayIpAddress": string
}
Kolom
addressRange

string

Wajib. Rentang alamat IP untuk subnet ini dalam notasi CIDR.

defaultGatewayIpAddress

string

Wajib. Gateway default untuk subnet ini.

SubscriptionConfig

Pesan untuk menyimpan konfigurasi langganan.

Representasi JSON
{
  "subscriptionId": string,
  "billingId": string,
  "state": enum (SubscriptionState)
}
Kolom
subscriptionId

string

Hanya output. ID unik langganan.

billingId

string

Hanya output. ID Penagihan Google Cloud yang digunakan untuk membuat langganan.

state

enum (SubscriptionState)

Hanya output. Status langganan saat ini.

SubscriptionState

Enum untuk menampilkan status langganan.

Enum
SUBSCRIPTION_STATE_UNSPECIFIED Status tidak ditentukan.
ACTIVE Status aktif berarti langganan telah berhasil dibuat dan penagihan sedang berlangsung.
INACTIVE Tidak aktif berarti langganan telah berhasil dibuat, tetapi penagihan belum dimulai.
ERROR Langganan dalam status salah.
FAILED_TO_RETRIEVE Status langganan gagal diambil. Masalah ini mungkin bersifat sementara. Pengguna harus mencoba kembali permintaan.
COMPLETED Langganan telah selesai, karena telah mencapai tanggal akhir.

ProvisioningState

Status penyediaan yang valid untuk konfigurasi seperti alamat MAC.

Enum
PROVISIONING_STATE_UNSPECIFIED Status penyediaan tidak ditentukan.
PROVISIONING_REQUIRED Penyediaan diperlukan. Ditetapkan oleh Google.
PROVISIONING_IN_PROGRESS Penyediaan sedang berlangsung. Ditetapkan oleh pelanggan.
PROVISIONING_COMPLETE Penyediaan selesai. Ditetapkan oleh pelanggan.

Metode

create

Membuat zona baru di project dan lokasi tertentu.

delete

Menghapus zona.

get

Mendapatkan detail zona.

list

Mencantumkan zona dalam project dan lokasi tertentu.

patch

Memperbarui parameter zona.

signal

Menandakan status zona.