Deployments: cancelPreview

Requer autorização

Cancela e remove a visualização associada à implantação. Faça o teste agora.

Solicitação

Solicitação HTTP

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

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 da solicitação.

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 dados com a seguinte estrutura:

{
  "fingerprint": bytes
}
Nome da propriedade Valor Descrição Observações
fingerprint bytes Especifica uma impressão digital para solicitações cancelPreview(). Uma impressão digital é um valor gerado aleatoriamente que precisa ser fornecido em solicitações cancelPreview() para realizar o bloqueio otimista. Isso garante simultaneidade otimista para que não haja solicitações conflitantes na implantação. Por exemplo, se alguém tenta fazer uma nova solicitação de atualização enquanto outro usuário tenta cancelar uma visualização, isso impede uma das solicitações.

A impressão digital é gerada inicialmente pelo Deployment Manager e muda após cada solicitação para modificar uma implantação. Para receber o valor mais recente da impressão digital, faça uma solicitação get() na implantação.

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 [Descontinuado] Este campo foi descontinuado.
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. É necessário especificar esse campo como parte do URL da solicitação HTTP. Ele não pode ser definido como um campo no corpo da solicitação.
clientOperationId string [Somente saída] O valor de "requestId", se você o forneceu na solicitação. Caso contrário, não está presente.
operationType string [Somente saída] O 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 este indicador para adivinhar quando a operação será concluída. O 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á no formato de texto RFC3339.
startTime string [Somente saída] Hora em que a operação foi iniciada pelo servidor. Esse valor está no formato de texto RFC3339.
endTime string [Somente saída] Hora em que a operação foi concluída. Esse valor está no 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. 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, para avisos em que não há resultados em uma solicitação de lista para uma zona específica, essa chave pode ser scope e o valor da chave pode ser 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, esse campo vai conter a mensagem de erro HTTP que foi retornada, como NOT FOUND.
region string [Somente saída] URL da região onde reside a operação. Somente disponível na execução de operações regionais. É necessário especificar esse campo como parte do URL da solicitação HTTP. Ele não pode ser definido como um campo no corpo da solicitação.
description string [Somente saída] Uma descrição textual da operação, configurada quando a operação foi criada.