Új kereskedelmi előfizetés átváltása

Cikk
02/07/2024

A következőre vonatkozik: Partnerközpont | A 21Vianet által üzemeltetett Partnerközpont | Partnerközpont a Microsoft Cloud for US Government számára

Megfelelő szerepkörök

Globális rendszergazda
Rendszergazdai ügynök

Ezek a módszerek támogatják a hagyományos és az új kereskedelmi forrás előfizetéseket is.

Feljegyzés

A licencalapú szolgáltatások új kereskedelmi felületei számos új képességet tartalmaznak, és minden Felhőszolgáltató (CSP) számára elérhetők. További információkért tekintse meg az új kereskedelmi szolgáltatások áttekintését.

Az ügyfél új kereskedelmi előfizetésének egy cél-előfizetésre való frissítésére vagy az NCE-próbaverzió fizetős előfizetéssé alakítására szolgál. Az előfizetés áttűnéséhez két API-kérést kell megadni. Az első GET jogosult áttűnések a frissítéshez elérhető termékváltozatok beszerzéséhez. Ezután POST áttűnés az áttűnés végrehajtásához.

Áttűnési jogosultságok lekérése

Egy adott ügyfél, előfizetés és kért típus jogosult áttűnések listáját adja vissza. A cél-előfizetés frissítési jogosultságát is visszaadja. Az áttűnési jogosultságok közé tartozhatnak az EndofSaleWithConversions állapotban lévő ajánlatok.

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).
A kezdeti előfizetés előfizetés-azonosítója.

GDAP-szerepkörök

A következő GDAP-szerepkörök közül legalább egyre lesz szüksége:

Címtárolvasó
Globális olvasó

Feljegyzés

Bár ez az API az örökölt és az NCE esetében érhető el, a GDAP csak az örökölt verzióhoz szükséges.

REST-kérés

Kérés szintaxisa

Metódus	Kérés URI-ja
GET	{baseURL}/v1/customers/{customer-tenant-id}/subscriptions/{subscription-id}/transitionEligibilities?eligibilityType={immediate, scheduled} HTTP/1.1

URI-paraméter

A következő lekérdezési paraméterekkel visszaadhatja a jogosult áttűnéseket.

Név	Típus	Kötelező	Leírás
ügyfél-bérlő-azonosító	Guid	I	Az ügyfél bérlőjének megfelelő GUID.
előfizetés-azonosító	Guid	I	A kezdeti előfizetésnek megfelelő GUID.
eligibilityType	húr	N	Az áttűnés végrehajtásának módját ismerteti; lehet azonnali vagy ütemezett. Az alapértelmezett szint a `Immediate`.

Kérésfejlécek

További információ: Partnerközpont – REST fejlécek.

Kérés törzse

Egyik sem

Példa kérése

GET https://api.partnercenter.microsoft.com/v1/customers/{customer-tenant-id}/subscriptions/{subscription-id}/transitionEligibilities?eligibilityType=immediate HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 18752a69-1aa1-4ef7-8f9d-eb3681b2d70a
MS-CorrelationId: 81b08ffe-4cf8-49cd-82db-5c2fb0a8e132
X-Locale: en-US

REST-válasz

Ha ez a módszer sikeres, a válasz törzsében visszaadja az adott előfizetésre vonatkozó jogosult áttűnések listáját.

Válasz sikeresség és hibakódok

Minden válaszhoz tartozik egy HTTP-állapotkód, amely jelzi a sikerességet vagy a hibát, valamint további hibakeresési információkat. A kód, hibatípus és egyéb paraméterek olvasásához használjon hálózati nyomkövetési eszközt. A teljes listát a Hibakódok című témakörben találja.

Jogosultsági hibák

Hibaleírások és jelentés.

Hibaleírás	Értelmezés
Az előfizetés nem váltható át – a forrás-előfizetés nem aktív.	Az eredeti alállapot nem aktív
Az előfizetés nem váltható át – a forrás-előfizetés még nincs kiépítve.	Az eredeti sub FulfillmentState nem sikeres
Az áttűnési típus nem kompatibilis – AzureAD-előfizetés-leképezés szükséges.	LegacyCannotConvertSubscriptionId hiba a GetSubscriptionUpgradeConflicts hívásakor
Az áttűnés típusa nem kompatibilis – a licencátvitelhez ütköző előfizetések léteznek.	Ha bármely Microsoft Entra-szolgáltatás más előfizetésből származó előfizetési azonosítókkal rendelkezik, vegye fel az ütközések listájára (beleértve az örökölt vagy modern vásárlási folyamattal végrehajtott vásárlásokat is)

