REST Resource: projects.locations.zones

Ressource : Zone

Zone contenant un ensemble de matériel.

Représentation 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
}
Champs
name

string

Identifiant. Nom de cette zone. Format : projects/{project}/locations/{location}/zones/{zone}
createTime

string (Timestamp format)

Uniquement en sortie. Date et heure de création de cette zone.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Uniquement en sortie. Date et heure de la dernière mise à jour de cette zone.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "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)

Facultatif. Étiquettes associées à cette zone sous forme de paires clé/valeur. Pour en savoir plus sur les étiquettes, consultez Créer et gérer des étiquettes.

Objet contenant une liste de paires "key": value. Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" }.
displayName

string

Facultatif. Nom à afficher convivial de cette zone.
state

enum (State)

Uniquement en sortie. État actuel de cette zone.
contacts[]

object (Contact)

Obligatoire. Les contacts de la zone (nom, adresse e-mail, téléphone). En fonction de l'ordre : le premier contact de la liste est le contact principal, le deuxième est le contact secondaire, etc.
ciqUri

string

Uniquement en sortie. Lien vers la feuille du questionnaire d'admission client (CIQ) pour cette zone.
networkConfig

object (ZoneNetworkConfig)

Facultatif. Configuration Mise en réseau de cette zone.
globallyUniqueId

string

Uniquement en sortie. Identifiant unique global généré pour cette zone Edge.
subscriptionConfigs[]

object (SubscriptionConfig)

Uniquement en sortie. Configurations d'abonnement pour cette zone.
provisioningState

enum (ProvisioningState)

Uniquement en sortie. État de provisionnement des configurations telles que les adresses MAC.
skipClusterProvisioning

boolean

Facultatif. Indique si l'étape de provisionnement du cluster doit être ignorée lors de la mise en service de l'usine. Si la valeur est "true", cela indique que le cluster Kubernetes sera créé une fois le matériel de la zone installé sur le site du client.
clusterIntentRequired

boolean

Uniquement en sortie. Indique si le client doit fournir une intention de cluster valide avant d'accepter la commande. Si la valeur est "true", la commande ne peut pas être acceptée tant que l'objectif du cluster n'est pas présent. Cela permet d'appliquer une validation précoce et d'éviter les retards causés par une configuration manquante.
clusterIntentVerified

boolean

Uniquement en sortie. Indique si l'intent de cluster fourni a bien été validé. Cette option permet de s'assurer que l'objectif du cluster existe avant que la commande puisse être acceptée.
aiCapable

boolean

Facultatif. Indique si cette zone est destinée au cluster Gemini on GDC Software.
intelPccsKey

string

Facultatif. Clé Intel Platform Config and Attestation Service (PCCS) pour provisionner et attester le matériel d'accélérateur d'IA. Utilisé par les zones diffusant Gemini sur un cluster GDC Software.
currentResourceOperation

object (ResourceOperation)

Uniquement en sortie. Opération de ressource actuelle pour la zone.
resourceOperations[]

object (ResourceOperation)

Facultatif. Liste de toutes les opérations de ressources effectuées sur la zone.
errors[]

object (Status)

Uniquement en sortie. Erreurs rencontrées lors de la mise en service de la zone. Les métadonnées ErrorInfo incluent un code temporel et indiquent si l'erreur peut être relancée.
site

string

Facultatif. Indique le nom du site où se trouve le matériel de cette zone. Format : projects/{project}/locations/{location}/sites/{site} Obligatoire pour les zones Gemini on GDC Software.

État

États valides pour une zone.

Enums
STATE_UNSPECIFIED L'état de la zone n'est pas spécifié.
ADDITIONAL_INFO_NEEDED Le client doit fournir des informations supplémentaires pour que nous puissions avancer.
INFO_COMPLETE La zone dispose de toutes les informations nécessaires pour commencer la préparation de la zone.
PREPARING Google prépare la zone.
READY_FOR_CUSTOMER_FACTORY_TURNUP_CHECKS La mise en service en usine a réussi.
CUSTOMER_FACTORY_TURNUP_CHECKS_STARTED La zone exécute des vérifications de mise en service en usine.
READY_FOR_PROVISIONING La zone est prête à être provisionnée.
READY_FOR_SITE_TURNUP La zone est prête pour la mise en service du site.
PROVISIONING_STARTED Le provisionnement de la zone a commencé.
PROVISIONING_FAILED Échec du provisionnement de la zone.
OFFLINE La Zone est hors connexion.
CUSTOMER_FACTORY_TURNUP_CHECKS_FAILED La zone a échoué aux vérifications de mise en service en usine.
ACTIVE La zone est disponible.
CANCELLED La zone a été annulée.
AWAITING_HARDWARE La zone est en attente d'association de matériel.

ZoneNetworkConfig

Configuration Mise en réseau d'une zone.

Représentation 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
}
Champs
machineMgmtIpv4Range

string

Obligatoire. Un bloc d'adresses IPv4 pour la gestion des machines. Il doit s'agir d'un bloc CIDR RFC1918 privé ou public suffisamment grand pour allouer au moins une adresse par machine dans la zone. Doit être au format managementIpv4Subnet et ne pas chevaucher d'autres plages d'adresses.
kubernetesNodeIpv4Range

string

