Hämta slutdatum för anpassad term

Artikel
02/19/2024

Gäller för: Partnercenter | Partnercenter som drivs av 21Vianet | Partnercenter för Microsoft Cloud for US Government

Partner kan visa tillåtna slutdatum för anpassad term för licensbaserade NCE-prenumerationer som de köper för sina kunder. Partner kan visa slutdatum som överensstämmer med slutet av kalendermånaden eller den samperioden med befintliga kundprenumerationer.

API:er stöder endast beräkningen av anpassade slutdatum för köp av nya prenumerationer och inte för förnyelse av befintliga prenumerationer.

Förutsättningar

Autentiseringsuppgifter enligt beskrivningen i Partnercenter-autentisering. Det här scenariot stöder autentisering med både fristående app- och App+User-autentiseringsuppgifter.
Ett CustomerTenantId. Om du inte känner till kundens ID kan du söka efter det i Partnercenter genom att välja arbetsytan Kunder , sedan kunden från kundlistan och sedan Konto. På kundens kontosida letar du efter Microsoft-ID :t i avsnittet Kundkontoinformation . Microsoft-ID:t är detsamma som kund-ID:t.

REST-begäran

Syntax för begäran

Metod	URI för förfrågan
GET	{baseURL}/v1/customers/{customerId}/subscriptions/customTermEndDates

Frågesträngar

I den här tabellen visas de frågesträngar som behövs för att filtrera och hämta slutdatum för anpassad term.

Namn:	Krav:	Beskrivning:
term_duration	Ja	En ISO 8601-representation av termens varaktighet. Aktuella värden som stöds är P1M (1 månad), P1Y (1 år) och P3Y (3 år).
term_start_date	Nej	Det avsedda inköpsdatumet. Det här kan inte vara i det förflutna.
target_coterm_subscription_id	Nej	En GUID-formaterad sträng som identifierar prenumerationen som ska samtermeras med.

Begärandehuvuden

Mer information finns i REST-huvuden för Partnercenter. Svaret för API:et returnerar högst 300 sidposter. Om över 300 poster returneras i en inmatad fråga, tillhandahålls en fortsättningstoken i svarshuvudet. Fortsättningstoken kan matas in i rubriken för följande begäran för att returnera ytterligare sidposter som efterfrågas.

Begärandetext

Inga.

REST-svar

Om det lyckas returnerar den här metoden information om de prenumerationer som migrerades (migreringsobjekt) i svarstexten. Detta inkluderar migrerings-ID:t.

Svarsframgång och felkoder

Varje svar levereras med en HTTP-statuskod som anger lyckad eller misslyckad och ytterligare felsökningsinformation. Använd ett verktyg för nätverksspårning för att läsa den här koden, feltypen och ytterligare parametrar. Den fullständiga listan finns i Rest-felkoder för Partnercenter.

Exempel på begärande-URL

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

Svarsexempel

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

Dela via