Előfizetés jogosultsági hibái

Ha egy cél-előfizetés nem jogosult a frissítésre, a rendszer az alábbi okok valamelyikét adja vissza.

A rendszer üres listákat ad vissza, ha a forrás-előfizetés próbaverzió, vagy ha a jogosultságtípus ütemezettként van megadva. Csak azonnali (félidős) áttűnéssel, nem ütemezett módosítással válthat át meglévő előfizetésre.

Hibaleírás	Hibakód
Az előfizetés nem aktív.	SubscriptionNotActive = 1
Az előfizetés a lemondási időszakon belül van.	SubscriptionInCancellationWindow = 2
Az előfizetés időtartama rövidebb, mint a forrás-előfizetés időtartama.	SubscriptionTermDurationShorterthanSourceTermDuration = 3
Az előfizetés lejárati dátuma a forrás-előfizetés lejárati dátuma előtt van.	Az előfizetés lejárati dátuma a forrás-előfizetés lejárati dátuma előtt van. = 4

Példa válaszra

HTTP/1.1 200 OK
Content-Length: 138
Content-Type: application/json
MS-CorrelationId: 81b08ffe-4cf8-49cd-82db-5c2fb0a8e132
MS-RequestId: 18752a69-1aa1-4ef7-8f9d-eb3681b2d70a
Date: Fri, 26 Feb 2021 20:42:26 GMT

{
  "totalCount": 2,
  "items": [
    {
      "operationId": "1caf8ec7-62cc-4ab5-b35d-572d2a62974c",
      "catalogItemId": "CFQ7TTC0KZCR:0001:CFQ7TTC0K71H",
      "title": "Microsoft 365 E5 Test Sku Title",
      "description": "Microsoft 365 E5 Test Sku Description",
      "quantity": 1,
      "subscriptionEligibilities": [
        {
          "isEligible": false,
          "subscriptionId": "92301b7d-7598-4938-d6f2-d31e080e9da6",
          "subscriptionFriendlyName": "Microsoft 365 Business Premium",
          "subscriptionTermDuration": "P1M",
          "subscriptionBillingCycle": "monthly",
          "errors": [
            {
              "code": 3,
              "description": "The subscription's term duration is shorter than the source subscription's term duration."
            }
          ]
        },
        {
          "isEligible": true,
          "subscriptionId": "151467a1-4246-4a00-da7b-3405463d9b78",
          "subscriptionFriendlyName": "Microsoft 365 Business Premium",
          "subscriptionTermDuration": "P1Y",
          "subscriptionBillingCycle": "monthly",
          "errors": []
        }
      ],
      "eligibilities": [
        {
          "isEligible": true,
          "transitionType": "transition_only",
          "errors": []
        },
        {
          "isEligible": false,
          "transitionType": "transition_with_license_transfer",
          "errors": [
            {
              "code": 3,
              "description": "Subscription cannot be transitioned because there are conflicting services."
            }
          ]
        }
      ],
      "attributes": {
        "objectType": "TransitionEligibility"
      }
    },
    {
      "operationId": "1caf8ec7-62cc-4ab5-b35d-572d2a62974c",
      "catalogItemId": "CFQ7TTC0L4M3:0001:CFQ7TTC0K78T",
      "title": "Business Premium Test Sku Title",
      "description": "Business Premium Test Sku Description",
      "quantity": 1,
      "eligibilities": [
        {
          "isEligible": false,
          "transitionType": "transition_with_license_transfer",
          "errors": [
            {
              "code": 3,
              "description": "Subscription cannot be transitioned because there are conflicting services."
            }
          ]
        }
      ],
      "attributes": {
        "objectType": "TransitionEligibility"
      }
    }
  ],
  "attributes": {
    "objectType": "Collection"
  }
}

Áttűnés utáni

Egy adott ügyfél és előfizetés átmeneti kérésének bejegyzése. Az áttűnést a kezdeti állapotával adja vissza.

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).
A kezdeti előfizetés előfizetés-azonosítója.

GDAP-szerepkörök

A következő GDAP-szerepkörök közül legalább egyre lesz szüksége:

Címtárolvasó vagy globális olvasó (csak áttűnés)
Címtáríró (áttűnés licencátvitellel)

Feljegyzés

Bár ez az API az örökölt és az NCE esetében érhető el, a GDAP csak az örökölt verzióhoz szükséges.

REST-kérés

Kérés szintaxisa

Metódus	Kérés URI-ja
POST	{baseURL}/v1/customers/{customer-tenant-id}/subscriptions/{subscription-id}/transitions HTTP/1.1

