Registar inquilinos para rastreio de utilização em Azure Stack Hub

Este artigo contém detalhes sobre as operações de registo. Pode utilizar estas operações para:

  • Gerir as inscrições dos inquilinos.
  • Gerir o rastreio de uso do inquilino.

Adicionar inquilino ao registo

Pode utilizar esta operação quando quiser adicionar um novo inquilino ao seu registo. O uso do inquilino é reportado ao abrigo de uma assinatura Azure ligada ao inquilino Azure Ative Directory (Azure AD).

Também pode utilizar esta operação para alterar a subscrição associada a um inquilino. Ligue para o PUT ou para o cmdlet PowerShell New-AzResource para substituir o mapeamento anterior. Se estiver a utilizar o módulo PowerShell AzureRM, utilize o cmdlet PowerShell New-AzureRMResource.

Pode associar uma única assinatura Azure a um inquilino. Se tentar adicionar uma segunda subscrição a um inquilino existente, a primeira subscrição é substituída.

Use perfis API

Os cmdlets de registo que se seguem exigem que especifique um perfil API ao executar o PowerShell. Os perfis da API representam um conjunto de fornecedores de recursos Azure e suas versões API. Ajudam-no a usar a versão certa da API quando interage com várias nuvens Azure. 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. Usa o perfil 2017-09-03.

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.

Parâmetros

Parâmetro Descrição
registrationSubscriçãoID A assinatura Azure que foi utilizada para o registo inicial.
clienteSubscriçãoID A assinatura Azure (não Azure Stack Hub) pertencente ao cliente a registar. Deve ser criado na oferta Fornecedor de Soluções em Nuvem (CSP) através do Centro de Parceiros. Se um cliente tiver mais do que um inquilino, crie uma subscrição para o inquilino se inscrever no Azure Stack Hub. O ID de subscrição do cliente é sensível a casos.
resourceGroup O grupo de recursos em Azure no qual o seu registo está armazenado.
registoName O nome do registo do seu Azure Stack Hub. É um objeto armazenado em Azure. O nome está geralmente na forma azurestack-CloudID,onde o CloudID é o ID em nuvem da sua implementação do Azure Stack Hub.

Nota

Os inquilinos devem estar registados em cada implantação do Azure Stack Hub que utilizam. 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.

PowerShell

Use o cmdlet New-AzResource para adicionar um inquilino. Ligação para Azure,e depois de um pedido elevado executar o seguinte comando:

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

Chamada API

Operação: PUT
RequestURI:
Resposta: 201 Criado
Corpo de Resposta: Vazio

Listar todos os inquilinos registados

Obtenha uma lista de todos os inquilinos que foram adicionados a uma inscrição.

Nota

Se nenhum inquilino foi registado, não receberá uma resposta.

Parâmetros

Parâmetro Descrição
registrationSubscriptionD A assinatura Azure que foi utilizada para o registo inicial.
resourceGroup O grupo de recursos em Azure no qual o seu registo está armazenado.
registoName O nome do registo da sua implantação do Azure Stack Hub. É um objeto armazenado em Azure. O nome é geralmente na forma de azurestack-CloudID,onde o CloudID é o ID em nuvem da sua implementação do Azure Stack Hub.

PowerShell

Utilize o cmdlet Get-AzResource para listar todos os inquilinos registados. Ligação para Azure Stack Hub, e, em seguida, de um pedido elevado executar o seguinte cmdlet:

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

Chamada API

Você pode obter uma lista de todos os mapeamentos de inquilinos usando a operação GET.

Operação: GET
RequestURI:
Resposta: 200
Órgão de Resposta:

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

Pode remover um inquilino que tenha sido adicionado a um registo. 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.

Parâmetros

Parâmetro Descrição
registrationSubscriptionD ID de assinatura para o registo.
resourceGroup O grupo de recursos para o registo.
registoName O nome do registo.
clienteSubscriçãoDida O ID de assinatura do cliente. O ID de subscrição do cliente é sensível a casos.

PowerShell

Utilize o cmdlet Remove-AzResource para remover um inquilino. Ligação para Azure Stack Hub, e, em seguida, de um pedido elevado executar o seguinte cmdlet:

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

Chamada API

Pode remover os mapeamentos do inquilino utilizando a operação DELETE.

Operação: DELETE
RequestURI:
Resposta: 204 Sem Conteúdo
Corpo de Resposta: Vazio

Passos seguintes