Registrera klientorganisationer för användningsspårning i Azure Stack Hub

  • Artikel

Den här artikeln innehåller information om registreringsåtgärder. Du kan använda dessa åtgärder för att:

  • Hantera klientregistreringar.
  • Hantera spårning av klientorganisationsanvändning.

Lägga till klientorganisation i registreringen

Du kan använda den här åtgärden när du vill lägga till en ny klientorganisation i din registrering. Klientanvändning rapporteras under en Azure-prenumeration som är ansluten till Microsoft Entra klientorganisation.

Du kan också använda den här åtgärden för att ändra prenumerationen som är associerad med en klientorganisation. Anropa PUT eller PowerShell-cmdleten New-AzResource för att skriva över den tidigare mappningen. Om du använder AzureRM PowerShell-modulen använder du PowerShell-cmdleten New-AzureRMResource .

Du kan associera en enskild Azure-prenumeration med en klientorganisation. Om du försöker lägga till en andra prenumeration i en befintlig klientorganisation skrivs den första prenumerationen över.

Använda API-profiler

Följande registrerings-cmdletar kräver att du anger en API-profil när du kör PowerShell. API-profiler representerar en uppsättning Azure-resursprovidrar och deras API-versioner. De hjälper dig att använda rätt version av API:et när du interagerar med flera Azure-moln. Om du till exempel arbetar med flera moln när du arbetar med globala Azure och Azure Stack Hub anger API-profiler ett namn som matchar deras utgivningsdatum. Du använder profilen 2017-09-03 .

Mer information om Azure Stack Hub- och API-profiler finns i Hantera API-versionsprofiler i Azure Stack Hub.

Parametrar

Parameter Beskrivning
registrationSubscriptionID Den Azure-prenumeration som användes för den första registreringen.
customerSubscriptionID Den Azure-prenumeration (inte Azure Stack Hub) som tillhör kunden som ska registreras. Måste skapas i erbjudandet molnlösningsleverantör (CSP) via Partnercenter. Om en kund har fler än en klientorganisation skapar du en prenumeration för klientorganisationen för att logga in på Azure Stack Hub. Kundens prenumerations-ID är skiftlägeskänsligt.
resourceGroup Resursgruppen i Azure där din registrering lagras.
registrationName Namnet på registreringen av din Azure Stack Hub. Det är ett objekt som lagras i Azure. Namnet är vanligtvis i formatet azurestack-CloudID, där CloudID är moln-ID för din Azure Stack Hub-distribution.

Anteckning

Klientorganisationer måste registreras för varje Azure Stack Hub-distribution som de använder. Om en klient använder mer än en Azure Stack Hub uppdaterar du de första registreringarna för varje distribution med klientprenumerationen.

PowerShell

Använd cmdleten New-AzResource för att lägga till en klientorganisation. Anslut till Azure och kör sedan följande kommando från en upphöjd fråga:

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

API-anrop

Åtgärd: PUT
RequestURI: subscriptions/{registrationSubscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions/{customerSubscriptionId}?api-version=2017-06-01 HTTP/1.1
Svar: 201 skapades
Svarstext: Tom

Visa en lista över alla registrerade klienter

Hämta en lista över alla klienter som har lagts till i en registrering.

Anteckning

Om inga klienter har registrerats får du inget svar.

Parametrar

Parameter Beskrivning
registrationSubscriptionId Den Azure-prenumeration som användes för den första registreringen.
resourceGroup Resursgruppen i Azure där din registrering lagras.
registrationName Namnet på registreringen av din Azure Stack Hub-distribution. Det är ett objekt som lagras i Azure. Namnet är vanligtvis i form av azurestack-CloudID, där CloudID är moln-ID för din Azure Stack Hub-distribution.

PowerShell

Använd cmdleten Get-AzResource för att visa en lista över alla registrerade klienter. Anslut till Azure Stack Hub och kör sedan följande cmdlet från en upphöjd fråga:

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

API-anrop

Du kan hämta en lista över alla klientmappningar med hjälp av GET-åtgärden.

Åtgärd: GET
RequestURI: subscriptions/{registrationSubscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions?api-version=2017-06-01 HTTP/1.1
Svar: 200
Svarstext:

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

Ta bort en klientmappning

Du kan ta bort en klientorganisation som har lagts till i en registrering. Om klientorganisationen fortfarande använder resurser på Azure Stack Hub debiteras deras användning för den prenumeration som användes i den första Azure Stack Hub-registreringen.

Parametrar

Parameter Beskrivning
registrationSubscriptionId Prenumerations-ID för registreringen.
resourceGroup Resursgruppen för registreringen.
registrationName Namnet på registreringen.
customerSubscriptionId Kundens prenumerations-ID. Kundens prenumerations-ID är skiftlägeskänsligt.

PowerShell

Använd cmdleten Remove-AzResource för att ta bort en klientorganisation. Anslut till Azure Stack Hub och kör sedan följande cmdlet från en upphöjd prompt:

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

API-anrop

Du kan ta bort klientmappningar med hjälp av DELETE-åtgärden.

Åtgärd: TA BORT
RequestURI: subscriptions/{registrationSubscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions/{customerSubscriptionId}?api-version=2017-06-01 HTTP/1.1
Svar: 204 Inget innehåll
Svarstext: Tom

Nästa steg