Obtenir la grille tarifaire

  • Article

Cet article explique comment obtenir une grille tarifaire pour un marché donné et une vue donnée. Cette méthode prend en charge les filtres pour obtenir l’historique par mois.

Prérequis

  • Informations d’identification, comme décrit dans Authentification auprès de l’API Partenaire. Ce scénario prend uniquement en charge l’authentification utilisateur de l’application. L’application uniquement n’est pas encore prise en charge. Les partenaires qui rencontrent une erreur http :400 doivent consulter la documentation d’authentification de l’API partenaire.
  • Cette API prend actuellement en charge uniquement l’accès utilisateur où les partenaires doivent se trouver dans l’un des rôles suivants : Administration global, Administration Agent ou Agent commercial.

Détails

  • Les données actuelles retournent uniquement les données relatives à la consommation et aux réservations de plan Azure, aux licences (nouvelle expérience commerciale) et aux produits de la Place de marché.
  • La tarification actuelle inclut tous les compteurs et produits disponibles pendant le mois actuel jusqu’à la date à laquelle l’API est appelée. Les mois précédents incluent tous les compteurs et produits disponibles pour le mois donné.
  • Les prix des compteurs de consommation sont uniquement en USD, les partenaires doivent utiliser l’API des taux de change pour calculer les coûts de devise locale.
  • Les prix du compteur de consommation sont estimés au détail. Les remises partenaires sont disponibles via un crédit partenaire.
  • Les prix des compteurs de réservations incluent les remises des partenaires CSP. Vous trouverez les prix de vente au détail estimés pour les réservations dans les services partagés téléchargés à partir de la page « Tarification et offres » de l’Espace partenaires.
  • Vous trouverez plus d’informations sur la tarification du plan Azure dans la documentation sur la tarification du plan Azure.
  • Les API de tarification des partenaires et de taux de change ne font pas partie du Kit de développement logiciel (SDK) de l’Espace partenaires.
  • Cette méthode retourne la liste des prix en tant que flux de fichiers. Le flux de fichiers est un fichier .csv ou une version compressée zip du .csv. Vous trouverez ci-dessous des détails sur la façon de demander des fichiers compressés.

Demande REST

Syntaxe de la requête

Méthode URI de demande
GET https://api.partner.microsoft.com/v1.0/sales/pricesheets(Market='{market}',PricesheetView='{view}')/$value

Paramètres requis de l’URI

Utilisez les paramètres de chemin d’accès suivants pour demander le marché et le type de grille tarifaire souhaitée.

Nom Type Requise Description
Marketing string Oui Code pays/région de deux lettres pour le marché demandé
PricesheetView string Oui Type de grille tarifaire demandée, qui peut être azure_consumption, azure_reservations, mis à jourlicensebased, marketplace ou software.

Remarque

updatedlicensebased PriceSheetView est actuellement disponible uniquement pour les partenaires qui font partie de Microsoft 365/Microsoft Dynamics 365 nouvelle expérience commerciale en préversion technique.

Remarque

La liste des prix du logiciel sera disponible via l’API à compter du 1er avril 2022.

Paramètres de filtre d’URI

Utilisez les paramètres de filtre suivants.

Nom Type Requise Description
Chronologie string Non La valeur par défaut est actuelle si elle n’est pas passée. Les valeurs possibles sont l’historique, le courant et l’avenir.
Month string Non Obligatoire uniquement si l’historique est demandé, doit adhérer à AAAAMM pour la grille tarifaire demandée.

Remarque

La tarification future n’est pas prise en charge pour la Place de marché. À partir du 1er avril 2022, les partenaires pourront afficher l’historique des tarifs logiciels via l’API, à compter de l’historique de mars 2022.

En-têtes de requête

  • Pour plus d’informations, consultez les en-têtes REST du partenaire.

En plus des en-têtes ci-dessus, les fichiers tarifaires peuvent être récupérés en tant que compression réduisant la bande passante et les temps de téléchargement. Par défaut, les fichiers ne sont pas compressés. Pour obtenir des versions compressées des fichiers, vous pouvez inclure la valeur d’en-tête ci-dessous. Sachez que les feuilles compressées ne sont disponibles qu’à partir d’avril 2020, toutes les feuilles antérieures à avril 2020 ne sont disponibles que comme non compressées.

En-tête Type de valeur Valeur Description
Accept-Encoding string deflate facultatif. Si le flux de fichiers omis n’est pas compressé.

Exemple de requête

GET https://api.partner.microsoft.com/v1.0/sales/pricesheets(Market='ad',PricesheetView='azure_consumption')/$value?timeline=history&month=201909 HTTP/1.1
Authorization: Bearer
Host: api.partner.microsoft.com

Exemple de demande pour le nouveau commerce

Remarque

updatedlicensebased PriceSheetView est actuellement disponible uniquement pour les partenaires qui font partie de Microsoft 365/Microsoft Dynamics 365 nouvelle expérience commerciale en préversion technique.

GET https://api.partner.microsoft.com/v1.0/sales/pricesheets(Market='US',PricesheetView='updatedlicensebased')/$value?timeline=history&month=202101 HTTP/1.1
Authorization: Bearer
Accept-Encoding: deflate
Host: api.partner.microsoft.com

Réponse REST

Si elle réussit, cette méthode retourne la liste des prix en tant que flux de fichiers. Le flux de fichiers est un fichier .csv ou une version compressée zip du .csv.

Exemple de réponse pour le nouveau commerce

Remarque

updatedlicensebased PriceSheetView est actuellement disponible uniquement pour les partenaires qui font partie de Microsoft 365/Microsoft Dynamics 365 nouvelle expérience commerciale en préversion technique.

HTTP/1.1 200 OK
Cache-Control: private
Content-Length: 42180180
Content-Type: application/octet-stream
Content-Disposition: attachment; filename=sheets.csv
Request-ID: 9f8bed52-e4df-4d0c-9ca6-929a187b0731
Date: Wed, 02 Feb 2021 03:41:20 GMT

"ProductTitle","ProductId","SkuId","SkuTitle","Publisher","SkuDescription","UnitOfMeasure","TermDuration","BillingPlan","Market","Currency","UnitPrice","PricingTierRangeMin","PricingTierRangeMax","EffectiveStartDate","EffectiveEndDate","Tags","ERP Price"
"Advanced Communications","CFQ7TTC0HDK0","0001","Advanced Communications","Microsoft Corporation","Advanced meetings, calling, workflow integration, and management tools for IT.","","P1Y","Annual","US","USD","115.2","","","2/1/2019 12:00:00 AM","2/4/2021 8:35:31 PM","License","144"
======= Truncated ==============

Codes d’erreur et de réussite de la réponse

Chaque réponse est fournie avec un code d’état HTTP qui indique la réussite ou l’échec et d’autres informations de débogage. Utilisez un outil de suivi réseau pour lire ce code, le type d’erreur et d’autres paramètres. Pour obtenir la liste complète, consultez Codes d’erreur.

S’il n’y a aucune modification attendue pour la nouvelle liste de prix future basée sur une licence commerciale, il n’y aura pas de liste de prix future retournée. Lorsque vous passez un avenir dans la chronologie demandée pour le PriceSheetView mis à jour, les partenaires verront le code de réponse de l’API suivant : 404 Introuvable.

Étapes suivantes