Új kereskedelmi migráció létrehozása

A következő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ési folyamata 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özpont -ban, a Ügyfelek munkaterület kiválasztásával, az ügyfelet az ügyféllistából kiválasztva, majd a Fiókkiválasztásával. Az ügyfél Fiók lapján keresse meg a Microsoft-azonosí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ó

Kéréskorlátozás

A Create Migration API korlátja 5 perc alatt 100 hívás egy partnertől. A korlátokról és a torlódásról további információ az API torlódási útmutatójában érhető el.

REST-kérés

Kérés szintaxisa

Módszer	URI kérése
POSTA	{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.

Név	Típus	Szükséges	Leírás
ügyfél-bérlő-azonosító	húr	Igen	Egy GUID formátumú sztring, amely azonosítja az ügyfelet.

Kérelemfejlécek

A további információért lásd a Partnerközpont REST-fejléceirészt.

Kérelem törzsadatai

Ez a táblázat a kérelem törzsében található Előfizetés tulajdonságait ismerteti.

Ingatlan	Típus	Szükséges	Leírás
jelenlegiElőfizetésAzonosító	húr	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.
időtartam	húr	Nem	A időtartam a migráláskor módosítható.
számlázási ciklus	húr	Nem	A számlázási ciklus a migráláskor módosítható.
teljes időtartam vásárlása	Boolean	Nem	A migrálás után új kifejezés indítható el az NCE-ben.
mennyiség	Int	Nem	Az előfizetés licencmennyisége a migráláskor növelhető vagy csökkenthető.
egyéni szerződés lejárati dátuma	dátum és 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 módszer a válasz törzsében migrált előfizetések adatait adja vissza (migrálási objektum).

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 lásd: Partner Center REST-hibakódjai.

Példák válaszra

{
    "addOnMigrations": [
        {
            "currentSubscriptionId": "E3AFD30D-D6E7-45AF-A6C5-FB905992AE00",
            "customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
            "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": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
            "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": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
            "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": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
    "catalogItemId": "CFQ7TTC0LF8Q:0001:CFQ7TTC0KQDF",
    "subscriptionEndDate": "2023-02-22T00:00:00Z",
    "quantity": 1,
    "termDuration": "P1Y",
    "billingCycle": "Monthly",
    "purchaseFullTerm": false
}