你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

通过旧 API 以编程方式创建 Azure 订阅

项目
02/14/2024

本文可帮助你使用旧版预览 API 以编程方式创建 Azure 订阅。本文介绍如何使用 Azure 资源管理器以编程方式创建订阅。

我们有新文章来讲解用于不同 Azure 协议订阅类型的最新 API 版本：

但是，如果不想使用最新 API 版本，仍可使用本文中的信息。

具有以下协议类型的计费帐户的 Azure 客户可以以编程方式创建订阅：

企业协议
Microsoft 客户协议 (MCA)
Microsoft 合作伙伴协议 (MPA)

以编程方式创建 Azure 订阅时，该订阅受你从 Microsoft 或授权经销商处获取 Azure 服务时所签署协议的约束。有关详细信息，请参阅 Microsoft Azure 法律信息。

注意

建议使用 Azure Az PowerShell 模块与 Azure 交互。请参阅安装 Azure PowerShell 以开始使用。若要了解如何迁移到 Az PowerShell 模块，请参阅将 Azure PowerShell 从 AzureRM 迁移到 Az。

无法以编程方式创建支持计划。可以在 Azure 门户中购买新的支持计划或升级一个。导航到“帮助 + 支持”，然后在页面顶部选择“选择正确的支持计划”。

为 EA 计费帐户创建订阅

使用以下各部分中的信息创建 EA 订阅。

先决条件

必须在注册帐户上具有所有者角色或是企业管理员才能创建订阅。可通过两种方式获取角色：

注册的企业管理员可以将你设为帐户所有者（需要登录），这使得你成为注册帐户的所有者。
注册帐户的现有所有者可以向你授予访问权限。类似地，若要使用服务主体来创建 EA 订阅，则必须向该服务主体授予创建订阅的权限。

查找有访问权限的帐户

将你添加到与帐户所有者关联的注册帐户后，Azure 通过帐户到注册关系确定订阅收费对象。在该帐户下创建的所有订阅均向该帐户所在的 EA 注册收费。若要创建订阅，必须传入拥有订阅所需的合约帐户和用户主体的相关值。

若要运行以下命令，必须登录到帐户所有者的主目录（默认在该目录中创建订阅）。

请求列出你有权访问的所有注册帐户：

GET https://management.azure.com/providers/Microsoft.Billing/enrollmentAccounts?api-version=2018-03-01-preview

API 响应列出你有权访问的所有注册帐户：

{
  "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"
      }
    }
  ]
}

使用 principalName 属性标识想要对其收取订阅费用的帐户。复制该帐户的 name。例如，要在 SignUpEngineering@contoso.com 注册帐户下创建订阅，请复制 747ddfe5-xxxx-xxxx-xxxx-xxxxxxxxxxxx。此标识符是注册帐户的对象 ID。将该值粘贴到某个位置，以便在下一步中将其用作 enrollmentAccountObjectId。

打开 Azure Cloud Shell 并选择 PowerShell。

使用 Get-AzEnrollmentAccount cmdlet 列出你可以访问的所有注册帐户。

Get-AzEnrollmentAccount

Azure 使用你有权访问的注册帐户列表做出响应：

ObjectId                               | PrincipalName
747ddfe5-xxxx-xxxx-xxxx-xxxxxxxxxxxx   | SignUpEngineering@contoso.com
4cd2fcf6-xxxx-xxxx-xxxx-xxxxxxxxxxxx   | BillingPlatformTeam@contoso.com

使用 principalName 属性标识想要对其收取订阅费用的帐户。复制该帐户的 ObjectId。例如，要在 SignUpEngineering@contoso.com 注册帐户下创建订阅，请复制 747ddfe5-xxxx-xxxx-xxxx-xxxxxxxxxxxx。将该对象 ID 粘贴到某个位置，以便在下一步中将其用作 enrollmentAccountObjectId。

使用 az billing enrollment-account list 命令列出有访问权限的所有注册帐户。

az billing enrollment-account list

Azure 使用你有权访问的注册帐户列表做出响应：

[
  {
    "id": "/providers/Microsoft.Billing/enrollmentAccounts/747ddfe5-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "name": "747ddfe5-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "principalName": "SignUpEngineering@contoso.com",
    "type": "Microsoft.Billing/enrollmentAccounts",
  },
  {
    "id": "/providers/Microsoft.Billing/enrollmentAccounts/747ddfe5-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "name": "4cd2fcf6-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "principalName": "BillingPlatformTeam@contoso.com",
    "type": "Microsoft.Billing/enrollmentAccounts",
  }
]

