Create a new commerce migration
A következőre vonatkozik: Partnerközpont | A 21Vianet által üzemeltetett Partnerközpont | Partnerközpont a Microsoft Cloud for US Government számára
Előfizetés új kereskedelmi felületre történő migrálásának létrehozása
Előfeltételek
Hitelesítő adatok a Partnerközpont hitelesítésében leírtak szerint. Ez a forgatókönyv támogatja az önálló alkalmazással és az App+Felhasználói hitelesítő adatokkal való hitelesítést is.
Ügyfélazonosító (
customer-tenant-id
). Ha nem ismeri az ügyfél azonosítóját, megkeresheti a Partnerközpontban az Ügyfelek munkaterület kiválasztásával, majd az ügyféllistából, majd a Fiók listában. Az ügyfél Fiók lapján keresse meg a Microsoft-azonosítót az Ügyfélfiók adatai szakaszban. A Microsoft-azonosító megegyezik az ügyfél-azonosítóval (customer-tenant-id
).Egy aktuális előfizetés-azonosító
Sebességkorlát
A Migrálási API-korlát 5 perc alatt 100 hívást fogad egy partnertől. A sebességkorlátokról és a szabályozásról az API szabályozási útmutatójában talál további információt.
REST-kérés
Kérés szintaxisa
Method | Kérés URI-ja |
---|---|
POST | {baseURL}/v1/customers/{customer-tenant-id}/migrations/newcommerce HTTP/1.1 |
URI-paraméter
Ez a táblázat felsorolja az új kereskedelmi migrálás létrehozásához szükséges lekérdezési paramétereket.
Name | Type | Kötelező | Leírás |
---|---|---|---|
ügyfél-bérlő-azonosító | sztring | Igen | Egy GUID formátumú sztring, amely azonosítja az ügyfelet. |
Kérelemfejlécek
További információ: Partnerközpont – REST fejlécek.
A kérés törzse
Ez a táblázat a kérelem törzsében található előfizetési tulajdonságokat ismerteti.
Tulajdonság | Type | Kötelező | Leírás |
---|---|---|---|
currentSubscriptionId | sztring | Igen | Egy előfizetés-azonosító, amely jelzi, hogy melyik előfizetéshez van szükség a migrálás ellenőrzésére. |
termDuration | karakterlánc | Nem | A időtartam a migráláskor módosítható. |
billingCycle | karakterlánc | Nem | A számlázási ciklus a migráláskor módosítható. |
purchaseFullTerm | logikai | Nem | A migrálás után új kifejezés indítható el az NCE-ben. |
mennyiség | egész | Nem | Az előfizetés licencmennyisége a migráláskor növelhető vagy csökkenthető. |
customTermEndDate | dátum/idő | Nem | A befejezési dátumok beállíthatók úgy, hogy egy meglévő, nemtriális OnlineServicesNCE-előfizetéshez vagy naptári hónaphoz igazodjanak. Az előfizetés záró dátumainak igazításáról itt talál további információt: Az előfizetés záró dátumainak igazítása a Partnerközpontban |
Példa kérése
Vegye figyelembe, hogy a beágyazott bővítményeket (bővítmény-előfizetésekkel rendelkező bővítmény-előfizetéseket) az addOnMigrations szolgáltatáson belüli egyszerű listaként kell megírni a kérelem törzsében, és nem ágyazhatók be a kérelem más bővítmény-előfizetéseibe; tekintse meg az utolsó kérési példát, amely bemutatja, hogyan írhatók meg a bővítmények a kérelem törzsében.
{
"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"
}
]
}
REST-válasz
Ha sikeres, ez a metódus a válasz törzsében az áttelepített előfizetések (migrálási objektum) részleteit adja vissza.
Válasz sikeresség és hibakódok
Minden válaszhoz tartozik egy HTTP-állapotkód, amely jelzi a sikert vagy a hibát, valamint további hibakeresési információkat. Ezt a kódot, hibatípust és egyéb paramétereket egy hálózati nyomkövetési eszközzel olvashatja el. A teljes listát a Partnerközpont REST-hibakódjaiban találja.
Példák válaszra
{
"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
}
Visszajelzés
https://aka.ms/ContentUserFeedback.
Hamarosan elérhető: 2024-ben fokozatosan kivezetjük a GitHub-problémákat a tartalom visszajelzési mechanizmusaként, és lecseréljük egy új visszajelzési rendszerre. További információ:Visszajelzés küldése és megtekintése a következőhöz: