在 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 版本配置文件。
parameters
参数 | 说明 |
---|---|
registrationSubscriptionID | 用于初始注册的 Azure 订阅。 |
customerSubscriptionID | 属于要注册的客户的 Azure 订阅(非 Azure Stack Hub)。 必须通过合作伙伴中心在云解决方案提供商 (CSP) 产品/服务中创建。 如果客户有多个租户,则为要登录 Azure Stack Hub 的租户创建订阅。 客户订阅 ID 区分大小写。 |
resourceGroup | Azure 中用于存储注册的资源组。 |
registrationName | 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 调用
Operation:PUT
RequestURI:subscriptions/{registrationSubscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions/{customerSubscriptionId}?api-version=2017-06-01 HTTP/1.1
响应:201 Created
响应正文:空
列出所有已注册租户
获取已添加到注册的所有租户列表。
注意
如果没有租户已注册,则不会收到响应。
parameters
参数 | 说明 |
---|---|
registrationSubscriptionId | 用于初始注册的 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 操作获取所有租户映射的列表。
Operation:GET
RequestURI: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 注册中使用的订阅收取这些资源的使用费用。
parameters
参数 | 说明 |
---|---|
registrationSubscriptionId | 注册的订阅 ID。 |
resourceGroup | 注册的资源组。 |
registrationName | 注册的名称。 |
customerSubscriptionId | 客户订阅 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 操作删除租户映射。
Operation:DELETE
RequestURI:subscriptions/{registrationSubscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions/{customerSubscriptionId}?api-version=2017-06-01 HTTP/1.1
响应:204 无内容
响应正文:空