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 for US Government

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 cliente (customer-tenant-id).

  • ID sottoscrizione corrente

Richiesta REST

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

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

Sintassi della richiesta

Metodo URI 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 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 chiunque del parametro di query.

Nome Tipo Descrizione
customerTenantId string Stringa in formato GUID che identifica il cliente.
currentSubscriptionID string Stringa con formattazione GUID che identifica l'ID sottoscrizione corrente
externalReferenceID string Stringa formattata GUID che identifica il batch di migrazione

Intestazioni della richiesta

Per altre 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
currentSubscriptionId string Sì Identificatore di sottoscrizione che indica quale sottoscrizione richiede la convalida per la migrazione.
termDuration string No La durata del termine può essere specificata per essere modificata al momento della migrazione.
billingCycle string No Il ciclo di fatturazione può essere specificato per essere modificato al momento della migrazione.
purchaseFullTerm bool No Un nuovo termine può essere avviato in NCE al momento della migrazione.
quantity int No La quantità di licenza per una sottoscrizione può essere aumentata o ridotta alla migrazione.
customTermEndDate Datetime No È possibile impostare una data di fine per allinearsi a una sottoscrizione onlineservicesNCE non di valutazione esistente o a un mese di calendario. Qui sono disponibili altre informazioni sull'allineamento delle date di fine sottoscrizione: 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 verificarsi al rinnovo
status 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