Register tenants for usage tracking in Azure Stack Hub

This article contains details about registration operations. You can use these operations to:

  • Manage tenant registrations.
  • Manage tenant usage tracking.

Add tenant to registration

You can use this operation when you want to add a new tenant to your registration. Tenant usage is reported under an Azure subscription connected with the Azure Active Directory (Azure AD) tenant.

You can also use this operation to change the subscription associated with a tenant. Call PUT or the New-AzResource PowerShell cmdlet to overwrite the previous mapping. If you are using the AzureRM PowerShell module, use the New-AzureRMResource PowerShell cmdlet.

You can associate a single Azure subscription with a tenant. If you try to add a second subscription to an existing tenant, the first subscription is overwritten.

Use API profiles

The following registration cmdlets require that you specify an API profile when running PowerShell. API profiles represent a set of Azure resource providers and their API versions. They help you use the right version of the API when interacting with multiple Azure clouds. For example, if you work with multiple clouds when working with global Azure and Azure Stack Hub, API profiles specify a name that matches their release date. You use the 2017-09-03 profile.

For more information about Azure Stack Hub and API profiles, see Manage API version profiles in Azure Stack Hub.

Parameters

Parameter Description
registrationSubscriptionID The Azure subscription that was used for the initial registration.
customerSubscriptionID The Azure subscription (not Azure Stack Hub) belonging to the customer to be registered. Must be created in the Cloud Solution Provider (CSP) offer through the Partner Center. If a customer has more than one tenant, create a subscription for the tenant to sign in to Azure Stack Hub. The customer subscription ID is case sensitive.
resourceGroup The resource group in Azure in which your registration is stored.
registrationName The name of the registration of your Azure Stack Hub. It's an object stored in Azure. The name is usually in the form azurestack-CloudID, where CloudID is the cloud ID of your Azure Stack Hub deployment.

Note

Tenants must be registered with each Azure Stack Hub deployment that they use. If a tenant uses more than one Azure Stack Hub, update the initial registrations of each deployment with the tenant subscription.

PowerShell

Use the New-AzResource cmdlet to add a tenant. Connect to Azure, and then from an elevated prompt run the following command:

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

API call

Operation: PUT
RequestURI: subscriptions/{registrationSubscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions/{customerSubscriptionId}?api-version=2017-06-01 HTTP/1.1
Response: 201 Created
Response Body: Empty

List all registered tenants

Get a list of all tenants that have been added to a registration.

Note

If no tenants have been registered, you won't receive a response.

Parameters

Parameter Description
registrationSubscriptionId The Azure subscription that was used for the initial registration.
resourceGroup The resource group in Azure in which your registration is stored.
registrationName The name of the registration of your Azure Stack Hub deployment. It's an object stored in Azure. The name is usually in the form of azurestack-CloudID, where CloudID is the cloud ID of your Azure Stack Hub deployment.

PowerShell

Use the Get-AzResource cmdlet to list all registered tenants. Connect to Azure Stack Hub, and then from an elevated prompt run the following cmdlet:

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

API call

You can get a list of all tenant mappings using the GET operation.

Operation: GET
RequestURI: subscriptions/{registrationSubscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions?api-version=2017-06-01 HTTP/1.1
Response: 200
Response Body:

{
    "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}"
}

Remove a tenant mapping

You can remove a tenant that has been added to a registration. If that tenant is still using resources on Azure Stack Hub, their usage is charged to the subscription used in the initial Azure Stack Hub registration.

Parameters

Parameter Description
registrationSubscriptionId Subscription ID for the registration.
resourceGroup The resource group for the registration.
registrationName The name of the registration.
customerSubscriptionId The customer subscription ID. The customer subscription ID is case sensitive.

PowerShell

Use the Remove-AzResource cmdlet to remove a tenant. Connect to Azure Stack Hub, and then from an elevated prompt run the following cmdlet:

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

API call

You can remove tenant mappings using the DELETE operation.

Operation: DELETE
RequestURI: subscriptions/{registrationSubscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions/{customerSubscriptionId}?api-version=2017-06-01 HTTP/1.1
Response: 204 No Content
Response Body: Empty

Next steps