ListObjects_边缘节点服务 ENS_API文档

插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains 插件
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

流控信息

请求速率为100/1(s)。

授权信息

如下是此API对应的授权信息,用于RAM权限策略语句的Action元素中,为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置,使用方法可参考访问控制帮助文档

具体说明如下:展开详情

操作访问级别资源类型条件关键字关联操作
ens:ListObjects
List
全部资源
*

请求参数

字段名称字段详情
BucketNamestring

Bucket 名称。

示例值:test参考取值来源:
    PutBucket
    ListBuckets
EncodingTypestring

请求响应体中文件名称采用的编码方式,目前仅支持 url。

示例值:url
Markerstring

此次列举文件的起点。设定从 Marker 之后按字母排序开始返回 Object。Marker 用来实现分页显示效果,参数的长度必须小于 1024 字节。展开详情

示例值:a
MaxKeysinteger<int64>

限定此次列举文件的最大个数。展开详情

注意 该字段类型为 Long,在序列化/反序列化的过程中可能导致精度丢失,请注意数值不得大于 9007199254740991。
示例值:100
Prefixstring

限定返回的文件必须以 prefix 作为前缀。使用 Prefix 查询时,返回的 Key 中仍会包含 Prefix。展开详情

示例值:b
ContinuationTokenstring

此次列举文件使用的 continuationToken。如果 MaxKeys 的设定无法一次完成列举,返回结果会附加 NextContinuationToken 作为下一次列举的 ContinuationToken。

示例值:test1.txt
StartAfterstring

此次列举文件的起点。设定从 StartAfter 之后按字母排序开始返回 Object。StartAfter 用来实现分页显示效果,参数的长度必须小于 1000 字节。展开详情

示例值:b

返回参数

字段名称字段详情
CommonPrefixesarray<string>

如果请求中指定了 Delimiter 参数,则会在返回的响应中包含 CommonPrefixes 元素。该元素表明以 Delimiter 结尾,并有共同前缀的 Object 名称的集合。

NextContinuationTokenstring

下次列举文件的 ContinuationToken。

示例值:CgJiYw--
ContinuationTokenstring

此次列举文件操作使用 ContinuationToken。

示例值:test1.txt
Delimiterstring

对文件名称进行分组的字符。

示例值:/
EncodingTypestring

指明返回结果中编码使用的类型。

示例值:不涉及
Prefixstring

本次查询结果的前缀。

示例值:b
Markerstring

标明本次列举文件的起点。

示例值:ceshi.txt1617853707991
BucketNamestring

Bucket 名称。

示例值:test
Contentsarray<object>

Object 元信息列表。

IsTruncatedboolean

指明列举文件是否被截断。展开详情

示例值:true
KeyCountinteger<int64>

此次请求返回的 Key 的个数。

注意 请注意,该值为 Long 类型,在某些语言中可能存在精度丢失的风险,请小心使用。
示例值:10
NextMarkerstring

下一次列举文件的起点。

示例值:ceshi.txt1617853707991
MaxKeysinteger<int64>

列举文件的最大个数。

注意 请注意,该值为 Long 类型,在某些语言中可能存在精度丢失的风险,请小心使用。
示例值:10
RequestIdstring

请求 ID。

示例值:4833C4AC-9396-458C-8F25-1D701334E560

返回示例

错误码

全局错误码
HTTP 状态码错误码错误信息操作
400
Invalid%s
Specified parameter %s is not valid诊断
400
InvalidBucketName
Specified parameter BucketName is not valid.诊断
400
InvalidPrefix
Specified parameter Prefix is not valid.诊断
400
InvalidStartAfter
Specified parameter StartAfter is not valid.诊断
400
InvalidMarker
Specified parameter Marker is not valid.诊断
400
InvalidDelimiter
Specified parameter Delimiter is not valid.诊断
400
NoPermission
Permission denied.诊断
400
InvalidParameter.%s
The specified field %s invalid. Please check it again.诊断
403
AccessDenied
auth is not valid诊断
403
UserDisable
The user has been disabled due to arrears.诊断
404
NoSuchBucket
The specified bucket does not exist.诊断
500
InternalError
The request processing has failed due to some unknown error.诊断

变更历史

变更时间变更内容概要操作
2024-12-26
变更错误码403
2022-02-24
新增OpenAPI,查询Object信息

相关示例