REST Resource: projects.locations.zones

Recurso: zona

Uma zona que contém um conjunto de hardware.

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

string

Identificador. Nome desta zona. Formato: projects/{project}/locations/{location}/zones/{zone}
createTime

string (Timestamp format)

Apenas saída. Horário em que a zona foi criada.

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. Hora em que esta zona foi atualizada pela última vez.

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

map (key: string, value: string)

Opcional. Rótulos associados a essa zona como pares de chave-valor. Para mais informações sobre rótulos, consulte Criar e gerenciar rótulos.

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

string

Opcional. Nome de exibição legível por humanos desta zona.
state

enum (State)

Apenas saída. Estado atual desta zona.
contacts[]

object (Contact)

Obrigatório. Os pontos de contato da zona (nome, e-mail, telefone). Dependente da ordem: o primeiro contato na lista é o principal, o segundo é o secundário etc.
ciqUri

string

Apenas saída. Link para a planilha do Questionário de admissão do cliente (CIQ, na sigla em inglês) para essa zona.
networkConfig

object (ZoneNetworkConfig)

Opcional. Configuração de rede para esta zona.
globallyUniqueId

string

Apenas saída. Identificador exclusivo globalmente gerado para esta zona de borda.
subscriptionConfigs[]

object (SubscriptionConfig)

Apenas saída. Configurações de assinatura para esta zona.
provisioningState

enum (ProvisioningState)

Apenas saída. Estado de provisionamento para configurações como endereços MAC.
skipClusterProvisioning

boolean

Opcional. Se a etapa de provisionamento do cluster deve ser ignorada durante a ativação de fábrica. Se for verdadeiro, indica que o cluster do Kubernetes será criado depois que o hardware da zona for instalado no site do cliente.
clusterIntentRequired

boolean

Apenas saída. Indica se o cliente precisa fornecer uma intent de cluster válida antes de aceitar o pedido. Se for verdadeiro, o pedido não poderá ser aceito até que a intenção do cluster esteja presente. Isso é usado para aplicar a validação antecipada e evitar atrasos causados por configurações ausentes.
clusterIntentVerified

boolean

Apenas saída. Indica se a intent do cluster fornecida foi verificada. Essa flag garante que a intenção do cluster exista antes que o pedido possa ser aceito.
aiCapable

boolean

Opcional. Indica se essa zona é para o cluster do Gemini no GDC Software.
intelPccsKey

string

Opcional. Chave do Serviço de Configuração e Atestado de Plataforma (PCCS, na sigla em inglês) da Intel para provisionar e atestar o hardware do acelerador de IA. Usado por zonas que veiculam o Gemini no cluster do software do GDC.
currentResourceOperation

object (ResourceOperation)

Apenas saída. A operação de recurso atual para a zona.
resourceOperations[]

object (ResourceOperation)

Opcional. Lista de todas as operações de recursos que foram realizadas na zona.
errors[]

object (Status)

Apenas saída. Os erros encontrados durante a ativação da zona. Os metadados de ErrorInfo vão incluir o carimbo de data/hora e se o erro pode ser repetido.
site

string

Opcional. Especifica o nome do local em que o hardware desta zona reside. Formato: projects/{project}/locations/{location}/sites/{site} Obrigatório para zonas do Gemini no software do GDC.

Estado

Estados válidos para uma zona.

Tipos enumerados
STATE_UNSPECIFIED O estado da zona não foi especificado.
ADDITIONAL_INFO_NEEDED O cliente precisa fornecer mais informações para que o processo continue.
INFO_COMPLETE A Zona tem todas as informações necessárias para iniciar a preparação.
PREPARING O Google está preparando a zona.
READY_FOR_CUSTOMER_FACTORY_TURNUP_CHECKS A ativação de fábrica foi concluída.
CUSTOMER_FACTORY_TURNUP_CHECKS_STARTED A zona está executando verificações de ativação de fábrica.
READY_FOR_PROVISIONING A zona está pronta para provisionamento.
READY_FOR_SITE_TURNUP A zona está pronta para a ativação do site.
PROVISIONING_STARTED O provisionamento da zona foi iniciado.
PROVISIONING_FAILED Falha no provisionamento da zona.
OFFLINE A Zona está off-line.
CUSTOMER_FACTORY_TURNUP_CHECKS_FAILED A zona falhou nas verificações de ativação de fábrica.
ACTIVE A zona está disponível para uso.
CANCELLED A zona foi cancelada.
AWAITING_HARDWARE A zona está aguardando a associação de hardware.

ZoneNetworkConfig

Configuração de rede para uma zona.

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

string

Obrigatório. Um bloco de endereços IPv4 para gerenciamento de máquinas. Precisa ser um bloco CIDR público ou RFC1918 privado grande o suficiente para alocar pelo menos um endereço por máquina na zona. Precisa estar em managementIpv4Subnet e ser separado de outros intervalos de endereços.
kubernetesNodeIpv4Range

string

Obrigatório. Um bloco de endereços IPv4 para nós do Kubernetes. Precisa ser um bloco CIDR público ou RFC1918 privado grande o suficiente para alocar pelo menos um endereço por máquina na zona. Precisa estar em kubernetesIpv4Subnet e ser separado de outros intervalos de endereços.
kubernetesControlPlaneIpv4Range

