aws-sdk-ebs 1.25.0 → 1.26.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 76787b57c3e30f227d540df0cd48615cf60d15160fdbe1258819c13c378bb685
-  data.tar.gz: 10faacb671723f45e64a0eba8f6377899e8dd079bb4b603cb033755d964f85fd
+  metadata.gz: 4013979f9613a256c24e2c2482c3f2aedb9b43468c76ec693329324aa911088b
+  data.tar.gz: b6cf7effb8b23cdb33e97ccf1f8ec696fb5ed9b1b6349bd749014ac5a500c0cd
 SHA512:
-  metadata.gz: bedcf78590b9de9cbc7c357cba11cd0720fff341122c2270d8dc1c9712c11f022f9e4edac52932a8e0cb4237129b3ca83c184c50c211ee84b5029377228e09a9
-  data.tar.gz: 720edf413c0f22d61bb4087424210b5352f52a40c734304d43ffd7cf7faaec3854b796572b74b4dae70baeb07c45b8ead9e54b58d12859286bb5480c79563ae0
+  metadata.gz: 1455bdd263d04eb131610cd1718dee2873da0bab4e5637d0a83687a1bc281c054c9b4097cf202db7c53a79d827e097f8066df5ccf46d8e00eee950ef57113eb8
+  data.tar.gz: 35ca94fec56c9d772bbf21dd0fc1c17f3a5b923324eaf96b513b4d03d0580af438194e1944ced9b39aee36c846a0135bbc79280d6f85eaa634b0a631edb52e5c

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.26.0 (2022-03-23)
+------------------
+
+* Feature - Increased the maximum supported value for the Timeout parameter of the StartSnapshot API from 60 minutes to 4320 minutes.  Changed the HTTP error code for ConflictException from 503 to 409.
+
 1.25.0 (2022-02-24)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.25.0
+1.26.0

data/lib/aws-sdk-ebs/client.rb

@@ -412,16 +412,25 @@ module Aws::EBS
     # @option params [required, String] :snapshot_id
     #   The ID of the snapshot containing the block from which to get data.
     #
-    # @option params [required, Integer] :block_index
-    #   The block index of the block from which to get data.
+    #   If the specified snapshot is encrypted, you must have permission to
+    #   use the KMS key that was used to encrypt the snapshot. For more
+    #   information, see [ Using encryption][1] in the *Amazon Elastic Compute
+    #   Cloud User Guide*.
     #
-    #   Obtain the `BlockIndex` by running the `ListChangedBlocks` or
-    #   `ListSnapshotBlocks` operations.
     #
-    # @option params [required, String] :block_token
-    #   The block token of the block from which to get data.
     #
-    #   Obtain the `BlockToken` by running the `ListChangedBlocks` or
+    #   [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ebsapis-using-encryption.html
+    #
+    # @option params [required, Integer] :block_index
+    #   The block index of the block in which to read 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.
+    #
+    # @option params [required, String] :block_token
+    #   The block token of the block from which to get data. You can obtain
+    #   the `BlockToken` by running the `ListChangedBlocks` or
     #   `ListSnapshotBlocks` operations.
     #
     # @return [Types::GetSnapshotBlockResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
@@ -612,6 +621,15 @@ module Aws::EBS
     # @option params [required, String] :snapshot_id
     #   The ID of the snapshot.
     #
+    #   If the specified snapshot is encrypted, you must have permission to
+    #   use the KMS key that was used to encrypt the snapshot. For more
+    #   information, see [ Using encryption][1] in the *Amazon Elastic Compute
+    #   Cloud User Guide*..
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ebsapis-using-encryption.html
+    #
     # @option params [required, Integer] :block_index
     #   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
@@ -705,13 +723,26 @@ module Aws::EBS
     #   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][1].
