Querying the Measurement Unit Number System

Function

This API is used to query the measurement unit number system on the partner sales platform.

Constraints

This API can be invoked using the partner AK/SK or token.

Debugging

You can debug the API in API Explorer which supports automatic authentication. API Explorer can automatically generate and debug example SDK code.

URI

GET /v2/bases/conversions

**Table 1** Request parameters
Parameter	Mandatory	Type	Value Range	Description
measure_type	No	Integer	-	Measurement type. 1: currency 2: duration 3: traffic 4: quantity 7: capacity 9: number of lines 10: period 11: frequency 12: number 16: bandwidth 17: capacity-duration 18: query rate 19: bandwidth (1000) 20: performance test usage 21: area 22: video 23: throughput 26: deduction unit for a general resource package 29: IOPS x duration 30: throughput x duration 31: number/duration 40: traffic (1000) 41: 1K tokens If this parameter is not included in the request parameters, is left empty, or is set to null, it cannot be used as a filter criterion.

Request

Request Parameters

None

Example Request

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

Response

Response Parameters

Parameter	Type	Value Range	Description
error_code	String	A maximum of 20 characters	Error code. For details, see Returned Values. This parameter is returned only when the query failed.
error_msg	String	A maximum of 1000 characters	Error description. This parameter is returned only when the query failed.
conversions	List<Conversion>	-	Measurement unit conversion information. For details, see Table 2.

**Table 2** Conversion
Parameter	Type	Value Range	Description
measure_id	Integer	-	Measurement unit ID. For example, 10 indicates GB.
ref_measure_id	Integer	-	Measurement unit ID after conversion. For example, 11 indicates MB.
conversion_ratio	Long	-	Conversion ratio. Example: If the measurement unit is GB and the target unit is MB, the conversion ratio is 1024 (1 GB = 1024 MB).
measure_type	Integer	-	Measurement type. 1: currency 2: duration 3: traffic 4: quantity 7: capacity 9: number of lines 10: period 11: frequency 12: number 16: bandwidth 17: capacity-duration 18: query rate 19: bandwidth (1000) 20: performance test usage 21: area 22: video 23: throughput

Example Response

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

Returned Values

4xx: This class of HTTP status code is intended for situations in which the error seems to have been caused by the client, for example, the request contains bad syntax or incorrect parameters. You must ensure the request is correct.
5xx: This class of HTTP status code is intended for cases in which the Huawei Cloud server is aware that it has encountered an error or is otherwise incapable of performing the request. In this case, contact Huawei Cloud customer service.