REST Resource: projects.locations.releases

Ressource : Release

Nouvelle version à propager et à déployer sur les unités. Cela inclut des pointeurs vers des plans préconfigurés pour l'actionnement (par exemple, des packages de configuration Helm ou Terraform) via le registre d'artefacts.

Représentation JSON 
{
  "name": string,
  "unitKind": string,
  "blueprint": {
    object (Blueprint)
  },
  "releaseRequirements": {
    object (ReleaseRequirements)
  },
  "inputVariables": [
    {
      object (UnitVariable)
    }
  ],
  "outputVariables": [
    {
      object (UnitVariable)
    }
  ],
  "inputVariableDefaults": [
    {
      object (UnitVariable)
    }
  ],
  "applicationTemplateComponent": {
    object (ComponentRef)
  },
  "labels": {
    string: string,
    ...
  },
  "annotations": {
    string: string,
    ...
  },
  "uid": string,
  "etag": string,
  "createTime": string,
  "updateTime": string
}
Champs
name

string

Identifiant. Nom de la ressource (URI complet de la ressource) suivant le schéma de dénomination standard :

"projects/{project}/locations/{location}/releases/{release}"
unitKind

string

Obligatoire. Immuable. Référence à UnitKind à laquelle correspond cette version (obligatoire et immuable une fois créée).
blueprint

object (Blueprint)

Facultatif. Les plans sont des images OCI contenant tous les artefacts nécessaires pour provisionner une unité.
releaseRequirements

object (ReleaseRequirements)

Facultatif. Ensemble des exigences à respecter sur l'appareil lors de l'utilisation de cette version.
inputVariables[]

object (UnitVariable)

Facultatif. Uniquement en sortie. Liste des variables d'entrée déclarées dans le plan et pouvant être présentes avec leurs valeurs dans la spécification de l'unité
outputVariables[]

object (UnitVariable)

Facultatif. Uniquement en sortie. Liste des variables de sortie déclarées dans le plan et qui peuvent être présentes avec leurs valeurs dans l'état de l'unité
inputVariableDefaults[]

object (UnitVariable)

Facultatif. Mappage des variables d'entrée aux valeurs par défaut. 100 au maximum
applicationTemplateComponent

object (ComponentRef)

Uniquement en sortie. Référence au composant et à la révision dans un ApplicationTemplate composite.
labels

map (key: string, value: string)

Facultatif. Étiquettes de la ressource, qui peuvent être utilisées pour la catégorisation. Elles sont semblables aux étiquettes de ressources Kubernetes.

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

map (key: string, value: string)

Facultatif. Les annotations sont un mappage clé-valeur non structuré stocké avec une ressource. Elles peuvent être définies par des outils externes pour stocker et récupérer des métadonnées arbitraires. Elles ne peuvent pas faire l'objet de requêtes et doivent être conservées lors de la modification d'objets.

Pour en savoir plus, consultez https://kubernetes.io/docs/user-guide/annotations.

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

string

Uniquement en sortie. Identifiant unique de la ressource. L'UID est unique dans le temps et l'espace pour cette ressource dans le cadre du service. Il est habituellement généré par le serveur lors de la création réussie d'une ressource et ne doit pas être modifié. L'UID permet d'identifier de manière unique les ressources avec réutilisation du nom. Il doit être un UUID4.
etag

string

Uniquement en sortie. Valeur opaque qui identifie de manière unique la version ou la génération d'une ressource. Cet identifiant permet de confirmer que le client et le serveur sont d'accord sur l'ordre d'écriture d'une ressource.
createTime

string (Timestamp format)

Uniquement en sortie. Code temporel de la création de la ressource.

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. Code temporel de la dernière mise à jour de la ressource. Toute modification de la ressource par les utilisateurs doit actualiser cette valeur. Les modifications d'une ressource par le service doivent actualiser cette valeur.

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

Plan

Les plans sont des images OCI contenant tous les artefacts nécessaires pour provisionner une unité. Les métadonnées telles que le type de moteur utilisé pour actionner le blueprint (par exemple, Terraform, Helm, etc.) et la version proviendront du fichier manifeste de l'image. Si le nom d'hôte est omis, il est considéré comme le chemin régional vers Artifact Registry (par exemple, us-east1-docker.pkg.dev).

Représentation JSON 
{
  "package": string,
  "engine": string,
  "version": string
}
Champs
package

string

Facultatif. Immuable. URI d'un plan utilisé par l'unité (obligatoire, sauf si unitKind ou release sont définis).
engine

string

Uniquement en sortie. Type de moteur utilisé pour actionner le blueprint (par exemple, Terraform, Helm, etc.).
version

string

Uniquement en sortie. Métadonnées de version, si elles sont présentes dans le plan.

ReleaseRequirements

Ensemble d'exigences à respecter sur l'appareil lors de l'utilisation de cette version.

Représentation JSON 
{
  "upgradeableFromReleases": [
    string
  ]
}
Champs
upgradeableFromReleases[]

string

Facultatif. Liste des versions à partir desquelles une unité peut être mise à niveau vers celle-ci (facultatif). Si ce champ est vide, aucune contrainte ne sera appliquée. Lorsque des demandes de mise à niveau d'unités vers cette version sont fournies, cette contrainte est vérifiée et appliquée.

Méthodes

create

 Créez une version.

delete

 Supprimez une seule version.

get

 Récupérer une seule version.

list

 Récupérez une collection de versions.

patch

 Mettez à jour une seule version.