+    #   You can't specify **ParentSnapshotId** and **Encrypted** in the same
+    #   request. If you specify both parameters, the request fails with
+    #   `ValidationException`.
+    #
+    #   The encryption status of the snapshot depends on the values that you
+    #   specify for **Encrypted**, **KmsKeyArn**, and **ParentSnapshotId**,
+    #   and whether your Amazon Web Services account is enabled for [
+    #   encryption by default][1]. For more information, see [ Using
+    #   encryption][2] in the *Amazon Elastic Compute Cloud User Guide*.
     #
+    #   If you specify an encrypted parent snapshot, you must have permission
+    #   to use the KMS key that was used to encrypt the parent snapshot. For
+    #   more information, see [ Permissions to use Key Management Service
+    #   keys][3] in the *Amazon Elastic Compute Cloud User Guide*.
     #
     #
-    #   [1]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CopySnapshot.html
+    #
+    #   [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EBSEncryption.html#encryption-by-default
+    #   [2]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ebsapis-using-encryption.html
+    #   [3]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ebsapi-permissions.html#ebsapi-kms-permissions
     #
     # @option params [Array<Types::Tag>] :tags
     #   The tags to apply to the snapshot.
@@ -741,40 +772,47 @@ module Aws::EBS
     #   [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ebs-direct-api-idempotency.html
     #
     # @option params [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.
+    #   Indicates whether to encrypt the snapshot.
     #
-    #   If you specify `true`, the snapshot is encrypted using the KMS key
-    #   specified using the **KmsKeyArn** parameter. If no value is specified
-    #   for **KmsKeyArn**, the default KMS key for your account is used. If no
-    #   default KMS key has been specified for your account, the Amazon Web
-    #   Services managed KMS key is used. To set a default KMS key for your
-    #   account, use [ ModifyEbsDefaultKmsKeyId][1].
+    #   You can't specify **Encrypted** and <b> ParentSnapshotId</b> in the
+    #   same request. If you specify both parameters, the request fails with
+    #   `ValidationException`.
     #
-    #   If your account is enabled for encryption by default, you cannot set
-    #   this parameter to `false`. In this case, you can omit this parameter.
+    #   The encryption status of the snapshot depends on the values that you
+    #   specify for **Encrypted**, **KmsKeyArn**, and **ParentSnapshotId**,
+    #   and whether your Amazon Web Services account is enabled for [
+    #   encryption by default][1]. For more information, see [ Using
+    #   encryption][2] in the *Amazon Elastic Compute Cloud User Guide*.
     #
-    #   For more information, see [ Using encryption][2] in the *Amazon
-    #   Elastic Compute Cloud User Guide*.
+    #   To create an encrypted snapshot, you must have permission to use the
+    #   KMS key. For more information, see [ Permissions to use Key Management
+    #   Service keys][3] in the *Amazon Elastic Compute Cloud User Guide*.
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_ModifyEbsDefaultKmsKeyId.html
-    #   [2]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ebs-accessing-snapshot.html#ebsapis-using-encryption
+    #   [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EBSEncryption.html#encryption-by-default
+    #   [2]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ebsapis-using-encryption.html
+    #   [3]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ebsapi-permissions.html#ebsapi-kms-permissions
     #
     # @option params [String] :kms_key_arn
     #   The Amazon Resource Name (ARN) of the Key Management Service (KMS) key
-    #   to be used to encrypt the snapshot. If you do not specify a KMS key,
-    #   the default Amazon Web Services managed KMS key is used.
+    #   to be used to encrypt the snapshot.
+    #
+    #   The encryption status of the snapshot depends on the values that you
+    #   specify for **Encrypted**, **KmsKeyArn**, and **ParentSnapshotId**,
+    #   and whether your Amazon Web Services account is enabled for [
+    #   encryption by default][1]. For more information, see [ Using
+    #   encryption][2] in the *Amazon Elastic Compute Cloud User Guide*.
+    #
+    #   To create an encrypted snapshot, you must have permission to use the
+    #   KMS key. For more information, see [ Permissions to use Key Management
+    #   Service keys][3] in the *Amazon Elastic Compute Cloud User Guide*.
+    #
     #
