文档首页 > > API参考> API> 实例管理> 查询实例列表

查询实例列表

分享
更新时间: 2020/06/13 GMT+08:00

功能介绍

根据指定条件查询实例列表。

接口约束

该接口支持DDS社区版和增强版。

URI

  • URI格式

    GET /v3/{project_id}/instances?id={id}&name={name}&mode={mode}&datastore_type={datastore_type}&vpc_id={vpc_id}&subnet_id={subnet_id}&offset={offset}&limit={limit}

  • 参数说明
    表1 参数说明

    名称

    是否必选

    参数类型

    描述

    project_id

    String

    租户在某一region下的project ID。

    id

    String

    实例ID。

    name

    String

    实例名称。

    如果name以“*”起始,表示按照“*”后面的值模糊匹配,否则,按照实际填写的name精确匹配查询。

    说明:

    “*”为系统保留字符,不能只传入该字符。

    mode

    String

    实例类型。

    • 取值为“Sharding”,表示集群实例。
    • 取值为“ReplicaSet”,表示副本集实例。
    • 取值为“Single”,表示单节点实例。

    datastore_type

    String

    数据库版本类型。

    • 取值为“DDS-Community”,表示DDS社区版实例。
    • 取值为“DDS-Enhanced”,表示DDS增强版实例。

    vpc_id

    String

    虚拟私有云ID,获取方法如下:

    • 方法1:登录虚拟私有云服务的控制台界面,在虚拟私有云的详情页面查找VPC ID。
    • 方法2:通过虚拟私有云服务的API接口查询,具体操作可参考查询VPC列表

    subnet_id

    String

    子网的网络ID,获取方法如下:

    • 方法1:登录虚拟私有云服务的控制台界面,单击VPC下的子网,进入子网详情页面,查找网络ID。
    • 方法2:通过虚拟私有云服务的API接口查询,具体操作可参考查询子网列表

    offset

    Integer

    索引位置偏移量,表示从指定project ID下最新的实例创建时间开始,按时间的先后顺序偏移offset条数据后查询对应的实例信息。

    取值大于或等于0。不传该参数时,查询偏移量默认为0,表示从最新的实例创建时间对应的实例开始查询。

    limit

    Integer

    查询实例个数上限值。

    取值范围:1~100。不传该参数时,默认查询前100条实例信息。

请求消息

  • 请求头
    查询所有实例列表:
    GET https://DDS的Endpoint/v3/0483b6b16e954cb88930a360d2c4e663/instances
    根据指定条件查询实例列表:
    GET https://DDS的Endpoint/v3/0483b6b16e954cb88930a360d2c4e663/instances?offset=0&limit=10&id=ed7cc6166ec24360a5ed5c5c9c2ed726in02&name=hy&mode=ReplicaSet&datastore_type=DDS-Community&vpc_id=19e5d45d-70fd-4a91-87e9-b27e71c9891f&subnet_id=bd51fb45-2dcb-4296-8783-8623bfe89bb7
  • 请求体

    N/A

