Liste todos os recursos ASUP
GET /accounts/{account_id}/core/v1/asups
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
|
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" |
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: "asup_1.0_get_response_body", array[]] |
Verdadeiro |
|
metadados |
Verdadeiro |
Exemplo de resposta
{
"type": "application/astra-asups",
"version": "1.0",
"items": [
{
"type": "application/astra-asup",
"version": "1.0",
"id": "80796606-79ba-480b-966c-e4c600fbf623",
"creationState": "completed",
"creationStateDetails": [],
"upload": "true",
"uploadState": "running",
"uploadStateDetails": [],
"triggerType": "manual",
"dataWindowStart": "2020-08-05T12:24:00.000000Z",
"dataWindowEnd": "2020-08-06T12:24:52.000000Z",
"metadata": {
"labels": [],
"creationTimestamp": "2020-08-06T12:24:52.256624Z",
"modificationTimestamp": "2020-08-06T12:24:52.256624Z",
"createdBy": "1b32a508-cc6f-4f1b-809f-c42fd91b4848"
}
},
{
"type": "application/astra-asup",
"version": "1.0",
"id": "6503131d-8b36-4434-b34f-73661ae8100b",
"creationState": "completed",
"creationStateDetails": [],
"upload": "true",
"uploadState": "completed",
"uploadStateDetails": [],
"triggerType": "scheduled",
"dataWindowStart": "2020-08-04T13:30:00.000000Z",
"dataWindowEnd": "2020-08-05T13:30:00.000000Z",
"metadata": {
"labels": [],
"creationTimestamp": "2020-08-05T13:30:00.012321Z",
"modificationTimestamp": "2020-08-05T13:30:00.012321Z",
"createdBy": "1b32a508-cc6f-4f1b-809f-c42fd91b4848"
}
}
],
"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 |
asup_1.0_get_response_body
| 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:
|
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 |