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
}
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 estará normalizada a Z y usa 0, 3, 6 o 9 dígitos fraccionarios. 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 estará normalizada a Z y usa 0, 3, 6 o 9 dígitos fraccionarios. 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. Son los puntos de contacto.
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.

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.
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_SITE_TURNUP La zona está lista para la activación del sitio.
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
}
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.

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.

SubscriptionConfig

Es un mensaje para almacenar la configuración de una suscripción.

Representación JSON 
{
  "subscriptionId": string,
  "billingId": string,
  "state": enum (SubscriptionState)
}
Campos
subscriptionId

string

Solo salida. Es el identificador único de la suscripción.
billingId

string

Solo salida. Es el ID de la Facturación de Google Cloud con el que se creó la suscripción.
state

enum (SubscriptionState)

Solo salida. Es el estado actual de la suscripción.

SubscriptionState

Es una enumeración que representa el estado de la suscripción.

Enums
SUBSCRIPTION_STATE_UNSPECIFIED El estado no se especifica.
ACTIVE El estado activo significa que la suscripción se creó correctamente y se está facturando.
INACTIVE Inactiva significa que la suscripción se creó correctamente, pero la facturación aún no comenzó.
ERROR La suscripción se encuentra en un estado erróneo.
FAILED_TO_RETRIEVE No se pudo recuperar el estado de la suscripción. Este puede ser un problema transitorio. El usuario debe volver a enviar la solicitud.
COMPLETED Se completó la suscripción porque se alcanzó la fecha de finalización.

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.