Partilhar via

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

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

  • Gerencie registros de locatários.
  • Gerencie o rastreamento de uso do locatário.

Adicionar inquilino ao registo

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.

Também pode utilizar esta operação para alterar a subscrição associada a um inquilino. Chame PUT ou o cmdlet New-AzResource PowerShell para substituir o mapeamento anterior. Se estiver a usar o módulo AzureRM PowerShell, utilize o cmdlet New-AzureRMResource 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 correta 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 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
ID de Inscrição de Subscrição A assinatura do Azure que foi usada para o registro inicial.
ID de Assinatura do Cliente A assinatura do Azure, pertencente ao cliente, a ser registada (não o Azure Stack Hub). Deve ser criado na oferta do Provedor de Soluções na Nuvem (CSP) por meio do Partner Center. Se um cliente tiver mais de um locatário, crie uma assinatura para que o locatário entre no Azure Stack Hub. O ID de subscrição do cliente diferencia maiúsculas de minúsculas.
grupo de recursos O grupo de recursos no Azure no qual seu registro está armazenado.
nomeDeRegisto O nome do registro do seu Azure Stack Hub. É um objeto armazenado no Azure. O nome geralmente está na forma azurestack-CloudID, onde CloudID é a ID de nuvem da sua implantação do Azure Stack Hub.

Observação

Os locatários devem ser registrados em cada implantação do Azure Stack Hub que 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. Conectar-se ao Azuree, em seguida, a partir de um prompt elevado, execute o seguinte comando:

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

Chamada de 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
Response Body: Vazio

Listar todos os locatários registrados

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

Observação

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

Parâmetros

Parâmetro Descrição
identificaçãoDeAssinaturaDeRegisto A assinatura do Azure que foi usada para o registro inicial.
grupo de recursos O grupo de recursos no Azure no qual seu registro está armazenado.
nomeDeRegisto O nome do registo da 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 sua implantação do Azure Stack Hub.

PowerShell

Use o cmdlet Get-AzResource para listar todos os locatários registrados. Conectar-se ao Azure Stack Hube, em seguida, a partir de um prompt elevado, execute o seguinte cmdlet:

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

Chamada de 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 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}"
}

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 da assinatura usada no registro inicial do Azure Stack Hub.

Parâmetros

Parâmetro Descrição
identificaçãoDeAssinaturaDeRegisto ID de subscrição para o registo.
grupo de recursos O grupo de recursos para o registro.
nomeDeRegisto O nome do registo.
IdDeSubscriçãoDoCliente O ID da subscrição do cliente. O ID de subscrição do cliente diferencia maiúsculas de minúsculas.

PowerShell

Use o cmdlet Remove-AzResource para remover um locatário. Conectar-se ao Azure Stack Hube, em seguida, a partir de um prompt elevado, execute o seguinte cmdlet:

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

Chamada de API

Você pode remover mapeamentos de inquilino usando a operação DELETE.

Operação: ELIMINAR
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
Response Body: Vazio

Próximos passos

  • Last updated on