Registrare i tenant per il rilevamento dell'utilizzo nell'hub di Azure Stack

  • Articolo

Questo articolo contiene informazioni dettagliate sulle operazioni di registrazione. È possibile usare queste operazioni per:

  • Gestire le registrazioni del tenant.
  • Gestire il rilevamento dell'utilizzo del tenant.

Aggiungere il tenant alla registrazione

È possibile usare questa operazione quando si vuole aggiungere un nuovo tenant alla registrazione. L'utilizzo del tenant viene segnalato in una sottoscrizione di Azure connessa al tenant Microsoft Entra.

È anche possibile usare questa operazione per modificare la sottoscrizione associata a un tenant. Chiamare PUT o il cmdlet di PowerShell New-AzResource per sovrascrivere il mapping precedente. Se si usa il modulo AzureRM PowerShell, usare il cmdlet PowerShell New-AzureRMResource .

È possibile associare una singola sottoscrizione di Azure a un tenant. Se si tenta di aggiungere una seconda sottoscrizione a un tenant esistente, la prima sottoscrizione viene sovrascritta.

Usare i profili API

I cmdlet di registrazione seguenti richiedono di specificare un profilo API durante l'esecuzione di PowerShell. I profili API rappresentano un set di provider di risorse di Azure e le relative versioni api. Consentono di usare la versione corretta dell'API durante l'interazione con più cloud di Azure. Ad esempio, se si usano più cloud quando si usano Azure globale e l'hub di Azure Stack, i profili API specificano un nome corrispondente alla data di rilascio. Si usa il profilo 2017-09-03 .

Per altre informazioni sull'hub di Azure Stack e sui profili API, vedere Gestire i profili di versione dell'API nell'hub di Azure Stack.

Parametri

Parametro Descrizione
registrationSubscriptionID Sottoscrizione di Azure usata per la registrazione iniziale.
customerSubscriptionID La sottoscrizione di Azure (non hub di Azure Stack) appartenente al cliente da registrare. Deve essere creato nell'offerta Cloud Solution Provider (CSP) tramite il Centro per i partner. Se un cliente ha più di un tenant, creare una sottoscrizione per il tenant per accedere all'hub di Azure Stack. L'ID sottoscrizione del cliente fa distinzione tra maiuscole e minuscole.
resourceGroup Il gruppo di risorse in Azure in cui viene archiviata la registrazione del CSP.
registrationName Il nome della registrazione dell'hub di Azure Stack del CSP. Si tratta di un oggetto archiviato in Azure. Il nome è in genere nel formato azurestack-CloudID, dove CloudID è l'ID cloud della distribuzione dell'hub di Azure Stack.

Nota

I tenant devono essere registrati con ogni distribuzione dell'hub di Azure Stack usata. Se un tenant usa più di un hub di Azure Stack, aggiornare le registrazioni iniziali di ogni distribuzione con la sottoscrizione del tenant.

PowerShell

Usare il cmdlet New-AzResource per aggiungere un tenant. Connettersi ad Azure e quindi da un prompt con privilegi elevati eseguire il comando seguente:

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

Chiamata API

Operazione: PUT
RequestURI: subscriptions/{registrationSubscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions/{customerSubscriptionId}?api-version=2017-06-01 HTTP/1.1
Risposta: 201 Creato
Corpo della risposta: vuoto

Elencare tutti i tenant registrati

Ottenere un elenco di tutti i tenant aggiunti a una registrazione.

Nota

Se non sono stati registrati tenant, non si riceverà una risposta.

Parametri

Parametro Descrizione
registrationSubscriptionId Sottoscrizione di Azure usata per la registrazione iniziale.
resourceGroup Il gruppo di risorse in Azure in cui viene archiviata la registrazione del CSP.
registrationName Nome della registrazione della distribuzione dell'hub di Azure Stack. Si tratta di un oggetto archiviato in Azure. Il nome è in genere sotto forma di azurestack-CloudID, dove CloudID è l'ID cloud della distribuzione dell'hub di Azure Stack.

PowerShell

Usare il cmdlet Get-AzResource per elencare tutti i tenant registrati. Connettersi all'hub di Azure Stack e quindi da un prompt con privilegi elevati eseguire il cmdlet seguente:

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

Chiamata API

È possibile ottenere un elenco di tutti i mapping dei tenant usando l'operazione GET.

Operazione: GET
RequestURI: subscriptions/{registrationSubscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions?api-version=2017-06-01 HTTP/1.1
Risposta: 200
Corpo della risposta:

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

Rimuovere un mapping di tenant

È possibile rimuovere un tenant aggiunto a una registrazione. Se il tenant usa ancora le risorse nell'hub di Azure Stack, l'utilizzo viene addebitato alla sottoscrizione usata nella registrazione iniziale dell'hub di Azure Stack.

Parametri

Parametro Descrizione
registrationSubscriptionId ID sottoscrizione per la registrazione.
resourceGroup Gruppo di risorse per la registrazione.
registrationName Nome della registrazione.
customerSubscriptionId ID sottoscrizione del cliente. L'ID sottoscrizione del cliente fa distinzione tra maiuscole e minuscole.

PowerShell

Usare il cmdlet Remove-AzResource per rimuovere un tenant. Connettersi all'hub di Azure Stack e quindi da un prompt con privilegi elevati eseguire il cmdlet seguente:

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

Chiamata API

È possibile rimuovere i mapping del tenant usando l'operazione DELETE.

Operazione: DELETE
RequestURI: subscriptions/{registrationSubscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions/{customerSubscriptionId}?api-version=2017-06-01 HTTP/1.1
Risposta: 204 Nessun contenuto
Corpo risposta: vuoto

Passaggi successivi