Price Sheet - Get

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
ErrorAdditionalInfo	Informations supplémentaires sur l’erreur de gestion des ressources.
ErrorDetail	Détail de l’erreur.
ErrorResponse	Réponse d’erreur
MeterDetails	Détails sur le compteur. Par défaut, cette valeur n’est pas remplie, sauf si elle est spécifiée dans $expand.
PriceSheetProperties	Price sheet
PriceSheetResult	Ressource de feuille de prix.
SavingsPlan	Détails du plan d’épargne

ErrorAdditionalInfo

Object

Informations supplémentaires sur l’erreur de gestion des ressources.

Nom	Type	Description
info	object	Informations supplémentaires.
type	string	Type d’informations supplémentaire.

ErrorDetail

Object

Détail de l’erreur.

Nom	Type	Description
additionalInfo	ErrorAdditionalInfo[]	Informations supplémentaires sur l’erreur.
code	string	Code d’erreur.
details	ErrorDetail[]	Détails de l’erreur.
message	string	Message d’erreur.
target	string	Cible d’erreur.

ErrorResponse

Object

Réponse d’erreur

Nom	Type	Description
error	ErrorDetail	Objet d’erreur.

MeterDetails

Object

Détails sur le compteur. Par défaut, cette valeur n’est pas remplie, sauf si elle est spécifiée dans $expand.

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

Price sheet

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

Détails 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