Requer autorização
Cria uma implantação e todos os recursos descritos pelo manifesto de implantação.
Solicitação
Solicitação HTTP
POST https://www.googleapis.com/deploymentmanager/v2/projects/project/global/deployments
Parâmetros
Nome do parâmetro | Valor | Descrição |
---|---|---|
Parâmetros de caminho | ||
project |
string |
Código de projeto da solicitação. |
Parâmetros de consulta opcionais | ||
preview |
boolean |
Caso definido como verdadeiro, cria uma implantação e recursos de "shell", mas não instancia efetivamente esses recursos. Isso permite visualizar a aparência da implantação. Depois de visualizar uma implantação, você poderá implantar os recursos fazendo uma solicitação com o método update() ou poderá usar o método cancelPreview() para cancelar a visualização também. A implantação continuará existindo depois que você cancelar a visualização, sendo necessário excluir separadamente essa implantação caso você queira removê-la.
|
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, informe um recurso de implantações.
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 |
[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] 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] Tipo de operação, como insert , update ou delete , e assim por diante. |
|
targetLink |
string |
[Somente saída] 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] 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á 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, 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 . 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, esta 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] URL da região onde reside a operação. Somente disponível na execução de operações regionais. | |
description |
string |
[Saída apenas] Uma descrição textual da operação, configurada quando a operação foi criada. |