获取禁用 URL 列表详情--veImageX-火山引擎

文档中心

立即注册

导航

veImageX

获取禁用 URL 列表详情

最近更新时间：2024.08.13 17:52:59首次发布时间：2023.01.12 18:13:58

本接口支持获取近 30 天内的已被禁用的 URL 列表详情，若 URL 解禁成功，则无法被查询。

说明

该接口属于历史版本 API，建议您使用新版 GetImageContentBlockList 接口。

请求说明

接口名称：GetImageContentBlockList
请求方式：POST
接口地址示例：https://imagex.volcengineapi.com/?Action=GetImageContentBlockList&Version=2018-08-01
请求频率：单用户请求频率是 10 次/秒。
数据延迟：暂无数据延迟。

说明

veImageX 在全球多个区域部署，每个区域有自己对应的 OpenAPI 域名，不支持跨区域调用。具体详情请查看服务地址。

请求参数

以下请求参数列表仅列出了该接口的部分公共参数，完整公共参数列表见公共参数。

Query

参数类型是否必选描述

Action String 是接口名称。

Version String 是接口版本。veImageX 当前 API 的版本为 2018-08-01。

参数	类型	是否必选	描述
Action	String	是	接口名称。
Version	String	是	接口版本。veImageX 当前 API 的版本为 `2018-08-01`。
ServiceId	String	是	服务 ID。您可以在veImageX 控制台服务管理页面，在创建好的图片服务中获取服务 ID。您也可以通过 OpenAPI 的方式获取服务 ID，具体请参考获取所有服务信息。

ServiceId

String

是

服务 ID。

您可以在veImageX 控制台服务管理页面，在创建好的图片服务中获取服务 ID。
您也可以通过 OpenAPI 的方式获取服务 ID，具体请参考获取所有服务信息。

Body

参数	类型	是否必选	描述
PageSize	Integer	否	每页最大记录数，取值范围是[10,1000]。默认值为 100。
PageNum	Integer	否	页码，系统将仅返回该页面上的任务。默认值为 1。
StartTime	Integer	是	开始查询时间，unix 时间戳，单位为秒。
EndTime	Integer	是	结束查询时间，unix 时间戳，单位为秒。
State	String	否	资源更新状态，取值如下所示： `submitting`：提交中 `running`：执行中 `succeed`：成功 `failed`：失败
Url	String	否	指定 URL，缺省情况下查询当前服务所有禁用任务列表。
Order	String	否	按时间排序，取值如下所示： `asc`：正序 `desc`：逆序

返回参数

参数	类型	描述
PageNum	Integer	当前页码
PageSize	Integer	每页最大记录数
Total	Integer	符合查询条件的总记录数
Data	Array of Data	具体数据

Data

参数	类型	描述
Url	String	指定的 URL
State	String	URL 状态
Process	String	任务进度
TaskType	String	任务类型，取值如下所示： `block_url`：禁用任务。 `unblock_url`：解禁任务，表示此时解禁未完成。
CreateTime	Integer	任务的创建时间
UpdateTime	Integer	任务的更新时间
Msg	String	完成结果提示信息

示例

请求示例

POST https://imagex.volcengineapi.com/?Action=GetImageContentBlockList&Version=2018-08-01&ServiceId=WMKp6UXe*
{
   "PageNum":1,
   "PageSize":10,
   "Order":"desc",
   "StartTime":1678204800,
   "EndTime":1678252535,
   "Url":"http://t.test.com/778141***b133f7b"
}

正常返回示例

{
   "ResponseMetadata":{
      "RequestId":"20230308131535FEDBE13F9A1A0010D907",
      "Action":"GetImageContentBlockList",
      "Version":"2018-08-01",
      "Service":"imagex",
      "Region":"cn-north-1"
   },
   "Result":{
      "PageNum":1,
      "PageSize":10,
      "Total":1,
      "Data":[
         {
            "Url":"http://t.test.com/778141***b133f7b",
            "TaskType":"block_url",
            "CreateTime":1678252511,
            "UpdateTime":1678252526,
            "State":"running",
            "Process":"0%",
            "Msg":""
         }
      ]
   }
}

异常返回示例

{
    "ResponseMetadata": {
        "RequestId": "2019052718331201022507411142148",
        "Action": "GetImageContentBlockList",
        "Version": "2018-08-01",
        "Service": "imagex",
        "Region": "cn-north-1"
        "Error": {
            "CodeN": 604004,
            "Code": "",
            "Message": "image url invalid"
        }
    }
}

错误码

访问错误码获取详细信息。

服务端 SDK

为了方便您快速开发，veImageX 提供了配套的服务端 SDK，同时支持多种编程语言。建议您使用服务端 SDK 来调用 API，参考文档如下所示：