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.

See a code example.

Faça o teste agora

See a code example.
Faça o teste agora

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
`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.