aws-sdk-fsx 1.114.0 → 1.116.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ca9b00f6961fc30a8e2c8d331958978e223d213a5ad3d5e043238d4a88fc07e6
-  data.tar.gz: 2a2d85c663b144020bd4a31260cc18a04a980aeb42f2ea1805af0de8d439e547
+  metadata.gz: 114a0dabdfd9da1384c591a6c1d53aefb0ad8c7849e40b5501b34caec33ebb8b
+  data.tar.gz: b87f4f80304d1a2a4a0eb2ef7a39c9656baef4de67928e964d47a0784cdb39d7
 SHA512:
-  metadata.gz: 86704db640c935d7b63c6a56bfd595f24d0431698de54558a37bd60de7bea0c37d93a0d7731d9b078d9b39a002915825de5fec7332775ed1f452449747e0b156
-  data.tar.gz: fae36715f598392c3d1cd287399d36a873f039d6283f5a90f423729882e81f84942a3cfab1c01350836c9043bc00760c259cb70f702a77d0fe47641af00c3fa5
+  metadata.gz: 89f38de77103aba43845418e318b5d490fefb511bb742f59c839f1eb39b37ae70b3d54b69427e96983e4b6bc9837b27bad5d1bfc23881b29f0502562c32b820d
+  data.tar.gz: ed837672931c0e2db7387c3a52b02ec967a98f68e30ac70e71e6c692c3597f8cc4bee03498b0ef90524f4b5ffb8357ee309aa3ea3d595e2680f0ffbf2824b78f

data/CHANGELOG.md

@@ -1,6 +1,16 @@
 Unreleased Changes
 ------------------
 
+1.116.0 (2025-07-21)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
+1.115.0 (2025-06-25)
+------------------
+
+* Feature - Add support for the ability to create Amazon S3 Access Points for Amazon FSx for OpenZFS file systems.
+
 1.114.0 (2025-06-02)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.114.0
+1.116.0

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

@@ -95,7 +95,7 @@ module Aws::FSx
     #     class name or an instance of a plugin class.
     #
     #   @option options [required, Aws::CredentialProvider] :credentials
-    #     Your AWS credentials. This can be an instance of any one of the
+    #     Your AWS credentials used for authentication. This can be an instance of any one of the
     #     following classes:
     #
     #     * `Aws::Credentials` - Used for configuring static, non-refreshing
@@ -128,18 +128,23 @@ module Aws::FSx
     #     locations will be searched for credentials:
     #
     #     * `Aws.config[:credentials]`
+    #
     #     * The `:access_key_id`, `:secret_access_key`, `:session_token`, and
     #       `:account_id` options.
-    #     * ENV['AWS_ACCESS_KEY_ID'], ENV['AWS_SECRET_ACCESS_KEY'],
-    #       ENV['AWS_SESSION_TOKEN'], and ENV['AWS_ACCOUNT_ID']
+    #
+    #     * `ENV['AWS_ACCESS_KEY_ID']`, `ENV['AWS_SECRET_ACCESS_KEY']`,
+    #       `ENV['AWS_SESSION_TOKEN']`, and `ENV['AWS_ACCOUNT_ID']`.
+    #
     #     * `~/.aws/credentials`
+    #
     #     * `~/.aws/config`
+    #
     #     * EC2/ECS IMDS instance profile - When used by default, the timeouts
     #       are very aggressive. Construct and pass an instance of
     #       `Aws::InstanceProfileCredentials` or `Aws::ECSCredentials` to
     #       enable retries and extended timeouts. Instance profile credential
-    #       fetching can be disabled by setting ENV['AWS_EC2_METADATA_DISABLED']
-    #       to true.
+    #       fetching can be disabled by setting `ENV['AWS_EC2_METADATA_DISABLED']`
+    #       to `true`.
     #
     #   @option options [required, String] :region
     #     The AWS region to connect to.  The configured `:region` is
@@ -167,6 +172,11 @@ module Aws::FSx
     #     When false, the request will raise a `RetryCapacityNotAvailableError` and will
     #     not retry instead of sleeping.
     #
