Eventi
19 nov, 23 - 21 nov, 23
Scopri i vantaggi più recenti dei partner con i miglioramenti del prodotto per supportare la crescita delle pratiche di intelligenza artificiale in Microsoft Ignite online.
Iscriviti subitoQuesto browser non è più supportato.
Esegui l'aggiornamento a Microsoft Edge per sfruttare i vantaggi di funzionalità più recenti, aggiornamenti della sicurezza e supporto tecnico.
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
Come creare una migrazione di una sottoscrizione a New Commerce Experience
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
Il limite dell'API Di creazione della migrazione è di 100 chiamate da parte di un partner in 5 minuti. Altre informazioni sui limiti di velocità e sulla limitazione delle richieste sono disponibili in Linee guida per la limitazione delle RICHIESTE API.
metodo | URI della richiesta |
---|---|
POST | {baseURL}/v1/customers/{customer-tenant-id}/migrations/new commerce HTTP/1.1 |
Questa tabella elenca i parametri di query necessari per creare una nuova migrazione commerciale.
Nome | Digita | Obbligatorio | Descrizione |
---|---|---|---|
customer-tenant-id | string | Sì | Stringa in formato GUID che identifica il cliente. |
Per altre informazioni, vedi Intestazioni REST del Centro per i partner.
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. |
termDuration | string | No | La durata del termine può essere modificata al momento della migrazione. |
billingCycle | string | No | Il ciclo di fatturazione può essere modificato 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 | È 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 |
Nota, i componenti aggiuntivi annidati (sottoscrizioni di componenti aggiuntivi con sottoscrizioni di componenti aggiuntivi) devono essere scritti nel corpo della richiesta come elenco semplice all'interno di addOnMigrations e non devono essere annidati all'interno di altre sottoscrizioni del componente aggiuntivo nella richiesta; vedere l'ultimo esempio di richiesta per la scrittura dei componenti aggiuntivi nel corpo della richiesta.
{
"currentSubscriptionId" : "9beb6319-6889-4d28-a155-68ca9c783842"
}
{
"currentSubscriptionId": "5C77DC7F-BE2C-4306-A3B5-0EBB4365D7FC",
"termDuration": "P1M",
"billingCycle": "Monthly",
}
{
"currentSubscriptionId": "5C77DC7F-BE2C-4306-A3B5-0EBB4365D7FC",
"purchaseFullTerm": true
}
{
"currentSubscriptionId": "66E738D6-E0BC-4FFB-8818-BDE99BC7008B",
"quantity": 1,
"billingCycle": "Annual",
"purchaseFullTerm": false,
"termDuration": "P1Y",
"addOnMigrations": [
{
"currentSubscriptionId": "359011DC-B5B0-4660-850B-A8FA9B2E3309",
"quantity": 1,
"billingCycle": "Monthly",
"purchaseFullTerm": false,
"termDuration": "P1M"
},
{
"currentSubscriptionId": "159D9F87-CE39-4EBD-B9C2-ECF0892A85A1",
"quantity": 1,
"billingCycle": "Monthly",
"purchaseFullTerm": false,
"termDuration": "P1Y"
}
]
}
In caso di esito positivo, questo metodo restituisce i dettagli delle sottoscrizioni di cui viene eseguita la migrazione (oggetto migrazione) nel corpo 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.
{
"addOnMigrations": [
{
"currentSubscriptionId": "E3AFD30D-D6E7-45AF-A6C5-FB905992AE00",
"customerTenantId": "75c5e79e-7e9f-429f-b772-ed3d38768f7c",
"catalogItemId": "CFQ7TTC0LH0T:0001:CFQ7TTC0K4KQ",
"subscriptionEndDate": "2023-02-22T00:00:00Z",
"quantity": 1,
"termDuration": "P1Y",
"billingCycle": "Monthly",
"purchaseFullTerm": false
},
{
"currentSubscriptionId": "80906BD9-E45C-4D1B-92A8-EA3F3FB6E105",
"customerTenantId": "75c5e79e-7e9f-429f-b772-ed3d38768f7c",
"catalogItemId": "CFQ7TTC0LH0R:0001:CFQ7TTC0K0SK",
"subscriptionEndDate": "2023-02-22T00:00:00Z",
"quantity": 1,
"termDuration": "P1Y",
"billingCycle": "Monthly",
"purchaseFullTerm": false
},
{
"currentSubscriptionId": "72E424F4-10FF-4C76-B101-C274F73BA498",
"customerTenantId": "75c5e79e-7e9f-429f-b772-ed3d38768f7c",
"catalogItemId": "CFQ7TTC0LHXJ:0001:CFQ7TTC0KHTR",
"subscriptionEndDate": "2023-02-22T00:00:00Z",
"quantity": 1,
"termDuration": "P1Y",
"billingCycle": "Monthly",
"purchaseFullTerm": false
}
],
"id": "7123c075-fc05-42d6-a21e-1d2036fa490b",
"startedTime": "2022-02-23T13:00:48.4489832Z",
"currentSubscriptionId": "2E56C7F5-E120-4CA4-BFF3-7DA763B4D777",
"status": "Processing",
"customerTenantId": "75c5e79e-7e9f-429f-b772-ed3d38768f7c",
"catalogItemId": "CFQ7TTC0LF8Q:0001:CFQ7TTC0KQDF",
"subscriptionEndDate": "2023-02-22T00:00:00Z",
"quantity": 1,
"termDuration": "P1Y",
"billingCycle": "Monthly",
"purchaseFullTerm": false
}
Eventi
19 nov, 23 - 21 nov, 23
Scopri i vantaggi più recenti dei partner con i miglioramenti del prodotto per supportare la crescita delle pratiche di intelligenza artificiale in Microsoft Ignite online.
Iscriviti subito