Převod nového komerčního předplatného

Článek
09/25/2024

Platí pro: Partnerské centrum | Partnerské centrum provozované společností 21Vianet | Partnerské centrum pro Microsoft Cloud pro státní správu USA

Odpovídající role

Agent pro správu

Tyto metody podporují tradiční i nová předplatná komerčního zdroje.

Poznámka:

Nové komerční prostředí pro služby založené na licencích zahrnuje mnoho nových funkcí a jsou k dispozici pro všechny poskytovatele cloudových řešení (CSP). Další informace najdete v přehledu nových obchodních prostředí.

Používá se k upgradu nového komerčního předplatného zákazníka na cílové předplatné nebo převod zkušební verze NCE na placené předplatné. Aby bylo možné převést předplatné, je potřeba provést dva požadavky rozhraní API. První přechody opravňující k získání skladových položek GET, které jsou k dispozici pro upgrade Pak proveďte přechod POST.

Získání eligibility přechodu

Vrátí seznam způsobilých přechodů pro daného zákazníka, předplatné a požadovaný typ. Vrátí také nárok na upgrade cílového předplatného. Mezi eligibility přechodu můžou patřit nabídky, které jsou ve stavu EndofSaleWithConversions.

Požadavky

Přihlašovací údaje popsané v ověřování v Partnerském centru Tento scénář podporuje ověřování pomocí samostatných přihlašovacích údajů aplikace i aplikace a uživatele.
ID zákazníka (customer-tenant-id). Pokud neznáte ID zákazníka, můžete ho vyhledat v Partnerském centru tak , že vyberete pracovní prostor Zákazníci , pak zákazník ze seznamu zákazníků a pak účet. Na stránce Účet zákazníka vyhledejte ID Microsoftu v části Informace o účtu zákazníka. ID Microsoftu je stejné jako ID zákazníka (customer-tenant-id).
ID předplatného pro počáteční předplatné.

Role GDAP

Budete potřebovat alespoň jednu z následujících rolí GDAP:

Čtenář adresáře
Globální čtenář

Poznámka:

I když je toto rozhraní API dostupné pro starší verzi a NCE, GDAP se vyžaduje jenom pro starší verzi.

Požadavek REST

Syntaxe požadavku

metoda	Identifikátor URI žádosti
GET	{baseURL}/v1/customers/{customer-tenant-id}/subscriptions/{subscription-id}/transitionEligibilities?eligibilityType={immediate, scheduled} HTTP/1.1

Parametr identifikátoru URI

K vrácení oprávněných přechodů použijte následující parametry dotazu.

Name	Type	Požadováno	Popis
customer-tenant-id	identifikátor guid	Y	Identifikátor GUID odpovídající tenantovi zákazníka.
id předplatného	identifikátor guid	Y	Identifikátor GUID odpovídající počátečnímu předplatnému.
eligibilityType	string	N	Popisuje, kdy má být přechod proveden; může být okamžité nebo naplánované. Výchozí hodnota je `Immediate`.

Záhlaví žádosti

Další informace najdete v tématu Hlavičky REST Partnerského centra.

Text požadavku

Nic

Příklad požadavku

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: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US

Odpověď REST

Pokud je tato metoda úspěšná, vrátí seznam způsobilých přechodů pro dané předplatné v textu odpovědi.

Kódy úspěšnosti a chyb odpovědi

Každá odpověď obsahuje stavový kód HTTP, který indikuje úspěch nebo selhání a další informace o ladění. Ke čtení tohoto kódu, typu chyby a dalších parametrů použijte nástroj pro trasování sítě. Úplný seznam najdete v tématu Kódy chyb.

Chyby způsobilosti

Popisy chyb a význam

Popis chyby	Význam
Předplatné nejde přecházet – zdrojové předplatné není aktivní.	Původní dílčí stav není aktivní
Předplatné nejde přecházet – zdrojové předplatné ještě není zřízené.	Původní dílčí stav plnění není úspěšný.
Typ přechodu není kompatibilní – vyžaduje se mapování předplatného AzureAD.	Chyba LegacyCannotConvertSubscriptionId při volání GetSubscriptionUpgradeConflicts
Typ přechodu není kompatibilní – existují konfliktní předplatná pro převod licencí.	Pokud některá služba Microsoft Entra obsahuje ID předplatných z jiného předplatného, přidejte ho do seznamu konfliktů (včetně nákupů provedených pomocí starší verze nebo moderního toku nákupu).

Chyby způsobilosti předplatného

Pokud cílové předplatné nemá nárok na upgrade, vrátí se jeden z následujících důvodů.

