GetURLsByStoreURIs - 获取封面图地址--视频点播-火山引擎

文档中心

立即注册

导航

视频点播

GetURLsByStoreURIs - 获取封面图地址

最近更新时间：2025.10.24 19:49:14首次发布时间：2025.10.24 19:49:14

调用 GetURLsByStoreURIs 接口根据图片的 StoreURI 批量获取其对应的公网访问 URL。

请求说明

请求方式：GET
请求地址：https://vod.volcengineapi.com?Action=GetURLsByStoreURIs&Version=2018-01-01

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共请求参数。

Query

参数	类型	是否必选	示例值	描述
Action	String	是	`GetURLsByStoreURIs`	接口名称。当前 API 的名称为 `GetURLsByStoreURIs`。
Version	String	是	`2018-01-01`	接口版本。当前 API 的版本为 `2018-01-01`。
Space	String	是	`yhss`	资源所在的点播空间名称。
StoreType	String	是	`Image`	存储类型。当前仅支持 `Image`，表示查询图片类型的资源。
StoreURIs	String	是	`tos-vod-cn-v-444dxxxxx509637/oQEjw1XtzeiDgQ0MRcfsjZWqlxxxxxeG9`	一个或多个资源的存储 URI。多个 `StoreURI` 之间使用逗号 (,) 分隔。

返回参数

下表仅列出本接口特有的返回参数。更多信息请见公共返回参数。

参数	类型	示例值	描述
URLs	Object[]	`-`	包含 `StoreURI` 和其对应 `URL` 的对象数组。
StoreURI	String	`tos-vod-cn-v-444dx37/oQEjw1xRxl***pQBeG9`	输入的资源存储 URI。
URL	String	`https://example.com/tos-vod-cn-v-444d809637/oQEjw1XtzeiDgQ0MRcfsjZWxBeG9~noop.image?sign=176085b415a5bx6f3e956f2`	`StoreURI` 对应的公网访问 URL。该 URL 已包含 CDN 加速域名和鉴权签名（如果开启了鉴权），可直接用于客户端访问。
NoPermissionUris	Null	`-`	因权限问题导致查询失败的 `StoreURI` 列表。
Total	Integer	`1`	本次成功查询到的 URL 数量。
BaseResp	Object	`-`	基础响应信息。
StatusCode	Integer	`0`	接口请求的状态码。`0`表示成功，其他值表示不同的错误状态。
StatusMessage	String	`success`	接口请求的状态信息，用于描述请求的处理结果。当 `StatusCode` 为 `0` 时，通常返回 `success`表示成功；其他状态码时返回具体的错误信息。
Extra	Null	`-`	额外的响应信息。

请求示例

GET https://vod.volcengineapi.com?Action=GetURLsByStoreURIs&Version=2018-01-01&Space=yxxxxxs&StoreType=Image&StoreURIs=tos-vod-cn-v-444d8xxxxxxxxx9637/oQEjw1XtzeiDgQ0MRcfxxxxxxxxxG9

返回示例

{
  "ResponseMetadata": {
    "RequestId": "20230604110420****100232280022D31",
    "Action": "GetURLsByStoreURIs",
    "Version": "2018-01-01",
    "Service": "vod",
    "Region": "cn-north-1"
  },
  "Result": {
    "URLs": [
      {
        "StoreURI": "tos-vod-cn-v-444dx37/oQEjw***QLxqpQBeG9",
        "URL": "https://example.com/tos-vod-cn-v-444d83ed89509637/oQEjw1***Q0MRcfsjZWxBeG9~noop.image?sign=176085***6f3e956f2"
      }
    ],
    "NoPermissionUris": null,
    "Total": 1,
    "BaseResp": {
      "StatusCode": 0,
      "StatusMessage": "success",
      "Extra": null
    }
  }
}

错误码

本接口无特有的错误码。更多信息请见公共错误码。