-    #   If you specify a **ParentSnapshotId**, omit this parameter; the
-    #   snapshot will be encrypted using the same KMS key that was used to
-    #   encrypt the parent snapshot.
     #
-    #   If **Encrypted** is set to `true`, you must specify a KMS key ARN.
+    #   [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EBSEncryption.html#encryption-by-default
+    #   [2]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ebsapis-using-encryption.html
+    #   [3]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ebsapi-permissions.html#ebsapi-kms-permissions
     #
     # @option params [Integer] :timeout
     #   The amount of time (in minutes) after which the snapshot is
@@ -854,7 +892,7 @@ module Aws::EBS
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-ebs'
-      context[:gem_version] = '1.25.0'
+      context[:gem_version] = '1.26.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-ebs/types.rb

@@ -184,19 +184,28 @@ module Aws::EBS
     #
     # @!attribute [rw] snapshot_id
     #   The ID of the snapshot containing the block from which to get data.
+    #
+    #   If the specified snapshot is encrypted, you must have permission to
+    #   use the KMS key that was used to encrypt the snapshot. For more
+    #   information, see [ Using encryption][1] in the *Amazon Elastic
+    #   Compute Cloud User Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ebsapis-using-encryption.html
     #   @return [String]
     #
     # @!attribute [rw] block_index
-    #   The block index of the block from which to get data.
-    #
-    #   Obtain the `BlockIndex` by running the `ListChangedBlocks` or
-    #   `ListSnapshotBlocks` operations.
+    #   The block index of the block in which to read 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.
     #   @return [Integer]
     #
     # @!attribute [rw] block_token
-    #   The block token of the block from which to get data.
-    #
-    #   Obtain the `BlockToken` by running the `ListChangedBlocks` or
+    #   The block token of the block from which to get data. You can obtain
+    #   the `BlockToken` by running the `ListChangedBlocks` or
     #   `ListSnapshotBlocks` operations.
     #   @return [String]
     #
@@ -452,6 +461,15 @@ module Aws::EBS
     #
     # @!attribute [rw] snapshot_id
     #   The ID of the snapshot.
+    #
+    #   If the specified snapshot is encrypted, you must have permission to
+    #   use the KMS key that was used to encrypt the snapshot. For more
+    #   information, see [ Using encryption][1] in the *Amazon Elastic
+    #   Compute Cloud User Guide*..
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ebsapis-using-encryption.html
     #   @return [String]
     #
     # @!attribute [rw] block_index
@@ -618,13 +636,27 @@ module Aws::EBS
     #   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][1].
+    #   You can't specify **ParentSnapshotId** and **Encrypted** in the
+    #   same request. If you specify both parameters, the request fails with
+    #   `ValidationException`.
+    #
+    #   The encryption status of the snapshot depends on the values that you
+    #   specify for **Encrypted**, **KmsKeyArn**, and **ParentSnapshotId**,
+    #   and whether your Amazon Web Services account is enabled for [
+    #   encryption by default][1]. For more information, see [ Using
+    #   encryption][2] in the *Amazon Elastic Compute Cloud User Guide*.
+    #
+    #   If you specify an encrypted parent snapshot, you must have
+    #   permission to use the KMS key that was used to encrypt the parent
+    #   snapshot. For more information, see [ Permissions to use Key
+    #   Management Service keys][3] in the *Amazon Elastic Compute Cloud
+    #   User Guide*.
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CopySnapshot.html
+    #   [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EBSEncryption.html#encryption-by-default
+    #   [2]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ebsapis-using-encryption.html
+    #   [3]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ebsapi-permissions.html#ebsapi-kms-permissions
     #   @return [String]
     #
     # @!attribute [rw] tags
@@ -658,43 +690,50 @@ module Aws::EBS
     #   @return [String]
     #
     # @!attribute [rw] 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.