+    #   @option options [Array<String>] :auth_scheme_preference
+    #     A list of preferred authentication schemes to use when making a request. Supported values are:
+    #     `sigv4`, `sigv4a`, `httpBearerAuth`, and `noAuth`. When set using `ENV['AWS_AUTH_SCHEME_PREFERENCE']` or in
+    #     shared config as `auth_scheme_preference`, the value should be a comma-separated list.
+    #
     #   @option options [Boolean] :client_side_monitoring (false)
     #     When `true`, client-side metrics will be collected for all API requests from
     #     this client.
@@ -253,8 +263,8 @@ module Aws::FSx
     #     4 times. Used in `standard` and `adaptive` retry modes.
     #
     #   @option options [String] :profile ("default")
-    #     Used when loading credentials from the shared credentials file
-    #     at HOME/.aws/credentials.  When not specified, 'default' is used.
+    #     Used when loading credentials from the shared credentials file at `HOME/.aws/credentials`.
+    #     When not specified, 'default' is used.
     #
     #   @option options [String] :request_checksum_calculation ("when_supported")
     #     Determines when a checksum will be calculated for request payloads. Values are:
@@ -374,7 +384,7 @@ module Aws::FSx
     #     `Aws::Telemetry::OTelProvider` for telemetry provider.
     #
     #   @option options [Aws::TokenProvider] :token_provider
-    #     A Bearer Token Provider. This can be an instance of any one of the
+    #     Your Bearer token used for authentication. This can be an instance of any one of the
     #     following classes:
     #
     #     * `Aws::StaticTokenProvider` - Used for configuring static, non-refreshing
@@ -1473,6 +1483,117 @@ module Aws::FSx
       req.send_request(options)
     end
 
