Inscrire des locataires pour le suivi de l’utilisation dans Azure Stack Hub

Cet article contient des détails sur les opérations d’inscription. Vous pouvez utiliser ces opérations pour :

• Gérer les inscriptions de locataires.
• Gérer le suivi de l'utilisation par les locataires.

Ajouter un locataire à l’inscription

Vous pouvez utiliser cette opération lorsque vous souhaitez ajouter un nouveau locataire à votre inscription. L'utilisation du locataire est signalée dans le cadre d'un abonnement Azure lié au locataire Microsoft Entra.

Vous pouvez également utiliser cette opération pour modifier l’abonnement associé à un locataire. Appelez PUT ou l’applet de commande PowerShell New-AzResource pour remplacer le mappage précédent. Si vous utilisez le module AzureRM PowerShell, utilisez l’applet de commande PowerShell New-AzureRMResource .

Vous pouvez associer un seul abonnement Azure à un locataire. Si vous essayez d’ajouter un deuxième abonnement à un locataire existant, le premier abonnement est remplacé.

Utiliser des profils d’API

Les applets de commande d’inscription suivantes nécessitent que vous spécifiiez un profil d’API lors de l’exécution de PowerShell. Les profils d’API représentent un ensemble de fournisseurs de ressources Azure et de leurs versions d’API. Ils vous aident à utiliser la bonne version de l’API lors de l’interaction avec plusieurs clouds Azure. Par exemple, si vous travaillez avec plusieurs clouds lors de l’utilisation d’Azure global et d’Azure Stack Hub, les profils d’API spécifient un nom qui correspond à leur date de publication. Vous utilisez le profil 2017-09-03.

Pour plus d’informations sur azure Stack Hub et les profils d’API, consultez Gérer les profils de version d’API dans Azure Stack Hub.

Paramètres

PowerShell

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

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

Appel API

Opération : PUT
RequestURI : subscriptions/{registrationSubscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions/{customerSubscriptionId}?api-version=2017-06-01 HTTP/1.1
Réponse : 201 Créé
Corps de la réponse : vide

Répertorier tous les locataires inscrits

Obtenez la liste de tous les locataires qui ont été ajoutés à une inscription.

Paramètres

PowerShell

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

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

Appel API

Vous pouvez obtenir une liste de tous les mappages de locataires à l’aide de l’opération GET.

Opération : GET
RequestURI : subscriptions/{registrationSubscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions?api-version=2017-06-01 HTTP/1.1
Réponse : 200
Corps de la réponse :

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

Supprimer un mappage de locataire

Vous pouvez supprimer un locataire qui a été ajouté à une inscription. Si ce locataire utilise toujours des ressources sur Azure Stack Hub, son utilisation est facturée à l’abonnement utilisé dans l’inscription Initiale d’Azure Stack Hub.

Paramètres

PowerShell

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

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

Appel API

Vous pouvez supprimer des mappages de locataires à l’aide de l’opération DELETE.

Opération : DELETE
RequestURI : subscriptions/{registrationSubscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions/{customerSubscriptionId}?api-version=2017-06-01 HTTP/1.1
Réponse : 204 Aucun contenu
Corps de la réponse : vide

Étapes suivantes

• Comment récupérer des informations d’utilisation des ressources à partir d’Azure Stack Hub