Partager via


Migrer à partir de l’API de grille tarifaire EA

Les clients EA qui utilisaient précédemment l’API Enterprise Reporting consumption.azure.com pour obtenir leur grille tarifaire doivent migrer vers une API Azure Resource Manager de remplacement. Les instructions suivantes vous aident à migrer et décrivent également les différences de contrat entre l’ancienne API et la nouvelle API.

Remarque

Toutes les API de création de rapports Azure Enterprise sont mises hors service. Vous devriez effectuer la migration vers les API Microsoft Cost Management dès que possible.

Attribuer des autorisations à un principal de service pour appeler l’API

Avant d’appeler l’API, vous devez configurer un principal de service (SPN) avec l’autorisation correcte. Vous utilisez le principal de service pour appeler l’API. Pour plus d’informations, consultez Attribuer des autorisations aux API Cost Management.

Appeler l’API de grille tarifaire

L’API Price Sheet génère la grille tarifaire de façon asynchrone et produit un fichier que vous téléchargez.

Utilisez les URI de requête suivants lors de l’appel de la nouvelle API Price Sheet :

Requêtes prises en charge

Vous pouvez appeler l’API à l’aide de l’étendue suivante :

Inscription : providers/Microsoft.Billing/billingAccounts/{billingAccountId}

Télécharger par compte de facturation pour la période de facturation spécifiée

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingPeriods/{billingPeriodName}/providers/Microsoft.CostManagement/pricesheets/default/download?api-version=2023-11-01

La requête POST retourne un emplacement pour interroger l’état de génération de rapport comme indiqué dans la réponse suivante :

Exemple de réponse

Code d’état : 202

Location: https://management.azure.com/providers/Microsoft.Billing/billingAccounts/0000000/providers/Microsoft.CostManagement/operationResults/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e?api-version=2023-09-01
Retry-After: 60

Code d’état : 200

{
  "status": "Completed",
  "properties": {
    "downloadUrl": "https://myaccount.blob.core.windows.net/?restype=service&comp=properties&sv=2015-04-05&ss=bf&srt=s&st=2015-04-29T22%3A18%3A26Z&se=2015-04-30T02%3A23%3A26Z&sr=b&sp=rw&spr=https&sig=G%2TEST%4B",
    "validTill": "2023-09-30T17:32:28Z"
  }
}

Exemple de requête pour interroger l’état de création du rapport

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/0000000/providers/Microsoft.CostManagement/operationResults/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e?api-version=2023-09-01

Modifications du corps de la réponse

[
        {
              "id": "enrollments/57354989/billingperiods/201601/products/343/pricesheets",
              "billingPeriodId": "201704",
            "meterId": "dc210ecb-97e8-4522-8134-2385494233c0",
              "meterName": "A1 VM",
              "unitOfMeasure": "100 Hours",
              "includedQuantity": 0,
              "partNumber": "N7H-00015",
              "unitPrice": 0.00,
              "currencyCode": "USD"
        },
        {
              "id": "enrollments/57354989/billingperiods/201601/products/2884/pricesheets",
              "billingPeriodId": "201404",
            "meterId": "dc210ecb-97e8-4522-8134-5385494233c0",
              "meterName": "Locally Redundant Storage Premium Storage - Snapshots - AU East",
              "unitOfMeasure": "100 GB",
              "includedQuantity": 0,
              "partNumber": "N9H-00402",
              "unitPrice": 0.00,
              "currencyCode": "USD"
        },
        ...
]

Nouvelles modifications de réponse

Les propriétés de la grille tarifaire sont les suivantes :

Nom Type Description
basePrice string Le prix unitaire au moment de la connexion du client ou le prix unitaire au moment du lancement du compteur de service GA si c'est après la connexion.

Il s’applique aux utilisateurs du Contrat Entreprise
currencyCode string Devise dans laquelle le Contrat Entreprise a été signé
effectiveEndDate string Date de fin effective de la période de facturation de la feuille de prix
effectiveStartDate string Date de début effective de la période de facturation de la feuille de prix
enrollmentNumber string Identificateur unique pour le compte de facturation EA.
includedQuantity string Quantités d’un service spécifique auquel un client EA a le droit de consommer sans frais incrémentiels.
marketPrice string Prix de liste actuel d’un produit ou d’un service donné. Ce prix est sans négociations et est basé sur votre type de Contrat Microsoft.

Pour PriceType Consumption, le prix du marché est reflété comme le prix à l’utilisation.

Pour le plan d’épargne PriceType, le prix du marché reflète l’avantage du plan d’épargne en plus du prix de paiement à l’utilisation pour la durée d’engagement correspondante.

Pour PriceType ReservedInstance, le prix du marché reflète le prix total de l’engagement d’un ou de trois ans.

Remarque : Pour les clients EA sans négociations, le prix du marché peut apparaître arrondi à une précision décimale différente de celle du prix unitaire.
meterCategory string Nom de la catégorie de classification du compteur. Par exemple, services Cloud, mise en réseau, etc.
meterId string Identificateur unique du compteur
meterName string Nom du compteur. Le compteur représente la ressource déployable d’un service Azure.
meterRegion string Nom de la région Azure dans laquelle le compteur du service est disponible.
meterSubCategory string Nom de la catégorie de sous-classification du compteur.
meterType string Nom du type de compteur
partNumber string Numéro de partie associé au compteur
priceType string Type de prix pour un produit. Par exemple, une ressource Azure avec un tarif à la carte avec priceType comme Consommation. D’autres types de prix incluent ReservedInstance et Savings Plan.
product string Nom du produit auquel les frais s’appliquent.
productId string Identificateur unique pour le produit dont le compteur est utilisé.
serviceFamily number Type de service Azure. Par exemple, Calcul, Analytique et Sécurité.
skuId string Identificateur unique de la référence SKU
term string Durée du plan d’épargne Azure ou durée – de réservation d’un an ou de trois ans (P1Y ou P3Y)
unitOfMeasure string Comment l'utilisation du service est mesurée
unitPrice string Le prix unitaire au moment de la facturation pour un produit ou un service donné, y compris toutes remises négociées en plus du prix du marché.

Pour PriceType ReservedInstance, le prix unitaire reflète le coût total de l’engagement sur un ou trois ans, remises comprises.

Remarque : le prix unitaire est différent du prix effectif dans les téléchargements de détails d’utilisation quand des services ont des prix différentiels entre les divers niveaux.

Si les services sont facturés à plusieurs niveaux, le prix effectif est un tarif mixte entre les niveaux et n'indique pas de prix unitaire spécifique à chaque niveau. Le prix combiné ou le prix effectif est le prix net de la quantité consommée sur plusieurs niveaux (où chaque niveau a un prix unitaire spécifique).