Interfejs API cen detalicznych platformy Azure dla Chin

Ten interfejs API zapewnia nieuwierzytelnione środowisko uzyskiwania stawek detalicznych dla wszystkich usług platformy Azure w Chinach. Użyj interfejsu API, aby zapoznać się z cenami usług platformy Azure w różnych regionach i różnych jednostkach SKU. Interfejs API może również pomóc w tworzeniu własnych narzędzi do wewnętrznej analizy i porównywania cen w jednostkach SKU i regionach. Informacje zawarte w tym artykule obejmują informacje dotyczące interfejsu API cen detalicznych platformy Azure do użycia w Chinach.

Za pośrednictwem odpowiedzi interfejsu API otrzymasz adres URL umożliwiający pobranie pliku CSV zawierającego stawki detaliczne dla wszystkich usług platformy Azure w Chinach.

Ceny detaliczne pokazane w tym dokumencie są przykładami.

Punkt końcowy interfejsu API

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

Parametry identyfikatora URI

Nazwa	W	Wymagany	Typ	Opis
api-version	query	True	ciąg	Wersja interfejsu API do użycia dla tej operacji

Reakcja

Nazwa	Typ	Opis
200 OK	DownloadURL	OK. Żądanie zakończyło się pomyślnie
Inne kody stanu	ErrorResponse	Odpowiedź na błąd opisująca, dlaczego operacja nie powiodła się

Przykładowe żądanie

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

Przykładowa odpowiedź

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"}"
}

Definicja

Nazwa	Opis
DownloadURL	Adres URL do pobrania wygenerowanego raportu
ErrorDetails	Szczegóły błędu
ErrorResponse	Odpowiedź na błąd wskazuje, że usługa nie może przetworzyć żądania przychodzącego. Przyczyna jest podana w komunikacie o błędzie

DownloadURL

Adres URL umożliwiający pobranie wygenerowanego raportu.

Nazwa	Typ	Opis
DownloadUrl	ciąg	Adres URL do pobrania wygenerowanego raportu
LastRefreshedAt	ciąg	Czas odświeżania danych w formacie UTC. Na przykład 2023-06-02T04:19:45Z
expiryTime	ciąg	Czas, w którym adres URL raportu staje się nieprawidłowy/wygasa w formacie UTC. Na przykład 2023-06-02T06:54:57.1059946Z

Use DownloadURL

Poniższe informacje to przykładowa odpowiedź z interfejsu 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"}

Skopiuj zawartość wewnątrz cudzysłowów dla adresu URL, a następnie wklej ją do adresu przeglądarki. Następnie przejdź do adresu, aby rozpocząć pobieranie pliku CSV. Nie dołączaj LastRefreshedAt ciągów lub ExpiryTime . Oto przykład.

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

Pobieranie pliku rozpoczyna się od AzureRetailPrices.csv.

ErrorDetails

Szczegóły błędu.

Nazwa	Typ	Opis
kod	ciąg	Kod błędu
message	ciąg	Komunikat o błędzie wskazujący, dlaczego operacja nie powiodła się

ErrorResponse

Odpowiedź na błąd wskazuje, że usługa nie może przetworzyć żądania przychodzącego. Przyczyna jest podana w komunikacie o błędzie.

Oto kilka odpowiedzi na błędy:

• 429 TooManyRequests — Żądanie jest ograniczane. Poczekaj przez czas określony w nagłówku x-ms-ratelimit-microsoft.consumption-retry-after i spróbuj ponownie.
• 503 ServiceUnavailable — Usługa jest tymczasowo niedostępna. Poczekaj przez czas określony w nagłówku Retry-After i spróbuj ponownie.

Nazwa	Typ	Opis
error	ErrorDetails	Szczegóły błędu

Szczegóły właściwości w pobranym pliku CSV

Oto wszystkie szczegóły właściwości uwzględnione w pobranym pliku CSV.

Wyświetlane ceny to przykłady.

Pole	Przykładowe wartości	Definicja
currencyCode	CNY	Waluta, w której są definiowane stawki i zwraca ceny. Zawsze jest to CNY dla usług w Chinach
tierMinimumUnits	0	Minimalna jednostka dla każdej warstwy. W przypadku usług z płaską ceną dla wszystkich jednostek wartość jest zawsze 0. W przypadku usług z cenami warstwowymi wartość to wskazanie minimalnej jednostki dla każdej warstwy
retailPrice	0.869038	Cena detaliczna dla usług firmy Microsoft
unitPrice	0.869038	Cena detaliczna dla usług firmy Microsoft
armRegionName	chinaeast2	Region usługi Azure Resource Manager, w którym jest dostępna usługa
Lokalizacja	CN East 2	Centrum danych platformy Azure, w którym wdrożono zasób
effectiveStartDate	2020-08-01T00:00:00Z	Pokazuje datę, kiedy ceny detaliczne są skuteczne.
meterId	f25b95bd-f9fa-5e85-a3e8-379259ae8dce	Unikatowy identyfikator zasobu
meterName	D2/DS2	Nazwa miernika
Productid	DZH318Z0BPVW	UniqueID produktu
skuId	DZH318Z0BPVW/00F9	UniqueID dla jednostki SKU
Productname	windows Virtual Machines serii D	Nazwa produktu
skuName	D2	Nazwa jednostki SKU
Servicename	Virtual Machines	Nazwa usługi
serviceFamily	Compute	Rodzina usług jednostki SKU
unitOfMeasure	1 godzina	Jak użycie jest mierzone dla usługi
typ	Zużycie	Typ stawek cenowych. Obsługiwane typy to Reservation, ConsumptionSavingsPlanConsumption i DevTestConsumption.
armSkuName	Standardowa_F16s	Nazwa jednostki SKU zarejestrowana na platformie Azure
Termin	3 lata	Długość terminu. Ma zastosowanie do okresu rezerwacji lub zatwierdzonego terminu w celu uzyskania stawki OszczędnościPlan
isPrimaryMeterRegion	Prawda	Wskazuje, czy region miernika jest ustawiony jako miernik podstawowy, czy nie. Podstawowe mierniki są używane do naliczania opłat i rozliczeń.

Przykład pobrany plik CSV

Oto przykład danych w pliku CSV po sformatowaniu go jako tabeli.

Wyświetlane ceny to przykłady.