中国向け Azure Retail Price API

この API を使用すると、中国のすべての Azure サービスの小売料金を取得するための認証されていないエクスペリエンスが提供されます。 API を使用して、さまざまなリージョンと異なる SKU の Azure サービスの価格を調べます。 API は、SKU とリージョン間の内部分析と価格比較のための独自のツールを作成するのにも役立ちます。 この記事の情報では、中国で使用する Azure Retail Price API にのみ適用される情報について説明します。

API 応答を通じて、中国のすべての Azure サービスの小売料金を含む CSV ファイルをダウンロードするための URL を取得します。

このドキュメントに示されている小売価格は例です。

API エンドポイント

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

URI パラメーター

名前	/	必須	Type	説明
api-version	query	True	string	この操作に使用する API バージョン

Response

名前	Type	説明
200 OK	DownloadURL	OK です。 要求が成功しました
その他の状態コード	ErrorResponse	操作に失敗した理由を説明するエラー応答

要求のサンプル

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

応答のサンプル

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

定義

名前	説明
DownloadURL	生成されたレポートをダウンロードする URL
ErrorDetails	エラーの詳細
ErrorResponse	エラー応答は、サービスが受信要求を処理できないことを示します。 理由は、エラー メッセージに記載されています

DownloadURL

生成されたレポートをダウンロードする URL。

名前	Type	説明
DownloadUrl	string	生成されたレポートをダウンロードする URL
LastRefreshedAt	string	データが UTC で更新される時刻。 たとえば、2023-06-02T04:19:45Z
expiryTime	string	レポート URL が無効になるか、UTC で期限切れになる時刻。 たとえば、2023-06-02T06:54:57.1059946Z

DownloadURL の使用

次の情報は、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"}

URL の引用符内の内容をコピーし、ブラウザーのアドレスに貼り付けます。 次に、アドレスに移動して CSV ファイルのダウンロードを開始します。 または ExpiryTime 文字列はLastRefreshedAt含めないでください。 次に例を示します。

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

AzureRetailPrices.csvのファイルのダウンロードが開始されます。

ErrorDetails

エラーの詳細。

名前	Type	説明
code	string	エラー コード
message	string	操作が失敗した理由を示すエラー メッセージ

ErrorResponse

エラー応答は、サービスが受信要求を処理できないことを示します。 理由は、エラー メッセージに示されています。

いくつかのエラー応答を次に示します。

• 429 TooManyRequests - 要求が調整されました。 x-ms-ratelimit-microsoft.consumption-retry-after ヘッダーで指定された時刻まで待ってから、再試行してください。
• 503 ServiceUnavailable - サービスは一時的に使用できません。 Retry-After ヘッダーで指定された時刻まで待ってから、再試行してください。

名前	Type	説明
error	ErrorDetails	エラーの詳細

ダウンロードした CSV ファイルのプロパティの詳細

ダウンロードした CSV ファイルに含まれるすべてのプロパティの詳細を次に示します。

表示される価格は例です。

フィールド	値の例	定義
currencyCode	CNY	レートが定義され、価格が返される通貨。 それは中国のサービスのための常にCNYである
tierMinimumUnits	0	各レベルの最小単位。 すべてのユニットの価格がフラットなサービスの場合、値は常に 0 です。 階層化された価格のサービスの場合、値は各レベルの最小ユニットを示します
retailPrice	0.869038	Microsoft サービスの小売価格
unitPrice	0.869038	Microsoft サービスの小売価格
armRegionName	chinaeast2	サービスが利用可能な Azure Resource Manager リージョン
場所	CN East 2	リソースがデプロイされている Azure データ センター
effectiveStartDate	2020-08-01T00:00:00Z	小売価格が有効な日付を表示します。
meterId	f25b95bd-f9fa-5e85-a3e8-379259ae8dce	リソースの一意識別子
meterName	D2/DS2	メーターの名前
Productid	DZH318Z0BPVW	製品の UniqueID
skuId	DZH318Z0BPVW/00F9	SKU の UniqueID
productName	Virtual Machines D シリーズ Windows	製品名
skuName	D2	SKU 名
serviceName	Virtual Machines	サービスの名前
serviceFamily	Compute	SKU のサービス ファミリ
unitOfMeasure	1 時間	サービスの使用状況の測定方法
type	従量課金	価格レートの種類。 サポートされている型は、 Reservation、 Consumption、 SavingsPlanConsumption および DevTestConsumptionです。
armSkuName	Standard_F16s	Azure に登録されている SKU 名
語句	3 年	用語の長さ。 SavingsPlan レートを取得するには、予約期間またはコミットされた用語に適用されます
isPrimaryMeterRegion	True	測定領域がプライマリ メーターとして設定されているかどうかを示します。 プライマリ メーターは、料金と課金に使用されます。

ダウンロードした CSV ファイルの例

テーブルとして書式設定した後の CSV ファイル内のデータの例を次に示します。

表示される価格は例です。