Skip to main content
Astra Automation
Uma versão mais recente deste produto está disponível.
O português é fornecido por meio de tradução automática para sua conveniência. O inglês precede o português em caso de inconsistências.

Modificar uma atualização

PDFs

PUT /accounts/{account_id}/core/v1/upgrades/{upgrade_id}

Substitui todo o recurso armazenado pelo corpo da solicitação JSON fornecida, preservando os valores-chave que não podem ser modificados pelo usuário.

Efeitos Colaterais

  • As atualizações são agendadas ou executadas com base no estado desejado.

Parâmetros

Nome Tipo Em Obrigatório Descrição

id_da_conta

string

caminho

Verdadeiro

ID do recurso de conta que o contém

  • exemplo: {{.Account}}

upgrade_id

string

caminho

Verdadeiro

ID da coleção de atualização a ser listada

Corpo da solicitação

Substitui todo o recurso armazenado pelo corpo da solicitação JSON fornecida, preservando os valores-chave que não podem ser modificados pelo usuário.

Efeitos Colaterais

  • As atualizações são agendadas ou executadas com base no estado desejado.

Nome Tipo Obrigatório Descrição

tipo

string

Verdadeiro

Tipo de mídia do recurso. Os valores definidos são:

  • "application/astra-upgrade"

versão

string

Verdadeiro

Versão do recurso. Os valores definidos são:

  • "1,0"

  • "1,1"

id

string

Falso

Identificador globalmente único do recurso. Os valores definidos são:

  • Em conformidade com o esquema UUIDv4

componentName

string

Falso

String JSON contendo o nome do tipo de software que pode ser atualizado. Os valores definidos são:

  • "acc"

  • "acs"

  • "Trident"

  • "kubernetes"

componentInstance

string

Falso

String JSON contendo o URI do componente que pode ser atualizado. Os valores definidos são:

  • Comprimento mínimo: 3

  • Comprimento máximo: 4095

ID do componente

string

Falso

String JSON contendo um identificador globalmente único do componente que pode ser atualizado. Os valores definidos são:

  • Conforme o esquema de identificador Astra

upgradeVersion

string

Falso

String JSON contendo o SemVer do arquivo de imagem do software para o qual pode ser feita a atualização. Os valores definidos são:

  • Está em conformidade com o SemVer Schema

currentVersion

string

Falso

String JSON contendo o SemVer atual da entidade a ser atualizada. Os valores definidos são:

  • Está em conformidade com o SemVer Schema

dependências

array[string]

Falso

Array JSON de strings JSON, cada uma contendo o UUID de uma atualização que deve ser concluída antes que esta atualização possa prosseguir. Usado para determinar quais atualizações serão realizadas como pré-requisitos e em qual ordem. Os valores definidos são:

  • Conforme o esquema de identificador Astra

estado

string

Falso

String JSON contendo um valor que indica o estado operacional da atualização. Se a atualização automática estiver habilitada, as atualizações serão iniciadas no estado "agendado". Caso contrário, as atualizações serão iniciadas no estado "proposto". Os valores definidos são:

  • "Indisponível" - A atualização não está disponível no momento

  • "Proposto" - A atualização foi proposta, mas não será executada automaticamente até ser aprovada

  • "Agendado" - A atualização foi aprovada, mas ainda não está pronta para ser instalada devido a dependências, janelas de tempo ou recursos disponíveis

  • "running" - A atualização está em andamento

  • "Concluído" - A atualização foi concluída

  • "Falha" - A atualização não foi concluída

stateDesired

string

Falso

String JSON contendo um valor que indica o estado desejado para "state". Este campo só é incluído quando o usuário pode solicitar diretamente uma alteração no estado do recurso. Os valores definidos são:

  • "Proposto" - A atualização não foi aprovada e não deve ser realizada

  • "Agendado" - A atualização foi aprovada e deve ser realizada dentro do prazo especificado

  • "Em execução" - A atualização deve ser realizada imediatamente, independentemente do período de tempo

stateDetails

array["type_astra_stateDetail"]

Falso

Matriz JSON de objetos JSON que lista detalhes adicionais sobre o "estado" atual. Se não houver detalhes disponíveis, essa matriz estará vazia.

  • Quantidade mínima de itens: 0

metadados

"type_astra_metadados_update"

Falso

