レガシ API を使用してプログラムで Azure サブスクリプションを作成する

[アーティクル]
11/14/2024

この記事は、レガシプレビュー API を使用してプログラムで Azure サブスクリプションを作成する場合に役に立ちます。この記事では、Azure Resource Manager を使用してプログラムからサブスクリプションを作成する方法について説明します。

さまざまな Azure 契約サブスクリプションの種類で使用できる最新の API バージョンに関して、次のような新しい記事があります。

ただし、最新の API バージョンを使用しない場合は、この記事の情報を引き続き使用できます。

次の契約の種類に対する課金アカウントを使用している Azure のお客様は、プログラムでサブスクリプションを作成できます。

Enterprise Agreement
Microsoft 顧客契約 (MCA)
Microsoft Partner Agreement (MPA)

プログラムで Azure サブスクリプションを作成した場合、そのサブスクリプションには、お客様が Microsoft または正規の販売代理店と締結した Azure サービスの契約が適用されます。詳細については、「Microsoft Azure の法的情報」を参照してください。

注意

Azure を操作するには、Azure Az PowerShell モジュールを使用することをお勧めします。作業を始めるには、「Azure PowerShell をインストールする」を参照してください。 Az PowerShell モジュールに移行する方法については、「AzureRM から Az への Azure PowerShell の移行」を参照してください。

プログラムでサポートプランを作成することはできません。新しいサポートプランを購入するか、Azure portal でアップグレードすることができます。 [ヘルプとサポート] に移動し、ページの上部にある [適切なサポートプランを選択] を選択します。

EA 課金アカウントのサブスクリプションを作成する

次のセクションの情報を使用して、EA サブスクリプションを作成します。

前提条件

サブスクリプションを作成するには、登録アカウントの所有者ロールを持っているか、エンタープライズ管理者である必要があります。そのロールを取得する方法は 2 つあります。

登録のエンタープライズ管理者は、ユーザーをアカウント所有者に設定できます (サインインが必要)。これにより、ユーザーは登録アカウントの所有者になります。
登録アカウントの既存の所有者が、アクセス許可を付与できます。同様に、サービスプリンシパルを使用して EA サブスクリプションを作成する場合は、そのサービスプリンシパルにサブスクリプションを作成する権限を付与する必要があります。

アクセスできるアカウントを検索します。

アカウント所有者に関連付けられた登録アカウントに追加されると、アカウントと登録の関係を使用してサブスクリプション料金の請求先が決定されます。このアカウント内で作成されたすべてのサブスクリプションは、アカウントが含まれる EA 登録に課金されます。サブスクリプションを作成するには、サブスクリプションを所有するための登録アカウントおよびユーザープリンシパルに関する値を受け渡す必要があります。

次のコマンドを実行するには、サブスクリプションが既定で作成されるディレクトリである、アカウント所有者の "ホームディレクトリ" にサインインしている必要があります。

自分がアクセスできるすべての登録アカウントを一覧表示するための要求:

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

API 応答で、自分がアクセスできるすべての登録アカウントが一覧表示されます。

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

principalName プロパティを使用して、サブスクリプション料金の請求先アカウントを指定します。そのアカウントの name をコピーします。たとえば、SignUpEngineering@contoso.com 登録アカウントでサブスクリプションを作成するには、aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e をコピーします。この識別子は登録アカウントのオブジェクト ID です。次の手順で enrollmentAccountObjectId として使用できるように、値をどこかに貼り付けておきます。

[Azure Cloud Shell] を開き、[PowerShell] を選択します。

Get-AzEnrollmentAccount コマンドレットを使用して、自分がアクセスできるすべての登録アカウントを一覧表示します。

Get-AzEnrollmentAccount

自分がアクセスできる登録アカウントの一覧が Azure から返されます。

ObjectId                               | PrincipalName
aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb   | SignUpEngineering@contoso.com
4cd2fcf6-xxxx-xxxx-xxxx-xxxxxxxxxxxx   | BillingPlatformTeam@contoso.com

