Implantações: patch

Requer autorização

Atualiza uma implantação e todos os recursos descritos pelo manifesto de implantação. Esse método aceita semântica de patch.

Solicitação

Solicitação HTTP

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

Parâmetros

Nome do parâmetro Valor Descrição
Parâmetros de caminho
deployment string O nome da implantação dessa solicitação.
project string O código de projeto dessa solicitação.
Parâmetros de consulta opcionais
createPolicy string Definem a política de uso para a criação de novos recursos.

Os valores aceitáveis são:
  • "ACQUIRE": recebe um recurso existente. A implantação falhará se o recurso não existir.
  • "CREATE_OR_ACQUIRE": recebe o recurso, se existir. Caso contrário, cria um. (padrão)
deletePolicy string Configura a política a ser usada para excluir recursos.

Os valores aceitáveis são:
  • "ABANDON": remove o recurso do Deployment Manager, mas não exclui o recurso subjacente.
  • "DELETE": remove o recurso do Deployment Manager e exclui o recurso subjacente. (padrão)
preview boolean Caso definido como verdadeiro, atualiza a implantação, cria e atualiza os recursos de "shell", mas não altera ou instancia efetivamente esses recursos. Isso permite visualizar a aparência da implantação. Use essa intenção para visualizar como uma atualização afetaria a implantação. Forneça um target.config com uma configuração, caso definido como verdadeiro. Depois de visualizar uma implantação, você poderá implantar os recursos fazendo uma solicitação com o método update() ou poderá usar o método cancelPreview() para remover a visualização também. A implantação continuará existindo depois que você cancelar a visualização, sendo necessário excluir separadamente essa implantação caso você queira removê-la. (Padrão: false)

Autorização

Esta solicitação requer autorização com pelo menos um dos seguintes escopos (leia mais sobre autenticação e autorização).

Escopo
https://www.googleapis.com/auth/cloud-platform
https://www.googleapis.com/auth/ndev.cloudman

Corpo da solicitação

No corpo da solicitação, forneça as partes relevantes de um recurso de implantações, de acordo com as regras da semântica de patch.

Resposta

Se bem-sucedido, este método retornará um corpo de resposta com a seguinte estrutura:

{
  "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 da propriedade Valor Descrição Observações
kind string [Somente saída] Tipo do recurso. Sempre compute#operation para recursos de operação.
id unsigned long [Somente saída] Código único do recurso. Definido pelo servidor.
creationTimestamp string [Somente saída] Timestamp de criação no formato de texto RFC3339.
name string [Somente saída] Nome do recurso.
zone string [Somente saída] URL da zona onde reside a operação. Só disponível durante a execução de operações por zona.
clientOperationId string [Somente saída] Reservado para uso futuro.
operationType string [Somente saída] Tipo de operação, como insert, update ou delete, e assim por diante.
targetId unsigned long [Somente saída] Código único de destino, que identifica uma concretização específica do recurso de destino.
status string [Somente saída] Status da operação, que pode ser um dos seguintes: PENDING, RUNNING ou DONE.
statusMessage string [Somente saída] Uma descrição textual opcional do status atual da operação.
user string [Somente saída] Usuário que solicitou a operação, por exemplo: user@example.com.
progress integer [Somente saída] Um indicador de progresso opcional que varia de 0 a 100. Não há nenhuma exigência de que seja linear nem tenha compatibilidade com qualquer granularidade de operações. Não use esse indicador para adivinhar quando a operação será concluída. Esse número precisa aumentar uniformemente à medida que a operação progride.
insertTime string [Somente saída] Hora em que a operação foi solicitada. Esse valor está em formato de texto RFC3339.
startTime string [Somente saída] Hora em que a operação foi iniciada pelo servidor. Esse valor está em formato de texto RFC3339.
endTime string [Somente saída] Hora em que a operação foi concluída. Esse valor está em formato de texto RFC3339.
error object [Somente saída] Se forem gerados erros durante o processamento da operação, este campo será preenchido.
error.errors[] list [Somente saída] A matriz de erros encontrados durante o processamento dessa operação.
error.errors[].code string [Somente saída] O código do tipo desse erro.
error.errors[].location string [Somente saída] Indica o campo na solicitação que causou o erro. Esta propriedade é opcional.
error.errors[].message string [Somente saída] Uma mensagem de erro opcional, legível.
warnings[] list [Somente saída] Se forem geradas mensagens de aviso durante o processamento da operação, este campo será preenchido.
warnings[].code string [Somente saída] Um código de aviso, se aplicável. Por exemplo, o código NO_RESULTS_ON_PAGE é retornado no Compute Engine quando não há resultados na resposta.
warnings[].message string [Somente saída] Uma descrição legível do código de advertência.
warnings[].data[] list [Somente saída] Metadados sobre esse aviso no formato key: value. Por exemplo:

"data": [ { "key": "scope", "value": "zones/us-east1-d" }
warnings[].data[].key string [Somente saída] Uma chave que fornece mais detalhes sobre o aviso retornado. Por exemplo, no caso de avisos de que não há resultados em uma solicitação de lista de uma determinada zona, essa chave corresponde ao scope e o valor dessa chave é o nome da zona. Outros exemplos podem ser uma chave indicando um recurso com uso suspenso e uma substituição sugerida, ou um aviso sobre configurações de rede inválidas. Por exemplo, se uma instância tenta executar o encaminhamento de IP, mas não é ativada pelo encaminhamento.
warnings[].data[].value string [Somente saída] Um valor de dados do aviso correspondente à chave.
httpErrorStatusCode integer [Somente saída] Se a operação falhar, este campo conterá o código de status de erro HTTP retornado. Por exemplo, um 404 significa que o recurso não foi encontrado.
httpErrorMessage string [Somente saída] Se a operação falhar, este campo conterá a mensagem de erro HTTP retornada como NOT FOUND.
region string [Somente saída] O URL da região onde reside a operação. Somente disponível na execução de operações regionais.
description string [Somente saída] Uma descrição textual da operação, configurada quando a operação foi criada.