AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅中国的 AWS 服务入门。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

将映像作为 Amazon EC2 AMI 导入到您的设备中

使用Amazon CLI，您可以使用Amazon功能虚拟机导入/导出以将图像导入到您的Amazon Snowball边缘设备作为 EC2 实例。导入映像后，您需要将它注册为 Amazon 系统映像 (AMI)，并将它作为 Amazon EC2 实例启动。

第 1 步：准备映像

您可以从Amazon云使用虚拟机导入/导出，或使用您选择的虚拟化平台本地生成映像。您还可以从Amazon云。

当您拥有映像时，您必须将其上传到设备上的 Amazon S3，因为您只能从 Amazon S3 中导入可在您的设备或集群上使用的映像。在导入过程中，您可以选择 Snowball Edge 设备上的 S3 存储桶来存储映像。

第 2 步：设置所需权限

要成功导入，您必须为虚拟机导入/导出、Amazon EC2 和用户设置权限。

VM Import/Export 所需的权限

创建角色

在开始导入过程之前，您必须使用允许 Snowball VM 导入/导出代入角色的信任策略创建 IAM 角色。授予角色的其他权限，以允许 VM 导入/导出访问存储在设备上 S3 存储桶中的映像。

API 的默认角色名称为vmimport。您可以使用--role-name字符串。

以下是需要附加到角色的信任策略示例，以便 VM 导入/导出可以访问需要从 S3 存储桶导入的快照。

{
   "Version":"2012-10-17",
   "Statement":[
      {
         "Effect":"Allow",
         "Principal":{
            "Service":"vmie.amazonaws.com"
         },
         "Action":"sts:AssumeRole"
      }
   ]
}

下面是一个从create-role命令。

{
        "Role": {
            "Path": "/",            
            "RoleName": "vmimport",            
            "RoleId": "XXXXXXXXXXXXXXXXXXXXXXXXXX",            
            "Arn": "arn:aws:iam::123456789012:role/vmimport",            
            "CreateDate": "2020-07-30T01:01:57.415000+00:00",            
            "AssumeRolePolicyDocument": {
                "Version": "2012-10-17",                
                "Statement": [
                    {
                        "Effect": "Allow",                        
                        "Principal": {
                            "Service": "vmie.amazonaws.com"                    
                        },                        
                        "Action": "sts:AssumeRole"                    
                    }
                ]
            },            
            "MaxSessionDuration": 3600        
        }
 }

为该角色创建策略并将策略附加到该角色

现在，您可以将策略附加到前面的角色并授予访问所需资源的权限。这允许本地虚拟机导入/导出服务从设备上的 Amazon S3 下载快照。

呼叫者所需的权限

除了要担任 Snowball Edge VM 导入/导出角色之外，还必须确保用户具有允许他们将角色传递给 VMIE 的权限。如果您使用默认 root 用户执行导入，则 root 用户已具有所需的所有权限，因此您可以跳过此步骤，然后转到步骤 3。

将以下两个 IAM 权限附加到正在执行导入的用户账户。

在您的设备上调用 Amazon EC2 API 所需的权限

要导入快照，IAM 用户必须具有ec2:ImportSnapshot权限。如果不需要限制对用户的访问，则可以使用ec2:*权限授予完全 Amazon EC2 访问权限。以下是可以在您的设备上授予或限制 Amazon EC2 的权限。

{
   "Version":"2012-10-17",
   "Statement":[
      {
         "Effect":"Allow",
         "Action":[
            "ec2:ImportSnapshot",
            "ec2:DescribeImportSnapshotTasks",
            "ec2:CancelImportTask",
            "ec2:DescribeSnapshots",
            "ec2:DeleteSnapshot",
            "ec2:RegisterImage",
            "ec2:DescribeImages",
            "ec2:DeregisterImage"
         ],
         "Resource":"*"
      }
   ]
}

第 3 步：将快照导入您的设备上的 Amazon S3

下一步是将快照导入到您设备上的 Amazon S3 中。

aws ec2 import-snapshot --disk-container "Format=RAW,UserBucket={S3Bucket=bucket,S3Key=vmimport/image01}" --profile xx --endpoint http://10.1.2.3:8008 --region snow

有关更多信息，请参阅 。导入快照。

此命令不支持以下开关。

第 4 步：将快照注册为 AMI

成功将快照导入到设备后，您可以使用register-image命令。

有关更多信息，请参阅 。寄存器映像。

块储存设备映射 JSON（未转义）

[
   {
      "DeviceName":"/dev/sda1",
      "Ebs":{
         "SnapshotId":"s.snap-0371c902634195955",
         "VolumeType":"sbg1"
      }
   },
   {
      "DeviceName":"/dev/sda2",
      "Ebs":{
         "VolumeType":"sbp1",
         "VolumeSize":1000
      }
   }
]

第 5 步：启动 AMI

要启动实例，请参阅run-instances。

aws ec2 run-instances --image-id s.ami-xxxxxxxxxxx --instance-type sbe-c.large --profile xx --endpoint http://10.1.2.3:8008

输出示例

{
   "Instances":[
      {
         "SourceDestCheck":false,
         "CpuOptions":{
            "CoreCount":1,
            "ThreadsPerCore":2
         },
         "InstanceId":"s.i-12345a73123456d1",
         "EnaSupport":false,
         "ImageId":"s.ami-1234567890abcdefg",
         "State":{
            "Code":0,
            "Name":"pending"
         },
         "EbsOptimized":false,
         "SecurityGroups":[
            {
               "GroupName":"default",
               "GroupId":"s.sg-1234567890abc"
            }
         ],
         "RootDeviceName":"/dev/sda1",
         "AmiLaunchIndex":0,
         "InstanceType":"sbe-c.large"
      }
   ],
   "ReservationId":"s.r-1234567890abc"
}

描述导入任务

要查看导入进度的当前状态，您可以运行 Amazon EC2describe-import-snapshot-tasks命令。此 API 支持分页和筛选task-state。

此命令不支持以下开关。

取消导入任务

要取消导入任务，请运行cancel-import-task命令。

此命令不支持以下开关。

描述快照

导入快照后，您可以使用此命令对其进行描述。要筛选快照，您可以传入--snapshot-ids使用上一个导入任务响应中的快照 ID。此 API 支持分页和过滤volume-id、status, 和start-time。

此命令不支持以下开关。

从您的设备删除快照

要删除您拥有且不再需要的快照，您可以使用delete-snapshot命令。

此命令不支持以下开关。

注销 AMI

要取消注册不再需要的 AMI，可以运行deregister-image命令。取消注册位于Pending状态当前不支持。

此命令不支持以下开关。