Listar suscripciones de la organización.¶

Método¶

GET https://papi.afi.ai/api/v1/orgs/{org_id}/licensing/subscriptions

Descripción¶

Devuelve los detalles de las suscripciones de la organización especificada. Cada inquilino de la organización tiene su propia suscripción. Utilice los parámetros de consulta limit y page_token para paginar los resultados.

Parámetros de ruta¶

org_id string obligatorio

ID de la organización cuyas suscripciones se mostrarán.

Parámetros de consulta¶

limit int32

Número máximo de elementos que se devolverán por página.

page_token string

Token de la operación de listado anterior (`next_page_token`) que se utiliza para continuar el listado.

curl

curl -X GET \
    -H 'Authorization: {api-key}' \
    https://papi.afi.ai/api/v1/orgs/{org_id}/licensing/subscriptions

Esquema de respuesta correcta (200)¶

object

SubscriptionsPage contiene los resultados del listado de suscripciones.

next_page_token string

Token de la página siguiente de la operación de listado. Establezca este valor como `page_token` en la solicitud posterior. Está vacío en la última página.

items array of objects

Lista de suscripciones que coinciden con la solicitud.

object

Subscription describe el estado y los detalles de una suscripción al servicio.

id string

ID de la suscripción.

status string

Estado de la suscripción. Los valores posibles incluyen `trial`, `trial_expired`, `active`, `expired` y `canceled`.

expires date-time

Hora prevista en la que la suscripción caducará o se renovará (para las suscripciones activas).

tenant_id string

ID del inquilino al que está asignada la suscripción.

items array of objects

Elementos de suscripción de las clases de elementos facturables que cubre esta suscripción.

object

SubscriptionItem describe los detalles de la suscripción para un tipo concreto de elemento facturable (recurso (usuario), almacenamiento, máquina virtual, nodo, etc.).

kind string

Tipo de elemento de suscripción (por ejemplo, recurso, almacenamiento, nodo, máquina virtual o base de datos).

qty int64

Número de unidades con licencia del tipo de elemento facturable (por ejemplo, 10 recursos o 5 licencias de almacenamiento adicional, cada una de las cuales concede una cuota de 100 GB).

auto_license boolean

Indica si el servicio ajusta automáticamente este elemento de suscripción en función del consumo actual. Esta opción la configura un administrador.

auto_license_max int64

Cantidad máxima que puede establecer el procedimiento de ajuste automático de licencias. Este límite lo configura un administrador.

quotas array of objects

Límites de cuota que esta suscripción concede al inquilino.

object

Quota describe los límites de licencia de un tipo de elemento concreto.

kind string

Tipo de elemento cubierto por esta cuota (recurso (usuario), almacenamiento, máquina virtual, nodo, etc.).

count int64

Número máximo de unidades permitidas para este elemento.

units string

Unidad de medida utilizada para esta cuota (vacía para las cuotas de recursos o nodos; MB o GB para el almacenamiento).

Ejemplo de respuesta¶

{
  "next_page_token": "string",
  "items": [
    {
      "id": "string",
      "status": "string",
      "expires": "2025-11-19T20:02:49.302263Z",
      "tenant_id": "string",
      "items": [
        {
          "kind": "string",
          "qty": "int64-as-string",
          "auto_license": true,
          "auto_license_max": "int64-as-string"
        }
      ],
      "quotas": [
        {
          "kind": "string",
          "count": "int64-as-string",
          "units": "string"
        }
      ]
    }
  ]
}