文档首页/ 数据管理服务 DAS/ API参考/ API(公测中)/ 云DBA/ 查询索引使用数量趋势 - GetIndexUsageTrend
更新时间:2025-11-28 GMT+08:00
分享

查询索引使用数量趋势 - GetIndexUsageTrend

功能介绍

查询索引使用数量趋势。

授权信息

账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权,具体权限要求请参见权限和授权项
  • 如果使用身份策略授权,需具备如下身份策略权限。

    授权项

    访问级别

    资源类型(*为必须)

    条件键

    别名

    依赖的授权项

    das::showCloudDBAInfo

    read

    -

    -

    -

    -

URI

GET /v3/{project_id}/instances/{instance_id}/index-usage/get-index-usage-trend

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释

租户在某一Region下的项目ID。

获取方法请参见获取项目ID

约束限制:

不涉及。

取值范围:

只能由英文字母、数字组成,且长度为32个字符。

默认取值:

不涉及。

instance_id

String

参数解释:

实例ID。标识实例的唯一标识。

约束限制:

不涉及。

取值范围:

只能由英文字母、数字组成,且长度为32个字符。

默认取值:

不涉及。

请求参数

响应参数

状态码: 200

表2 响应Body参数

参数

参数类型

描述

trend_list

Arrays of 表3 Objects

参数解释:

趋势数量列表。

取值范围:

不涉及。

fragmentation_trend

表4 Object

参数解释:

碎片率趋势。

取值范围:

不涉及。

usage_trend

表4 Object

参数解释:

使用率趋势。

取值范围:

不涉及。

表3 Point

参数

参数类型

描述

collect_time

Long

参数解释:

采集时间。

取值范围:

不涉及。

max_fragmentation_percentage

Double

参数解释:

TOP1碎片率。

取值范围:

不涉及。

index_size_mb

Double

参数解释:

总空间大小,MB。

取值范围:

不涉及。

page_count

Double

参数解释:

页数量。

取值范围:

不涉及。

表4 Percent

参数

参数类型

描述

percent_le10_count

Long

参数解释:

百分比小于等于10%的数量。

取值范围:

不涉及。

percent10_to50_count

Long

参数解释:

百分比大于10%小于等于50%的数量。

取值范围:

不涉及。

percent50_to80_count

Long

参数解释:

百分比大于50%小于等于80%的数量。

取值范围:

不涉及。

percent_gl80_count

Long

参数解释:

百分比大于80%的数量。

取值范围:

不涉及。

请求示例

GET https://das.cn-north-1.myhuaweicloud.com/v3/abfb7eecd30f497f8e21f03106c7a604/instances/ccb0301017874d4b8d8e697ab8e5834ain04/index-usage/get-index-usage-trend 
 

响应示例

状态码: 200

Success.

{
    "trend_list": [
        {
            "collect_time": 1763613122000,
            "max_fragmentation_percentage": 99.75,
            "index_size_mb": 10952.2,
            "page_count": 1401876
        }
    ],
    "fragmentation_trend": {
        "percent_le10_count": 121,
        "percent10_to50_count": 56,
        "percent50_to80_count": 11,
        "percent_gl80_count": 130
    },
    "usage_trend": {
        "percent_le10_count": 253,
        "percent10_to50_count": 15,
        "percent50_to80_count": 10,
        "percent_gl80_count": 40
    }
}

状态码

状态码

描述

200

Success.

400

Client error.

500

Server error.

错误码

请参见错误码

相关文档