查询oss用户桶下文件列表

请求参数

Query 参数

regionID

string

资源池id

必需

bucket

string

bucket名称

必需

prefix

string

文件前缀检索

可选

marker

string

起始对象键标记

可选

maxKeys

integer

可选

单次 ListObject 请求返回最大的条目数量

delimiter

string

可选

定界符是您用来对键进行分组的字符

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

返回响应

🟢200successful operation

application/json

Body

description

string

描述

可选

errorCode

string

错误码

可选

message

string

错误说明

可选

returnObj

object

响应对象

可选

marker

string

起始对象键标记

可选

versionIdMarker

string

多版本对象键标记

可选

name

string

桶名称

可选

isTruncated

boolean

可选

是否返回了所有查询结果

delimiter

string

可选

定界符是您用来对键进行分组的字符

nextMarker

string

下一对象键标记

可选

nextVersionIdMarker

string

多版本下一对象标识

可选

maxKeys

integer <int32>

最大的条目数量

可选

prefix

string

文件前缀

可选

encodingType

string

可选

对响应中的对象键进行编码并指定要使用的编码方法

commonPrefixes

array [object {1}]

可选

在计算返回数时，所有键（最多 1,000 个）汇总在一个公共前缀中计为单个返回。仅当指定分隔符时，响应才能包含 commonPrefixes

contents

array [object {8}]

对象信息

可选

deleteMarkers

array [object {5}]

可选

标识删除对象，实际没有删除

statusCode

integer <int32>

请求状态码

可选

示例

{
    "description": "成功",
    "errorCode": "SUCCESS",
    "message": "success",
    "returnObj": {
        "contents": [
            {
                "ETag": "\"\"",
                "isLatest": true,
                "key": "ces.txt",
                "lastModified": "2023-04-06T06:38:28.497000Z",
                "owner": {
                    "ID": "",
                    "displayName": ""
                },
                "size": 3433,
                "storageClass": "STANDARD",
                "versionID": "null"
            }
        ],
        "encodingType": "url",
        "isTruncated": false,
        "marker": "",
        "name": "ztces-230404-create",
        "prefix": "",
        "versionIdMarker": ""
    },
    "statusCode": 800
}