MCP Tools Reference: saasservicemgmt

Outil : list_releases

Liste les ressources de version. Paramètre obligatoire : "parent" (par exemple, projects/my-project/locations/us-central1). Paramètres facultatifs : "page_size", "page_token", "filter", "order_by".

L'exemple suivant montre comment utiliser curl pour appeler l'outil MCP list_releases.

Requête curl 
                  
curl --location 'https://saasservicemgmt.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "list_releases",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Schéma d'entrée

Structure de la requête pour la méthode ListReleases.

ListReleasesRequest

Représentation JSON 
{
  "parent": string,
  "pageSize": integer,
  "pageToken": string,
  "filter": string,
  "orderBy": string
}
Champs
parent

string

Obligatoire. Parent de la version.
pageSize

integer

Nombre maximal de sorties à envoyer par page.
pageToken

string

Jeton de page : si le next_page_token d'une réponse précédente est fourni, cette requête enverra la page suivante.
filter

string

Filtrez la liste comme indiqué dans https://google.aip.dev/160.
orderBy

string

Triez les résultats comme indiqué dans https://google.aip.dev/132.

Schéma de sortie

Structure de la réponse pour la méthode ListReleases.

ListReleasesResponse

Représentation JSON 
{
  "releases": [
    {
      object (Release)
    }
  ],
  "nextPageToken": string,
  "unreachable": [
    string
  ]
}
Champs
releases[]

object (Release)

Les versions résultantes.
nextPageToken

string

Si le jeton de page suivante est présent, il peut être fourni à un appel ListReleases ultérieur pour lister la page suivante. Si ce champ est vide, cela signifie qu'il n'y a plus de pages.
unreachable[]

string

Emplacements inaccessibles.

Version

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

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

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.

UnitVariable

Représentation JSON 
{
  "variable": string,
  "type": enum (Type),
  "value": string
}
Champs
variable

string

Obligatoire. Immuable. Nom de la variable issue des configurations d'actionnement.
type

enum (Type)

Facultatif. Immuable. Nom d'un type de variable compatible. Les types acceptés sont string, int et bool.
value

string

Facultatif. Valeur encodée sous forme de chaîne pour la variable.

ComponentRef

Représentation JSON 
{
  "compositeRef": {
    object (CompositeRef)
  },
  "component": string,
  "revision": string
}
Champs
compositeRef

object (CompositeRef)

Référence à Composite ApplicationTemplate.
component

string

Nom du composant dans composite.Components
revision

string

Révision du composant. Si le composant n'a pas de révision, ce champ sera défini explicitement sur la révision de l'ApplicationTemplate composite.

CompositeRef

Représentation JSON 
{
  "applicationTemplate": string,
  "revision": string,
  "syncOperation": string
}
Champs
applicationTemplate

string

Obligatoire. Référence à la ressource ApplicationTemplate.
revision

string

Révision du modèle d'application à utiliser. Toute modification apportée à une révision déclenchera une resynchronisation manuelle. Si ce champ est vide, ApplicationTemplate sera ignoré.
syncOperation

string

Uniquement en sortie. Référence à l'opération d'importation et de réplication AppTemplate en cours (c'est-à-dire l'opération_id pour l'opération de longue durée). Ce champ est opaque pour une utilisation externe.

LabelsEntry

Représentation JSON 
{
  "key": string,
  "value": string
}
Champs
key

string
value

string

AnnotationsEntry

Représentation JSON 
{
  "key": string,
  "value": string
}
Champs
key

string
value

string

Horodatage

Représentation JSON 
{
  "seconds": string,
  "nanos": integer
}
Champs
seconds

string (int64 format)

Représente les secondes de l'heure UTC à partir de l'epoch Unix 1970-01-01T00:00:00Z. La valeur doit être comprise entre -62135596800 et 253402300799 inclus (ce qui correspond à 0001-01-01T00:00:00Z et 9999-12-31T23:59:59Z).
nanos

integer

Fractions de secondes non négatives avec une précision de l'ordre de la nanoseconde. Ce champ correspond à la partie en nanosecondes de la durée, et non à une alternative aux secondes. Les valeurs de secondes négatives avec des fractions doivent toujours comporter des valeurs de nanosecondes non négatives comptabilisées dans le temps. La valeur doit être comprise entre 0 et 999 999 999 inclus.

Annotations d'outils

Indication destructive : ❌ | Indication idempotente : ✅ | Indication en lecture seule : ✅ | Indication Open World : ❌