Implantações: cancelPreview

Requer autorização

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

  •  
  •  

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 para esta solicitação.
project string O código do projeto para esta 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 Notas
fingerprint bytes Especifica uma impressão digital para solicitações cancelPreview(). Essa impressão é um valor gerado aleatoriamente que é fornecido em solicitações cancelPreview() para a execução de bloqueios otimistas. 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 é inicialmente gerada pelo Deployment Manager e é alterada depois de cada solicitação para modificar uma implantação. Para buscar o valor mais recente dessa impressão, execute uma solicitação get() na implantação.

Resposta

Se bem-sucedido, este método retorna 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 Notas
kind string [Somente saída] Tipo do recurso. Sempre compute#operation para recursos de operação.
id unsigned long [Somente saída] O identificador exclusivo do recurso. Esse identificador é 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 em que reside a operação. Disponível apenas ao executar 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.
targetId unsigned long [Somente saída] O código de destino exclusivo, que identifica uma concretização específica do recurso de destino.
status string [Somente saída] O status da operação, que pode ser 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. Ele aumenta de maneira uniforme conforme o andamento da operação.
insertTime string [Somente saída] O horário em que essa operação foi solicitada. Esse valor está no formato de texto RFC3339.
startTime string [Somente saída] O horário em que essa operação foi iniciada pelo servidor. Esse valor está no formato de texto RFC3339.
endTime string [Somente saída] O horário em que essa 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, esse campo será preenchido.
error.errors[] list [Somente saída] A matriz dos erros encontrados durante o processamento dessa operação.
error.errors[].code string [Somente saída] O identificador do tipo de erro.
error.errors[].location string [Somente saída] Indica o campo na solicitação em que o erro ocorreu. Essa propriedade é opcional.
error.errors[].message string [Somente saída] Uma mensagem de erro legível e opcional.
warnings[] list [Somente saída] Se mensagens de aviso forem geradas 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 aviso.
warnings[].data[] list [Somente saída] Metadados sobre este 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, para avisos em que não há resultado em uma solicitação de lista para uma zona específica, essa chave pode ser o 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] Quando ocorre uma falha na operação, este campo contém o código de status de erro de HTTP retornado. Por exemplo, um 404 significa que o recurso não foi encontrado.
httpErrorMessage string [Somente saída] Quando ocorre uma falha na operação, este campo contém a mensagem de erro de HTTP retornado, por exemplo, NOT FOUND.
region string [Somente saída] O URL da região em que reside a operação. Disponível apenas durante a execução de operações regionais.
description string [Somente saída] Uma descrição textual da operação, configurada no momento em que a operação foi criada.