在特定注册帐户下创建订阅

以下示例在上一步选择的注册帐户中创建名为 Dev Team Subscription 的订阅。订阅产品/服务为 MS-AZR-0017P（常规 Microsoft 企业协议）。它也选择性地添加两个用户作为订阅的 Azure RBAC 所有者。

发出以下请求，将 <enrollmentAccountObjectId> 替换为从第一步复制的 name (747ddfe5-xxxx-xxxx-xxxx-xxxxxxxxxxxx)。若要指定所有者，请参阅如何获取用户对象 ID。

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>"
    }
  ]
}

元素名称	必须	类型	说明
`displayName`	否	字符串	订阅的显示名称。如果未指定，则将其设置为产品/服务名称，例如“Microsoft Azure Enterprise”。
`offerType`	是	字符串	订阅的套餐。 EA 的两个选项是 MS-AZR-0017P（生产用）和 MS-AZR-0148P（开发/测试用，需要在 Azure 门户中启用）。
`owners`	否	字符串	创建订阅时作为 Azure RBAC 所有者添加到订阅的用户的对象 ID。

在响应中，作为标头 Location 的一部分，你返回一个可以查询订阅创建操作状态的 URL。完成订阅创建后，Location URL 上的 GET 将返回 subscriptionLink 对象，该对象具有订阅 ID。有关更多详细信息，请参阅订阅 API 文档

若要安装包含 New-AzSubscriptionAlias cmdlet 的模块版本，请在下面的示例中运行 Install-Module Az.Subscription -RequiredVersion 0.9.0。若要安装 0.9.0 版 PowerShellGet，请参阅获取 PowerShellGet 模块。

运行以下 New-AzSubscription 命令，并将 <enrollmentAccountObjectId> 替换为第一步中收集的 ObjectId (747ddfe5-xxxx-xxxx-xxxx-xxxxxxxxxxxx)。若要指定所有者，请参阅如何获取用户对象 ID。

New-AzSubscription -OfferType MS-AZR-0017P -Name "Dev Team Subscription" -EnrollmentAccountObjectId <enrollmentAccountObjectId> -OwnerObjectId <userObjectId1>,<servicePrincipalObjectId>

元素名称	必须	类型	说明
`Name`	否	字符串	订阅的显示名称。如果未指定，则将其设置为产品/服务名称，例如 Microsoft Azure Enterprise。
`OfferType`	是	String	订阅套餐。 EA 的两个选项是 MS-AZR-0017P（生产用）和 MS-AZR-0148P（开发/测试用，需要在 Azure 门户中启用）。
`EnrollmentAccountObjectId`	是	字符串	注册帐户的对象 ID，在该帐户下创建订阅并对其计费。此值为从 `Get-AzEnrollmentAccount` 获取的 GUID。
`OwnerObjectId`	否	String	要在创建订阅时作为 Azure RBAC 所有者添加到订阅的任意用户的对象 ID。
`OwnerSignInName`	否	String	要在创建订阅时作为 Azure RBAC 所有者添加到订阅的任意用户的电子邮件地址。可以使用此参数，而不使用 `OwnerObjectId`。
`OwnerApplicationId`	否	String	要在创建订阅时作为 Azure RBAC 所有者添加到订阅的任意服务主体的应用程序 ID。可以使用此参数，而不使用 `OwnerObjectId`。使用此参数时，服务主体必须具有对该目录的读取访问权限。

首先，通过运行 az extension add --name subscription 安装此预览版扩展。

运行以下 az account create 命令，并将 <enrollmentAccountObjectId> 替换为第一步中收集的 name (747ddfe5-xxxx-xxxx-xxxx-xxxxxxxxxxxx)。若要指定所有者，请参阅如何获取用户对象 ID。

az account create --offer-type "MS-AZR-0017P" --display-name "Dev Team Subscription" --enrollment-account-object-id "<enrollmentAccountObjectId>" --owner-object-id "<userObjectId>","<servicePrincipalObjectId>"

