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.

  • Per eseguire una query su una pianificazione specifica
  • Ottenere l'elenco delle pianificazioni per un determinato criterio

Sintassi della richiesta

Metodo URI della 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 della 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 È possibile specificare la durata del termine da modificare al momento della migrazione.
billingCycle string No È possibile specificare il ciclo di fatturazione da modificare al momento della migrazione.
purchaseFullTerm bool No È possibile avviare un nuovo termine in NCE al momento della migrazione.
quantity int No La quantità di licenze per una sottoscrizione può essere aumentata o ridotta al momento della migrazione.
customTermEndDate datetime No Una data di fine può essere impostata in modo da allinearsi a una sottoscrizione onlineServicesNCE esistente o a un mese di calendario esistente. 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 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 risposta

[
{
"id": "f016c025-a873-47af-8b52-2516fbef4c65",
"currentSubscriptionId": "c6105a9c-36cb-4f88-92ea-9573040725c4",
"subscriptionEndDate": "2023-07-19T00:00:00Z",
"status": "Created",
"customerTenantId": "6f297517-16e6-4313-8c6d-4e10496d2871",
"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