Compartilhar via


Registrar locatários para acompanhamento de uso no Azure Stack Hub

Este artigo contém detalhes sobre operações de registro. Você pode usar essas operações para:

  • Gerenciar registros de locatário.
  • Gerenciar o acompanhamento de uso do locatário.

Adicionar locatário ao registro

Você pode usar essa operação quando quiser adicionar um novo locatário ao seu registro. O uso do locatário é relatado em uma assinatura do Azure conectada ao locatário Microsoft Entra.

Você também pode usar essa operação para alterar a assinatura associada a um locatário. Chame PUT ou o cmdlet Do PowerShell New-AzResource para substituir o mapeamento anterior. Se você estiver usando o módulo do PowerShell do AzureRM, use o cmdlet New-AzureRMResource do PowerShell.

Você pode associar uma única assinatura do Azure a um locatário. Se você tentar adicionar uma segunda assinatura a um locatário existente, a primeira assinatura será substituída.

Usar perfis de API

Os cmdlets de registro a seguir exigem que você especifique um perfil de API ao executar o PowerShell. Os perfis de API representam um conjunto de provedores de recursos do Azure e suas versões de API. Eles ajudam você a usar a versão certa da API ao interagir com várias nuvens do Azure. Por exemplo, se você trabalhar com várias nuvens ao trabalhar com o Azure global e o Azure Stack Hub, os perfis de API especificarão um nome que corresponda à data de lançamento. Você usa o perfil 2017-09-03 .

Para obter mais informações sobre perfis de API e do Azure Stack Hub, consulte Gerenciar perfis de versão da API no Azure Stack Hub.

Parâmetros

Parâmetro Descrição
registrationSubscriptionID A assinatura do Azure que foi usada para o registro inicial.
customerSubscriptionID A assinatura do Azure (não Azure Stack Hub) que pertence ao cliente a ser registrado. Deve ser criado na oferta CSP (Provedor de Soluções na Nuvem) por meio do Partner Center. Se um cliente tiver mais de um locatário, crie uma assinatura para o locatário entrar no Azure Stack Hub. A ID da assinatura do cliente diferencia maiúsculas de minúsculas.
resourceGroup O grupo de recursos no Azure no qual seu registro está armazenado.
registrationName O nome do registro do seu Azure Stack Hub. É um objeto armazenado no Azure. O nome geralmente está no formato azurestack-CloudID, em que CloudID é a ID de nuvem da implantação do Azure Stack Hub.

Observação

Os locatários devem ser registrados com cada implantação do Azure Stack Hub que eles usam. Se um locatário usar mais de um Azure Stack Hub, atualize os registros iniciais de cada implantação com a assinatura do locatário.

PowerShell

Use o cmdlet New-AzResource para adicionar um locatário. Conecte-se ao Azure e, em seguida, em um prompt com privilégios elevados, 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 locatários registrados

Obtenha uma lista de todos os locatários que foram adicionados a um registro.

Observação

Se nenhum locatário tiver sido registrado, você não receberá uma resposta.

Parâmetros

Parâmetro Descrição
registrationSubscriptionId A assinatura do Azure que foi usada para o registro inicial.
resourceGroup O grupo de recursos no Azure no qual seu registro está armazenado.
registrationName O nome do registro da implantação do Azure Stack Hub. É um objeto armazenado no Azure. O nome geralmente está na forma de azurestack-CloudID, em que CloudID é a ID de nuvem da implantação do Azure Stack Hub.

PowerShell

Use o cmdlet Get-AzResource para listar todos os locatários registrados. Conecte-se ao Azure Stack Hub e, em seguida, em um prompt com privilégios elevados, execute 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 locatário usando a 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 locatário

Você pode remover um locatário que foi adicionado a um registro. Se esse locatário ainda estiver usando recursos no Azure Stack Hub, seu uso será cobrado para a assinatura usada no registro inicial do Azure Stack Hub.

Parâmetros

Parâmetro Descrição
registrationSubscriptionId ID da assinatura para o registro.
resourceGroup O grupo de recursos para o registro.
registrationName O nome do registro.
customerSubscriptionId A ID da assinatura do cliente. A ID da assinatura do cliente diferencia maiúsculas de minúsculas.

PowerShell

Use o cmdlet Remove-AzResource para remover um locatário. Conecte-se ao Azure Stack Hub e, em seguida, em um prompt com privilégios elevados, execute o seguinte cmdlet:

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

Chamada à API

Você pode remover mapeamentos de locatário usando 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

Próximas etapas