Tenants registreren voor het bijhouden van gebruik in Azure Stack Hub

  • Artikel
  • 4 minuten om te lezen

Dit artikel bevat informatie over registratiebewerkingen. U kunt deze bewerkingen gebruiken om:

  • Tenantregistraties beheren.
  • Het bijhouden van tenantgebruik beheren.

Tenant toevoegen aan registratie

U kunt deze bewerking gebruiken wanneer u een nieuwe tenant wilt toevoegen aan uw registratie. Tenantgebruik wordt gerapporteerd onder een Azure-abonnement dat is verbonden met de Azure Ad-tenant (Azure Active Directory).

U kunt deze bewerking ook gebruiken om het abonnement te wijzigen dat is gekoppeld aan een tenant. Roep PUT of de PowerShell-cmdlet New-AzResource aan om de vorige toewijzing te overschrijven. Als u de AzureRM PowerShell-module gebruikt, gebruikt u de PowerShell-cmdlet New-AzureRMResource .

U kunt één Azure-abonnement koppelen aan een tenant. Als u probeert een tweede abonnement toe te voegen aan een bestaande tenant, wordt het eerste abonnement overschreven.

API-profielen gebruiken

Voor de volgende registratie-cmdlets moet u een API-profiel opgeven bij het uitvoeren van PowerShell. API-profielen vertegenwoordigen een set Azure-resourceproviders en hun API-versies. Ze helpen u bij het gebruik van de juiste versie van de API bij interactie met meerdere Azure-clouds. Als u bijvoorbeeld met meerdere clouds werkt wanneer u met globale Azure en Azure Stack Hub werkt, geven API-profielen een naam op die overeenkomt met de releasedatum. U gebruikt het profiel 2017-09-03 .

Zie API-versieprofielen beheren in Azure Stack Hub voor meer informatie over Azure Stack Hub- en API-profielen.

Parameters

Parameter Beschrijving
registrationSubscriptionID Het Azure-abonnement dat is gebruikt voor de eerste registratie.
customerSubscriptionID Het Azure-abonnement (niet Azure Stack Hub) dat hoort bij de klant die moet worden geregistreerd. Moet worden gemaakt in de CSP-aanbieding (Cloud Solution Provider) via het Partnercentrum. Als een klant meer dan één tenant heeft, maakt u een abonnement voor de tenant om u aan te melden bij Azure Stack Hub. De abonnements-id van de klant is hoofdlettergevoelig.
resourceGroup De resourcegroep in Azure waarin uw registratie is opgeslagen.
registrationName De naam van de registratie van uw Azure Stack Hub. Het is een object dat is opgeslagen in Azure. De naam heeft meestal de vorm azurestack-CloudID, waarbij CloudID de cloud-id is van uw Azure Stack Hub-implementatie.

Notitie

Tenants moeten worden geregistreerd bij elke Azure Stack Hub-implementatie die ze gebruiken. Als een tenant meer dan één Azure Stack Hub gebruikt, werkt u de initiële registraties van elke implementatie bij met het tenantabonnement.

PowerShell

Gebruik de cmdlet New-AzResource om een tenant toe te voegen. Maak verbinding met Azure en voer vervolgens vanaf een opdrachtprompt met verhoogde bevoegdheid de volgende opdracht uit:

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

API-aanroep

Bewerking: PUT
RequestURI: subscriptions/{registrationSubscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions/{customerSubscriptionId}?api-version=2017-06-01 HTTP/1.1
Antwoord: 201 gemaakt
Hoofdtekst van antwoord: leeg

Alle geregistreerde tenants weergeven

Haal een lijst op met alle tenants die zijn toegevoegd aan een registratie.

Notitie

Als er geen tenants zijn geregistreerd, ontvangt u geen antwoord.

Parameters

Parameter Beschrijving
registrationSubscriptionId Het Azure-abonnement dat is gebruikt voor de eerste registratie.
resourceGroup De resourcegroep in Azure waarin uw registratie is opgeslagen.
registrationName De naam van de registratie van uw Azure Stack Hub-implementatie. Het is een object dat is opgeslagen in Azure. De naam heeft meestal de vorm van azurestack-CloudID, waarbij CloudID de cloud-id is van uw Azure Stack Hub-implementatie.

PowerShell

Gebruik de cmdlet Get-AzResource om alle geregistreerde tenants weer te geven. Maak verbinding met Azure Stack Hub en voer vervolgens vanaf een prompt met verhoogde bevoegdheid de volgende cmdlet uit:

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

API-aanroep

U kunt een lijst met alle tenanttoewijzingen ophalen met behulp van de GET-bewerking.

Bewerking: GET
RequestURI: subscriptions/{registrationSubscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions?api-version=2017-06-01 HTTP/1.1
Antwoord: 200
Hoofdtekst van antwoord:

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

Een tenanttoewijzing verwijderen

U kunt een tenant verwijderen die is toegevoegd aan een registratie. Als die tenant nog steeds resources gebruikt in Azure Stack Hub, wordt het gebruik ervan in rekening gebracht voor het abonnement dat wordt gebruikt in de eerste Azure Stack Hub-registratie.

Parameters

Parameter Beschrijving
registrationSubscriptionId Abonnements-id voor de registratie.
resourceGroup De resourcegroep voor de registratie.
registrationName De naam van de registratie.
customerSubscriptionId De abonnements-id van de klant. De abonnements-id van de klant is hoofdlettergevoelig.

PowerShell

Gebruik de cmdlet Remove-AzResource om een tenant te verwijderen. Maak verbinding met Azure Stack Hub en voer vervolgens vanuit een prompt met verhoogde bevoegdheid de volgende cmdlet uit:

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

API-aanroep

U kunt tenanttoewijzingen verwijderen met behulp van de delete-bewerking.

Bewerking: DELETE
RequestURI: subscriptions/{registrationSubscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions/{customerSubscriptionId}?api-version=2017-06-01 HTTP/1.1
Antwoord: 204 Geen inhoud
Hoofdtekst van antwoord: leeg

Volgende stappen