API Prix de vente au détail Azure pour la Chine

Article
06/21/2023

Cette API vous offre une expérience non authentifiée pour obtenir des tarifs de vente au détail pour tous les services Azure en Chine. Utilisez l’API pour explorer les prix des services Azure dans différentes régions et différentes références SKU. L’API peut également vous aider à créer vos propres outils pour l’analyse interne et la comparaison des prix entre les références SKU et les régions. Les informations contenues dans cet article couvrent les informations qui s’appliquent uniquement à l’API Prix de détail Azure pour une utilisation en Chine.

Grâce à la réponse de l’API, vous obtenez une URL pour télécharger un fichier CSV qui inclut les tarifs de vente au détail pour tous les services Azure en Chine.

Les prix de détail indiqués dans ce document sont des exemples.

Point de terminaison d’API

https://prices.azure.cn/api/retail/pricesheet/download?api-version=2023-06-01-preview

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
api-version	query	True	string	Version de l’API à utiliser pour cette opération

response

Nom	Type	Description
200 OK	DownloadURL	OK. La demande a réussi
Autres codes d’état	ErrorResponse	Réponse d’erreur décrivant le motif de l’échec de l’opération

Exemple de requête

https://prices.azure.cn/api/retail/pricesheet/download?api-version=2023-06-01-preview

Exemple de réponse

Status code: 200

{
    "DownloadUrl": "https://upapisachinanorth3.blob.core.chinacloudapi.cn/retailpricesasync/2023060101/AzureRetailPrices.csv?<token>",
    "LastRefreshedAt": "2023-06-02T04:19:45Z",
    "ExpiryTime": ""2023-06-02T06:54:57.1059946Z"}"
}

Définition

Nom	Description
DownloadURL	URL pour télécharger le rapport généré
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

DownloadURL

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

Nom	Type	Description
DownloadUrl	string	URL pour télécharger le rapport généré
LastRefreshedAt	string	Heure à laquelle les données sont actualisées en UTC. Par exemple, 2023-06-02T04:19:45Z
expiryTime	string	Heure à laquelle l’URL du rapport devient non valide/expire au format UTC. Par exemple, 2023-06-02T06:54:57.1059946Z

DownloadURL use

Les informations suivantes sont un exemple de réponse de l’API.

{"DownloadUrl":"https://upapisachinanorth3.blob.core.chinacloudapi.cn/retailpricesasync/2023060101/AzureRetailPrices.csv?<token>","LastRefreshedAt":"2023-06-02T04:19:45Z","ExpiryTime":"2023-06-02T06:54:57.1059946Z"}

Copiez le contenu entre guillemets pour l’URL, puis collez-le dans l’adresse de votre navigateur. Accédez ensuite à l’adresse pour démarrer le téléchargement du fichier CSV. N’incluez pas les LastRefreshedAt chaînes ou ExpiryTime . Voici un exemple.

https://upapisachinanorth3.blob.core.chinacloudapi.cn/retailpricesasync/2023060101/AzureRetailPrices.csv?<token>

Le téléchargement du fichier démarre pour AzureRetailPrices.csv.

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.

Voici quelques réponses d’erreur :

429 TooManyRequests - La demande est limitée. Réessayez après avoir attendu le temps spécifié 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 le temps spécifié dans l’en-tête Retry-After.

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

Détails de la propriété dans le fichier CSV téléchargé

Voici tous les détails de propriété inclus dans le fichier CSV téléchargé.

Les prix indiqués sont des exemples.

Champ	Exemples de valeurs	Définition
currencyCode	CNY	Devise dans laquelle les taux sont définis et retourne les prix. Il est toujours CNY pour les services en Chine
tierMinimumUnits	0	Unité minimale pour chaque niveau. Pour les services avec des tarifs fixes pour toutes les unités, la valeur est toujours égale à 0. Pour les services avec une tarification hiérarchisé, la valeur est d’indiquer l’unité minimale pour chaque niveau
retailPrice	0.869038	Prix de vente au détail des services Microsoft
unitPrice	0.869038	Prix de vente au détail des services Microsoft
armRegionName	chinaeast2	Région Azure Resource Manager où le service est disponible
Emplacement	CN Est 2	Centre de données Azure où la ressource est déployée
effectiveStartDate	2020-08-01T00:00:00Z	Affiche la date d’entrée en vigueur des prix de détail.
meterId	f25b95bd-f9fa-5e85-a3e8-379259ae8dce	Identificateur unique de la ressource
meterName	D2/DS2	Nom du compteur
Productid	DZH318Z0BPVW	UniqueID du produit
skuId	DZH318Z0BPVW/00F9	UniqueID pour la référence SKU
ProductName	Machines Virtuelles Série D Windows	Nom du produit
skuName	D2	Nom de la référence (SKU)
serviceName	Machines Virtuelles	Nom du service
serviceFamily	Compute	Famille de services de la référence SKU
unitOfMeasure	1 heure	Comment l’utilisation est mesurée pour le service
type	Consommation	Type de tarifs. Les types pris en charge sont `Reservation`, `Consumption`et `SavingsPlanConsumptionDevTestConsumption`.
armSkuName	Standard_F16s	Nom de référence SKU inscrit dans Azure
terme	3 ans	Longueur du terme. Il s’applique à la durée de réservation ou à la durée validée pour obtenir le taux SavingsPlan
isPrimaryMeterRegion	True	Indique si la région du compteur est définie en tant que compteur principal ou non. Les compteurs principaux sont utilisés pour les frais et la facturation.

Exemple de fichier CSV téléchargé

Voici un exemple de données dans le fichier CSV après l’avoir mis en forme en tant que tableau.