Abrufen von benutzerdefinierten Endterminen

Artikel
02/19/2024

Gilt für: Partner Center | Partner Center-Betrieb durch 21Vianet | Partner Center für Microsoft Cloud for US Government

Partner können zulässige endtermine für NCE-lizenzbasierte Abonnements anzeigen, die sie für ihre Kunden kaufen. Partner können Enddaten anzeigen, die am Ende des Kalendermonats oder der gemeinsamen Laufzeit mit vorhandenen Kundenabonnements ausgerichtet sind.

APIs unterstützen nur die Berechnung von benutzerdefinierten Endterminen für den Kauf neuer Abonnements und nicht für die Verlängerung vorhandener Abonnements.

Voraussetzungen

Anmeldeinformationen, wie unter Partner Center-Authentifizierung beschrieben. Dieses Szenario unterstützt die Authentifizierung mit eigenständigen App- und App+Benutzeranmeldeinformationen.
Eine CustomerTenantId. Wenn Sie die KUNDEN-ID nicht kennen, können Sie sie im Partner Center nachschlagen, indem Sie den Arbeitsbereich "Kunden " und dann den Kunden aus der Kundenliste und dann "Konto" auswählen. Suchen Sie auf der Seite "Konto" des Kunden im Abschnitt "Kundenkontoinformationen" nach der Microsoft-ID. Die Microsoft-ID ist identisch mit der Kunden-ID.

REST-Anforderung

Anforderungssyntax

Methode	Anforderungs-URI
GET	{baseURL}/v1/customers/{customerId}/subscriptions/customTermEndDates

Abfragezeichenfolgen

In dieser Tabelle sind die Abfragezeichenfolgen aufgeführt, die zum Filtern und Abrufen von benutzerdefinierten Endterminen für Ausdrücke erforderlich sind.

Name:	Erforderlich:	Beschreibung:
term_duration	Ja	Eine ISO 8601-Darstellung der Dauer des Begriffs. Die aktuellen unterstützten Werte sind P1M (1 Monat), P1Y (1 Jahr) und P3Y (3 Jahre).
term_start_date	Nein	Das beabsichtigte Kaufdatum. Dies kann in der Vergangenheit nicht geschehen.
target_coterm_subscription_id	Nein	Eine GUID-formatierte Zeichenfolge, mit der das Abonnement identifiziert wird, mit dem er kotermiert.

Anforderungsheader

Weitere Informationen finden Sie unter Partner Center-REST-Header. Die Antwort der API gibt maximal 300 Seitendatensätze zurück. Wenn in einer eingegebenen Abfrage mehr als 300 Datensätze zurückgegeben werden, wird ein Fortsetzungstoken im Antwortheader bereitgestellt. Das Fortsetzungstoken kann in der Kopfzeile einer folgenden Anforderung eingegeben werden, um zusätzliche Seitendatensätze zurückzugeben, die abgefragt werden.

Anforderungstext

Keine.

REST-Antwort

Wenn die Methode erfolgreich verläuft, werden Details der Abonnements zurückgegeben, die migriert wurden (Migrationsobjekt) im Antworttext. Dies schließt die Migrations-ID ein.

Erfolgs- und Fehlercodes der Antwort

Jede Antwort enthält einen HTTP-Statuscode, der Aufschluss darüber gibt, ob der Vorgang erfolgreich war, sowie ggf. zusätzliche Debuginformationen. Verwende ein Tool für die Netzwerkablaufverfolgung, um diesen Code, den Fehlertyp und zusätzliche Parameter zu lesen. Die vollständige Liste finden Sie unter Partner Center-REST-Fehlercodes.

Beispiele für Anforderungs-URL

baseurl/v1/customers/94cd6638-11b6-4323-8c9f-6ae3088adc59/subscriptions/customTermEndDates?term_duration=P1M

Beispielantworten

 {
    "totalCount": 2,
    "items": [
        {
            "allowedCustomTermEndDateType": "calendarMonthAligned",
            "allowedCustomTermEndDate": "2023-07-31T00:00:00"
        },
        {
            "allowedCustomTermEndDateType": "subscriptionAligned",
            "cotermSubscriptionIds": [
               "5fcf618b-1daa-4604-da99-cc3e1c9ee422",
               "d30a9ff9-713e-4546-c97e-f06b9dcf6ef6"
            ],
            "allowedCustomTermEndDate": "2023-08-01T00:00:00"
        }
    ],
    "links": {
        "self": {
            "uri": "/customers/94cd6638-11b6-4323-8c9f-6ae3088adc59/subscriptions/customTermEndDates?term_duration=P1M",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "objectType": "Collection"
    }
 }

Freigeben über