Implantações: atualizar

Atualiza uma implantação e todos os recursos descritos pelo manifesto de implantação.

See a code example.

Faça o teste agora

See a code example.
Faça o teste agora

Solicitação

Solicitação HTTP

PUT 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 do 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`": adquire 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, informe um recurso de implantações.

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
`kind`	`string`	[Somente saída] Tipo do recurso. Sempre `compute#operation` para recursos de operação.
`id`	`unsigned long`	[Somente saída] O código exclusivo do recurso. Esse código é 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] O 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] O tipo de operação, como `insert`, `update` ou `delete`, e assim por diante.
`targetLink`	`string`	[Somente saída] O URL do recurso modificado pela operação. Em operações relacionadas à criação de um instantâneo, isso aponta para o disco permanente do qual o instantâneo foi criado.
`targetId`	`unsigned long`	[Somente saída] O código exclusivo de destino, que identifica uma concretização específica do recurso de destino.
`status`	`string`	[Somente saída] O status da operação, que pode ser um dos seguintes procedimentos: `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] O 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] A 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, esse 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, esse 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`.
`selfLink`	`string`	[Somente saída] URL definido pelo servidor para o recurso.
`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.