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)
}
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ù le résultat généré se sert toujours du 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ù le résultat généré se sert toujours du 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. Points de contact.

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.

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