REST Resource: projects.locations.zones

Ressource : Zone

Une 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
}
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. Étiquettes associées à 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 des configurations, comme 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 bien été vérifiée. Cet indicateur garantit que l'intention du cluster existe avant que la commande puisse être acceptée.
aiCapable

boolean

Uniquement en sortie. Indique si cette zone est destinée à Gemini sur le cluster logiciel 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.

É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é.
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.

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
}
Champs
machineMgmtIpv4Range

string

Obligatoire. 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 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 RFC1918 privé 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 RFC1918 privé 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.

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 Border Gateway Protocol (BGP).

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 saisir 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 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é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.