You need to enable JavaScript to run this app.
最新活动
产品
解决方案
定价
生态与合作
支持与服务
开发者
了解我们
导航

获取所有服务信息

最近更新时间2023.07.28 15:16:36

首次发布时间2021.02.23 10:42:23

本接口支持获取当前火山账号下创建的所有 veImageX 图片服务信息。

注意事项

  • 请求频率:单用户请求频率限制为 1000 次/秒
  • 超时时间:超时时间约 5 秒

请求说明

  • 请求方式:GET
  • 接口地址示例:https://imagex.volcengineapi.com/?Action=GetAllImageServices&Version=2018-08-01

说明

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

请求参数

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

Query

参数类型是否必选示例值描述
ActionStringGetAllImageServices接口名称。当前 API 的版本为 GetAllImageServices
VersionString2018-08-01接口版本。当前 API 的版本为 2018-08-01
SearchPtnString7y***1i该值为空时返回所有服务,指定后返回服务名或者 ID 中包含该字符串的服务。

返回参数

参数类型示例值描述
ServicesArray of Services所有的服务信息。

Services

参数类型示例值描述
ServiceNameStringImageX服务服务名称。
ServiceIdString7y***1i指定的服务 ID。

ServiceRegion

String

cn

服务地域,取值如下所示:

  • cn:中国
  • va:美东
  • sg:新加坡

ServiceType

String

Image

服务类型,取值如下所示:

  • StaticRc:素材托管服务
  • Image:图片处理服务

ServiceStatus

String

正常

服务状态。状态分为未审核、审核未通过、正常、禁用。

说明

  • 只有服务状态为正常时,该服务才可用。
  • 如果是其他异常状态,请参考服务管理进行处理。
CreateAtString2018-05-09 17:44:40服务创建时间,即创建时当地服务器时间。

HasSigkey

Bool

false

服务是否已经配置鉴权 key,取值如下所示:

  • true:已配置
  • false:未配置
TemplatePrefixStringtplv-fc*****cf-该服务的图片模板固定前缀。
DomainInfosArray of DomainInfos绑定域名的相关信息。
PrimaryKeyStrings1g2b75**PeZZ4f主鉴权 Key。
SecondaryKeyStringHYPe178**2hZZ4f备鉴权 Key。

ObjectAccess

Bool

true

是否开启源地址访问,取值如下所示:

  • true:开启
  • false:关闭

CompactURL

Bool

true

是否开启精简 URL,取值如下所示:

  • true:开启
  • false:关闭
MirrorObject of Mirror镜像回源配置。
StorageObject of Storage资源配置。
AllowBktsArray of Stringtos-cn-i-fc*****cf服务的授权 Bucket 列表。

UploadOverwrite

Boolean

false

是否开启覆盖上传,取值如下所示:

  • true:开启
  • false:关闭

Storage

参数类型示例值描述
BktNameStringtos-cn-i-fc*****cf存储 Bucket 名称。
TTLInteger0保存时间,单位为秒。

AllTypes

Bool

false

是否支持任意文件格式上传,取值如下所示:

  • true:支持
  • false:不支持

DomainInfos

参数类型示例值描述
DomainNameStringimgtest.a.org绑定的域名。
CNAMEStringimgtest.a.org.bytedance.com域名解析到的 cname。
StatusString正常域名状态。

IsDefault

Bool

false

是否是默认域名,取值如下所示:

  • true:默认域名
  • false:非默认域名

Mirror

参数类型示例值描述
SchemaStringhttp下载图片的协议,支持取值:httphttps
HostStringtest.com镜像回源域名。

Hosts

JSON Map

{
  "test.com": 100,
  "test1.com": 0
}

带权重回源域名,key 为 String 类型时,代表镜像回源域名;value 为 Integer 类型时,代表域名权重。

SourceString/a/b/test%s镜像源 URI,其中图片名用 %s 占位符替代,比如/obj/%s。

Headers

JSON Map

{
  "name": "app1"
}

镜像回源下载原图时,携带的 HTTP 头部,键值都为 String 类型。

示例

请求示例

GET https://imagex.volcengineapi.com/?Action=GetAllImageServices&Version=2018-08-01&SearchPtn=picture

返回示例

{
   "ResponseMetadata":{
      "RequestId":"2022082920380201020803721701755F97",
      "Action":"GetAllImageServices",
      "Version":"2018-08-01",
      "Service":"imagex",
      "Region":"cn-north-1"
   },
   "Result": {
        "Services": [
            {
                "ServiceName": "picture_1",
                "ServiceId": "fc*****cf",
                "ServiceRegion": "cn",
                "CreateAt": "2018-05-09 17:44:40",
                "ServiceStatus": "正常",
                "HasSigkey": false,
                "TemplatePrefix": "tplv-fc*****cf-",
                "UploadOverwrite": "false",
                "DomainInfos": [{
                    "DomainName": "test",
                    "CNAME": "test.bytedance.com",
                    "Status": "正常",
                    "IsDefault": true
                }],
                "ObjectAccess": false,
                "CompactURL": false,
                "AllowBkts": ["tos-cn-i-fc*****cf"],
                "Mirror": {
				            "Schema": "http",
				            "Host": "test.com",
				            "Hosts": {
				                "test.com": 100,
				                "test1.com": 0
				            },
				            "Source": "/a/b/test%s",
				            "Headers": {
				                "name": "app1"
				            }
				        },
                "Storage": {
                    "BktName": "tos-cn-i-fc*****cf",
                    "TTL": 0,
                    "AllTypes": false
                }
            }
        ]
    }
}

错误码

访问公共错误码服务相关错误码获取详细信息。