Deployments

Attention:Il s'agit d'une version obsolète de l'API Deployment Manager. Veuillez utiliser la dernière version de l'API à la place.

Un déploiement est une collection de ressources qui sont déployées et gérées ensemble par le biais d'un fichier de configuration.

La liste des méthodes associées à cette ressource est présentée au bas de la page.

Représentations de la ressource

{
  "id": unsigned long,
  "insertTime": string,
  "updateTime": string,
  "name": string,
  "description": string,
  "fingerprint": bytes,
  "manifest": string,
  "update": {
    "errors": [
      string
    ],
    "manifest": string
  },
  "target": {
    "config": string,
    "imports": [
      {
        "name": string,
        "content": string
      }
    ]
  },
  "state": string,
  "intent": string
}

Nom de propriété	Valeur	Description	Remarques
description	string	Description facultative du déploiement fournie par l'utilisateur.
fingerprint	bytes	Spécifie une empreinte pour les requêtes update(). Une empreinte est une valeur générée de manière aléatoire qui doit être fournie dans les requêtes update() pour effectuer un verrouillage optimiste. Cela garantit la concurrence optimiste, de sorte qu'une seule mise à jour puisse être effectuée à la fois. L'empreinte est initialement générée par le Gestionnaire de déploiement et change après chaque requête de modification des données. Pour obtenir la dernière valeur d'empreinte, effectuez une requête get() sur un déploiement.
id	unsigned long	[Uniquement en sortie] Identifiant unique de la ressource qui est défini par le serveur.
insertTime	string	[Sortie uniquement] Code temporel de création du déploiement, au format texte RFC3339 .
intent	string	[Uniquement en entrée] Indique comment Deployment Manager doit appliquer ce modèle. Les options possibles sont PREVIEW, UPDATE et CANCEL. PREVIEW crée un déploiement et des ressources "shell", mais n'instancie pas réellement ces ressources. Vous pouvez ainsi prévisualiser votre déploiement. Vous pouvez utiliser cet intent pour prévisualiser les mises à jour de déploiements ou de nouveaux déploiements. Vous devez fournir un target.config avec une configuration pour cet intent. Après avoir prévisualisé un déploiement, vous pouvez déployer vos ressources en envoyant une requête avec l'intent UPDATE ou vous pouvez CANCEL complètement l'aperçu. Notez que le déploiement continuera d'exister après l'annulation de l'aperçu. Vous devrez le supprimer séparément si vous souhaitez le supprimer. UPDATE met à jour les ressources sous-jacentes d'un déploiement. Si vous fournissez un champ target.config renseigné avec cette requête, Deployment Manager utilise cette configuration pour effectuer une mise à jour. Si vous avez déjà prévisualisé cette mise à jour et que vous ne fournissez pas de target.config ou que vous fournissez un target.config vide, Deployment Manager utilise la dernière configuration prévisualisée. CANCEL annule une mise à jour dans PREVIEW ou UPDATE, mais n'annule aucune modification déjà effectuée.
manifest	string	[Sortie uniquement] URL du fichier manifeste représentant le dernier fichier manifeste déployé avec succès.
name	string	Nom de la ressource, fourni par le client lors de sa création. Le nom doit comporter entre 1 et 63 caractères, et être conforme à la norme RFC 1035. Plus précisément, le nom doit comporter entre 1 et 63 caractères et correspondre à l'expression régulière [a-z]([-a-z0-9]*[a-z0-9])?. Le premier caractère doit donc être une minuscule et tous les caractères suivants doivent être soit un tiret, soit une lettre minuscule, soit un chiffre, à l'exception du dernier caractère qui ne peut pas être un tiret.
state	string	[Uniquement en sortie] État actuel du déploiement. Il peut s'agir de DEPLOYED, DEPLOYMENT_FAILED, PREVIEWING, UPDATING et CANCELING.
target	nested object	[Seulement en entrée] Paramètres qui définissent votre déploiement, y compris la configuration de déploiement et les modèles pertinents.
target.config	string	Configuration à utiliser pour ce déploiement.
target.imports[]	list	Indique les fichiers à importer pour cette configuration. Vous pouvez l'utiliser pour importer des modèles ou d'autres fichiers. Par exemple, vous pouvez importer un fichier texte pour l'utiliser dans un modèle.
target.imports[].content	string	Contenu du fichier.
target.imports[].name	string	Nom du fichier.
update	nested object	[Sortie uniquement] Si Deployment Manager met actuellement à jour ou prévisualise une mise à jour de ce déploiement, la configuration mise à jour s'affiche ici.
update.errors[]	list	[Sortie uniquement] Liste de toutes les erreurs rencontrées lors de la tentative d'implémentation de la mise à jour.
update.manifest	string	[Sortie uniquement] URL du fichier manifeste représentant la configuration de mise à jour de ce déploiement.
updateTime	string	[Sortie uniquement] Code temporel de la mise à jour du déploiement, au format texte RFC3339 .

Méthodes

supprimer

Supprime un déploiement et toutes les ressources associées.

get

Obtient des informations sur un déploiement spécifique.

insérer

Crée un déploiement et toutes les ressources décrites par le fichier manifeste de déploiement.

liste

Répertorie tous les déploiements d'un projet donné.

patch

Met à jour un déploiement et toutes les ressources décrites par le fichier manifeste de déploiement. Cette méthode est compatible avec la sémantique patch.

update

Met à jour un déploiement et toutes les ressources décrites par le fichier manifeste de déploiement.