Créer une entité de mise à niveau de produit pour un client

Vous pouvez créer une entité de mise à niveau de produit pour mettre à niveau un client vers une famille de produits donnée (par exemple, un plan Azure) à l’aide de la ressource ProductUpgradeRequest .

Conditions préalables

• Informations d’identification décrites dans l’authentification de l’Espace partenaires. Ce scénario prend en charge l’authentification avec les informations d’identification app+utilisateur. Suivez le modèle d’application sécurisée lors de l’utilisation de l’authentification App+Utilisateur avec les API de l’Espace partenaires.

• ID du client (customer-tenant-id). Si vous ne connaissez pas l'identifiant du client, vous pouvez le rechercher dans le Centre de Partenaires en sélectionnant l'espace de travail Clients, puis le client dans la liste des clients, puis Compte. Dans la page Compte du client, recherchez l’ID Microsoft dans la section Informations sur le compte client. L’ID Microsoft est le même que l’ID de client (customer-tenant-id).

• Famille de produits vers laquelle vous souhaitez mettre à niveau le client.

C#

Pour mettre à niveau un client vers une offre Azure :

1. Créez un objet ProductUpgradesRequest et spécifiez l’identificateur du client et « Azure » comme famille de produits.

2. Utilisez la collection IAggregatePartner.ProductUpgrades .

3. Appelez la méthode Create et transmettez l’objet ProductUpgradesRequest , qui renverra une chaîne d’en-tête d’emplacement .

4. Extrayez l’identifiant de mise à niveau de la chaîne d’en-tête d’emplacement qui peut être utilisée pour interroger l’état de la mise à niveau.

// IAggregatePartner partnerOperations;

string selectedCustomerId = "58e2af4f-0ad3-4688-8744-be2357cd939a";

string selectedProductFamily = "Azure";

var productUpgradeRequest = new ProductUpgradesRequest
{
    CustomerId = selectedCustomerId,
    ProductFamily = selectedProductFamily
};

var productUpgradeLocationHeader = partnerOperations.ProductUpgrades.Create(productUpgradeRequest);

var upgradeId = Regex.Split(productUpgradeLocationHeader, "/")[1];

Requête REST

Syntaxe de la requête

En-têtes de requête

Pour plus d’informations, consultez En-têtes REST de l’Espace Partenaires.

Corps de la requête

Le corps de la demande doit contenir une ressource ProductUpgradeRequest .

Exemple de requête

POST https://api.partnercenter.microsoft.com/v1/productupgrades HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: c245d5f2-1de3-4ae0-9e42-95e38e3cb8ff
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
MS-PartnerCenter-Application: Partner Center .NET SDK Samples
Content-Type: application/json
Host: api.partnercenter.microsoft.com
Content-Length: 340
Expect: 100-continue
Connection: Keep-Alive
{
  "customerId": "4c721420-72ad-4708-a0a7-371a2f7b0969",
  "productFamily": "Azure"
}

Réponse REST

En cas de réussite, la réponse contient un en-tête Location qui a un URI qui peut être utilisé pour récupérer l’état de la mise à niveau du produit. Enregistrez cet URI pour l’utiliser avec d’autres API REST associées.

Réussite de la réponse et codes d’erreur

Chaque réponse est accompagnée d’un code d’état HTTP qui indique la réussite ou l’échec ainsi que des informations de débogage supplémentaires. Utilisez un outil de suivi réseau pour lire ce code, le type d’erreur et les paramètres supplémentaires. Pour obtenir la liste complète, consultez Codes d’erreur REST de Partner Center.

Exemple de réponse

HTTP/1.1 202 Accepted
Content-Length: 0
Location: productUpgrades/42d075a4-bfe7-43e7-af6d-7c68a57edcb4
MS-CorrelationId: bbbb1111-cc22-3333-44dd-555555eeeeee
MS-RequestId: cb82f7d6-f0d9-44d4-82f9-f6eee6e68390
MS-CV: iqOqN0FnaE2y0HcD.0
MS-ServerId: 030020525
Date: Thu, 28 Sep 2019 20:35:35 GMT