principalName プロパティを使用して、サブスクリプション料金の請求先アカウントを指定します。そのアカウントの ObjectId をコピーします。たとえば、SignUpEngineering@contoso.com 登録アカウントでサブスクリプションを作成するには、aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e をコピーします。次の手順で enrollmentAccountObjectId として使用できるように、オブジェクト ID をどこかに貼り付けておきます。

az billing enrollment-account list コマンドを使用して、自分がアクセスできるすべての登録アカウントを一覧表示します。

az billing enrollment-account list

自分がアクセスできる登録アカウントの一覧が Azure から返されます。

[
  {
    "id": "/providers/Microsoft.Billing/enrollmentAccounts/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
    "name": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
    "principalName": "SignUpEngineering@contoso.com",
    "type": "Microsoft.Billing/enrollmentAccounts",
  },
  {
    "id": "/providers/Microsoft.Billing/enrollmentAccounts/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
    "name": "4cd2fcf6-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "principalName": "BillingPlatformTeam@contoso.com",
    "type": "Microsoft.Billing/enrollmentAccounts",
  }
]

特定の登録アカウントの中にサブスクリプションを作成する

次の例では、前のステップで選択した登録アカウントに Dev Team Subscription という名前のサブスクリプションを作成します。サブスクリプションオファーは MS-AZR-0017P (通常のマイクロソフトエンタープライズ契約) です。また、必要に応じて Azure RBAC 所有者として 2 人のユーザーをサブスクリプションに追加することもできます。

次の要求を実行します。その際、<enrollmentAccountObjectId> を最初のステップでコピーした name (aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb) と置き換えます。所有者を指定するには、ユーザーオブジェクト 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`	いいえ	String	サブスクリプションの表示名です。指定されていない場合は、"Microsoft Azure エンタープライズ" などのプラン名に設定されます。
`offerType`	はい	String	サブスクリプションのオファーです。 EA では、MS-AZR-0017P (運用環境用) と MS-AZR-0148P (開発/テスト用。Azure portal を使用して有効にする必要があります) の 2 つのオプションがあります。
`owners`	いいえ	String	サブスクリプションの作成時、それに Azure RBAC 所有者として追加するユーザーのオブジェクト ID。

応答では、ヘッダー Location の一部として、サブスクリプション作成操作の状態を照会できる URL が返されます。サブスクリプションの作成が完了すると、Location URL の GET によって、サブスクリプション ID を持つ subscriptionLink オブジェクトが返されます。詳細については、サブスクリプション API のドキュメントを参照してください

New-AzSubscriptionAlias コマンドレットを含むモジュールのバージョンをインストールするには、次の例で Install-Module Az.Subscription -RequiredVersion 0.9.0を実行します。 PowerShellGet のバージョン 0.9.0 をインストールするには、「 PowerShellGet モジュールを取得する」を参照してください。

次の New-AzSubscription コマンドを実行します。その際、<enrollmentAccountObjectId> を最初のステップで収集した ObjectId (aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb) で置き換えます。所有者を指定するには、ユーザーオブジェクト ID を取得する方法を参照してください。

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

要素名	必須	タイプ	説明
`Name`	いいえ	String	サブスクリプションの表示名です。指定されていない場合は、"Microsoft Azure エンタープライズ" などのプラン名に設定されます。
`OfferType`	はい	String	サブスクリプションオファー。 EA では、MS-AZR-0017P (運用環境用) と MS-AZR-0148P (開発/テスト用。Azure portal を使用して有効にする必要があります) の 2 つのオプションがあります。
`EnrollmentAccountObjectId`	はい	String	サブスクリプションが作成された、請求先の登録アカウントのオブジェクト 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 (aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb) で置き換えます。所有者を指定するには、ユーザーオブジェクト 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`	いいえ	String	サブスクリプションの表示名です。指定されていない場合は、"Microsoft Azure エンタープライズ" などのプラン名に設定されます。
`offer-type`	はい	String	サブスクリプションのオファーです。 EA では、MS-AZR-0017P (運用環境用) と MS-AZR-0148P (開発/テスト用。Azure portal を使用して有効にする必要があります) の 2 つのオプションがあります。
`enrollment-account-object-id`	はい	String	サブスクリプションが作成された、請求先の登録アカウントのオブジェクト 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 の制限事項

