Deployments: insert

Cria uma implantação e todos os recursos descritos pelo manifesto de implantação. Faça o teste agora.

Solicitação

Solicitação HTTP

POST https://www.googleapis.com/deploymentmanager/v2beta/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
createPolicy string Definem a política de uso para a criação de novos recursos.

Os valores aceitáveis são:
  • "ACQUIRE"
  • "CREATE"
  • "CREATE_OR_ACQUIRE" (padrão)
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ê pode implantar seus recursos fazendo uma solicitação com o método "update()" ou usar o método "cancelPreview()" para cancelar a visualização por completo. A implantação ainda vai existir depois que você cancelar a visualização, e você precisará excluir essa implantação separadamente se quiser remover.

Autorização

Esta solicitação requer autorização com pelo menos um dos seguintes escopos:

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] Identificador exclusivo da operação. Definido pelo servidor.
creationTimestamp string [Descontinuado] Este campo foi descontinuado.
name string [Somente saída] Nome da operação.
zone string [Somente saída] URL da zona onde reside a operação. Aplicável apenas ao realizar operações por zona.
clientOperationId string [Somente saída] O valor de "requestId", se você o forneceu na solicitação. Caso contrário, não está presente.
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] Código único 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: `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á no formato de texto RFC3339.
startTime string [Somente saída] Hora em que a operação foi iniciada pelo servidor. Esse valor está no formato de texto RFC3339.
endTime string [Somente saída] Hora em que a 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, 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. 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á resultados em uma solicitação de lista para uma zona específica, essa chave pode ser 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] 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, esse campo vai conter a mensagem de erro HTTP que foi retornada, como "NOT FOUND".
region string [Somente saída] URL da região onde reside a operação. Aplicável apenas ao realizar operações regionais.
description string [Somente saída] Uma descrição textual da operação, configurada quando a operação foi criada.