Metadados especificados pelo cliente e pelo serviço associados ao recurso. Os valores definidos são:

  • Está em conformidade com o esquema de metadados Astra. Se não for especificado na atualização, os rótulos do objeto de metadados, creationTimestamp e createdBy, serão preservados sem modificação.
Exemplo de solicitação 
{
  "type": "application/astra-upgrade",
  "version": "1.1",
  "stateDesired": "running"
}

Resposta

Status: 204, Indicates if the upgrade resource was updated.

Resposta

Status: 401, Unauthorized
Nome Tipo Obrigatório Descrição

tipo

string

Verdadeiro

título

string

Verdadeiro

detalhe

string

Verdadeiro

status

string

Verdadeiro

ID de correlação

string

Falso
Exemplo de resposta 
{
  "type": "https://astra.netapp.io/problems/3",
  "title": "Missing bearer token",
  "detail": "The request is missing the required bearer token.",
  "status": "401"
}

Resposta

Status: 400, Bad request
Nome Tipo Obrigatório Descrição

tipo

string

Verdadeiro

título

string

Verdadeiro

detalhe

string

Verdadeiro

status

string

Verdadeiro

ID de correlação

string

Falso

invalidFields

array["invalidFields"]

Falso

Lista de campos inválidos no corpo da requisição
Exemplo de resposta 
{
  "type": "https://astra.netapp.io/problems/5",
  "title": "Invalid query parameters",
  "detail": "The supplied query parameters are invalid.",
  "status": "400"
}

Resposta

Status: 409, Conflict
Nome Tipo Obrigatório Descrição

tipo

string

Verdadeiro

título

string

Verdadeiro

detalhe

string

Verdadeiro

status

string

Verdadeiro

ID de correlação

string

Falso

invalidFields

array["invalidFields"]

Falso

Lista de campos inválidos no corpo da requisição
Exemplo de resposta 
{
  "type": "https://astra.netapp.io/problems/10",
  "title": "JSON resource conflict",
  "detail": "The request body JSON contains a field that conflicts with an idempotent value.",
  "status": "409"
}

Resposta

Status: 403, Forbidden
Nome Tipo Obrigatório Descrição

tipo

string

Verdadeiro

título

string

Verdadeiro

detalhe

string

Verdadeiro

status

string

Verdadeiro

ID de correlação

string

Falso
Exemplo de resposta 
{
  "type": "https://astra.netapp.io/problems/11",
  "title": "Operation not permitted",
  "detail": "The requested operation isn't permitted.",
  "status": "403"
}

Erro

Status: 404, Not found
Nome Tipo Obrigatório Descrição

tipo

string

Verdadeiro

título

string

Verdadeiro

detalhe

string

Verdadeiro

status

string

Verdadeiro

ID de correlação

string

Falso
Exemplo de resposta de erro 
{
  "type": "https://astra.netapp.io/problems/1",
  "title": "Resource not found",
  "detail": "The resource specified in the request URI wasn't found.",
  "status": "404"
}

Definições

Ver definições

additionalDetails

type_astra_stateDetail

Nome Tipo Obrigatório Descrição

tipo

string

Verdadeiro

título

string

Verdadeiro

detalhe

string

Verdadeiro

additionalDetails

"additionalDetails"

Falso

tipo_astra_label

Nome Tipo Obrigatório Descrição

nome

string

Verdadeiro

valor

string

Verdadeiro

type_astra_metadados_update

Metadados especificados pelo cliente e pelo serviço associados ao recurso. Os valores definidos são:

  • Está em conformidade com o esquema de metadados Astra. Se não for especificado na atualização, os rótulos do objeto de metadados, creationTimestamp e createdBy, serão preservados sem modificação.

Nome Tipo Obrigatório Descrição

etiquetas

array["tipo_astra_label"]

Falso

CriaçãoTimestamp

string

Falso

Alteração do Timestamp

string

Falso

CreatedBy

string

Falso

modifiedBy

string

Falso

invalidParams

Nome Tipo Obrigatório Descrição

nome

string

Verdadeiro

Nome do parâmetro de consulta inválido

razão

string

Verdadeiro

Motivo pelo qual o parâmetro de consulta é inválido

invalidFields

Nome Tipo Obrigatório Descrição

nome

string

Verdadeiro

Nome do campo inválido no corpo da requisição

razão

string

Verdadeiro

Motivo pelo qual o campo do corpo da solicitação é inválido