Skip to main content
Astra Automation
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 recurso ASUP

PDFs

POST /accounts/{account_id}/core/v1/asups

Indica os valores desejados para o recurso da API ASUP 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}}

Corpo da solicitação

Indica os valores desejados para o recurso da API ASUP a ser criado.

Nome Tipo Obrigatório Descrição

tipo

string

Verdadeiro

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

  • "application/astra-asup"

versão

string

Verdadeiro

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

  • "1,0"

carregar

string

Verdadeiro

String JSON contendo um valor que indica se o pacote AutoSupport deve ser carregado após a criação bem-sucedida. Os valores definidos são:

  • "verdadeiro" - Carregar o pacote AutoSupport.

  • "falso" - Não faça o upload do AutoSupport bundle.

dataWindowStart

string

Falso

String JSON contendo um timestamp indicando o horário de início da janela de coleta de dados do pacote AutoSupport. O padrão é 24 horas antes do valor da chave "dataWindowEnd". Deve ocorrer antes do valor da chave "dataWindowEnd". O máximo é 7 dias antes do horário atual da solicitação. Os valores definidos são:

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

dataWindowEnd

string

Falso

String JSON contendo um carimbo de data/hora indicando o horário de término da janela de coleta de dados do pacote AutoSupport. O padrão é o horário atual da solicitação. Os valores definidos são:

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

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-asup",
  "version": "1.0",
  "upload": "true"
}

Resposta

Status: 201, Returns the newly created asup 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:

  • "application/astra-asup"

versão

string

Verdadeiro

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

  • "1,0"

id

string

Verdadeiro

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

  • Em conformidade com o esquema UUIDv4

creationState

string

Verdadeiro

String JSON contendo um valor que indica o estado de criação do AutoSupport bundle. Para os estados "concluído" e "parcial", o bundle pode ser baixado realizando uma requisição GET para o URI do recurso com um cabeçalho Accept contendo "/" ou "application/gzip". Os valores definidos são:

  • "running" - AutoSupport a geração de pacotes está ocorrendo normalmente.

  • "Concluído" - a geração do pacote AutoSupport foi concluída.

  • "partial" - AutoSupport a geração do pacote foi concluída, mas alguns dados não foram incluídos no pacote.

  • "failed" - AutoSupport a geração do pacote está em estado de falha permanente.

creationStateDetails

array["type_astra_stateDetail"]

Verdadeiro

Matriz JSON de objetos JSON que lista detalhes adicionais sobre o motivo pelo qual "creationState" foi alterado para "parcial" ou "falhou". Se nenhum detalhe estiver disponível, esta matriz estará vazia.

  • Itens mínimos: 0

carregar

string

Verdadeiro

String JSON contendo um valor que indica se o pacote AutoSupport deve ser carregado após a criação bem-sucedida. Os valores definidos são:

  • "verdadeiro" - Carregar o pacote AutoSupport.

  • "falso" - Não faça o upload do AutoSupport bundle.

uploadState

string

Falso

String JSON contendo um valor que indica o estado do upload do pacote AutoSupport, caso tenha sido solicitado. Os valores definidos são:

  • "pendente" - o upload do pacote AutoSupport está agendado para quando a criação do pacote AutoSupport for concluída ("creationState" está "em execução").

  • "blocked" - AutoSupport o envio do pacote não foi tentado porque o pacote não foi criado ("creationState" é "failed") ou o envio foi bloqueado porque não há licença.

  • "Em execução" - o upload do pacote AutoSupport está sendo executado normalmente ("creationState" está "concluído" ou "parcial").

  • "completed" - AutoSupport o envio do pacote foi finalizado.

  • "Falha" - AutoSupport o envio do pacote está em estado de falha permanente.

uploadStateDetails

array["type_astra_stateDetail"]

Falso

Matriz JSON de objetos JSON que lista detalhes adicionais sobre o motivo pelo qual "uploadState" foi para "falhou". Se nenhum detalhe estiver disponível, esta matriz estará vazia.

  • Itens mínimos: 0

triggerType

string

Verdadeiro

String JSON contendo um valor que indica o que desencadeou a criação do recurso ASUP. Os valores definidos são:

  • "manual" - O recurso ASUP e o pacote AutoSupport associado foram criados manualmente.

  • "Agendado" - O recurso ASUP e o pacote AutoSupport associado foram criados de acordo com um agendamento configurado.

dataWindowStart

string

Verdadeiro

String JSON contendo um timestamp indicando o horário de início da janela de coleta de dados do pacote AutoSupport. O padrão é 24 horas antes do valor da chave "dataWindowEnd". Deve ocorrer antes do valor da chave "dataWindowEnd". O máximo é 7 dias antes do horário atual da solicitação. Os valores definidos são:

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

dataWindowEnd

string

Verdadeiro

String JSON contendo um carimbo de data/hora indicando o horário de término da janela de coleta de dados do pacote AutoSupport. O padrão é o horário atual da solicitação. Os valores definidos são:

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

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-asup",
  "version": "1.0",
  "id": "9950003f-a1c7-5ca7-8930-06eec25f60aa",
  "creationState": "running",
  "creationStateDetails": [],
  "upload": "true",
  "uploadState": "pending",
  "uploadStateDetails": [],
  "triggerType": "manual",
  "dataWindowStart": "2020-08-05T12:24:00.000000Z",
  "dataWindowEnd": "2020-08-06T12:24:52.000000Z",
  "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

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

additionalDetails

type_astra_stateDetail

Nome Tipo Obrigatório Descrição

tipo

string

Verdadeiro

título

string

Verdadeiro

detalhe

string

Verdadeiro

additionalDetails

"additionalDetails"

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