添加用户自定义镜像

最近更新时间: 2026-11-07 00:16:28

1. 接口描述

接口请求域名： bms.api3.fincloud.tencent.cn。

添加用户自定义镜像

默认接口请求频率限制：20次/秒。

接口更新时间：2025-12-30 11:23:43。

接口既验签名又鉴权。

2. 输入参数

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

参数名称	必选	允许NULL	类型	描述
Action	是	否	String	公共参数，本接口取值：AddTenantImage
Version	是	否	String	公共参数，本接口取值：2018-08-13
Region	是	否	String	公共参数，地域信息可通过DescribeRegions接口查看产品支持的地域列表
ImageAlias	是	否	String	租户使用的镜像别名示例值： img_name
ImageUrl	是	否	String	对应镜像的租户端COS URL 示例值： http://***/CentOS.iso
OsType	是	否	String	镜像系统示例值： tlinux
ImageFormat	否	否	String	镜像文件格式示例值： IOS
SystemArch	是	否	String	镜像系统架构：X86/ARM 示例值： x86_64
SystemPlatform	是	否	String	镜像系统平台示例值： redhat
SystemVersions	是	否	String	镜像版本示例值： 2.0
ImageDescribe	否	否	String	镜像描述示例值： Description
ZoneName	是	否	String	可用区名称示例值： testg

3. 输出参数

参数名称	类型	描述
Detail	String	返回结果说明示例值： ok
Result	Int64	返回结果值，0成功， 1失败示例值： 0
TaskId	String	添加镜像任务ID 示例值： 042e15d2-98ac-4575-b9a6-4090b-d0fa569
RequestId	String	唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

4. 错误码

该接口暂无业务逻辑相关的错误码，其他错误码详见公共错误码。

5. 示例

示例1 添加用户自定义镜像

输入示例

{
  "ImageAlias": "image_name",
  "ImageUrl": "http://bms.api3.fincloud.tencent.cn/CentOS.iso",
  "OsType": "Linux",
  "ImageFormat": "ISO",
  "SystemArch": "aarch64",
  "SystemPlatform": "CentOS",
  "SystemVersions": "7",
  "ImageDescribe": "",
  "ZoneName": "az",
  "Version": "2018-08-13",
  "Language": "zh-CN"
}

输出示例

{
  "Response": {
    "Detail": "ok",
    "Result": 0,
    "TaskId": "0f827e1e-f583-416f-803f-3f157f02024b",
    "RequestId": "d67a47fa-2513-4352-9353-7104820886f7"
  }
}