String reason
The reason for the exception.
Integer blockIndex
The block index.
String firstBlockToken
The block token for the block index of the FirstSnapshotId
specified in the
ListChangedBlocks
operation. This value is absent if the first snapshot does not have the changed
block that is on the second snapshot.
String secondBlockToken
The block token for the block index of the SecondSnapshotId
specified in the
ListChangedBlocks
operation.
String snapshotId
The ID of the snapshot.
Integer changedBlocksCount
The number of blocks that were written to the snapshot.
String checksum
An aggregated Base-64 SHA256 checksum based on the checksums of each written block.
To generate the aggregated checksum using the linear aggregation method, arrange the checksums for each written block in ascending order of their block index, concatenate them to form a single string, and then generate the checksum on the entire string using the SHA256 algorithm.
String checksumAlgorithm
The algorithm used to generate the checksum. Currently, the only supported algorithm is SHA256
.
String checksumAggregationMethod
The aggregation method used to generate the checksum. Currently, the only supported aggregation method is
LINEAR
.
String status
The status of the snapshot.
String snapshotId
The ID of the snapshot containing the block from which to get data.
Integer blockIndex
The block index of the block from which to get data.
Obtain the BlockIndex
by running the ListChangedBlocks
or
ListSnapshotBlocks
operations.
String blockToken
The block token of the block from which to get data.
Obtain the BlockToken
by running the ListChangedBlocks
or
ListSnapshotBlocks
operations.
Integer dataLength
The size of the data in the block.
InputStream blockData
The data content of the block.
String checksum
The checksum generated for the block, which is Base64 encoded.
String checksumAlgorithm
The algorithm used to generate the checksum for the block, such as SHA256.
String firstSnapshotId
The ID of the first snapshot to use for the comparison.
The FirstSnapshotID
parameter must be specified with a SecondSnapshotId
parameter;
otherwise, an error occurs.
String secondSnapshotId
The ID of the second snapshot to use for the comparison.
The SecondSnapshotId
parameter must be specified with a FirstSnapshotID
parameter;
otherwise, an error occurs.
String nextToken
The token to request the next page of results.
Integer maxResults
The number of results to return.
Integer startingBlockIndex
The block index from which the comparison should start.
The list in the response will start from this block index or the next valid block index in the snapshots.
List<E> changedBlocks
An array of objects containing information about the changed blocks.
Date expiryTime
The time when the BlockToken
expires.
Long volumeSize
The size of the volume in GB.
Integer blockSize
The size of the block.
String nextToken
The token to use to retrieve the next page of results. This value is null when there are no more results to return.
String snapshotId
The ID of the snapshot from which to get block indexes and block tokens.
String nextToken
The token to request the next page of results.
Integer maxResults
The number of results to return.
Integer startingBlockIndex
The block index from which the list should start. The list in the response will start from this block index or the next valid block index in the snapshot.
List<E> blocks
An array of objects containing information about the blocks.
Date expiryTime
The time when the BlockToken
expires.
Long volumeSize
The size of the volume in GB.
Integer blockSize
The size of the block.
String nextToken
The token to use to retrieve the next page of results. This value is null when there are no more results to return.
String snapshotId
The ID of the snapshot.
Integer blockIndex
The block index of the block in which to write the data. A block index is a logical index in units of
512
KiB blocks. To identify the block index, divide the logical offset of the data in the logical
volume by the block size (logical offset of data/524288
). The logical offset of the data must be
512
KiB aligned.
InputStream blockData
The data to write to the block.
The block data is not signed as part of the Signature Version 4 signing process. As a result, you must generate and provide a Base64-encoded SHA256 checksum for the block data using the x-amz-Checksum header. Also, you must specify the checksum algorithm using the x-amz-Checksum-Algorithm header. The checksum that you provide is part of the Signature Version 4 signing process. It is validated against a checksum generated by Amazon EBS to ensure the validity and authenticity of the data. If the checksums do not correspond, the request fails. For more information, see Using checksums with the EBS direct APIs in the Amazon Elastic Compute Cloud User Guide.
Integer dataLength
The size of the data to write to the block, in bytes. Currently, the only supported size is 524288
.
Valid values: 524288
Integer progress
The progress of the write process, as a percentage.
String checksum
A Base64-encoded SHA256 checksum of the data. Only SHA256 checksums are supported.
String checksumAlgorithm
The algorithm used to generate the checksum. Currently, the only supported algorithm is SHA256
.
String reason
The reason for the exception.
String reason
The reason for the exception.
String reason
The reason for the exception.
Long volumeSize
The size of the volume, in GiB. The maximum size is 16384
GiB (16 TiB).
String parentSnapshotId
The ID of the parent snapshot. If there is no parent snapshot, or if you are creating the first snapshot for an on-premises volume, omit this parameter.
If your account is enabled for encryption by default, you cannot use an unencrypted snapshot as a parent snapshot. You must first create an encrypted copy of the parent snapshot using CopySnapshot.
List<E> tags
The tags to apply to the snapshot.
String description
A description for the snapshot.
String clientToken
A unique, case-sensitive identifier that you provide to ensure the idempotency of the request. Idempotency ensures that an API request completes only once. With an idempotent request, if the original request completes successfully. The subsequent retries with the same client token return the result from the original successful request and they have no additional effect.
If you do not specify a client token, one is automatically generated by the AWS SDK.
For more information, see Idempotency for StartSnapshot API in the Amazon Elastic Compute Cloud User Guide.
Boolean encrypted
Indicates whether to encrypt the snapshot. To create an encrypted snapshot, specify true
. To create
an unencrypted snapshot, omit this parameter.
If you specify a value for ParentSnapshotId, omit this parameter.
If you specify true
, the snapshot is encrypted using the CMK specified using the KmsKeyArn
parameter. If no value is specified for KmsKeyArn, the default CMK for your account is used. If no default
CMK has been specified for your account, the AWS managed CMK is used. To set a default CMK for your account, use
ModifyEbsDefaultKmsKeyId.
If your account is enabled for encryption by default, you cannot set this parameter to false
. In
this case, you can omit this parameter.
For more information, see Using encryption in the Amazon Elastic Compute Cloud User Guide.
String kmsKeyArn
The Amazon Resource Name (ARN) of the AWS Key Management Service (AWS KMS) customer master key (CMK) to be used to encrypt the snapshot. If you do not specify a CMK, the default AWS managed CMK is used.
If you specify a ParentSnapshotId, omit this parameter; the snapshot will be encrypted using the same CMK that was used to encrypt the parent snapshot.
If Encrypted is set to true
, you must specify a CMK ARN.
Integer timeout
The amount of time (in minutes) after which the snapshot is automatically cancelled if:
No blocks are written to the snapshot.
The snapshot is not completed after writing the last block of data.
If no value is specified, the timeout defaults to 60
minutes.
String description
The description of the snapshot.
String snapshotId
The ID of the snapshot.
String ownerId
The AWS account ID of the snapshot owner.
String status
The status of the snapshot.
Date startTime
The timestamp when the snapshot was created.
Long volumeSize
The size of the volume, in GiB.
Integer blockSize
The size of the blocks in the snapshot, in bytes.
List<E> tags
The tags applied to the snapshot. You can specify up to 50 tags per snapshot. For more information, see Tagging your Amazon EC2 resources in the Amazon Elastic Compute Cloud User Guide.
String parentSnapshotId
The ID of the parent snapshot.
String kmsKeyArn
The Amazon Resource Name (ARN) of the AWS Key Management Service (AWS KMS) customer master key (CMK) used to encrypt the snapshot.
String reason
The reason for the validation exception.
Copyright © 2021. All rights reserved.