元素名称	必须	类型	说明
`display-name`	否	字符串	订阅的显示名称。如果未指定，则将其设置为产品/服务名称，例如 Microsoft Azure Enterprise。
`offer-type`	是	字符串	订阅的套餐。 EA 的两个选项是 MS-AZR-0017P（生产用）和 MS-AZR-0148P（开发/测试用，需要在 Azure 门户中启用）。
`enrollment-account-object-id`	是	字符串	注册帐户的对象 ID，在该帐户下创建订阅并对其计费。此值为从 `az billing enrollment-account list` 获取的 GUID。
`owner-object-id`	否	String	要在创建订阅时作为 Azure RBAC 所有者添加到订阅的任意用户的对象 ID。
`owner-upn`	否	String	要在创建订阅时作为 Azure RBAC 所有者添加到订阅的任意用户的电子邮件地址。可以使用此参数，而不使用 `owner-object-id`。
`owner-spn`	否	String	要在创建订阅时作为 Azure RBAC 所有者添加到订阅的任意服务主体的应用程序 ID。可以使用此参数，而不使用 `owner-object-id`。使用此参数时，服务主体必须具有对该目录的读取访问权限。

要查看所有参数的完整列表，请参阅 az account create。

对创建 Azure Enterprise 订阅的 API 限制

仅 Azure Enterprise 订阅可以使用此 API 进行创建。
每个注册帐户的订阅限制为 5000 个。超过此限制后，只能在 Azure 门户中为该帐户创建更多订阅。如果想要通过 API 创建更多订阅，请创建另一个注册帐户。已取消、已删除和已传输的订阅数的上限为 5000。
如果用户不是帐户所有者，而是通过 Azure RBAC 添加到注册帐户的，则该用户不能在 Azure 门户中创建订阅。
不能选择要在其中创建订阅的租户。订阅始终在帐户所有者的主租户中进行创建。若要将订阅移到不同的租户，请参阅更改订阅租户。

为 MCA 帐户创建订阅

使用以下各部分中的信息为 MCA 帐户创建订阅。

先决条件

必须在发票科目上具有所有者、参与者或 Azure 订阅创建者角色，或者在计费对象信息或计费帐户上具有所有者或参与者角色才能创建订阅。有关详细信息，请参阅订阅计费角色和任务。

下面的示例使用 REST API。目前，PowerShell 和 Azure CLI 不受支持。

查找你有权访问的计费帐户

发出以下请求，以列出所有计费帐户。

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts?api-version=2019-10-01-preview

API 响应列出你有权访问的计费帐户。

{
  "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"
    }
  ]
}

使用 displayName 属性来标识要为其创建订阅的计费帐户。确保帐户的 agreementType 为 MicrosoftCustomerAgreement。复制帐户的 name。例如，若要为 Contoso 计费帐户创建订阅，请复制 5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx。将该值粘贴到某个位置，以便在下一步中使用它。

查找发票科目以创建订阅

订阅费用在计费对象信息发票的某个科目中显示。使用以下 API 获取你有权在其上创建 Azure 订阅的发票科目和计费对象信息的列表。

发出以下请求，将 <billingAccountName> 替换为从第一步复制的 name (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

API 响应列出你有权在其上创建订阅的所有发票科目及其计费对象信息：

{
    "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"
  }]
}

使用 invoiceSectionDisplayName 属性来标识要为其创建订阅的发票科目。复制发票科目的 invoiceSectionId、billingProfileId 和其中一个 skuId。例如，若要为 Development 发票科目创建类型为 Microsoft Azure plan 的订阅，请复制 /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 和 0001。将这些值粘贴到某个位置，以便在下一步中使用它们。

为发票科目创建订阅

以下示例为 Development 发票科目创建类型为 Microsoft Azure 计划的名为 Dev Team subscription 的订阅。订阅将向 Contoso finance 的计费对象信息收费，并在发票的 Development 科目显示。

发出以下请求，将 <invoiceSectionId> 替换为从第二步复制的 invoiceSectionId (/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)。将第二步中复制的 billingProfileId 和 skuId 传递到 API 的请求参数中。若要指定所有者，请参阅如何获取用户对象 ID。

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",",
}'

元素名称	必须	类型	说明
`displayName`	是	字符串	订阅的显示名称。
`billingProfileId`	是	字符串	用于计收订阅使用费的计费对象信息的 ID。
`skuId`	是	字符串	确定 Azure 计划类型的 SKU ID。
`owners`	否	字符串	创建订阅时要作为 Azure RBAC 所有者要添加到订阅的任何用户或服务主体的对象 ID。
`costCenter`	否	字符串	与订阅关联的成本中心。它在使用情况 CSV 文件中显示。
`managementGroupId`	否	字符串	订阅将添加到其中的管理组的 ID。若要获取管理组列表，请参阅管理组 - 列表 API。使用 API 中管理组的 ID。

在响应中，返回 subscriptionCreationResult 对象进行监视。完成订阅创建后，subscriptionCreationResult 对象将返回有订阅 ID 的 subscriptionLink 对象。

