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. Heure à laquelle cette zone a été créée.

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. 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. Libellés associés à cette zone sous forme de paires clé/valeur. Pour en savoir plus sur les libellés, consultez Créer et gérer des libellés.

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

string

Facultatif. Nom convivial de cette zone.
state

enum (State)

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

object (Contact)

Obligatoire. Contacts de la zone (nom, adresse e-mail, téléphone). L'ordre est important : 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'accueil des clients (CIQ) pour cette zone.
networkConfig

object (ZoneNetworkConfig)

Facultatif. Configuration Mise en réseau pour 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 pour les configurations telles que les adresses MAC.
skipClusterProvisioning

boolean

Facultatif. Indique s'il faut ignorer l'étape de provisionnement du cluster lors de la configuration d'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'intention du cluster n'est pas présente. Cela permet d'appliquer la validation anticipée et d'éviter les retards causés par une configuration manquante.
clusterIntentVerified

boolean

Uniquement en sortie. Indique si l'intention de cluster fournie a été validée. Cet indicateur garantit 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 logiciel Gemini on GDC.
intelPccsKey

string

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

object (ResourceOperation)

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

object (ResourceOperation)

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

object (Status)

Uniquement en sortie. Erreurs rencontrées lors de l'activation 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 Gemini sur les zones logicielles GDC.

État

États valides pour une zone.

Enums
STATE_UNSPECIFIED L'état de la zone n'est pas spécifié.
ADDITIONAL_INFO_NEEDED Nous avons besoin d'informations supplémentaires de la part du client pour progresser.
INFO_COMPLETE La zone contient toutes les informations nécessaires pour commencer à la préparer.
PREPARING Google prépare la zone.
READY_FOR_CUSTOMER_FACTORY_TURNUP_CHECKS La configuration 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 Le provisionnement de la zone a échoué.
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 matérielle.

ZoneNetworkConfig

Configuration Mise en réseau pour 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. Bloc d'adresses IPv4 pour la gestion des machines. Il doit s'agir d'un bloc CIDR privé RFC1918 ou public suffisamment grand pour allouer au moins une adresse par machine dans la zone. Doit être dans managementIpv4Subnet et disjoint des autres plages d'adresses.
kubernetesNodeIpv4Range

string

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

string

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

object (Subnet)

Obligatoire. 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 du réseau.
aiCapableIpv4Subnet

object (Subnet)

Facultatif. Sous-réseau IPv4 pour une zone diffusant Gemini sur un cluster logiciel GDC. Le dernier sous-réseau /29 de la plage fournie est réservé au protocole 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 le cluster logiciel GDC.
torSwitchType

string

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

string

Facultatif. Plage d'adresses IPv4 publiques du proxy Boundary 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 privées de la périphérie au cœur du proxy de limite, au format CIDR. Actuellement, /32 est attendu. Utilisé par les zones diffusant Gemini sur le cluster logiciel GDC.
boundaryProxyPrivateCoreEdgeIpv4Range

string

Facultatif. Plage d'adresses IPv4 privées du proxy de limite, du cœur à la périphérie, en notation 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 le cluster logiciel GDC.

Sous-réseau

Représente un sous-réseau.

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

string

Obligatoire. Plage d'adresses pour 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. Vous devez indiquer au moins deux adresses IP de pairs de couche 3.

ProvisioningState

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

Enums
PROVISIONING_STATE_UNSPECIFIED L'état du 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éfinie par le client.
PROVISIONING_COMPLETE Le provisionnement est terminé. Définie 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

 Indique l'état d'une zone.