全栈应用服务器 > API 文档 > 实例 >获取实例列表

获取实例列表

最近更新时间: 2025-12-09 15:42:50

描述

分页获取实例列表。

请求路径

GET /v1/instances

请求参数

参数名称	参数类型	是否必填	描述
marker	string	否	分页标记，从上一次响应的 `nextMarker` 继续查询
limit	int	否	每页返回数量，取值范围：1~100，默认 20

响应字段

字段名称	字段类型	描述
items	object array	实例列表，元素结构与“获取实例详情”接口响应一致
nextMarker	string	下一页标记，没有更多数据时为空字符串

请求示例

GET /v1/instances?limit=1 HTTP/1.1
Host: <RegionID>-ecs.qiniuapi.com
Authorization: Qiniu <AccessToken>

响应示例

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{
  "items": [
    {
      "instanceID": "i-1234567890abcdef",
      "name": "my-instance",
      "state": "Running",
      "createdAt": "2024-01-01T00:00:00Z",
      "instanceTypeInfo": {
        "instanceType": "ecs.c1.large",
        "cpu": 4,
        "memory": 8
      },
      "cost": {
        "chargeType": "PostPaid"
      },
      "systemDisk": {
        "id": "d-1234567890abcdef",
        "diskType": "local.ssd",
        "size": 40
      },
      "region": {
        "id": "cn-hangzhou",
        "name": "杭州一区"
      }
    }
  ],
  "nextMarker": "i-abcdef1234567890"
}

以上内容是否对您有帮助？