@Generated(value="software.amazon.awssdk:codegen") public final class ImportImageRequest extends Ec2Request implements ToCopyableBuilder<ImportImageRequest.Builder,ImportImageRequest>
Contains the parameters for ImportImage.
Modifier and Type | Class and Description |
---|---|
static interface |
ImportImageRequest.Builder |
Modifier and Type | Method and Description |
---|---|
String |
architecture()
The architecture of the virtual machine.
|
static ImportImageRequest.Builder |
builder() |
ClientData |
clientData()
The client-specific data.
|
String |
clientToken()
The token to enable idempotency for VM import requests.
|
String |
description()
A description string for the import image task.
|
List<ImageDiskContainer> |
diskContainers()
Information about the disk containers.
|
Boolean |
encrypted()
Specifies whether the destination AMI of the imported image should be encrypted.
|
boolean |
equals(Object obj) |
<T> Optional<T> |
getValueForField(String fieldName,
Class<T> clazz)
Used to retrieve the value of a field from any class that extends
SdkRequest . |
int |
hashCode() |
String |
hypervisor()
The target hypervisor platform.
|
String |
kmsKeyId()
An identifier for the AWS Key Management Service (AWS KMS) customer master key (CMK) to use when creating the
encrypted AMI.
|
String |
licenseType()
The license type to be used for the Amazon Machine Image (AMI) after importing.
|
String |
platform()
The operating system of the virtual machine.
|
String |
roleName()
The name of the role to use when not using the default role, 'vmimport'.
|
List<SdkField<?>> |
sdkFields() |
static Class<? extends ImportImageRequest.Builder> |
serializableBuilderClass() |
ImportImageRequest.Builder |
toBuilder()
Take this object and create a builder that contains all of the current property values of this object.
|
String |
toString() |
overrideConfiguration
copy
public String architecture()
The architecture of the virtual machine.
Valid values: i386
| x86_64
Valid values: i386
| x86_64
public ClientData clientData()
The client-specific data.
public String clientToken()
The token to enable idempotency for VM import requests.
public String description()
A description string for the import image task.
public List<ImageDiskContainer> diskContainers()
Information about the disk containers.
Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
public Boolean encrypted()
Specifies whether the destination AMI of the imported image should be encrypted. The default CMK for EBS is used
unless you specify a non-default AWS Key Management Service (AWS KMS) CMK using KmsKeyId
. For more
information, see Amazon EBS
Encryption in the Amazon Elastic Compute Cloud User Guide.
KmsKeyId
. For more information, see Amazon EBS Encryption in
the Amazon Elastic Compute Cloud User Guide.public String hypervisor()
The target hypervisor platform.
Valid values: xen
Valid values: xen
public String kmsKeyId()
An identifier for the AWS Key Management Service (AWS KMS) customer master key (CMK) to use when creating the
encrypted AMI. This parameter is only required if you want to use a non-default CMK; if this parameter is not
specified, the default CMK for EBS is used. If a KmsKeyId
is specified, the Encrypted
flag must also be set.
The CMK identifier may be provided in any of the following formats:
Key ID
Key alias, in the form alias/ExampleAlias
ARN using key ID. The ID ARN contains the arn:aws:kms
namespace, followed by the region of the CMK,
the AWS account ID of the CMK owner, the key
namespace, and then the CMK ID. For example,
arn:aws:kms:us-east-1:012345678910:key/abcd1234-a123-456a-a12b-a123b4cd56ef.
ARN using key alias. The alias ARN contains the arn:aws:kms
namespace, followed by the region of the
CMK, the AWS account ID of the CMK owner, the alias
namespace, and then the CMK alias. For example,
arn:aws:kms:us-east-1:012345678910:alias/ExampleAlias.
AWS parses KmsKeyId
asynchronously, meaning that the action you call may appear to complete even
though you provided an invalid identifier. This action will eventually report failure.
The specified CMK must exist in the region that the AMI is being copied to.
KmsKeyId
is specified, the
Encrypted
flag must also be set.
The CMK identifier may be provided in any of the following formats:
Key ID
Key alias, in the form alias/ExampleAlias
ARN using key ID. The ID ARN contains the arn:aws:kms
namespace, followed by the region of
the CMK, the AWS account ID of the CMK owner, the key
namespace, and then the CMK ID. For
example,
arn:aws:kms:us-east-1:012345678910:key/abcd1234-a123-456a-a12b-a123b4cd56ef.
ARN using key alias. The alias ARN contains the arn:aws:kms
namespace, followed by the
region of the CMK, the AWS account ID of the CMK owner, the alias
namespace, and then the
CMK alias. For example, arn:aws:kms:us-east-1:012345678910:alias/ExampleAlias.
AWS parses KmsKeyId
asynchronously, meaning that the action you call may appear to complete
even though you provided an invalid identifier. This action will eventually report failure.
The specified CMK must exist in the region that the AMI is being copied to.
public String licenseType()
The license type to be used for the Amazon Machine Image (AMI) after importing.
Note: You may only use BYOL if you have existing licenses with rights to use these licenses in a third party cloud like AWS. For more information, see Prerequisites in the VM Import/Export User Guide.
Valid values: AWS
| BYOL
Note: You may only use BYOL if you have existing licenses with rights to use these licenses in a third party cloud like AWS. For more information, see Prerequisites in the VM Import/Export User Guide.
Valid values: AWS
| BYOL
public String platform()
The operating system of the virtual machine.
Valid values: Windows
| Linux
Valid values: Windows
| Linux
public String roleName()
The name of the role to use when not using the default role, 'vmimport'.
public ImportImageRequest.Builder toBuilder()
ToCopyableBuilder
toBuilder
in interface ToCopyableBuilder<ImportImageRequest.Builder,ImportImageRequest>
toBuilder
in class Ec2Request
public static ImportImageRequest.Builder builder()
public static Class<? extends ImportImageRequest.Builder> serializableBuilderClass()
public <T> Optional<T> getValueForField(String fieldName, Class<T> clazz)
SdkRequest
SdkRequest
. The field name
specified should match the member name from the corresponding service-2.json model specified in the
codegen-resources folder for a given service. The class specifies what class to cast the returned value to.
If the returned value is also a modeled class, the SdkRequest.getValueForField(String, Class)
method will
again be available.getValueForField
in class SdkRequest
fieldName
- The name of the member to be retrieved.clazz
- The class to cast the returned object to.Copyright © 2017 Amazon Web Services, Inc. All Rights Reserved.