REST Resource: projects.locations.flags

Ressource : option

Représente un seul signalement.

Représentation JSON
{
  "name": string,
  "key": string,
  "valueType": enum (FlagValueType),
  "flagValueType": enum (ValueType),
  "evaluationSpec": {
    object (EvaluationSpec)
  },
  "unitKind": string,
  "description": string,
  "variants": [
    {
      object (FlagVariant)
    }
  ],
  "flagSet": string,
  "state": enum (State),
  "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}/flags/{flagId}"

key

string

Obligatoire. Immuable. Clé de flag utilisée dans les API d'évaluation d'exécution (OpenFeature). Longueur maximale : 256 octets.

valueType
(deprecated)

enum (FlagValueType)

Facultatif. Immuable. Obsolète : utilisez plutôt flagValueType. Type de valeur de l'indicateur.

flagValueType

enum (ValueType)

Facultatif. Immuable. Type de valeur de l'indicateur.

evaluationSpec

object (EvaluationSpec)

Facultatif. Spécification de la façon dont la valeur du flag doit être évaluée.

Si un indicateur booléen est créé sans spécification evaluationSpec, deux variantes par défaut sont créées ("Activé" avec boolValue = true et "Désactivé" avec boolValue = false), et "Désactivé" est défini comme defaultTarget.

unitKind

string

Obligatoire. Immuable. UnitKind pouvant utiliser cette option.

description

string

Facultatif. Description du signalement. Longueur maximale : 500 octets.

variants[]

object (FlagVariant)

Facultatif. Liste des variantes.

flagSet

string

Facultatif. Ensemble d'indicateurs auquel appartient cet indicateur.

state

enum (State)

Facultatif. État actuel du signalement.

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

FlagValueType

Enums
FLAG_VALUE_TYPE_UNSPECIFIED
FLAG_VALUE_TYPE_BOOL Type de valeur de l'indicateur booléen.
FLAG_VALUE_TYPE_INT Type de valeur d'indicateur entier.
FLAG_VALUE_TYPE_STRING Type de valeur de l'option de chaîne.
FLAG_VALUE_TYPE_DOUBLE Type de flag double.

ValueType

Type de valeur de l'indicateur.

Enums
FLAG_VALUE_TYPE_UNSPECIFIED Type de valeur d'indicateur non spécifié.
FLAG_VALUE_TYPE_BOOLEAN Type de valeur de l'indicateur booléen.
FLAG_VALUE_TYPE_INTEGER Type de valeur d'indicateur entier.
FLAG_VALUE_TYPE_STRING Type de valeur de l'option de chaîne.
FLAG_VALUE_TYPE_DOUBLE Type de valeur de l'indicateur Double.

FlagVariant

Une variante est un identifiant pour une valeur (nom attribué à une valeur).

Représentation JSON
{
  "id": string,
  "trackingId": string,
  "description": string,

  // Union field value can be only one of the following:
  "booleanValue": boolean,
  "integerValue": string,
  "stringValue": string,
  "doubleValue": number
  // End of list of possible types for union field value.
}
Champs
id

string

Obligatoire. ID de la variante. Longueur maximale : 128 octets.

trackingId

string

Facultatif. trackingId est unique en fonction du nom et de la valeur de la variante dans le champ d'application du service. Il est généralement généré par le serveur et ne doit pas être modifié. trackingId permet d'identifier et de suivre les variantes de manière unique.

description

string

Facultatif. Description lisible de ce que fait ou représente cette variante.

Champ d'union value. value est une valeur d'indicateur unique pour la variante. value ne peut être qu'un des éléments suivants :
booleanValue

boolean

Facultatif. Valeur booléenne de la variante.

integerValue

string (int64 format)

Facultatif. Valeur de variante entière.

stringValue

string

Facultatif. Valeur de variante de type chaîne.

doubleValue

number

Facultatif. Valeur de variante double.

État

L'état définit l'état du signalement.

Enums
FLAG_STATE_UNSPECIFIED L'état du signalement n'est pas spécifié.
FLAG_STATE_IN_DEVELOPMENT Le signalement est en cours de développement.
FLAG_STATE_ACTIVE Le signalement est actif.
FLAG_STATE_SUNSETTING L'option est obsolète.
FLAG_STATE_CLEANUP Le signalement est en cours de traitement.

Méthodes

create

Créer un signalement.

delete

Supprimez un seul signalement.

get

Récupérez un seul indicateur.

list

Récupérez une collection d'indicateurs.

patch

Mettez à jour un seul indicateur.