REST Resource: projects.locations.unitKinds

Ressource : UnitKind

Définition d'une unité. Les unités appartenant au même UnitKind sont gérées ensemble. Par exemple, elles suivent le même modèle de publication (plans, versions, etc.) et sont généralement déployées ensemble.

Représentation JSON
{
  "name": string,
  "defaultRelease": string,
  "dependencies": [
    {
      object (Dependency)
    }
  ],
  "inputVariableMappings": [
    {
      object (VariableMapping)
    }
  ],
  "outputVariableMappings": [
    {
      object (VariableMapping)
    }
  ],
  "saas": string,
  "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}/unitKinds/{unitKind}"

defaultRelease

string

Facultatif. Référence à l'objet Release à utiliser par défaut pour créer des unités de ce UnitKind (facultatif).

Si aucune version n'est spécifiée, une nouvelle unité doit indiquer explicitement la version à utiliser pour sa création.

dependencies[]

object (Dependency)

Facultatif. Immuable. Liste des autres genres d'unité dont dépendra cette version. Les dépendances seront provisionnées automatiquement si elles ne sont pas trouvées. 10 maximum.

inputVariableMappings[]

object (VariableMapping)

Facultatif. Liste des inputVariables pour cette version qui seront récupérées à partir des outputVariables d'une dépendance ou transmises aux inputVariables d'une dépendance. 100 au maximum.

outputVariableMappings[]

object (VariableMapping)

Facultatif. La liste des outputVariables pour ce genre d'unité sera transmise aux outputVariables de cette unité. 100 au maximum.

saas

string

Obligatoire. Immuable. Référence au SaaS qui définit le produit (service géré) que le producteur souhaite gérer avec SaaS Runtime. Fait partie du modèle de données commun de l'environnement d'exécution SaaS. Immuable une fois défini.

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

Dépendance

Une dépendance représente une seule dépendance avec un autre type d'unité par alias.

Représentation JSON
{
  "unitKind": string,
  "alias": string
}
Champs
unitKind

string

Obligatoire. Immuable. Genre d'unité de la dépendance.

alias

string

Obligatoire. Alias de la dépendance. Utilisé pour le mappage des variables d'entrée.

VariableMapping

Mappage des variables d'entrée à leur variable de sortie respective pour les dépendances

Représentation JSON
{
  "variable": string,

  // Union field mapping_type can be only one of the following:
  "from": {
    object (FromMapping)
  },
  "to": {
    object (ToMapping)
  }
  // End of list of possible types for union field mapping_type.
}
Champs
variable

string

Obligatoire. Nom de la variable.

Champ d'union mapping_type.

mapping_type ne peut être qu'un des éléments suivants :

from

object (FromMapping)

Facultatif. Variables de sortie dont les valeurs proviendront des dépendances

to

object (ToMapping)

Facultatif. Variables d'entrée dont les valeurs seront transmises aux dépendances.

FromMapping

Variables de sortie dont les valeurs seront transmises aux dépendances

Représentation JSON
{
  "dependency": string,
  "outputVariable": string
}
Champs
dependency

string

Obligatoire. Alias de la dépendance à laquelle outputVariable transmettra sa valeur

outputVariable

string

Obligatoire. Nom de l'outputVariable de la dépendance

ToMapping

Variables d'entrée dont les valeurs seront transmises aux dépendances

Représentation JSON
{
  "dependency": string,
  "inputVariable": string,
  "ignoreForLookup": boolean
}
Champs
dependency

string

Obligatoire. Alias de la dépendance à laquelle inputVariable transmettra sa valeur

inputVariable

string

Obligatoire. Nom de l'inputVariable sur la dépendance

ignoreForLookup

boolean

Facultatif. Indique à SaaS Runtime si ce mappage doit être utilisé lors de la recherche ou non.

Méthodes

create

Créez un genre d'unité.

delete

Supprimez un seul genre d'unité.

get

Récupérez un seul genre d'unité.

list

Récupérez une collection de genres d'unité.

patch

Mettez à jour un seul genre d'unité.