Azure Stack Hub に使用状況の追跡のためのテナントを登録する

この記事では、登録操作について詳しく説明します。 これらの操作を使用して次のことができます。

• テナントの登録を管理する。
• テナントの使用状況の追跡を管理する。

テナントを登録に追加する

この操作は、ご自分の登録に新しいテナントを追加するときに使用します。 テナントの使用状況は、Microsoft Entra テナントに接続されている Azure サブスクリプションで報告されます。

この操作は、テナントに関連付けられているサブスクリプションを変更する場合にも使用できます。 以前のマッピングを上書きするには、PUT または New-AzResource PowerShell コマンドレットを呼び出します。 AzureRM PowerShell モジュールを使用している場合は、New-AzureRMResource PowerShell コマンドレットを使用します。

テナントと関連付けることができる Azure サブスクリプションは 1 つだけです。 既存のテナントに第 2 のサブスクリプションを追加すると、最初のサブスクリプションは上書きされます。

API プロファイルの使用

次の登録コマンドレットでは、PowerShell を実行するときに API プロファイルを指定する必要があります。 API プロファイルは、一連の Azure リソース プロバイダーとその API バージョンを表します。 これにより、複数の Azure クラウドを対話操作するときに、適切なバージョンの API を使用できます。 たとえば、グローバルな Azure と Azure Stack Hub を操作するときに複数のクラウドを操作する場合、API プロファイルでは、そのリリース日と一致する名前が指定されます。 2017-09-03 プロファイルを使用します。

Azure Stack Hub と API プロファイルの詳細については、「Azure Stack Hub での API バージョンのプロファイルの管理」を参照してください。

パラメーター

PowerShell

New-AzResource -ResourceId "subscriptions/{registrationSubscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions/{customerSubscriptionId}" -ApiVersion 2017-06-01

New-AzureRMResource -ResourceId "subscriptions/{registrationSubscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions/{customerSubscriptionId}" -ApiVersion 2017-06-01

API 呼び出し

Operation:PUT
要求 URI: subscriptions/{registrationSubscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions/{customerSubscriptionId}?api-version=2017-06-01 HTTP/1.1
応答:201 Created
応答本文:Empty

すべての登録済みテナントの一覧

登録に追加されているすべてのテナントの一覧を取得します。

パラメーター

PowerShell

Get-AzResource -ResourceId "subscriptions/{registrationSubscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions" -ApiVersion 2017-06-01

Get-AzureRMResource -ResourceId "subscriptions/{registrationSubscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions" -ApiVersion 2017-06-01

API 呼び出し

GET 操作を使用して、すべてのテナント マッピングの一覧を取得できます。

Operation:GET
要求 URI: subscriptions/{registrationSubscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions?api-version=2017-06-01 HTTP/1.1
応答:200
応答本文:

{
    "value": [{
            "id": " subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions/{ cspSubscriptionId 1}",
            "name": " cspSubscriptionId 1",
            "type": "Microsoft.AzureStack\customerSubscriptions",
            "properties": { "tenantId": "tId1" }
        },
        {
            "id": " subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions/{ cspSubscriptionId 2}",
            "name": " cspSubscriptionId2 ",
            "type": "Microsoft.AzureStack\customerSubscriptions",
            "properties": { "tenantId": "tId2" }
        }
    ],
    "nextLink": "{originalRequestUrl}?$skipToken={opaqueString}"
}

テナント マッピングの削除

登録に追加されているテナントを削除することができます。 そのテナントがまだ Azure Stack Hub のリソースを使用している場合、その使用は Azure Stack Hub の初期登録に使用されたサブスクリプションに課金されます。

パラメーター

PowerShell

Remove-AzResource -ResourceId "subscriptions/{registrationSubscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions/{customerSubscriptionId}" -ApiVersion 2017-06-01

Remove-AzureRMResource -ResourceId "subscriptions/{registrationSubscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions/{customerSubscriptionId}" -ApiVersion 2017-06-01

API 呼び出し

DELETE 操作を使用して、テナントのマッピングを削除することができます。

Operation:DELETE
要求 URI: subscriptions/{registrationSubscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions/{customerSubscriptionId}?api-version=2017-06-01 HTTP/1.1
応答:204 No Content
応答本文:Empty

次のステップ

• Azure Stack Hub からのリソースの使用量の取得方法