Condividi tramite

Ottenere una nuova pianificazione della migrazione commerciale

  • Articolo

Si applica a: Centro partner | Centro partner gestito da 21Vianet | Centro partner per Microsoft Cloud per il Governo degli Stati Uniti

Questo articolo descrive come ottenere una nuova pianificazione della migrazione commerciale.

Importante

Questa API è attualmente disponibile solo nel tenant sandbox.

Prerequisiti

  • Credenziali descritte in Autenticazione del Centro per i partner. Questo scenario supporta l'autenticazione con le credenziali App standalone e App+Utente.

  • ID cliente (customer-tenant-id). 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 dell'account del cliente cerca l'ID Microsoft nella sezione Info account del cliente. L'ID Microsoft corrisponde all'ID del cliente (customer-tenant-id).

  • ID della sottoscrizione corrente

Richiesta REST

Esistono due modi diversi in cui i partner possono interrogare.

  • I partner possono fare una richiesta per ottenere una pianificazione specifica.
  • I partner possono eseguire query per ottenere l'elenco delle pianificazioni per criteri specifici

Sintassi della richiesta

Metodo URI delle richiesta
GET {baseURL}/v1/customers/{customer-tenant-id}/migrations/newcommerce/schedules/{scheduleID}

Parametro URI

Questa tabella elenca i parametri di query necessari per creare una nuova migrazione commerciale.

Nome Tipo Obbligatorio Descrizione
ID-tenant-del-cliente string Sì Stringa in formato GUID che identifica il cliente.
Metodo URI delle richiesta
GET {baseURL}/v1/migrations/newcommerce/schedules?CustomerTenantId={customer-tenant-id}

Parametro URI

Questa tabella elenca i parametri di query necessari per creare una nuova migrazione commerciale. È possibile usare qualsiasi parametro di query.

Nome Tipo Descrizione
customerTenantId string Stringa in formato GUID che identifica il cliente.
currentSubscriptionID string Stringa in formato GUID che identifica l'ID sottoscrizione corrente
ID di riferimento esterno string Stringa in formato GUID che identifica il batch di migrazione

Intestazioni delle richieste

Per ulteriori informazioni, vedi Intestazioni REST del Centro per i partner.

Corpo della risposta

Questa tabella descrive le proprietà della sottoscrizione nella risposta.

Proprietà Tipo Obbligatorio Descrizione
IDAbbonamentoCorrente string Sì Identificatore di sottoscrizione che indica quale sottoscrizione richiede la convalida per la migrazione.
durata del termine string No Durata del termine applicata alla migrazione.
ciclo di fatturazione string No Ciclo di fatturazione applicato alla migrazione.
acquisto dell'intero periodo bool No Indica se la migrazione avvia o meno un nuovo periodo.
quantità int No La quantità di licenze per una sottoscrizione può essere aumentata o ridotta al momento della migrazione.
data di fine del termine personalizzato data e ora No È possibile impostare una data di fine per allinearsi a una sottoscrizione esistente di OnlineServicesNCE non di prova o a un mese di calendario. Altre informazioni sull'allineamento delle date di fine della sottoscrizione sono disponibili qui: Allineare le date di fine della sottoscrizione nel Centro per i partner
targetDate data e ora No Data di destinazione quando pianificare la migrazione.
migrare al rinnovo bool No Indica se la pianificazione deve essere eseguita al rinnovo
stato string No Stato della migrazione del programma
Ora di creazione data e ora No Quando è stata creata la pianificazione
oraUltimaModifica data e ora No Data dell'ultima modifica della pianificazione

Risposta REST

In caso di esito positivo, questo metodo restituisce i dettagli delle sottoscrizioni di cui viene eseguita la migrazione (oggetto migrazione) nel corpo della risposta.

Codici di errore e di esito della risposta

Ogni risposta viene fornita con un codice di stato HTTP che indica l'esito positivo o negativo con ulteriori informazioni di debug. Usare uno strumento di traccia di rete per leggere questo codice, il tipo di errore e altri parametri. Per l'elenco completo, vedi Codici di errore REST del Centro per i partner.

Esempi di risposta

[
{
"id": "f016c025-a873-47af-8b52-2516fbef4c65",
"currentSubscriptionId": "c6105a9c-36cb-4f88-92ea-9573040725c4",
"subscriptionEndDate": "2023-07-19T00:00:00Z",
"status": "Created",
"customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
"quantity": 25,
"termDuration": "P1Y",
"billingCycle": "Monthly",
"purchaseFullTerm": false,
"targetDate": "2022-10-30T00:00:00",
"createdTime": "2022-10-18T21:20:50.9668605+00:00",
"lastModifiedTime": "2022-10-18T21:29:32.8992819+00:00"
}
]

Vedi anche