更新时间:2024-09-26 GMT+08:00

查询度量单位进制

功能介绍

客户在自建平台上查询度量单位的进制转换信息,用于不同度量单位之间的转换。

接口约束

该接口可以使用客户AK/SK或者Token调用。

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。

URI

GET /v2/bases/conversions

表1 查询参数

参数

是否必选

参数类型

取值范围

描述

measure_type

Integer

[1-2147483647]

度量类型。

  • 1:货币
  • 2:时长
  • 3:流量
  • 4:数量
  • 6:长度
  • 7:容量
  • 9:行数
  • 10:周期
  • 11:频率
  • 12:个数
  • 15:容量*时长
  • 16:带宽速率
  • 17:容量时长
  • 18:查询速率
  • 19:带宽速率(1000进制)
  • 20:性能测试用量
  • 21:面积
  • 22:视频
  • 23:吞吐量
  • 26:通用资源包抵扣单位
  • 27:核数*时长
  • 28:内存*时长
  • 29:IOPS*时长
  • 30:吞吐量*时长
  • 31:个/时长
  • 40:流量(1000进制)
  • 41:1K Tokens
  • 103:港币
  • 104:tokens

此参数不携带或携带值为空或携带值为null时,不作为筛选条件;不支持携带值为空串。

请求消息

请求参数

请求示例

GET https://bss-intl.myhuaweicloud.com/v2/bases/conversions?measure_type=3 HTTP/1.1
Content-Type: application/json
X-Auth-TokenMIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ

响应消息

响应参数

参数

参数类型

取值范围

描述

error_code

String

最大长度:20

状态码。具体请参考状态码。只有失败才返回该字段。

error_msg

String

最大长度:1000

错误描述信息。只有失败才返回该字段。

conversions

List<Conversion>

-

度量单位的换算信息,具体参见表2

表2 Conversion

参数

参数类型

取值范围

描述

measure_id

Integer

-

度量单位ID。

例如:10表示GB。

ref_measure_id

Integer

-

转换后的度量单位ID。

例如:11表示MB。

conversion_ratio

Long

-

度量单位和转换后的度量单位之间的转换比率。

例如:

度量单位为GB,转换度量单位为MB时,转换比率为1024,两者之间的转换公式为:1GB=1024MB。

measure_type

Integer

[1-2147483647]

度量类型。

  • 1:货币
  • 2:时长
  • 3:流量
  • 4:数量
  • 6:长度
  • 7:容量
  • 9:行数
  • 10:周期
  • 11:频率
  • 12:个数
  • 15:容量*时长
  • 16:带宽速率
  • 17:容量时长
  • 18:查询速率
  • 19:带宽速率(1000进制)
  • 20:性能测试用量
  • 21:面积
  • 22:视频
  • 23:吞吐量
  • 26:通用资源包抵扣单位
  • 27:核数*时长
  • 28:内存*时长
  • 29:IOPS*时长
  • 30:吞吐量*时长
  • 31:个/时长
  • 40:流量(1000进制)
  • 41:1K Tokens
  • 103:港币
  • 104:tokens

响应示例

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: length
Date: response time  
{
   "conversions": [
        {
            "measure_id": 10,
            "ref_measure_id": 11,
            "conversion_ratio": 1024,
            "measure_type": 3
        },
        {
            "measure_id": 0,
            "ref_measure_id": 5,
            "conversion_ratio": 1440,
            "measure_type": 2
        }
    ]
}

状态码

  • 状态码4xx:由于明显的客户端错误(例如,格式错误的请求语法、参数错误等),华为云会返回4xx错误码,请及时检查请求消息的正确性,重新发起请求。
  • 状态码5xx:由于华为云系统原因,导致无法完成明显有效请求的处理,可及时联系华为云客服处理。

HTTP状态码

错误码

错误描述

403

CBC.0151

访问拒绝。

500

CBC.0999

其他错误。