Ottenere date di fine del termine personalizzate

Articolo
03/07/2025

si applica a: Centro per i partner | Centro per i partner gestito da 21Vianet | Centro per i partner per Microsoft Cloud per il governo degli Stati Uniti

I partner possono visualizzare le date di fine del termine personalizzate consentite per le sottoscrizioni basate su licenza NCE che acquistano per i clienti. I partner possono visualizzare le date di fine che coincidono con la fine del mese di calendario o che si allineano con le sottoscrizioni esistenti dei clienti.

Le API supportano solo il calcolo delle date di fine del termine personalizzate per l'acquisto di nuove sottoscrizioni e non per il rinnovo delle sottoscrizioni esistenti.

Prerequisiti

Credenziali come descritte nell'autenticazione di Partner Center . Questo scenario supporta l'autenticazione con le credenziali App autonome e App+Utente.
Un CustomerTenantId. Se non si conosce l'ID del cliente, è possibile cercarlo in Centro per i partner selezionando l'area di lavoro clienti, quindi il cliente dall'elenco dei clienti, quindi Account. Nella pagina Account del cliente, cercare l'ID Microsoft nella sezione Informazioni sull'account cliente. L'ID Microsoft corrisponde all'ID cliente.

Richiesta REST

Sintassi della richiesta

Metodo	URI della richiesta
GET	{baseURL}/v1/customers/{customerId}/subscriptions/customTermEndDates

Stringhe di interrogazione

Questa tabella elenca le stringhe di query necessarie per filtrare e recuperare le date di fine del termine personalizzate.

Nome:	Obbligatorio:	Descrizione:
Durata del termine	Sì	Rappresentazione ISO 8601 della durata del termine. I valori supportati correnti sono P1M (1 mese), P1Y (1 anno) e P3Y (3 anni).
data_inizio_periodo	No	Data di acquisto prevista. Questo non può essere in passato.
identificativo_sottoscrizione_coterminata_target	No	Stringa in formato GUID che identifica la sottoscrizione per il coterm.

Intestazioni della richiesta

Per ulteriori informazioni, consultare intestazioni REST del Centro per i partner. La risposta dell'API restituisce un massimo di 300 record di pagina. Se in una query immessa vengono restituiti più di 300 record, nell'intestazione della risposta viene fornito un token di continuazione. Il token di continuazione può essere immesso nell'intestazione di una richiesta seguente per recuperare ulteriori record di pagina risultanti dalla query.

Corpo della richiesta

Nessuno.

Risposta REST

In caso di esito positivo, questo metodo restituisce i dettagli degli abbonamenti che sono stati migrati (oggetto di migrazione) nel corpo della risposta. Sono inclusi l'ID migrazione.

Codici di errore e esito positivo della risposta

Ogni risposta viene fornita con un codice di stato HTTP che indica l'esito positivo o negativo e altre informazioni di debug. Usare uno strumento di traccia di rete per leggere il codice, il tipo di errore e i parametri aggiuntivi. Per l'elenco completo, vedere REST codici di errore del Partner Center.

Esempi di URL di richiesta

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

Esempi di risposta

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

Condividi tramite