{"componentChunkName":"component---src-templates-acg-portal-new-template-tsx","path":"/imt8n4eu1","result":{"data":{"markdownRemark":{"html":"

\n该接口用于按 marker 方式分页查询用户的实例快照列表，返回实例快照及其子快照明细。

\n

marker 缺省为 -1，表示从头开始查询；后续分页请传上一次响应返回的 nextMarker。
maxKeys 缺省为 10，取值范围为 1-100。
instanceIds 与 instanceSnapshotIds 为可选过滤条件，均支持短ID和长UUID两种形式。
响应中 isTruncated 为 true 表示后面还有数据，此时 nextMarker 为下一页的起始 marker；为 false 时 nextMarker 不返回。
请求 marker 为 -1 时，响应中回显的 marker 归一为空字符串。

\n

\n

\n API Explorer\n \n 去调试\n

\n\n

\n

\n 您可以在 API Explorer 中直接运行该接口，免去您计算签名的困扰。运行成功后，API Explorer 可以自动生成 SDK 代码示例。\n

\n

\n

请求结构

\n\n

\n

\n

\n Plain Text\n \n

\n

\n

1POST /v{version}/snapshot/insnap/list HTTP/1.1\n2Host: bcc.bj.baidubce.com\n3Authorization: authorization string\n4\n5{\n6    "marker": marker,\n7    "maxKeys": maxKeys,\n8    "instanceIds" : [instanceId],\n9    "instanceSnapshotIds" : [instanceSnapshotId]\n10}

\n

\n

\n

\n \n

请求头域

\n

除公共头域外，无其它特殊头域。

\n

请求参数

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

参数名称	类型	是否必需	参数位置	描述
version	String	是	URL参数	API版本号
marker	String	否	RequestBody参数	批量获取列表的查询起始位置，是一个由系统生成的字符串，缺省 -1 表示从头开始
maxKeys	int	否	RequestBody参数	每页包含的最大数量，取值范围1-100，缺省值为10
instanceIds	List<String>	否	RequestBody参数	按实例ID过滤，选填
instanceSnapshotIds	List<String>	否	RequestBody参数	按实例快照ID过滤，选填

\n

返回头域

\n

除公共头域，无其它特殊头域。

\n

返回参数

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

参数名称	类型	描述
marker	String	标记查询的起始位置
isTruncated	Boolean	true表示后面还有数据，false表示已经是最后一页
nextMarker	String	获取下一页所需要传递的marker值。当isTruncated为false时，该域不出现
maxKeys	int	每页包含的最大数量
instanceSnapshots	List<InstanceSnapshotModel>	返回的实例快照列表

\n

错误码

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

错误码	错误描述	HTTP状态码	中文解释
ConstraintViolationException	maxKeys must be at most 100	400	maxKeys 超出取值范围
BadRequest	Bad request parameters or illegal request.	400	请求参数无效

\n

请求示例

\n\n

\n

\n

\n Plain Text\n \n

\n

\n

1POST /v2/snapshot/insnap/list HTTP/1.1\n2Host: bcc.bj.baidubce.com\n3Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de\n4\n5{\n6    "marker": "-1",\n7    "maxKeys": 10\n8}

\n

\n

\n

\n \n

返回示例

\n\n

\n

\n

\n Plain Text\n \n

\n

\n

1HTTP/1.1 200 OK\n2x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50\n3Date: Wed, 03 Dec 2014 06:42:19 GMT\n4Content-Type: application/json;charset=UTF-8\n5Server: BWS\n6\n7{\n8    "marker": "",\n9    "isTruncated": false,\n10    "maxKeys": 10,\n11    "instanceSnapshots": [\n12        {\n13            "instanceSnapshotId": "ins-fSzBB13i",\n14            "instanceSnapshotName": "example-insnap-001",\n15            "instanceSnapshotSizeInGiB": 60,\n16            "createdTime": "2026-08-20T09:12:33Z",\n17            "instanceSnapshotStatus": "active",\n18            "instanceId": "i-YufwpQAe",\n19            "snapshots": [\n20                {\n21                    "snapshotId": "s-6r3dam6F",\n22                    "snapshotName": "example-insnap-001-sys",\n23                    "snapshotSizeInGiB": 40,\n24                    "snapshotStatus": "Available",\n25                    "volumeId": "i-YufwpQAe",\n26                    "instanceSnapshotId": "ins-fSzBB13i",\n27                    "creationMethod": "MANUAL",\n28                    "description": "",\n29                    "createdTime": "2026-08-20T09:12:33Z",\n30                    "expiredTime": "2026-08-27T09:12:33Z",\n31                    "encrypted": false,\n32                    "imageId": ""\n33                },\n34                {\n35                    "snapshotId": "s-8kL2nvQx",\n36                    "snapshotName": "example-insnap-001-data",\n37                    "snapshotSizeInGiB": 20,\n38                    "snapshotStatus": "Available",\n39                    "volumeId": "v-nky7qeom",\n40                    "instanceSnapshotId": "ins-fSzBB13i",\n41                    "creationMethod": "MANUAL",\n42                    "description": "",\n43                    "createdTime": "2026-08-20T09:12:33Z",\n44                    "expiredTime": "2026-08-27T09:12:33Z",\n45                    "encrypted": false,\n46                    "imageId": ""\n47                }\n48            ]\n49        }\n50    ]\n51}

\n

\n

\n

\n ","fields":{"slug":"imt8n4eu1","title":"查询实例快照列表","date":"2026-08-31","extractedHeadings":[]},"headings":[]}},"pageContext":{"isCreatedByStatefulCreatePages":false,"slug":"imt8n4eu1","prev":{"id":"cmt8na2j4","name":"删除实例快照","path":"cmt8na2j4","filePath":"API参考/快照相关接口/删除实例快照.md","seo":null,"parentIds":["djwvynrdc","Fjwvyo70a"],"parents":[{"id":"djwvynrdc","documentId":null,"name":"API参考","repoName":"BCC","filePath":"API参考","disabled":false,"path":"djwvynrdc","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":null,"solutionTag":null,"solutionColor":null},{"id":"Fjwvyo70a","documentId":null,"name":"快照相关接口","repoName":"BCC","filePath":"API参考/快照相关接口","disabled":false,"path":"Fjwvyo70a","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":null,"solutionTag":null,"solutionColor":null}]},"next":{"id":"Sjwvynywx","name":"自动快照策略相关接口","path":"Sjwvynywx","filePath":"API参考/自动快照策略相关接口/创建自动快照策略.md","seo":null,"parentIds":["djwvynrdc","7jwvyny76"],"parents":[{"id":"djwvynrdc","documentId":null,"name":"API参考","repoName":"BCC","filePath":"API参考","disabled":false,"path":"djwvynrdc","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":null,"solutionTag":null,"solutionColor":null},{"id":"7jwvyny76","documentId":null,"name":"自动快照策略相关接口","repoName":"BCC","filePath":"API参考/自动快照策略相关接口","disabled":false,"path":"7jwvyny76","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":null,"solutionTag":null,"solutionColor":null}]},"parents":[{"id":"djwvynrdc","documentId":null,"name":"API参考","repoName":"BCC","filePath":"API参考","disabled":false,"path":"djwvynrdc","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":null,"solutionTag":null,"solutionColor":null},{"id":"Fjwvyo70a","documentId":null,"name":"快照相关接口","repoName":"BCC","filePath":"API参考/快照相关接口","disabled":false,"path":"Fjwvyo70a","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":null,"solutionTag":null,"solutionColor":null}],"specificSeo":null}}}