响应消息

  • 要素说明
    表2 要素说明

    名称

    参数类型

    描述

    instances

    Array of objects

    实例信息。详情请参见表3

    total_count

    Integer

    总记录数。

    表3 instances字段数据结构说明

    名称

    参数类型

    描述

    id

    String

    实例ID。

    name

    String

    实例名称。

    status

    String

    实例状态。

    取值:

    • normal,表示实例正常。
    • abnormal,表示实例异常。
    • creating,表示实例创建中。
    • frozen,表示实例被冻结。
    • data_disk_full,表示实例磁盘已满。
    • createfail,表示实例创建失败。
    • enlargefail,表示实例扩容节点个数失败。

    port

    Integer

    数据库端口号。文档数据库实例支持的端口号范围为2100~9500。

    mode

    String

    实例类型。与请求参数相同。

    region

    String

    实例所在区域。

    datastore

    Object

    数据库信息。详情请参见表4

    engine

    String

    存储引擎。

    • 对于社区版实例,取值为“wiredTiger”。
    • 对于增强版实例,取值为“rocksDB”。

    created

    String

    实例创建时间。

    updated

    String

    实例操作最新变更的时间。

    db_user_name

    String

    默认用户名。取值为“rwuser”。

    ssl

    Integer

    是否开启SSL安全连接。

    • 取值为“1”,表示开启。
    • 取值为“0”,表示不开启。

    vpc_id

    String

    虚拟私有云ID。

    subnet_id

    String

    子网的网络ID。

    security_group_id

    String

    安全组ID。

    backup_strategy

    Object

    备份策略。详情请参见表5

    pay_mode

    String

    计费方式。

    • 取值为“0”,表示按需计费。
    • 取值为“1”,表示包年/包月计费。

    maintenance_window

    String

    系统可维护时间窗。

    groups

    Array of objects

    组信息。详情请参见表6

    storage

    Object

    增强版实例的存储池空间信息。详情请参见表8

    disk_encryption_id

    String

    磁盘加密的密钥ID。该参数仅在实例磁盘被加密时返回。

    enterprise_project_id

    String

    企业项目ID。

    取值为“0”,表示为default企业项目。

    time_zone

    String

    时区。

    actions

    Array of strings

    实例正在执行的动作。

    表4 datastore字段数据结构说明

    名称

    参数类型

    描述

    type

    String

    数据库引擎。

    version

    String

    数据库版本号。

    表5 backup_strategy字段数据结构说明

    名称

    参数类型

    描述

    start_time

    String

    备份时间段。自动备份将在该时间段内触发。当前时间指UTC时间。

    keep_days

    Integer

    已生成备份文件可以保存的天数。取值范围:0~732。

    表6 groups字段数据结构说明

    名称

    参数类型

    描述

    type

    String

    节点类型。

    取值:

    • shard
    • config
    • mongos
    • replica
    • single

    id

    String

    组ID。节点类型为shard和config时,该参数有效。

    name

    String

    组名称。节点类型为shard和config时,该参数有效。

    status

    String

    组状态。节点类型为shard和config时,该参数有效。

    volume

    Object

    volume信息。详情请参见表7。节点类型为shard、config、replica、single时,该参数有效。

    nodes

    Array of objects

    节点信息。详情请参见表9

    表7 volume字段数据结构说明

    名称

    参数类型

    描述

    size

    String

    磁盘大小。单位:GB。

    used

    String

    磁盘使用量。单位:GB。

    表8 storage字段数据结构说明

    名称

    参数类型

    描述

    size

    String

    磁盘大小。单位:GB。

    used

    String

    磁盘使用量。单位:GB。

    表9 nodes字段数据结构说明

    名称

    参数类型

    描述

    id

    String

    节点ID。

    name

    String

    节点名称。

    status

    String

    节点状态。

    role

    String

    节点角色。

    社区版实例下节点角色的取值:
    • master,mongos节点返回该值。
    • Primary,shard组主节点、config组主节点、副本集主节点、单节点返回该值。
    • Secondary,shard组备节点、config组备节点、副本集备节点返回该值。
    • Hidden,shard组隐藏节点、config组隐藏节点、副本集隐藏节点返回该值。
    • unknown,节点异常时返回该值。
    增强版实例下节点角色的取值:
    • master,mongos节点返回该值。
    • Primary,shard节点返回该值。
    • unknown,节点异常时返回该值。

    private_ip

    String

    节点内网IP。该参数仅针对集群实例的mongos节点、副本集实例、以及单节点实例有效,且在弹性云服务器创建成功后参数值存在,否则,值为""。

    public_ip

    String

    绑定的外网IP。该参数仅针对集群实例的mongos节点、副本集实例的主节点和备节点、以及单节点实例有效。

    spec_code

    String

    资源规格编码。关于实例的规格信息,请参见查询所有实例规格信息中响应参数“flavors.spec_code”的值。

    availability_zone

    String

    可用区。

    响应样例中参数“region”和“availability_zone”的值为示例值。

  • 响应样例
    查询所有实例列表:
    { 
        "instances": [
            {
                "id": "8436a91546294036b75931e879882200in02",
                "name": "dds-efa6",
                "status": "normal",
                "port": "8635",
                "mode": "ReplicaSet",
                "region": "aaa",
                "datastore": {
                    "type": "DDS-Community",
                    "version": "3.4"
                },
                "engine": "wiredTiger",
                "created": "2019-01-17T07:05:52",
                "updated": "2019-01-17T07:05:47",
                "db_user_name": "rwuser",
                "ssl": "1",
                "vpc_id": "674e9b42-cd8d-4d25-a2e6-5abcc565b961",
                "subnet_id": "f1df08c5-71d1-406a-aff0-de435a51007b",
                "security_group_id": "7aa51dbf-5b63-40db-9724-dad3c4828b58",
                "backup_strategy": {
                    "start_time": "16:00-17:00",
                    "keep_days": 7
                },
                "pay_mode": "0",
                "maintenance_window": "02:00-06:00",
                "groups": [
                    {
                        "type": "replica",
                        "volume": {
                            "size": "10",
                            "used": "0.33"
                        },
                        "nodes": [
                            {
                                "id": "233eaac9c6f245c0bb9c2d21eea12d1bno02",
                                "name": "dds-efa6_replica_node_2",
                                "status": "normal",
                                "role": "Primary",
                                "private_ip": "192.168.0.174",
                                "public_ip": "",
                                "spec_code": "dds.s2.medium.4.shard",
                                "availability_zone": "bbb"
                            },
                            {
                                "id": "d57d76d6320a4a7b86db82c317550c4ano02",
                                "name": "dds-efa6_replica_node_1",
                                "status": "normal",
                                "role": "Hidden",
                                "private_ip": "192.168.0.39",
                                "public_ip": "",
                                "spec_code": "dds.s2.medium.4.shard",
                                "availability_zone": "bbb"
                            },
                            {
                                "id": "f46b0a1cf4d9400e9fd7af17f8742d37no02",
                                "name": "dds-efa6_replica_node_3",
                                "status": "normal",
                                "role": "Secondary",
                                "private_ip": "192.168.0.176",
                                "public_ip": "",
                                "spec_code": "dds.s2.medium.4.shard",
                                "availability_zone": "bbb"
                            }
                        ]
                    }
                ],
                "enterprise_project_id": "0",
                "time_zone": "",
                "actions": [
                  "CREATE"
                 ]
            },
            {
                "id": "d77905385f114217b75ae7d6ab9a7588in02",
                "name": "dds-5699",
                "status": "normal",
                "port": "8635",
                "mode": "Single",
                "region": "aaa",
                "datastore": {
                    "type": "DDS-Community",
                    "version": "3.4"
                },
                "engine": "wiredTiger",
                "created": "2019-01-17T07:04:39",
                "updated": "2019-01-17T07:04:33",
                "db_user_name": "rwuser",
                "ssl": "1",
                "vpc_id": "674e9b42-cd8d-4d25-a2e6-5abcc565b961",
                "subnet_id": "f1df08c5-71d1-406a-aff0-de435a51007b",
                "security_group_id": "7aa51dbf-5b63-40db-9724-dad3c4828b58",
                "backup_strategy": {
                    "start_time": "17:00-18:00",
                    "keep_days": 7
                },
                "pay_mode": "0",
                "maintenance_window": "02:00-06:00",
                "groups": [
                    {
                        "type": "single",
                        "volume": {
                            "size": "10",
                            "used": "0.33"
                        },
                        "nodes": [
                            {
                                "id": "bd4dccbd53ae48d5bd3046bebf715079no02",
                                "name": "dds-5699_single_node_1",
                                "status": "normal",
                                "role": "Primary",
                                "private_ip": "192.168.0.9",
                                "public_ip": "",
                                "spec_code": "dds.c3.medium.4.single",
                                "availability_zone": "bbb"
                            }
                        ]
                    }
                ],
                "enterprise_project_id": "0",
                "time_zone": "",
                "actions": [
                  "CREATE"
                 ]
            },
            {
                "id": "9136fd2a9fcd405ea4674276ce36dae8in02",
                "name": "dds-32f4",
                "status": "normal",
                "port": "8635",
                "mode": "Sharding",
                "region": "aaa",
                "datastore": {
                    "type": "DDS-Community",
                    "version": "3.4"
                },
                "engine": "wiredTiger",
                "created": "2019-01-17T07:04:37",
                "updated": "2019-01-17T07:04:31",
                "db_user_name": "rwuser",
                "ssl": "1",
                "vpc_id": "674e9b42-cd8d-4d25-a2e6-5abcc565b961",
                "subnet_id": "f1df08c5-71d1-406a-aff0-de435a51007b",
                "security_group_id": "7aa51dbf-5b63-40db-9724-dad3c4828b58",
                "backup_strategy": {
                    "start_time": "19:00-20:00",
                    "keep_days": 7
                },
                "pay_mode": "0",
                "maintenance_window": "02:00-06:00",
                "groups": [
                    {
                        "type": "mongos",
                        "nodes": [
                            {
                                "id": "a742c13a284949adad177672e8a0f01cno02",
                                "name": "dds-32f4_mongos_node_1",
                                "status": "normal",
                                "role": "master",
                                "private_ip": "192.168.0.56",
                                "public_ip": "",
                                "spec_code": "dds.c3.medium.4.mongos",
                                "availability_zone": "bbb"
                            },
                            {
                                "id": "d4f66666b1d64ab28719da0526341c7eno02",
                                "name": "dds-32f4_mongos_node_2",
                                "status": "normal",
                                "role": "master",
                                "private_ip": "192.168.0.185",
                                "public_ip": "",
                                "spec_code": "dds.c3.medium.4.mongos",
                                "availability_zone": "bbb"
                            }
                        ]
                    },
                    {
                        "type": "shard",
                        "id": "d1b92d2cbd544e85ac7ce6a7f33ba205gr02",
                        "name": "shard_2",
                        "status": "normal",
                        "volume": {
                            "size": "10",
                            "used": "0.33"
                        },
                        "nodes": [
                            {
                                "id": "0e9abaebe5974b63a5b221de6ee34cfeno02",
                                "name": "dds-32f4_shard_2_node_3",
                                "status": "normal",
                                "role": "Primary",
                                "spec_code": "dds.c3.medium.4.shard",
                                "availability_zone": "bbb"
                            },
                            {
                                "id": "1d7f4c5476c04cc187f920925c2b601fno02",
                                "name": "dds-32f4_shard_2_node_2",
                                "status": "normal",
                                "role": "Hidden",
                                "spec_code": "dds.c3.medium.4.shard",
                                "availability_zone": "bbb"
                            },
                            {
                                "id": "3dd2cce03da54fc08f10651cbfea778dno02",
                                "name": "dds-32f4_shard_2_node_1",
                                "status": "normal",
                                "role": "Secondary",
                                "spec_code": "dds.c3.medium.4.shard",
                                "availability_zone": "bbb"
                            }
                        ]
                    },
                    {
                        "type": "shard",
                        "id": "06439baa35c146d3a8965af59d370908gr02",
                        "name": "shard_1",
                        "status": "normal",
                        "volume": {
                            "size": "10",
                            "used": "0.33"
                        },
                        "nodes": [
                            {
                                "id": "0f6744d7e29f42ff80fc1a36cc145042no02",
                                "name": "dds-32f4_shard_1_node_1",
                                "status": "normal",
                                "role": "Primary",
                                "spec_code": "dds.c3.medium.4.shard",
                                "availability_zone": "bbb"
                            },
                            {
                                "id": "3abcb399113b4512bd5a906da54e8753no02",
                                "name": "dds-32f4_shard_1_node_3",
                                "status": "normal",
                                "role": "Hidden",
                                "spec_code": "dds.c3.medium.4.shard",
                                "availability_zone": "bbb"
                            },
                            {
                                "id": "c149f70563494501b5706cad225a8ebdno02",
                                "name": "dds-32f4_shard_1_node_2",
                                "status": "normal",
                                "role": "Secondary",
                                "spec_code": "dds.c3.medium.4.shard",
                                "availability_zone": "bbb"
                            }
                        ]
                    },
                    {
                        "type": "config",
                        "id": "84e7c96b82aa4fedb3b00f98edd71ba4gr02",
                        "name": "config",
                        "status": "normal",
                        "volume": {
                            "size": "20",
                            "used": "0.33"
                        },
                        "nodes": [
                            {
                                "id": "7422f7331b714ac39aa647a1ec968d33no02",
                                "name": "dds-32f4_config_node_2",
                                "status": "normal",
                                "role": "Primary",
                                "spec_code": "dds.c3.large.2.config",
                                "availability_zone": "bbb"
                            },
                            {
                                "id": "9e3b343151044eda91ddb8a42ae5cbefno02",
                                "name": "dds-32f4_config_node_3",
                                "status": "normal",
                                "role": "Hidden",
                                "spec_code": "dds.c3.large.2.config",
                                "availability_zone": "bbb"
                            },
                            {
                                "id": "c0053ca460ac4889841ffb14a886ec54no02",
                                "name": "dds-32f4_config_node_1",
                                "status": "normal",
                                "role": "Secondary",
                                "spec_code": "dds.c3.large.2.config",
                                "availability_zone": "bbb"
                            }
                        ]
                    }
                ],
                "enterprise_project_id": "0",
                "time_zone": "",
                "actions": [
                  "CREATE"
                 ]
            },
    {
                "id": "ee05c73fe7f64390a6e85758c17cc3a8in10",
                "name": "dds-a086",
                "status": "normal",
                "port": "8635",
                "mode": "Sharding",
                "region": "aaa",
                "datastore": {
                    "type": "DDS-Enhanced",
                    "version": "3.4"
                },
                "engine": "rocksDB",
                "created": "2019-05-07T03:08:08",
                "updated": "2019-05-07T03:08:04",
                "db_user_name": "rwuser",
                "ssl": "1",
                "vpc_id": "68ed686b-872c-4937-93b7-9b708035de1e",
                "subnet_id": "6349a1b5-58cd-4641-9766-f9613ee74ec5",
                "security_group_id": "aca4d06a-de74-4972-9e43-fb532fb78eba",
                "backup_strategy": {
                    "start_time": "00:00-01:00",
                    "keep_days": 7
                },
                "pay_mode": "0",
                "maintenance_window": "02:00-06:00",
                "groups": [
                    {
                        "type": "mongos",
                        "nodes": [
                            {
                                "id": "07d854d0989641f1992059fbde911a0fno10",
                                "name": "dds-a086_mongos_node_1",
                                "status": "normal",
                                "role": "master",
                                "private_ip": "192.168.0.211",
                                "public_ip": "",
                                "spec_code": "dds.container.c3.medium.4.mongos",
                                "availability_zone": "bbb"
                            },
                            {
                                "id": "15edf741c39b40bebe8a0d12984bc337no10",
                                "name": "dds-a086_mongos_node_2",
                                "status": "normal",
                                "role": "master",
                                "private_ip": "192.168.0.161",
                                "public_ip": "",
                                "spec_code": "dds.container.c3.medium.4.mongos",
                                "availability_zone": "bbb"
                            }
                        ]
                    },
                    {
                        "type": "shard",
                        "id": "abbb7fcba9c84527a69efc26bb94b09bgr10",
                        "name": "shard_2",
                        "status": "normal",
                        "nodes": [
                            {
                                "id": "87bd4d89259740bb9a0efbd750c3f49fno10",
                                "name": "dds-a086_shard_2_node_1",
                                "status": "normal",
                                "role": "Primary",
                                "spec_code": "dds.container.c3.medium.4.shard",
                                "availability_zone": "bbb"
                            }
                        ]
                    },
                    {
                        "type": "shard",
                        "id": "dba76fca4bca4597939588f1b29a703egr10",
                        "name": "shard_1",
                        "status": "normal",
                        "nodes": [
                            {
                                "id": "8ea7472c3b1e495d9bd0b56c156ac09bno10",
                                "name": "dds-a086_shard_1_node_1",
                                "status": "normal",
                                "role": "Primary",
                                "spec_code": "dds.container.c3.medium.4.shard",
                                "availability_zone": "bbb"
                            }
                        ]
                    }
                ],
                "storage": {
                    "size": "100.0",
                    "used": ".00"
                },
                "enterprise_project_id": "0",
                "time_zone": "",
                "actions": [
                    "BACKUP"
                ]
            }
        ],
        "total_count": 4
    }

状态码

详情请参见状态码

错误码

详情请参见错误码

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

智能客服提问云社区提问