获取对象上传信息

POST 
https://your-envId.api.tcloudbasegateway.com/v1/storages/get-objects-upload-info

批量获取上传对象所需信息。

Request

application/json

Body

arrayrequired

上传对象请求参数，数组格式

• Array [
objectId 对象 ID，例如文件名称 (string)required
signedHeader object
property name* string[]
Array [
string
]
• ]

Responses

200

调用成功时返回

Response Headers

• X-Request-Id string

  请求ID

application/json

Schema

Schema

• Array [
oneOf
v1GetObjectsUploadInfoResponseItemSuccess
uploadUrl uri
downloadUrl uri
downloadUrlEncoded uri
token 上传时所需要的 token，填充 X-Cos-Security-Token 请求头 (string)
authorization 上传时所需要的 authorization 认证信息，填充 Authorization 请求头 (string)
cloudObjectMeta 上传时所需要的 metadata 信息，填充 X-Cos-Meta-Fileid 请求头 (string)
cloudObjectId 对象上传后的云端对象 ID (string)
objectId 本次请求的对象 ID (string)
v1GetObjectsUploadInfoResponseItemError
code 对该对象的请求出错时返回的错误码 (string)
message 对该对象的请求出错时返回的错误信息 (string)
• ]

Example (from schema)

[
  {
    "uploadUrl": "https://url/file.jpg%3FExpires%3D123",
    "downloadUrl": "https://url/file.jpg?Expires=123",
    "downloadUrlEncoded": "https://url/file.jpg%3FExpires%3D123",
    "token": "token",
    "authorization": "q-sign-algorithm=sha1&q-ak=",
    "cloudObjectMeta": "metadata",
    "cloudObjectId": "cloud://your-envId.bucket/file.jpg?Expires=123",
    "objectId": "file.jpg"
  },
  {
    "code": "COS_ACTION_FAILED",
    "message": "Execute COS action failed."
  }
]

default

通用报错信息，详见 https://docs.cloudbase.net/error-code/service

Response Headers

• X-Request-Id string

  请求ID

application/json

Schema

Schema

code 错误码 (string)
message 错误信息 (string)
requestId 请求 ID (string)

Example (from schema)

{
  "code": "string",
  "message": "string",
  "requestId": "string"
}

InvalidHost

请求地址异常

{
  "code": "INVALID_HOST",
  "message": "xxx",
  "requestId": "xxx"
}

Authorization: http

name: JWTAuthtype: httpscheme: bearerdescription: 环境 ID 所对应的 token，使用登录鉴权(v2)获取

• curl
• python
• go
• nodejs
• ruby
• csharp
• php
• java
• powershell

• CURL

curl -L 'https://your-envId.api.tcloudbasegateway.com/v1/storages/get-objects-upload-info' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>' \
-d '[
  {
    "objectId": "file.jpg",
    "signedHeader": [
      "here-goes-md5"
    ]
  },
  {
    "object": "already-exsited-object"
  }
]'

Request Collapse all

Base URL

https://your-envId.api.tcloudbasegateway.com

Auth

Security Scheme

JWTAuthAPIKey

Bearer Token

Body required

[
  {
    "objectId": "file.jpg",
    "signedHeader": [
      "here-goes-md5"
    ]
  },
  {
    "object": "already-exsited-object"
  }
]

ResponseClear

Click the Send API Request button above and see the response here!