Implantações: parar

Requer autorização

Para uma operação em andamento. Isso não reverte trabalhos já concluídos, mas evita a inicialização de algum trabalho novo.

  •  
  •  

Solicitação

Solicitação HTTP

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

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.

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 stop(). Essa impressão é um valor gerado aleatoriamente que é fornecido em solicitações stop() para a execução de bloqueios otimistas. Isso garante a 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 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] 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.
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.
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.