为 MPA 计费帐户创建订阅

使用以下各部分中的信息为 MPA 计费帐户创建订阅。

先决条件

必须在组织的云解决方案提供商帐户中具有全局管理员或管理员代理角色，才能为计费帐户创建订阅。有关详细信息，请参阅合作伙伴中心 - 为用户分配角色和权限。

下面的示例使用 REST API。目前，PowerShell 和 Azure CLI 不受支持。

查找你有权访问的计费帐户

发出以下请求，以列出你有权访问的所有计费帐户。

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts?api-version=2019-10-01-preview

API 响应列出计费帐户。

{
  "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"
    }
  ]
}

使用 displayName 属性来标识要为其创建订阅的计费帐户。确保帐户的 agreementType 为 MicrosoftPartnerAgreement。复制帐户的 name。例如，若要为 Contoso 计费帐户创建订阅，请复制 99a13315-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx。将该值粘贴到某个位置，以便在下一步中使用它。

查找具有 Azure 计划的客户

发出以下请求，将 <billingAccountName> 替换为从第一步复制的 name (5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx)，以列出你可以为其创建 Azure 订阅的计费帐户中的所有客户。

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/<billingAccountName>/customers?api-version=2019-10-01-preview

API 响应列出具有 Azure 计划的计费帐户中的客户。你可以为这些客户创建订阅。

{
  "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"
    }]
}

使用 displayName 属性来标识要为其创建订阅的客户。复制客户的 id。例如，若要为 Fabrikam toys 创建订阅，请复制 /providers/Microsoft.Billing/billingAccounts/99a13315-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/customers/2281f543-xxxx-xxxx-xxxx-xxxxxxxxxxxx。将该值粘贴到某个位置，以便在后面的步骤中使用它。

对于间接提供商可选：获取客户的经销商

如果你是 CSP 双层模型中的间接提供商，则可以在为客户创建订阅时指定经销商。

发出以下请求，将 <customerId> 替换为从第二步复制的 id (/providers/Microsoft.Billing/billingAccounts/99a13315-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/customers/2281f543-xxxx-xxxx-xxxx-xxxxxxxxxxxx)，以列出客户可用的所有经销商。

GET https://management.azure.com<customerId>?$expand=resellers&api-version=2019-10-01-preview

API 响应列出客户的经销商：

{
  "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"
      }
    ]
  }
}]
}

使用 description 属性来标识与订阅关联的经销商。复制经销商的 resellerId。例如，若要关联 Wingtip，请复制 3xxxxx。将该值粘贴到某个位置，以便在下一步中使用它。

为客户创建订阅

以下示例为 Fabrikam Toys 创建名为 Dev Team subscription 的订阅，并将 Wingtip 经销商与该订阅相关联。

POST https://management.azure.com<customerId>/providers/Microsoft.Subscription/createSubscription?api-version=2018-11-01-preview

'{"displayName": "Dev Team subscription",
  "skuId": "0001",
  "resellerId": "<resellerId>",
}'

元素名称	必须	类型	说明
`displayName`	是	字符串	订阅的显示名称。
`skuId`	是	字符串	Azure 计划的 SKU ID。将 0001 用于 Microsoft Azure 计划类型的订阅
`resellerId`	否	字符串	将与订阅关联的经销商的 ID。

在响应中，返回 subscriptionCreationResult 对象进行监视。完成订阅创建后，subscriptionCreationResult 对象将返回 subscriptionLink 对象。它具有订阅 ID。

后续步骤

若要查看使用 .NET 创建企业协议 (EA) 订阅的示例，请参阅 GitHub 上的示例代码。

创建订阅以后，即可将该权限授予其他用户和服务主体。有关详细信息，请参阅授予创建 Azure Enterprise 订阅（预览版）所需的访问权限。
要详细了解如何使用管理组管理大量订阅，请参阅使用 Azure 管理组整理资源。

Share via

通过旧 API 以编程方式创建 Azure 订阅

为 EA 计费帐户创建订阅

先决条件

查找有访问权限的帐户

在特定注册帐户下创建订阅

对创建 Azure Enterprise 订阅的 API 限制

为 MCA 帐户创建订阅

先决条件

查找你有权访问的计费帐户

查找发票科目以创建订阅

为发票科目创建订阅

为 MPA 计费帐户创建订阅

先决条件

查找你有权访问的计费帐户

查找具有 Azure 计划的客户

对于间接提供商可选：获取客户的经销商

为客户创建订阅

后续步骤

反馈

反馈

其他资源