中国向け 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 ファイル内のデータの例を次に示します。

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

価格を含む CSV ファイルの例を示すスクリーンショット。