string

Obrigatório. Um bloco de endereços IPv4 para o plano de controle do Kubernetes. Precisa ser um bloco CIDR público ou RFC1918 privado grande o suficiente para alocar pelo menos um endereço por cluster na zona. Precisa estar em kubernetesIpv4Subnet e ser separado de outros intervalos de endereços.
managementIpv4Subnet

object (Subnet)

Obrigatório. Uma sub-rede IPv4 para a rede de gerenciamento.
kubernetesIpv4Subnet

object (Subnet)

Opcional. Uma sub-rede IPv4 para a rede do Kubernetes. Se não for especificada, a sub-rede do Kubernetes será igual à de gerenciamento.
dnsIpv4Addresses[]

string

Opcional. Servidores de nomes DNS. A infraestrutura do GDC resolve as consultas de DNS usando esses IPs. Quando o valor não for especificado, o DNS do Google será usado.
kubernetesPrimaryVlanId

integer

Opcional. ID da VLAN do Kubernetes. Por padrão, o nó do Kubernetes, incluindo a rede principal do Kubernetes, está na mesma VLAN que a rede de gerenciamento de máquinas. Para fins de segmentação de rede, é possível separá-los (opcional).
aiCapableIpv4Subnet

object (Subnet)

Opcional. Sub-rede IPv4 para uma zona que disponibiliza o Gemini no cluster do software do GDC. A última sub-rede /29 do intervalo fornecido é reservada para DHCP.
bgpConfig

object (BGPConfig)

Opcional. Configuração específica do protocolo de gateway de borda (BGP) para esta zona. Usado por zonas que veiculam o Gemini no cluster do software do GDC.
topLevelDomain

string

Opcional. Domínio de nível superior personalizado para esta zona. Usado por zonas que veiculam o Gemini no cluster do software do GDC.
torSwitchType

string

Opcional. Informações adicionais sobre o tipo de switch ToR do cliente. Usado por zonas que veiculam o Gemini no cluster do software do GDC.
boundaryProxyPublicIpv4Range

string

Opcional. Intervalo IPv4 público do proxy de limite na notação CIDR. No momento, /32 é esperado. Usado por zonas que disponibilizam o Gemini no cluster do software do GDC.
boundaryProxyPrivateEdgeCoreIpv4Range

string

Opcional. Intervalo de IPv4 do proxy de limite de borda privada para o núcleo na notação CIDR. No momento, /32 é esperado. Usado por zonas que disponibilizam o Gemini no cluster do software do GDC.
boundaryProxyPrivateCoreEdgeIpv4Range

string

Opcional. Intervalo IPv4 do núcleo privado para a borda do proxy de limite na notação CIDR. No momento, /32 é esperado. Usado por zonas que disponibilizam o Gemini no cluster do software do GDC.
bastionHostPublicIpv4Range

string

Opcional. Intervalo IPv4 público do Bastion Host na notação CIDR. No momento, /32 é esperado. Usado por zonas que disponibilizam o Gemini no cluster do software do GDC.
bastionHostPrivateIpv4Range

string

Opcional. Intervalo de IPv4 privado do Bastion Host na notação CIDR. No momento, /32 é esperado. Usado por zonas que disponibilizam o Gemini no cluster do software do GDC.
tlsPublicRootCertificatePem

string

Opcional. Certificado raiz público de TLS no formato PEM. Usado por zonas que veiculam o Gemini no cluster do software do GDC.

Sub-rede

Representa uma sub-rede.

Representação JSON 
{
  "addressRange": string,
  "defaultGatewayIpAddress": string
}
Campos
addressRange

string

Obrigatório. Intervalo de endereços desta sub-rede na notação CIDR.
defaultGatewayIpAddress

string

Obrigatório. Gateway padrão para esta sub-rede.

BGPConfig

Configuração do protocolo de gateway de borda (BGP, na sigla em inglês).

Representação JSON 
{
  "asn": string,
  "l3PeerIps": [
    string
  ]
}
Campos
asn

string

Obrigatório. Número de sistema autônomo (ASN, na sigla em inglês) do BGP.
l3PeerIps[]

string

Obrigatório. IPs de peering do BGP. É necessário pelo menos dois IPs de peering L3.

ProvisioningState

Estados de provisionamento válidos para configurações como endereços MAC.

Tipos enumerados
PROVISIONING_STATE_UNSPECIFIED O estado de provisionamento não foi especificado.
PROVISIONING_REQUIRED O provisionamento é obrigatório. Definido pelo Google.
PROVISIONING_IN_PROGRESS O provisionamento está em andamento. Definido pelo cliente.
PROVISIONING_COMPLETE O provisionamento foi concluído. Definido pelo cliente.

Métodos

create

 Cria uma zona em determinado projeto e local.

delete

 Exclui uma zona.

get

 Recebe detalhes de uma zona.

list

 Lista as zonas em um determinado projeto e local.

patch

 Atualiza os parâmetros de uma zona.

signal

 Sinaliza o estado de uma zona.