URI-paraméter

Az áttűnés végrehajtásához használja az alábbi lekérdezési paramétereket.

Név	Típus	Kötelező	Leírás
ügyfél-bérlő-azonosító	Guid	I	Az ügyfél bérlőjének megfelelő GUID.
előfizetés-azonosító	Guid	I	A kezdeti előfizetésnek megfelelő GUID.

Kérésfejlécek

További információ: Partnerközpont – REST fejlécek.

Kérés törzse

Ez a táblázat a kérelem törzsében található áttűnési tulajdonságokat ismerteti.

Tulajdonság	Típus	Kötelező	Leírás
fromCatalogItemId	húr	Nem	A katalóguselem, amelyről áttér.
fromSubscriptionId	húr	Nem	Az előfizetés azonosítója, amelyről áttér.
toCatalogItemId	sztring	Igen	Az áttűnni kívánt katalóguselem.
toSubscriptionId	húr	Nem	Az előfizetés azonosítója, amelybe áttér.
mennyiség	egész szám	Igen	Az áttérni kívánt licencek száma.
termDuration	húr	Nem	Az előfizetés időtartamának megadása.
billingCycle	húr	Nem	Az előfizetés számlázási ciklusának megadása.
transitionType	sztring	Igen	Az áttűnés típusa. Lehetséges értékek – `transition_only`, `transition_with_license_transfer`.

Példa kérése

POST https://api.partnercenter.microsoft.com/v1/customers/{customerId}/subscriptions/{subscriptionId}/transitions HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 18752a69-1aa1-4ef7-8f9d-eb3681b2d70a
MS-CorrelationId: 81b08ffe-4cf8-49cd-82db-5c2fb0a8e132
X-Locale: en-US

{
    "fromCatalogItemId": "CFQ7TTC0LF8Q:0001:CFQ7TTC0K39X",
    "fromSubscriptionId": "e487e8dc-421e-4275-cb42-3c1c8daccf70",
    "toCatalogItemId": "CFQ7TTC0LF8R:0001:CFQ7TTC0KCSV",
    "toSubscriptionId": "0af52192-4a2a-4364-d25b-c8ecab3a5697",
    "quantity": 2,
    "termDuration": "P1M",
    "billingCycle": "Monthly",
    "transitionType": "transition_only"
}

REST-válasz

Ha sikeres, ez a metódus egy átmeneti erőforrást ad vissza a kezdeti állapotával.

Válasz sikeresség és hibakódok

Példa válaszra

HTTP/1.1 200 OK
Content-Length: 138
Content-Type: application/json
MS-CorrelationId: 81b08ffe-4cf8-49cd-82db-5c2fb0a8e132
MS-RequestId: 18752a69-1aa1-4ef7-8f9d-eb3681b2d70a
Date: Fri, 26 Feb 2021 20:42:26 GMT

{
    "fromCatalogItemId": "CFQ7TTC0LF8Q:0001:CFQ7TTC0K39X",
    "fromSubscriptionId": "e487e8dc-421e-4275-cb42-3c1c8daccf70",
    "toCatalogItemId": "CFQ7TTC0LF8R:0001:CFQ7TTC0KCSV",
    "toSubscriptionId": "0af52192-4a2a-4364-d25b-c8ecab3a5697",
    "quantity": 2,
    "termDuration": "P1M",
    "billingCycle": "Monthly",
    "transitionType": "transition_only"
    "Events": [
        {
            "name": "Conversion",
            "status": "Started ",
            "timestamp": "2021-01-08T18:01:14.7488618Z",
            "attributes":
            {
                "objectType": "TransitionEvent"
            }
        }
    ],
    "attributes":
    {
        "objectType": "Transition" 
    }
}

Megosztás a következőn keresztül:

Új kereskedelmi előfizetés átváltása

Áttűnési jogosultságok lekérése

Előfeltételek

GDAP-szerepkörök

REST-kérés

Kérés szintaxisa

URI-paraméter

Kérésfejlécek

Kérés törzse

Példa kérése

REST-válasz

Válasz sikeresség és hibakódok

Jogosultsági hibák

Előfizetés jogosultsági hibái

Példa válaszra

Áttűnés utáni

Előfeltételek

GDAP-szerepkörök

REST-kérés

Kérés szintaxisa

URI-paraméter

Kérésfejlécek

Kérés törzse

Példa kérése

REST-válasz

Válasz sikeresség és hibakódok

Példa válaszra

Visszajelzés

Visszajelzés

További források