华为云FLEXUS云服务_FLEXUS云数据库RDS-查询数据库实例列表:URI

时间:2024-08-07 10:52:05

URI

  • URI格式

    GET /v3/{project_id}/instances?id={id}&name={name}&type={type}&datastore_type={datastore_type}&group_type={group_type}&offset={offset}&limit={limit}&tags={key}={value}

  • 参数说明
    表1 参数说明

    名称

    参数类型

    是否必选

    说明

    project_id

    String

    参数解释

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

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

    约束限制

    不涉及。

    取值范围

    不涉及。

    默认取值

    不涉及。

    id

    String

    参数解释

    实例ID。

    “*”为系统保留字符,如果ID是以“*”起始,表示按照*后面的值模糊匹配,否则,按照ID精确匹配查询。不能只传入“*”。

    约束限制

    不涉及。

    取值范围

    不涉及。

    默认取值

    不涉及。

    name

    String

    参数解释

    实例名称。

    “*”为系统保留字符,如果name是以“*”起始,表示按照*后面的值模糊匹配,否则,按照name精确匹配查询。不能只传入“*”。

    约束限制

    不涉及。

    取值范围

    不涉及。

    默认取值

    不涉及。

    type

    String

    参数解释

    按照实例类型查询。

    约束限制

    不涉及。

    取值范围

    取值Single、Ha,分别对应于单实例、主备实例。

    默认取值

    不涉及。

    datastore_type

    String

    参数解释

    数据库类型。

    约束限制

    不涉及。

    取值范围

    MySQL,区分大小写。

    默认取值

    不涉及。

    offset

    Integer

    参数解释

    索引位置,偏移量。

    约束限制

    不涉及。

    取值范围

    从第一条数据偏移offset条数据后开始查询,默认为0(偏移0条数据,表示从第一条数据开始查询),必须为数字,不能为负数。

    默认取值

    0

    limit

    Integer

    参数解释

    查询记录数。

    约束限制

    不涉及。

    取值范围

    默认为100,不能为负数,最小值为1,最大值为100。

    默认取值

    100

    tags

    Array of objects

    参数解释:

    根据实例标签键值对进行查询。详情请参见表2

    约束限制:

    如果同时使用多个标签键值对进行查询,中间使用逗号分隔开,最多包含20组。

    group_type

    String

    参数解释:

    查询FlexusRDS实例列表。

    约束限制:

    不涉及。

    取值范围:

    flexus

    默认取值:

    不涉及。

    表2 tags字段数据结构说明

    名称

    参数类型

    是否必选

    说明

    key

    String

    参数解释:

    标签键。

    约束限制:

    不涉及。

    取值范围:

    长度为1-128个unicode字符。

    可以包含任何语种字母、数字、空格和_.:=+-@,但首尾不能含有空格,不能以_sys_开头。

    默认取值:

    不涉及。

    value

    String

    参数解释:

    标签值。

    约束限制:

    不涉及。

    取值范围:

    最大长度255个unicode字符,可以为空字符串。

    可以包含任何语种字母、数字、空格和_.:=+-@。

    默认取值:

    不涉及。

support.huaweicloud.com/api-flexusrds/rds_01_0004.html