Abonnements auflisten
Namespace: microsoft.graph
Ruft die Liste der kommerziellen Abonnements ab, die eine Organisation erworben hat.
Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.
Globaler Dienst | US Government L4 | US Government L5 (DOD) | China, betrieben von 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
Berechtigungen
Wählen Sie für diese API die Als am wenigsten privilegierten Berechtigungen gekennzeichneten Berechtigungen aus. Verwenden Sie nur dann eine Berechtigung mit höheren Berechtigungen , wenn dies für Ihre App erforderlich ist. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.
Berechtigungstyp | Berechtigungen mit den geringsten Berechtigungen | Berechtigungen mit höheren Berechtigungen |
---|---|---|
Delegiert (Geschäfts-, Schul- oder Unikonto) | Organization.Read.All | Directory.Read.All |
Delegiert (persönliches Microsoft-Konto) | Nicht unterstützt | Nicht unterstützt |
Anwendung | Organization.Read.All | Directory.Read.All, Organization.ReadWrite.All |
HTTP-Anforderung
GET /directory/subscriptions
Optionale Abfrageparameter
Diese Methode unterstützt die OData-Abfrageparameter zur Anpassung der Antwort.
Anforderungsheader
Name | Beschreibung |
---|---|
Authorization | Bearer {token}. Erforderlich. Erfahren Sie mehr über die Authentifizierung und Autorisierung. |
Anforderungstext
Geben Sie keinen Anforderungstext für diese Methode an.
Antwort
Wenn die Methode erfolgreich verläuft, werden der 200 OK
Antwortcode und eine Auflistung von companySubscription-Objekten im Antworttext zurückgegeben.
Beispiel
Anforderung
Das folgende Beispiel zeigt eine Anfrage.
GET https://graph.microsoft.com/v1.0/directory/subscriptions
Antwort
Das folgende Beispiel zeigt die Antwort.
Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.
HTTP/1.1 200 OK
Content-type: application/json
{
"value": [
{
"createdDateTime": "2023-01-01T00:00:00Z",
"commerceSubscriptionId": "f9c1ea2d-2c6e-4717-8c3b-7130812d70ba",
"id": "860697e3-b0aa-4196-a6c6-7ec361ed58f7",
"isTrial": false,
"nextLifecycleDateTime": "2023-02-01T00:00:00Z",
"serviceStatus": [
{
"appliesTo": "User",
"provisioningStatus": "Success",
"servicePlanId": "8b8269e5-f841-416c-ab3a-f5dfb9737986",
"servicePlanName": "MyPlanName"
}
],
"skuId": "0816ccb9-3785-4d19-bf78-6c53e2106509",
"skuPartNumber": "MyPartNumber",
"status": "Enabled",
"totalLicenses": 25,
"ownerId": "fe04f19f-d924-42b7-9dee-edf4e3fab7f6",
"ownerTenantId": "331af819-4e0b-49f7-a6bf-14e1165ad3a0",
"ownerType": "User"
}
]
}