aws-sdk-s3control 1.49.0 → 1.51.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1cb02c38b2c63293b68f27caf2457db9104a248e97b53083961058bd26ff339d
-  data.tar.gz: 330ca09c63c5b2c41fb37c5719c23d27d922fe7c07327190810542d562506445
+  metadata.gz: e5109e68962119d4a9a904aaa1582997ae67d3adf2922b6438009c4b23daa30a
+  data.tar.gz: fa51ee6943a793ef655b6d5c89f4aa4b3205ae42b708f765e29fe8b45662091c
 SHA512:
-  metadata.gz: a8bad92325555664ef66732d7766ee67087155d97644c28f85d1208cf1892b5a58e5aa7b252867cec083c9365e3161a97587e71dfdb7b103099cea8bb2470ed8
-  data.tar.gz: 5458363f38b23a5d1004475c5992e0a8236a21e99498b520bd53bb1ff7c76719772a62dfca77dc2321c59740e9d62048d0b78a4ba8eddc0f0fcf7909663400c8
+  metadata.gz: 02be32fd9ff470da7bbfb4090e7ece65eecb9fc392d74df42aac2c2f3cf205f82bb148691c703eccd94b2b1944c191a0e37978bed1c968bfa2fd9bb3c90c98dc
+  data.tar.gz: 4ac27366df7355c0a3764875b88a2624656b48a4667abf1fca62e6eb4b5f9753ed3dcb33ecba70d4314b65b440ffcc1a0001b7e307e506b5483a72fe8f9fbddc

data/CHANGELOG.md

@@ -1,6 +1,16 @@
 Unreleased Changes
 ------------------
 
+1.51.0 (2022-09-21)
+------------------
+
+* Feature - S3 on Outposts launches support for object versioning for Outposts buckets. With S3 Versioning, you can preserve, retrieve, and restore every version of every object stored in your buckets. You can recover from both unintended user actions and application failures.
+
+1.50.0 (2022-04-05)
+------------------
+
+* Feature - Documentation-only update for doc bug fixes for the S3 Control API docs.
+
 1.49.0 (2022-02-24)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.49.0
+1.51.0

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

@@ -379,11 +379,11 @@ module Aws::S3Control
     #
     # All Amazon S3 on Outposts REST API requests for this action require an
     # additional parameter of `x-amz-outpost-id` to be passed with the
-    # request and an S3 on Outposts endpoint hostname prefix instead of
-    # `s3-control`. For an example of the request syntax for Amazon S3 on
-    # Outposts that uses the S3 on Outposts endpoint hostname prefix and the
-    # `x-amz-outpost-id` derived using the access point ARN, see the
-    # [Examples][3] section.
+    # request. In addition, you must use an S3 on Outposts endpoint hostname
+    # prefix instead of `s3-control`. For an example of the request syntax
+    # for Amazon S3 on Outposts that uses the S3 on Outposts endpoint
+    # hostname prefix and the `x-amz-outpost-id` derived by using the access
+    # point ARN, see the [Examples][3] section.
     #
     #
     #
@@ -665,7 +665,7 @@ module Aws::S3Control
     # @option params [String] :outpost_id
     #   The ID of the Outposts where the bucket is being created.
     #
-    #   <note markdown="1"> This is required by Amazon S3 on Outposts buckets.
+    #   <note markdown="1"> This ID is required by Amazon S3 on Outposts buckets.
     #
     #    </note>
     #
@@ -1060,11 +1060,11 @@ module Aws::S3Control
     #
     # All Amazon S3 on Outposts REST API requests for this action require an
     # additional parameter of `x-amz-outpost-id` to be passed with the
-    # request and an S3 on Outposts endpoint hostname prefix instead of
-    # `s3-control`. For an example of the request syntax for Amazon S3 on
-    # Outposts that uses the S3 on Outposts endpoint hostname prefix and the
-    # `x-amz-outpost-id` derived using the access point ARN, see the
-    # [Examples][1] section.
+    # request. In addition, you must use an S3 on Outposts endpoint hostname
+    # prefix instead of `s3-control`. For an example of the request syntax
+    # for Amazon S3 on Outposts that uses the S3 on Outposts endpoint
+    # hostname prefix and the `x-amz-outpost-id` derived by using the access
+    # point ARN, see the [Examples][1] section.
     #
     # The following actions are related to `DeleteAccessPoint`\:
     #
@@ -1166,11 +1166,11 @@ module Aws::S3Control
     #
     # All Amazon S3 on Outposts REST API requests for this action require an
     # additional parameter of `x-amz-outpost-id` to be passed with the
-    # request and an S3 on Outposts endpoint hostname prefix instead of
-    # `s3-control`. For an example of the request syntax for Amazon S3 on
-    # Outposts that uses the S3 on Outposts endpoint hostname prefix and the
-    # `x-amz-outpost-id` derived using the access point ARN, see the
-    # [Examples][1] section.
+    # request. In addition, you must use an S3 on Outposts endpoint hostname
+    # prefix instead of `s3-control`. For an example of the request syntax
+    # for Amazon S3 on Outposts that uses the S3 on Outposts endpoint
+    # hostname prefix and the `x-amz-outpost-id` derived by using the access
+    # point ARN, see the [Examples][1] section.
     #
     # The following actions are related to `DeleteAccessPointPolicy`\:
     #
@@ -1273,11 +1273,11 @@ module Aws::S3Control
     #
     # All Amazon S3 on Outposts REST API requests for this action require an
     # additional parameter of `x-amz-outpost-id` to be passed with the
