You need to enable JavaScript to run this app.
导航

ImportImage

最近更新时间2024.03.22 16:45:43

首次发布时间2022.07.01 09:23:04

调用 ImportImage 接口导入一份您的本地镜像文件到云服务器,作为自定义镜像出现在相应地域中。

说明

  • 导入镜像的要求和限制请参见导入镜像要求
  • 您必须提前上传镜像文件到对象存储“TOS bucket服务”,并确认授权ECS官方服务账号可以访问您的对象文件。具体操作,请参见导入自定义镜像
  • 您可以使用导入的镜像创建ECS实例(RunInstances),或者更换实例的系统盘(ReplaceSystemDisk)。
  • 每个地域下最多支持50个自定义镜像。

调试

请求参数

名称类型是否必填示例值描述
ActionStringImportImage要执行的操作,取值:ImportImage。
VersionString2020-04-01接口的版本,取值:2020-04-01。

ImageName

String

image-1

镜像名称。

  • 必须以字母、汉字开头。
  • 只能包含中文,字母,数字,下划线“_”,中划线“-”,英文句号“.”。
  • 长度限制为1 ~ 128个字符。

Description

String

This is my first image

镜像描述。

  • 必须以字母、汉字开头。
  • 只能包含中文,字母,数字,下划线“_”,中划线“-”,等号“=”,英文逗号“,”和英文句号“.”,中文逗号“,”和中文句号“。”和空格。
  • 长度限制为0 ~ 255个字符。
  • 不填默认为空。

OsType

String

Linux

操作系统类型。取值:

  • Linux

  • Windows

说明

若为空,火山引擎会根据您传入的Platform类型确认OsType

Platform

String

CentOS

镜像操作系统的发行版本。取值:

  • CentOS
  • Debian
  • veLinux
  • Windows Server
  • Fedora
  • OpenSUSE
  • Ubuntu
PlatformVersionString7.6镜像的发行版本。

Architecture

String

amd64

镜像的架构类型。取值:

  • amd64:x86计算
  • arm64:ARM计算

Url

String

-

自定义镜像在TOS存储桶的Url链接。

说明

请将自定义镜像文件上传至TOS存储桶获取链接,详情可查看导入自定义镜像

BootMode

String

UEFI

镜像的启动模式。取值:

  • BIOS(默认):BIOS启动模式。
  • UEFI:UEFI启动模式。
    • 通用型g3i、计算型c3i、内存型r3i及弹性裸金属型规格的云服务器,仅支持UEFI启动模式。
    • 如果Architecture=arm64,则默认值为UEFI,且只能设置为UEFI。

ProjectName

String

default

资源所属项目。

注意

调用接口账号若仅拥有部分项目权限,本参数必填。授权账号操作项目详情,可查看管理项目权限

NeedDetection

Boolean

true

是否进行镜像检测。取值:

  • true:默认值,进行检测。
  • false:不进行检测。

Tags.N.Key

String

image-tag-key-1

镜像标签的标签键。

  • 参数 - N:表示标签键的序号,取值范围:1~20。
  • 多个标签键之间用&分隔。

说明

  • 命名规则如下:
    • 不能以volc:的任意大小写组合开头。
    • 只能包含语言字符、数字、空格和英文符号“_”、“.”、“:”、“/”、“=”、“+”、“-”、“@”。
    • 长度限制在1~128个字符之间。
  • 同一资源的标签键不允许重复。

Tags.N.Value

String

image-tag-value-1

镜像标签的标签值。

  • 参数 - N:表示标签值的序号,取值范围:1~20。
  • 多个标签值之间用&分隔。

说明

  • 命名规则如下:
    • 只能包含语言字符、数字、空格和英文符号“_”、“.”、“:”、“/”、“=”、“+”、“-”、“@”。
    • 允许为空,长度限制在0~256个字符之间。
  • 如果传入该参数,则必须先传入Tags.N.Key

返回数据

名称类型示例值描述
ImageIdStringimage-ebgy1og99tfct0gw****镜像ID。

请求示例

GET /?Action=ImportImage&Version=2020-04-01&ImageName=image-1&OsType=Linux&Platform=CentOS&PlatformVersion=7.6&Architecture=amd64&Url=xxx HTTP/1.1
Host: open.volcengineapi.com
Region: cn-beijing
Service: ecs

返回示例

{
    "ResponseMetadata": {
        "RequestId": "202106111445100102252431000052****",
        "Action": "ImportImage",
        "Version": "2020-04-01",
        "Service": "ecs",
        "Region": "cn-beijing"
    },
    "Result": {
        "ImageId": "image-ebgy1og99tfct0gw****"
    }
}

错误码

HttpCode错误码错误信息描述

400

MissingParameter.ImageName

The required parameter ImageName is not supplied.

镜像名称不能为空。

400InvalidImageName.MalformedThe specified ImageName is malformed.指定的镜像名称不合法。

400

InvalidDescription.Malformed

The specified Description is malformed.

指定的镜像描述不合法。

400InvalidOsType.MalformedThe specified OsType is malformed.指定的操作系统类型不合法。
400InvalidPlatformForDetect.UnSupportedThe specified image platform cannot be used for detect.指定的镜像平台不支持检测。

400

MissingParameter.Platform

The required parameter Platform is not supplied.

镜像的操作系统发行版不能为空。

400InvalidPlatformForImportImage.UnsupportedThe specified Platform cannot be used for ImportImage.指定的镜像操作系统发行版不支持导入。
400InvalidArchitecture.MalformedThe specified Architecture is malformed.指定的镜像架构类型不合法。
400InvalidBootMode.MalformedThe specified BootMode is malformed.指定的启动方式不合法。
400InvalidUrl.MalformedThe specified URL is malformed.指定的URL不合法。
400InvalidTosGetObject.AccessDeniedThe Action tos:GetObject is not authorized for ecs, please check your IAM policy of ecs.tos:GetObject未授权给ecs,请检查您的ecs IAM策略。
400LimitExceeded.MaximumImageCountYou've reached the limit on the number of image that you can create.可拥有的自定义镜像个数超过限制。
400LimitExceeded.MaximumImageSizeYou've reached the limit on the number of image size that you can import.指定的镜像大小(GiB)超出限制。
400InvalidTagKey.MalformedThe specified TagKey is malformed.指定的标签的键不合法。
400InvalidTagValue.MalformedThe specified TagValue is malformed.指定的标签的值不合法。
400LimitExceeded.MaximumTagsYou've reached the limit on the number of tags that you can create.指定的标签数量超过最大限制。
404InvalidTOSObject.NotFoundThe specified TOSObject does not exist.指定的TOSObject不存在。
404InvalidProject.NotFoundThe specified Project does not exist.指定的Project不存在。
409InvalidTagKey.ConflictThe specified TagKey already exists.指定的标签键已存在。
500InternalErrorAn internal error has occurred.内部错误,请重试。如果多次尝试失败,请提交工单。