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
}
Campos
name

string

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

string (Timestamp format)

Apenas saída. Data e hora em que essa 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 essa 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 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 e assim por diante.
ciqUri

string

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

object (ZoneNetworkConfig)

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

string

Apenas saída. Identificador globalmente exclusivo 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 da fábrica. Se for "true", 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 intenção de cluster válida antes de aceitar o pedido. Se for "true", o pedido não poderá ser aceito até que a intenção do cluster esteja presente. Isso é usado para aplicar a validação inicial e evitar atrasos causados pela falta de configuração.
clusterIntentVerified

boolean

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

boolean

Apenas saída. Indica se esta zona é para o cluster de software do Gemini no GDC.
intelPccsKey

string

Opcional. Chave do serviço de configuração e atestado da plataforma Intel (PCCS, na sigla em inglês) para provisionar e atestar o hardware do acelerador de IA. Usado por zonas que atendem o Gemini no cluster de 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 Precisamos de mais informações do cliente para continuar.
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 da 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.
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.

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
}
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 disjunto 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 disjunto 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 disjunto 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 especificado, a sub-rede do Kubernetes será a mesma que a 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 atende ao Gemini no cluster de software do GDC. A última sub-rede /29 do intervalo fornecido é reservada para DHCP.
bgpConfig

object (BGPConfig)

Opcional. Configuração específica do Border Gateway Protocol (BGP) para esta zona. Usado por zonas que atendem o Gemini no cluster de software do GDC.
topLevelDomain

string

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

string

Opcional. Informações adicionais sobre o tipo de troca dos ToR do cliente. Usado por zonas que atendem o Gemini no cluster de 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).

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

string

Obrigatório. Número de sistema autônomo (ASN) do BGP.
l3PeerIps[]

string

Obrigatório. IPs de peering do BGP. São necessários pelo menos dois IPs de peer da camada 3.

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

 Indica o estado de uma zona.