Registrare i tenant per il rilevamento dell'utilizzo nell'hub di Azure Stack
Questo articolo contiene informazioni dettagliate sulle operazioni di registrazione. È possibile usare queste operazioni per:
- Gestisci le registrazioni dei tenant.
- Gestire il monitoraggio dell'utilizzo del tenant.
Aggiungere un 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 di Microsoft Entra.
È anche possibile usare questa operazione per modificare la sottoscrizione associata a un tenant. Chiamare PUT o il New-AzResource cmdlet di PowerShell per sovrascrivere il mapping precedente. Se stai usando il modulo AzureRM di PowerShell, utilizza il cmdlet New-AzureRMResource di PowerShell.
È 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 dell'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. Usi 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 |
|---|---|
| IDRegistrazioneAbbonamento | Sottoscrizione di Azure usata per la registrazione iniziale. |
| IDAbbonamentoCliente | 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ù tenant, creare una sottoscrizione per il tenant per accedere all'hub di Azure Stack. L'ID sottoscrizione del cliente è sensibile alle maiuscole e minuscole. |
| gruppo di risorse | Gruppo di risorse in Azure in cui è archiviata la registrazione. |
| nomeRegistrazione | Nome della registrazione dell'hub di Azure Stack. 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 tenant.
PowerShell
Usare il cmdlet New-AzResource per aggiungere un tenant. Connettersi ad Azuree 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
URI di richiesta: 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
Ottieni l'elenco di tutti i tenant aggiunti a una registrazione.
Nota
Se non sono stati registrati inquilini, non si riceverà una risposta.
Parametri
| Parametro | Descrizione |
|---|---|
| ID iscrizione registrazione | Sottoscrizione di Azure usata per la registrazione iniziale. |
| gruppo di risorse | Gruppo di risorse in Azure in cui è archiviata la registrazione. |
| nomeRegistrazione | 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 Stacke quindi eseguire il cmdlet seguente da un prompt con privilegi elevati:
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 una mappatura di tenant
È possibile rimuovere un tenant aggiunto a una registrazione. Se il tenant usa ancora risorse nell'hub di Azure Stack, l'utilizzo viene addebitato alla sottoscrizione usata nella registrazione iniziale dell'hub di Azure Stack.
Parametri
| Parametro | Descrizione |
|---|---|
| identificativoRegistrazioneSottoscrizione | ID sottoscrizione per la registrazione. |
| gruppo di risorse | Gruppo di risorse per la registrazione. |
| nomeRegistrazione | Nome della registrazione. |
| IDAbbonamentoCliente | ID sottoscrizione del cliente. L'ID di sottoscrizione del cliente è sensibile a maiuscole e minuscole. |
PowerShell
Usare il cmdlet Remove-AzResource per rimuovere un tenant. Connettersi all'hub di Azure Stacke quindi eseguire il cmdlet seguente da un prompt con privilegi elevati:
Remove-AzResource -ResourceId "subscriptions/{registrationSubscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions/{customerSubscriptionId}" -ApiVersion 2017-06-01
Chiamata API
È possibile rimuovere i mapping dei tenant usando l'operazione DELETE.
Operazione: ELIMINA
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 Della Risposta: Vuoto