API 类问题

最后更新时间:2021-07-07 11:03:40

    COS API 是否支持 S3 协议?

    COS 提供了 AWS S3 兼容的 API,详情请参见 使用 AWS S3 SDK 访问 COS

    调用 API 接口时,出现“Request has expired”等错误信息,该如何处理?

    出现该提示,存在两种可能:

    • 一是因为您发起请求的时间超过了签名的有效时间。
    • 二是您本地系统时间和所在时区的时间不一致。

    针对第一种可能,建议重新获取有效的请求签名再进行 API 操作。若是第二种可能,请将您的本地系统时间按照所在时区的时间进行校正。

    如何调用 API 删除掉未完成上传文件?

    首先调用接口 ListMultipartUploads 列出未完成上传文件,然后调用 Abort Multipart upload 接口舍弃一个分块上传并删除已上传的块。

    调用批量删除接口返回正确,但实际文件删除失败怎么办?

    请检查删除的文件路径,文件路径不需要以/开头。

    COS 中分块上传 UploadPart 请求时返回 NoSuchUpload?

    当传入 uploadIdpartNumber 都相同的时候,后传入的块将覆盖之前传入的块。当 uploadId 不存在时会返回“404错误,NoSuchUpload”,详情请参见 Upload Part 文档。

    如何通过 API 修改对象的存储类型?

    用户可通过调用 PUT Object - Copy 接口,修改 x-cos-storage-class 参数实现修改对象的存储类型,详情请参见 PUT Object - Copy

    对象存储怎么设置签名永久有效?

    对象存储的签名是使用时间戳来判断请求是否过期,并不能设置永久有效。假设用户使用永久密钥生成签名,希望签名达到长期有效的目的,可以设置一个较为长久的时间戳,例如过期时间为当前时间+50年。若用户使用临时密钥生成签名,由于临时密钥的有效期最多为2小时,那么生成的签名,其有效期也在2小时内。

    对象存储 COS 支持 API 查询账单吗?

    COS 不提供查询账单的 API,请您通过控制台 账单详情 查看。如需通过 API 查询账单明细数据,请参见 查询账单明细数据 计费文档。

    是否支持使用 API 查询存储对象的大小?

    可以通过 GET Bucket(List Objects) 接口查询对象的大小。

    如何通过 API 修改对象名称?

    使用 PUT Object - Copy 复制对象并指定对象名称实现重命名。

    如何通过 API 获取存储桶域名?

    通过 HEAD Bucket 接口获取存储桶域名。响应头中 “x-cos-bucket-region”参数值即表示存储桶所在地域。

    如何通过 API 获取存储桶大小?

    COS 没有直接获取存储桶大小的 API,建议您通过 云监控接口 获取存储桶中各存储类型的存储量后累加计算存储桶的存储量。

    如何通过 API 查询用量明细?

    可参见以下方式:

    1. 直接使用 API 请求工具 进行查询。

    COS 是否有目录操作的 API 接口?

    对象存储中本身是没有文件夹和目录的概念的,控制台所展示的文件夹其实是以 / 结尾的空对象。

    如何通过 API 创建目录/文件夹?

    通过调用 PUT Object 接口实现,上传文件名以 “/” 结尾的空文件即可生成目录的形式。

    说明:

    对象存储中本身是没有文件夹和目录的概念的,为了满足用户使用习惯,对象存储在控制台、COS browser 等图形化工具中模拟了「文件夹」或「目录」的展示方式。具体实现是通过创建一个文件名以“/”结尾,内容为空的对象,展示方式上模拟了传统文件夹。

    如何使用 API 删除目录/文件夹?

    COS API 仅支持删除单个文件,如需删除整个目录,需要使用 GET Bucket(List Objects) 接口获取指定前缀(prefix 参数)的所有文件后,再使用 DELETE Object 进行删除。

    COS 智能分层存储如何区分 Object 所处存储层?

    通过 查询对象元数据 接口返回的 x-cos-storage-tier 获取对象所处的存储层。

    COS 如何使用 API 搜索对象?

    可以使用 HEAD Object 接口 判断该对象是否存在。如果您需要搜索某个对象,可通过 Get Bucket 接口 获取存储桶内所有对象后进行判断。

    COS 使用 GET Object 接口时,动态指定返回的内容是否以附件下载?

    使用 GET Object 接口时,在 url 上携带 response-content-disposition 参数,需要下载附件时指定值为 attachment 即可。此类型的 GET Object 请求必须要携带签名,您可以使用COS 签名工具生成签名。

    调用 COS 的 putObjectCopy 时提示 NoSuchKey,该如何处理?

    请检查源文件是否存在,若源文件存在一般是因为文件夹后面没添加“/”导致的报错,请添加“/”后再尝试操作。

    是否支持通过 API 获取某个 object 的 request 次数?

    COS 没有 API 支持获取某个 Object 的 request 次数。您可以通过分析日志来进行操作,请您这边先 开启日志管理功能,之后可以通过分析日志来进行获取。