Price Sheet - Download By Billing Profile

Référence

Service:: Cost Management

Version d'API:: 2023-11-01

Obtient une URL pour télécharger la feuille de prix du mois actuel pour un profil de facturation. L’opération est prise en charge pour les comptes de facturation avec le type contrat Partenaire Microsoft ou contrat client Microsoft.

Vous pouvez utiliser la nouvelle version de l’API 2023-11-01 pour les périodes de facturation janvier 2023. La tarification d’Azure Reserved Instance (RI) est disponible uniquement via la nouvelle version de l’API.

En raison de la croissance du produit Azure, l’expérience de téléchargement de la grille tarifaire Azure dans cette préversion sera mise à jour à partir d’un fichier csv/json unique vers un fichier Zip contenant plusieurs fichiers csv/json, chacun avec une taille maximale de 75 Mo.

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

Paramètres URI

Nom Dans Obligatoire Type Description

billingAccountName

path

True

string

ID qui identifie de façon unique un compte de facturation.

Modèle d’expression régulière: ([A-Za-z0-9]+(-[A-Za-z0-9]+)+):([A-Za-z0-9]+(-[A-Za-z0-9]+)+)_[0-9]{4}-[0-9]{2}-[0-9]{2}

billingProfileName

path

True

string

ID qui identifie de façon unique un profil de facturation.

Modèle d’expression régulière: ([A-Za-z0-9]+(-[A-Za-z0-9]+)+)

api-version

query

True

string

Version de l’API à utiliser pour cette opération.

Réponses

Nom

Type

Description

200 OK

PricesheetDownloadProperties

D’ACCORD. La demande a réussi.

202 Accepted

Accepté.

En-têtes

Location: string
Retry-After: string
OData-EntityId: string

Other Status Codes

Réponse d’erreur décrivant pourquoi l’opération a échoué.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory.

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom	Description
user_impersonation	emprunter l’identité de votre compte d’utilisateur

Exemples

PricesheetDownloadByBillingProfile

Exemple de requête

HTTP

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/7c05a543-80ff-571e-9f98-1063b3b53cf2:99ad03ad-2d1b-4889-a452-090ad407d25f_2019-05-31/billingProfiles/2USN-TPCD-BG7-TGB/providers/Microsoft.CostManagement/pricesheets/default/download?api-version=2023-11-01

Exemple de réponse

Code d’état:: 202

Location: https://management.azure.com:443/providers/Microsoft.Billing/billingAccounts/7c05a543-80ff-571e-9f98-1063b3b53cf2:99ad03ad-2d1b-4889-a452-090ad407d25f_2019-05-31/billingProfiles/2USN-TPCD-BG7-TGB/providers/Microsoft.CostManagement/operationResults/45000000-0000-0000-0000-000000000000?sessiontoken=0:000000&api-version=2023-11-01&OperationType=PriceSheet
Retry-After: 60
OData-EntityId: 45000000-0000-0000-0000-000000000000

Code d’état:: 200

{
  "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",
  "expiryTime": "2018-07-21T17:32:28Z"
}

Définitions

Nom	Description
ErrorDetails	Détails de l’erreur.
ErrorResponse	La réponse d’erreur indique que le service n’est pas en mesure de traiter la requête entrante. La raison est fournie dans le message d’erreur. Réponses d’erreur : 429 TooManyRequests : la requête est limitée. Réessayez après avoir attendu l’heure spécifiée dans l’en-tête « x-ms-ratelimit-microsoft.consumption-retry-after ». 503 ServiceUnavailable - Le service est temporairement indisponible. Réessayez après avoir attendu l’heure spécifiée dans l’en-tête « Retry-After ».
MCAPriceSheetProperties	Propriétés de la grille tarifaire.
PricesheetDownloadProperties	URL pour télécharger le rapport généré.

ErrorDetails

Détails de l’erreur.

Nom	Type	Description
code	string	Code d’erreur.
message	string	Message d’erreur indiquant pourquoi l’opération a échoué.

ErrorResponse

La réponse d’erreur indique que le service n’est pas en mesure de traiter la requête entrante. La raison est fournie dans le message d’erreur.

Réponses d’erreur :

429 TooManyRequests : la requête est limitée. Réessayez après avoir attendu l’heure spécifiée dans l’en-tête « x-ms-ratelimit-microsoft.consumption-retry-after ».
503 ServiceUnavailable - Le service est temporairement indisponible. Réessayez après avoir attendu l’heure spécifiée dans l’en-tête « Retry-After ».

Nom	Type	Description
error	ErrorDetails	Détails de l’erreur.

MCAPriceSheetProperties

Propriétés de la grille tarifaire.

Nom	Type	Description
basePrice	string	Prix unitaire au moment où le client se connecte ou le prix unitaire au moment du lancement du compteur de service ga s’il est après l’authentification. Cela s’applique aux utilisateurs contrat Entreprise
billingAccountID	string	Identificateur unique du compte de facturation.
billingAccountName	string	Nom du profil de facturation configuré pour recevoir des factures. Les prix de la grille tarifaire sont associés à ce profil de facturation.
billingCurrency	string	Devise dans laquelle les frais sont publiés.
billingProfileId	string	Identificateur unique pour le profil de facturation.
billingProfileName	string	Nom du profil de facturation configuré pour recevoir des factures. Les prix de la grille tarifaire sont associés à ce profil de facturation.
currency	string	Devise dans laquelle tous les prix sont reflétés.
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
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 la consommation PriceType, le prix du marché est reflété en tant que prix de paiement à 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 de 1 ou 3 ans.
meterCategory	string	Nom de la catégorie de classification du compteur. Par exemple, les services cloud, la mise en réseau, etc.
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
priceType	string	Type de prix pour un produit. Par exemple, une ressource Azure avec un tarif de paiement à l’utilisation avec priceType en tant que consommation. D’autres types de prix incluent ReservedInstance et Savings Plan.
product	string	Nom du produit qui accumule les frais.
productId	string	Identificateur unique du produit dont le compteur est consommé.
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 d’un plan d’épargne Azure ou d’une durée de réservation : un an ou trois ans (P1Y ou P3Y)
tierMinimumUnits	string	Définit la limite inférieure de la plage de niveaux pour laquelle les prix sont définis. Par exemple, si la plage est comprise entre 0 et 100, tierMinimumUnits est 0.
unitOfMeasure	string	Comment l’utilisation est mesurée pour le service
unitPrice	string	Le prix unitaire au moment de la facturation d’un produit ou d’un service donné, y compris les remises négociées au-dessus du prix du marché. Pour PriceType ReservedInstance, le prix unitaire reflète le coût total de l’engagement de 1 ou 3 ans, y compris les remises. Remarque : le prix unitaire n’est pas le même que le prix effectif dans les téléchargements des détails de l’utilisation lorsque les services ont des prix différentiels entre les niveaux. Si les services ont une tarification multiniveau, le prix effectif est un taux mixte entre les niveaux et n’affiche pas de prix unitaire spécifique au niveau. Le prix combiné ou le prix effectif est le prix net de la quantité consommée couvrant les différents niveaux (où chaque niveau a un prix unitaire spécifique).

PricesheetDownloadProperties

URL pour télécharger le rapport généré.

Nom	Type	Description
downloadFileProperties	MCAPriceSheetProperties	Propriétés dans le fichier téléchargé
downloadUrl	string	URL pour télécharger le rapport généré.
expiryTime	string	Heure à laquelle l’URL du rapport devient non valide/expire au format UTC, par exemple, 2020-12-08T05:55:59.4394737Z.