Registar inquilinos para controlo de utilização no Azure Stack Hub

  • Artigo

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

  • Gerir registos de inquilinos.
  • Gerir o controlo de utilização do inquilino.

Adicionar inquilino ao registo

Pode utilizar esta operação quando pretender adicionar um novo inquilino ao seu registo. A utilização do inquilino é reportada numa subscrição do Azure ligada ao inquilino Microsoft Entra.

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

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

Utilizar perfis de API

Os seguintes cmdlets de registo requerem que especifique um perfil de API ao executar o PowerShell. Os perfis de API representam um conjunto de fornecedores de recursos do Azure e as respetivas versões de API. Ajudam-no a utilizar a versão certa da API ao interagir com várias clouds do Azure. Por exemplo, se trabalhar com várias clouds ao trabalhar com o Azure global e o Azure Stack Hub, os perfis de API especificam um nome que corresponda à data de lançamento. Utiliza o perfil 2017-09-03 .

Para obter mais informações sobre o Azure Stack Hub e perfis de API, veja Manage API version profiles in Azure Stack Hub (Gerir perfis de versão da API no Azure Stack Hub).

Parâmetros

Parâmetro Description
registrationSubscriptionID A subscrição do Azure que foi utilizada para o registo inicial.
customerSubscriptionID A subscrição do Azure (não o Azure Stack Hub) pertencente ao cliente a registar. Tem de ser criado na oferta do Fornecedor de Soluções Cloud (CSP) através do Centro de Parceiros. Se um cliente tiver mais do que um inquilino, crie uma subscrição para o inquilino iniciar sessão no Azure Stack Hub. O ID da subscrição do cliente é sensível a maiúsculas e minúsculas.
resourceGroup O grupo de recursos no Azure no qual o registo está armazenado.
registrationName O nome do registo do Azure Stack Hub. É um objeto armazenado no Azure. Normalmente, o nome está no formato azurestack-CloudID, em que CloudID é o ID da cloud da sua implementação do Azure Stack Hub.

Nota

Os inquilinos têm de ser registados em cada implementaçã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 de inquilino.

PowerShell

Utilize o cmdlet New-AzResource para adicionar um inquilino. Ligue-se ao Azure e, em seguida, a partir de uma linha de comandos elevada, execute 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: subscriptions/{registrationSubscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions/{customerSubscriptionId}?api-version=2017-06-01 HTTP/1.1
Resposta: 201 Criado
Corpo da Resposta: Vazio

Listar todos os inquilinos registados

Obtenha uma lista de todos os inquilinos que foram adicionados a um registo.

Nota

Se não tiverem sido registados inquilinos, não receberá uma resposta.

Parâmetros

Parâmetro Description
registrationSubscriptionId A subscrição do Azure que foi utilizada para o registo inicial.
resourceGroup O grupo de recursos no Azure no qual o registo está armazenado.
registrationName O nome do registo da implementação do Azure Stack Hub. É um objeto armazenado no Azure. Normalmente, o nome está na forma de azurestack-CloudID, em que CloudID é o ID da cloud da sua implementação do Azure Stack Hub.

PowerShell

Utilize o cmdlet Get-AzResource para listar todos os inquilinos registados. Ligue-se ao Azure Stack Hub e, em seguida, a partir de uma linha de comandos elevada, execute o seguinte cmdlet:

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

Chamada à API

Pode obter uma lista de todos os mapeamentos de inquilinos através da operação GET.

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

Remover 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 respetiva utilização será cobrada na subscrição utilizada no registo inicial do Azure Stack Hub.

Parâmetros

Parâmetro Description
registrationSubscriptionId ID da subscrição do registo.
resourceGroup O grupo de recursos do registo.
registrationName O nome do registo.
customerSubscriptionId O ID da subscrição do cliente. O ID da subscrição do cliente é sensível a maiúsculas e minúsculas.

PowerShell

Utilize o cmdlet Remove-AzResource para remover um inquilino. Ligue-se ao Azure Stack Hub e, em seguida, a partir de uma linha de comandos elevada, execute 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 mapeamentos de inquilinos com a operação DELETE.

Operação: DELETE
RequestURI: subscriptions/{registrationSubscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions/{customerSubscriptionId}?api-version=2017-06-01 HTTP/1.1
Resposta: 204 Sem Conteúdo
Corpo da Resposta: Vazio

Passos seguintes