Partager via

Créer des abonnements Azure programmatiquement avec des API héritées

  • Article

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 :

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 bien démarrer, 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 :

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/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
      "name": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
      "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 aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e. 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 (aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb). 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/bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx",
      "name": "bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx",
      "properties": {
        "accountId": "bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f",
        "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 bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f: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 (bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f: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/bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f: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/bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f: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/bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f: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/bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f: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/bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_2019-05-31/billingProfiles/PBFV-XXXX-XXX-XXX/invoiceSections/GJGR-XXXX-XXX-XXX, /providers/Microsoft.Billing/billingAccounts/bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f: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/bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f: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/cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx",
      "name": "cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx",
      "properties": {
        "accountId": "bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f",
        "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 cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a: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 (bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f: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/cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/customers/dddd3d3d-ee4e-ff5f-aa6a-bbbbbb7b7b7b",
      "name": "dddd3d3d-ee4e-ff5f-aa6a-bbbbbb7b7b7b",
      "properties": {
        "billingProfileDisplayName": "Contoso USD",
        "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a: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/cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a: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/cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a: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/cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/customers/dddd3d3d-ee4e-ff5f-aa6a-bbbbbb7b7b7b. 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/cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/customers/dddd3d3d-ee4e-ff5f-aa6a-bbbbbb7b7b7b) 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/cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a: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/cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a: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/cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/customers/dddd3d3d-ee4e-ff5f-aa6a-bbbbbb7b7b7b). 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.