查询极智压缩状态

最近更新时间:2024-04-09 15:54:32

我的收藏

功能描述

该接口用于查询图片极智压缩功能的状态。

授权说明

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

服务开通

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

使用限制

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

请求

请求示例

GET /?image-slim HTTP/1.1
Host: <BucketName-APPID>.pic.<Region>.myqcloud.com
Date: GMT Date
Authorization: Auth String
说明:
Authorization: Auth String,详情请参见 请求签名 文档。

请求头

该请求操作仅使用了公共请求头,了解公共请求头详情,请参阅 公共请求头部 章节。

请求体

该请求的请求体为空。

响应

响应头

该响应仅使用公共响应头,了解公共响应头详情,请参阅 公共响应头部 章节。

响应体

<?xml version="1.0" encoding="UTF-8" ?>
<ImageSlim>
<Status>off</Status>
<SlimMode>API</SimMode>
<Suffixs>
<Suffix>jpg</Suffix>
<Suffix>png</Suffix>
</Suffixs>
</ImageSlim>

参数说明

节点名称(关键字)
父节点
描述
Status
ImageSlim
极智压缩的状态,包含值:
on:极智压缩已开启。
off:极智压缩已关闭。
SlimMode
ImageSlim
极智压缩的使用模式。包含两种:
API:开通极智压缩的 API 使用方式,开通后可在图片下载时通过极智压缩参数对图片进行压缩。
Auto:开通极智压缩的自动使用方式,开通后无需携带任何参数,存储桶内指定格式的图片将在访问时自动进行极智压缩。
Suffixs
ImageSlim
当 SlimMode 的值包含 Auto 时返回,表示需要自动进行压缩的图片格式。
Suffix
Suffixs
标识自动进行压缩的图片格式,包含值:jpg、png、gif。
该接口支持 json 格式返回,当请求 header 指定 accept= application/json,响应体如下:
{
"ImageSlim":{
"Status":"on",
"SlimMode":"Auto",
"Suffixs":[
{
"Suffix":"jpg"
},
{
"Suffix":"png"
}
]
}
}