Ottenere date di fine del termine personalizzate

Articolo
02/19/2024

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 allineate alla fine del mese di calendario o che co-term con le sottoscrizioni dei clienti esistenti.

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 descritte in Autenticazione del Centro per i partner. Questo scenario supporta l'autenticazione con le credenziali app autonome e App+Utente.
A CustomerTenantId. Se non si conosce l'ID del cliente, è possibile cercarlo nel 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 del 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 query

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

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

Intestazioni delle richieste

Per altre informazioni, vedi 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 restituire record di pagina aggiuntivi sottoposti a query.

Corpo della richiesta

Nessuno.

Risposta REST

In caso di esito positivo, questo metodo restituisce i dettagli delle sottoscrizioni di cui è stata eseguita la migrazione (oggetto migrazione) nel corpo della risposta. Sono inclusi l'ID migrazione.

Codici di errore e di esito della risposta

Ogni risposta viene fornita con un codice di stato HTTP che ne indica l'esito e con informazioni di debug aggiuntive. Usa uno strumento di traccia di rete per leggere il codice, il tipo di errore e parametri aggiuntivi. Per l'elenco completo, vedi Codici di errore REST del Centro per i partner.

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