Condividi tramite

Ottenere una nuova pianificazione della migrazione commerciale

  • Articolo

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

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 autonome 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 sottoscrizione corrente

Richiesta REST

Esistono due modi diversi in cui i partner possono eseguire query.

  • I partner possono eseguire query 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/new commerce/schedules/{scheduleID}

Parametro URI

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

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

Parametro URI

Questa tabella elenca i parametri di query necessari per creare una nuova migrazione commerciale. È possibile usare chiunque del 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
externalReferenceID string Stringa in formato GUID che identifica il batch di migrazione

Intestazioni delle richieste

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

Corpo della risposta

Questa tabella descrive le proprietà della sottoscrizione nella risposta.

Proprietà Type Obbligatorio Descrizione
currentSubscriptionId string Sì Identificatore di sottoscrizione che indica quale sottoscrizione richiede la convalida per la migrazione.
termDuration string No Durata del termine applicata alla migrazione.
billingCycle string No Ciclo di fatturazione applicato alla migrazione.
purchaseFullTerm bool No Indica se la migrazione avvia o meno un nuovo termine.
quantity int No La quantità di licenze per una sottoscrizione può essere aumentata o ridotta al momento della migrazione.
customTermEndDate datetime No È possibile impostare una data di fine per allinearsi a una sottoscrizione onlineservicesNCE esistente 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 datetime No Data di destinazione quando pianificare la migrazione.
migrateOnRenewal bool No Indica se la pianificazione deve essere eseguita al rinnovo
stato string No Stato della migrazione della pianificazione
createdTime datetime No Quando è stata creata la pianificazione
lastModifiedTime datetime 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