この API を使用して作成できるのは、Azure Enterprise サブスクリプションのみです。
登録アカウントあたりのサブスクリプション数は 5000 までに制限されています。その後、アカウントの追加のサブスクリプションは、Azure portal でのみ作成することができます。 API を使用してさらにサブスクリプションを作成する場合は、別の登録アカウントを作成します。キャンセル、削除、および譲渡されたサブスクリプションもカウントされ、5000 件の制限の対象となります。
アカウント所有者ではないが、Azure RBAC で登録アカウントに追加されたユーザーは、Azure portal でサブスクリプションを作成することはできません。
サブスクリプションが作成されるテナントを選択することはできません。サブスクリプションは常に、アカウント所有者のホームテナント内に作成されます。サブスクリプションを別のテナントに移動する場合は、テナントのサブスクリプションの変更に関する記事を参照してください。

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

displayName プロパティを使用して、サブスクリプションを作成する課金アカウントを指定します。アカウントの agreementType が MicrosoftCustomerAgreement であることを確認します。アカウントの name をコピーします。たとえば、Contoso 課金アカウントのサブスクリプションを作成するには、bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx をコピーします。次の手順で使用できるように、値をどこかに貼り付けておきます。

サブスクリプションを作成する請求書セクションを検索する

お使いのサブスクリプションの料金は、課金プロファイルの請求書のセクションに表示されます。次の API を使用して、自分に Azure サブスクリプションを作成するためのアクセス権がある請求書セクションと課金プロファイルの一覧を取得します。

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

invoiceSectionDisplayName プロパティを使用して、サブスクリプションを作成する請求書セクションを指定します。請求書セクションの invoiceSectionId、billingProfileId、いずれかの skuId をコピーします。たとえば、Development 請求書セクションの Microsoft Azure plan 型のサブスクリプションを作成するには、/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、および 0001 をコピーします。次の手順で使用できるように、これらの値をどこかに貼り付けておきます。

請求書セクションのサブスクリプションを作成する

次の例では、Dev Team Subscription という名前で種類が Microsoft Azure プランであるサブスクリプションを、Development 請求書セクションを対象に作成します。サブスクリプションは Contoso finance の課金プロファイルに請求され、請求書の Development セクションに表示されます。

