更新时间:2024-12-10 GMT+08:00
分享

查询EVS容量

功能

查询EVS弹性卷存储服务,所用到的物理存储服务器的总量、已分配量、剩余可用量等。

SLA项

定义

请求成功率

≥99%

可用性

Tier 2

数据一致性

强一致

吞吐量

60 次/分钟

TP50请求时延

200 ms

TP99.9请求时延

300 ms

注意事项

调用方法

GET

URI

/rest/dataapi/homs/open-api/v1/CloudService/capacity

路径参数

查询参数

请求

  • 请求header参数

    参数

    是否必选

    类型

    值域

    说明

    X-APIG-Appcode

    string

    由SRE分配的AppCode。

    x-auth-token

    string

    调用方APIG的IAM认证token。

    x-hcso-domainid

    是(HCSO场景)

    否(其他场景)

    string

    接入的租户ID。

    x-hcso-appcode

    string

    由SRE分配的AppCode

  • 查询参数

    参数

    是否必选

    类型

    值域

    说明

    begin_time

    int

    查询开始时间(毫秒时间戳)。

    end_time

    int

    查询结束时间(毫秒时间戳)。

    service_type

    string

    EVS

    服务类型。

    zone_type

    string

    manage/pod

    manage管理区,pod租户区。

    page_size

    int

    0~1000

    页大小。

    offset_value

    int

    查询起始值。

  • 请求body参数

  • 请求示例
    GET /rest/dataapi/homs/open-api/v1/CloudService/capacity?service_type=EVS HTTP/1.1 
    Host: example.com
    Content-Type: application/json 
    Accept: application/json
    X-APIG-Appcode: xxx 
    x-auth-token: xxx 
    x-hcso-domainid:xxx 
    x-hcso-appcode:xxx

响应

  • 响应参数

    参数

    是否必选

    类型

    值域

    说明

    code

    String

    返回码。

    msg

    String

    返回消息。

    total

    Integer

    数据条数。

    service_type

    String

    云服务名,标识资源所属的云服务EVS。

    timestamp

    Long

    时间戳。

    region

    String

    资源所属region中文名。

    zone_type

    String

    资源所属区域类型:MANAGE管理区,POD租户区。

    allocated

    String

    已分配发放量,xxTB(单位)。

    avaliable

    String

    剩余可发放量,xxTB(单位)。

    metric_type

    String

    云硬盘类型指标:如SAS盘,SSD盘、高IO盘、普通IO盘。

  • 响应示例
    HTTP/1.1 200  OK
    Date:Tue,18 Jul 2023 09:58:01 GMT
    Server: example.com
    Content-Type: application/json;charset=UTF8 
    { 
        "total": 2, 
        "list": [ 
                 { 
                 "available": "94.5693359375", 
                 "metric_type": "SAS", 
                 "service_type": "EVS", 
                 "zone_type": "MANAGE", 
                 "region": "cn-central-229", 
                 "allocated": "112.2265625", 
                 "timestamp": "1649692800000" 
                 }, 
                 { 
                 "available": "102.4052734375", 
                 "metric_type": "SAS", 
                 "service_type": "EVS", 
                 "zone_type": "MANAGE", 
                 "region": "cn-east-264", 
                 "allocated": "173.3232421875", 
                "timestamp": "1649692800000" 
                 } 
               ] 
    }

状态码

状态码

说明

200

操作成功。

400

参数错误。

401

token鉴权失败。

403

鉴权失败。

404

rest接口未找到。

500

默认ServiceException异常码,应用内部错误。

相关文档