全部产品
Search

搜索本产品

    云安全中心：CreateOssScanConfig - 创建检测策略配置

    文档中心

    云安全中心：CreateOssScanConfig - 创建检测策略配置

    更新时间：Sep 16, 2026

    恶意文件检测功能下，创建对OSS内恶意文件检测的策略配置。

    接口说明

    建议您在使用本接口前，先使用 PublicPreCheckImageScanTask 接口查询容器镜像安全扫描覆盖的镜像数和消耗的授权数，确保镜像安全扫描所需的授权数足够，避免因授权数不够导致镜像安全扫描任务中断。

    调试

    您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

    调试

    授权信息

    下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

    • 操作：是指具体的权限点。

    • 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。

    • 资源类型：是指操作中支持授权的资源类型。具体说明如下：

      • 对于必选的资源类型，用前面加 * 表示。

      • 对于不支持资源级授权的操作，用全部资源表示。

    • 条件关键字：是指云产品自身定义的条件关键字。

    • 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

    操作

    访问级别

    资源类型

    条件关键字

    关联操作

    yundun-sas:CreateOssScanConfig

    create

    *OssScanConfig

    acs:yundun-sas:*:{#accountId}:ossscanconfig/*

    		 无 无

    请求参数

    名称

    类型

    必填

    描述

    示例值
    Enable

    integer

    否

    是否启用。取值：

    • 1：开启

    • 0：关闭

    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

    否

    解密类型。取值：

    • OSS：OSS 完全托管。

    • KMS：KMS。

    KMS
    LastModifiedStartTime

    integer

    否

    检测最后一次修改时间在指定时间戳之后的文件，单位毫秒。

    1724301769834
    RealTimeIncr

    boolean

    否

    是否开启实时增量检测。此参数设置为 true 时，参数 ScanDayList、StartTime、EndTime 不生效。

    true
    Source

    string

    否

    业务来源。取值：

    • OSS：OSS

    • NAS：NAS

    OSS
    AutoAdd

    integer

    否

    OssBucket 是否默认加入此策略

    • true：开启

    • false：不开启

    0
    ClientToken

    string

    否

    用于保证请求的幂等性。由客户端生成该参数值，要保证在不同请求间唯一，最大值不超过 64 个 ASCII 字符，且该参数值中不能包含非 ASCII 字符。

    123e4567-e89b-12d3-a456-426655440000
    DryRun

    boolean

    否

    是否只预检此次请求。true：仅检查请求，不执行实际操作；false：正常执行请求。默认值为 false。

    返回参数

    名称

    类型

    描述

    示例值

    object

    Id

    integer

    策略 ID。

    210****
    RequestId

    string

    本次调用请求的 ID，是由阿里云为该请求生成的唯一标识符，可用于排查和定位问题。

    5DFD6277-CC36-57F7-ACE6-F5952123****

    示例

    正常返回示例

    JSON格式

    {
  "Id": 0,
  "RequestId": "5DFD6277-CC36-57F7-ACE6-F5952123****"
}

    错误码

    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 当前操作未被授权，请联系主账号在RAM控制台进行授权后再执行操作。
    409 IDEMPOTENT_REQUEST_IN_PROGRESS A request with the same ClientToken is still being processed. 使用相同 ClientToken 的请求正在处理中。

    访问错误中心查看更多错误码。

    变更历史

    更多信息，参考变更详情。