-    # request and an S3 on Outposts endpoint hostname prefix instead of
-    # `s3-control`. For an example of the request syntax for Amazon S3 on
-    # Outposts that uses the S3 on Outposts endpoint hostname prefix and the
-    # `x-amz-outpost-id` derived using the access point ARN, see the
-    # [Examples][3] section.
+    # request. In addition, you must use an S3 on Outposts endpoint hostname
+    # prefix instead of `s3-control`. For an example of the request syntax
+    # for Amazon S3 on Outposts that uses the S3 on Outposts endpoint
+    # hostname prefix and the `x-amz-outpost-id` derived by using the access
+    # point ARN, see the [Examples][3] section.
     #
     # **Related Resources**
     #
@@ -1354,11 +1354,11 @@ module Aws::S3Control
     #
     # All Amazon S3 on Outposts REST API requests for this action require an
     # additional parameter of `x-amz-outpost-id` to be passed with the
-    # request and an S3 on Outposts endpoint hostname prefix instead of
-    # `s3-control`. For an example of the request syntax for Amazon S3 on
-    # Outposts that uses the S3 on Outposts endpoint hostname prefix and the
-    # `x-amz-outpost-id` derived using the access point ARN, see the
-    # [Examples][3] section.
+    # request. In addition, you must use an S3 on Outposts endpoint hostname
+    # prefix instead of `s3-control`. For an example of the request syntax
+    # for Amazon S3 on Outposts that uses the S3 on Outposts endpoint
+    # hostname prefix and the `x-amz-outpost-id` derived by using the access
+    # point ARN, see the [Examples][3] section.
     #
     # For more information about object expiration, see [Elements to
     # Describe Lifecycle Actions][4].
@@ -1445,11 +1445,11 @@ module Aws::S3Control
     #
     # All Amazon S3 on Outposts REST API requests for this action require an
     # additional parameter of `x-amz-outpost-id` to be passed with the
-    # request and an S3 on Outposts endpoint hostname prefix instead of
-    # `s3-control`. For an example of the request syntax for Amazon S3 on
-    # Outposts that uses the S3 on Outposts endpoint hostname prefix and the
-    # `x-amz-outpost-id` derived using the access point ARN, see the
-    # [Examples][4] section.
+    # request. In addition, you must use an S3 on Outposts endpoint hostname
+    # prefix instead of `s3-control`. For an example of the request syntax
+    # for Amazon S3 on Outposts that uses the S3 on Outposts endpoint
+    # hostname prefix and the `x-amz-outpost-id` derived by using the access
+    # point ARN, see the [Examples][4] section.
     #
     # The following actions are related to `DeleteBucketPolicy`\:
     #
@@ -1518,11 +1518,11 @@ module Aws::S3Control
     #
     # All Amazon S3 on Outposts REST API requests for this action require an
     # additional parameter of `x-amz-outpost-id` to be passed with the
-    # request and an S3 on Outposts endpoint hostname prefix instead of
-    # `s3-control`. For an example of the request syntax for Amazon S3 on
-    # Outposts that uses the S3 on Outposts endpoint hostname prefix and the
-    # `x-amz-outpost-id` derived using the access point ARN, see the
-    # [Examples][3] section.
+    # request. In addition, you must use an S3 on Outposts endpoint hostname
+    # prefix instead of `s3-control`. For an example of the request syntax
+    # for Amazon S3 on Outposts that uses the S3 on Outposts endpoint
+    # hostname prefix and the `x-amz-outpost-id` derived by using the access
+    # point ARN, see the [Examples][3] section.
     #
     # The following actions are related to `DeleteBucketTagging`\:
     #
@@ -2053,11 +2053,11 @@ module Aws::S3Control
     #
     # All Amazon S3 on Outposts REST API requests for this action require an
     # additional parameter of `x-amz-outpost-id` to be passed with the
-    # request and an S3 on Outposts endpoint hostname prefix instead of
-    # `s3-control`. For an example of the request syntax for Amazon S3 on
-    # Outposts that uses the S3 on Outposts endpoint hostname prefix and the
-    # `x-amz-outpost-id` derived using the access point ARN, see the
-    # [Examples][1] section.
+    # request. In addition, you must use an S3 on Outposts endpoint hostname
+    # prefix instead of `s3-control`. For an example of the request syntax
+    # for Amazon S3 on Outposts that uses the S3 on Outposts endpoint
+    # hostname prefix and the `x-amz-outpost-id` derived by using the access
+    # point ARN, see the [Examples][1] section.
     #
     # The following actions are related to `GetAccessPoint`\:
     #
@@ -2441,11 +2441,11 @@ module Aws::S3Control
     #
     # All Amazon S3 on Outposts REST API requests for this action require an
     # additional parameter of `x-amz-outpost-id` to be passed with the
-    # request and an S3 on Outposts endpoint hostname prefix instead of
-    # `s3-control`. For an example of the request syntax for Amazon S3 on
-    # Outposts that uses the S3 on Outposts endpoint hostname prefix and the
-    # `x-amz-outpost-id` derived using the access point ARN, see the
-    # [Examples][2] section.
+    # request. In addition, you must use an S3 on Outposts endpoint hostname
+    # prefix instead of `s3-control`. For an example of the request syntax
+    # for Amazon S3 on Outposts that uses the S3 on Outposts endpoint
+    # hostname prefix and the `x-amz-outpost-id` derived by using the access
+    # point ARN, see the [Examples][2] section.
     #
     # * [PutObject][3]
     #
@@ -2528,11 +2528,11 @@ module Aws::S3Control
     #
     # All Amazon S3 on Outposts REST API requests for this action require an
     # additional parameter of `x-amz-outpost-id` to be passed with the
