Sdílet prostřednictvím

Programové vytváření předplatných Azure pomocí starší verze rozhraní API

  • Článek

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:

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 na Nápověda a podpora 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

Chcete-li vytvořit předplatné, musíte mít u registračního účtu roli vlastníka nebo být podnikovým správcem. Existují dva způsoby, jak tuto roli získat:

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/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
      "name": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
      "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 aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e. 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 (aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb). 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.
  • Platí limit 5 000 předplatných na jeden registrační účet. 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/bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx",
      "name": "bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx",
      "properties": {
        "accountId": "bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f",
        "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 bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f: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 (bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f: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/bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f: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/bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f: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/bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f: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/bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f: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/bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_2019-05-31/billingProfiles/PBFV-XXXX-XXX-XXX/invoiceSections/GJGR-XXXX-XXX-XXX, /providers/Microsoft.Billing/billingAccounts/bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f: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/bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f: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

Abyste mohli vytvořit předplatné pro fakturační účet, musíte mít v účtu Cloud Solution Provider vaší organizace roli 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/cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx",
      "name": "cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx",
      "properties": {
        "accountId": "bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f",
        "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 cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a: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 (bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f: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/cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/customers/dddd3d3d-ee4e-ff5f-aa6a-bbbbbb7b7b7b",
      "name": "dddd3d3d-ee4e-ff5f-aa6a-bbbbbb7b7b7b",
      "properties": {
        "billingProfileDisplayName": "Contoso USD",
        "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a: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/cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a: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/cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a: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/cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/customers/dddd3d3d-ee4e-ff5f-aa6a-bbbbbb7b7b7b. 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/cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/customers/dddd3d3d-ee4e-ff5f-aa6a-bbbbbb7b7b7b). 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/cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a: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/cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a: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/cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/customers/dddd3d3d-ee4e-ff5f-aa6a-bbbbbb7b7b7b). 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