REST Resource: projects.locations.privateClouds

Recurso: PrivateCloud

Representa um recurso de nuvem privada. As nuvens privadas do tipo STANDARD e TIME_LIMITED são recursos zonais, e as nuvens privadas STRETCHED são regionais.

Representação 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)
}
Campos
name

string

Apenas saída. Identificador. O nome do recurso desta nuvem privada. Os nomes de recursos são URIs sem esquema que seguem as convenções em https://cloud.google.com/apis/design/resource_names. Por exemplo: projects/my-project/locations/us-central1-a/privateClouds/my-cloud
createTime

string (Timestamp format)

Apenas saída. Hora de criação deste recurso.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de Z, outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Apenas saída. A última atualização deste recurso.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de Z, outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
deleteTime

string (Timestamp format)

Apenas saída. Data e hora em que o recurso foi programado para exclusão.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de Z, outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
expireTime

string (Timestamp format)

Apenas saída. O horário em que o recurso será excluído de forma irreversível.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de Z, outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
state

enum (State)

Apenas saída. Estado do recurso. Novos valores podem ser adicionados a essa enumeração quando apropriado.
networkConfig

object (NetworkConfig)

Obrigatório. Configuração de rede da nuvem privada.
managementCluster

object (ManagementCluster)

Obrigatório. Somente entrada. O cluster de gerenciamento para essa nuvem privada. Esse campo é obrigatório durante a criação da nuvem privada para fornecer detalhes do cluster padrão.

Os seguintes campos não podem ser alterados após a criação da nuvem privada: ManagementCluster.clusterId, ManagementCluster.nodeTypeId.
description

string

Descrição fornecida pelo usuário para essa nuvem privada.
hcx

object (Hcx)

Apenas saída. Dispositivo HCX.
nsx

object (Nsx)

Apenas saída. Dispositivo NSX.
vcenter

object (Vcenter)

Apenas saída. Dispositivo do vCenter.
uid

string

Apenas saída. Identificador exclusivo gerado pelo sistema para o recurso.
type

enum (Type)

Opcional. Tipo da nuvem privada. O padrão é STANDARD.

Estado

O enum "State" define os possíveis estados das nuvens privadas.

Tipos enumerados
STATE_UNSPECIFIED O valor padrão. Esse valor nunca pode ser usado.
ACTIVE A nuvem privada está pronta.
CREATING A nuvem privada está sendo criada.
UPDATING A nuvem privada está sendo atualizada.
FAILED A nuvem privada está em estado de falha.
DELETED A nuvem privada está programada para exclusão. O processo de exclusão pode ser cancelado usando o método de recuperação correspondente.
PURGING A nuvem privada é excluída de forma irreversível e está sendo removida do sistema.

NetworkConfig

Configuração de rede no projeto do consumidor com que o peering precisa ser feito.

Representação JSON 
{
  "managementCidr": string,
  "vmwareEngineNetwork": string,
  "vmwareEngineNetworkCanonical": string,
  "managementIpAddressLayoutVersion": integer,
  "dnsServerIp": string
}
Campos
managementCidr

string

Obrigatório. CIDR de gerenciamento usado por dispositivos de gerenciamento da VMware.
vmwareEngineNetwork

string

Opcional. O nome do recurso relativo da rede do VMware Engine anexada à nuvem privada. Especifique o nome no seguinte formato: projects/{project}/locations/{location}/vmwareEngineNetworks/{vmwareEngineNetworkId}, em que {project} pode ser um número ou um ID do projeto.
vmwareEngineNetworkCanonical

string

Apenas saída. O nome canônico da rede do VMware Engine no formato: projects/{projectNumber}/locations/{location}/vmwareEngineNetworks/{vmwareEngineNetworkId}
managementIpAddressLayoutVersion

integer

Apenas saída. A versão do layout de endereço IP do intervalo de endereços IP de gerenciamento. As versões possíveis incluem: * managementIpAddressLayoutVersion=1: indica o layout de endereço IP legado usado por algumas nuvens privadas atuais. Isso não é mais compatível com novas nuvens particulares porque não oferece suporte a todos os recursos. * managementIpAddressLayoutVersion=2: indica o layout de endereço IP mais recente usado por todas as nuvens privadas recém-criadas. Esta versão é compatível com todos os recursos atuais.
dnsServerIp

string

Apenas saída. IP do servidor DNS da nuvem privada. Todas as consultas de DNS podem ser encaminhadas para esse endereço para resolução de nomes de entidades de gerenciamento da nuvem privada, como vCenter, NSX-T Manager e hosts ESXi.

ManagementCluster

Configuração do cluster de gerenciamento.

Representação JSON 
{
  "clusterId": string,
  "nodeTypeConfigs": {
    string: {
      object (NodeTypeConfig)
    },
    ...
  },
  "stretchedClusterConfig": {
    object (StretchedClusterConfig)
  }
}
Campos
clusterId

string

