Registar inquilinos para rastreio de utilização no Azure Stack HubRegister tenants for usage tracking in Azure Stack Hub

Este artigo contém detalhes sobre as operações de registo.This article contains details about registration operations. Pode utilizar estas operações para:You can use these operations to:

  • Gerir as inscrições dos inquilinos.Manage tenant registrations.
  • Gerir o rastreio de uso do inquilino.Manage tenant usage tracking.

Adicionar inquilino ao registoAdd tenant to registration

Pode utilizar esta operação quando quiser adicionar um novo inquilino ao seu registo.You can use this operation when you want to add a new tenant to your registration. O uso do inquilino é reportado ao abrigo de uma assinatura Azure ligada ao inquilino Azure Ative Directory (Azure AD).Tenant usage is reported under an Azure subscription connected with the Azure Active Directory (Azure AD) tenant.

Também pode utilizar esta operação para alterar a subscrição associada a um inquilino.You can also use this operation to change the subscription associated with a tenant. Ligue para o PUT ou para o cmdlet PowerShell New-AzResource para substituir o mapeamento anterior.Call PUT or the New-AzResource PowerShell cmdlet to overwrite the previous mapping. Se estiver a utilizar o módulo PowerShell AzureRM, utilize o cmdlet PowerShell New-AzureResource.If you are using the AzureRM PowerShell module, use New-AzureResource PowerShell cmdlet.

Pode associar uma única assinatura Azure a um inquilino.You can associate a single Azure subscription with a tenant. Se tentar adicionar uma segunda subscrição a um inquilino existente, a primeira subscrição é substituída.If you try to add a second subscription to an existing tenant, the first subscription is overwritten.

Use perfis de APIUse API profiles

Os cmdlets de registo que se seguem exigem que especifique um perfil API ao executar o PowerShell.The following registration cmdlets require that you specify an API profile when running PowerShell. Os perfis da API representam um conjunto de fornecedores de recursos Azure e suas versões API.API profiles represent a set of Azure resource providers and their API versions. Ajudam-no a usar a versão certa da API quando interage com várias nuvens Azure.They help you use the right version of the API when interacting with multiple Azure clouds. Por exemplo, se trabalhar com várias nuvens ao trabalhar com o Global Azure e o Azure Stack Hub, os perfis da API especificam um nome que corresponda à data de lançamento.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. Usa o perfil 2017-09-03.You use the 2017-09-03 profile.

Para obter mais informações sobre os perfis Azure Stack Hub e API, consulte os perfis de versão API do Manage no Azure Stack Hub.For more information about Azure Stack Hub and API profiles, see Manage API version profiles in Azure Stack Hub.

ParâmetrosParameters

ParâmetroParameter DescriçãoDescription
registrationSubscriçãoIDregistrationSubscriptionID A assinatura Azure que foi utilizada para o registo inicial.The Azure subscription that was used for the initial registration.
clienteSubscriçãoIDcustomerSubscriptionID A subscrição Azure (não Azure Stack Hub) pertencente ao cliente para ser registada.The Azure subscription (not Azure Stack Hub) belonging to the customer to be registered. Deve ser criado na oferta do Cloud Solution Provider (CSP) através do Partner Center.Must be created in the Cloud Solution Provider (CSP) offer through the Partner Center. Se um cliente tiver mais do que um inquilino, crie uma subscrição para o inquilino se inscrever no Azure Stack Hub.If a customer has more than one tenant, create a subscription for the tenant to sign in to Azure Stack Hub. O ID de subscrição do cliente é sensível a casos.The customer subscription ID is case sensitive.
resourceGroupresourceGroup O grupo de recursos em Azure no qual o seu registo está armazenado.The resource group in Azure in which your registration is stored.
nome de registosregistrationName O nome do registo do seu Azure Stack Hub.The name of the registration of your Azure Stack Hub. É um objeto armazenado em Azure.It's an object stored in Azure. O nome está geralmente na forma azurestack-CloudID, onde o CloudID é o ID em nuvem da sua implementação do Azure Stack Hub.The name is usually in the form azurestack-CloudID, where CloudID is the cloud ID of your Azure Stack Hub deployment.

Nota

Os inquilinos devem estar registados em cada implantação do Azure Stack Hub que utilizam.Tenants must be registered with each Azure Stack Hub deployment that they use. Se um inquilino utilizar mais do que um Azure Stack Hub, atualize os registos iniciais de cada implementação com a subscrição do inquilino.If a tenant uses more than one Azure Stack Hub, update the initial registrations of each deployment with the tenant subscription.

