API de Preços de Varejo do Azure para a China

Essa API oferece uma experiência não autenticada para obter taxas de varejo para todos os serviços do Azure na China. Use a API para explorar os preços dos serviços do Azure em diferentes regiões e SKUs diferentes. A API também pode ajudá-lo a criar suas próprias ferramentas para análise interna e comparação de preços entre SKUs e regiões. As informações neste artigo abordam informações que se aplicam somente à API de Preços de Varejo do Azure para uso na China.

Por meio da resposta da API, você obtém uma URL para baixar um arquivo CSV que inclui as taxas de varejo para todos os serviços do Azure na China.

Os preços de varejo mostrados neste documento são exemplos.

Ponto de extremidade de API

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

Parâmetros de URI

Nome	Em	Obrigatório	Type	Descrição
api-version	Consulta	True	string	A versão da API a ser usada para esta operação

Resposta

Nome	Type	Descrição
200 OK	DownloadURL	OK. A solicitação foi bem-sucedida
Outros códigos de status	ErrorResponse	Resposta de erro que descreve por que a operação falhou

Solicitação de exemplo

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

Resposta de exemplo

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

Definição

Nome	Descrição
DownloadURL	A URL para baixar o relatório gerado
ErrorDetails	Os detalhes do erro
ErrorResponse	A resposta de erro indica que o serviço não é capaz de processar a solicitação de entrada. O motivo é fornecido na mensagem de erro

DownloadURL

A URL para baixar o relatório gerado.

Nome	Type	Descrição
DownloadUrl	string	A URL para baixar o relatório gerado
LastRefreshedAt	string	A hora em que os dados são atualizados em UTC. Por exemplo, 2023-06-02T04:19:45Z
expiryTime	string	A hora em que a URL do relatório se torna inválida/expira em UTC. Por exemplo, 2023-06-02T06:54:57.1059946Z

DownloadURL use

As informações a seguir são uma resposta de exemplo da 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"}

Copie o conteúdo dentro das aspas da URL e cole-o no endereço do navegador. Em seguida, vá para o endereço para iniciar o download do arquivo CSV. Não inclua as LastRefreshedAt cadeias de caracteres ou ExpiryTime . A seguir, um exemplo.

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

O download do arquivo começa para AzureRetailPrices.csv.

ErrorDetails

Os detalhes do erro.

Nome	Type	Descrição
code	string	Código do erro
message	string	Mensagem de erro indicando por que a operação falhou

ErrorResponse

A resposta de erro indica que o serviço não é capaz de processar a solicitação de entrada. O motivo é fornecido na mensagem de erro.

Aqui estão algumas respostas de erro:

• 429 TooManyRequests – A solicitação é limitada. Tente novamente depois de aguardar o tempo especificado no cabeçalho x-ms-ratelimit-microsoft.consumption-retry-after.
• 503 ServiceUnavailable - O serviço está temporariamente indisponível. Tente novamente depois de aguardar o tempo especificado no cabeçalho Retry-After.

Nome	Type	Descrição
erro	ErrorDetails	Os detalhes do erro

Detalhes da propriedade no arquivo CSV baixado

Aqui estão todos os detalhes da propriedade que estão incluídos no arquivo CSV baixado.

Os preços mostrados são exemplos.

Campo	Valores de exemplo	Definição
currencyCode	CNY	A moeda na qual as taxas são definidas e retorna os preços. É sempre CNY para serviços na China
tierMinimumUnits	0	A unidade mínima para cada camada. Para serviços com preço fixo para todas as unidades, o valor é sempre 0. Para serviços com preços em camadas, o valor é para indicar a unidade mínima para cada camada
retailPrice	0.869038	Preço de varejo para serviços da Microsoft
unitPrice	0.869038	Preço de varejo para serviços da Microsoft
armRegionName	chinaeast2	Azure Resource Manager região em que o serviço está disponível
Localização	CN Leste 2	Data center do Azure em que o recurso é implantado
effectiveStartDate	2020-08-01T00:00:00Z	Mostra a data em que os preços de varejo estão em vigor.
meterId	f25b95bd-f9fa-5e85-a3e8-379259ae8dce	Identificador exclusivo do recurso
meterName	D2/DS2	Nome do medidor
Productid	DZH318Z0BPVW	UniqueID do produto
skuId	DZH318Z0BPVW/00F9	UniqueID para o SKU
productName	Windows da série Máquinas Virtuais D	Nome do produto
skuName	D2	Nome do SKU
serviceName	Máquinas Virtuais	Nome do serviço
serviceFamily	Computação	Família de serviços do SKU
unitOfMeasure	1 hora	Como o uso é medido para o serviço
type	Consumo	O tipo de taxas de preços. Os tipos com suporte são Reservation, ConsumptionSavingsPlanConsumption e DevTestConsumption.
armSkuName	Standard_F16s	Nome do SKU registrado no Azure
Termo	3 anos	Comprimento do termo. É aplicável ao termo de reserva ou ao termo confirmado para obter a taxa de SavingsPlan
isPrimaryMeterRegion	True	Indica se a região do medidor está definida como um medidor primário ou não. Os medidores primários são usados para cobrança e encargos.

Exemplo de arquivo CSV baixado

Aqui está um exemplo de dados no arquivo CSV depois de formatá-lo como uma tabela.

Os preços mostrados são exemplos.