REST Resource: projects.locations.rolloutKinds

Ressource : RolloutKind

Objet qui décrit différents paramètres de l'exécution du déploiement. Inclut des règles intégrées et personnalisables.

Représentation JSON 
{
  "name": string,
  "unitKind": string,
  "rolloutOrchestrationStrategy": string,
  "maintenancePolicyEnforcement": enum (MaintenancePolicyEnforcement),
  "unitFilter": string,
  "updateUnitKindStrategy": enum (UpdateUnitKindStrategy),
  "labels": {
    string: string,
    ...
  },
  "annotations": {
    string: string,
    ...
  },
  "uid": string,
  "etag": string,
  "createTime": string,
  "updateTime": string,
  "errorBudget": {
    object (ErrorBudget)
  }
}
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}/rolloutKinds/{rolloutKindId}"
unitKind

string

Obligatoire. Immuable. UnitKind auquel ce type de déploiement correspond. Les déploiements de ce type cibleront les unités de ce genre. En d'autres termes, cela définit la population d'unités cibles à mettre à niveau par les déploiements.
rolloutOrchestrationStrategy

string

Facultatif. Stratégie utilisée pour exécuter un déploiement. Ce champ est obligatoire.

Deux stratégies de valeurs sont acceptées et utilisées pour le contrôle : "Google.Cloud.Simple.AllAtOnce" et "Google.Cloud.Simple.OneLocationAtATime".

Un déploiement avec l'une de ces stratégies simples sera déployé dans tous les emplacements définis dans les emplacements SaaS du genre d'unité associé.
maintenancePolicyEnforcement

enum (MaintenancePolicyEnforcement)

Facultatif. Valeur parmi "strict" (application de la stratégie de maintenance et examen uniquement des unités avec une stratégie de maintenance), "ignore" (ignorance de la stratégie de maintenance) et "skip" (ignorance des unités avec une stratégie de maintenance)
unitFilter

string

Facultatif. Chaîne de filtre au format CEL(https://github.com/google/cel-spec) par rapport à Unit. Le filtre sera appliqué pour déterminer la population d'unités éligibles. Ce filtre ne peut que réduire le champ d'application du déploiement, et non l'étendre.
updateUnitKindStrategy

enum (UpdateUnitKindStrategy)

Facultatif. Configuration pour la mise à jour du genre d'unité. Par défaut, le genre d'unité sera mis à jour au début du déploiement.
labels

map (key: string, value: string)

Facultatif. Libellés de la ressource, qui peuvent être utilisés pour la catégorisation. Ils sont semblables aux libellés 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".
errorBudget

object (ErrorBudget)

Facultatif. Configuration du budget d'erreur. Si le nombre d'unités ayant échoué dépasse max(allowedCount, allowed_ratio * totalUnits), le déploiement est mis en pause. Si cette valeur n'est pas définie, toutes les unités seront mises à jour, quel que soit le nombre d'échecs rencontrés.

MaintenancePolicyEnforcement

Définit l'application de la stratégie de maintenance.

Enums
MAINTENANCE_POLICY_ENFORCEMENT_UNSPECIFIED
MAINTENANCE_POLICY_ENFORCEMENT_STRICT
MAINTENANCE_POLICY_ENFORCEMENT_IGNORED
MAINTENANCE_POLICY_ENFORCEMENT_SKIPPED

UpdateUnitKindStrategy

Enums
UPDATE_UNIT_KIND_STRATEGY_UNSPECIFIED Stratégie non spécifiée.
UPDATE_UNIT_KIND_STRATEGY_ON_START Mettez à jour la stratégie de genre d'unité au début du déploiement.
UPDATE_UNIT_KIND_STRATEGY_NEVER Ne mettez jamais à jour le type d'unité.

ErrorBudget

Configuration du budget d'erreur. Si le nombre d'unités ayant échoué dépasse max(allowedCount, allowed_ratio * totalUnits), le déploiement est mis en pause.

Représentation JSON 
{
  "allowedCount": integer,
  "allowedPercentage": integer
}
Champs
allowedCount

integer

Facultatif. Nombre maximal d'unités défaillantes autorisées dans un emplacement sans mettre en pause le déploiement.
allowedPercentage

integer

Facultatif. Pourcentage maximal d'unités autorisées à échouer (0, 100] dans un lieu sans mettre en pause le déploiement.

Méthodes

create

 Créez un genre de déploiement.

delete

 Supprimez un seul genre de déploiement.

get

 Récupérez un seul genre de déploiement.

list

 Récupère une collection de types de déploiement.

patch

 Mettez à jour un seul type de déploiement.