Recupera un derecho
GET /accounts/{account_id}/core/v1/entitlements/{entitlement_id}
Devuelve el recurso de la API de Entitlement almacenado en el cuerpo de respuesta JSON.
Parámetros
| Nombre | Tipo | En | Obligatorio | Descripción |
|---|---|---|---|---|
account_id |
cadena |
ruta |
Verdadero |
ID del recurso de cuenta que lo contiene
|
entitlement_id |
cadena |
ruta |
Verdadero |
ID de la colección de derechos a listar |
Respuesta
Status: 200, Returns the stored Entitlement API resource in the JSON 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:
|
asignación |
cadena |
Falso |
Cadena JSON que contiene el ID del objeto al que se asigna el derecho. Solo está presente cuando se asigna el derecho. Contenido de cadena no validado por el esquema. |
producto |
cadena |
Falso |
Cadena JSON que contiene la cadena del producto extraída de la licencia o suscripción. Contenido de cadena no validado por el esquema. |
productVersion |
cadena |
Falso |
Cadena JSON que contiene la cadena de versión extraída de la licencia o suscripción. Contenido de cadena no validado por el esquema. |
entitlementType |
cadena |
Verdadero |
Cadena JSON que contiene el tipo de derecho. Se extrae de la licencia o suscripción. Contenido de cadena no validado por el esquema. |
entitlementValue |
cadena |
Verdadero |
Cadena JSON que contiene la capacidad asociada con el entitlement. Contenido de cadena no validado por el esquema. |
entitlementConsumption |
cadena |
Falso |
Cadena JSON que contiene la cantidad de capacidad asociada con la asignación de derechos que está actualmente en uso. Contenido de cadena no validado por el esquema. |
sourceLicense |
cadena |
Falso |
Cadena JSON que contiene el ID del objeto de licencia del que procede el derecho. Los valores definidos son:
|
sourceSubscription |
cadena |
Falso |
Cadena JSON que contiene el ID del objeto de suscripción del que procede el derecho. Los valores definidos son:
|
validFromTimestamp |
cadena |
Falso |
Cadena JSON que contiene una marca de tiempo que indica cuándo el derecho se vuelve válido. Los valores definidos son:
|
validUntilTimestamp |
cadena |
Falso |
Cadena JSON que contiene una marca de tiempo que indica cuándo deja de ser válido el entitlement. Los valores definidos son:
|
metadatos |
Verdadero |
Metadatos especificados por el cliente y el servicio asociados al recurso. Los valores definidos son:
|
Ejemplo de respuesta
{
"type": "application/astra-entitlement",
"version": "1.0",
"id": "8bdafc19-bde6-5f45-9808-4893c845c9f5",
"product": "Astra SDS",
"productVersion": "1.0",
"entitlementType": "capacity",
"entitlementValue": "2",
"entitlementConsumption": "1",
"sourceLicense": "c8aa757a-5318-489f-8134-a2a1a6956a3e",
"validFromTimestamp": "2020-08-06T00:00:00.000000Z",
"validUntilTimestamp": "2021-08-06T00:00:00.000000Z",
"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 |
array["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"
}
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 |
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 |