Obligatoire. Bloc d'adresses IPv4 pour les nœuds Kubernetes. Il doit s'agir d'un bloc CIDR RFC1918 privé ou public suffisamment grand pour allouer au moins une adresse par machine dans la zone. Doit être au format kubernetesIpv4Subnet et ne pas chevaucher d'autres plages d'adresses.
kubernetesControlPlaneIpv4Range

string

Obligatoire. Un bloc d'adresses IPv4 pour le plan de contrôle Kubernetes. Il doit s'agir d'un bloc CIDR RFC 1918 privé ou public suffisamment grand pour allouer au moins une adresse par cluster dans la zone. Doit être au format kubernetesIpv4Subnet et ne pas chevaucher d'autres plages d'adresses.
managementIpv4Subnet

object (Subnet)

Obligatoire. Un sous-réseau IPv4 pour le réseau de gestion.
kubernetesIpv4Subnet

object (Subnet)

Facultatif. Un sous-réseau IPv4 pour le réseau Kubernetes. Si aucune valeur n'est spécifiée, le sous-réseau Kubernetes sera identique au sous-réseau de gestion.
dnsIpv4Addresses[]

string

Facultatif. Serveurs de noms DNS. L'infrastructure GDC résoudra les requêtes DNS via ces adresses IP. Si aucune valeur n'est spécifiée, Google DNS est utilisé.
kubernetesPrimaryVlanId

integer

Facultatif. ID du VLAN Kubernetes. Par défaut, le nœud Kubernetes (y compris le réseau Kubernetes principal) se trouve dans le même VLAN que le réseau de gestion des machines. Ces réseaux peuvent éventuellement être séparés à des fins de segmentation réseau.
aiCapableIpv4Subnet

object (Subnet)

Facultatif. Sous-réseau IPv4 pour une zone diffusant un cluster Gemini sur GDC Software. Le dernier sous-réseau /29 de la plage fournie est réservé au DHCP.
bgpConfig

object (BGPConfig)

Facultatif. Configuration spécifique au protocole BGP (Border Gateway Protocol) pour cette zone. Utilisé par les zones diffusant Gemini sur le cluster logiciel GDC.
topLevelDomain

string

Facultatif. Domaine de premier niveau personnalisé pour cette zone. Utilisé par les zones diffusant Gemini sur un cluster GDC Software.
torSwitchType

string

Facultatif. Informations supplémentaires sur le type de commutateur ToR du client. Utilisé par les zones diffusant Gemini sur un cluster GDC Software.
boundaryProxyPublicIpv4Range

string

Facultatif. Plage d'adresses IPv4 publiques du proxy de limite au format CIDR. Actuellement, /32 est attendu. Utilisé par les zones diffusant Gemini sur le cluster logiciel GDC.
boundaryProxyPrivateEdgeCoreIpv4Range

string

Facultatif. Plage d'adresses IPv4 de périphérie à cœur du proxy de limite, en notation CIDR. Actuellement, /32 est attendu. Utilisé par les zones diffusant Gemini sur le cluster logiciel GDC.
boundaryProxyPrivateCoreEdgeIpv4Range

string

Facultatif. Plage d'adresses IPv4 du cœur privé au proxy périphérique de limite, au format CIDR. Actuellement, /32 est attendu. Utilisé par les zones diffusant Gemini sur le cluster logiciel GDC.
bastionHostPublicIpv4Range

string

Facultatif. Plage d'adresses IPv4 publiques de l'hôte bastion au format CIDR. Actuellement, /32 est attendu. Utilisé par les zones diffusant Gemini sur le cluster logiciel GDC.
bastionHostPrivateIpv4Range

string

Facultatif. Plage d'adresses IPv4 privées de l'hôte bastion au format CIDR. Actuellement, /32 est attendu. Utilisé par les zones diffusant Gemini sur le cluster logiciel GDC.
tlsPublicRootCertificatePem

string

Facultatif. Certificat racine public TLS au format PEM. Utilisé par les zones diffusant Gemini sur un cluster GDC Software.

Sous-réseau

Représente un sous-réseau.

Représentation JSON 
{
  "addressRange": string,
  "defaultGatewayIpAddress": string
}
Champs
addressRange

string

Obligatoire. Plage d'adresses de ce sous-réseau au format CIDR.
defaultGatewayIpAddress

string

Obligatoire. Passerelle par défaut pour ce sous-réseau.

BGPConfig

Configuration du protocole BGP (Border Gateway Protocol).

Représentation JSON 
{
  "asn": string,
  "l3PeerIps": [
    string
  ]
}
Champs
asn

string

Obligatoire. Numéro de système autonome (ASN) BGP.
l3PeerIps[]

string

Obligatoire. Adresses IP des pairs BGP. Veuillez indiquer au moins deux adresses IP de pairs L3.

ProvisioningState

États de provisionnement valides pour les configurations telles que les adresses MAC.

Enums
PROVISIONING_STATE_UNSPECIFIED L'état de provisionnement n'est pas spécifié.
PROVISIONING_REQUIRED Le provisionnement est obligatoire. Définie par Google.
PROVISIONING_IN_PROGRESS Le provisionnement est en cours. Défini par le client.
PROVISIONING_COMPLETE Le provisionnement est terminé. Défini par le client.

Méthodes

create

 Crée une zone dans un projet et un emplacement donnés.

delete

 Supprime une zone.

get

 Récupère les détails d'une zone.

list

 Liste les zones d'un projet et d'un emplacement donnés.

patch

 Met à jour les paramètres d'une zone.

signal

 Signale l'état d'une zone.