Programové vytváření předplatných Azure pomocí starší verze rozhraní API
Tento článek vám pomůže programově vytvářet předplatná Azure pomocí našeho staršího rozhraní API ve verzi Preview. V tomto článku se naučíte, jak programově vytvářet předplatná s využitím Azure Resource Manageru.
Připravili jsme nové články věnované použití nejnovější verze rozhraní API s předplatnými Azure s různými typy smluv:
- Programové vytváření předplatných EA s využitím nejnovějšího rozhraní API
- Programové vytváření předplatných MCA s využitím nejnovějšího rozhraní API
- Programové vytváření předplatných MPA s využitím nejnovějšího rozhraní API
Informace v tomto článku však můžete využít, i když nechcete používat nejnovější verzi rozhraní API.
Zákazníci Azure s fakturačním účtem pro následující typy smluv můžou vytvářet předplatná programově:
- Smlouva Enterprise
- Smlouva se zákazníkem Microsoftu (MCA)
- Smlouva s partnerem Microsoftu
Když vytvoříte předplatné Azure programově, vztahuje se na toto předplatné smlouva, na základě které jste získali služby Azure od Microsoftu nebo autorizovaného prodejce. Další informace najdete v článku Právní informace o Microsoft Azure.
Poznámka:
Při práci s Azure doporučujeme používat modul Azure Az PowerShellu. Začněte tím, že si projdete téma Instalace Azure PowerShellu. Informace o tom, jak migrovat na modul Az PowerShell, najdete v tématu Migrace Azure PowerShellu z AzureRM na Az.
Plány podpory nemůžete vytvářet programově. Nový plán podpory si můžete koupit nebo upgradovat na webu Azure Portal. Přejděte do nápovědy a podpory a pak v horní části stránky vyberte Zvolit správný plán podpory.
Vytváření předplatných pro fakturační účet EA
K vytváření předplatných EA použijte informace v následujících sekcích.
Požadavky
Abyste mohli vytvořit předplatné, musíte mít roli vlastníka registračního účtu nebo musíte být podnikovým Správa istratorem. Existují dva způsoby, jak tuto roli získat:
- Podnikový správce pro vaši registraci vás může nastavit jako vlastníka účtu (vyžaduje se přihlášení) a to z vás udělá vlastníka tohoto registračního účtu.
- Přístup vám může udělit stávající vlastník registračního účtu. Podobně platí, že pokud chcete k vytvoření předplatného EA využít instanční objekt, musíte tomuto instančnímu objektu udělit možnost vytvářet předplatná.
Vyhledání účtů, ke kterým máte přístup
Jakmile jste přidáni k registračnímu účtu přidruženému k vlastníkovi účtu, Azure pomocí tohoto vztahu účet-registrace určí, kam se mají účtovat poplatky za předplatné. Všechna předplatná vytvořená v rámci účtu se fakturují v rámci registrace EA, do níž tento účet patří. Pokud chcete vytvářet předplatná, musíte předat hodnoty týkající se registračního účtu a instančních objektů uživatele, kteří mají být vlastníky těchto předplatných.
Ke spuštění následujících příkazů je potřeba, abyste byli přihlášení k domovskému adresáři vlastníka účtu. V tomto adresáři se ve výchozím nastavení vytvářejí předplatná.
Vyžádejte si výpis všech registračních účtů, ke kterým máte přístup:
GET https://management.azure.com/providers/Microsoft.Billing/enrollmentAccounts?api-version=2018-03-01-preview
V odpovědi rozhraní API se zobrazí všechny registrační účty, ke kterým máte přístup.
{
"value": [
{
"id": "/providers/Microsoft.Billing/enrollmentAccounts/747ddfe5-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"name": "747ddfe5-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"type": "Microsoft.Billing/enrollmentAccounts",
"properties": {
"principalName": "SignUpEngineering@contoso.com"
}
},
{
"id": "/providers/Microsoft.Billing/enrollmentAccounts/4cd2fcf6-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"name": "4cd2fcf6-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"type": "Microsoft.Billing/enrollmentAccounts",
"properties": {
"principalName": "BillingPlatformTeam@contoso.com"
}
}
]
}
K určení účtu, pod kterým se mají předplatná fakturovat, použijte vlastnost principalName. Zkopírujte name tohoto účtu. Pokud například chcete vytvářet předplatná v rámci registračního účtu SignUpEngineering@contoso.com, zkopírujte 747ddfe5-xxxx-xxxx-xxxx-xxxxxxxxxxxx. Tento identifikátor představuje ID objektu registračního účtu. Tuto hodnotu někam vložte, abyste ji mohli použít v dalším kroku jako enrollmentAccountObjectId.
Vytváření předplatných v rámci konkrétního registračního účtu
Následující příklad vytvoří předplatné s názvem Dev Team Subscription v registračním účtu, který jste vybrali v předchozím kroku. Nabídka předplatného je MS-AZR-0017P (běžná smlouva Microsoft Enterprise). Volitelně také pro toto předplatné přidá dva uživatele jako vlastníky Azure RBAC.
Proveďte následující požadavek, ve kterém nahraďte <enrollmentAccountObjectId> hodnotou name, kterou jste zkopírovali v prvním kroku (747ddfe5-xxxx-xxxx-xxxx-xxxxxxxxxxxx). Pokud chcete zadat vlastníky, podívejte se, jak získat ID objektů uživatele.
POST https://management.azure.com/providers/Microsoft.Billing/enrollmentAccounts/<enrollmentAccountObjectId>/providers/Microsoft.Subscription/createSubscription?api-version=2018-03-01-preview
{
"displayName": "Dev Team Subscription",
"offerType": "MS-AZR-0017P",
"owners": [
{
"objectId": "<userObjectId>"
},
{
"objectId": "<servicePrincipalObjectId>"
}
]
}
| Název prvku | Požaduje se | Type | Popis |
|---|---|---|---|
displayName |
No | String | Zobrazovaný název předplatného. Pokud není zadaný, nastaví se na název nabídky, například Microsoft Azure Enterprise. |
offerType |
Ano | String | Nabídka předplatného. Dvě možnosti EA jsou MS-AZR-0017P (produkční použití) a MS-AZR-0148P (vývoj/testování, musí být povolené na webu Azure Portal). |
owners |
No | String | ID objektu libovolného uživatele, který se má přidat jako vlastník Azure RBAC v předplatném při jeho vytvoření. |
V odpovědi se jako součást hlavičky Locationvrátí adresa URL, na které se můžete dotazovat na stav operace vytváření předplatného. Jakmile se vytvoření předplatného dokončí, příkaz GET pro adresu URL Location vrátí objekt subscriptionLink, který obsahuje ID předplatného. Další podrobnosti najdete v dokumentaci k rozhraní API pro předplatné.
Omezení rozhraní API pro vytváření předplatných Azure Enterprise
- Pomocí tohoto rozhraní API se dají vytvářet jenom předplatná Azure Enterprise.
- Pro každý registrační účet platí limit 5 000 předplatných. Další předplatná pro tento účet se potom dají vytvářet jenom na webu Azure Portal. Pokud chcete prostřednictvím tohoto rozhraní API vytvořit více předplatných, vytvořte si další registrační účet. Zrušená, odstraněná a přenesená předplatná se započítávají do limitu 5000.
- Uživatelé, kteří nejsou vlastníky účtu, ale byli do registračního účtu přidáni přes Azure RBAC, nemůžou vytvářet předplatná na webu Azure Portal.
- Tenanta, ve kterém se má předplatné vytvořit, nejde vybrat. Předplatné se vždycky vytvoří v domovském tenantovi vlastníka účtu. Pokud chcete předplatné přesunout do jiného tenanta, projděte si téma věnované změně tenanta předplatného.
Vytváření předplatných pro fakturační účet MCA
V následujících částech najdete informace o vytváření předplatných pro účet MCA.
Požadavky
Abyste mohli vytvářet předplatná, musíte mít roli vlastníka, přispěvatele nebo tvůrce předplatného Azure pro oddíl faktury nebo roli vlastníka nebo přispěvatele pro fakturační profil nebo fakturační účet. Další informace najdete v tématu Role a úlohy fakturace předplatného.
V následujících příkladech se používají rozhraní REST API. PowerShell ani Azure CLI se v současné době nepodporují.
Vyhledání fakturačních účtů, ke kterým máte přístup
Pomocí následujícího požadavku zobrazte seznam všech fakturačních účtů.
GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts?api-version=2019-10-01-preview
V odpovědi rozhraní API se zobrazí všechny fakturační účty, ke kterým máte přístup.
{
"value": [
{
"id": "/providers/Microsoft.Billing/billingAccounts/5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx",
"name": "5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx",
"properties": {
"accountId": "5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"accountStatus": "Active",
"accountType": "Enterprise",
"agreementType": "MicrosoftCustomerAgreement",
"displayName": "Contoso",
"hasReadAccess": true,
"organizationId": "41b29574-xxxx-xxxx-xxxx-xxxxxxxxxxxxx_xxxx-xx-xx"
},
"type": "Microsoft.Billing/billingAccounts"
},
{
"id": "/providers/Microsoft.Billing/billingAccounts/4f89e155-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx",
"name": "4f89e155-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx",
"properties": {
"accountId": "4f89e155-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"accountStatus": "Active",
"accountType": "Enterprise",
"agreementType": "MicrosoftCustomerAgreement",
"displayName": "Fabrikam",
"hasReadAccess": true,
"organizationId": "41b29574-xxxx-xxxx-xxxx-xxxxxxxxxxxxx_xxxx-xx-xx"
},
"type": "Microsoft.Billing/billingAccounts"
}
]
}
Pomocí vlastnosti displayName identifikujte fakturační účet, pro který chcete vytvářet předplatná. Zkontrolujte, jestli má agreementType tohoto účtu hodnotu MicrosoftCustomerAgreement. Zkopírujte name tohoto účtu. Pokud například chcete vytvořit předplatné pro fakturační účet Contoso, zkopírujte 5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx. Tuto hodnotu někam vložte, abyste ji mohli použít v dalším kroku.
Vyhledání oddílů faktur pro vytváření předplatných
V oddílu faktury pro fakturační profil se zobrazí poplatky za vaše předplatné. Pomocí následujícího rozhraní API získáte seznam oddílů faktur a fakturačních profilů, u kterých máte oprávnění k vytváření předplatných Azure.
Proveďte následující požadavek, ve kterém nahraďte <billingAccountName> hodnotou name, kterou jste zkopírovali v prvním kroku (5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx).
POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/<billingAccountName>/listInvoiceSectionsWithCreateSubscriptionPermission?api-version=2019-10-01-preview
V odpovědi rozhraní API se zobrazí všechny oddíly faktur a jejich fakturační profily, u kterých máte přístup pro vytváření předplatných:
{
"value": [{
"billingProfileDisplayName": "Contoso finance",
"billingProfileId": "/providers/Microsoft.Billing/billingAccounts/5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/billingProfiles/PBFV-xxxx-xxx-xxx",
"enabledAzurePlans": [{
"productId": "DZH318Z0BPS6",
"skuId": "0001",
"skuDescription": "Microsoft Azure Plan"
}, {
"productId": "DZH318Z0BPS6",
"skuId": "0002",
"skuDescription": "Microsoft Azure Plan for DevTest"
}],
"invoiceSectionDisplayName": "Development",
"invoiceSectionId": "/providers/Microsoft.Billing/billingAccounts/5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/billingProfiles/PBFV-xxxx-xxx-xxx/invoiceSections/GJ77-xxxx-xxx-xxx"
}, {
"billingProfileDisplayName": "Contoso finance",
"billingProfileId": "/providers/Microsoft.Billing/billingAccounts/5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/billingProfiles/PBFV-xxxx-xxx-xxx",
"enabledAzurePlans": [{
"productId": "DZH318Z0BPS6",
"skuId": "0001",
"skuDescription": "Microsoft Azure Plan"
}, {
"productId": "DZH318Z0BPS6",
"skuId": "0002",
"skuDescription": "Microsoft Azure Plan for DevTest"
}],
"invoiceSectionDisplayName": "Testing",
"invoiceSectionId": "/providers/Microsoft.Billing/billingAccounts/5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/billingProfiles/PBFV-XXXX-XXX-XXX/invoiceSections/GJGR-XXXX-XXX-XXX"
}]
}
Pomocí vlastnosti invoiceSectionDisplayName identifikujte oddíl faktury, pro který chcete vytvářet předplatná. Pro tento oddíl faktury zkopírujte invoiceSectionId, billingProfileId a jednu z hodnot skuId. Pokud například chcete vytvořit předplatné typu Microsoft Azure plan pro oddíl faktury Development, zkopírujte /providers/Microsoft.Billing/billingAccounts/5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_2019-05-31/billingProfiles/PBFV-XXXX-XXX-XXX/invoiceSections/GJGR-XXXX-XXX-XXX, /providers/Microsoft.Billing/billingAccounts/5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_2019-05-31/billingProfiles/PBFV-xxxx-xxx-xxx a 0001. Tyto hodnoty někam vložte, abyste je mohli použít v dalším kroku.
Vytvoření předplatného pro oddíl faktury
Následující příklad vytvoří předplatné s názvem Dev Team Subscription typu plán Microsoft Azure pro oddíl faktury Development. Toto předplatné se účtuje do fakturačního profilu Contoso finance a v příslušné faktuře bude uvedené v oddílu Development.
Proveďte následující požadavek, ve kterém nahradíte <invoiceSectionId> hodnotou invoiceSectionId, kterou jste zkopírovali v druhém kroku (/providers/Microsoft.Billing/billingAccounts/5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_2019-05-31/billingProfiles/PBFV-XXXX-XXX-XXX/invoiceSections/GJGR-XXXX-XXX-XXX). Jako parametry požadavku pro rozhraní API zadejte hodnoty billingProfileId a skuId zkopírované v druhém kroku. Pokud chcete zadat vlastníky, podívejte se, jak získat ID objektů uživatele.
POST https://management.azure.com<invoiceSectionId>/providers/Microsoft.Subscription/createSubscription?api-version=2018-11-01-preview
'{"displayName": "Dev Team subscription",
"billingProfileId": "<billingProfileId>",
"skuId": "<skuId>",
"owners": [
{
"objectId": "<userObjectId>"
},
{
"objectId": "<servicePrincipalObjectId>"
}
],
"costCenter": "35683",
"managementGroupId": "/providers/Microsoft.Management/managementGroups/xxxxxxx",",
}'
| Název prvku | Požaduje se | Type | Popis |
|---|---|---|---|
displayName |
Ano | String | Zobrazovaný název předplatného. |
billingProfileId |
Ano | String | ID fakturačního profilu, na který se účtují poplatky za využití předplatného. |
skuId |
Ano | String | Identifikátor SKU, který určuje typ plánu Azure. |
owners |
No | String | ID objektu libovolného instančního objektu služby nebo uživatele, který chcete přidat jako vlastníka Azure RBAC při vytváření předplatného. |
costCenter |
No | String | Nákladové centrum přidružené k předplatnému. Zobrazuje se v souboru CSV s daty využití. |
managementGroupId |
No | String | ID skupiny pro správu, do které bude toto předplatné přidáno. Pokud chcete získat seznam skupin pro správu, projděte si téma zaměřené na skupiny pro správu – rozhraní API pro zobrazení seznamu. Použijte ID skupiny pro správu z tohoto rozhraní API. |
V odpovědi se vrátí objekt subscriptionCreationResult pro monitorování. Jakmile se vytváření předplatného dokončí, objekt subscriptionCreationResult vrátí objekt subscriptionLink, který obsahuje ID předplatného.
Vytváření předplatných pro fakturační účet MPA
V následujících částech najdete informace o vytváření předplatných pro fakturační účet MPA.
Požadavky
K vytvoření předplatného pro váš fakturační účet musíte mít v účtu poskytovatele cloudového řešení vaší organizace roli globálního správce nebo agenta pro správu. Další informace najdete v tématu Partnerské centrum – přiřazování uživatelských rolí a oprávnění.
V následujících příkladech se používají rozhraní REST API. PowerShell ani Azure CLI se v současné době nepodporují.
Vyhledání fakturačních účtů, ke kterým máte přístup
Pomocí následujícího požadavku zobrazte seznam všech fakturačních účtů, ke kterým máte přístup.
GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts?api-version=2019-10-01-preview
V odpovědi rozhraní API se zobrazí seznam fakturačních účtů.
{
"value": [
{
"id": "/providers/Microsoft.Billing/billingAccounts/99a13315-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx",
"name": "99a13315-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx",
"properties": {
"accountId": "5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"accountStatus": "Active",
"accountType": "Enterprise",
"agreementType": "MicrosoftPartnerAgreement",
"displayName": "Contoso",
"hasReadAccess": true,
"organizationId": "1d100e69-xxxx-xxxx-xxxx-xxxxxxxxxxxxx_xxxx-xx-xx"
},
"type": "Microsoft.Billing/billingAccounts"
},
{
"id": "/providers/Microsoft.Billing/billingAccounts/4f89e155-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx",
"name": "4f89e155-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx",
"properties": {
"accountId": "4f89e155-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"accountStatus": "Active",
"accountType": "Enterprise",
"agreementType": "MicrosoftCustomerAgreement",
"displayName": "Fabrikam",
"hasReadAccess": true,
"organizationId": "1d100e69-xxxx-xxxx-xxxx-xxxxxxxxxxxxx_xxxx-xx-xx"
},
"type": "Microsoft.Billing/billingAccounts"
}
]
}
Pomocí vlastnosti displayName identifikujte fakturační účet, pro který chcete vytvářet předplatná. Zkontrolujte, jestli má agreementType tohoto účtu hodnotu MicrosoftPartnerAgreement. Zkopírujte name tohoto účtu. Pokud například chcete vytvořit předplatné pro fakturační účet Contoso, zkopírujte 99a13315-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx. Tuto hodnotu někam vložte, abyste ji mohli použít v dalším kroku.
Vyhledání zákazníků s plány Azure
Proveďte následující požadavek, ve kterém nahradíte <billingAccountName> hodnotou name, kterou jste zkopírovali v prvním kroku (5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx). Zobrazí se seznam všech zákazníků ve fakturačním účtu, pro které můžete vytvářet předplatná Azure.
GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/<billingAccountName>/customers?api-version=2019-10-01-preview
V odpovědi rozhraní API se zobrazí zákazníci ve fakturačním účtu s plány Azure. Pro tyto zákazníky můžete vytvářet předplatná.
{
"value": [
{
"id": "/providers/Microsoft.Billing/billingAccounts/99a13315-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/customers/2281f543-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"name": "2281f543-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"properties": {
"billingProfileDisplayName": "Contoso USD",
"billingProfileId": "/providers/Microsoft.Billing/billingAccounts/99a13315-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/billingProfiles/JUT6-xxxx-xxxx-xxxx",
"displayName": "Fabrikam toys"
},
"type": "Microsoft.Billing/billingAccounts/customers"
},
{
"id": "/providers/Microsoft.Billing/billingAccounts/99a13315-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/customers/97c3fac4-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"name": "97c3fac4-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"properties": {
"billingProfileDisplayName": "Fabrikam sports",
"billingProfileId": "/providers/Microsoft.Billing/billingAccounts/99a13315-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/billingProfiles/JUT6-xxxx-xxxx-xxxx",
"displayName": "Fabrikam bakery"
},
"type": "Microsoft.Billing/billingAccounts/customers"
}]
}
Pomocí vlastnosti displayName identifikujte zákazníka, pro kterého chcete vytvářet předplatná. Zkopírujte id tohoto zákazníka. Pokud například chcete vytvořit předplatné pro zákazníka Fabrikam toys, zkopírujte /providers/Microsoft.Billing/billingAccounts/99a13315-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/customers/2281f543-xxxx-xxxx-xxxx-xxxxxxxxxxxx. Tuto hodnotu někam vložte, abyste ji mohli použít v dalších krocích.
Volitelné pro nepřímé poskytovatele: Získání prodejců pro zákazníka
Pokud jste nepřímý poskytovatel v dvouúrovňovém modelu CSP, můžete při vytváření předplatných pro zákazníky určit prodejce.
Proveďte následující požadavek, ve kterém nahradíte <customerId> hodnotou id, kterou jste zkopírovali v druhém kroku (/providers/Microsoft.Billing/billingAccounts/99a13315-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/customers/2281f543-xxxx-xxxx-xxxx-xxxxxxxxxxxx). Zobrazí se seznam všech prodejců, kteří jsou pro příslušného zákazníka k dispozici.
GET https://management.azure.com<customerId>?$expand=resellers&api-version=2019-10-01-preview
V odpovědi rozhraní API se zobrazí prodejci pro tohoto zákazníka:
{
"value": [{
"id": "/providers/Microsoft.Billing/billingAccounts/99a13315-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/customers/2ed2c490-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"name": "2ed2c490-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"type": "Microsoft.Billing/billingAccounts/customers",
"properties": {
"displayName": "Fabrikam toys",
"resellers": [
{
"resellerId": "3xxxxx",
"description": "Wingtip"
}
]
}
},
{
"id": "/providers/Microsoft.Billing/billingAccounts/99a13315-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/customers/4ed2c793-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"name": "4ed2c793-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"type": "Microsoft.Billing/billingAccounts/customers",
"properties": {
"displayName": "Fabrikam toys",
"resellers": [
{
"resellerId": "5xxxxx",
"description": "Tailspin"
}
]
}
}]
}
Pomocí vlastnosti description identifikujte prodejce, kterého chcete přidružit k předplatnému. Zkopírujte resellerId tohoto prodejce. Pokud například chcete přidružit prodejce Wingtip, zkopírujte 3xxxxx. Tuto hodnotu někam vložte, abyste ji mohli použít v dalším kroku.
Vytvoření předplatného pro zákazníka
Následující příklad vytvoří předplatné s názvem Dev Team Subscription pro zákazníka Fabrikam toys a přidruží k tomuto předplatnému prodejce Wingtip.
Proveďte následující požadavek, ve kterém nahradíte <customerId> hodnotou id, kterou jste zkopírovali v druhém kroku (/providers/Microsoft.Billing/billingAccounts/99a13315-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/customers/2281f543-xxxx-xxxx-xxxx-xxxxxxxxxxxx). Jako parametry požadavku pro rozhraní API předejte volitelnou hodnotu resellerId zkopírovanou v druhém kroku.
POST https://management.azure.com<customerId>/providers/Microsoft.Subscription/createSubscription?api-version=2018-11-01-preview
'{"displayName": "Dev Team subscription",
"skuId": "0001",
"resellerId": "<resellerId>",
}'
| Název prvku | Požaduje se | Type | Popis |
|---|---|---|---|
displayName |
Ano | String | Zobrazovaný název předplatného. |
skuId |
Ano | String | Identifikátor SKU plánu Azure. Pro předplatná typu plán Microsoft Azure použijte 0001. |
resellerId |
No | String | ID prodejce, který bude přidružený k předplatnému. |
V odpovědi se vrátí objekt subscriptionCreationResult pro monitorování. Jakmile se vytváření předplatného dokončí, objekt subscriptionCreationResult vrátí objekt subscriptionLink. Ten obsahuje ID předplatného.
Další kroky
- Příklad vytvoření předplatného pro smlouvu Enterprise (EA) pomocí rozhraní .NET najdete v ukázkovém kódu na GitHubu.
- Teď když jste vytvořili předplatné, můžete tuto možnost poskytnout dalším uživatelům a instančním objektům. Další informace najdete v tématu Udělení přístupu pro vytváření předplatných Azure Enterprise (Preview).
- Další informace o správě velkého počtu předplatných pomocí skupin pro správu najdete v tématu věnovaném uspořádání prostředků pomocí skupin pro správu v Azure.