Créer des abonnements Azure programmatiquement avec des API héritées
Cet article explique comment créer des abonnements Azure programmatiquement à l’aide de la préversion héritée de l’API. Dans cet article, vous apprenez à créer des abonnements par programmation en utilisant Azure Resource Manager.
Nous disposons de nouveaux articles pour la dernière version de l’API à utiliser avec différents types d’abonnements de contrat Azure :
- Créer des abonnements EA programmatiquement avec la dernière API
- Créer des abonnements MCA programmatiquement avec la dernière API
- Créer des abonnements MPA programmatiquement avec la dernière API
Toutefois, si vous ne souhaitez pas utiliser la dernière version d’API, vous pouvez quand même utiliser les informations de cet article.
Les clients Azure disposant d’un compte de facturation pour les types de contrat suivants peuvent créer des abonnements programmatiquement :
- Contrat Entreprise
- Contrat client Microsoft (MCA)
- Contrat Partenaire Microsoft (MPA)
Quand vous créez un abonnement Azure programmatiquement, cet abonnement est régi par le contrat applicable à votre achat de services Azure auprès de Microsoft ou d’un revendeur agréé. Pour plus d’informations, consultez Informations légales relatives à Microsoft Azure.
Notes
Nous vous recommandons d’utiliser le module Azure Az PowerShell pour interagir avec Azure. Pour commencer, consultez Installer Azure PowerShell. Pour savoir comment migrer vers le module Az PowerShell, consultez Migrer Azure PowerShell depuis AzureRM vers Az.
Vous ne pouvez pas créer de plans de support par programmation. Vous pouvez acheter un nouveau plan de support ou en mettre un à niveau dans le portail Azure. Accédez à Aide + support, puis en haut de la page, sélectionnez Choisir le plan de support approprié.
Créer des abonnements pour un compte de facturation EA
Consultez les sections suivantes pour savoir comment créer des abonnements EA.
Prérequis
Vous devez disposer d’un rôle Propriétaire sur un compte d’inscription ou être Administrateur de l’entreprise pour créer un abonnement. Vous pouvez obtenir ce rôle de deux manières :
- L’administrateur d’entreprise de votre inscription peut vous rendre propriétaire d’un compte (connexion obligatoire), ce qui vous rend propriétaire du compte d’inscription.
- Un propriétaire existant du compte d’inscription peut vous accorder l’accès. De la même façon, si vous souhaitez utiliser un principal de service pour créer un abonnement EA, vous devez autoriser ce principal de service à créer des abonnements.
Rechercher les comptes auxquels vous avez accès
Une fois que vous avez été ajouté à un compte d’inscription associé à un propriétaire de compte, Azure utilise la relation entre le compte et l’inscription pour déterminer où facturer les frais d’abonnement. Tous les abonnements créés sous le compte sont facturés à l’inscription EA à laquelle appartient ce compte. Pour créer des abonnements, vous devez transmettre les valeurs sur le compte d’inscription et les principaux d’utilisateur pour qu’ils obtiennent la propriété de l’abonnement.
Pour exécuter les commandes suivantes, vous devez être connecté au répertoire de base du propriétaire de compte, qui est le répertoire dans lequel les abonnements sont créés par défaut.
Requête pour obtenir la liste de tous les comptes d’inscription auxquels vous avez accès :
GET https://management.azure.com/providers/Microsoft.Billing/enrollmentAccounts?api-version=2018-03-01-preview
En réponse, l’API retourne la liste de tous les comptes d’inscription auxquels vous avez accès :
{
"value": [
{
"id": "/providers/Microsoft.Billing/enrollmentAccounts/747ddfe5-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"name": "747ddfe5-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"type": "Microsoft.Billing/enrollmentAccounts",
"properties": {
"principalName": "SignUpEngineering@contoso.com"
}
},
{
"id": "/providers/Microsoft.Billing/enrollmentAccounts/4cd2fcf6-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"name": "4cd2fcf6-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"type": "Microsoft.Billing/enrollmentAccounts",
"properties": {
"principalName": "BillingPlatformTeam@contoso.com"
}
}
]
}
Utilisez la propriété principalName pour identifier le compte auquel vous souhaitez que soient facturés les abonnements. Copiez l’élément name de ce compte. Par exemple, pour créer des abonnements dans le compte d’inscription SignUpEngineering@contoso.com, copiez 747ddfe5-xxxx-xxxx-xxxx-xxxxxxxxxxxx. L’identificateur est l’ID d’objet du compte d’inscription. Collez cette valeur quelque part, de façon à pouvoir l’utiliser à l’étape suivante en tant que enrollmentAccountObjectId.
Créer des abonnements sous un compte d’inscription spécifique
L’exemple suivant crée un abonnement nommé Dev Team Subscription dans le compte d’inscription sélectionné à l’étape précédente. L’offre d’abonnement est MS-AZR - 0017p (Accord Entreprise Microsoft standard). Elle ajoute également en option deux utilisateurs en tant que propriétaires de RBAC pour l’abonnement.
Envoyez la requête suivante, en remplaçant <enrollmentAccountObjectId> par l’élément name copié lors de la première étape (747ddfe5-xxxx-xxxx-xxxx-xxxxxxxxxxxx). Pour spécifier des propriétaires, consultez Comment obtenir les ID d’objet utilisateur.
POST https://management.azure.com/providers/Microsoft.Billing/enrollmentAccounts/<enrollmentAccountObjectId>/providers/Microsoft.Subscription/createSubscription?api-version=2018-03-01-preview
{
"displayName": "Dev Team Subscription",
"offerType": "MS-AZR-0017P",
"owners": [
{
"objectId": "<userObjectId>"
},
{
"objectId": "<servicePrincipalObjectId>"
}
]
}
| Nom de l’élément | Obligatoire | Type | Description |
|---|---|---|---|
displayName |
Non | String | Nom d’affichage de l’abonnement. Si cet élément n’est pas spécifié, il est défini sur le nom de l’offre, tel que « Microsoft Azure Enterprise ». |
offerType |
Oui | String | Offre de l’abonnement. Les deux options pour EA sont MS-AZR-0017P (utilisation en production) et MS-AZR-0148P (dev/test, doit être activée dans le Portail Azure). |
owners |
Non | String | ID d’objet d’un utilisateur devant être ajouté en tant que propriétaire RBAC Azure dans l’abonnement au moment de sa création. |
Dans la réponse, dans le cadre de l’en-tête Location, vous récupérez une URL pour laquelle vous pouvez rechercher l’état de l’opération de création d’abonnement. Quand la création de l’abonnement est terminée, une instruction GET sur l’URL Location retourne un objet subscriptionLink, qui comprend l’ID d’abonnement. Pour plus d’informations, consultez la documentation de l’API Abonnement.
Limitations de l’API de création d’abonnement Azure Enterprise
- Seuls des abonnements Azure Enterprise peuvent être créés à l’aide de l’API.
- Il existe une limite de 5 000 abonnements par compte d’inscription. Au-delà de cette limite, les abonnements supplémentaires pour le compte peuvent être créés uniquement à partir du portail Azure. Si vous souhaitez créer des abonnements supplémentaires via l’API, créez un autre compte d’inscription. Les abonnements annulés, supprimés et transférés sont pris en compte dans la limite de 5000.
- Les utilisateurs qui ne sont pas propriétaires de compte, mais qui ont été ajoutés à un compte d’inscription avec Azure RBAC, ne peuvent pas créer d’abonnements dans le portail Azure.
- Vous ne pouvez pas sélectionner le locataire où l’abonnement doit être créé. L’abonnement est toujours créé dans le locataire de base du propriétaire du compte. Pour déplacer l’abonnement vers un autre locataire, consultez Changer le locataire d’abonnement.
Créer des abonnements pour un compte MCA
Utilisez les informations des sections suivantes pour savoir comment créer un compte MCA.
Prérequis
Vous devez avoir un rôle Propriétaire, Contributeur ou Créateur de l’abonnement Azure sur une section de facture ou bien un rôle Propriétaire ou Contributeur sur un profil de facturation ou un compte de facturation pour créer des abonnements. Pour plus d’informations, consultez Rôles et tâches liés à la facturation des abonnements.
Les exemples suivants utilisent les API REST. Actuellement, PowerShell et Azure CLI ne sont pas pris en charge.
Rechercher les comptes de facturation auxquels vous avez accès
Exécutez la requête suivante pour lister tous les comptes de facturation.
GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts?api-version=2019-10-01-preview
En réponse, l’API retourne la liste de tous les comptes de facturation auxquels vous avez accès.
{
"value": [
{
"id": "/providers/Microsoft.Billing/billingAccounts/5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx",
"name": "5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx",
"properties": {
"accountId": "5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"accountStatus": "Active",
"accountType": "Enterprise",
"agreementType": "MicrosoftCustomerAgreement",
"displayName": "Contoso",
"hasReadAccess": true,
"organizationId": "41b29574-xxxx-xxxx-xxxx-xxxxxxxxxxxxx_xxxx-xx-xx"
},
"type": "Microsoft.Billing/billingAccounts"
},
{
"id": "/providers/Microsoft.Billing/billingAccounts/4f89e155-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx",
"name": "4f89e155-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx",
"properties": {
"accountId": "4f89e155-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"accountStatus": "Active",
"accountType": "Enterprise",
"agreementType": "MicrosoftCustomerAgreement",
"displayName": "Fabrikam",
"hasReadAccess": true,
"organizationId": "41b29574-xxxx-xxxx-xxxx-xxxxxxxxxxxxx_xxxx-xx-xx"
},
"type": "Microsoft.Billing/billingAccounts"
}
]
}
Utilisez la propriété displayName afin d’identifier le compte de facturation pour lequel vous souhaitez créer des abonnements. Vérifiez que le compte affiche MicrosoftCustomerAgreement comme agreementType. Copiez la valeur name du compte. Par exemple, si vous souhaitez créer un abonnement pour le compte de facturation Contoso, copiez 5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx. Collez cette valeur quelque part, de façon à pouvoir l’utiliser à l’étape suivante.
Rechercher les sections de facture pour créer des abonnements
Les frais de votre abonnement sont indiqués dans une section de la facture d’un profil de facturation. Utilisez l’API suivante pour obtenir la liste des sections de facture et des profils de facturation sur lesquels vous avez l’autorisation de créer des abonnements Azure.
Envoyez la requête suivante, en remplaçant <billingAccountName> par l’élément name copié lors de la première étape (5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx).
POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/<billingAccountName>/listInvoiceSectionsWithCreateSubscriptionPermission?api-version=2019-10-01-preview
En réponse, l’API retourne la liste de toutes les sections de facture et des profils de facturation associés auxquels vous avez accès pour créer des abonnements :
{
"value": [{
"billingProfileDisplayName": "Contoso finance",
"billingProfileId": "/providers/Microsoft.Billing/billingAccounts/5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/billingProfiles/PBFV-xxxx-xxx-xxx",
"enabledAzurePlans": [{
"productId": "DZH318Z0BPS6",
"skuId": "0001",
"skuDescription": "Microsoft Azure Plan"
}, {
"productId": "DZH318Z0BPS6",
"skuId": "0002",
"skuDescription": "Microsoft Azure Plan for DevTest"
}],
"invoiceSectionDisplayName": "Development",
"invoiceSectionId": "/providers/Microsoft.Billing/billingAccounts/5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/billingProfiles/PBFV-xxxx-xxx-xxx/invoiceSections/GJ77-xxxx-xxx-xxx"
}, {
"billingProfileDisplayName": "Contoso finance",
"billingProfileId": "/providers/Microsoft.Billing/billingAccounts/5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/billingProfiles/PBFV-xxxx-xxx-xxx",
"enabledAzurePlans": [{
"productId": "DZH318Z0BPS6",
"skuId": "0001",
"skuDescription": "Microsoft Azure Plan"
}, {
"productId": "DZH318Z0BPS6",
"skuId": "0002",
"skuDescription": "Microsoft Azure Plan for DevTest"
}],
"invoiceSectionDisplayName": "Testing",
"invoiceSectionId": "/providers/Microsoft.Billing/billingAccounts/5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/billingProfiles/PBFV-XXXX-XXX-XXX/invoiceSections/GJGR-XXXX-XXX-XXX"
}]
}
Utilisez la propriété invoiceSectionDisplayName afin d’identifier la section de facture pour laquelle vous souhaitez créer des abonnements. Copiez la valeur invoiceSectionId, la valeur billingProfileId et l’une des valeurs skuId pour la section facture. Par exemple, si vous souhaitez créer un abonnement de type Microsoft Azure plan pour la section de facture Development, copiez /providers/Microsoft.Billing/billingAccounts/5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_2019-05-31/billingProfiles/PBFV-XXXX-XXX-XXX/invoiceSections/GJGR-XXXX-XXX-XXX, /providers/Microsoft.Billing/billingAccounts/5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_2019-05-31/billingProfiles/PBFV-xxxx-xxx-xxx et 0001. Collez ces valeurs quelque part, car vous en aurez besoin à l’étape suivante.
Créer un abonnement pour une section de facture
L’exemple suivant crée un abonnement nommé Dev Team subscription de type Microsoft Azure Plan pour la section de facture Development. Cet abonnement est facturé sur le profil de facturation de Contoso finance et apparaîtra dans la section Development de la facture correspondante.
Exécutez la requête suivante, en remplaçant <invoiceSectionId> par la valeur invoiceSectionId que vous avez copiée à la deuxième étape (/providers/Microsoft.Billing/billingAccounts/5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_2019-05-31/billingProfiles/PBFV-XXXX-XXX-XXX/invoiceSections/GJGR-XXXX-XXX-XXX). Passez les valeurs billingProfileId et skuId que vous avez copiées à la deuxième étape dans les paramètres de requête de l’API. Pour spécifier des propriétaires, consultez Comment obtenir les ID d’objet utilisateur.
POST https://management.azure.com<invoiceSectionId>/providers/Microsoft.Subscription/createSubscription?api-version=2018-11-01-preview
'{"displayName": "Dev Team subscription",
"billingProfileId": "<billingProfileId>",
"skuId": "<skuId>",
"owners": [
{
"objectId": "<userObjectId>"
},
{
"objectId": "<servicePrincipalObjectId>"
}
],
"costCenter": "35683",
"managementGroupId": "/providers/Microsoft.Management/managementGroups/xxxxxxx",",
}'
| Nom de l’élément | Obligatoire | Type | Description |
|---|---|---|---|
displayName |
Oui | String | Nom d’affichage de l’abonnement. |
billingProfileId |
Oui | String | ID du profil de facturation sur lequel les frais de l’abonnement sont facturés. |
skuId |
Oui | String | Référence SKU qui détermine le type de plan Azure. |
owners |
Non | String | ID d’objet du principal de service ou de l’utilisateur à ajouter comme propriétaire Azure RBAC dans l’abonnement au moment de sa création. |
costCenter |
Non | String | Centre de coûts associé à l’abonnement. Il est indiqué dans le fichier CSV de l’utilisation. |
managementGroupId |
Non | String | ID du groupe d’administration auquel l’abonnement sera ajouté. Pour obtenir la liste des groupes d’administration, consultez Groupes d’administration - Lister les API. Utilisez l’ID d’un groupe d’administration fourni par l’API. |
Dans la réponse, vous obtenez un objet subscriptionCreationResult pour le monitoring. Quand la création de l’abonnement est terminée, l’objet subscriptionCreationResult retourne un objet subscriptionLink, qui a l’ID d’abonnement.
Créer des abonnements pour un compte de facturation MPA
Utilisez les informations des sections suivantes pour savoir comment créer un compte de facturation MPA.
Prérequis
Pour créer un abonnement associé à votre compte de facturation, vous devez avoir un rôle Administrateur général ou Agent d’administration pour le compte du fournisseur de solutions Cloud au sein de votre organisation. Pour plus d’informations, consultez Espace partenaires - Affecter des rôles et des autorisations aux utilisateurs.
Les exemples suivants utilisent les API REST. Actuellement, PowerShell et Azure CLI ne sont pas pris en charge.
Rechercher les comptes de facturation auxquels vous avez accès
Exécutez la requête suivante pour lister tous les comptes de facturation auxquels vous avez accès.
GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts?api-version=2019-10-01-preview
En réponse, l’API retourne la liste des comptes de facturation.
{
"value": [
{
"id": "/providers/Microsoft.Billing/billingAccounts/99a13315-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx",
"name": "99a13315-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx",
"properties": {
"accountId": "5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"accountStatus": "Active",
"accountType": "Enterprise",
"agreementType": "MicrosoftPartnerAgreement",
"displayName": "Contoso",
"hasReadAccess": true,
"organizationId": "1d100e69-xxxx-xxxx-xxxx-xxxxxxxxxxxxx_xxxx-xx-xx"
},
"type": "Microsoft.Billing/billingAccounts"
},
{
"id": "/providers/Microsoft.Billing/billingAccounts/4f89e155-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx",
"name": "4f89e155-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx",
"properties": {
"accountId": "4f89e155-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"accountStatus": "Active",
"accountType": "Enterprise",
"agreementType": "MicrosoftCustomerAgreement",
"displayName": "Fabrikam",
"hasReadAccess": true,
"organizationId": "1d100e69-xxxx-xxxx-xxxx-xxxxxxxxxxxxx_xxxx-xx-xx"
},
"type": "Microsoft.Billing/billingAccounts"
}
]
}
Utilisez la propriété displayName afin d’identifier le compte de facturation pour lequel vous souhaitez créer des abonnements. Vérifiez que le compte affiche MicrosoftPartnerAgreement comme agreementType. Copiez la valeur name du compte. Par exemple, si vous souhaitez créer un abonnement pour le compte de facturation Contoso, copiez 99a13315-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx. Collez cette valeur quelque part, de façon à pouvoir l’utiliser à l’étape suivante.
Rechercher les clients qui ont des plans Azure
Exécutez la requête suivante, en remplaçant <billingAccountName> par la valeur name que vous avez copiée à la première étape (5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx) pour lister tous les clients associés au compte de facturation pour lequel vous pouvez créer des abonnements Azure.
GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/<billingAccountName>/customers?api-version=2019-10-01-preview
En réponse, l’API retourne la liste des clients du compte de facturation qui ont des plans Azure. Vous pouvez créer des abonnements pour les clients.
{
"value": [
{
"id": "/providers/Microsoft.Billing/billingAccounts/99a13315-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/customers/2281f543-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"name": "2281f543-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"properties": {
"billingProfileDisplayName": "Contoso USD",
"billingProfileId": "/providers/Microsoft.Billing/billingAccounts/99a13315-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/billingProfiles/JUT6-xxxx-xxxx-xxxx",
"displayName": "Fabrikam toys"
},
"type": "Microsoft.Billing/billingAccounts/customers"
},
{
"id": "/providers/Microsoft.Billing/billingAccounts/99a13315-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/customers/97c3fac4-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"name": "97c3fac4-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"properties": {
"billingProfileDisplayName": "Fabrikam sports",
"billingProfileId": "/providers/Microsoft.Billing/billingAccounts/99a13315-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/billingProfiles/JUT6-xxxx-xxxx-xxxx",
"displayName": "Fabrikam bakery"
},
"type": "Microsoft.Billing/billingAccounts/customers"
}]
}
Utilisez la propriété displayName afin d’identifier le client pour lequel vous souhaitez créer des abonnements. Copiez la valeur id du client. Par exemple, si vous souhaitez créer un abonnement pour Fabrikam toys, copiez /providers/Microsoft.Billing/billingAccounts/99a13315-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/customers/2281f543-xxxx-xxxx-xxxx-xxxxxxxxxxxx. Collez cette valeur quelque part de façon à pouvoir l’utiliser dans les étapes suivantes.
Facultatif pour les fournisseurs indirects : Obtenir les revendeurs d’un client
Si vous avez été ajouté comme fournisseur indirect dans le modèle CSP de niveau deux, vous pouvez spécifier un revendeur au moment de la création des abonnements pour les clients.
Exécutez la requête suivante, en remplaçant <customerId> par la valeur id que vous avez copiée à la deuxième étape (/providers/Microsoft.Billing/billingAccounts/99a13315-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/customers/2281f543-xxxx-xxxx-xxxx-xxxxxxxxxxxx) pour lister tous les revendeurs disponibles pour un client.
GET https://management.azure.com<customerId>?$expand=resellers&api-version=2019-10-01-preview
En réponse, l’API retourne la liste des revendeurs pour le client :
{
"value": [{
"id": "/providers/Microsoft.Billing/billingAccounts/99a13315-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/customers/2ed2c490-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"name": "2ed2c490-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"type": "Microsoft.Billing/billingAccounts/customers",
"properties": {
"displayName": "Fabrikam toys",
"resellers": [
{
"resellerId": "3xxxxx",
"description": "Wingtip"
}
]
}
},
{
"id": "/providers/Microsoft.Billing/billingAccounts/99a13315-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/customers/4ed2c793-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"name": "4ed2c793-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"type": "Microsoft.Billing/billingAccounts/customers",
"properties": {
"displayName": "Fabrikam toys",
"resellers": [
{
"resellerId": "5xxxxx",
"description": "Tailspin"
}
]
}
}]
}
Utilisez la propriété description afin d’identifier le revendeur qui sera associé à l’abonnement. Copiez la valeur resellerId du revendeur. Par exemple, pour associer Wingtip, copiez 3xxxxx. Collez cette valeur quelque part, de façon à pouvoir l’utiliser à l’étape suivante.
Créer un abonnement pour un client
L’exemple suivant crée un abonnement nommé Dev Team subscription pour Fabrikam toys et associe le revendeur Wingtip à l’abonnement.
Exécutez la requête suivante, en remplaçant <customerId> par la valeur id que vous avez copiée à la deuxième étape (/providers/Microsoft.Billing/billingAccounts/99a13315-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/customers/2281f543-xxxx-xxxx-xxxx-xxxxxxxxxxxx). Passez la valeur resellerId facultative, que vous avez copiée à la deuxième étape, dans les paramètres de requête de l’API.
POST https://management.azure.com<customerId>/providers/Microsoft.Subscription/createSubscription?api-version=2018-11-01-preview
'{"displayName": "Dev Team subscription",
"skuId": "0001",
"resellerId": "<resellerId>",
}'
| Nom de l’élément | Obligatoire | Type | Description |
|---|---|---|---|
displayName |
Oui | String | Nom d’affichage de l’abonnement. |
skuId |
Oui | String | Référence SKU du plan Azure. Utilisez 0001 pour les abonnements de type Plan Microsoft Azure |
resellerId |
Non | String | ID du revendeur qui sera associé à l’abonnement. |
Dans la réponse, vous obtenez un objet subscriptionCreationResult pour le monitoring. Lorsque la création de l’abonnement est terminée, l’objet subscriptionCreationResult retourne un objet subscriptionLink. Celui-ci comprend l’ID de l’abonnement.
Étapes suivantes
- Pour afficher un exemple de création d’un abonnement Contrat Entreprise (EA) à l’aide de .NET, consultez l’exemple de code sur GitHub.
- Maintenant que vous avez créé un abonnement, vous pouvez accorder cette capacité à d’autres utilisateurs et principaux de service. Pour plus d’informations, consultez Accorder l’accès pour créer des abonnements Azure Enterprise (préversion).
- Pour plus d’informations sur la gestion d’un grand nombre d’abonnements à l’aide de groupes d’administration, consultez Organiser vos ressources avec des groupes d’administration Azure.
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour