Převod nového komerčního předplatného
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
- Globální správce
- 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: 81b08ffe-4cf8-49cd-82db-5c2fb0a8e132
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: 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"
}
}
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: 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"
}
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
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.
Příklad odpovědi
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"
}
}
Váš názor
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu: https://aka.ms/ContentUserFeedback.
Odeslat a zobrazit názory pro