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
}
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.

É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.
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_SITE_TURNUP La zone est prête pour la mise en service du site.
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
}
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.

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.

SubscriptionConfig

Message permettant de stocker une configuration d'abonnement.

Représentation JSON 
{
  "subscriptionId": string,
  "billingId": string,
  "state": enum (SubscriptionState)
}
Champs
subscriptionId

string

Uniquement en sortie. Identifiant unique de l'abonnement.
billingId

string

Uniquement en sortie. ID de facturation Google Cloud sous lequel l'abonnement est créé.
state

enum (SubscriptionState)

Uniquement en sortie. État actuel de l'abonnement.

SubscriptionState

Énumération représentant l'état de l'abonnement.

Enums
SUBSCRIPTION_STATE_UNSPECIFIED État non spécifié.
ACTIVE L'état "Actif" signifie que l'abonnement a bien été créé et que la facturation est en cours.
INACTIVE "Inactif" signifie que l'abonnement a été créé, mais que la facturation n'a pas encore commencé.
ERROR L'abonnement est dans un état d'erreur.
FAILED_TO_RETRIEVE Impossible de récupérer l'état de l'abonnement. Il s'agit peut-être d'un problème temporaire. L'utilisateur doit réessayer d'envoyer la requête.
COMPLETED L'abonnement est terminé, car il a atteint sa date de fin.

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.