共用方式為

在 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 版本設定檔。

參數

參數 描述
registrationSubscriptionID（註冊訂閱ID） 用於初始註冊的 Azure 訂用帳戶。
客戶訂閱識別碼 屬於要註冊之客戶的 Azure 訂用帳戶（而非 Azure Stack Hub）。 必須透過合作夥伴中心在雲端解決方案提供者 （CSP） 供應專案中建立。 如果客戶有多個租使用者，請為租使用者建立訂用帳戶以登入 Azure Stack Hub。 客戶訂用帳戶的 ID 會區分大小寫。
資源群組 Azure 中儲存註冊的資源群組。
註冊名稱 Azure Stack Hub 註冊的名稱。 它是儲存在 Azure 中的物件。 名稱的格式通常為 azurestack-CloudID，其中 CloudID 是您 Azure Stack Hub 部署的雲端標識符。

注意

租戶必須在其使用的每個 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 已建立
回應內容：空白

列出所有已註冊的租戶

取得已新增至註冊的所有租用戶清單。

注意

如果未註冊任何租使用者，您就不會收到回應。

參數

參數 描述
註冊訂閱識別碼 用於初始註冊的 Azure 訂用帳戶。
資源群組 Azure 中儲存註冊的資源群組。
註冊名稱 Azure Stack Hub 部署註冊的名稱。 它是儲存在 Azure 中的物件。 此名稱通常的格式是 azurestack-CloudID，其中 CloudID 是您 Azure Stack Hub 部署的雲端 ID。

PowerShell

使用 Get-AzResource cmdlet 來列出所有已註冊的租戶。 連線到 Azure Stack Hub，然後從提升許可權的提示字元執行下列指令：

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 註冊中使用的訂用帳戶收費。

參數

參數 描述
註冊訂閱識別碼 註冊的訂用帳戶ID。
資源群組 註冊所需的資源群組。
registrationName 註冊的名稱。
顧客訂閱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 作業來移除租用戶對應。

作業：刪除
RequestURI： subscriptions/{registrationSubscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions/{customerSubscriptionId}?api-version=2017-06-01 HTTP/1.1
回應：204 無內容
回應內容： 空白

後續步驟