# EbsInstanceBlockDeviceSpecification
<a name="API_EbsInstanceBlockDeviceSpecification"></a>

Amazon EBS-specific block device mapping specifications.

## Contents
<a name="API_EbsInstanceBlockDeviceSpecification_Contents"></a>

 ** deleteOnTermination **   <a name="imagebuilder-Type-EbsInstanceBlockDeviceSpecification-deleteOnTermination"></a>
Specifies whether to delete the associated device on termination.  
Type: Boolean  
Required: No

 ** encrypted **   <a name="imagebuilder-Type-EbsInstanceBlockDeviceSpecification-encrypted"></a>
Specifies whether to encrypt the device.  
Type: Boolean  
Required: No

 ** iops **   <a name="imagebuilder-Type-EbsInstanceBlockDeviceSpecification-iops"></a>
The IOPS value for the device. Required only when volumeType is io1 or io2.  
Type: Integer  
Valid Range: Minimum value of 100. Maximum value of 64000.  
Required: No

 ** kmsKeyId **   <a name="imagebuilder-Type-EbsInstanceBlockDeviceSpecification-kmsKeyId"></a>
The Amazon Resource Name (ARN) that uniquely identifies the KMS key to use when encrypting the device. This can be either the Key ARN or the Alias ARN. For more information, see [Key identifiers (KeyId)](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#key-id-key-ARN) in the * AWS Key Management Service Developer Guide*.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 1024.  
Required: No

 ** snapshotId **   <a name="imagebuilder-Type-EbsInstanceBlockDeviceSpecification-snapshotId"></a>
The snapshot that defines the device contents.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 1024.  
Required: No

 ** throughput **   <a name="imagebuilder-Type-EbsInstanceBlockDeviceSpecification-throughput"></a>
 **For GP3 volumes only** – The throughput in MiB/s that the volume supports.  
Type: Integer  
Valid Range: Minimum value of 125. Maximum value of 1000.  
Required: No

 ** volumeSize **   <a name="imagebuilder-Type-EbsInstanceBlockDeviceSpecification-volumeSize"></a>
Overrides the volume size for the device.  
Type: Integer  
Valid Range: Minimum value of 1. Maximum value of 16000.  
Required: No

 ** volumeType **   <a name="imagebuilder-Type-EbsInstanceBlockDeviceSpecification-volumeType"></a>
Overrides the volume type for the device.  
Type: String  
Valid Values: `standard | io1 | io2 | gp2 | gp3 | sc1 | st1`   
Required: No

## See Also
<a name="API_EbsInstanceBlockDeviceSpecification_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\+\+](https://docs.aws.amazon.com/goto/SdkForCpp/imagebuilder-2019-12-02/EbsInstanceBlockDeviceSpecification) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/imagebuilder-2019-12-02/EbsInstanceBlockDeviceSpecification) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/imagebuilder-2019-12-02/EbsInstanceBlockDeviceSpecification)