次の要求を実行します。その際、<invoiceSectionId> を 2 番目のステップでコピーした invoiceSectionId (/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) と置き換えます。 2 番目の手順でコピーした 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`	イエス	String	サブスクリプションの表示名です。
`billingProfileId`	はい	String	サブスクリプションの料金に対して課金される課金プロファイルの ID です。
`skuId`	はい	String	Azure プランの種類を決定する SKU ID です。
`owners`	いいえ	String	サブスクリプションの作成時にサブスクリプションに Azure RBAC 所有者として追加するユーザーまたはサービスプリンシパルのオブジェクト ID です。
`costCenter`	いいえ	String	サブスクリプションに関連付けられているコストセンターです。使用状況の CSV ファイルに表示されます。
`managementGroupId`	いいえ	String	サブスクリプションが追加される管理グループの 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/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"
    }
  ]
}

displayName プロパティを使用して、サブスクリプションを作成する課金アカウントを指定します。アカウントの agreementType が MicrosoftPartnerAgreement であることを確認します。アカウントの name をコピーします。たとえば、Contoso 課金アカウントのサブスクリプションを作成するには、cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx をコピーします。次の手順で使用できるように、値をどこかに貼り付けておきます。

Azure プランの顧客を検索する

次の要求を実行します。その際、<billingAccountName> を最初のステップでコピーした name (bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f: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/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"
    }]
}

displayName プロパティを使用して、サブスクリプションを作成する対象の顧客を指定します。顧客の id をコピーします。たとえば、Fabrikam toys のサブスクリプションを作成するには、/providers/Microsoft.Billing/billingAccounts/cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/customers/dddd3d3d-ee4e-ff5f-aa6a-bbbbbb7b7b7b をコピーします。後の手順で使用するので、値をどこかに貼り付けておきます。

間接プロバイダー向けのオプション: 顧客のリセラーを取得する

CSP の 2 層モデルの間接プロバイダーである場合は、顧客のサブスクリプションを作成するときにリセラーを指定できます。

次の要求を実行します。その際、<customerId> を 2 番目のステップでコピーした id (/providers/Microsoft.Billing/billingAccounts/cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/customers/dddd3d3d-ee4e-ff5f-aa6a-bbbbbb7b7b7b) と置き換えます。これにより、顧客が利用できるすべてのリセラーが一覧表示されます。

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

API 応答には、顧客向けのリセラーが一覧表示されます。

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

description プロパティを使用して、サブスクリプションに関連付けるリセラーを特定します。リセラーの resellerId をコピーします。たとえば、Wingtip を関連付けるには、3xxxxx をコピーします。次の手順で使用できるように、値をどこかに貼り付けておきます。

顧客のサブスクリプションを作成する

次の例では、Dev Team subscription という名前のサブスクリプションを Fabrikam toys 用に作成し、Wingtip リセラーをそのサブスクリプションに関連付けます。

次の要求を実行します。その際、<customerId> を 2 番目のステップでコピーした id (/providers/Microsoft.Billing/billingAccounts/cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/customers/dddd3d3d-ee4e-ff5f-aa6a-bbbbbb7b7b7b) と置き換えます。 2 番目のステップでコピーしたオプションの resellerId を API の要求パラメーターで渡します。

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`	イエス	String	サブスクリプションの表示名です。
`skuId`	はい	String	Azure プランの SKU ID です。種類が Microsoft Azure プランであるサブスクリプションには 0001 を使用します。
`resellerId`	いいえ	String	サブスクリプションに関連付けられるリセラーの ID です。

監視対象の subscriptionCreationResult オブジェクトが返されます。サブスクリプションの作成が完了すると、subscriptionCreationResult オブジェクトによって、subscriptionLink オブジェクトが返されます。これには、サブスクリプション ID が含まれています。

次のステップ

.NET を使用して Enterprise Agreement (EA) サブスクリプションを作成する例を表示するには、GitHub のサンプルコードを参照してください。

サブスクリプションを作成し終えたら、他のユーザーおよびサービスプリンシパルでその機能を利用できるようになります。詳細については、「Azure Enterprise サブスクリプションを作成する権限を付与する (プレビュー)」を参照してください。
管理グループを使用して大量のサブスクリプションを管理する方法の詳細については、Azure 管理グループによるリソースの整理に関する記事を参照してください。

次の方法で共有

レガシ API を使用してプログラムで Azure サブスクリプションを作成する

EA 課金アカウントのサブスクリプションを作成する

前提条件

アクセスできるアカウントを検索します。

特定の登録アカウントの中にサブスクリプションを作成する

Azure Enterprise のサブスクリプション作成 API の制限事項

MCA アカウントのサブスクリプションを作成する

前提条件

アクセスできる課金アカウントを検索する

サブスクリプションを作成する請求書セクションを検索する

請求書セクションのサブスクリプションを作成する

MPA 課金アカウントのサブスクリプションを管理する

前提条件

アクセス権のある課金アカウントを検索する

Azure プランの顧客を検索する

間接プロバイダー向けのオプション: 顧客のリセラーを取得する

顧客のサブスクリプションを作成する

次のステップ

フィードバック

その他のリソース