Obrigatório. O identificador fornecido pelo usuário do novo Cluster. O identificador precisa atender aos seguintes requisitos:

  • Contém apenas de 1 a 63 caracteres alfanuméricos e hifens
  • Começa com um caractere alfabético
  • Termina com um caractere que não é um hífen
  • Não formatado como um UUID
  • Em conformidade com a RFC 1034 (seção 3.5)
nodeTypeConfigs

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

Obrigatório. O mapa dos tipos de nós do cluster, em que a chave é o identificador canônico do tipo de nó (corresponde ao NodeType).

Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
stretchedClusterConfig

object (StretchedClusterConfig)

Opcional. Configuração de um cluster estendido. Obrigatório para nuvens privadas ESTENDIDAS.

Hcx

Detalhes sobre um dispositivo do HCX Cloud Manager.

Representação JSON 
{
  "internalIp": string,
  "version": string,
  "state": enum (State),
  "fqdn": string
}
Campos
internalIp

string

Endereço IP interno do dispositivo.
version

string

Versão do dispositivo.
state

enum (State)

Apenas saída. O estado do dispositivo.
fqdn

string

Nome de domínio totalmente qualificado do dispositivo.

Estado

Estado do dispositivo

Tipos enumerados
STATE_UNSPECIFIED Estado do eletrodoméstico não especificado. Esse é o valor padrão.
ACTIVE O eletrodoméstico está funcionando e pode ser usado.
CREATING O dispositivo está sendo implantado.
ACTIVATING O dispositivo está sendo ativado.

Nsx

Detalhes sobre um dispositivo do NSX Manager.

Representação JSON 
{
  "internalIp": string,
  "version": string,
  "state": enum (State),
  "fqdn": string
}
Campos
internalIp

string

Endereço IP interno do dispositivo.
version

string

Versão do dispositivo.
state

enum (State)

Apenas saída. O estado do dispositivo.
fqdn

string

Nome de domínio totalmente qualificado do dispositivo.

Estado

Estado do dispositivo

Tipos enumerados
STATE_UNSPECIFIED Estado do eletrodoméstico não especificado. Esse é o valor padrão.
ACTIVE O eletrodoméstico está funcionando e pode ser usado.
CREATING O dispositivo está sendo implantado.

vCenter

Detalhes sobre um dispositivo de gerenciamento do vCenter Server.

Representação JSON 
{
  "internalIp": string,
  "version": string,
  "state": enum (State),
  "fqdn": string
}
Campos
internalIp

string

Endereço IP interno do dispositivo.
version

string

Versão do dispositivo.
state

enum (State)

Apenas saída. O estado do dispositivo.
fqdn

string

Nome de domínio totalmente qualificado do dispositivo.

Estado

Estado do dispositivo

Tipos enumerados
STATE_UNSPECIFIED Estado do eletrodoméstico não especificado. Esse é o valor padrão.
ACTIVE O eletrodoméstico está funcionando e pode ser usado.
CREATING O dispositivo está sendo implantado.

Tipo

O tipo de enumeração define o tipo de nuvem privada.

Tipos enumerados
STANDARD O Standard Private é um recurso zonal com mais de três nós. Tipo padrão.
TIME_LIMITED A nuvem privada com limite de tempo é um recurso zonal, pode ter apenas um nó e tem vida útil limitada. Será excluída após o período definido e poderá ser convertida em uma nuvem privada padrão ao ser expandida para três ou mais nós.
STRETCHED A nuvem privada estendida é um recurso regional com redundância, com um mínimo de seis nós, e a contagem de nós precisa ser par.

Métodos

create

 Cria um recurso PrivateCloud em determinado projeto e local.

delete

 Programa a exclusão de um recurso PrivateCloud.

get

 Recupera um recurso PrivateCloud pelo nome dele.

getDnsForwarding

 Recebe detalhes da configuração DnsForwarding.

getIamPolicy

 Busca a política de controle de acesso de um recurso.

list

 Lista recursos PrivateCloud em determinado projeto e local.

patch

 Modifica um recurso PrivateCloud.

privateCloudDeletionNow

 Acelera a exclusão de uma nuvem privada que está em exclusão reversível. Um recurso PrivateCloud em exclusão reversível tem PrivateCloud.state definido como SOFT_DELETED e PrivateCloud.expireTime definido como o momento em que a exclusão não pode mais ser revertida.

resetNsxCredentials

 Redefine as credenciais do dispositivo NSX.

resetVcenterCredentials

 Redefine as credenciais do appliance Vcenter.

setIamPolicy

 Define a política de controle de acesso no recurso especificado.

showNsxCredentials

 Recebe detalhes das credenciais do dispositivo NSX.

showVcenterCredentials

 Recebe detalhes das credenciais do dispositivo Vcenter.

testIamPermissions

 Retorna permissões do autor da chamada no recurso especificado.

undelete

 Restaura uma nuvem privada que foi programada para exclusão por DeletePrivateCloud.

updateDnsForwarding

 Atualiza os parâmetros da configuração DnsForwarding, como domínios associados.