REST Resource: projects.locations.zones

Recurso: Zona

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,
  "currentResourceOperation": {
    object (ResourceOperation)
  },
  "resourceOperations": [
    {
      object (ResourceOperation)
    }
  ],
  "errors": [
    {
      object (Status)
    }
  ],
  "site": 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. Es la hora en la 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. Es la hora en la 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 con 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. Es el nombre visible y fácil de leer de esta zona.
state

enum (State)

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

object (Contact)

Obligatorio. Los puntos de contacto de la zona (nombre, correo electrónico y teléfono) Depende del orden: el primer contacto de la lista es el contacto principal; el segundo, el secundario, etc.
ciqUri

string

Solo salida. 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 red de esta zona.
globallyUniqueId

string

Solo salida. Identificador único a nivel global generado 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. Estado de aprovisionamiento para parámetros de configuración, como las direcciones MAC.
skipClusterProvisioning

boolean

Es opcional. Indica si se debe omitir el paso de aprovisionamiento del clúster durante el inicio 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 el sitio del cliente.
clusterIntentRequired

boolean

Solo salida. Indica si el cliente debe proporcionar un intent de clúster válido antes de aceptar el pedido. Si es verdadero, el pedido no se puede aceptar 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 el intent del clúster proporcionado se verificó correctamente. Esta marca garantiza que exista el intent del clúster antes de que se pueda aceptar el pedido.
aiCapable

boolean

Es opcional. Indica si esta zona es para el clúster de Gemini en GDC Software.
intelPccsKey

string

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

object (ResourceOperation)

Solo salida. La operación de recurso actual para la zona.
resourceOperations[]

object (ResourceOperation)

Es opcional. Es una lista de todas las operaciones de recursos que se realizaron en la zona.
errors[]

object (Status)

Solo salida. Son los errores que se encontraron durante la activación de la zona. Los metadatos de ErrorInfo incluirán la marca de tiempo y si el error se puede reintentar.
site

string

Es opcional. Especifica el nombre del sitio en el que reside el hardware de esta zona. Formato: projects/{project}/locations/{location}/sites/{site} Obligatorio para las zonas de Gemini en GDC Software.

Estado

Son los estados válidos para una zona.

Enums
STATE_UNSPECIFIED No se especificó el estado de la zona.
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 su 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 activación 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.
OFFLINE La zona está sin conexión.
CUSTOMER_FACTORY_TURNUP_CHECKS_FAILED La zona falló en las verificaciones de activación de fábrica.
ACTIVE La zona está disponible para su uso.
CANCELLED Se canceló la zona.
AWAITING_HARDWARE La zona está esperando la asociación de hardware.

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,
  "boundaryProxyPublicIpv4Range": string,
  "boundaryProxyPrivateEdgeCoreIpv4Range": string,
  "boundaryProxyPrivateCoreEdgeIpv4Range": string,
  "bastionHostPublicIpv4Range": string,
  "bastionHostPrivateIpv4Range": string,
  "tlsPublicRootCertificatePem": string
}
Campos
machineMgmtIpv4Range

string

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

string

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

string

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

object (Subnet)

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

object (Subnet)

Es opcional. 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. Subred IPv4 para una zona que entrega Gemini en el clúster de GDC Software. La última subred /29 del rango proporcionado se reserva para DHCP.
bgpConfig

object (BGPConfig)

Es opcional. Configuración específica del protocolo de puerta de enlace de frontera (BGP) para esta zona. Lo usan las zonas que entregan Gemini en el clúster de GDC Software.
topLevelDomain

string

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

string

Es opcional. Información adicional sobre el tipo de interruptor ToR del cliente. Lo usan las zonas que entregan Gemini en el clúster de GDC Software.
boundaryProxyPublicIpv4Range

string

Es opcional. Es el rango de IPv4 público del proxy de límite en notación CIDR. Actualmente, se espera /32. Lo usan las zonas que entregan Gemini en el clúster de GDC Software.
boundaryProxyPrivateEdgeCoreIpv4Range

string

Es opcional. Es el rango de IPv4 del proxy de límite de Edge privado al núcleo en notación CIDR. Actualmente, se espera /32. Lo usan las zonas que entregan Gemini en el clúster de GDC Software.
boundaryProxyPrivateCoreEdgeIpv4Range

string

Es opcional. Es el rango de IPv4 del núcleo privado al perímetro del proxy de límite en notación CIDR. Actualmente, se espera /32. Lo usan las zonas que entregan Gemini en el clúster de GDC Software.
bastionHostPublicIpv4Range

string

Es opcional. Es el rango de IPv4 público del host de bastión en notación CIDR. Actualmente, se espera /32. Lo usan las zonas que entregan Gemini en el clúster de GDC Software.
bastionHostPrivateIpv4Range

string

Es opcional. Es el rango de IPv4 privado del host de bastión en notación CIDR. Actualmente, se espera /32. Lo usan las zonas que entregan Gemini en el clúster de GDC Software.
tlsPublicRootCertificatePem

string

Es opcional. Es el certificado raíz público de TLS en formato PEM. Lo usan las zonas que entregan Gemini en el clúster de GDC Software.

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. IPs de par de BGP. Se requieren al menos dos IPs de par de L3.

ProvisioningState

Estados de aprovisionamiento válidos para parámetros de configuración, como las direcciones MAC.

Enums
PROVISIONING_STATE_UNSPECIFIED No se especificó el estado de aprovisionamiento.
PROVISIONING_REQUIRED Se requiere aprovisionamiento. Establecido por Google.
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 de un proyecto y una ubicación determinados.

patch

 Actualiza los parámetros de una zona.

signal

 Indica el estado de una zona.