调用MaskOssImage接口来对存储对象中的图片进行脱敏。
接口说明
前置条件
需要购买图片脱敏额度才可以使用接口，每调用一次接口，会扣减一次对应的脱敏额度。
QPS 限制
本接口的单用户 QPS 限制为 10 次/秒。超过限制，API 调用将会被限流，这可能影响您的业务，请合理调用。
使用说明
脱敏完成后，图片会存储到图片所属 Bucket 下的 aliyun_dsc_desensitization 文件夹中。
例如，Bucket 中的图片 exampledir/test.png，脱敏后会存储为 aliyun_dsc_desensitization/exampledir/test.png。
详情可见 https://help.aliyun.com/zh/dsc/data-security-center/user-guide/picture-desensitization
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求语法
POST HTTP/1.1请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| BucketName |
string |
是 |
OSS Bucket 名称。 |
sddp-api-demo-bucket |
| ObjectKey |
string |
是 |
文件在 OSS 上存储的完整文件名。 |
dir1/test.png |
| ServiceRegionId |
string |
是 |
Bucket 所在的地域。 |
cn-hangzhou |
| MaskRuleIdList |
string |
是 |
脱敏规则 ID 列表，用,分隔符进行连接。 规则 ID 映射关系如下 3000 包含身份证信息的图片（中国内地） 3009 包含车牌信息的图片（中国内地） 3002 包含人脸信息的图片 1002 姓名（简体中文） 1003 地址（中国内地） 4003 统一社会信用代码 |
3000,3002 |
| IsSupportRestore |
boolean |
否 |
图片是否支持复原。 |
true |
| IsAlwaysUpload |
boolean |
否 |
是否总是上传处理后的图片。 若为 fasle，只有在命中脱敏规则后才上传。 若为 true，则总会上传处理后的图片。 |
true |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
Schema of Response |
||
| RequestId |
string |
请求 ID |
136082B3-B21F-5E9D-B68E-991FFD205D24 |
示例
正常返回示例
JSON格式
{
"RequestId": "136082B3-B21F-5E9D-B68E-991FFD205D24"
}错误码
|
HTTP status code |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 400 | IdempotentParameterMismatch | The request uses the same client token as a previous, but non-identical request. Do not reuse a client token with different requests, unless the requests are identical. |
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。