Deployments

Attenzione: questa è una versione ritirata dell'API Deployment Manager. Utilizza la versione più recente dell'API.

Un deployment è una raccolta di risorse che vengono implementate e gestite insieme utilizzando un file di configurazione.

Per un elenco dei metodi per questa risorsa, consulta la fine di questa pagina.

Rappresentazioni delle risorse

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

Nome proprietà	Valore	Descrizione	Note
description	string	Una descrizione facoltativa del deployment fornita dall'utente.
fingerprint	bytes	Specifica un'impronta per le richieste update(). Un'impronta è un valore generato in modo casuale che deve essere fornito nelle richieste update() per eseguire il blocco ottimistico. In questo modo viene garantita la concorrenza ottimistica, in modo da poter eseguire un solo aggiornamento alla volta. L'impronta viene inizialmente generata da Deployment Manager e cambia dopo ogni richiesta di modifica dei dati. Per ottenere il valore dell'impronta più recente, esegui una richiesta get() a un deployment.
id	unsigned long	[Solo output] Identificatore univoco della risorsa, definito dal server.
insertTime	string	[Solo output] Timestamp della creazione del deployment, in formato di testo RFC3339 .
intent	string	[Solo input] Specifica in che modo Deployment Manager deve applicare questo modello. Le possibili opzioni sono PREVIEW, UPDATE e CANCEL. PREVIEW crea un deployment e risorse "shell", ma non le esegue effettivamente. In questo modo puoi visualizzare l'anteprima del tuo deployment. Puoi utilizzare questa intenzione per visualizzare l'anteprima degli aggiornamenti dei deployment o di nuovi deployment. Devi fornire un target.config con una configurazione per questo intento. Dopo aver visualizzato l'anteprima di un deployment, puoi eseguire il deployment delle risorse inviando una richiesta con l'intent UPDATE o CANCEL l'anteprima del tutto. Tieni presente che il deployment continuerà a esistere dopo l'annullamento dell'anteprima e dovrai eliminarlo separatamente se vuoi rimuoverlo. UPDATE esegue un aggiornamento delle risorse sottostanti in un deployment. Se fornisci un campo target.config compilato con questa richiesta, Deployment Manager utilizza questa configurazione per eseguire un aggiornamento. Se hai visualizzato l'anteprima di questo aggiornamento in precedenza e non fornisci un target.config o fornisci un target.config vuoto, Deployment Manager utilizza l'ultima configurazione visualizzata in anteprima. CANCEL annulla un aggiornamento in PREVIEW o UPDATE, ma non annulla le modifiche già apportate.
manifest	string	[Solo output] URL del manifest che rappresenta l'ultimo manifest di cui è stato eseguito il deployment.
name	string	Nome della risorsa, fornito dal cliente al momento della creazione. Il nome deve avere una lunghezza compresa tra 1 e 63 caratteri ed essere conforme allo standard RFC1035. Nello specifico, il nome deve avere una lunghezza compresa tra 1 e 63 caratteri e corrispondere all'espressione regolare [a-z]([-a-z0-9]*[a-z0-9])?, il che significa che il primo carattere deve essere una lettera minuscola e tutti i caratteri successivi devono essere trattini, lettere minuscole o cifre, tranne l'ultimo carattere, che non può essere un trattino.
state	string	[Solo output] Lo stato attuale del deployment. Può essere DEPLOYED, DEPLOYMENT_FAILED, PREVIEWING, UPDATING e CANCELING.
target	nested object	[Solo input] I parametri che definiscono il deployment, inclusa la configurazione del deployment e i modelli pertinenti.
target.config	string	La configurazione da utilizzare per questo deployment.
target.imports[]	list	Specifica i file da importare per questa configurazione. Questo può essere utilizzato per importare modelli o altri file. Ad esempio, potresti importare un file di testo per utilizzarlo in un modello.
target.imports[].content	string	I contenuti del file.
target.imports[].name	string	Il nome del file.
update	nested object	[Solo output] Se Deployment Manager sta attualmente aggiornando o visualizzando l'anteprima di un aggiornamento di questo deployment, la configurazione aggiornata viene visualizzata qui.
update.errors[]	list	[Solo output] Elenco di tutti gli errori riscontrati durante il tentativo di applicazione dell'aggiornamento.
update.manifest	string	[Solo output] URL del manifest che rappresenta la configurazione di aggiornamento di questo deployment.
updateTime	string	[Solo output] Timestamp dell'aggiornamento del deployment, in formato di testo RFC3339 .

Metodi

elimina

Elimina un deployment e tutte le risorse al suo interno.

get

Ottiene informazioni su un deployment specifico.

inserire

Crea un deployment e tutte le risorse descritte dal manifest di deployment.

list

Elenca tutti i deployment per un determinato progetto.

patch

Aggiorna un deployment e tutte le risorse descritte dal manifest di deployment. Questo metodo supporta la semantica patch.

update

Aggiorna un deployment e tutte le risorse descritte dal manifest di deployment.