Freigeben über

Abrufen von benutzerdefinierten Endterminen

anwendbar auf: Partnerzentrum | Partnerzentrum betrieben von 21Vianet | Partnerzentrum für die Microsoft-Cloud für die US-Regierung

Partner können zulässige benutzerdefinierte Enddaten für NCE-Lizenzabonnements anzeigen, die sie für ihre Kunden erwerben. Partner können Enddaten anzeigen, die mit dem Ende des Kalendermonats übereinstimmen oder mit bestehenden Kundenabonnements übereinstimmen.

APIs unterstützen nur die Berechnung von benutzerdefinierten Laufzeitenddaten 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 auswählen, dann den Kunden aus der Kundenliste und anschließend Konto. Suchen Sie auf der Kontoseite des Kunden im Abschnitt Kundenkontoinfo nach der Microsoft-ID. Die Microsoft-ID ist identisch mit der Kunden-ID.

REST-Anforderung

Anforderungssyntax

Methode Anforderungs-URI
ERHALTEN {baseURL}/v1/kunden/{customerId}/Abonnements/customTermEndDates

Abfrage-Zeichenfolgen

In dieser Tabelle sind die Abfragezeichenfolgen aufgeführt, die zum Filtern und Abrufen von benutzerdefinierten Enddaten von Begriffen erforderlich sind.

Name: Erforderlich: Beschreibung:
term_duration Ja Eine ISO 8601-Darstellung der Dauer des Begriffs. Die aktuell unterstützten Werte sind P1M (1 Monat), P1Y (1 Jahr) und P3Y (3 Jahre).
term_start_date Nein Das vorgesehene Kaufdatum. Das kann nicht in der Vergangenheit sein.
target_coterm_subscription_id Nein Eine GUID-formatierte Zeichenfolge, die das Abonnement identifiziert, mit dem Coterm verwendet werden soll.

Hinweis

Laufzeitdauern von P1M oder monatlichen Laufzeiten, die an die API übergeben werden, geben gemeinsame Laufzeitergebnisse zurück, die möglicherweise nicht zur Laufzeitausrichtung verwendet werden können. Monatliche Ausrichtungen können nicht mit einem Abonnement verwendet werden, das am 28., 29. oder 30. des Monats endet, es sei denn, dieses Datum ist der letzte Tag des Monats.

Anforderungsheader

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

Anfragekörper

Keiner.

REST-Antwort

Bei erfolgreicher Ausführung gibt diese Methode Details zu den Abonnements zurück, die im Antworttext migriert wurden (Migrationsobjekt). Dazu gehört auch die Migrations-ID.

Antworterfolgs- und Fehlercodes

Jede Antwort enthält einen HTTP-Statuscode, der Erfolg oder Fehler sowie zusätzliche Debuginformationen angibt. 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-URLs

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"​
    }​
 }
  • Last updated on