0041-00000115
问题描述 响应头中不包含Location字段。问题原因 请求触发镜像回源时，访问源站触发3xx跳转，但是响应头中不包含Location字段。问题示例 无 解决方案 排查源站异常。相关文档 镜像回源
0003-00000906
问题描述 Bucket所有者发生变化导致操作失败。问题原因 您对某个Bucket发起某种请求，但是在该请求处理过程中Bucket所有者发生变化，导致操作终止，引起请求失败。问题示例 比如您发起了UploadObject请求上传文件，但是在文件上传的过程中...
0006-00000106
问题描述 PostObject请求表单读取超时。问题原因 您通过PostObject请求上传文件时，由于网络环境...问题示例 无 解决方案 参考网络超时处理方法排查并解决PostObject请求上传超时的问题。更多信息，请参见 网络超时处理。相关文档 PostObject
0010-00000208
问题描述 对象标签或Bucket标签的Key不能为空的。问题原因 您发起了PutObjectTagging请求设置对象标签，发起了PutBucketTags设置Bucket标签，但是请求体XML结构中 Tag/Key 节点的值为空字符串。问题示例 比如您发起了如下请求：PUT/...
0041-00000203
问题描述 请求触发镜像回源时，数据无法写入OSS。问题原因 Bucket处于被保护状态时，无法向该Bucket写入文件。问题示例 无 解决方案 确保回源文件写入的Bucket未处于保留策略的保护状态。相关文档 镜像回源 保留策略
0003-00001105
问题描述 您无法再当前Location创建Bucket。问题原因 您发起了PutBucket操作并指定了Bucket所在的Location，但是您当前没有在该Location创建Bucket的权限。问题示例 无 解决方案 如果您希望在该Location创建Bucket，请联系OSS 技术支持。
0004-00000001
问题描述 该功能处于邀测状态，尚未对所有用户开放使用。问题原因 该功能处于邀测状态，当前仅开放给部分用户邀测使用。问题示例 无 解决方案 如果您确认在该功能的邀测用户列表中，请联系 技术支持。
0018-00000004
问题描述 不支持通过API接口修改CDN缓存自动刷新相关参数。问题原因 出于安全考虑，OSS不支持通过API接口修改CDN缓存自动刷新相关参数。问题示例 无 解决方案 通过OSS管理控制台修改CDN缓存自动刷新相关参数。相关文档 绑定自定义域名
0010-00000107
问题描述 设置对象标签的请求XML结构中缺少Key节点或value节点。问题原因 您发起了PutObjectTagging请求设置对象标签，但是请求体XML结构中未指定 Tag/Key 和或 Tag/Value 节点。问题示例 比如您发起了如下请求：PUT/objectname?tagging ...
0013-00000108
问题描述 当前地域不支持您指定的存储类型。问题原因 仅部分地域支持冷归档存储、深度冷归档存储类型。问题示例 无 解决方案 确认当前地域支持冷归档存储、深度冷归档存储类型。更多信息，请参见 存储类型介绍。相关文档 PutBucket
0004-00000801
问题描述 图片处理请求并发数过高，消耗的CPU核数超出限值。问题原因 OSS图片处理请求的并发数超出限制，导致请求被拒绝。问题示例 无 解决方案 合理降低图片处理请求并发数。如您的业务有更高的需求，请联系 技术支持。
0041-00000104
问题描述 请求触发镜像回源时，无法从源站读取数据。问题原因 因源站异常导致请求触发镜像回源时，无法从源站读取数据。问题示例 无 解决方案 检查是否能正常访问镜像回源地址中的文件。排查源站异常 相关文档 镜像回源
0041-00000101
问题描述 请求触发镜像回源时，源站返回了非404、206、200状态码。问题原因 源站异常导致触发镜像回源时，源站返回了非404、206、200状态码，导致回源失败。问题示例 无 解决方案 排查源站异常。相关文档 镜像回源
0025-00000005
问题描述 OSS ON云盒环境不支持当前操作。问题原因 您发起的操作请求在OSS ON云盒环境下不支持。问题示例 无 解决方案 了解OSS ON云盒的使用限制。了解OSS ON云盒管控域名和数据域名支持的API列表。更多信息，请参见 什么是OSS ON云盒。
0010-00000210
问题描述 对象标签或Bucket标签的Key不允许重复。问题原因 您发起了PutObjectTagging请求设置对象标签，或发起了PutBucketTags请求设置Bucket标签，但是请求XML结构中出现了重复的Key，导致接口报错。问题示例 比如您发起了如下请求 PUT/...
0041-00000112
问题描述 请求触发镜像回源时，解析的自定义元数据大小超出8 KB限制。问题原因 单个Object可以配置多个自定义元数据，但所有的自定义元数据总大小不能超过...问题示例 无 解决方案 检查配置的自定义元数据大小以及请求格式。相关文档 镜像回源
0016-00000821
问题描述 SelectObject请求查询的目标Object不是UTF-8编码。问题原因 您发起了SelectObject请求，但是请求查询的目标Object不是UTF-8编码。...问题示例 无 解决方案 确保要查询的目标Object为UTF-8编码格式。相关文档 查询文件 RestoreObject
0010-00000101
问题原因 您发起了设置对象标签的请求，但是请求体结构不符合XML规范，导致接口报错。问题示例 比如您发起了如下请求：PUT/objectname?tagging Content‐Length:xxx Host:BucketName.oss-cn-hangzhou.aliyuncs.com Date: Mon,18 Mar 2019 ...
0020-00000001
问题描述 清单功能暂不可用。问题原因 您发起了PutBucketInventory，GetBucketInventory或DeleteBucketInventory等...问题示例 无 解决方案 确认发起请求所在Region支持配置清单相关功能。确认您是清单功能的邀测用户。相关文档 存储空间清单
0003-00001104
问题描述 您的账号无法创建新的Bucket。...问题示例 无 解决方案 您可以换一个可用账号进行尝试；如果您希望通过当前账号创建Bucket，请赋予该账号 oss:PutBucket 权限。更多信息，请参见 为RAM用户授权自定义的权限策略。
异常处理
使用SDK时如果请求出错，会有相应的异常抛出，同时在log（默认为程序运行目录下oss_sdk.log）中也会记录详细的出错信息。OSS Ruby SDK中有ClientError和ServerError两种异常，这两种异常均为RuntimeError的子类。ClientError ClientError指...
0041-00000102
问题描述 镜像回源每秒请求数QPS（Query Per Second）超出限制。问题原因 中国各地域默认QPS为2000、流量为2 Gbit/s；海外各地域默认QPS为1000、...问题示例 无 解决方案 如果镜像回源有更大的QPS需求，请联系 技术支持。相关文档 镜像回源
OSS文件处于冻结状态无法正常访问
问题描述 阿里云对象存储OSS中的文件在以下场景处于冷冻状态，无法正常访问。文件存储类型是归档存储、冷归档存储或者深度冷归档存储。文件存在违法违规情况。问题原因 阿里云对象存储OSS中的文件处于冻结状态有以下几种情况：在对象存储...
0037-00000005
问题示例 无 解决方案 结合响应中的ErrorCode和ErrorMessage定位请求体XML中存在的问题，并结合DoMetaQuery接口文档进行调整。通过OSS管理控制查询满足指定条件的文件，避免手动构造请求体。相关文档 数据索引（Data Indexing）DoMetaQuery
OSS下载的RAR文件存在乱码
问题描述 通过OSS下载的RAR格式文件，打开文件后存在乱码。问题原因 Object的文件类型不正确，HTTP头的 Content-Type 参数和实际文件类型参数不匹配。解决方案 修改Object属性中的HTTP表头，将设置中的 Content-Type 值改成 application/x-...
0010-00000213
问题描述 用户标签的Key不合法。问题原因 用户标签的Key包含非法字符，或者以 http:// 、https:// 、Aliyun 为前缀。问题示例 无 解决方案 标签的Key不支持以 http:// 、https:// 、Aliyun 为前缀（不区分大小写），并且标签合法字符集包括...
防盗链常见问题
本文介绍OSS防盗链的常见问题以及排查方法。配置了 防盗链，但没有生效？如果您为OSS配置了Referer防盗链，但测试防盗链没有生效，请排查您的浏览器、OSS、CDN设置。排查项目 错误原因 解决办法 浏览器 Referer字段的值被修改或设定为特定...
0017-00000142
问题示例 无 解决方案 检查S3兼容请求中的请求头，确认是否缺少 x-amz-acl。如果您希望通过S3兼容的方式访问OSS，推荐您通过SDK进行访问，减少由于手动构造请求导致的错误。相关文档 Object ACL 使用Amazon S3 SDK访问OSS
0017-00000102
问题示例 无 解决方案 检查请求中请求体的大小，或待上传文件大小是否超出接口限制。例如PutObject中，添加的Object大小不能超过5 GB。如果上传时单文件大小过大，可尝试分片上传或断点续传等。更多信息，请参见 UploadPart。相关文档 ...
0013-00000103
问题描述 当前的Bucket类型不支持 x-oss-storage-class 指定的存储类型。问题原因 您发起了CopyObject等请求，并在请求...问题示例 无 解决方案 请检查指定的Object存储类型，确保当前Bucket支持该存储类型。相关文档 存储类型介绍 PutBucket
文件存储NAS
阿里云文件存储NAS（Apsara File Storage）是面向阿里云ECS实例、E-HPC和容器服务等计算节点的文件存储服务。它是一种可共享访问、弹性扩展、高可靠以及高性能的分布式文件系统，支持NFS和SMB协议。文件存储NAS 目前提供极速型、通用性能型...
性能优化指导原则
为了使您的应用程序在OSS上获得最佳性能，建议您遵循以下指导原则。测量性能指标 根据CPU、网络吞吐量的要求来评估不同的ECS实例规格。有关实例规格的更多信息，请参见 ECS实例规格。此外，建议您在测量性能时使用HTTP分析工具查看DNS查询...
概述
阿里云提供针对各种存储资源（块、文件和对象）的低成本、高可靠、高可用的存储服务，涵盖数据备份、归档、容灾等场景。本文介绍阿里云各类存储服务及特性的适用场景、性能、安全、接口和费用模型等，帮助您选择最适合您业务场景和需求的云...
推荐的性能设计模式
在设计从OSS上传和下载数据的应用程序时，请使用我们推荐的性能设计模式，使应用程序达到最佳性能。我们还提供性能优化指导原则，供您在规划应用程序架构时参考。对频繁访问的内容使用缓存 如果您的应用程序需要支持同一地区大量用户同时...
OSS中的透明图片添加水印不生效
问题描述 为存储在阿里云对象存储OSS中的图片文件增加水印时，水印不生效。问题原因 图片水印不支持原图有 透明图 层。添加水印时是以原图颜色为背景色，将水印图片融合进入RGB通道，Alpha通道保留原值。Alpha通道只有两个值（全透明或者不...
0048-00000106
问题描述 使用浏览器通过OSS传输加速域名访问文件时，可能会出现无法预览而是直接下载的现象。问题原因 在2020/11/17 11:07之后开通传输加速的Bucket，使用 OSS传输加速域名 访问任意文件，OSS会在返回头中增加两个Header：x-oss-force-...
0048-00000112
问题描述 使用浏览器通过OSS传输加速域名访问文件时，可能会出现无法预览而是直接下载的现象。问题原因 在2023/02/01 00:00之后开通传输加速的Bucket，使用 OSS传输加速域名 访问任意文件，OSS会在返回头中增加两个Header：x-oss-force-...
0048-00000110
问题描述 使用浏览器通过OSS传输加速域名访问文件时，可能会出现无法预览而是直接下载的现象。问题原因 在2021/01/14 12:00之后开通传输加速的Bucket，使用 OSS传输加速域名 访问任意文件，OSS会在返回头中增加两个Header：x-oss-force-...
0048-00000111
问题描述 使用浏览器通过OSS传输加速域名访问文件时，可能会出现无法预览而是直接下载的现象。问题原因 在2021/01/16 00:00之后开通传输加速的Bucket，使用 OSS传输加速域名 访问任意文件，OSS会在返回头中增加两个Header：x-oss-force-...
0048-00000108
问题描述 使用浏览器通过OSS传输加速域名访问文件时，可能会出现无法预览而是直接下载的现象。问题原因 在2021/01/07 18:00之后开通传输加速的Bucket，使用 OSS传输加速域名 访问任意文件，OSS会在返回头中增加两个Header：x-oss-force-...
- 产品推荐
- 这些文档可能帮助您