获取 Azure 订阅中所用资源的价格和元数据信息

您可以查询订阅中所用的资源/仪表元数据以及相关的价格,按照以下参数查询:

  • 提供项 ID(标识)
  • 货币
  • 地域文化
  • 地区

Important

与计费表有关的元数据,包括但不限于服务名称、类型、资源、计量单位和地区等,可能随时在未经通知的情况下变更。如果您打算以自动方式使用这些计费数据,请使用计费表 GUID(全局唯一标识符)识别每项可计费项目。如果由于采用新的计费模式而计划变更计费表 GUID,会提前通知您。

请求

请见 Resource RateCard(资源价格表)(预览) 中的通用参数和头信息小节,了解与 Resource RateCard API(应用程序编程接口)有关的所有请求使用的头信息和参数。

方法 请求 URI(统一资源标识符)
GET https://https://management.chinacloudapi.cn/subscriptions/{subscription-Id}/providers/Microsoft.Commerce/RateCard?api-version={api-version}&$filter=OfferDurableId eq '{OfferDurableId}' and Currency eq '{Currency}' and Locale eq '{Locale}' and RegionInfoeq '{RegionInfo}'
  • 把 {OfferDurableId}(提供项持久 ID)设定为一个有效的提供项 ID 代码(例如 MS-MC-AZR-33P)。请见 Azure 优惠项目详情了解关于可用提供项 ID、国家/地区可用性和计费货币的更多信息。提供项 ID 参数包括 “MS-AZR-” 前缀再加上提供项 ID 编号。
  • 把 {Currency}(货币)设定为用于表示资源价格的货币。
  • 把 {Locale}(地域文化)设定为资源元数据需要面向的地域文化。
  • 把 {RegionInfo}(地区信息)设定为提供项购买地区的双字母 ISO(国际标准化组织)代码。

Note

请注意,需要全部 4 个查询参数。另外,$filter(过滤器)查询选项此时仅支持‘等于’和‘与’逻辑运算符。没有请求体。

响应

响应示例

下面是多种提供项 ID 和地区的 HTTP(超文本传输协议)响应的示例,显示了请求 URL 和查询参数的替代值,以及对应的 JSON(JavaScript 对象表示法)编码响应体。

下面的例子显示了“随收随付”提供项查询,其中提供项持久ID = MS-MC-AZR-0033P,用于中国地区,价格用人民币表示,元数据面向美国英语(en-US)地域文化。

https://management.chinacloudapi.cn/subscriptions/{subscription-Id}/providers/Microsoft.Commerce/RateCard?api-version=2015-06-01-preview&$filter=OfferDurableId eq 'MS-MC-AZR-0033P' and Currency eq 'CNY' and Locale eq 'en-US' and RegionInfoeq 'CN'

JSON

{
"OfferTerms": [],
"Meters": [
    {
        "MeterId": "1822fcc4-6059-4cbb-a132-54a187aaac46",
        "MeterName": "Compute Hours",
        "MeterCategory": "Virtual Machines",
        "MeterSubCategory": "Basic_D6 VM (Non-Windows)",
        "Unit": "Hours",
        "MeterTags": [],
        "MeterRates": {
            "0": 3.136
        },
        "EffectiveDate": "2015-02-01T00:00:00Z",
        "IncludedQuantity": 0.0
    },
    {
        "MeterId": "3c5324ad-eb8c-44c6-af9a-6741ae75fc90",
        "MeterName": "Data Transfer Out at 500 Mbps (GB)",
        "MeterCategory": "Networking",
        "MeterSubCategory": "ExpressRoute (IXP)",
        "Unit": "GB",
        "MeterTags": [],
        "MeterRates": {
            "0": 0.1
        },
        "EffectiveDate": "2014-08-01T00:00:00Z",
        "IncludedQuantity": 2048.0
    },

    {
        "MeterId": "9ee077eb-c902-46ef-b7f9-2caeade852e0",
        "MeterName": "Compute Hours",
        "MeterCategory": "Cloud Services",
        "MeterSubCategory": "A6 Cloud Services",
        "Unit": "Hours",
        "MeterTags": [],
        "MeterRates": {
        "0": 0.71
        },
        "EffectiveDate": "2013-12-01T00:00:00Z",
        "IncludedQuantity": 0.0
    },
…   
]
"Currency": "CNY",
"Locale": "en-US",
"IsTaxIncluded": false,
    }

