Azure Retail Prices-API voor China

Deze API biedt u een niet-geverifieerde ervaring om detailhandeltarieven te krijgen voor alle Azure-services in China. Gebruik de API om prijzen voor Azure-services in verschillende regio's en verschillende SKU's te verkennen. De API kan u ook helpen bij het maken van uw eigen hulpprogramma's voor interne analyse en prijsvergelijking tussen SKU's en regio's. De informatie in dit artikel bevat informatie die alleen van toepassing is op de Azure Retail Prices-API voor gebruik in China.

Via het API-antwoord krijgt u een URL voor het downloaden van een CSV-bestand met de detailhandelstarieven voor alle Azure-services in China.

De detailhandelsprijzen die in dit document worden weergegeven, zijn voorbeelden.

API-eindpunt

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

URI-parameters

Naam	In	Vereist	Type	Beschrijving
api-versie	query	True	tekenreeks	De API-versie die voor deze bewerking moet worden gebruikt

Antwoord

Naam	Type	Beschrijving
200 OK	DownloadURL	OK. De aanvraag is voltooid
Andere statuscodes	Foutresponse	Foutreactie waarin wordt beschreven waarom de bewerking is mislukt

Voorbeeldaanvraag

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

Voorbeeldantwoord

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

Definitie

Naam	Beschrijving
DownloadURL	De URL voor het downloaden van het gegenereerde rapport
ErrorDetails	De details van de fout
Foutresponse	Foutreactie geeft aan dat de service de binnenkomende aanvraag niet kan verwerken. De reden wordt opgegeven in het foutbericht

DownloadURL

De URL voor het downloaden van het gegenereerde rapport.

Naam	Type	Beschrijving
DownloadUrl	tekenreeks	De URL voor het downloaden van het gegenereerde rapport
LastRefreshedAt	tekenreeks	Het tijdstip waarop de gegevens worden vernieuwd in UTC. Bijvoorbeeld 2023-06-02T04:19:45Z
expiryTime	tekenreeks	Het tijdstip waarop de rapport-URL ongeldig wordt/verloopt in UTC. Bijvoorbeeld 2023-06-02T06:54:57.1059946Z

DownloadURL-gebruik

De volgende informatie is een voorbeeldantwoord van de 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"}

Kopieer de inhoud tussen de aanhalingstekens voor de URL en plak deze in uw browseradres. Ga vervolgens naar het adres om het downloaden van het CSV-bestand te starten. Neem de tekenreeksen of ExpiryTime niet opLastRefreshedAt. Hier volgt een voorbeeld.

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

Het downloaden van het bestand wordt gestart voor AzureRetailPrices.csv.

ErrorDetails

De details van de fout.

Naam	Type	Beschrijving
code	tekenreeks	Foutcode
message	tekenreeks	Foutbericht dat aangeeft waarom de bewerking is mislukt

Foutresponse

Foutreactie geeft aan dat de service de binnenkomende aanvraag niet kan verwerken. De reden wordt opgegeven in het foutbericht.

Hier volgen enkele foutreacties:

• 429 TooManyRequests - Aanvraag wordt beperkt. Probeer het opnieuw nadat u de tijd hebt gewacht die in de header x-ms-ratelimit-microsoft.consumption-retry-after wordt opgegeven.
• 503 ServiceUnavailable - Service is tijdelijk niet beschikbaar. Probeer het opnieuw nadat u de tijd hebt gewacht die in de header Retry-After wordt opgegeven.

Naam	Type	Beschrijving
fout	ErrorDetails	De details van de fout

Details van de eigenschap in het gedownloade CSV-bestand

Hier volgen alle details van de eigenschap die zijn opgenomen in het gedownloade CSV-bestand.

De weergegeven prijzen zijn voorbeelden.

Veld	Voorbeeldwaarden	Definitie
currencyCode	CNY	De valuta waarin de tarieven worden gedefinieerd en die prijzen als resultaat geeft. Het is altijd VOOR SERVICES in China
tierMinimumUnits	0	De minimumeenheid voor elke laag. Voor services met vaste prijzen voor alle eenheden is de waarde altijd 0. Voor services met gelaagde prijzen is de waarde om de minimumeenheid voor elke laag aan te geven
retailPrice	0.869038	Detailhandelsprijs voor Microsoft-services
unitPrice	0.869038	Detailhandelsprijs voor Microsoft-services
armRegionName	chinaeast2	Azure Resource Manager regio waar de service beschikbaar is
Locatie	CN - oost 2	Azure-datacenter waar de resource wordt geïmplementeerd
effectiveStartDate	2020-08-01T00:00:00Z	Toont de datum waarop de verkoopprijzen van kracht zijn.
meterId	f25b95bd-f9fa-5e85-a3e8-379259ae8dce	Unieke id van de resource
meterName	D2/DS2	Naam van de meter
Productid	DZH318Z0BPVW	UniqueID van het product
skuId	DZH318Z0BPVW/00F9	UniqueID voor de SKU
Productnaam	Windows Virtual Machines D-serie	Productnaam
skuName	D2	SKU-naam
Servicenaam	Virtual Machines	Naam van de service
serviceFamily	Compute	Servicefamilie van de SKU
unitOfMeasure	1 uur	Hoe het gebruik voor de service wordt gemeten
type	Verbruik	Het type prijstarieven. De ondersteunde typen zijn Reservation, Consumptionen SavingsPlanConsumptionDevTestConsumption.
armSkuName	Standard_F16s	SKU-naam geregistreerd in Azure
Termijn	Drie jaar	Duur van de term. Het is van toepassing op reserveringstermijn of de vastgelegde termijn om het SavingsPlan-tarief te verkrijgen
isPrimaryMeterRegion	Waar	Hiermee wordt aangegeven of het metergebied is ingesteld als een primaire meter of niet. Primaire meters worden gebruikt voor kosten en facturering.

Voorbeeld van gedownload CSV-bestand

Hier volgt een voorbeeld van gegevens in het CSV-bestand nadat het is opgemaakt als een tabel.

De weergegeven prijzen zijn voorbeelden.