Hämta slutdatum för anpassad term

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