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 besitzt ein eigenes Abonnement. Mit den Abfrageparametern limit und page_token können Sie die Ergebnisse seitenweise durchlaufen.

Pfadparameter¶

org_id string erforderlich

ID der Organisation, deren Abonnements aufgelistet werden sollen.

Abfrageparameter¶

limit int32

Maximale Anzahl der pro Seite zurückzugebenden Elemente.

page_token string

Token aus dem vorherigen Listenaufruf (`next_page_token`), mit dem die Auflistung fortgesetzt wird.

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 der Auflistung. Legen Sie diesen Wert in der nachfolgenden Anfrage als `page_token` fest. Auf der letzten Seite ist er leer.

items array of objects

Liste der Abonnements, die der Anfrage entsprechen.

object

Subscription beschreibt den Status und die Details eines Dienstabonnements.

id string

ID des Abonnements.

status string

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

expires date-time

Voraussichtlicher Zeitpunkt, zu dem das Abonnement abläuft oder verlängert wird (bei aktiven Abonnements).

tenant_id string

ID des Mandanten, dem das Abonnement zugewiesen ist.

items array of objects

Abonnementpositionen für die durch dieses Abonnement lizenzierten abrechenbaren Positionsklassen.

object

SubscriptionItem beschreibt Abonnementdetails für eine bestimmte Art abrechenbarer Positionen (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 die abrechenbare Positionsart (beispielsweise 10 Ressourcen oder 5 zusätzliche Speicherlizenzen mit jeweils 100 GB Kontingent).

auto_license boolean

Gibt an, ob der Dienst diese Abonnementposition anhand des aktuellen Verbrauchs automatisch anpasst. Diese Einstellung wird von einem Administrator konfiguriert.

auto_license_max int64

Maximale Menge, die durch die automatische Lizenzanpassung festgelegt werden kann. Diese Grenze wird von einem Administrator konfiguriert.

quotas array of objects

Kontingentgrenzen, die dieses Abonnement dem Mandanten gewährt.

object

Quota beschreibt die lizenzierten Grenzen für eine bestimmte Positionsart.

kind string

Art der durch dieses Kontingent abgedeckten Position (Ressource (Benutzer), Speicher, virtueller Computer, Knoten usw.).

count int64

Maximal zulässige Anzahl von Einheiten für diese Position.

units string

Für dieses Kontingent verwendete Maßeinheit (leer bei Ressourcen-/Knotenkontingenten; MB oder GB bei Speicher).

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