ImportImage#

Description#

Creates a task to import snapshots. If the snapshot being imported has OVA format, an instance will be imported. If you try to import multiple OVA snapshots, then an error occurs.

Request Parameters#

Required parameters#

  • DiskContainer — Information about the imported snapshots.

Optional parameters#

  • Description — The description of the import task.

    • Type: String

    • Required: No

    • Length constraints: Up to 255 ASCII characters

  • Email — The email address for notification.

    • Type: String

    • Required: No

  • ImageName — The image name.

    • Type: String

    • Required: No

    • Constraints: up to 255 ASCII characters, parentheses (), square brackets [], spaces " ", periods ., slashes /, dashes -, single quotes ', at-signs @, or underscores _

  • Notify — Notify about the task status via email.

    • Type: Boolean

    • Required: No

  • VirtualizationType — The type of the image virtualization.

    • Type: String

    • Possible values: hvm | hvm-legacy

    • Required: No

Response Elements#

  • description — The description of the task.

  • imageId — The image ID.

  • importTaskId — The ID of the import task.

  • progress — The percentage of task completion.

  • snapshotDetailsSet

    • description — The description of the snapshot.

    • diskImageSize — The size of the volume.

    • format — The format of the volume.

    • progress — The progress of the snapshot creation process.

    • snapshotId — The ID of the snapshot.

    • status — The state of the snapshot import task.

    • statusMessage — The description of the current step.

    • userBucket

      • s3Bucket — The bucket used.

      • s3Key — The S3 ID of the imported snapshot.

  • status — The state of the snapshot import task.

  • statusMessage — The description of the current task step.

Examples#

c2-ec2 ImportImage Description "description" DiskContainer.0.Description "image description" DiskContainer.0.Format "VMDK" DiskContainer.0.UserBucket.S3Bucket "bucket" DiskContainer.0.UserBucket.S3Key "image.vmdk" Notify True Email test@test.test