恶意文件检测功能下，创建对OSS内恶意文件检测的策略配置。
接口说明
建议您在使用本接口前，先使用 PublicPreCheckImageScanTask 接口查询容器镜像安全扫描覆盖的镜像数和消耗的授权数，确保镜像安全扫描所需的授权数足够，避免因授权数不够导致镜像安全扫描任务中断。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| Enable |
integer |
否 |
是否启用。取值：
|
1 |
| ScanDayList |
array |
否 |
扫描时间，数字表示一周中的第几天。 |
|
|
integer |
否 |
扫描时间，数字表示一周中的第几天。 |
1 |
|
| BucketNameList |
array |
否 |
Bucket 名称列表。 |
|
|
string |
否 |
Bucket 名称。 |
cccarvato-oss**** |
|
| KeySuffixList |
array |
否 |
检测的文件后缀列表。 |
|
|
string |
否 |
限定检测文件的 Key 必须以指定的后缀结尾。 |
.asp |
|
| StartTime |
string |
否 |
检测开始时间，格式为 HH:mm:ss。 |
00:00:00 |
| EndTime |
string |
否 |
检测停止时间，格式为 HH:mm:ss。 |
01:01:00 |
| Name |
string |
否 |
策略名称。 |
testName |
| KeyPrefixList |
array |
否 |
文件前缀列表。 |
|
|
string |
否 |
限定检测文件的 Key 必须以指定的 KeyPrefix 作为前缀，不能以正斜线（/）开头。 |
/root |
|
| AllKeyPrefix |
boolean |
否 |
是否匹配所有前缀。此参数设置为 true 时，参数 KeyPrefixList 不生效。 |
true |
| DecompressMaxLayer |
integer |
否 |
存在多个层级的压缩包嵌套时的最大解压层数，最小取值为 1，最大取值为 5。超过最大解压层数时，解压操作将直接结束，已解压出文件的检测不受影响。 |
1 |
| DecompressMaxFileCount |
integer |
否 |
最大解压文件数。最小取值为 1，最大取值为 1000。超过最大解压文件数时，解压操作将直接结束，已解压出文件的检测不受影响。 |
100 |
| DecryptionList |
array |
否 |
解密类型列表。 |
|
|
string |
否 |
解密类型。取值：
|
KMS |
|
| LastModifiedStartTime |
integer |
否 |
检测最后一次修改时间在指定时间戳之后的文件，单位毫秒。 |
1724301769834 |
| RealTimeIncr |
boolean |
否 |
是否开启实时增量检测。此参数设置为 true 时，参数 ScanDayList、StartTime、EndTime 不生效。 |
true |
| AutoAdd |
integer |
否 |
OssBucket 是否默认加入此策略
|
0 |
| ClientToken |
string |
否 |
用于保证请求的幂等性。由客户端生成该参数值，要保证在不同请求间唯一，最大值不超过 64 个 ASCII 字符，且该参数值中不能包含非 ASCII 字符。 |
123e4567-e89b-12d3-a456-426655440000 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
|||
| RequestId |
string |
本次调用请求的 ID，是由阿里云为该请求生成的唯一标识符，可用于排查和定位问题。 |
5DFD6277-CC36-57F7-ACE6-F5952123**** |
| Id |
integer |
策略 ID。 |
210**** |
示例
正常返回示例
JSON格式
{
"RequestId": "5DFD6277-CC36-57F7-ACE6-F5952123****",
"Id": 0
}错误码
|
HTTP status code |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 400 | IDEMPOTENT_PARAMETER_MISMATCH | The same ClientToken was used with different request parameters. | 相同的 ClientToken 被用于不同的请求参数。 |
| 500 | ServerError | ServerError | |
| 403 | NoPermission | caller has no permission | |
| 409 | IDEMPOTENT_REQUEST_IN_PROGRESS | A request with the same ClientToken is still being processed. | 使用相同 ClientToken 的请求正在处理中。 |
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。