+    #   Indicates whether to encrypt the snapshot.
     #
-    #   If you specify `true`, the snapshot is encrypted using the KMS key
-    #   specified using the **KmsKeyArn** parameter. If no value is
-    #   specified for **KmsKeyArn**, the default KMS key for your account is
-    #   used. If no default KMS key has been specified for your account, the
-    #   Amazon Web Services managed KMS key is used. To set a default KMS
-    #   key for your account, use [ ModifyEbsDefaultKmsKeyId][1].
+    #   You can't specify **Encrypted** and <b> ParentSnapshotId</b> in the
+    #   same request. If you specify both parameters, the request fails with
+    #   `ValidationException`.
     #
-    #   If your account is enabled for encryption by default, you cannot set
-    #   this parameter to `false`. In this case, you can omit this
-    #   parameter.
+    #   The encryption status of the snapshot depends on the values that you
+    #   specify for **Encrypted**, **KmsKeyArn**, and **ParentSnapshotId**,
+    #   and whether your Amazon Web Services account is enabled for [
+    #   encryption by default][1]. For more information, see [ Using
+    #   encryption][2] in the *Amazon Elastic Compute Cloud User Guide*.
     #
-    #   For more information, see [ Using encryption][2] in the *Amazon
-    #   Elastic Compute Cloud User Guide*.
+    #   To create an encrypted snapshot, you must have permission to use the
+    #   KMS key. For more information, see [ Permissions to use Key
+    #   Management Service keys][3] in the *Amazon Elastic Compute Cloud
+    #   User Guide*.
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_ModifyEbsDefaultKmsKeyId.html
-    #   [2]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ebs-accessing-snapshot.html#ebsapis-using-encryption
+    #   [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EBSEncryption.html#encryption-by-default
+    #   [2]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ebsapis-using-encryption.html
+    #   [3]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ebsapi-permissions.html#ebsapi-kms-permissions
     #   @return [Boolean]
     #
     # @!attribute [rw] kms_key_arn
     #   The Amazon Resource Name (ARN) of the Key Management Service (KMS)
-    #   key to be used to encrypt the snapshot. If you do not specify a KMS
-    #   key, the default Amazon Web Services managed KMS key is used.
+    #   key to be used to encrypt the snapshot.
+    #
+    #   The encryption status of the snapshot depends on the values that you
+    #   specify for **Encrypted**, **KmsKeyArn**, and **ParentSnapshotId**,
+    #   and whether your Amazon Web Services account is enabled for [
+    #   encryption by default][1]. For more information, see [ Using
+    #   encryption][2] in the *Amazon Elastic Compute Cloud User Guide*.
+    #
+    #   To create an encrypted snapshot, you must have permission to use the
+    #   KMS key. For more information, see [ Permissions to use Key
+    #   Management Service keys][3] in the *Amazon Elastic Compute Cloud
+    #   User Guide*.
+    #
     #
-    #   If you specify a **ParentSnapshotId**, omit this parameter; the
-    #   snapshot will be encrypted using the same KMS key that was used to
-    #   encrypt the parent snapshot.
     #
-    #   If **Encrypted** is set to `true`, you must specify a KMS key ARN.
+    #   [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EBSEncryption.html#encryption-by-default
+    #   [2]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ebsapis-using-encryption.html
+    #   [3]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ebsapi-permissions.html#ebsapi-kms-permissions
     #   @return [String]
     #
     # @!attribute [rw] timeout

data/lib/aws-sdk-ebs.rb

@@ -48,6 +48,6 @@ require_relative 'aws-sdk-ebs/customizations'
 # @!group service
 module Aws::EBS
 
-  GEM_VERSION = '1.25.0'
+  GEM_VERSION = '1.26.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-ebs
 version: !ruby/object:Gem::Version
-  version: 1.25.0
+  version: 1.26.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-02-24 00:00:00.000000000 Z
+date: 2022-03-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core