Price Sheet - Get

Référence

Service:: Consumption

Version d'API:: 2024-08-01

Obtient la grille tarifaire d’un abonnement. La grille tarifaire est disponible via cette API uniquement pour le 1er mai 2014 ou version ultérieure.

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Consumption/pricesheets/default?api-version=2024-08-01

Avec des paramètres facultatifs:

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Consumption/pricesheets/default?$expand={$expand}&$skiptoken={$skiptoken}&$top={$top}&api-version=2024-08-01

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
subscriptionId	path	True	string	ID d’abonnement Azure.
api-version	query	True	string	Version de l’API à utiliser avec la demande cliente. La version actuelle est 2023-03-01.
$expand	query		string	Peut être utilisé pour développer les propriétés/meterDetails dans une grille tarifaire. Par défaut, ces champs ne sont pas inclus lors du retour de la grille tarifaire.
$skiptoken	query		string	Skiptoken est utilisé uniquement si une opération précédente a retourné un résultat partiel. Si une réponse précédente contient un élément nextLink, la valeur de l’élément nextLink inclut un paramètre skiptoken qui spécifie un point de départ à utiliser pour les appels suivants.
$top	query		integer (int32) minimum: 1 maximum: 1000	Peut être utilisé pour limiter le nombre de résultats aux premiers résultats N.

Réponses

Nom	Type	Description
200 OK	PriceSheetResult	D’ACCORD. La demande a réussi.
Other Status Codes	ErrorResponse	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

PriceSheet

Exemple de requête

HTTP

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Consumption/pricesheets/default?api-version=2024-08-01

Exemple de réponse

Code d’état:: 200

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Billing/billingPeriods/201702/providers/Microsoft.Consumption/pricesheets/default",
  "name": "default",
  "type": "Microsoft.Consumption/pricesheets",
  "properties": {
    "nextLink": "https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/microsoft.consumption/pricesheets/default?api-version=2018-01-31&$skiptoken=AQAAAA%3D%3D",
    "pricesheets": [
      {
        "billingPeriodId": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Billing/billingPeriods/201702",
        "meterId": "00000000-0000-0000-0000-000000000000",
        "unitOfMeasure": "100 Hours",
        "includedQuantity": 100,
        "partNumber": "XX-11110",
        "unitPrice": 0.00328,
        "currencyCode": "EUR",
        "offerId": "OfferId 1",
        "savingsPlan": {
          "term": "P3Y",
          "effectivePrice": 0.002,
          "marketPrice": 0.00328
        }
      }
    ]
  }
}

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 ». 504 Délai d’expiration de la passerelle : le service a expiré lors du traitement de la demande. Réduisez la plage de dates dans la requête, si possible.
MeterDetails	Propriétés du détail du compteur.
PriceSheetProperties	Propriétés de la grille tarifaire.
PriceSheetResult	Ressource de feuille de prix.
SavingsPlan	Propriétés du Plan d’épargne.

ErrorDetails

Object

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

Object

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 ».
504 Délai d’expiration de la passerelle : le service a expiré lors du traitement de la demande. Réduisez la plage de dates dans la requête, si possible.

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

MeterDetails

Object

Propriétés du détail du compteur.

Nom	Type	Description
meterCategory	string	Catégorie du compteur, par exemple « Services cloud », « Mise en réseau », etc.
meterLocation	string	Emplacement dans lequel le service Azure est disponible.
meterName	string	Nom du compteur, dans la catégorie de compteur donnée
meterSubCategory	string	Sous-catégorie du compteur, par exemple « A6 Services cloud », « ExpressRoute (IXP) », etc.
pretaxStandardRate	number (decimal)	Prix de référencement prétaxé.
serviceName	string	Nom du service.
serviceTier	string	Niveau de service.
totalIncludedQuantity	number (decimal)	Quantité totale incluse associée à l’offre.
unit	string	Unité dans laquelle la consommation du compteur est facturée, par exemple « Heures », « Go », etc.

PriceSheetProperties

Object

Propriétés de la grille tarifaire.

Nom	Type	Description
billingPeriodId	string	ID de la ressource de période de facturation à laquelle appartient l’utilisation.
currencyCode	string	Code devise
includedQuantity	number (decimal)	Qualité incluse pour une offre
meterDetails	MeterDetails	Détails sur le compteur. Par défaut, cette valeur n’est pas remplie, sauf si elle est spécifiée dans $expand.
meterId	string (uuid)	ID du compteur (GUID)
offerId	string	ID de l’offre
partNumber	string	Numéro de partie
savingsPlan	SavingsPlan	Détails du plan d’épargne
unitOfMeasure	string	Unité de mesure
unitPrice	number (decimal)	Prix unitaire

PriceSheetResult

Object

Ressource de feuille de prix.

Nom	Type	Description
etag	string	Etag de la ressource.
id	string	ID ARM complet d’un événement.
name	string	ID qui identifie de façon unique un événement.
properties.download	MeterDetails	Détails du téléchargement de la feuille de prix.
properties.nextLink	string	Lien (URL) vers la page suivante des résultats.
properties.pricesheets	PriceSheetProperties[]	Price sheet
tags	object	Balises de ressource.
type	string	Type de ressource.

SavingsPlan

Object

Propriétés du Plan d’épargne.

Nom	Type	Description
effectivePrice	number (decimal)	Prix effectif de SavingsPlan
marketPrice	number (decimal)	Prix du marché d’ÉpargnePlan
term	string	Terme de Plan d’épargne

Partager via

Price Sheet - Get

Paramètres URI

Réponses

Sécurité

azure_auth

Étendues

Exemples

PriceSheet

Exemple de requête

Exemple de réponse

Définitions

ErrorDetails

ErrorResponse

MeterDetails

PriceSheetProperties

PriceSheetResult

SavingsPlan