Partager via

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

  • Article

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

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

Ajouter un locataire à l’inscription

Vous pouvez utiliser cette opération quand vous voulez ajouter un nouveau locataire à votre inscription. L’utilisation du locataire est signalée sous un abonnement Azure connecté au locataire Microsoft Entra.

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

Vous ne pouvez associer qu’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 la spécification d’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 leurs versions d’API. Ils vous aident à utiliser la version appropriée de l’API lors de l’interaction avec plusieurs clouds Azure, Par exemple, si vous travaillez avec plusieurs clouds quand vous utilisez des infrastructures Azure et Azure Stack Hub globales, 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 des API dans Azure Stack Hub.

Paramètres

Paramètre Description
registrationSubscriptionID L’abonnement Azure qui était utilisé au moment de l’inscription.
customerSubscriptionID L’abonnement Azure (pas Azure Stack Hub) appartenant au client à inscrire. Il doit être créé dans l’offre du fournisseur de solution cloud via l’Espace partenaires. Si un client a plusieurs locataires, créez un abonnement pour le locataire pour vous connecter à Azure Stack Hub. L’ID de l’abonnement client est sensible à la casse.
resourceGroup Le groupe de ressources Azure dans lequel est stockée votre inscription.
registrationName Le nom de l’inscription de votre compte Azure Stack Hub. Il s’agit d’un objet stocké dans Azure. Le nom prend en général la forme azurestack-CloudID, où CloudID est l’ID du cloud de votre déploiement Azure Stack Hub.

Remarque

Les locataires doivent être inscrits auprès de chaque déploiement Azure Stack Hub qu’ils utilisent. Si un locataire utilise plusieurs comptes Azure Stack Hub, mettez à jour les inscriptions initiales de chaque déploiement avec l’abonnement du locataire.

PowerShell

Utilisez l’applet de commande New-AzResource pour ajouter un locataire. Connectez-vous à Azure, puis à partir d'une invite avec élévation de privilèges, exécutez la commande suivante :

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

Appel d’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 réponse : Vide

Répertorier tous les locataires inscrits

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

Remarque

Si aucun locataire n’a été inscrit, vous ne recevez aucune réponse.

Paramètres

Paramètre Description
registrationSubscriptionId L’abonnement Azure qui était utilisé au moment de l’inscription.
resourceGroup Le groupe de ressources Azure dans lequel est stockée votre inscription.
registrationName Le nom de l’inscription de votre déploiement Azure Stack Hub. Il s’agit d’un objet stocké dans Azure. Le nom prend en général la forme azurestack-CloudID, où CloudID est l’ID du cloud de votre déploiement Azure Stack Hub.

PowerShell

Utilisez la cmdlet Get-AzResource pour lister tous les locataires inscrits. Connectez-vous à Azure Stack Hub, puis à partir d’une invite de commandes avec élévation de privilèges , exécutez l’applet de commande suivante :

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

Appel d’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 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 les ressources sur Azure Stack Hub, son utilisation est facturée sur l’abonnement utilisé lors de l’inscription Azure Stack Hub initiale.

Paramètres

Paramètre Description
registrationSubscriptionId L’ID d’abonnement pour l’inscription.
resourceGroup Le groupe de ressources pour l’inscription.
registrationName Le nom de l’inscription.
customerSubscriptionId L’ID de l’abonnement client. L’ID de l’abonnement client est sensible à la casse.

PowerShell

Utilisez la cmdlet Remove-AzResource pour supprimer un abonné. Connectez-vous à Azure Stack Hub, puis à partir d’une invite de commandes avec élévation de privilèges , exécutez l’applet de commande suivante :

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

Appel d’API

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

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

Étapes suivantes