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)
}
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.
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.

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.
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_SITE_TURNUP A zona está pronta para a ativação do site.
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
}
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).

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.

SubscriptionConfig

Uma mensagem para armazenar uma configuração de assinatura.

Representação JSON 
{
  "subscriptionId": string,
  "billingId": string,
  "state": enum (SubscriptionState)
}
Campos
subscriptionId

string

Apenas saída. O identificador exclusivo da assinatura.
billingId

string

Apenas saída. O ID do Faturamento do Google Cloud em que a assinatura foi criada.
state

enum (SubscriptionState)

Apenas saída. O estado atual da assinatura.

SubscriptionState

Enumeração para representar o estado da assinatura.

Tipos enumerados
SUBSCRIPTION_STATE_UNSPECIFIED Estado não especificado.
ACTIVE O estado "Ativo" significa que a assinatura foi criada e o faturamento está em andamento.
INACTIVE "Inativa" significa que a assinatura foi criada, mas o faturamento ainda não começou.
ERROR A assinatura está em um estado incorreto.
FAILED_TO_RETRIEVE Não foi possível recuperar o estado da assinatura. Esse problema pode ser temporário. O usuário precisa tentar fazer a solicitação novamente.
COMPLETED A assinatura foi concluída porque chegou à data de término.

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.