在 Azure Stack Hub 中注册租户以跟踪使用情况

本文包含有关注册操作的详细信息。 可以使用这些操作来执行以下操作:

  • 管理租户注册。
  • 管理租户使用情况跟踪。

将租户添加到用户注册中

如果要向注册中添加新租户,可以使用此操作。 租户使用情况是在与 Microsoft Entra 租户连接的 Azure 订阅下报告的。

您还可以使用此操作更改与租户关联的订阅。 调用 PUT 或 New-AzResource PowerShell cmdlet 以覆盖以前的映射。 如果使用 AzureRM PowerShell 模块,请使用 New-AzureRMResource PowerShell cmdlet。

可以将单个 Azure 订阅与租户相关联。 如果尝试将第二个订阅添加到现有租户,则会覆盖第一个订阅。

使用 API 配置文件

以下注册 cmdlet 要求在运行 PowerShell 时指定 API 配置文件。 API 配置文件表示一组 Azure 资源提供程序及其 API 版本。 它们有助于在与多个 Azure 云交互时使用正确的 API 版本。 例如,如果在使用全局 Azure 和 Azure Stack Hub 时使用多个云,API 配置文件会指定与其发布日期匹配的名称。 使用 2017-09-03 配置文件。

有关 Azure Stack Hub 和 API 配置文件的详细信息,请参阅 管理 Azure Stack Hub 中的 API 版本配置文件

参数

参数 DESCRIPTION
registrationSubscriptionID(注册订阅ID) 用于初始注册的 Azure 订阅。
客户订阅ID (customerSubscriptionID) 属于要注册的客户的 Azure 订阅(非 Azure Stack Hub)。 必须在云解决方案提供商(CSP)产品/服务中,通过合作伙伴中心创建。 如果客户有多个租户,请为租户创建一个订阅以登录到 Azure Stack Hub。 客户订阅 ID 区分大小写。
resourceGroup Azure 中用于存储注册的资源组。
登记名称 Azure Stack Hub 的注册名称。 它是 Azure 中存储的对象。 名称通常采用 azurestack-CloudID 的形式,其中 CloudID 是 Azure Stack Hub 部署的云 ID。

注释

租户必须在他们使用的每个 Azure Stack Hub 部署中注册。 如果租户使用多个 Azure Stack Hub,请使用租户订阅更新每个部署的初始注册。

PowerShell

使用 New-AzResource cmdlet 添加租户。 连接到 Azure,然后在提升的提示符下运行以下命令:

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

API 调用

运算:PUT
RequestURIsubscriptions/{registrationSubscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions/{customerSubscriptionId}?api-version=2017-06-01 HTTP/1.1
响应:201 Created
响应正文:空

列出所有已注册的租户

获取已添加到注册的所有租户的列表。

注释

如果未注册任何租户,则不会收到响应。

参数

参数 DESCRIPTION
注册订阅ID 用于初始注册的 Azure 订阅。
resourceGroup Azure 中用于存储注册的资源组。
注册名称 (registrationName) Azure Stack Hub 部署的注册名称。 它是 Azure 中存储的对象。 名称通常采用 azurestack-CloudID 的形式,其中 CloudID 是 Azure Stack Hub 部署的云 ID。

PowerShell

使用 Get-AzResource cmdlet 列出所有已注册的租户。 连接到 Azure Stack Hub,然后从提升的提示符运行以下 cmdlet:

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

API 调用

可以通过使用 GET 操作来获取所有租户映射的列表。

运算:GET
RequestURIsubscriptions/{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 注册中使用的订阅。

参数

参数 DESCRIPTION
注册订阅ID (registrationSubscriptionId) 注册的订阅 ID。
resourceGroup 注册的资源组。
注册名称 注册的名称。
客户订阅ID 客户订阅 ID。 客户订阅 ID 区分大小写。

PowerShell

使用 Remove-AzResource cmdlet 删除租户。 连接到 Azure Stack Hub,然后从提升的提示符运行以下 cmdlet:

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

API 调用

可以使用 DELETE 操作来删除租户映射。

操作:DELETE
RequestURIsubscriptions/{registrationSubscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions/{customerSubscriptionId}?api-version=2017-06-01 HTTP/1.1
响应:204 无内容
响应正文:空

后续步骤