ImportImage#

Description#

Creates a task to import snapshots as an image. If the snapshot you want to import 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

  • TagSpecification.N — Tags assigned to the resource being created. When the resource type is snapshot, tags will be assigned to all snapshots created with the image.

    • Type: List of TagSpecification objects

    • Valid resource types: image | snapshot

    • 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.

  • tagSet — List of created tags.

Examples#

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