@Generated(value="software.amazon.awssdk:codegen") public final class ImportImageRequest extends Ec2Request implements ToCopyableBuilder<ImportImageRequest.Builder,ImportImageRequest>
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) |
boolean |
equalsBySdkFields(Object obj) |
<T> Optional<T> |
getValueForField(String fieldName,
Class<T> clazz) |
boolean |
hasDiskContainers()
Returns true if the DiskContainers property was specified by the sender (it may be empty), or false if the sender
did not specify the value (it will be empty).
|
int |
hashCode() |
boolean |
hasLicenseSpecifications()
Returns true if the LicenseSpecifications property was specified by the sender (it may be empty), or false if the
sender did not specify the value (it will be empty).
|
String |
hypervisor()
The target hypervisor platform.
|
String |
kmsKeyId()
An identifier for the symmetric AWS Key Management Service (AWS KMS) customer master key (CMK) to use when
creating the encrypted AMI.
|
List<ImportImageLicenseConfigurationRequest> |
licenseSpecifications()
The ARNs of the license configurations.
|
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() |
String |
toString()
Returns a string representation of this object.
|
overrideConfiguration
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
copy
public String architecture()
The architecture of the virtual machine.
Valid values: i386
| x86_64
| arm64
Valid values: i386
| x86_64
| arm64
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 boolean hasDiskContainers()
public List<ImageDiskContainer> diskContainers()
Information about the disk containers.
Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
You can use hasDiskContainers()
to see if a value was sent in this field.
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 symmetric 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. 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.
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.
Amazon EBS does not support asymmetric CMKs.
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. 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.
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.
Amazon EBS does not support asymmetric CMKs.
public String licenseType()
The license type to be used for the Amazon Machine Image (AMI) after importing.
By default, we detect the source-system operating system (OS) and apply the appropriate license. Specify
AWS
to replace the source-system license with an AWS license, if appropriate. Specify
BYOL
to retain the source-system license, if appropriate.
To use BYOL
, you must have existing licenses with rights to use these licenses in a third party
cloud, such as AWS. For more information, see Prerequisites in the VM Import/Export User Guide.
By default, we detect the source-system operating system (OS) and apply the appropriate license. Specify
AWS
to replace the source-system license with an AWS license, if appropriate. Specify
BYOL
to retain the source-system license, if appropriate.
To use BYOL
, you must have existing licenses with rights to use these licenses in a third
party cloud, such as AWS. For more information, see Prerequisites in the VM Import/Export User Guide.
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 boolean hasLicenseSpecifications()
public List<ImportImageLicenseConfigurationRequest> licenseSpecifications()
The ARNs of the license configurations.
Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
You can use hasLicenseSpecifications()
to see if a value was sent in this field.
public ImportImageRequest.Builder toBuilder()
toBuilder
in interface ToCopyableBuilder<ImportImageRequest.Builder,ImportImageRequest>
toBuilder
in class Ec2Request
public static ImportImageRequest.Builder builder()
public static Class<? extends ImportImageRequest.Builder> serializableBuilderClass()
public int hashCode()
hashCode
in class AwsRequest
public boolean equals(Object obj)
equals
in class AwsRequest
public boolean equalsBySdkFields(Object obj)
equalsBySdkFields
in interface SdkPojo
public String toString()
public <T> Optional<T> getValueForField(String fieldName, Class<T> clazz)
getValueForField
in class SdkRequest
Copyright © 2020. All rights reserved.