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 do Microsoft Entra.

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

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 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ê trabalha com várias nuvens ao trabalhar com o Azure global e o Azure Stack Hub, os perfis de API especificam um nome que corresponde à data de lançamento. Você usa o perfil 2017-09-03.

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

Parâmetros

Parâmetro Descrição
registrationSubscriptionID A assinatura do Azure usada para o registro inicial.
ID de Assinatura do Cliente A assinatura do Azure (não o Azure Stack Hub) que pertence ao cliente e precisa ser registrada. 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 o registro é 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 em 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 usada para o registro inicial.
resourceGroup O grupo de recursos no Azure no qual o registro é armazenado.
registrationName O nome do registro de sua implantação do Azure Stack Hub. É um objeto armazenado no Azure. O nome geralmente está na forma de azurestack-CloudID, onde 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ários 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 de 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

  • Last updated on