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,
  "intelPccsKey": string
}
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.
intelPccsKey

string

Opsional. Kunci Intel Platform Config and Attestation Service (PCCS) untuk menyediakan dan mengesahkan hardware akselerator AI. Digunakan oleh zona yang menayangkan Gemini di cluster Software 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.
INFO_COMPLETE Zona memiliki semua informasi yang diperlukan untuk memulai persiapan Zona.
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_PROVISIONING Zone siap untuk penyediaan.
READY_FOR_SITE_TURNUP Zona siap untuk pengaktifan situs.
PROVISIONING_STARTED Penyediaan Zone telah dimulai.
PROVISIONING_FAILED Penyediaan Zona gagal.
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,
  "aiCapableIpv4Subnet": {
    object (Subnet)
  },
  "bgpConfig": {
    object (BGPConfig)
  },
  "topLevelDomain": string,
  "torSwitchType": string
}
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.
aiCapableIpv4Subnet

object (Subnet)

Opsional. Subnet IPv4 untuk zona yang melayani Gemini di cluster Software GDC. Subnet /29 terakhir dari rentang yang diberikan dicadangkan untuk DHCP.
bgpConfig

object (BGPConfig)

Opsional. Konfigurasi khusus Border Gateway Protocol (BGP) untuk zona ini. Digunakan oleh zona yang menayangkan Gemini di cluster Software GDC.
topLevelDomain

string

Opsional. Domain level teratas kustom untuk zona ini. Digunakan oleh zona yang menayangkan Gemini di cluster Software GDC.
torSwitchType

string

Opsional. Informasi tambahan tentang jenis peralihan ToR pelanggan. Digunakan oleh zona yang menayangkan Gemini di cluster Software GDC.

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.

BGPConfig

Konfigurasi Border Gateway Protocol (BGP).

Representasi JSON 
{
  "asn": string,
  "l3PeerIps": [
    string
  ]
}
Kolom
asn

string

Wajib. Nomor Sistem Otonom (ASN) BGP.
l3PeerIps[]

string

Wajib. IP Peer BGP. Minimal dua IP peer L3 diperlukan.

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.