Prázdné seznamy budou vráceny, pokud je zdrojovým předplatným zkušební verze nebo pokud je typ způsobilosti zadaný jako naplánovaný. Do stávajícího předplatného můžete přejít pouze s okamžitým přechodem (označovaným také jako "midterm"), nikoli na plánovanou změnu.

Popis chyby	Kód chyby
Předplatné není aktivní.	SubscriptionNotActive = 1
Předplatné je v okně zrušení.	SubscriptionInCancellationWindow = 2
Doba trvání předplatného je kratší než doba trvání zdrojového předplatného.	SubscriptionTermDurationShorterThanSourceTermDuration = 3
Koncové datum předplatného je před koncovým datem koncového období zdrojového předplatného.	Koncové datum předplatného je před koncovým datem koncového období zdrojového předplatného. = 4

Příklad odpovědi

HTTP/1.1 200 OK
Content-Length: 138
Content-Type: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
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": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
          "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": "bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f",
          "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"
  }
}

Po přechodu

Publikuje žádost o přechod pro daného zákazníka a předplatné. Vrátí přechod s počátečním stavem.

Požadavky

Přihlašovací údaje popsané v ověřování v Partnerském centru Tento scénář podporuje ověřování pomocí samostatných přihlašovacích údajů aplikace i aplikace a uživatele.
ID zákazníka (customer-tenant-id). Pokud neznáte ID zákazníka, můžete ho vyhledat v Partnerském centru tak , že vyberete pracovní prostor Zákazníci , pak zákazník ze seznamu zákazníků a pak účet. Na stránce Účet zákazníka vyhledejte ID Microsoftu v části Informace o účtu zákazníka. ID Microsoftu je stejné jako ID zákazníka (customer-tenant-id).
ID předplatného pro počáteční předplatné.

Role GDAP

Budete potřebovat alespoň jednu z následujících rolí GDAP:

Čtenář adresářů nebo globální čtenář (pouze přechod)
Directory Writer (přechod s převodem licencí)

Poznámka:

I když je toto rozhraní API dostupné pro starší verzi a NCE, GDAP se vyžaduje jenom pro starší verzi.

Požadavek REST

Syntaxe požadavku

metoda	Identifikátor URI žádosti
POST	{baseURL}/v1/customers/{customer-tenant-id}/subscriptions/{subscription-id}/transitions HTTP/1.1

Parametr identifikátoru URI

K provedení přechodu použijte následující parametry dotazu.

Name	Type	Požadováno	Popis
customer-tenant-id	identifikátor guid	Y	Identifikátor GUID odpovídající tenantovi zákazníka.
id předplatného	identifikátor guid	Y	Identifikátor GUID odpovídající počátečnímu předplatnému.

Záhlaví žádosti

Další informace najdete v tématu Hlavičky REST Partnerského centra.

Text požadavku

Tato tabulka popisuje vlastnosti přechodu v textu požadavku.

Vlastnost	Typ	Požadováno	Popis
fromCatalogItemId	string	No	Položka katalogu, ze které přecházíte.
fromSubscriptionId	string	No	ID předplatného, ze které přecházíte.
toCatalogItemId	string	Ano	Položka katalogu, na kterou přecházíte.
toSubscriptionId	string	No	ID předplatného, na které přecházíte.
množství.	integer	Ano	Počet licencí, které se mají převést.
termDuration	string	No	Určuje dobu trvání předplatného.
billingCycle	string	No	Určuje fakturační cyklus předplatného.
transitionType	string	Ano	Typ přechodu. Možné hodnoty - `transition_only`, `transition_with_license_transfer`.

Příklad požadavku

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: aaaa0000-bb11-2222-33cc-444444dddddd
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"
}

Odpověď REST

V případě úspěchu vrátí tato metoda prostředek Transition s počátečním stavem.

Kódy úspěšnosti a chyb odpovědi

Příklad odpovědi

HTTP/1.1 200 OK
Content-Length: 138
Content-Type: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
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" 
    }
}

Sdílet prostřednictvím

Převod nového komerčního předplatného

Získání eligibility přechodu

Požadavky

Role GDAP

Požadavek REST

Syntaxe požadavku

Parametr identifikátoru URI

Záhlaví žádosti

Text požadavku

Příklad požadavku

Odpověď REST

Kódy úspěšnosti a chyb odpovědi

Chyby způsobilosti

Chyby způsobilosti předplatného

Příklad odpovědi

Po přechodu

Požadavky

Role GDAP

Požadavek REST

Syntaxe požadavku

Parametr identifikátoru URI

Záhlaví žádosti

Text požadavku

Příklad požadavku

Odpověď REST

Kódy úspěšnosti a chyb odpovědi

Příklad odpovědi

Váš názor

Další materiály