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.

Liste os backups do aplicativo para um app

PDFs

GET /accounts/{account_id}/k8s/v1/apps/{app_id}/appBackups

Retorna uma matriz JSON com todos os recursos correspondentes na coleção. Se campos individuais forem especificados na solicitação, a matriz JSON de itens conterá os campos solicitados para cada recurso correspondente na ordem especificada.

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}}

app_id

string

caminho

Verdadeiro

ID do recurso do aplicativo que o contém

incluir

string

consulta

Falso

Indica quais campos devem ser retornados ao listar uma coleção.

Exemplos de URL: "include=id", "include=id,name"

Exemplos OpenAPI: "id"

  • exemplo: id, nome, estado

limite

string

consulta

Falso

Indica o número máximo de recursos a serem retornados ao listar uma coleção.

Exemplos de URL: "limit=2"

Exemplos OpenAPI: "2"

Resposta

Status: 200, Returns a JSON array of all matching resources in the collection. If individual fields are specified in the request, the items JSON array will contain the fields requested for each matching resource in the order specified.
Nome Tipo Obrigatório Descrição

itens

array[Qualquer um de: "appBackup_1.2_get_response_body", array[]]

Verdadeiro

metadados

"type_astra_metadata_list"

Verdadeiro
Exemplo de resposta 
{
  "type": "application/astra-appBackups",
  "version": "1.2",
  "items": [
    [
      "5cb608f9-571b-492e-a520-5bfb900a9b9c",
      "app-name-245",
      "pending"
    ],
    [
      "f8faa690-7e09-48a4-b33c-7965712acd0c",
      "app-name-244",
      "completed"
    ]
  ],
  "metadata": {
    "labels": [],
    "creationTimestamp": "2022-10-06T20:58:16.305662Z",
    "modificationTimestamp": "2022-10-06T20:58:16.305662Z",
    "createdBy": "8f84cf09-8036-51e4-b579-bd30cb07b269"
  }
}

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

invalidParams

array["invalidParams"]

Falso

Lista de parâmetros de consulta inválidos
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: 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"
}

Resposta

Status: 500, Internal server error
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/96",
  "title": "Backups not listed",
  "detail": "The backups didn't list because of an internal server issue.",
  "status": "500"
}

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/2",
  "title": "Collection not found",
  "detail": "The collection specified in the request URI wasn't found.",
  "status": "404"
}

Definições

Ver definições

type_astra_stateDetail

Nome Tipo Obrigatório Descrição

tipo

string

Verdadeiro

título

string

Verdadeiro

detalhe

string

Verdadeiro

tipo_astra_label

Nome Tipo Obrigatório Descrição

nome

string

Verdadeiro

valor

string

Verdadeiro

tipo_metadados_astra

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 criação, um objeto de metadados será criado sem rótulos.

Nome Tipo Obrigatório Descrição

etiquetas

array["tipo_astra_label"]

Verdadeiro

CriaçãoTimestamp

string

Verdadeiro

Alteração do Timestamp

string

Verdadeiro

CreatedBy

string

Verdadeiro

modifiedBy

string

Falso

appBackup_1.2_get_response_body

Nome Tipo Obrigatório Descrição

tipo

string

Verdadeiro

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

  • "aplicação/astra-appBackup"

versão

string

Verdadeiro

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

  • "1,0"

  • "1,1"

  • "1,2"

id

string

Verdadeiro

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

  • Em conformidade com o esquema UUIDv4

nome

string

Verdadeiro

String JSON contendo um nome especificado pelo usuário para o backup. Se não for especificado, ou quando backups forem iniciados por um agendamento, o sistema atribui um nome para o backup. Os valores definidos são:

  • Comprimento mínimo: 1

  • Comprimento máximo: 63

  • Em conformidade com o esquema de rótulos DNS 1123

bucketID

string

Verdadeiro

String JSON contendo um ID de bucket opcional que indica onde o backup será armazenado na criação. Se não for especificado, um bucket selecionado pelo sistema será usado. Se nenhum bucket estiver disponível, um erro será retornado na criação. Os valores definidos são:

  • Conforme o esquema de identificador Astra

ID do Snapshot

string

Falso

String JSON contendo o snapshot usado para criar o backup. Para criar o backup, um ID de snapshot associado ao aplicativo que está sendo copiado pode ser especificado no momento da criação. Se não for especificado, um novo snapshot será criado para o backup. Os valores definidos são:

  • Conforme o esquema de identificador Astra

ID do agendamento

string

Falso

String JSON contendo um ID de agendamento opcional que indica que o backup foi acionado por um agendamento e qual agendamento acionou o backup. Presente apenas para backups iniciados por um agendamento. Os valores definidos são:

  • Conforme o esquema de identificador Astra

estado

string

Verdadeiro

String JSON contendo um valor que indica o estado operacional do backup. Os valores definidos são:

  • "Pendente" - O backup do aplicativo está agendado para descoberta

  • "Descobrindo" - O backup do aplicativo está em processo de descoberta

  • "Em execução" - O backup do aplicativo está sendo executado normalmente

  • "Concluído" - O backup do aplicativo foi concluído com sucesso

  • "Falha" - O backup do aplicativo está em estado de falha permanente

  • "Removido" - O backup do aplicativo não está acessível no momento

  • "Desconhecido" - Não foi possível determinar o estado do backup do aplicativo

stateUnready

array[string]

Verdadeiro

Matriz JSON de strings JSON, cada uma indicando um motivo pelo qual um backup de aplicativo não consegue passar para o estado "em execução", ou por que passou para o estado "falhou" ou "removido". Os valores definidos são:

  • Comprimento mínimo: 1

  • Comprimento máximo: 127

hookState

string

Falso

String JSON contendo um valor que indica o estado de quaisquer hooks de execução executados como parte de um snapshot. Os valores definidos são:

  • "failed" - Um ou mais ganchos de execução falharam

  • "Sucesso" - Havia zero ou mais ganchos aplicáveis e todos foram bem-sucedidos

hookStateDetails

array["type_astra_stateDetail"]

Falso

Matriz JSON de objetos JSON que lista detalhes adicionais sobre o motivo pelo qual "hookState" foi transferido para "falhou". Se não houver detalhes disponíveis, essa matriz estará vazia.

  • Itens mínimos: 0

backupCreationTimestamp

string

Falso

String JSON contendo um registro de data e hora indicando quando o backup foi realizado. Os valores definidos são:

  • Em conformidade com o esquema de data e hora ISO-8601

totalBytes

número

Falso

Número JSON contendo o número total de bytes no backup.

bytesDone

número

Falso

Número JSON contendo o número de bytes copiados para um backup em andamento. Quando o backup for concluído, ele corresponderá ao campo totalBytes.

percentDone

número

Falso

Número JSON contendo a porcentagem de conclusão de um backup em andamento. Quando o backup é concluído, ele é definido como "100".

metadados

"tipo_metadados_astra"

Verdadeiro

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 criação, um objeto de metadados será criado sem rótulos.

type_astra_metadata_list

Nome Tipo Obrigatório Descrição

continuar

string

Falso

contar

número

Falso

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