REST Resource: projects.locations.privateClouds

Resource: PrivateCloud

Mewakili resource cloud pribadi. Cloud pribadi jenis STANDARD dan TIME_LIMITED adalah resource zonal, sedangkan cloud pribadi STRETCHED bersifat regional.

Representasi JSON 
{
  "name": string,
  "createTime": string,
  "updateTime": string,
  "deleteTime": string,
  "expireTime": string,
  "state": enum (State),
  "networkConfig": {
    object (NetworkConfig)
  },
  "managementCluster": {
    object (ManagementCluster)
  },
  "description": string,
  "hcx": {
    object (Hcx)
  },
  "nsx": {
    object (Nsx)
  },
  "vcenter": {
    object (Vcenter)
  },
  "uid": string,
  "type": enum (Type)
}
Kolom
name

string

Hanya output. ID. Nama resource cloud pribadi ini. Nama resource adalah URI tanpa skema yang mengikuti konvensi di https://cloud.google.com/apis/design/resource_names. Contoh: projects/my-project/locations/us-central1-a/privateClouds/my-cloud
createTime

string (Timestamp format)

Hanya output. Waktu pembuatan resource ini.

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 pembaruan terakhir resource ini.

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".
deleteTime

string (Timestamp format)

Hanya output. Waktu saat resource dijadwalkan untuk dihapus.

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".
expireTime

string (Timestamp format)

Hanya output. Waktu saat resource akan dihapus secara permanen.

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".
state

enum (State)

Hanya output. Status resource. Nilai baru dapat ditambahkan ke enum ini jika sesuai.
networkConfig

object (NetworkConfig)

Wajib. Konfigurasi jaringan cloud pribadi.
managementCluster

object (ManagementCluster)

Wajib. Hanya input. Cluster pengelolaan untuk cloud pribadi ini. Kolom ini wajib diisi selama pembuatan cloud pribadi untuk memberikan detail cluster default.

Kolom berikut tidak dapat diubah setelah pembuatan cloud pribadi: ManagementCluster.clusterId, ManagementCluster.nodeTypeId.
description

string

Deskripsi yang diberikan pengguna untuk cloud pribadi ini.
hcx

object (Hcx)

Hanya output. HCX Appliance.
nsx

object (Nsx)

Hanya output. Peralatan NSX.
vcenter

object (Vcenter)

Hanya output. Vcenter appliance.
uid

string

Hanya output. ID unik yang dibuat sistem untuk resource.
type

enum (Type)

Opsional. Jenis cloud pribadi. Nilai defaultnya adalah STANDARD.

Negara bagian/Provinsi

Enum State menentukan kemungkinan status cloud pribadi.

Enum
STATE_UNSPECIFIED Nilai default. Nilai ini tidak boleh digunakan.
ACTIVE Private Cloud sudah siap.
CREATING Private Cloud sedang dibuat.
UPDATING Cloud pribadi sedang diperbarui.
FAILED Private Cloud dalam status gagal.
DELETED Private Cloud dijadwalkan untuk dihapus. Proses penghapusan dapat dibatalkan menggunakan metode urungkan penghapusan yang sesuai.
PURGING Private Cloud dihapus secara permanen dan sedang dihapus dari sistem.

NetworkConfig

Konfigurasi jaringan di project konsumen yang harus di-peering.

Representasi JSON 
{
  "managementCidr": string,
  "vmwareEngineNetwork": string,
  "vmwareEngineNetworkCanonical": string,
  "managementIpAddressLayoutVersion": integer,
  "dnsServerIp": string
}
Kolom
managementCidr

string

Wajib. CIDR pengelolaan yang digunakan oleh peralatan pengelolaan VMware.
vmwareEngineNetwork

string

Opsional. Nama resource relatif jaringan VMware Engine yang terhubung ke cloud pribadi. Tentukan nama dalam formulir berikut: projects/{project}/locations/{location}/vmwareEngineNetworks/{vmwareEngineNetworkId} dengan {project} dapat berupa nomor project atau project ID.
vmwareEngineNetworkCanonical

string

Hanya output. Nama kanonis jaringan VMware Engine dalam bentuk: projects/{projectNumber}/locations/{location}/vmwareEngineNetworks/{vmwareEngineNetworkId}
managementIpAddressLayoutVersion

integer

Hanya output. Versi tata letak alamat IP dari rentang alamat IP pengelolaan. Kemungkinan versi mencakup: * managementIpAddressLayoutVersion=1: Menunjukkan tata letak alamat IP lama yang digunakan oleh beberapa cloud pribadi yang ada. Fitur ini tidak lagi didukung untuk cloud pribadi baru karena tidak mendukung semua fitur. * managementIpAddressLayoutVersion=2: Menunjukkan tata letak alamat IP terbaru yang digunakan oleh semua cloud pribadi yang baru dibuat. Versi ini mendukung semua fitur saat ini.
dnsServerIp

string

Hanya output. IP Server DNS Private Cloud. Semua kueri DNS dapat diteruskan ke alamat ini untuk resolusi nama entitas pengelolaan Private Cloud seperti vCenter, NSX-T Manager, dan host ESXi.

ManagementCluster

Konfigurasi cluster pengelolaan.

Representasi JSON 
{
  "clusterId": string,
  "nodeTypeConfigs": {
    string: {
      object (NodeTypeConfig)
    },
    ...
  },
  "stretchedClusterConfig": {
    object (StretchedClusterConfig)
  }
}
Kolom
clusterId

