REST Resource: projects.locations.zones

Recurso: Zone

Es una zona que contiene un conjunto de hardware.

Representación 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

Es el identificador. Es el nombre de esta zona. Formato: projects/{project}/locations/{location}/zones/{zone}
createTime

string (Timestamp format)

Solo salida. Fecha y hora en que se creó esta zona.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Solo salida. Fecha y hora en que se actualizó esta zona por última vez.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
labels

map (key: string, value: string)

Es opcional. Son las etiquetas asociadas a esta zona como pares clave-valor. Para obtener más información sobre las etiquetas, consulta Crea y administra etiquetas.

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
displayName

string

Es opcional. Nombre visible descriptivo de esta zona.
state

enum (State)

Solo salida. Es el estado actual de esta zona.
contacts[]

object (Contact)

Obligatorio. Puntos de contacto de la zona (nombre, correo electrónico y teléfono). Dependiente del orden: El primer contacto de la lista es el principal, el segundo es el secundario, etcétera.
ciqUri

string

Solo salida. Es el vínculo a la hoja del cuestionario de admisión del cliente (CIQ) para esta zona.
networkConfig

object (ZoneNetworkConfig)

Es opcional. Es la configuración de redes para esta zona.
globallyUniqueId

string

Solo salida. Es el identificador único a nivel global que se genera para esta zona perimetral.
subscriptionConfigs[]

object (SubscriptionConfig)

Solo salida. Son los parámetros de configuración de suscripción para esta zona.
provisioningState

enum (ProvisioningState)

Solo salida. Es el estado de aprovisionamiento para configuraciones como las direcciones MAC.
skipClusterProvisioning

boolean

Es opcional. Indica si se debe omitir el paso de aprovisionamiento del clúster durante el encendido de fábrica. Si es verdadero, indica que el clúster de Kubernetes se creará después de que se instale el hardware de la zona en las instalaciones del cliente.
clusterIntentRequired

boolean

Solo salida. Indica si el cliente debe proporcionar una intención de clúster válida antes de aceptar el pedido. Si es verdadero, no se puede aceptar el pedido hasta que esté presente el intent del clúster. Se usa para aplicar la validación temprana y evitar retrasos causados por la falta de configuración.
clusterIntentVerified

boolean

Solo salida. Indica si se verificó correctamente la intención de clúster proporcionada. Esta marca garantiza que exista el intent del clúster antes de que se pueda aceptar el pedido.
aiCapable

boolean

Solo salida. Indica si esta zona es para el clúster de software de Gemini en GDC.
intelPccsKey

string

Es opcional. Clave del servicio de configuración y certificación de la plataforma Intel (PCCS) para aprovisionar y certificar el hardware del acelerador de IA. Lo usan las zonas que ejecutan Gemini en el clúster de software de GDC.

Estado

Son los estados válidos para una zona.

Enums
STATE_UNSPECIFIED El estado de la zona no está especificado.
ADDITIONAL_INFO_NEEDED Se requiere más información del cliente para avanzar.
INFO_COMPLETE La zona tiene toda la información necesaria para comenzar la preparación.
PREPARING Google está preparando la zona.
READY_FOR_CUSTOMER_FACTORY_TURNUP_CHECKS La activación de fábrica se realizó correctamente.
CUSTOMER_FACTORY_TURNUP_CHECKS_STARTED La zona está ejecutando verificaciones de encendido de fábrica.
READY_FOR_PROVISIONING La zona está lista para el aprovisionamiento.
READY_FOR_SITE_TURNUP La zona está lista para la activación del sitio.
PROVISIONING_STARTED Se inició el aprovisionamiento de la zona.
PROVISIONING_FAILED No se pudo aprovisionar la zona.
CUSTOMER_FACTORY_TURNUP_CHECKS_FAILED La zona no pasó las verificaciones de activación de fábrica.
ACTIVE La zona está disponible para su uso.
CANCELLED Se canceló la zona.

ZoneNetworkConfig

Es la configuración de red de una zona.

Representación 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

