Get object download information

POST 
/v1/storages/get-objects-download-info

Batch obtain object download URLs.

This API is subject to cloud storage bucket permission configuration and identity authentication and authorization. Ensure the requesting identity has the necessary permissions for the corresponding resources.

For cloud storage permission configuration, see Cloud Storage Basic Permissions and Cloud Storage Security Rules.

💡 Tip: If cloud storage operations are blocked by basic permissions or security rules, you may encounter the error code: STORAGE_EXCEED_AUTHORITY

💡 Tip: If cloud storage operations are blocked by the identity authentication mechanism, you may encounter the error code: ACTION_FORBIDDEN

Request

application/json

Body

arrayrequired

Download object request parameters, array format

• Array [
cloudObjectId Cloud object ID (string)
• ]

Responses

200

Returned when the call is successful

Response Headers

• X-Request-Id string

  Request ID

application/json

Schema

Schema

• Array [
oneOf
v1GetObjectDownloadInfoResponseItemSuccess
cloudObjectId Cloud object ID (string)
downloadUrl Download URL after object upload (not URL-encoded) (string)
downloadUrlEncoded Download URL after object upload (URL-encoded) (string)
v1GetObjectDownloadInfoResponseItemError
code Error code returned when the request for this object fails (string)
message Error message returned when the request for this object fails (string)
• ]

Example (from schema)

[
  {
    "cloudObjectId": "cloud://your-envId.bucket/file.jpg",
    "downloadUrl": "https://url/file.jpg",
    "downloadUrlEncoded": "https://url/file.jpg"
  },
  {
    "code": "INVALID_PARAM",
    "message": "Invalid request param."
  }
]

default

General error information, see https://docs.cloudbase.net/error-code/service for details

Response Headers

• X-Request-Id string

  Request ID

application/json

Schema

Schema

code Error code (string)
message Error message (string)
requestId Request ID (string)

Example (from schema)

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

InvalidHost

Invalid request address

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

Loading...