开通原图保护

最近更新时间:2024-07-09 18:06:51

我的收藏

功能描述

原图保护是一种原始图片保护服务,能够阻止恶意用户对原始图片的请求,该功能需要与 数据万象的样式 功能配合使用。开启原图保护功能后,对应存储桶中的图片无法直接访问,仅能以带样式的 URL 进行访问。
该功能适用于原图资源防盗业务防刷等场景。例如您可以将水印参数保存为样式,然后开启原图保护,则相应存储桶内的图片仅能通过添加了水印样式的 URL 进行访问。
该接口用于开启某个存储桶的原图保护功能。

授权说明

通过子账号使用时,需要授予ci:SetOriginProtect 权限,详情请参见 数据万象 action

服务开通

使用该功能需提前开通数据万象,并绑定存储桶。详情请参见 绑定存储桶

使用限制

使用该接口时,请先确认相关限制条件。详情请参见 使用限制

请求

请求示例

PUT /?origin-protect HTTP/1.1
Host: <BucketName-APPID>.pic.<Region>.myqcloud.com
Date: GMT Date
Authorization: Auth String
说明:
Authorization: Auth String,详情请参见 请求签名 文档。
通过子账号使用时,需要授予相关的权限,详情请参见 授权粒度详情 文档。

请求头

此接口仅使用公共请求头部,详情请参见 公共请求头部 文档。

请求体

该请求操作的实现需要有以下请求体。
<Suffixs>
<Suffix>jpg</Suffix>
<Suffix>png</Suffix>
<Suffix>webp</Suffix>
</Suffixs>
参数说明:
节点名称
描述
类型
是否必选
Suffixs
原图保护根据图片后缀生效,该节点包含图片后缀的集合。
Container
Suffix
需要生效原图保护的图片后缀,如需生效多个后缀需填写多次,有效值:jpg、jpeg、png、webp、bmp、gif、heif、heic、avif。
String

响应

响应头

此接口仅返回公共响应头部,详情请参见 公共响应头部 文档。

响应体

该响应的响应体为空。