CreateBatchUploadUrl - 批量获取文件上传参数

批量获取文件上传参数。

调试

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

授权信息

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

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用前面加 * 表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
yundun-sas:CreateBatchUploadURLnone
*全部资源
*

请求参数

名称类型必填描述示例值
Md5Listarray

文件 MD5 列表。

string

文件 MD5。

a479262288e03f6a90dc282ea3******
Typeinteger

文件类型。取值:

  • 0:未知文件类型
0

返回参数

名称类型描述示例值
object

Schema of Response

RequestIdstring

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

DA62490B-7883-5EB4-8601-F2D1D9******
UploadUrlListarray<object>

文件上传参数。

UploadUrListobject

文件上传参数。

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
Md5string

文件 MD5。

2f8dc248a0fbb96c69e45acad2******

示例

正常返回示例

JSON格式

{
  "RequestId": "DA62490B-7883-5EB4-8601-F2D1D9******",
  "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": false,
      "Md5": "2f8dc248a0fbb96c69e45acad2******"
    }
  ]
}

错误码

HTTP status code错误码错误信息描述
403NoPermissioncaller has no permission当前操作未被授权,请联系主账号在RAM控制台进行授权后再执行操作。
500ServerErrorServerError服务故障,请稍后重试!

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