752      阿里云  技术社区[云栖]

导入镜像__镜像相关接口_API 参考_云服务器 ECS-阿里云

导入自定义镜像

描述

导入镜像是把客户线下的一个镜像文件导入到ECS环境中生成一个自定义镜像。可以使用这个镜像来创建ECS实例和更换系统盘。

• 请先将镜像文件上传到OSS。
• 导入镜像的地域必须跟镜像文件存放的OSS的同一个账号同一个地域。
• DiskDeviceMapping.N 暂时只支持1，也就是只支持系统盘镜像，暂时不支持数据盘做镜像。
• 镜像没有导入完成，是不能进行删除操作，可以进行取消导入镜像任务操作。
• 需要通过RAM给阿里云ECS官方服务账号授权读取OSS的权限。

1.创建角色：AliyunECSImageImportDefaultRole（必须是这个名称，否则导入镜像会失败），角色的策略：
{
  "Statement": [
    {
      "Action": "sts:AssumeRole",
      "Effect": "Allow",
      "Principal": {
        "Service": [
          "ecs.aliyuncs.com"
        ]
      }
    }
  ],
  "Version": "1"
}
2.在该角色下直接加入默认的系统权限策略：AliyunECSImageImportRolePolicy，这个策略是ECS提供导入镜像的默认策略，你也可以创建自定义策略，权限需要包含：
{
  "Version": "1",
  "Statement": [
    {
      "Action": [
        "oss:GetObject",
        "oss:GetBucketLocation"
      ],
      "Resource": "*",
      "Effect": "Allow"
    }
  ]
}

请求参数

https://ecs.aliyuncs.com/?Action=ImportImage
&RegionId=cn-hangzhou
&DiskDeviceMapping.1.OSSBucket=ecsimageos
&DiskDeviceMapping.1.OSSObject=CentOS_5.4_32.raw
&<公共请求参数>

<ImportImageResponse>
    <RequestId>C8B26B44-0189-443E-9816-D951F59623A9</RequestId>
    <ImageId>Img-231234567</ImageId>
    <ImportTaskId>123-345-2332-22323</ImportTaskId>
</ImportImageResponse>

{
    "RequestId": "C8B26B44-0189-443E-9816-D951F59623A9",
    "ImageId": "Img-231234567"，
    "ImportTaskId":"123-345-2332-22323"
}