首页 云安全中心 API参考指南 API目录 文件检测 CreateFileDetectUploadUrl - 获取文件上传参数

CreateFileDetectUploadUrl - 获取文件上传参数

获取文件上传参数。

接口说明

通过此接口获取文件上传参数。如果返回参数中的FileExist的值为true，表示待检测文件在云端已存在，不需要再上传，可以直接推送检测。如果FileExist的值为false，需要用此接口返回的参数，通过表单上传的方式将文件上传至指定存储位置。

表单上传服务由OSS产品提供，请参考表单上传。

文件检测相关接口均包含HashKey参数，表示文件唯一标识，目前仅支持md5。请在使用前计算文件md5。

调试

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

调试

授权信息

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

  • 操作：是指具体的权限点。
  • 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
  • 资源类型：是指操作中支持授权的资源类型。具体说明如下：
    • 对于必选的资源类型，用背景高亮的方式表示。
    • 对于不支持资源级授权的操作，用全部资源表示。
  • 条件关键字：是指云产品自身定义的条件关键字。
  • 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。
操作访问级别资源类型条件关键字关联操作
yundun-sas:CreateFileDetectUploadUrlWrite
  • SecurityCenter
    acs:yundun-sas:*:{#accountId}:*
    无
无

请求参数

名称类型必填描述示例值
HashKeyListarray否

文件标识。目前仅支持MD5。

说明HashKeyList 和 HashKeyContextList不能同时为空。
string否

文件标识。目前仅支持MD5。

0a212417e65c26ff133cfff28f6c****
Typeinteger是

文件类型。取值：

  • 0：不确定的文件类型
  • 1：二进制文件
  • 2：WebShell文件
  • 4：脚本文件
说明如果不确定文件类型，将该参数的值设置为0。
0
HashKeyContextListarray否

文件HASH集合。

说明HashKeyList 和 HashKeyContextList不能同时为空。
object否

文件HASH。

HashKeystring否

文件hash值。

30319dd5cee8f894766e479cac170da0
FileSizeinteger否

文件大小。单位：字节。

2698557

返回参数

名称类型描述示例值
object
RequestIdstring

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

09969D2C-4FAD-429E-BFBF-9A60DEF8BF6F
UploadUrlListarray

文件上传需要的参数集合。

object

文件上传需要的参数。

PublicUrlstring

文件上传地址的公网EndPoint。

http://example.com
InternalUrlstring

文件上传地址的内网EndPoint。

http://example.com
Expirestring

上传参数过期的时间戳，单位为毫秒。

1658562101370
Contextobject

上传签名信息。

AccessIdstring

文件存储位置的AccessKey。

LTAI4G1mgPbjvGQuiV1X****
Policystring

文件上传的限制Policy，如文件大小。

eyJleHBpcmF0aW9uIjoiMjAyMi0wNy0yM1QxMDo1ODoxMC****
Signaturestring

文件上传的签名。

wDhPgVdnY/bkKFYcYFl+4crl****
OssKeystring

文件在OSS Bucket中的存储key。

1/2022/06/23/15/41/16559701077444693a0c6-33b2-4cc2-a99f-9f38b8b8****
FileExistboolean

文件是否存在。取值：

  • true：文件已存在，不需要上传。
  • false：文件不存在，需要上传。
false
HashKeystring

文件标识。

0a212417e65c26ff133cfff28f6c****
Codestring

结果代码，200表示成功，若为别的值则表示失败，调用方可根据此字段判断失败原因。

200
Messagestring

错误码的详细信息。

successful

示例

正常返回示例

JSON格式

{
  "RequestId": "09969D2C-4FAD-429E-BFBF-9A60DEF8BF6F",
  "UploadUrlList": [
    {
      "PublicUrl": "http://example.com",
      "InternalUrl": "http://example.com",
      "Expire": "1658562101370",
      "Context": {
        "AccessId": "LTAI4G1mgPbjvGQuiV1X****",
        "Policy": "eyJleHBpcmF0aW9uIjoiMjAyMi0wNy0yM1QxMDo1ODoxMC****",
        "Signature": "wDhPgVdnY/bkKFYcYFl+4crl****",
        "OssKey": "1/2022/06/23/15/41/16559701077444693a0c6-33b2-4cc2-a99f-9f38b8b8****"
      },
      "FileExist": true,
      "HashKey": "0a212417e65c26ff133cfff28f6c****",
      "Code": "200",
      "Message": "successful"
    }
  ]
}

错误码

HTTP status code错误码错误信息描述
400RequestTooFrequentlyRequest too frequently, please try again later请求太频繁，请稍后再试
400InvalidApiDetectTypeUnsupported Api Detect Type.不支持的文件类型。
403NoPermissioncaller has no permission当前操作未被授权，请联系主账号在RAM控制台进行授权后再执行操作。
500ServerErrorServerError服务故障
500SystemBusySystem busy, please try again later.系统繁忙，请稍后重试。

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

变更历史

变更时间变更内容概要操作
2022-08-22OpenAPI 错误码发生变更，OpenAPI 入参发生变更，OpenAPI 返回结构发生变更
变更项变更内容
错误码OpenAPI 错误码发生变更
    错误码 400 变更
    删除错误码：500
入参OpenAPI 入参发生变更
    新增入参：HashKeyContextList
出参OpenAPI 返回结构发生变更
2022-08-22OpenAPI 错误码发生变更，OpenAPI 入参发生变更，OpenAPI 返回结构发生变更
变更项变更内容
错误码OpenAPI 错误码发生变更
    错误码 400 变更
    删除错误码：500
入参OpenAPI 入参发生变更
    新增入参：HashKeyContextList
出参OpenAPI 返回结构发生变更
阿里云首页 云安全中心 相关技术圈