JSON元素定义

下面列出了 HTTP 响应体中可能出现的 JSON 数据元素。

元素名称 说明

Credit

信用

依据提供项条款提供的信用金额。此域仅供“货币承诺”类提供项条款使用。

Currency

货币

用于表示价格的货币。

EffectiveDate

生效日期

仪表价格或提供项条款从此日起生效。

ExcludedMeterIds

排除的仪表ID

从提供项条款中排除的仪表 ID。

IncludedQuantity

包含的数量

提供项中包含的免费资源数量。超出此数量会收费。

IsTaxIncluded

是否含税

所有价格均为税前价格,因此返回的数值始终为“false”。

Locale

地域文化

资源信息面向的地域文化。

MeterCategory

仪表类别

仪表的类别,例如“云服务”、“网络”等。

MeterId

仪表 ID

资源的唯一标识符。

MeterName

仪表名称

仪表的名称,在给定的仪表类别内。

MeterRates

仪表价格

仪表价格的键值对列表,采用“键”:“值”格式,其中键 = 仪表数量,值 = 对应的价格。

MeterRegion

仪表地区

Azure 服务的可用地区。

MeterSubCategory

仪表次级类别

仪表的次级类别,例如 “A6 云服务”、“ExpressRoute IXP” 等。

MeterStatus

仪表状态

仪表 ID 是“在用”还是“废弃”。

Name

名称

Azure 提供项条款的名称,例如“货币信用”。

ServiceRegion

服务地区

Azure 服务的可用地区。

Tags

标签

提供更多的仪表数据。

“第三方”表示无折扣的仪表。空白表示第一方。

TieredDiscount

分级折扣

分级仪表价格的键值对列表,采用“键”:“值”格式,其中键 = 价格,值 = 对应的折扣比例。此域仅供“货币承诺”类提供项条款使用。

Unit

单位

仪表消费的计量单位,例如“小时”、“GB” 等。

响应代码

HTTP 状态代码 错误代码 说明

200/OK

200/成功

n/a

成功查询的正常响应。响应体包含与指定过滤器匹配的数据。

400/Bad Request

400/无效请求

InvalidApiVersion

无效的 API 版本

不支持 API 版本查询参数或者格式不正确。

400/Bad Request

400/无效请求

InvalidProperty

无效的属性

属性缺失或者含有不合格的数值。响应体中的错误“代码”伴有对应的“消息”,解释有问题的属性。

400/Bad Request

400/无效请求

NoApiVersion

没有 API 版本

API 版本查询参数缺失。

401/Unauthorized

401/未授权

AuthenticationFailed

验证失败

通常由于使用无效或过期的访问令牌导致此错误。响应体中的错误“代码”伴有对应的“消息”,对错误进行解释。请见“验证 Azure 资源管理器请求”,了解关于获取安全的访问令牌的详情。

401/Unauthorized

401/未授权

MissingAuthorization

验证缺失

授权头信息缺失或不完整。请见“验证 Azure 资源管理器请求”,了解关于获取安全的访问令牌的详情。

404/Not Found

404/未发现

InvalidResourceType

无效的资源类型

API 版本参数中的版本不正确。响应中的错误“代码”伴有对应的“消息”,对错误进行解释。

404/Not Found

404/未发现

ObjectNotFound

未发现对象

客户没有授权。

404/Not Found

404/未发现

SubscriptionNotFound

未发现订阅

请求 URL 中的订阅 ID 值无效或者未发现订阅 ID 值。

想了解在境外其它国家由微软运营的Azure 服务,请访问微软 Azure 提供的项目详情