Obligatorio. Es un bloque de direcciones IPv4 para la administración de máquinas. Debe ser un bloque CIDR privado RFC1918 o público lo suficientemente grande como para asignar al menos una dirección por máquina en la zona. Debe estar en managementIpv4Subnet y ser disjunto con otros rangos de direcciones.
kubernetesNodeIpv4Range

string

Obligatorio. Es un bloque de direcciones IPv4 para nodos de Kubernetes. Debe ser un bloque CIDR privado RFC1918 o público lo suficientemente grande como para asignar al menos una dirección por máquina en la zona. Debe estar en kubernetesIpv4Subnet y ser disjunto con otros rangos de direcciones.
kubernetesControlPlaneIpv4Range

string

Obligatorio. Es un bloque de direcciones IPv4 para el plano de control de Kubernetes. Debe ser un bloque CIDR privado RFC1918 o público lo suficientemente grande como para asignar al menos una dirección por clúster en la zona. Debe estar en kubernetesIpv4Subnet y ser disjunto con otros rangos de direcciones.
managementIpv4Subnet

object (Subnet)

Obligatorio. Es una subred IPv4 para la red de administración.
kubernetesIpv4Subnet

object (Subnet)

Es opcional. Es una subred IPv4 para la red de Kubernetes. Si no se especifica, la subred de Kubernetes será la misma que la subred de administración.
dnsIpv4Addresses[]

string

Es opcional. Servidores de nombres DNS La infraestructura de GDC resolverá las consultas de DNS a través de estas IP. Si no se especifica, se usa el DNS de Google.
kubernetesPrimaryVlanId

integer

Es opcional. ID de VLAN de Kubernetes. De forma predeterminada, el nodo de Kubernetes, incluida la red principal de Kubernetes, se encuentra en la misma VLAN que la red de administración de máquinas. Para la segmentación de red, se pueden separar de forma opcional.
aiCapableIpv4Subnet

object (Subnet)

Es opcional. Es la subred IPv4 para una zona que entrega Gemini en el clúster de software de GDC. La última subred /29 del rango proporcionado está reservada para DHCP.
bgpConfig

object (BGPConfig)

Es opcional. Es la configuración específica del Protocolo de puerta de enlace de frontera (BGP) para esta zona. Lo usan las zonas que ejecutan Gemini en el clúster de software de GDC.
topLevelDomain

string

Es opcional. Es el dominio de nivel superior personalizado para esta zona. Lo usan las zonas que ejecutan Gemini en el clúster de software de GDC.
torSwitchType

string

Es opcional. Es información adicional sobre el tipo de cambio de las CdC del cliente. Lo usan las zonas que ejecutan Gemini en el clúster de software de GDC.

Subred

Representa una subred.

Representación JSON 
{
  "addressRange": string,
  "defaultGatewayIpAddress": string
}
Campos
addressRange

string

Obligatorio. Es el rango de direcciones de esta subred en notación CIDR.
defaultGatewayIpAddress

string

Obligatorio. Es la puerta de enlace predeterminada para esta subred.

BGPConfig

Configuración del Protocolo de puerta de enlace de frontera (BGP)

Representación JSON 
{
  "asn": string,
  "l3PeerIps": [
    string
  ]
}
Campos
asn

string

Obligatorio. Número de sistema autónomo (ASN) de BGP.
l3PeerIps[]

string

Obligatorio. Son las IPs de los pares de BGP. Se requieren al menos dos IPs de peer de capa 3.

ProvisioningState

Son los estados de aprovisionamiento válidos para configuraciones como las direcciones MAC.

Enums
PROVISIONING_STATE_UNSPECIFIED El estado de aprovisionamiento no está especificado.
PROVISIONING_REQUIRED Se requiere aprovisionamiento. Google lo establece.
PROVISIONING_IN_PROGRESS El aprovisionamiento está en curso. Establecido por el cliente.
PROVISIONING_COMPLETE Se completó el aprovisionamiento. Establecido por el cliente.

Métodos

create

 Crea una zona nueva en un proyecto y una ubicación determinados.

delete

 Borra una zona.

get

 Obtiene detalles de una zona.

list

 Enumera las zonas en una ubicación y un proyecto determinados.

patch

 Actualiza los parámetros de una zona.

signal

 Indica el estado de una zona.