Deployments: patch

Applica patch a un deployment e a tutte le risorse descritte dal manifest di deployment. Questo metodo supporta la semantica delle patch. Prova subito.

Richiesta

Richiesta HTTP

PATCH https://www.googleapis.com/deploymentmanager/v2/projects/project/global/deployments/deployment

Parametri

Nome parametro Valore Descrizione
Parametri del percorso
deployment string Il nome del deployment per questa richiesta.
project string L'ID progetto per questa richiesta.
Parametri di query facoltativi
createPolicy string Imposta il criterio da utilizzare per la creazione di nuove risorse.

I valori accettati sono:
  • "ACQUIRE": acquisisci una risorsa esistente. Se la risorsa non esiste, il deployment non andrà a buon fine.
  • "CREATE_OR_ACQUIRE": acquisisci la risorsa se esiste, creane una se non esiste. (predefinito)
deletePolicy string Imposta il criterio da utilizzare per l'eliminazione delle risorse.

I valori accettati sono:
  • "ABANDON": rimuove la risorsa da Deployment Manager, ma non elimina la risorsa sottostante.
  • "DELETE": rimuove la risorsa da Deployment Manager ed elimina la risorsa sottostante. (predefinito)
preview boolean Se impostato su true, aggiorna il deployment e crea e aggiorna le risorse "shell", ma non le altera né le esegue in un'istanza. In questo modo puoi visualizzare l'anteprima del deployment. Puoi utilizzare questo intento per visualizzare l'anteprima dell'impatto di un aggiornamento sul tuo deployment. Devi fornire un target.config con una configurazione se questo valore è impostato su true. Dopo aver visualizzato l'anteprima di un deployment, puoi eseguire il deployment delle risorse inviando una richiesta con update() oppure puoi cancelPreview() per rimuovere del tutto l'anteprima. Tieni presente che il deployment continuerà a esistere dopo l'annullamento dell'anteprima e se vuoi rimuoverlo, dovrai eliminarlo separatamente. (Valore predefinito: false)

Corpo della richiesta

Nel corpo della richiesta, fornisci le parti pertinenti di una risorsa Deployments, in base alle regole della semantica delle patch.

Risposta

In caso di esito positivo, questo metodo restituisce un corpo della risposta con la seguente struttura:

