Abonnements einer Organisation auflisten.¶

Methode¶

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

Beschreibung¶

Gibt Abonnementdetails für die angegebene Organisation zurück. Jeder Mandant in der Organisation hat ein eigenes Abonnement. Mit den Abfrageparametern limit und page_token rufen Sie die Ergebnisse seitenweise ab.

Pfadparameter¶

org_id string erforderlich

ID der Organisation, deren Abonnements aufgelistet werden.

Abfrageparameter¶

limit int32

Maximale Anzahl der Elemente pro Seite.

page_token string

Token aus der vorherigen Auflistung (next_page_token), mit dem Sie die Auflistung fortsetzen.

curl

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

Schema der erfolgreichen Antwort (200)¶

object

SubscriptionsPage enthält die Ergebnisse der Abonnementauflistung.

next_page_token string

Token für die nächste Seite. Übergeben Sie diesen Wert in der nächsten Anforderung als page_token. Auf der letzten Seite ist das Token leer.

items array of objects

Liste der Abonnements, die der Anforderung entsprechen.

object

Subscription beschreibt den Status und die Details eines Dienstabonnements.

id string

ID des Abonnements.

status string

Abonnementstatus. Mögliche Werte sind unter anderem trial, trial_expired, active, expired und canceled.

expires date-time

Voraussichtlicher Zeitpunkt, zu dem das Abonnement abläuft oder, falls es aktiv ist, verlängert wird.

tenant_id string

ID des Mandanten, dem das Abonnement zugewiesen ist.

items array of objects

Abonnementpositionen für die durch dieses Abonnement lizenzierten Arten abrechenbarer Einheiten.

object

SubscriptionItem beschreibt die Abonnementdetails für eine bestimmte Art abrechenbarer Einheit (Ressource (Benutzer), Speicher, virtueller Computer, Knoten usw.).

kind string

Art der Abonnementposition (beispielsweise Ressource, Speicher, Knoten, virtueller Computer oder Datenbank).

qty int64

Anzahl lizenzierter Einheiten für diese Art von Abonnementposition (beispielsweise 10 Ressourcen oder 5 zusätzliche Speicherlizenzen mit einem Kontingent von jeweils 100 GB).

auto_license boolean

Gibt an, ob der Dienst die lizenzierte Menge dieser Abonnementposition automatisch an den aktuellen Verbrauch anpasst. Ein Administrator legt diese Einstellung fest.

auto_license_max int64

Höchste Anzahl lizenzierter Einheiten, die die automatische Lizenzanpassung festlegen kann. Ein Administrator legt diese Grenze fest.

quotas array of objects

Kontingentgrenzen, die für den Mandanten mit diesem Abonnement gelten.

object

Quota beschreibt die lizenzierten Grenzen für eine bestimmte Art von Element.

kind string

Art des Elements, für das dieses Kontingent gilt (Ressource (Benutzer), Speicher, virtueller Computer, Knoten usw.).

count int64

Maximal zulässige Anzahl von Einheiten für dieses Element.

units string

Maßeinheit des Kontingents. Bei Ressourcen- oder Knotenkontingenten ist das Feld leer; bei Speicherkontingenten enthält es MB oder GB.

Antwortbeispiel¶

{
  "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"
        }
      ]
    }
  ]
}