+    # Creates an S3 access point and attaches it to an Amazon FSx volume.
+    # For FSx for OpenZFS file systems, the volume must be hosted on a
+    # high-availability file system, either Single-AZ or Multi-AZ. For more
+    # information, see [Accessing your data using access
+    # points](fsx/latest/OpenZFSGuide/s3accesspoints-for-FSx.html) in the
+    # Amazon FSx for OpenZFS User Guide.
+    #
+    # The requester requires the following permissions to perform these
+    # actions:
+    #
+    # * `fsx:CreateAndAttachS3AccessPoint`
+    #
+    # * `s3:CreateAccessPoint`
+    #
+    # * `s3:GetAccessPoint`
+    #
+    # * `s3:PutAccessPointPolicy`
+    #
+    # * `s3:DeleteAccessPoint`
+    #
+    # The following actions are related to `CreateAndAttachS3AccessPoint`:
+    #
+    # * DescribeS3AccessPointAttachments
+    #
+    # * DetachAndDeleteS3AccessPoint
+    #
+    # @option params [String] :client_request_token
+    #   (Optional) An idempotency token for resource creation, in a string of
+    #   up to 63 ASCII characters. This token is automatically filled on your
+    #   behalf when you use the Command Line Interface (CLI) or an Amazon Web
+    #   Services SDK.
+    #
+    #   **A suitable default value is auto-generated.** You should normally
+    #   not need to pass this option.**
+    #
+    # @option params [required, String] :name
+    #   The name you want to assign to this S3 access point.
+    #
+    # @option params [required, String] :type
+    #   The type of S3 access point you want to create. Only `OpenZFS` is
+    #   supported.
+    #
+    # @option params [Types::CreateAndAttachS3AccessPointOpenZFSConfiguration] :open_zfs_configuration
+    #   Specifies the configuration to use when creating and attaching an S3
+    #   access point to an FSx for OpenZFS volume.
+    #
+    # @option params [Types::CreateAndAttachS3AccessPointS3Configuration] :s3_access_point
+    #   Specifies the virtual private cloud (VPC) configuration if you're
+    #   creating an access point that is restricted to a VPC. For more
+    #   information, see [Creating access points restricted to a virtual
+    #   private cloud][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/fsx/latest/OpenZFSGuide/access-points-vpc.html
+    #
+    # @return [Types::CreateAndAttachS3AccessPointResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::CreateAndAttachS3AccessPointResponse#s3_access_point_attachment #s3_access_point_attachment} => Types::S3AccessPointAttachment
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.create_and_attach_s3_access_point({
+    #     client_request_token: "ClientRequestToken",
+    #     name: "S3AccessPointAttachmentName", # required
+    #     type: "OPENZFS", # required, accepts OPENZFS
+    #     open_zfs_configuration: {
+    #       volume_id: "VolumeId", # required
+    #       file_system_identity: { # required
+    #         type: "POSIX", # required, accepts POSIX
+    #         posix_user: {
+    #           uid: 1, # required
+    #           gid: 1, # required
+    #           secondary_gids: [1],
+    #         },
+    #       },
+    #     },
+    #     s3_access_point: {
+    #       vpc_configuration: {
+    #         vpc_id: "VpcId",
+    #       },
+    #       policy: "AccessPointPolicy",
+    #     },
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.s3_access_point_attachment.lifecycle #=> String, one of "AVAILABLE", "CREATING", "DELETING", "UPDATING", "FAILED"
+    #   resp.s3_access_point_attachment.lifecycle_transition_reason.message #=> String
+    #   resp.s3_access_point_attachment.creation_time #=> Time
+    #   resp.s3_access_point_attachment.name #=> String
+    #   resp.s3_access_point_attachment.type #=> String, one of "OPENZFS"
+    #   resp.s3_access_point_attachment.open_zfs_configuration.volume_id #=> String
+    #   resp.s3_access_point_attachment.open_zfs_configuration.file_system_identity.type #=> String, one of "POSIX"
+    #   resp.s3_access_point_attachment.open_zfs_configuration.file_system_identity.posix_user.uid #=> Integer
+    #   resp.s3_access_point_attachment.open_zfs_configuration.file_system_identity.posix_user.gid #=> Integer
+    #   resp.s3_access_point_attachment.open_zfs_configuration.file_system_identity.posix_user.secondary_gids #=> Array
+    #   resp.s3_access_point_attachment.open_zfs_configuration.file_system_identity.posix_user.secondary_gids[0] #=> Integer
+    #   resp.s3_access_point_attachment.s3_access_point.resource_arn #=> String
+    #   resp.s3_access_point_attachment.s3_access_point.alias #=> String
+    #   resp.s3_access_point_attachment.s3_access_point.vpc_configuration.vpc_id #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/fsx-2018-03-01/CreateAndAttachS3AccessPoint AWS API Documentation
+    #
+    # @overload create_and_attach_s3_access_point(params = {})
+    # @param [Hash] params ({})
+    def create_and_attach_s3_access_point(params = {}, options = {})
+      req = build_request(:create_and_attach_s3_access_point, params)
+      req.send_request(options)
+    end
+
     # Creates a backup of an existing Amazon FSx for Windows File Server
     # file system, Amazon FSx for Lustre file system, Amazon FSx for NetApp
     # ONTAP volume, or Amazon FSx for OpenZFS file system. We recommend
@@ -2688,7 +2809,7 @@ module Aws::FSx
     #
     #
     #   [1]: https://docs.aws.amazon.com/fsx/latest/WindowsGuide/optimize-fsx-costs.html#storage-type-options
-    #   [2]: https://docs.aws.amazon.com/fsx/latest/LustreGuide/lustre-storage-classes
+    #   [2]: https://docs.aws.amazon.com/fsx/latest/LustreGuide/using-fsx-lustre.html#lustre-storage-classes
     #   [3]: https://docs.aws.amazon.com/fsx/latest/OpenZFSGuide/performance-intelligent-tiering
     #
     # @option params [required, Array<String>] :subnet_ids
@@ -4998,12 +5119,19 @@ module Aws::FSx
     # Then provide a `FileSystemId` value to the `DeleteFileSystem`
     # operation.
     #
+    # Before deleting an Amazon FSx for OpenZFS file system, make sure that
+    # there aren't any Amazon S3 access points attached to any volume. For
+    # more information on how to list S3 access points that are attached to
+    # volumes, see [Listing S3 access point attachments][1]. For more
+    # information on how to delete S3 access points, see [Deleting an S3
+    # access point attachment][2].
+    #
     # By default, when you delete an Amazon FSx for Windows File Server file
     # system, a final backup is created upon deletion. This final backup
     # isn't subject to the file system's retention policy, and must be
     # manually deleted.
     #
-    # To delete an Amazon FSx for Lustre file system, first [unmount][1] it
+    # To delete an Amazon FSx for Lustre file system, first [unmount][3] it
     # from every connected Amazon EC2 instance, then provide a
     # `FileSystemId` value to the `DeleteFileSystem` operation. By default,
     # Amazon FSx will not take a final backup when the `DeleteFileSystem`
@@ -5012,15 +5140,15 @@ module Aws::FSx
     # file system you are deleting. Backups cannot be enabled on S3-linked
     # file systems. To ensure all of your data is written back to S3 before
     # deleting your file system, you can either monitor for the
-    # [AgeOfOldestQueuedMessage][2] metric to be zero (if using automatic
-    # export) or you can run an [export data repository task][3]. If you
+    # [AgeOfOldestQueuedMessage][4] metric to be zero (if using automatic
+    # export) or you can run an [export data repository task][5]. If you
     # have automatic export enabled and want to use an export data
     # repository task, you have to disable automatic export before executing
     # the export data repository task.
     #
     # The `DeleteFileSystem` operation returns while the file system has the
     # `DELETING` status. You can check the file system deletion status by
-    # calling the [DescribeFileSystems][4] operation, which returns a list
+    # calling the [DescribeFileSystems][6] operation, which returns a list
     # of file systems in your account. If you pass the file system ID for a
     # deleted file system, the `DescribeFileSystems` operation returns a
     # `FileSystemNotFound` error.
@@ -5036,10 +5164,12 @@ module Aws::FSx
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/fsx/latest/LustreGuide/unmounting-fs.html
-    # [2]: https://docs.aws.amazon.com/fsx/latest/LustreGuide/monitoring-cloudwatch.html#auto-import-export-metrics
-    # [3]: https://docs.aws.amazon.com/fsx/latest/LustreGuide/export-data-repo-task-dra.html
-    # [4]: https://docs.aws.amazon.com/fsx/latest/APIReference/API_DescribeFileSystems.html
+    # [1]: https://docs.aws.amazon.com/fsx/latest/OpenZFSGuide/access-points-list
+    # [2]: https://docs.aws.amazon.com/fsx/latest/OpenZFSGuide/delete-points-list
+    # [3]: https://docs.aws.amazon.com/fsx/latest/LustreGuide/unmounting-fs.html
+    # [4]: https://docs.aws.amazon.com/fsx/latest/LustreGuide/monitoring-cloudwatch.html#auto-import-export-metrics
+    # [5]: https://docs.aws.amazon.com/fsx/latest/LustreGuide/export-data-repo-task-dra.html
+    # [6]: https://docs.aws.amazon.com/fsx/latest/APIReference/API_DescribeFileSystems.html
     #
     # @option params [required, String] :file_system_id
     #   The ID of the file system that you want to delete.
@@ -6511,6 +6641,82 @@ module Aws::FSx
       req.send_request(options)
     end
 
+    # Describes one or more S3 access points attached to Amazon FSx volumes.
+    #
+    # The requester requires the following permission to perform this
+    # action:
+    #
+    # * `fsx:DescribeS3AccessPointAttachments`
+    #
+    # ^
+    #
+    # @option params [Array<String>] :names
+    #   The names of the S3 access point attachments whose descriptions you
+    #   want to retrieve.
+    #
+    # @option params [Array<Types::S3AccessPointAttachmentsFilter>] :filters
+    #   Enter a filter Name and Values pair to view a select set of S3 access
+    #   point attachments.
+    #
+    # @option params [Integer] :max_results
+    #   The maximum number of resources to return in the response. This value
+    #   must be an integer greater than zero.
+    #
+    # @option params [String] :next_token
+    #   (Optional) Opaque pagination token returned from a previous operation
+    #   (String). If present, this token indicates from what point you can
+    #   continue processing the request, where the previous `NextToken` value
+    #   left off.
+    #
+    # @return [Types::DescribeS3AccessPointAttachmentsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::DescribeS3AccessPointAttachmentsResponse#s3_access_point_attachments #s3_access_point_attachments} => Array&lt;Types::S3AccessPointAttachment&gt;
+    #   * {Types::DescribeS3AccessPointAttachmentsResponse#next_token #next_token} => String
+    #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.describe_s3_access_point_attachments({
+    #     names: ["S3AccessPointAttachmentName"],
+    #     filters: [
+    #       {
+    #         name: "file-system-id", # accepts file-system-id, volume-id, type
+    #         values: ["S3AccessPointAttachmentsFilterValue"],
+    #       },
+    #     ],
+    #     max_results: 1,
+    #     next_token: "NextToken",
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.s3_access_point_attachments #=> Array
+    #   resp.s3_access_point_attachments[0].lifecycle #=> String, one of "AVAILABLE", "CREATING", "DELETING", "UPDATING", "FAILED"
+    #   resp.s3_access_point_attachments[0].lifecycle_transition_reason.message #=> String
+    #   resp.s3_access_point_attachments[0].creation_time #=> Time
+    #   resp.s3_access_point_attachments[0].name #=> String
+    #   resp.s3_access_point_attachments[0].type #=> String, one of "OPENZFS"
+    #   resp.s3_access_point_attachments[0].open_zfs_configuration.volume_id #=> String
+    #   resp.s3_access_point_attachments[0].open_zfs_configuration.file_system_identity.type #=> String, one of "POSIX"
+    #   resp.s3_access_point_attachments[0].open_zfs_configuration.file_system_identity.posix_user.uid #=> Integer
+    #   resp.s3_access_point_attachments[0].open_zfs_configuration.file_system_identity.posix_user.gid #=> Integer
+    #   resp.s3_access_point_attachments[0].open_zfs_configuration.file_system_identity.posix_user.secondary_gids #=> Array
+    #   resp.s3_access_point_attachments[0].open_zfs_configuration.file_system_identity.posix_user.secondary_gids[0] #=> Integer
+    #   resp.s3_access_point_attachments[0].s3_access_point.resource_arn #=> String
+    #   resp.s3_access_point_attachments[0].s3_access_point.alias #=> String
+    #   resp.s3_access_point_attachments[0].s3_access_point.vpc_configuration.vpc_id #=> String
+    #   resp.next_token #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/fsx-2018-03-01/DescribeS3AccessPointAttachments AWS API Documentation
+    #
+    # @overload describe_s3_access_point_attachments(params = {})
+    # @param [Hash] params ({})
+    def describe_s3_access_point_attachments(params = {}, options = {})
+      req = build_request(:describe_s3_access_point_attachments, params)
+      req.send_request(options)
+    end
+
     # Indicates whether participant accounts in your organization can create
     # Amazon FSx for NetApp ONTAP Multi-AZ file systems in subnets that are
     # shared by a virtual private cloud (VPC) owner. For more information,
@@ -7160,6 +7366,54 @@ module Aws::FSx
       req.send_request(options)
     end
 
+    # Detaches an S3 access point from an Amazon FSx volume and deletes the
+    # S3 access point.
+    #
+    # The requester requires the following permission to perform this
+    # action:
+    #
+    # * `fsx:DetachAndDeleteS3AccessPoint`
+    #
+    # * `s3:DeleteAccessPoint`
+    #
+    # @option params [String] :client_request_token
+    #   (Optional) An idempotency token for resource creation, in a string of
+    #   up to 63 ASCII characters. This token is automatically filled on your
+    #   behalf when you use the Command Line Interface (CLI) or an Amazon Web
+    #   Services SDK.
+    #
+    #   **A suitable default value is auto-generated.** You should normally
+    #   not need to pass this option.**
+    #
+    # @option params [required, String] :name
+    #   The name of the S3 access point attachment that you want to delete.
+    #
+    # @return [Types::DetachAndDeleteS3AccessPointResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::DetachAndDeleteS3AccessPointResponse#lifecycle #lifecycle} => String
+    #   * {Types::DetachAndDeleteS3AccessPointResponse#name #name} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.detach_and_delete_s3_access_point({
+    #     client_request_token: "ClientRequestToken",
+    #     name: "S3AccessPointAttachmentName", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.lifecycle #=> String, one of "AVAILABLE", "CREATING", "DELETING", "UPDATING", "FAILED"
+    #   resp.name #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/fsx-2018-03-01/DetachAndDeleteS3AccessPoint AWS API Documentation
+    #
+    # @overload detach_and_delete_s3_access_point(params = {})
+    # @param [Hash] params ({})
+    def detach_and_delete_s3_access_point(params = {}, options = {})
+      req = build_request(:detach_and_delete_s3_access_point, params)
+      req.send_request(options)
+    end
+
     # Use this action to disassociate, or remove, one or more Domain Name
     # Service (DNS) aliases from an Amazon FSx for Windows File Server file
     # system. If you attempt to disassociate a DNS alias that is not
@@ -9538,7 +9792,7 @@ module Aws::FSx
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-fsx'
-      context[:gem_version] = '1.114.0'
+      context[:gem_version] = '1.116.0'
       Seahorse::Client::Request.new(handlers, context)
     end