REST Resource: projects.locations.zones

Resource: Zone

Zona yang menampung sekumpulan 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,
  "currentResourceOperation": {
    object (ResourceOperation)
  },
  "resourceOperations": [
    {
      object (ResourceOperation)
    }
  ],
  "errors": [
    {
      object (Status)
    }
  ],
  "site": 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 key-value pair. 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 manusia.
state

enum (State)

Hanya output. Status saat ini untuk zona ini.
contacts[]

object (Contact)

Wajib. Kontak (POC) zona (nama, email, telepon). Bergantung pada urutan: kontak pertama dalam daftar adalah kontak utama, 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 lokasi pelanggan.
clusterIntentRequired

boolean

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

boolean

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

boolean

Opsional. Menunjukkan apakah zona ini untuk cluster Gemini di GDC Software.
intelPccsKey

string

Opsional. Kunci Intel Platform Config and Attestation Service (PCCS) untuk menyediakan dan mengesahkan hardware akselerator AI. Digunakan oleh zona yang menyajikan Gemini di cluster GDC Software.
currentResourceOperation

object (ResourceOperation)

Hanya output. Operasi resource saat ini untuk zona tersebut.
resourceOperations[]

object (ResourceOperation)

Opsional. Daftar semua operasi resource yang telah dilakukan di zona tersebut.
errors[]

object (Status)

Hanya output. Error yang terjadi selama pengaktifan zona. Metadata ErrorInfo akan menyertakan stempel waktu dan apakah error dapat dicoba ulang.
site

string

Opsional. Menentukan nama Situs tempat hardware di Zona ini berada. Format: projects/{project}/locations/{location}/sites/{site} Diperlukan untuk Gemini di zona Software GDC.

Negara bagian/Provinsi

Status yang valid untuk zona.

Enum
STATE_UNSPECIFIED Status Zona tidak ditentukan.
ADDITIONAL_INFO_NEEDED Informasi lebih lanjut diperlukan dari pelanggan untuk melanjutkan.
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 telah berhasil.
CUSTOMER_FACTORY_TURNUP_CHECKS_STARTED Zona sedang menjalankan pemeriksaan aktivasi pabrik.
READY_FOR_PROVISIONING Zona siap untuk penyediaan.
READY_FOR_SITE_TURNUP Zona siap untuk aktivasi situs.
PROVISIONING_STARTED Penyediaan Zona telah dimulai.
PROVISIONING_FAILED Penyediaan Zona gagal.
OFFLINE Zona sedang offline.
CUSTOMER_FACTORY_TURNUP_CHECKS_FAILED Zona gagal dalam pemeriksaan turnup pabrik.
ACTIVE Zona tersedia untuk digunakan.
CANCELLED Zona telah dibatalkan.
AWAITING_HARDWARE Zona sedang menunggu pengaitan hardware.

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,
  "boundaryProxyPublicIpv4Range": string,
  "boundaryProxyPrivateEdgeCoreIpv4Range": string,
  "boundaryProxyPrivateCoreEdgeIpv4Range": string,
  "bastionHostPublicIpv4Range": string,
  "bastionHostPrivateIpv4Range": string,
  "tlsPublicRootCertificatePem": string
}
Kolom
machineMgmtIpv4Range

string

Wajib. Blok alamat IPv4 untuk pengelolaan mesin. Harus berupa blok CIDR RFC1918 pribadi atau publik yang cukup besar untuk mengalokasikan setidaknya satu alamat per mesin di Zona. Harus berada di managementIpv4Subnet, dan terpisah dengan rentang alamat lainnya.
kubernetesNodeIpv4Range

string

Wajib. Blok alamat IPv4 untuk node Kubernetes. Harus berupa RFC1918 pribadi atau blok CIDR publik yang cukup besar untuk mengalokasikan setidaknya satu alamat per mesin di Zona. Harus berada di kubernetesIpv4Subnet, dan terpisah dengan rentang alamat lainnya.
kubernetesControlPlaneIpv4Range

string

Wajib. Blok alamat IPv4 untuk bidang kontrol Kubernetes. Harus berupa blok CIDR RFC1918 pribadi atau publik yang cukup besar untuk mengalokasikan setidaknya satu alamat per cluster di Zona. Harus dalam kubernetesIpv4Subnet, dan terpisah dengan rentang alamat lainnya.
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 menyajikan Gemini di cluster GDC Software. Subnet /29 terakhir dari rentang yang disediakan dicadangkan untuk DHCP.
bgpConfig

object (BGPConfig)

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

string

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

string

Opsional. Informasi tambahan tentang jenis switch ToR pelanggan. Digunakan oleh zona yang menyajikan Gemini di cluster GDC Software.
boundaryProxyPublicIpv4Range

string

Opsional. Rentang IPv4 publik proxy batas dalam notasi CIDR. Saat ini, /32 adalah yang diharapkan. Digunakan oleh zona yang menyajikan Gemini di cluster GDC Software.
boundaryProxyPrivateEdgeCoreIpv4Range

string

Opsional. Rentang IPv4 edge ke core pribadi proxy batas dalam notasi CIDR. Saat ini, /32 adalah yang diharapkan. Digunakan oleh zona yang menyajikan Gemini di cluster GDC Software.
boundaryProxyPrivateCoreEdgeIpv4Range

string

Opsional. Rentang IPv4 inti pribadi ke edge proxy batas dalam notasi CIDR. Saat ini, /32 adalah yang diharapkan. Digunakan oleh zona yang menyajikan Gemini di cluster GDC Software.
bastionHostPublicIpv4Range

string

Opsional. Rentang IPv4 publik bastion host dalam notasi CIDR. Saat ini, /32 adalah yang diharapkan. Digunakan oleh zona yang menyajikan Gemini di cluster GDC Software.
bastionHostPrivateIpv4Range

string

Opsional. Rentang IPv4 pribadi bastion host dalam notasi CIDR. Saat ini, /32 adalah yang diharapkan. Digunakan oleh zona yang menyajikan Gemini di cluster GDC Software.
tlsPublicRootCertificatePem

string

Opsional. Root certificate publik TLS dalam format PEM. Digunakan oleh zona yang menyajikan Gemini di cluster GDC Software.

Subnet

Merepresentasikan subnet.

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

string

Wajib. Rentang alamat 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. Diperlukan minimal dua IP peer L3.

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 dalam proses. 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 di project dan lokasi tertentu.

patch

 Memperbarui parameter zona.

signal

 Menandakan status zona.