阿里云-对象存储服务OSS图片服务手册.pdf

对象存储 OSS 图片服务手册 对象存储 OSS/图片服务手册 图片服务手册 图片服务介绍 阿里云OSS图片处理服务（Image Service，简称 IMG） ，是阿里云OSS对外提供的海量，安全，低成本高可 靠的图片处理服务。用户将原始图片上传保存在OSS上，通过简单的 RESTful 接口，在任何时间、任何地点、 任何互联网设备上对图片进行处理。图片处理服务提供图片处理接口，图片上传请使用OSS上传接口。基于 IMG，用户可以搭建出跟图片相关的服务。 图片服务基础功能 图片服务提供以下功能： - 获取图片信息 - 图片格式转换 - 图片缩放、裁剪、旋转 - 图片添加图片、文字、图文混合水印 - 自定义图片处理样式 - 通过管道顺序调用多种图片处理功能 图片服务(IMG)与对象存储(OSS)的关系 - IMG不上传图片，IMG处理的图片是OSS用户上传到Bucket里的Object。也就是说用户可以通过 OSS和IMG都可以访问同一张图片。 - IMG只处理来自于OSS的图片。 - IMG和OSS有同样的区域，不同的访问域名。 注意 - Bucket和Object见OSS 基本概念 - IMG的图片上传请参考图片上传 - IMG的访问域名请参考图片访问域名 - OSS的访问域名请参考OSS访问域名 1 对象存储 OSS/图片服务手册 图片服务基本概念 Object（对象、文件） 在IMG中，用户操作图片的基本数据单元是Object。即OSS对应的Object， 单个 Object（即每张图片）允许 的最大大小是20MB。 Object 命名规范： 1. 使用 UTF-8 编码。 2. 长度必须在 1-1023 字节之间。 3. 不能以"/"或者"\"字符开头。 Channel （频道） Channel 是 IMG上的命名空间，也是计费、权限控制、日志记录等高级功能的管理实体。IMG名称在整个图片 处理服务中具有全局唯一性，且不能修改。一个用户最多可创建 10 个 Channel，但每个Channel中存放的 object的数量没有限制，存储容量每个Channel最高支持2PB。目前Channel跟OSS的Bucket相对应，即用户 只能创建与自己在OSS上Bucket同名的Channel。 Channel 命名规范： 1. 只能包括小写字母，数字，短横线(-)。 2. 必须以小写字母或者数字开头和结尾。 3. 长度必须在 3-63 字节之间。 Style（样式） 图片处理服务提供用户将图片的处理操作和参数保存成一个别名，即样式。一系列操作，利用样式功能后，只 需要用一个很短的URL就能实现相同的效果。 - 一个Channel下面有多个样式，目前一个Channel允许最多有50个样式。 - 样式适应于Channel 下面的object图像变化操作。假如在A Channel下面有样式，名称为abc， 样式 内容是100w.jpg（按宽缩略成100，保存成jpg格式）那么A Channel下面所有的object都能使用样式 abc，实现缩略成 100w.jpg的效果。 - 样式的作用范围只在一个Channel下，即A Channel不能使用B Channel 的样式。 Style 命名规范： 1. 长度为1-63个字符。