aws-sdk-fsx 1.114.0 → 1.115.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ca9b00f6961fc30a8e2c8d331958978e223d213a5ad3d5e043238d4a88fc07e6
-  data.tar.gz: 2a2d85c663b144020bd4a31260cc18a04a980aeb42f2ea1805af0de8d439e547
+  metadata.gz: 6eb80c2e7543cfd64f659af821ceea17ce1ad3582dce0d63e117374cad619fd3
+  data.tar.gz: c8049da1a68b6266da711867de4a5cd02be133373df7a56246f9ceaec9752457
 SHA512:
-  metadata.gz: 86704db640c935d7b63c6a56bfd595f24d0431698de54558a37bd60de7bea0c37d93a0d7731d9b078d9b39a002915825de5fec7332775ed1f452449747e0b156
-  data.tar.gz: fae36715f598392c3d1cd287399d36a873f039d6283f5a90f423729882e81f84942a3cfab1c01350836c9043bc00760c259cb70f702a77d0fe47641af00c3fa5
+  metadata.gz: 90c0722f7863edd9cf003f2cbd600338a5a4bdd0e6d45235ad28a1178df1ca65397184741acf086d70ca3a25da6263505c9a64735251a7638f5af70086a86493
+  data.tar.gz: 0a5d81d2a561b067ab8a8395334703aa7ac0c1cd0070b4fc1bb60b970ebd1f5af5d268b43591215f8d1a8b18a9a413e38e0fa10c264a4d02be05507f4cad5bc5

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+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.115.0

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

@@ -1473,6 +1473,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 +2799,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 +5109,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 +5130,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 +5154,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 +6631,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 +7356,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 +9782,7 @@ module Aws::FSx
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-fsx'
-      context[:gem_version] = '1.114.0'
+      context[:gem_version] = '1.115.0'
       Seahorse::Client::Request.new(handlers, context)
     end