PowerShellPowerShell

Use o cmdlet New-AzResource para adicionar um inquilino.Use the New-AzResource cmdlet to add a tenant. Ligue-se a Azure, e, em seguida, a partir de um pedido elevado executar o seguinte comando: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

Chamada APIAPI call

Operação: PUTOperation: PUT
RequestURI: subscriptions/{registrationSubscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions/{customerSubscriptionId}?api-version=2017-06-01 HTTP/1.1RequestURI: subscriptions/{registrationSubscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions/{customerSubscriptionId}?api-version=2017-06-01 HTTP/1.1
Resposta: 201 CriadoResponse: 201 Created
Corpo de Resposta: VazioResponse Body: Empty

Listar todos os inquilinos registadosList all registered tenants

Obtenha uma lista de todos os inquilinos que foram adicionados a uma inscrição.Get a list of all tenants that have been added to a registration.

Nota

Se nenhum inquilino foi registado, não receberá uma resposta.If no tenants have been registered, you won't receive a response.

ParâmetrosParameters

ParâmetroParameter DescriçãoDescription
registrationSubscriptionDregistrationSubscriptionId A assinatura Azure que foi utilizada para o registo inicial.The Azure subscription that was used for the initial registration.
resourceGroupresourceGroup O grupo de recursos em Azure no qual o seu registo está armazenado.The resource group in Azure in which your registration is stored.
nome de registosregistrationName O nome do registo da sua implantação do Azure Stack Hub.The name of the registration of your Azure Stack Hub deployment. É um objeto armazenado em Azure.It's an object stored in Azure. O nome é geralmente na forma de azurestack-CloudID, onde o CloudID é o ID em nuvem da sua implementação do Azure Stack Hub.The name is usually in the form of azurestack-CloudID, where CloudID is the cloud ID of your Azure Stack Hub deployment.

PowerShellPowerShell

Utilize o cmdlet Get-AzResource para listar todos os inquilinos registados.Use the Get-AzResource cmdlet to list all registered tenants. Ligue ao Azure Stack Hub, e, em seguida, a partir de um rápido elevado executar o seguinte cmdlet: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

Chamada APIAPI call

Você pode obter uma lista de todos os mapeamentos de inquilinos usando a operação GET.You can get a list of all tenant mappings using the GET operation.

Operação: GETOperation: GET
RequestURI: subscriptions/{registrationSubscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions?api-version=2017-06-01 HTTP/1.1RequestURI: subscriptions/{registrationSubscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions?api-version=2017-06-01 HTTP/1.1
Resposta: 200Response: 200
Órgão de resposta: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}"
}

Remova um mapeamento de inquilinoRemove a tenant mapping

Pode remover um inquilino que tenha sido adicionado a uma inscrição.You can remove a tenant that has been added to a registration. Se esse inquilino ainda estiver a utilizar recursos no Azure Stack Hub, a sua utilização é cobrada à subscrição utilizada no registo inicial do Azure Stack Hub.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.

ParâmetrosParameters

ParâmetroParameter DescriçãoDescription
registrationSubscriptionDregistrationSubscriptionId ID de assinatura para o registo.Subscription ID for the registration.
resourceGroupresourceGroup O grupo de recursos para o registo.The resource group for the registration.
nome de registosregistrationName O nome do registo.The name of the registration.
clienteSubscriçãoDidacustomerSubscriptionId O ID de assinatura do cliente.The customer subscription ID. O ID de subscrição do cliente é sensível a casos.The customer subscription ID is case sensitive.

PowerShellPowerShell

Utilize o cmdlet Remove-AzResource para remover um inquilino.Use the Remove-AzResource cmdlet to remove a tenant. Ligue ao Azure Stack Hub, e, em seguida, a partir de um rápido elevado executar o seguinte cmdlet: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

Chamada APIAPI call

Pode remover os mapeamentos do inquilino utilizando a operação DELETE.You can remove tenant mappings using the DELETE operation.

Operação: DELETEOperation: DELETE
RequestURI: subscriptions/{registrationSubscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions/{customerSubscriptionId}?api-version=2017-06-01 HTTP/1.1RequestURI: subscriptions/{registrationSubscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions/{customerSubscriptionId}?api-version=2017-06-01 HTTP/1.1
Resposta: 204 Sem ConteúdoResponse: 204 No Content
Corpo de Resposta: VazioResponse Body: Empty

Passos seguintesNext steps