本文包含有关注册操作的详细信息。 可以使用这些操作来执行以下操作:
- 管理租户注册。
- 管理租户使用情况跟踪。
将租户添加到用户注册中
如果要向注册中添加新租户,可以使用此操作。 租户使用情况是在与 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
RequestURI: subscriptions/{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
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 注册中使用的订阅。
参数
参数 | 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
RequestURI: subscriptions/{registrationSubscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions/{customerSubscriptionId}?api-version=2017-06-01 HTTP/1.1
响应:204 无内容
响应正文:空