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. |
|
targetLink |
string |
[Somente saída] O URL do recurso modificado pela operação. Para operações relacionadas à criação de um instantâneo, esse URL aponta para o disco permanente onde o instantâneo foi criado. | |
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 . |
|
selfLink |
string |
[Somente saída] URL definido pelo servidor para o recurso. | |
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. |