Aggiornare una nuova pianificazione della migrazione commerciale
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 aggiornare una nuova pianificazione della migrazione commerciale. I partner possono eseguire l'aggiornamento prima della data di destinazione pianificata.
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
Sintassi della richiesta
| Metodo | URI delle richiesta |
|---|---|
| PUT | {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. |
| scheduleID | string | Sì | Stringa in formato GUID che ha identificato la pianificazione |
Intestazioni delle richieste
Per altre informazioni, vedi Intestazioni REST del Centro per i partner.
Testo della richiesta
Questa tabella descrive le proprietà della sottoscrizione nel corpo della richiesta.
| Proprietà | Type | Obbligatorio | Descrizione |
|---|---|---|---|
| currentSubscriptionId | string | Sì | Identificatore di sottoscrizione che indica quale sottoscrizione richiede la convalida per la migrazione. Non consentito per l'operazione di aggiornamento. |
| termDuration | string | No | Durata del periodo per la migrazione. |
| billingCycle | string | No | Ciclo di fatturazione per la migrazione. |
| purchaseFullTerm | bool | No | Indica se la migrazione continua il termine legacy corrente o ne avvia una nuova. |
| 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. Se targetDate è impostato per la data specificata, migrationOnRenewal può essere impostato su null o false. |
| migrateOnRenewal | bool | No | Se il flag è impostato su true per migrateOnRenewal, non è necessario specificare targetDate per pianificare una migrazione. |
Esempio di richiesta
{
"id": "f016c025-a873-47af-8b52-2516fbef4c65",
"currentSubscriptionId": "c6105a9c-36cb-4f88-92ea-9573040725c4",
"status": "Created",
"customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
"quantity": 25,
"termDuration": "P1Y",
"billingCycle": "Monthly",
"purchaseFullTerm": false,
"targetDate": "2022-10-30T00:00:00"
}
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 e informazioni di debug aggiuntive. 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"
}