Listar todas las características
GET /accounts/{account_id}/core/v1/features
Devuelve una matriz JSON de todos los recursos coincidentes de la colección. Si se especifican campos individuales en la solicitud, la matriz JSON de elementos contendrá los campos solicitados para cada recurso coincidente en el orden especificado.
Parámetros
| Nombre | Tipo | En | Obligatorio | Descripción |
|---|---|---|---|---|
account_id |
cadena |
ruta |
Verdadero |
ID del recurso de cuenta que lo contiene
|
incluya |
cadena |
consulta |
Falso |
Indica qué campos deben devolverse al listar una colección. Ejemplos de URL: "include=id", "include=id,name" Ejemplos OpenAPI: "id" |
límite |
cadena |
consulta |
Falso |
Indica el número máximo de recursos a devolver al listar una colección. Ejemplos de URL: "limit=2" Ejemplos OpenAPI: "2" |
filtro |
cadena |
consulta |
Falso |
Indica qué campos deben coincidir para devolver un recurso al listar una colección. Los operadores admitidos son:
Ejemplo de URL: "filter=field%20eq%20%27value%27" Ejemplos OpenAPI: "field eq 'value'" |
cuente |
cadena |
consulta |
Falso |
Indica si se debe devolver el número total de recursos en el objeto de metadatos. Ejemplos de URL: "count=true" Ejemplos de OpenAPI: "true" |
OrderBy |
cadena |
consulta |
Falso |
Indica el orden de clasificación de los recursos al listar una colección. Ejemplos de URL: "orderBy=name", "orderBy=name%20desc" Ejemplos OpenAPI: "name desc" |
omitir |
cadena |
consulta |
Falso |
Indica el número de recursos que deben omitirse al listar una colección. Ejemplos de URL: "skip=1" Ejemplos OpenAPI: "1" |
Respuesta
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.
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
artículos |
array[Cualquiera de: "feature_1.1_get_response_body", array[]] |
Verdadero |
|
metadatos |
Verdadero |
Ejemplo de respuesta
{
"type": "application/astra-features",
"version": "1.1",
"items": [
{
"type": "application/astra-feature",
"version": "1.0",
"id": "c1d4d2f7-9b30-45a2-9657-8b24f17a4fd1",
"name": "astra.account.rbac",
"isEnabled": "true",
"metadata": {
"labels": [],
"creationTimestamp": "2021-02-19T22:10:22.448274Z",
"modificationTimestamp": "2021-02-19T22:10:22.448274Z",
"createdBy": "c9550bbb-e70b-4578-8504-07397f875bcb"
}
},
{
"type": "application/astra-feature",
"version": "1.0",
"id": "85c693cd-2f89-4944-982a-e885301162bd",
"name": "astra.account.smtp",
"isEnabled": "false",
"metadata": {
"labels": [],
"creationTimestamp": "2021-02-19T22:10:22.448274Z",
"modificationTimestamp": "2021-02-19T22:10:22.448274Z",
"createdBy": "c9550bbb-e70b-4578-8504-07397f875bcb"
}
}
],
"metadata": {
"labels": [],
"creationTimestamp": "2022-10-06T20:58:16.305662Z",
"modificationTimestamp": "2022-10-06T20:58:16.305662Z",
"createdBy": "8f84cf09-8036-51e4-b579-bd30cb07b269"
}
}
Respuesta
Status: 401, Unauthorized
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
tipo |
cadena |
Verdadero |
|
título |
cadena |
Verdadero |
|
detalle |
cadena |
Verdadero |
|
estado |
cadena |
Verdadero |
|
correlationID |
cadena |
Falso |
Ejemplo de respuesta
{
"type": "https://astra.netapp.io/problems/3",
"title": "Missing bearer token",
"detail": "The request is missing the required bearer token.",
"status": "401"
}
Respuesta
Status: 400, Bad request
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
tipo |
cadena |
Verdadero |
|
título |
cadena |
Verdadero |
|
detalle |
cadena |
Verdadero |
|
estado |
cadena |
Verdadero |
|
correlationID |
cadena |
Falso |
|
invalidParams |
matriz["invalidParams"] |
Falso |
Lista de parámetros de consulta no válidos |
Ejemplo de respuesta
{
"type": "https://astra.netapp.io/problems/5",
"title": "Invalid query parameters",
"detail": "The supplied query parameters are invalid.",
"status": "400"
}
Respuesta
Status: 403, Forbidden
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
tipo |
cadena |
Verdadero |
|
título |
cadena |
Verdadero |
|
detalle |
cadena |
Verdadero |
|
estado |
cadena |
Verdadero |
|
correlationID |
cadena |
Falso |
Ejemplo de respuesta
{
"type": "https://astra.netapp.io/problems/11",
"title": "Operation not permitted",
"detail": "The requested operation isn't permitted.",
"status": "403"
}
Respuesta
Status: 503, Service unavailable
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
tipo |
cadena |
Verdadero |
|
título |
cadena |
Verdadero |
|
detalle |
cadena |
Verdadero |
|
estado |
cadena |
Verdadero |
|
correlationID |
cadena |
Falso |
Ejemplo de respuesta
{
"type": "https://astra.netapp.io/problems/41",
"title": "Service not ready",
"detail": "Currently, the service can't respond to this request.",
"status": "503"
}
Error
Status: 404, Not found
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
tipo |
cadena |
Verdadero |
|
título |
cadena |
Verdadero |
|
detalle |
cadena |
Verdadero |
|
estado |
cadena |
Verdadero |
|
correlationID |
cadena |
Falso |
Ejemplo de respuesta de error
{
"type": "https://astra.netapp.io/problems/2",
"title": "Collection not found",
"detail": "The collection specified in the request URI wasn't found.",
"status": "404"
}
Definiciones
Ver definiciones
etiqueta_tipo_astra
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
nombre |
cadena |
Verdadero |
|
valor |
cadena |
Verdadero |
tipo_astra_metadatos
Metadatos especificados por el cliente y el servicio asociados al recurso. Los valores definidos son:
-
Cumple con el esquema de metadatos Astra
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
etiquetas |
array["etiqueta_tipo_astra"] |
Verdadero |
|
CreationTimestamp |
cadena |
Verdadero |
|
Modificación.Marca de hora |
cadena |
Verdadero |
|
CreatedBy |
cadena |
Verdadero |
|
modifiedBy |
cadena |
Falso |
feature_1.1_get_response_body
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
tipo |
cadena |
Verdadero |
Tipo de medio del recurso. Los valores definidos son:
|
versión |
cadena |
Verdadero |
Versión del recurso. Los valores definidos son:
|
id |
cadena |
Verdadero |
Identificador único global del recurso. Los valores definidos son:
|
nombre |
cadena |
Verdadero |
Cadena JSON que contiene un nombre para la característica, en notación jerárquica de puntos. Los valores definidos son:
|
isEnabled |
cadena |
Verdadero |
Cadena JSON que contiene un valor que indica si el indicador de función está activado o desactivado. Los valores definidos son:
|
metadatos |
Verdadero |
Metadatos especificados por el cliente y el servicio asociados al recurso. Los valores definidos son:
|
type_astra_metadata_list
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
continuar |
cadena |
Falso |
|
cuente |
número |
Falso |
|
etiquetas |
array["etiqueta_tipo_astra"] |
Falso |
|
CreationTimestamp |
cadena |
Falso |
|
Modificación.Marca de hora |
cadena |
Falso |
|
CreatedBy |
cadena |
Falso |
|
modifiedBy |
cadena |
Falso |
invalidParams
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
nombre |
cadena |
Verdadero |
Nombre del parámetro de consulta no válido |
motivo |
cadena |
Verdadero |
Razón por la que el parámetro de consulta no es válido |