-    # request and an S3 on Outposts endpoint hostname prefix instead of
-    # `s3-control`. For an example of the request syntax for Amazon S3 on
-    # Outposts that uses the S3 on Outposts endpoint hostname prefix and the
-    # `x-amz-outpost-id` derived using the access point ARN, see the
-    # [Examples][6] section.
+    # request. In addition, you must use an S3 on Outposts endpoint hostname
+    # prefix instead of `s3-control`. For an example of the request syntax
+    # for Amazon S3 on Outposts that uses the S3 on Outposts endpoint
+    # hostname prefix and the `x-amz-outpost-id` derived by using the access
+    # point ARN, see the [Examples][6] section.
     #
     # `GetBucketLifecycleConfiguration` has the following special error:
     #
@@ -2657,11 +2657,11 @@ module Aws::S3Control
     #
     # All Amazon S3 on Outposts REST API requests for this action require an
     # additional parameter of `x-amz-outpost-id` to be passed with the
-    # request and an S3 on Outposts endpoint hostname prefix instead of
-    # `s3-control`. For an example of the request syntax for Amazon S3 on
-    # Outposts that uses the S3 on Outposts endpoint hostname prefix and the
-    # `x-amz-outpost-id` derived using the access point ARN, see the
-    # [Examples][4] section.
+    # request. In addition, you must use an S3 on Outposts endpoint hostname
+    # prefix instead of `s3-control`. For an example of the request syntax
+    # for Amazon S3 on Outposts that uses the S3 on Outposts endpoint
+    # hostname prefix and the `x-amz-outpost-id` derived by using the access
+    # point ARN, see the [Examples][4] section.
     #
     # The following actions are related to `GetBucketPolicy`\:
     #
@@ -2748,11 +2748,11 @@ module Aws::S3Control
     #
     # All Amazon S3 on Outposts REST API requests for this action require an
     # additional parameter of `x-amz-outpost-id` to be passed with the
-    # request and an S3 on Outposts endpoint hostname prefix instead of
-    # `s3-control`. For an example of the request syntax for Amazon S3 on
-    # Outposts that uses the S3 on Outposts endpoint hostname prefix and the
-    # `x-amz-outpost-id` derived using the access point ARN, see the
-    # [Examples][3] section.
+    # request. In addition, you must use an S3 on Outposts endpoint hostname
+    # prefix instead of `s3-control`. For an example of the request syntax
+    # for Amazon S3 on Outposts that uses the S3 on Outposts endpoint
+    # hostname prefix and the `x-amz-outpost-id` derived by using the access
+    # point ARN, see the [Examples][3] section.
     #
     # The following actions are related to `GetBucketTagging`\:
     #
@@ -2813,6 +2813,81 @@ module Aws::S3Control
       req.send_request(options)
     end
 
+    # <note markdown="1"> This operation returns the versioning state only for S3 on Outposts
+    # buckets. To return the versioning state for an S3 bucket, see
+    # [GetBucketVersioning][1] in the *Amazon S3 API Reference*.
+    #
+    #  </note>
+    #
+    # Returns the versioning state for an S3 on Outposts bucket. With
+    # versioning, you can save multiple distinct copies of your data and
+    # recover from unintended user actions and application failures.
+    #
+    # If you've never set versioning on your bucket, it has no versioning
+    # state. In that case, the `GetBucketVersioning` request does not return
+    # a versioning state value.
+    #
+    # For more information about versioning, see [Versioning][2] in the
+    # *Amazon S3 User Guide*.
+    #
+    # All Amazon S3 on Outposts REST API requests for this action require an
+    # additional parameter of `x-amz-outpost-id` to be passed with the
+    # request. In addition, you must use an S3 on Outposts endpoint hostname
+    # prefix instead of `s3-control`. For an example of the request syntax
+    # for Amazon S3 on Outposts that uses the S3 on Outposts endpoint
+    # hostname prefix and the `x-amz-outpost-id` derived by using the access
+    # point ARN, see the [Examples][3] section.
+    #
+    # The following operations are related to `GetBucketVersioning` for S3
+    # on Outposts.
+    #
+    # * [PutBucketVersioning][4]
+    #
+    # * [PutBucketLifecycleConfiguration][5]
+    #
+    # * [GetBucketLifecycleConfiguration][6]
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketVersioning.html
+    # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/Versioning.html
+    # [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_GetBucketVersioning.html#API_control_GetBucketVersioning_Examples
+    # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_PutBucketVersioning.html
+    # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_PutBucketLifecycleConfiguration.html
+    # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_GetBucketLifecycleConfiguration.html
+    #
+    # @option params [required, String] :account_id
+    #   The Amazon Web Services account ID of the S3 on Outposts bucket.
+    #
+    # @option params [required, String] :bucket
+    #   The S3 on Outposts bucket to return the versioning state for.
+    #
+    # @return [Types::GetBucketVersioningResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::GetBucketVersioningResult#status #status} => String
+    #   * {Types::GetBucketVersioningResult#mfa_delete #mfa_delete} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.get_bucket_versioning({
+    #     account_id: "AccountId", # required
+    #     bucket: "BucketName", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.status #=> String, one of "Enabled", "Suspended"
+    #   resp.mfa_delete #=> String, one of "Enabled", "Disabled"
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/s3control-2018-08-20/GetBucketVersioning AWS API Documentation
+    #
+    # @overload get_bucket_versioning(params = {})
+    # @param [Hash] params ({})
+    def get_bucket_versioning(params = {}, options = {})
+      req = build_request(:get_bucket_versioning, params)
+      req.send_request(options)
+    end
+
     # Returns the tags on an S3 Batch Operations job. To use this operation,
     # you must have permission to perform the `s3:GetJobTagging` action. For
     # more information, see [Controlling access and labeling jobs using
