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

Esta API dá-lhe uma experiência não autenticada para obter taxas de revenda para todos os serviços do Azure na China. Utilize 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 as suas próprias ferramentas para análise interna e comparação de preços entre SKUs e regiões. As informações neste artigo abrangem informações que se aplicam apenas à API de Preços de Revenda do Azure para utilização na China.

Através da resposta da API, obtém um URL para transferir um ficheiro CSV que inclui as taxas de revenda para todos os serviços do Azure na China.

Os preços de revenda apresentados neste documento são exemplos.

Ponto final de API

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

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
api-version	query	Verdadeiro	string	A versão da API a utilizar para esta operação

Resposta

Nome	Tipo	Description
200 OK	TransferirURL	OK. O pedido foi esclarido com êxito
Outros Códigos de Estado	ErrorResponse	Resposta de erro que descreve por que motivo a operação falhou

Pedido de exemplo

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

Resposta de amostra

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
TransferirURL	O URL para transferir o relatório gerado
ErrorDetails	Os detalhes do erro
ErrorResponse	A resposta a erros indica que o serviço não consegue processar o pedido recebido. O motivo é fornecido na mensagem de erro

TransferirURL

O URL para transferir o relatório gerado.

Nome	Tipo	Description
DownloadUrl	string	O URL para transferir o relatório gerado
LastRefreshedAt	string	O momento em que os dados são atualizados em UTC. Por exemplo, 2023-06-02T04:19:45Z
expiryTime	string	O momento em que o URL do relatório se torna inválido/expira em UTC. Por exemplo, 2023-06-02T06:54:57.1059946Z

Utilização do DownloadURL

As seguintes informações 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 do URL e, em seguida, cole no endereço do browser. Em seguida, aceda ao endereço para iniciar a transferência do ficheiro CSV. Não inclua as LastRefreshedAt cadeias ou ExpiryTime . Eis um exemplo.

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

A transferência de ficheiros é iniciada para AzureRetailPrices.csv.

ErrorDetails

Os detalhes do erro.

Nome	Tipo	Descrição
code	string	Código de erro
message	string	Mensagem de erro a indicar por que motivo a operação falhou

ErrorResponse

A resposta a erros indica que o serviço não consegue processar o pedido recebido. O motivo é fornecido na mensagem de erro.

Seguem-se algumas respostas de erro:

• 429 TooManyRequests - O pedido está limitado. Tente novamente depois de esperar pelo 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 esperar pelo tempo especificado no cabeçalho Retry-After.

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

Detalhes da propriedade no ficheiro CSV transferido

Eis todos os detalhes da propriedade incluídos no ficheiro CSV transferido.

Os preços apresentados são exemplos.

Campo	Valores de exemplo	Definição
currencyCode	CNY	A moeda em que as taxas são definidas e devolve os preços. É sempre CNY para serviços na China
tierMinimumUnits	0	A unidade mínima para cada camada. Para serviços com preços fixos para todas as unidades, o valor é sempre 0. Para serviços com preços em camadas, o valor é indicar a unidade mínima para cada escalão
retailPrice	0.869038	Preço de revenda para serviços Microsoft
unitPrice	0.869038	Preço de revenda para serviços Microsoft
armRegionName	chinaeast2	Azure Resource Manager região onde o serviço está disponível
Localização	CN Leste 2	Datacenter do Azure onde o recurso é implementado
effectiveStartDate	08-2020-01T00:00:00Z	Mostra a data em que os preços de retalho são eficazes.
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 Máquinas Virtuais Série 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 a utilização é medida para o serviço
tipo	Consumo	O tipo de taxas de preço. Os tipos suportados são Reservation, ConsumptionSavingsPlanConsumption e DevTestConsumption.
armSkuName	Standard_F16s	Nome do SKU registado no Azure
termo	3 Anos	Comprimento do termo. É aplicável ao Termo de reserva ou ao termo consolidado para obter a taxa do Plano de Poupança
isPrimaryMeterRegion	Verdadeiro	Indica se a região do medidor está definida como um medidor primário ou não. Os medidores primários são utilizados para custos e faturação.

Exemplo de ficheiro CSV transferido

Eis um exemplo de dados no ficheiro CSV após formatá-lo como uma tabela.

Os preços apresentados são exemplos.