string

Wajib. ID yang diberikan pengguna untuk Cluster baru. ID harus memenuhi persyaratan berikut:

  • Hanya berisi 1-63 karakter alfanumerik dan tanda hubung
  • Dimulai dengan karakter alfabet
  • Diakhiri dengan karakter non-tanda hubung
  • Tidak diformat sebagai UUID
  • Sesuai dengan RFC 1034 (bagian 3.5)
nodeTypeConfigs

map (key: string, value: object (NodeTypeConfig))

Wajib. Peta jenis node cluster dalam cluster ini, dengan kunci adalah ID kanonis jenis node (sesuai dengan NodeType).

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

object (StretchedClusterConfig)

Opsional. Konfigurasi cluster yang diperluas. Diperlukan untuk cloud pribadi yang DIPERLUAS.

Hcx

Detail tentang appliance HCX Cloud Manager.

Representasi JSON 
{
  "internalIp": string,
  "version": string,
  "state": enum (State),
  "fqdn": string
}
Kolom
internalIp

string

Alamat IP internal appliance.
version

string

Versi appliance.
state

enum (State)

Hanya output. Status peralatan.
fqdn

string

Nama domain yang sepenuhnya memenuhi syarat dari appliance.

Negara bagian/Provinsi

Status alat

Enum
STATE_UNSPECIFIED Status perangkat tidak ditentukan. Ini adalah nilai defaultnya.
ACTIVE Peralatan berfungsi dan dapat digunakan.
CREATING Perangkat sedang di-deploy.
ACTIVATING Perangkat sedang diaktifkan.

Nsx

Detail tentang perangkat NSX Manager.

Representasi JSON 
{
  "internalIp": string,
  "version": string,
  "state": enum (State),
  "fqdn": string
}
Kolom
internalIp

string

Alamat IP internal appliance.
version

string

Versi appliance.
state

enum (State)

Hanya output. Status peralatan.
fqdn

string

Nama domain yang sepenuhnya memenuhi syarat dari appliance.

Negara bagian/Provinsi

Status alat

Enum
STATE_UNSPECIFIED Status perangkat tidak ditentukan. Ini adalah nilai defaultnya.
ACTIVE Peralatan berfungsi dan dapat digunakan.
CREATING Perangkat sedang di-deploy.

Vcenter

Detail tentang appliance pengelolaan vCenter Server.

Representasi JSON 
{
  "internalIp": string,
  "version": string,
  "state": enum (State),
  "fqdn": string
}
Kolom
internalIp

string

Alamat IP internal appliance.
version

string

Versi appliance.
state

enum (State)

Hanya output. Status peralatan.
fqdn

string

Nama domain yang sepenuhnya memenuhi syarat dari appliance.

Negara bagian/Provinsi

Status alat

Enum
STATE_UNSPECIFIED Status perangkat tidak ditentukan. Ini adalah nilai defaultnya.
ACTIVE Peralatan berfungsi dan dapat digunakan.
CREATING Perangkat sedang di-deploy.

Jenis

Jenis Enum menentukan jenis cloud pribadi.

Enum
STANDARD Private standar adalah resource zonal, dengan 3+ node. Jenis default.
TIME_LIMITED Private cloud dengan waktu terbatas adalah resource zonal, hanya dapat memiliki 1 node, dan memiliki rentang waktu terbatas. Akan dihapus setelah jangka waktu tertentu, dapat dikonversi menjadi private cloud standar dengan memperluasnya hingga 3 node atau lebih.
STRETCHED Stretched private cloud adalah resource regional dengan redundansi, dengan minimal 6 node, jumlah node harus genap.

Metode

create

 Membuat resource PrivateCloud baru di project dan lokasi tertentu.

delete

 Menjadwalkan penghapusan resource PrivateCloud.

get

 Mengambil resource PrivateCloud berdasarkan nama resource-nya.

getDnsForwarding

 Mendapatkan detail konfigurasi DnsForwarding.

getIamPolicy

 Mendapatkan kebijakan kontrol akses untuk resource.

list

 Mencantumkan resource PrivateCloud dalam project dan lokasi tertentu.

patch

 Mengubah resource PrivateCloud.

privateCloudDeletionNow

 Mempercepat penghapusan cloud pribadi yang saat ini dalam penghapusan sementara. Resource PrivateCloud dalam penghapusan sementara memiliki PrivateCloud.state yang ditetapkan ke SOFT_DELETED dan PrivateCloud.expireTime yang ditetapkan ke waktu saat penghapusan tidak dapat lagi dibatalkan.

resetNsxCredentials

 Mereset kredensial appliance NSX.

resetVcenterCredentials

 Mereset kredensial appliance Vcenter.

setIamPolicy

 Menetapkan kebijakan kontrol akses pada resource yang ditentukan.

showNsxCredentials

 Mendapatkan detail kredensial untuk appliance NSX.

showVcenterCredentials

 Mendapatkan detail kredensial untuk appliance Vcenter.

testIamPermissions

 Menampilkan izin yang dimiliki pemanggil pada resource tertentu.

undelete

 Memulihkan cloud pribadi yang sebelumnya dijadwalkan untuk dihapus oleh DeletePrivateCloud.

updateDnsForwarding

 Memperbarui parameter konfigurasi DnsForwarding, seperti domain terkait.