Deployments

Achtung:Dies ist eine veraltete Version der Deployment Manager API. Verwenden Sie stattdessen die aktuelle API-Version.

Eine Bereitstellung ist eine Sammlung an Ressourcen, die unter Verwendung einer Konfigurationsdatei zusammen bereitgestellt und verwaltet werden.

Am Ende dieser Seite finden Sie eine Liste der Methoden für diese Ressource.

Ressourcendarstellungen

{
  "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
}

Property-Name	Wert	Beschreibung	Hinweise
description	string	Eine optionale Beschreibung der Bereitstellung vom Nutzer.
fingerprint	bytes	Gibt einen Fingerabdruck für update()-Anfragen an. Ein Fingerabdruck ist ein zufällig generierter Wert, der in update()-Anfragen angegeben werden muss, um ein optimistisches Sperrverfahren durchzuführen. So wird eine optimistische Parallelität gewährleistet, sodass jeweils nur eine Aktualisierung durchgeführt werden kann. Der Fingerabdruck wird anfänglich von Deployment Manager generiert und ändert sich nach jeder Abfrage, um Daten zu ändern. Wenn Sie den aktuellen Fingerabdruckwert abrufen möchten, senden Sie eine get()-Anfrage an ein Deployment.
id	unsigned long	[Nur Ausgabe] Eindeutige Kennung für die Ressource; definiert durch den Server.
insertTime	string	[Nur Ausgabe] Zeitstempel, zu dem die Bereitstellung erstellt wurde, im Textformat RFC3339 .
intent	string	[Nur Eingabe] Gibt an, wie Deployment Manager diese Vorlage anwenden soll. Mögliche Optionen sind PREVIEW, UPDATE und CANCEL. PREVIEW erstellt eine Bereitstellung und „Shell“-Ressourcen, instanziiert diese aber nicht. So können Sie sich eine Vorschau Ihrer Bereitstellung ansehen. Mit diesem Intent können Sie sich eine Vorschau von Updates oder neuen Bereitstellungen ansehen. Sie müssen eine target.config mit einer Konfiguration für diesen Intent angeben. Nachdem Sie die Vorschau einer Bereitstellung aufgerufen haben, können Sie Ihre Ressourcen bereitstellen, indem Sie eine Anfrage mit der UPDATE-Intent senden. Sie können die Vorschau auch CANCEL. Die Bereitstellung bleibt nach dem Abbrechen der Vorschau erhalten. Wenn Sie sie entfernen möchten, müssen Sie sie separat löschen. UPDATE führt eine Aktualisierung der zugrunde liegenden Ressourcen in einer Bereitstellung durch. Wenn Sie in dieser Anfrage ein ausgefülltes target.config-Feld angeben, verwendet Deployment Manager diese Konfiguration, um eine Aktualisierung durchzuführen. Wenn Sie dieses Update bereits als Vorschau angesehen haben und keine target.config oder eine leere target.config angeben, verwendet Deployment Manager die letzte Konfiguration, die als Vorschau angezeigt wurde. CANCEL bricht ein Update ab, das sich in PREVIEW oder UPDATE befindet, macht aber keine bereits vorgenommenen Änderungen rückgängig.
manifest	string	[Nur Ausgabe] URL des Manifests, die für das letzte erfolgreich bereitgestellte Manifest steht.
name	string	Name der Ressource, angegeben von dem Client beim Erstellen der Ressource. Der Name muss zwischen 1 und 63 Zeichen lang sein und RFC 1035 entsprechen. Der Name muss 1–63 Zeichen lang sein und mit dem regulären Ausdruck [a-z]([-a-z0-9]*[a-z0-9])? übereinstimmen. Das erste Zeichen muss ein Kleinbuchstabe und alle folgenden Zeichen müssen ein Bindestrich, ein Kleinbuchstabe oder eine Ziffer sein, mit Ausnahme des letzten Zeichens, das kein Bindestrich sein darf.
state	string	[Nur Ausgabe] Der aktuelle Status der Bereitstellung. Das kann DEPLOYED, DEPLOYMENT_FAILED, PREVIEWING, UPDATING und CANCELING sein.
target	nested object	[Nur Ausgabe] Die Parameter, die Ihre Bereitstellung definieren, darunter die Bereitstellungskonfiguration und die relevanten Vorlagen.
target.config	string	Die Konfiguration, die für diese Bereitstellung genutzt werden soll.
target.imports[]	list	Gibt eine Datei zum Import für diese Konfiguration an. Dies kann verwendet werden, um Vorlagen oder andere Dateien zu importieren. Beispielsweise wollen Sie möglicherweise eine Textdatei importieren, um sie in einer Vorlage zu verwenden.
target.imports[].content	string	Der Inhalt der Datei.
target.imports[].name	string	Der Name der Datei.
update	nested object	[Nur Ausgabe] Wenn Deployment Manager gerade eine Aktualisierung oder Vorschau der Bereitstellung durchführt, taucht die aktualisierte Konfiguration hier auf.
update.errors[]	list	[Nur Ausgabe] Liste aller Fehler, die beim Versuch, das Update auszuführen, aufgetreten sind.
update.manifest	string	[Nur Ausgabe] URL des Manifests, die für die aktualisierte Konfiguration dieser Bereitstellung steht.
updateTime	string	[Nur Ausgabe] Zeitstempel, zu dem die Bereitstellung aktualisiert wurde, im Textformat RFC3339 .

Methoden

Delete

Löst eine Bereitstellung und alle darin enthaltenen Ressourcen.

get

Ermittelt Informationen zu einer bestimmten Bereitstellung.

insert

Erstellt eine Bereitstellung und alle im Bereitstellungsmanifest beschriebenen Ressourcen.

list

Listet alle Bereitstellungen für ein bestimmtes Projekt auf.

patch

Aktualisiert eine Bereitstellung und alle im Bereitstellungsmanifest beschriebenen Ressourcen. Diese Methode unterstützt die Patch-Semantik.

aktualisieren

Aktualisiert eine Bereitstellung und alle Ressourcen, die im Bereitstellungsmanifest beschrieben sind.