Deployments

Cuidado:esta é uma versão descontinuada da API Deployment Manager. Use a versão mais recente da API.

Implantação é uma coleção de recursos implantados e gerenciados juntos usando-se um arquivo de configuração.

Para ver uma lista dos métodos desse recurso, consulte o final desta página.

Representações de recursos

{
  "id": unsigned long,
  "insertTime": string,
  "updateTime": string,
  "name": string,
  "description": string,
  "fingerprint": bytes,
  "manifest": string,
  "update": {
    "errors": [
      string
    ],
    "manifest": string
  },
  "target": {
    "config": string,
    "imports": [
      {
        "name": string,
        "content": string
      }
    ]
  },
  "state": string,
  "intent": string
}

Nome da propriedade	Valor	Descrição	Observações
description	string	Uma descrição opcional da implantação, fornecida pelo usuário.
fingerprint	bytes	Especifica uma impressão digital para solicitações update(). Uma impressão digital é um valor gerado aleatoriamente que precisa ser fornecido em solicitações update() para realizar o bloqueio otimista. Isso garante a concorrência otimista para que apenas uma atualização possa ser realizada por vez. A impressão digital é inicialmente gerada pelo Deployment Manager e é alterada depois de cada solicitação para modificar os dados. Para receber o valor mais recente da impressão digital, faça uma solicitação get() para uma implantação.
id	unsigned long	[Somente saída] Código exclusivo do recurso, definido pelo servidor.
insertTime	string	[Somente saída] Carimbo de data/hora em que a implantação foi criada, no formato de texto RFC3339 .
intent	string	[Somente entrada] Especifica como o Deployment Manager deve aplicar esse modelo. As opções possíveis são PREVIEW, UPDATE e CANCEL. PREVIEW cria uma implantação e recursos "shell", mas não instancia esses recursos. Assim, você pode conferir uma prévia da sua implantação. Você pode usar essa intent para visualizar atualizações ou novas implantações. É preciso fornecer um target.config com uma configuração para essa intent. Depois de visualizar uma implantação, você pode implantar seus recursos fazendo uma solicitação com a intent UPDATE ou CANCEL a visualização. A implantação ainda vai existir depois que você cancelar a visualização, e você precisará excluir essa implantação separadamente se quiser removê-la. UPDATE executa uma atualização nos recursos subjacentes de uma implantação. Se você fornecer um campo target.config preenchido com essa solicitação, o Deployment Manager vai usar essa configuração para realizar uma atualização. Se você já tiver visualizado essa atualização e não fornecer um target.config ou fornecer um target.config vazio, o Deployment Manager vai usar a configuração visualizada mais recentemente. CANCEL cancela uma atualização que está em PREVIEW ou UPDATE, mas não desfaz as mudanças já feitas.
manifest	string	[Saída apenas] URL do manifesto que representa o manifesto mais recente implantado com êxito.
name	string	Nome do recurso, fornecido pelo cliente quando o recurso é criado. O nome precisa ter de 1 a 63 caracteres e estar de acordo com o RFC1035. Especificamente, o nome precisa ter de 1 a 63 caracteres e coincidir com a expressão regular [a-z]([-a-z0-9]*[a-z0-9])?, o que significa que o primeiro caractere precisa ser uma letra minúscula e todos os caracteres seguintes precisam ser um traço, uma letra minúscula ou um dígito, exceto o último caractere, que não pode ser um traço.
state	string	[Somente saída] O estado atual da implantação. Os valores podem ser DEPLOYED, DEPLOYMENT_FAILED, PREVIEWING, UPDATING e CANCELING.
target	nested object	[Entrada apenas] Os parâmetros que definem a implantação, inclusive a configuração da implantação e os modelos relevantes.
target.config	string	A configuração a ser usada na implantação.
target.imports[]	list	Especifica todos os arquivos a serem importados para a configuração. Ele pode ser usado para importar modelos ou outros arquivos. Por exemplo, convém importar um arquivo de texto para usar o arquivo em um modelo.
target.imports[].content	string	O conteúdo do arquivo.
target.imports[].name	string	O nome do arquivo.
update	nested object	[Saída apenas] Caso o Deployment Manager esteja atualizando ou visualizando uma atualização para essa implantação, a configuração atualizada é exibida aqui.
update.errors[]	list	[Somente saída] Lista de todos os erros encontrados ao tentar atualizar.
update.manifest	string	[Saída apenas] URL do manifesto que representa a configuração de atualização dessa implantação.
updateTime	string	[Somente saída] Carimbo de data/hora em que a implantação foi atualizada, no formato de texto RFC3339 .

Métodos

delete

Exclui uma implantação e todos os recursos dela.

get

Recebe informações sobre uma implantação específica.

inserir

Cria uma implantação e todos os recursos descritos pelo manifesto de implantação.

list

Lista todas as implantações de um determinado projeto.

patch

Atualiza uma implantação e todos os recursos descritos pelo manifesto de implantação. Esse método é compatível com a semântica de patch.

atualizar

Atualiza uma implantação e todos os recursos descritos pelo manifesto de implantação.