{
  "kind": "deploymentmanager#operation",
  "id": unsigned long,
  "creationTimestamp": string,
  "name": string,
  "zone": string,
  "clientOperationId": string,
  "operationType": string,
  "targetLink": string,
  "targetId": unsigned long,
  "status": string,
  "statusMessage": string,
  "user": string,
  "progress": integer,
  "insertTime": string,
  "startTime": string,
  "endTime": string,
  "error": {
    "errors": [
      {
        "code": string,
        "location": string,
        "message": string
      }
    ]
  },
  "warnings": [
    {
      "code": string,
      "message": string,
      "data": [
        {
          "key": string,
          "value": string
        }
      ]
    }
  ],
  "httpErrorStatusCode": integer,
  "httpErrorMessage": string,
  "selfLink": string,
  "region": string,
  "description": string
}
Nome proprietà Valore Descrizione Note
kind string [Solo output] Tipo di risorsa. Sempre compute#operation per le risorse Operation.
id unsigned long [Solo output] L'identificatore univoco della risorsa. Questo identificatore è definito dal server.
creationTimestamp string [Ritiro] Questo campo è stato ritirato.
name string [Solo output] Nome della risorsa.
zone string [Solo output] L'URL della zona in cui si trova l'operazione. Disponibile solo quando vengono eseguite operazioni per zona. Devi specificare questo campo nell'URL della richiesta HTTP. Non può essere impostato come campo nel corpo della richiesta.
clientOperationId string [Solo output] Il valore di "requestId", se lo hai fornito nella richiesta. Non presente negli altri casi.
operationType string [Solo output] Il tipo di operazione, ad esempio insert, update o delete e così via.
targetId unsigned long [Solo output] L'ID target univoco, che identifica una specifica incarnazione della risorsa di destinazione.
status string [Solo output] Lo stato dell'operazione, che può essere uno dei seguenti: PENDING, RUNNING o DONE.
statusMessage string [Solo output] Una descrizione testuale facoltativa dello stato corrente dell'operazione.
user string [Solo output] Utente che ha richiesto l'operazione, ad esempio: user@example.com.
progress integer [Solo output] Un indicatore di avanzamento facoltativo compreso tra 0 e 100. Non è necessario che sia lineare o supporti qualsiasi granularità delle operazioni. Questo valore non deve essere utilizzato per prevedere quando l'operazione sarà completata. Questo numero dovrebbe aumentare in modo monotono man mano che l'operazione procede.
insertTime string [Solo output] La data e l'ora in cui è stata richiesta questa operazione. Questo valore è nel formato di testo RFC3339.
startTime string [Solo output] Data e ora di inizio dell'operazione da parte del server. Questo valore è nel formato di testo RFC3339.
endTime string [Solo output] Data e ora del completamento dell'operazione. Questo valore è nel formato di testo RFC3339.
error object [Solo output] Se vengono generati errori durante l'elaborazione dell'operazione, questo campo verrà compilato.
error.errors[] list [Solo output] L'array di errori riscontrati durante l'elaborazione di questa operazione.
error.errors[].code string [Solo output] L'identificatore del tipo di errore per questo errore.
error.errors[].location string [Solo output] Indica il campo della richiesta che ha causato l'errore. Questa proprietà è facoltativa.
error.errors[].message string [Solo output] Un messaggio di errore facoltativo leggibile.
warnings[] list [Solo output] Se durante l'elaborazione dell'operazione vengono generati messaggi di avviso, questo campo verrà compilato.
warnings[].code string [Solo output] Un codice di avviso, se applicabile. Ad esempio, Compute Engine restituisce NO_RESULTS_ON_PAGE se non ci sono risultati nella risposta.
warnings[].message string [Solo output] Una descrizione leggibile del codice di avviso.
warnings[].data[] list [Solo output] Metadati relativi a questo avviso in formato key: value. Ad esempio: 
"data": [ { "key": "scope", "value": "zones/us-east1-d" }
warnings[].data[].key string [Solo output] Una chiave che fornisce ulteriori dettagli sull'avviso restituito. Ad esempio, per gli avvisi in cui non sono presenti risultati in una richiesta di elenco per una determinata zona, questa chiave potrebbe essere scope e il valore della chiave potrebbe essere il nome della zona. Altri esempi possono essere una chiave che indica una risorsa deprecata e una sostituzione suggerita oppure un avviso relativo a impostazioni di rete non valide (ad esempio, se un'istanza tenta di eseguire il forwarding IP, ma non è abilitata per il forwarding IP).
warnings[].data[].value string [Solo output] Un valore di dati di avviso corrispondente alla chiave.
httpErrorStatusCode integer [Solo output] Se l'operazione non va a buon fine, questo campo contiene il codice di stato di errore HTTP restituito. Ad esempio, un 404 indica che la risorsa non è stata trovata.
httpErrorMessage string [Solo output] Se l'operazione non va a buon fine, questo campo contiene il messaggio di errore HTTP restituito, ad esempio NOT FOUND.
region string [Solo output] L'URL della regione in cui si trova l'operazione. Disponibile solo quando vengono eseguite operazioni a livello di regione. Devi specificare questo campo nell'URL della richiesta HTTP. Non può essere impostato come campo nel corpo della richiesta.
description string [Solo output] Una descrizione testuale dell'operazione, impostata al momento della creazione.

Prova

Utilizza l'Explorer API di seguito per chiamare questo metodo sui dati in tempo reale e visualizzare la risposta. In alternativa, prova lo strumento di esplorazione autonomo.