Recuperar um recurso ASUP
GET /accounts/{account_id}/core/v1/asups/{asup_id}
Retorna o recurso da API ASUP armazenado no corpo da resposta JSON. Se o pacote AutoSupport "creationState" estiver "completo" ou "parcial", o pacote AutoSupport pode ser baixado especificando um cabeçalho Accept contendo "/" ou "application/gzip".
Parâmetros
| Nome | Tipo | Em | Obrigatório | Descrição |
|---|---|---|---|---|
id_da_conta |
string |
caminho |
Verdadeiro |
ID do recurso de conta que o contém
|
asup_id |
string |
caminho |
Verdadeiro |
ID da coleção asup a ser listada |
Resposta
Status: 200, Returns the stored ASUP API resource in the JSON response body. If the AutoSupport bundle "creationState" is "completed" or "partial", the AutoSupport bundle can be downloaded by specifying an Accept header containing "*/*" or "application/gzip".
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
tipo |
string |
Verdadeiro |
Tipo de mídia do recurso. Os valores definidos são:
|
versão |
string |
Verdadeiro |
Versão do recurso. Os valores definidos são:
|
id |
string |
Verdadeiro |
Identificador globalmente único do recurso. Os valores definidos são:
|
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:
|
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 não houver detalhes disponíveis, essa matriz estará vazia.
|
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:
|
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:
|
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 não houver detalhes disponíveis, essa matriz estará vazia.
|
triggerType |
string |
Verdadeiro |
String JSON contendo um valor que indica o que desencadeou a criação do recurso ASUP. Os valores definidos são:
|
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:
|
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:
|
metadados |
Verdadeiro |
Metadados especificados pelo cliente e pelo serviço associados ao recurso. Os valores definidos são:
|
Exemplo de resposta
{
"type": "application/astra-asup",
"version": "1.0",
"id": "9950003f-a1c7-5ca7-8930-06eec25f60aa",
"creationState": "completed",
"creationStateDetails": [],
"upload": "false",
"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 |
|
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"
}
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 |
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 |