Share via


Tenants registreren voor het bijhouden van gebruik in Azure Stack Hub

Dit artikel bevat informatie over registratiebewerkingen. U kunt deze bewerkingen gebruiken voor het volgende:

  • Tenantregistraties beheren.
  • Het bijhouden van tenantgebruik beheren.

Tenant toevoegen aan registratie

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

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 de juiste versie van de API te gebruiken bij interactie met meerdere Azure-clouds. Als u bijvoorbeeld met meerdere clouds werkt wanneer u werkt met globale Azure en Azure Stack Hub, 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) van 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 zich 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 eerste 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 prompt 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
Antwoordtekst: leeg

Alle geregistreerde tenants weergeven

Een lijst ophalen 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
Antwoordtekst:

{
    "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 in Azure Stack Hub gebruikt, wordt het gebruik ervan in rekening gebracht voor het abonnement dat is 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 vanaf 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 de bewerking DELETE.

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
Antwoordtekst: leeg

Volgende stappen