@@ -3242,11 +3317,11 @@ module Aws::S3Control
     #
     # All Amazon S3 on Outposts REST API requests for this action require an
     # additional parameter of `x-amz-outpost-id` to be passed with the
-    # request and an S3 on Outposts endpoint hostname prefix instead of
-    # `s3-control`. For an example of the request syntax for Amazon S3 on
-    # Outposts that uses the S3 on Outposts endpoint hostname prefix and the
-    # `x-amz-outpost-id` derived using the access point ARN, see the
-    # [Examples][1] section.
+    # request. In addition, you must use an S3 on Outposts endpoint hostname
+    # prefix instead of `s3-control`. For an example of the request syntax
+    # for Amazon S3 on Outposts that uses the S3 on Outposts endpoint
+    # hostname prefix and the `x-amz-outpost-id` derived by using the access
+    # point ARN, see the [Examples][1] section.
     #
     # The following actions are related to `ListAccessPoints`\:
     #
@@ -3586,9 +3661,9 @@ module Aws::S3Control
     # @option params [Integer] :max_results
     #
     # @option params [String] :outpost_id
-    #   The ID of the Outposts.
+    #   The ID of the Outposts resource.
     #
-    #   <note markdown="1"> This is required by Amazon S3 on Outposts buckets.
+    #   <note markdown="1"> This ID is required by Amazon S3 on Outposts buckets.
     #
     #    </note>
     #
@@ -3748,11 +3823,11 @@ module Aws::S3Control
     #
     # All Amazon S3 on Outposts REST API requests for this action require an
     # additional parameter of `x-amz-outpost-id` to be passed with the
-    # request and an S3 on Outposts endpoint hostname prefix instead of
-    # `s3-control`. For an example of the request syntax for Amazon S3 on
-    # Outposts that uses the S3 on Outposts endpoint hostname prefix and the
-    # `x-amz-outpost-id` derived using the access point ARN, see the
-    # [Examples][1] section.
+    # request. In addition, you must use an S3 on Outposts endpoint hostname
+    # prefix instead of `s3-control`. For an example of the request syntax
+    # for Amazon S3 on Outposts that uses the S3 on Outposts endpoint
+    # hostname prefix and the `x-amz-outpost-id` derived by using the access
+    # point ARN, see the [Examples][1] section.
     #
     # The following actions are related to `PutAccessPointPolicy`\:
     #
@@ -3876,11 +3951,11 @@ module Aws::S3Control
     #
     # All Amazon S3 on Outposts REST API requests for this action require an
     # additional parameter of `x-amz-outpost-id` to be passed with the
-    # request and an S3 on Outposts endpoint hostname prefix instead of
-    # `s3-control`. For an example of the request syntax for Amazon S3 on
-    # Outposts that uses the S3 on Outposts endpoint hostname prefix and the
-    # `x-amz-outpost-id` derived using the access point ARN, see the
-    # [Examples][2] section.
+    # request. In addition, you must use an S3 on Outposts endpoint hostname
+    # prefix instead of `s3-control`. For an example of the request syntax
+    # for Amazon S3 on Outposts that uses the S3 on Outposts endpoint
+    # hostname prefix and the `x-amz-outpost-id` derived by using the access
+    # point ARN, see the [Examples][2] section.
     #
     # The following actions are related to
     # `PutBucketLifecycleConfiguration`\:
@@ -4002,11 +4077,11 @@ module Aws::S3Control
     #
     # All Amazon S3 on Outposts REST API requests for this action require an
     # additional parameter of `x-amz-outpost-id` to be passed with the
-    # request and an S3 on Outposts endpoint hostname prefix instead of
-    # `s3-control`. For an example of the request syntax for Amazon S3 on
-    # Outposts that uses the S3 on Outposts endpoint hostname prefix and the
-    # `x-amz-outpost-id` derived using the access point ARN, see the
-    # [Examples][4] section.
+    # request. In addition, you must use an S3 on Outposts endpoint hostname
+    # prefix instead of `s3-control`. For an example of the request syntax
+    # for Amazon S3 on Outposts that uses the S3 on Outposts endpoint
+    # hostname prefix and the `x-amz-outpost-id` derived by using the access
+    # point ARN, see the [Examples][4] section.
     #
     # The following actions are related to `PutBucketPolicy`\:
     #
@@ -4139,11 +4214,11 @@ module Aws::S3Control
     #
     # All Amazon S3 on Outposts REST API requests for this action require an
     # additional parameter of `x-amz-outpost-id` to be passed with the
-    # request and an S3 on Outposts endpoint hostname prefix instead of
-    # `s3-control`. For an example of the request syntax for Amazon S3 on
-    # Outposts that uses the S3 on Outposts endpoint hostname prefix and the
-    # `x-amz-outpost-id` derived using the access point ARN, see the
-    # [Examples][9] section.
+    # request. In addition, you must use an S3 on Outposts endpoint hostname
+    # prefix instead of `s3-control`. For an example of the request syntax
+    # for Amazon S3 on Outposts that uses the S3 on Outposts endpoint
+    # hostname prefix and the `x-amz-outpost-id` derived by using the access
+    # point ARN, see the [Examples][9] section.
     #
     # The following actions are related to `PutBucketTagging`\:
     #
@@ -4212,6 +4287,106 @@ module Aws::S3Control
       req.send_request(options)
     end
 
