REST Resource: projects.locations.releases

Recurso: Release

Uma nova versão a ser propagada e implantada nas unidades. Isso inclui ponteiros para blueprints empacotados para atuação (por exemplo, pacotes de configuração do Helm ou do Terraform) via Artifact Registry.

Representação JSON 
{
  "name": string,
  "unitKind": string,
  "blueprint": {
    object (Blueprint)
  },
  "releaseRequirements": {
    object (ReleaseRequirements)
  },
  "inputVariables": [
    {
      object (UnitVariable)
    }
  ],
  "outputVariables": [
    {
      object (UnitVariable)
    }
  ],
  "inputVariableDefaults": [
    {
      object (UnitVariable)
    }
  ],
  "labels": {
    string: string,
    ...
  },
  "annotations": {
    string: string,
    ...
  },
  "uid": string,
  "etag": string,
  "createTime": string,
  "updateTime": string
}
Campos
name

string

Identificador. O nome do recurso (URI completo do recurso) seguindo o esquema de nomenclatura padrão:

"projects/{project}/locations/{location}/releases/{release}"
unitKind

string

Obrigatório. Imutável. Referência ao UnitKind a que esta versão corresponde (obrigatório e imutável após a criação).
blueprint

object (Blueprint)

Opcional. Os projetos são imagens da OCI que contêm todos os artefatos necessários para provisionar uma unidade.
releaseRequirements

object (ReleaseRequirements)

Opcional. Conjunto de requisitos a serem cumpridos na unidade ao usar esta versão.
inputVariables[]

object (UnitVariable)

Opcional. Apenas saída. Lista de variáveis de entrada declaradas no blueprint e que podem estar presentes com seus valores na especificação da unidade.
outputVariables[]

object (UnitVariable)

Opcional. Apenas saída. Lista de variáveis de saída declaradas no blueprint e que podem estar presentes com os valores delas no status da unidade.
inputVariableDefaults[]

object (UnitVariable)

Opcional. Mapeamento de variáveis de entrada para valores padrão. Máximo de 100
labels

map (key: string, value: string)

Opcional. Os rótulos no recurso, que podem ser usados para categorização, semelhantes aos rótulos de recursos do Kubernetes.

Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
annotations

map (key: string, value: string)

Opcional. Anotações é um mapa de chave-valor não estruturado armazenado com um recurso que pode ser definido por ferramentas externas para armazenar e recuperar metadados arbitrários. Elas não podem ser consultadas e precisam ser preservadas ao modificar objetos.

Mais informações: https://kubernetes.io/docs/user-guide/annotations

Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
uid

string

Apenas saída. O identificador exclusivo do recurso. O UID é exclusivo no tempo e espaço para esse recurso no escopo do serviço. Geralmente, ele é gerado pelo servidor quando um recurso é criado com sucesso e não pode ser modificado. O UID é usado para identificar exclusivamente recursos com reutilização de nome de recurso. Deve ser um UUID4.
etag

string

Apenas saída. Um valor opaco que identifica exclusivamente uma versão ou geração de um recurso. Pode ser usado para confirmar que o cliente e o servidor concordam com a ordenação de um recurso em criação.
createTime

string (Timestamp format)

Apenas saída. O carimbo de data/hora em que o recurso foi criado.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de Z, outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Apenas saída. O carimbo de data/hora da última atualização do recurso. Qualquer mudança que for feita pelos usuários no recurso vai atualizar esse valor. As mudanças de um recurso feitas pelo serviço devem atualizar esse valor.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de Z, outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

Blueprint

Os projetos são imagens da OCI que contêm todos os artefatos necessários para provisionar uma unidade. Metadados como o tipo do mecanismo usado para acionar o blueprint (por exemplo, Terraform, Helm etc.) e a versão vêm do manifesto da imagem. Se o nome do host for omitido, ele será considerado o caminho regional para o Artifact Registry (por exemplo, us-east1-docker.pkg.dev).

Representação JSON 
{
  "package": string,
  "engine": string,
  "version": string
}
Campos
package

string

Opcional. Imutável. URI de um blueprint usado pela unidade. Obrigatório, a menos que "unitKind" ou "release" estejam definidos.
engine

string

Apenas saída. Tipo do mecanismo usado para acionar o blueprint. Por exemplo, "terraform", "helm" etc.
version

string

Apenas saída. Metadados de versão, se presentes no blueprint.

ReleaseRequirements

Conjunto de requisitos a serem cumpridos na unidade ao usar esta versão.

Representação JSON 
{
  "upgradeableFromReleases": [
    string
  ]
}
Campos
upgradeableFromReleases[]

string

Opcional. Uma lista de versões mínimas para fazer upgrade de uma unidade para esta versão (opcional). Se estiver em branco, nenhuma restrição será aplicada. Quando fornecidas, as solicitações de upgrade de unidade para esta versão vão verificar e aplicar essa restrição.

Métodos

create

 Crie um novo lançamento.

delete

 Exclui uma única versão.

get

 Recupera uma única versão.

list

 Recupera uma coleção de versões.

patch

 Atualizar uma única versão.