获取PFS实例列表
更新时间：2025-03-19
描述
获取PFS实例列表
请求
请求结构
Bash
1GET /v1/pfs/instance?maxKeys=1&manner=marker
2x-bce-date: 2023-06-09T10:08:22Z
3host: pfs.xx.baidubce.com ## 请将xx替换为对应地域的服务域名，如北京为bj、保定为bd、苏州为su、阳泉为yq
4content-type: application/json
5Authorization: authorization string请求头域
除公共头域外，无其他特殊头域
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| maxKeys | int | 否 | URL Parameter | 返回实例列表长度最大为1000，默认为20个，取值范围为【1，1000】，超过范围的规整为1或1000 |
| manner | string | 是 | URL Parameter | 请求的分段类型，必须指定marker |
| marker | string | 否 | URL Parameter | 按照instanceId（格式一般为""pfs-xxxxxx""）的字典序排列，从marker之后的第一个开始返回（不包括marker） |
| filterTag | string | 否 | URL Parameter | 用于过滤的标签 |
响应
返回状态码，成功返回200，失败返回见错误码
返回头域
除公共头域外，无其他特殊头域
返回参数
| 参数名字 | 参数类型 | 是否必须 | 参数位置 | 描述 |
|---|---|---|---|---|
| isTruncated | bool | 是 | response body | |
| marker | string | 否 | response body | 按照instanceId（格式一般为""pfs-xxxxxx""）的字典序排列，从marker之后的第一个开始返回（不包括marker） |
| maxKeys | int | 是 | response body | 请求返回的result个数 |
| nextMarker | string | 否 | response body | 下次请求需要传递的marker值 |
| result | List |
否 | response body | PFS实例详细信息 |
示例
请求：
Bash
1GET /v1/pfs/instance?maxKeys=1&manner=marker
2x-bce-date: 2023-06-09T10:08:22Z
3host: pfs.xx.baidubce.com ## 请将xx替换为对应地域的服务域名，如北京为bj、保定为bd、苏州为su、阳泉为yq
4content-type: application/json
5Authorization: authorization string响应：
Bash
1HTTP/1.1 200 OK
2x-bce-request-id: 946002ee-cb4f-4aad-b686-5be55df27f09
3Date: Wed, 10 Apr 2016 08:26:52 GMT
4Transfer-Encoding: chunked
5Content-Type: application/json;charset=UTF-8
6{
7 "isTruncated": true,
8 "marker": "",
9 "maxKeys": 1,
10 "nextMarker": "pfs-0xxxxy",
11 "result": [
12 {
13 "capacity": 7168,
14 "createTime": "2023-06-09T05:04:30Z",
15 "description": "PFS l2 test",
16 "endpoint": "172.16.32.8",
17 "instanceId": "pfs-xxxx",
18 "instanceStatus": "RUNNING",
19 "instanceType": "basic",
20 "name": "",
21 "paymentTiming": "postpay",
22 "subnetModel": {
23 "cidr": "172.16.32.0/20",
24 "physicalZone": "AZONE-gzbh",
25 "subnetId": "sbn-6xba3cdasf1",
26 "zoneName": "zoneC"
27 },
28 "usage": 0,
29 "vpcId": "vpc-jx648pkxw3tc"
30 }
31 ]
32}