查询oss用户桶下文件列表

GET

/v4/oss/list-objects

开发未对齐原因：v1版本只实现了/v4/oss/list-objects接口对应了公有云的/v4/oss/list-object-versions接口功能，
v2版本和公有云对齐开发两个接口，该接口取消deleteMarkers字段接口和contents中isLatest、versionID字段，需要此信息请使用/v4/oss/list-object-versions接口

请求参数

Authorization

在 header 添加参数

userID

示例：

userID: ********************

Query 参数

Header 参数

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET 'http://ct-global.ctapi-internal.ctyun.local:31111/v4/oss/list-objects?regionID=nm8&bucket=bucket1&prefix=test&marker=test&maxKeys=10&delimiter=/' \
--header 'x-ctyun-user-id: {{userID}}' \
--header 'Accept-Language: zh-CN' \
--header 'userId: ef378f73-1c52-435e-90f2-6a9cd2258c8e' \
--header 'userID: <api-key>'

返回响应

🟢200successful operation

application/json

Body

示例

{
	"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
}

修改于 2025-08-07 08:23:01

设置存储空间的访问权限（ACL）

查询oss用户桶下对象版本信息