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.

Criar um novo Snapshot de aplicativo para um app

PDFs

POST /accounts/{account_id}/k8s/v1/apps/{app_id}/appSnaps

Indica os valores desejados para o recurso da API de Snapshot de Aplicativo a ser criado.

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

Corpo da solicitação

Indica os valores desejados para o recurso da API de Snapshot de Aplicativo a ser criado.

Nome Tipo Obrigatório Descrição

tipo

string

Verdadeiro

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

  • "aplicação/astra-appSnap"

versão

string

Verdadeiro

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

  • "1,0"

  • "1,1"

  • "1,2"

nome

string

Falso

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

  • Comprimento mínimo: 1

  • Comprimento máximo: 63

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

metadados

"tipo_metadados_astra"

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 criação, um objeto de metadados será criado sem rótulos.
Exemplo de solicitação 
{
  "type": "application/astra-appSnap",
  "version": "1.2",
  "name": "app-name-245"
}

Resposta

Status: 201, Returns the newly created appSnap resource in the JSON 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-appSnap"

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 Snapshot. Se não for especificado, ou quando Snapshots forem iniciados por um agendamento, o sistema atribui um nome para o Snapshot. Os valores definidos são:

  • Comprimento mínimo: 1

  • Comprimento máximo: 63

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

ID do agendamento

string

Falso

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

  • Conforme o esquema de identificador Astra

snapshotAppAsset

string

Falso

String JSON contendo o ID do recurso do aplicativo correspondente ao snapshot. Este campo será retornado quando o estado do snapshot do aplicativo for "completed". 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 snapshot. Os valores definidos são:

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

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

  • "Em execução" - O Snapshot do aplicativo está em execução normalmente

  • "Concluído" - O Snapshot do aplicativo foi concluído

  • "failed" - O Snapshot do aplicativo está em estado de falha permanente

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

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

stateUnready

array[string]

Verdadeiro

Matriz JSON de strings JSON, cada uma indicando um motivo pelo qual um snapshot de aplicativo não consegue passar para o estado "em execução" ou pelo qual passou para o estado "com falha". 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 qualquer gancho de execução ou ganchos em execução 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

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.
Exemplo de resposta 
{
  "type": "application/astra-appSnap",
  "version": "1.2",
  "id": "4f56a1df-8f47-541a-bd81-77260053a2f6",
  "name": "app-name-245",
  "scheduleID": "1fe83650-9b3c-41ef-bb25-a2910c19c33e",
  "state": "pending",
  "stateUnready": [],
  "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

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

Definições

Ver definições

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

type_astra_stateDetail

Nome Tipo Obrigatório Descrição

tipo

string

Verdadeiro

título

string

Verdadeiro

detalhe

string

Verdadeiro

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