+    # <note markdown="1"> This operation sets the versioning state only for S3 on Outposts
+    # buckets. To set the versioning state for an S3 bucket, see
+    # [PutBucketVersioning][1] in the *Amazon S3 API Reference*.
+    #
+    #  </note>
+    #
+    # Sets the versioning state for an S3 on Outposts bucket. With
+    # versioning, you can save multiple distinct copies of your data and
+    # recover from unintended user actions and application failures.
+    #
+    # You can set the versioning state to one of the following:
+    #
+    # * **Enabled** - Enables versioning for the objects in the bucket. All
+    #   objects added to the bucket receive a unique version ID.
+    #
+    # * **Suspended** - Suspends versioning for the objects in the bucket.
+    #   All objects added to the bucket receive the version ID `null`.
+    #
+    # If you've never set versioning on your bucket, it has no versioning
+    # state. In that case, a [ GetBucketVersioning][2] request does not
+    # return a versioning state value.
+    #
+    # When you enable S3 Versioning, for each object in your bucket, you
+    # have a current version and zero or more noncurrent versions. You can
+    # configure your bucket S3 Lifecycle rules to expire noncurrent versions
+    # after a specified time period. For more information, see [ Creating
+    # and managing a lifecycle configuration for your S3 on Outposts
+    # bucket][3] in the *Amazon S3 User Guide*.
+    #
+    # If you have an object expiration lifecycle policy in your
+    # non-versioned bucket and you want to maintain the same permanent
+    # delete behavior when you enable versioning, you must add a noncurrent
+    # expiration policy. The noncurrent expiration lifecycle policy will
+    # manage the deletes of the noncurrent object versions in the
+    # version-enabled bucket. For more information, see [Versioning][4] in
+    # the *Amazon S3 User Guide*.
+    #
+    # All Amazon S3 on Outposts REST API requests for this action require an
+    # additional parameter of `x-amz-outpost-id` to be passed with the
+    # request. In addition, you must use an S3 on Outposts endpoint hostname
+    # prefix instead of `s3-control`. For an example of the request syntax
+    # for Amazon S3 on Outposts that uses the S3 on Outposts endpoint
+    # hostname prefix and the `x-amz-outpost-id` derived by using the access
+    # point ARN, see the [Examples][5] section.
+    #
+    # The following operations are related to `PutBucketVersioning` for S3
+    # on Outposts.
+    #
+    # * [GetBucketVersioning][2]
+    #
+    # * [PutBucketLifecycleConfiguration][6]
+    #
+    # * [GetBucketLifecycleConfiguration][7]
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketVersioning.html
+    # [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_GetBucketVersioning.html
+    # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3OutpostsLifecycleManaging.html
+    # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/Versioning.html
+    # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_PutBucketVersioning.html#API_control_PutBucketVersioning_Examples
+    # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_PutBucketLifecycleConfiguration.html
+    # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_GetBucketLifecycleConfiguration.html
+    #
+    # @option params [required, String] :account_id
+    #   The Amazon Web Services account ID of the S3 on Outposts bucket.
+    #
+    # @option params [required, String] :bucket
+    #   The S3 on Outposts bucket to set the versioning state for.
+    #
+    # @option params [String] :mfa
+    #   The concatenation of the authentication device's serial number, a
+    #   space, and the value that is displayed on your authentication device.
+    #
+    # @option params [required, Types::VersioningConfiguration] :versioning_configuration
+    #   The root-level tag for the `VersioningConfiguration` parameters.
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.put_bucket_versioning({
+    #     account_id: "AccountId", # required
+    #     bucket: "BucketName", # required
+    #     mfa: "MFA",
+    #     versioning_configuration: { # required
+    #       mfa_delete: "Enabled", # accepts Enabled, Disabled
+    #       status: "Enabled", # accepts Enabled, Suspended
+    #     },
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/s3control-2018-08-20/PutBucketVersioning AWS API Documentation
+    #
+    # @overload put_bucket_versioning(params = {})
+    # @param [Hash] params ({})
+    def put_bucket_versioning(params = {}, options = {})
+      req = build_request(:put_bucket_versioning, params)
+      req.send_request(options)
+    end
+
     # Sets the supplied tag-set on an S3 Batch Operations job.
     #
     # A tag is a key-value pair. You can associate S3 Batch Operations tags
@@ -4260,7 +4435,7 @@ module Aws::S3Control
     #
     # Related actions include:
     #
-    # * [CreatJob][6]
+    # * [CreateJob][6]
     #
     # * [GetJobTagging][1]
     #
@@ -4377,7 +4552,7 @@ module Aws::S3Control
 
     # Creates or modifies the `PublicAccessBlock` configuration for an
     # Amazon Web Services account. For this operation, users must have the
-    # `s3:PutBucketPublicAccessBlock` permission. For more information, see
+    # `s3:PutAccountPublicAccessBlock` permission. For more information, see
     # [ Using Amazon S3 block public access][1].
     #
     # Related actions include:
@@ -4731,7 +4906,7 @@ module Aws::S3Control
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-s3control'
-      context[:gem_version] = '1.49.0'
+      context[:gem_version] = '1.51.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-s3control/client_api.rb

@@ -40,6 +40,7 @@ module Aws::S3Control
     BucketLevel = Shapes::StructureShape.new(name: 'BucketLevel')
     BucketLocationConstraint = Shapes::StringShape.new(name: 'BucketLocationConstraint')
     BucketName = Shapes::StringShape.new(name: 'BucketName')
+    BucketVersioningStatus = Shapes::StringShape.new(name: 'BucketVersioningStatus')
     Buckets = Shapes::ListShape.new(name: 'Buckets')
     CloudWatchMetrics = Shapes::StructureShape.new(name: 'CloudWatchMetrics')
     ConfigId = Shapes::StringShape.new(name: 'ConfigId')
@@ -116,6 +117,8 @@ module Aws::S3Control
     GetBucketResult = Shapes::StructureShape.new(name: 'GetBucketResult')
     GetBucketTaggingRequest = Shapes::StructureShape.new(name: 'GetBucketTaggingRequest')
     GetBucketTaggingResult = Shapes::StructureShape.new(name: 'GetBucketTaggingResult')
+    GetBucketVersioningRequest = Shapes::StructureShape.new(name: 'GetBucketVersioningRequest')
+    GetBucketVersioningResult = Shapes::StructureShape.new(name: 'GetBucketVersioningResult')
     GetJobTaggingRequest = Shapes::StructureShape.new(name: 'GetJobTaggingRequest')
     GetJobTaggingResult = Shapes::StructureShape.new(name: 'GetJobTaggingResult')
     GetMultiRegionAccessPointPolicyRequest = Shapes::StructureShape.new(name: 'GetMultiRegionAccessPointPolicyRequest')
@@ -200,6 +203,9 @@ module Aws::S3Control
     ListStorageLensConfigurationsRequest = Shapes::StructureShape.new(name: 'ListStorageLensConfigurationsRequest')
     ListStorageLensConfigurationsResult = Shapes::StructureShape.new(name: 'ListStorageLensConfigurationsResult')
     Location = Shapes::StringShape.new(name: 'Location')
+    MFA = Shapes::StringShape.new(name: 'MFA')
+    MFADelete = Shapes::StringShape.new(name: 'MFADelete')
+    MFADeleteStatus = Shapes::StringShape.new(name: 'MFADeleteStatus')
     ManifestPrefixString = Shapes::StringShape.new(name: 'ManifestPrefixString')
     MaxLength1024String = Shapes::StringShape.new(name: 'MaxLength1024String')
     MaxResults = Shapes::IntegerShape.new(name: 'MaxResults')
@@ -257,6 +263,7 @@ module Aws::S3Control
     PutBucketLifecycleConfigurationRequest = Shapes::StructureShape.new(name: 'PutBucketLifecycleConfigurationRequest')
     PutBucketPolicyRequest = Shapes::StructureShape.new(name: 'PutBucketPolicyRequest')
     PutBucketTaggingRequest = Shapes::StructureShape.new(name: 'PutBucketTaggingRequest')
+    PutBucketVersioningRequest = Shapes::StructureShape.new(name: 'PutBucketVersioningRequest')
     PutJobTaggingRequest = Shapes::StructureShape.new(name: 'PutJobTaggingRequest')
     PutJobTaggingResult = Shapes::StructureShape.new(name: 'PutJobTaggingResult')
     PutMultiRegionAccessPointPolicyInput = Shapes::StructureShape.new(name: 'PutMultiRegionAccessPointPolicyInput')
@@ -354,6 +361,7 @@ module Aws::S3Control
     UpdateJobPriorityResult = Shapes::StructureShape.new(name: 'UpdateJobPriorityResult')
     UpdateJobStatusRequest = Shapes::StructureShape.new(name: 'UpdateJobStatusRequest')
     UpdateJobStatusResult = Shapes::StructureShape.new(name: 'UpdateJobStatusResult')
+    VersioningConfiguration = Shapes::StructureShape.new(name: 'VersioningConfiguration')
     VpcConfiguration = Shapes::StructureShape.new(name: 'VpcConfiguration')
     VpcId = Shapes::StringShape.new(name: 'VpcId')
 
@@ -668,6 +676,14 @@ module Aws::S3Control
     GetBucketTaggingResult.add_member(:tag_set, Shapes::ShapeRef.new(shape: S3TagSet, required: true, location_name: "TagSet"))
     GetBucketTaggingResult.struct_class = Types::GetBucketTaggingResult
 
+    GetBucketVersioningRequest.add_member(:account_id, Shapes::ShapeRef.new(shape: AccountId, required: true, location: "header", location_name: "x-amz-account-id", metadata: {"hostLabel"=>true, "hostLabelName"=>"AccountId"}))
+    GetBucketVersioningRequest.add_member(:bucket, Shapes::ShapeRef.new(shape: BucketName, required: true, location: "uri", location_name: "name"))
+    GetBucketVersioningRequest.struct_class = Types::GetBucketVersioningRequest
+
+    GetBucketVersioningResult.add_member(:status, Shapes::ShapeRef.new(shape: BucketVersioningStatus, location_name: "Status"))
+    GetBucketVersioningResult.add_member(:mfa_delete, Shapes::ShapeRef.new(shape: MFADeleteStatus, location_name: "MfaDelete"))
+    GetBucketVersioningResult.struct_class = Types::GetBucketVersioningResult
+
     GetJobTaggingRequest.add_member(:account_id, Shapes::ShapeRef.new(shape: AccountId, required: true, location: "header", location_name: "x-amz-account-id", metadata: {"hostLabel"=>true, "hostLabelName"=>"AccountId"}))
     GetJobTaggingRequest.add_member(:job_id, Shapes::ShapeRef.new(shape: JobId, required: true, location: "uri", location_name: "id"))
     GetJobTaggingRequest.struct_class = Types::GetJobTaggingRequest
@@ -1048,6 +1064,14 @@ module Aws::S3Control
     PutBucketTaggingRequest[:payload] = :tagging
     PutBucketTaggingRequest[:payload_member] = PutBucketTaggingRequest.member(:tagging)
 
+    PutBucketVersioningRequest.add_member(:account_id, Shapes::ShapeRef.new(shape: AccountId, required: true, location: "header", location_name: "x-amz-account-id", metadata: {"hostLabel"=>true, "hostLabelName"=>"AccountId"}))
+    PutBucketVersioningRequest.add_member(:bucket, Shapes::ShapeRef.new(shape: BucketName, required: true, location: "uri", location_name: "name"))
+    PutBucketVersioningRequest.add_member(:mfa, Shapes::ShapeRef.new(shape: MFA, location: "header", location_name: "x-amz-mfa"))
+    PutBucketVersioningRequest.add_member(:versioning_configuration, Shapes::ShapeRef.new(shape: VersioningConfiguration, required: true, location_name: "VersioningConfiguration", metadata: {"xmlNamespace"=>{"uri"=>"http://awss3control.amazonaws.com/doc/2018-08-20/"}}))
+    PutBucketVersioningRequest.struct_class = Types::PutBucketVersioningRequest
+    PutBucketVersioningRequest[:payload] = :versioning_configuration
+    PutBucketVersioningRequest[:payload_member] = PutBucketVersioningRequest.member(:versioning_configuration)
+
     PutJobTaggingRequest.add_member(:account_id, Shapes::ShapeRef.new(shape: AccountId, required: true, location: "header", location_name: "x-amz-account-id", metadata: {"hostLabel"=>true, "hostLabelName"=>"AccountId"}))
     PutJobTaggingRequest.add_member(:job_id, Shapes::ShapeRef.new(shape: JobId, required: true, location: "uri", location_name: "id"))
     PutJobTaggingRequest.add_member(:tags, Shapes::ShapeRef.new(shape: S3TagSet, required: true, location_name: "Tags"))
@@ -1309,6 +1333,10 @@ module Aws::S3Control
     UpdateJobStatusResult.add_member(:status_update_reason, Shapes::ShapeRef.new(shape: JobStatusUpdateReason, location_name: "StatusUpdateReason"))
     UpdateJobStatusResult.struct_class = Types::UpdateJobStatusResult
 
+    VersioningConfiguration.add_member(:mfa_delete, Shapes::ShapeRef.new(shape: MFADelete, location_name: "MfaDelete"))
+    VersioningConfiguration.add_member(:status, Shapes::ShapeRef.new(shape: BucketVersioningStatus, location_name: "Status"))
+    VersioningConfiguration.struct_class = Types::VersioningConfiguration
+
     VpcConfiguration.add_member(:vpc_id, Shapes::ShapeRef.new(shape: VpcId, required: true, location_name: "VpcId"))
     VpcConfiguration.struct_class = Types::VpcConfiguration
 
@@ -1709,6 +1737,17 @@ module Aws::S3Control
         o.output = Shapes::ShapeRef.new(shape: GetBucketTaggingResult)
       end)
 
+      api.add_operation(:get_bucket_versioning, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "GetBucketVersioning"
+        o.http_method = "GET"
+        o.http_request_uri = "/v20180820/bucket/{name}/versioning"
+        o.endpoint_pattern = {
+          "hostPrefix" => "{AccountId}.",
+        }
+        o.input = Shapes::ShapeRef.new(shape: GetBucketVersioningRequest)
+        o.output = Shapes::ShapeRef.new(shape: GetBucketVersioningResult)
+      end)
+
       api.add_operation(:get_job_tagging, Seahorse::Model::Operation.new.tap do |o|
         o.name = "GetJobTagging"
         o.http_method = "GET"
@@ -1987,6 +2026,18 @@ module Aws::S3Control
         o.output = Shapes::ShapeRef.new(shape: Shapes::StructureShape.new(struct_class: Aws::EmptyStructure))
       end)
 
+      api.add_operation(:put_bucket_versioning, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "PutBucketVersioning"
+        o.http_method = "PUT"
+        o.http_request_uri = "/v20180820/bucket/{name}/versioning"
+        o.http_checksum_required = true
+        o.endpoint_pattern = {
+          "hostPrefix" => "{AccountId}.",
+        }
+        o.input = Shapes::ShapeRef.new(shape: PutBucketVersioningRequest)
+        o.output = Shapes::ShapeRef.new(shape: Shapes::StructureShape.new(struct_class: Aws::EmptyStructure))
+      end)
+
       api.add_operation(:put_job_tagging, Seahorse::Model::Operation.new.tap do |o|
         o.name = "PutJobTagging"
         o.http_method = "PUT"

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

@@ -154,7 +154,7 @@ module Aws::S3Control
     #   @return [String]
     #
     # @!attribute [rw] message
-    #   A generic descritpion of the error condition in English.
+    #   A generic description of the error condition in English.
     #   @return [String]
     #
     # @!attribute [rw] resource
@@ -677,7 +677,7 @@ module Aws::S3Control
     # @!attribute [rw] outpost_id
     #   The ID of the Outposts where the bucket is being created.
     #
-    #   <note markdown="1"> This is required by Amazon S3 on Outposts buckets.
+    #   <note markdown="1"> This ID is required by Amazon S3 on Outposts buckets.
     #
     #    </note>
     #   @return [String]
@@ -2332,6 +2332,51 @@ module Aws::S3Control
       include Aws::Structure
     end
 
+    # @note When making an API call, you may pass GetBucketVersioningRequest
+    #   data as a hash:
+    #
+    #       {
+    #         account_id: "AccountId", # required
+    #         bucket: "BucketName", # required
+    #       }
+    #
+    # @!attribute [rw] account_id
+    #   The Amazon Web Services account ID of the S3 on Outposts bucket.
+    #   @return [String]
+    #
+    # @!attribute [rw] bucket
+    #   The S3 on Outposts bucket to return the versioning state for.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/s3control-2018-08-20/GetBucketVersioningRequest AWS API Documentation
+    #
+    class GetBucketVersioningRequest < Struct.new(
+      :account_id,
+      :bucket)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] status
+    #   The versioning state of the S3 on Outposts bucket.
+    #   @return [String]
+    #
+    # @!attribute [rw] mfa_delete
+    #   Specifies whether MFA delete is enabled in the bucket versioning
+    #   configuration. This element is returned only if the bucket has been
+    #   configured with MFA delete. If MFA delete has never been configured
+    #   for the bucket, this element is not returned.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/s3control-2018-08-20/GetBucketVersioningResult AWS API Documentation
+    #
+    class GetBucketVersioningResult < Struct.new(
+      :status,
+      :mfa_delete)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @note When making an API call, you may pass GetJobTaggingRequest
     #   data as a hash:
     #
@@ -3977,9 +4022,9 @@ module Aws::S3Control
     #   @return [Integer]
     #
     # @!attribute [rw] outpost_id
-    #   The ID of the Outposts.
+    #   The ID of the Outposts resource.
     #
-    #   <note markdown="1"> This is required by Amazon S3 on Outposts buckets.
+    #   <note markdown="1"> This ID is required by Amazon S3 on Outposts buckets.
     #
     #    </note>
     #   @return [String]
@@ -4177,7 +4222,7 @@ module Aws::S3Control
     #   The current status of the Multi-Region Access Point.
     #
     #   `CREATING` and `DELETING` are temporary states that exist while the
-    #   request is propogating and being completed. If a Multi-Region Access
+    #   request is propagating and being completed. If a Multi-Region Access
     #   Point has a status of `PARTIALLY_CREATED`, you can retry creation or
     #   send a request to delete the Multi-Region Access Point. If a
     #   Multi-Region Access Point has a status of `PARTIALLY_DELETED`, you
@@ -4940,6 +4985,48 @@ module Aws::S3Control
       include Aws::Structure
     end
 
+    # @note When making an API call, you may pass PutBucketVersioningRequest
+    #   data as a hash:
+    #
+    #       {
+    #         account_id: "AccountId", # required
+    #         bucket: "BucketName", # required
+    #         mfa: "MFA",
+    #         versioning_configuration: { # required
+    #           mfa_delete: "Enabled", # accepts Enabled, Disabled
+    #           status: "Enabled", # accepts Enabled, Suspended
+    #         },
+    #       }
+    #
+    # @!attribute [rw] account_id
+    #   The Amazon Web Services account ID of the S3 on Outposts bucket.
+    #   @return [String]
+    #
+    # @!attribute [rw] bucket
+    #   The S3 on Outposts bucket to set the versioning state for.
+    #   @return [String]
+    #
+    # @!attribute [rw] mfa
+    #   The concatenation of the authentication device's serial number, a
+    #   space, and the value that is displayed on your authentication
+    #   device.
+    #   @return [String]
+    #
+    # @!attribute [rw] versioning_configuration
+    #   The root-level tag for the `VersioningConfiguration` parameters.
+    #   @return [Types::VersioningConfiguration]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/s3control-2018-08-20/PutBucketVersioningRequest AWS API Documentation
+    #
+    class PutBucketVersioningRequest < Struct.new(
+      :account_id,
+      :bucket,
+      :mfa,
+      :versioning_configuration)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @note When making an API call, you may pass PutJobTaggingRequest
     #   data as a hash:
     #
@@ -5570,8 +5657,8 @@ module Aws::S3Control
     # @!attribute [rw] target_key_prefix
     #   Specifies the folder prefix into which you would like the objects to
     #   be copied. For example, to copy objects into a folder named
-    #   "Folder1" in the destination bucket, set the TargetKeyPrefix to
-    #   "Folder1/".
+    #   `Folder1` in the destination bucket, set the TargetKeyPrefix to
+    #   `Folder1`.
     #   @return [String]
     #
     # @!attribute [rw] object_lock_legal_hold_status
@@ -6270,8 +6357,8 @@ module Aws::S3Control
     #
     # @!attribute [rw] key_id
     #   Specifies the ID of the Amazon Web Services Key Management Service
-    #   (Amazon Web Services KMS) symmetric customer managed key to use for
-    #   encrypting generated manifest objects.
+    #   (Amazon Web Services KMS) symmetric encryption customer managed key
+    #   to use for encrypting generated manifest objects.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/s3control-2018-08-20/SSEKMSEncryption AWS API Documentation
@@ -6782,6 +6869,39 @@ module Aws::S3Control
       include Aws::Structure
     end
 
+    # Describes the versioning state of an Amazon S3 on Outposts bucket. For
+    # more information, see [PutBucketVersioning][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_PutBucketVersioning.html
+    #
+    # @note When making an API call, you may pass VersioningConfiguration
+    #   data as a hash:
+    #
+    #       {
+    #         mfa_delete: "Enabled", # accepts Enabled, Disabled
+    #         status: "Enabled", # accepts Enabled, Suspended
+    #       }
+    #
+    # @!attribute [rw] mfa_delete
+    #   Specifies whether MFA delete is enabled or disabled in the bucket
+    #   versioning configuration for the S3 on Outposts bucket.
+    #   @return [String]
+    #
+    # @!attribute [rw] status
+    #   Sets the versioning state of the S3 on Outposts bucket.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/s3control-2018-08-20/VersioningConfiguration AWS API Documentation
+    #
+    class VersioningConfiguration < Struct.new(
+      :mfa_delete,
+      :status)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # The virtual private cloud (VPC) configuration for an access point.
     #
     # @note When making an API call, you may pass VpcConfiguration

data/lib/aws-sdk-s3control.rb

@@ -48,6 +48,6 @@ require_relative 'aws-sdk-s3control/customizations'
 # @!group service
 module Aws::S3Control
 
-  GEM_VERSION = '1.49.0'
+  GEM_VERSION = '1.51.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-s3control
 version: !ruby/object:Gem::Version
-  version: 1.49.0
+  version: 1.51.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-02-24 00:00:00.000000000 Z
+date: 2022-09-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sigv4