aws-sdk-transfer 1.107.0 → 1.109.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '08f1cb0dd360dccba723592acd89e76c082d67bef8cdec6665054b762ffcb3b2'
-  data.tar.gz: 99ad08e00c80e9f501a658d0e405e876caba4ff6098f1d9b9423f35a9807bb3c
+  metadata.gz: ba44624d87f5ff63ccf597bc03442db29712bfd3a6ca4368a8d1f38563e74d42
+  data.tar.gz: 746ab633d1e7f69528ff33cc7a3944f21958a585bec03a2322a10d891c006165
 SHA512:
-  metadata.gz: 044037dc05ab2dd2e476472aa01fe4dbf15d75553bb84b0dd0d3118ece6efe6910509aab51877405de3a3f996448295e56d0afbe401d030c832189cb7648c53b
-  data.tar.gz: 3d9cbff53948092592824b4e3b391791c831fb4c87118929d69ceb0f92682ca7ceee5c71b9a72d856e0c900dbd0bdb8a6842b27c934b1d94cb7ae5bba060d549
+  metadata.gz: 24d2196b7c333903f9f0d9166ceb5ea8e739ba3e05ac98f8461f2211139d1d5ba973b29e8a837f7225186bd09b4525c567ed4a9496943266016add68fb65929e
+  data.tar.gz: 6656808f9fb52e53798a49bb6e4b44e74ed4e0de420826a7c1c485f504856d850859710e02ce7021d7dc5db4edf8453ac5a3b092417c71ec9a20981491f965d1

data/CHANGELOG.md

@@ -1,6 +1,16 @@
 Unreleased Changes
 ------------------
 
+1.109.0 (2024-12-18)
+------------------
+
+* Feature - Added AS2 agreement configurations to control filename preservation and message signing enforcement. Added AS2 connector configuration to preserve content type from S3 objects.
+
+1.108.0 (2024-12-02)
+------------------
+
+* Feature - AWS Transfer Family now offers Web apps that enables simple and secure access to data stored in Amazon S3.
+
 1.107.0 (2024-11-06)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.107.0
+1.109.0

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

@@ -694,6 +694,31 @@ module Aws::Transfer
     # @option params [Array<Types::Tag>] :tags
     #   Key-value pairs that can be used to group and search for agreements.
     #
+    # @option params [String] :preserve_filename
+    #   Determines whether or not Transfer Family appends a unique string of
+    #   characters to the end of the AS2 message payload filename when saving
+    #   it.
+    #
+    #   * `ENABLED`: the filename provided by your trading parter is preserved
+    #     when the file is saved.
+    #
+    #   * `DISABLED` (default value): when Transfer Family saves the file, the
+    #     filename is adjusted, as described in [File names and locations][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/transfer/latest/userguide/send-as2-messages.html#file-names-as2
+    #
+    # @option params [String] :enforce_message_signing
+    #   Determines whether or not unsigned messages from your trading partners
+    #   will be accepted.
+    #
+    #   * `ENABLED`: Transfer Family rejects unsigned messages from your
+    #     trading partner.
+    #
+    #   * `DISABLED` (default value): Transfer Family accepts unsigned
+    #     messages from your trading partner.
+    #
     # @return [Types::CreateAgreementResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::CreateAgreementResponse#agreement_id #agreement_id} => String
@@ -714,6 +739,8 @@ module Aws::Transfer
     #         value: "TagValue", # required
     #       },
     #     ],
+    #     preserve_filename: "ENABLED", # accepts ENABLED, DISABLED
+    #     enforce_message_signing: "ENABLED", # accepts ENABLED, DISABLED
     #   })
     #
     # @example Response structure
@@ -821,6 +848,7 @@ module Aws::Transfer
     #       mdn_signing_algorithm: "SHA256", # accepts SHA256, SHA384, SHA512, SHA1, NONE, DEFAULT
     #       mdn_response: "SYNC", # accepts SYNC, NONE
     #       basic_auth_secret_id: "As2ConnectorSecretId",
+    #       preserve_content_type: "ENABLED", # accepts ENABLED, DISABLED
     #     },
     #     access_role: "Role", # required
     #     logging_role: "Role",
@@ -1045,7 +1073,8 @@ module Aws::Transfer
     #   `API_GATEWAY`. Accepts an array containing all of the information
     #   required to use a directory in `AWS_DIRECTORY_SERVICE` or invoke a
     #   customer-supplied authentication API, including the API Gateway URL.
-    #   Not required when `IdentityProviderType` is set to `SERVICE_MANAGED`.
+    #   Cannot be specified when `IdentityProviderType` is set to
+    #   `SERVICE_MANAGED`.
     #
     # @option params [String] :identity_provider_type
     #   The mode of authentication for a server. The default value is
@@ -1463,6 +1492,63 @@ module Aws::Transfer
       req.send_request(options)
     end
 
+    # Creates a web app based on specified parameters, and returns the ID
+    # for the new web app.
+    #
+    # @option params [required, Types::WebAppIdentityProviderDetails] :identity_provider_details
+    #   You can provide a structure that contains the details for the identity
+    #   provider to use with your web app.
+    #
+    # @option params [String] :access_endpoint
+    #   The `AccessEndpoint` is the URL that you provide to your users for
+    #   them to interact with the Transfer Family web app. You can specify a
+    #   custom URL or use the default value.
+    #
+    # @option params [Types::WebAppUnits] :web_app_units
+    #   A union that contains the value for number of concurrent connections
+    #   or the user sessions on your web app.
+    #
+    # @option params [Array<Types::Tag>] :tags
+    #   Key-value pairs that can be used to group and search for web apps.
+    #
+    # @return [Types::CreateWebAppResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::CreateWebAppResponse#web_app_id #web_app_id} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.create_web_app({
+    #     identity_provider_details: { # required
+    #       identity_center_config: {
+    #         instance_arn: "IdentityCenterInstanceArn",
+    #         role: "Role",
+    #       },
+    #     },
+    #     access_endpoint: "WebAppAccessEndpoint",
+    #     web_app_units: {
+    #       provisioned: 1,
+    #     },
+    #     tags: [
+    #       {
+    #         key: "TagKey", # required
+    #         value: "TagValue", # required
+    #       },
+    #     ],
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.web_app_id #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/transfer-2018-11-05/CreateWebApp AWS API Documentation
+    #
+    # @overload create_web_app(params = {})
+    # @param [Hash] params ({})
+    def create_web_app(params = {}, options = {})
+      req = build_request(:create_web_app, params)
+      req.send_request(options)
+    end
+
     # Allows you to create a workflow with specified steps and step details
     # the workflow invokes after file transfer completes. After creating a
     # workflow, you can associate the workflow created with any transfer
@@ -1911,6 +1997,52 @@ module Aws::Transfer
       req.send_request(options)
     end
 
+    # Deletes the specified web app.
+    #
+    # @option params [required, String] :web_app_id
+    #   Provide the unique identifier for the web app that you are deleting.
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.delete_web_app({
+    #     web_app_id: "WebAppId", # required
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/transfer-2018-11-05/DeleteWebApp AWS API Documentation
+    #
+    # @overload delete_web_app(params = {})
+    # @param [Hash] params ({})
+    def delete_web_app(params = {}, options = {})
+      req = build_request(:delete_web_app, params)
+      req.send_request(options)
+    end
+
+    # Deletes the `WebAppCustomization` object that corresponds to the web
+    # app ID specified.
+    #
+    # @option params [required, String] :web_app_id
+    #   Provide the unique identifier for the web app that contains the
+    #   customizations that you are deleting.
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.delete_web_app_customization({
+    #     web_app_id: "WebAppId", # required
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/transfer-2018-11-05/DeleteWebAppCustomization AWS API Documentation
+    #
+    # @overload delete_web_app_customization(params = {})
+    # @param [Hash] params ({})
+    def delete_web_app_customization(params = {}, options = {})
+      req = build_request(:delete_web_app_customization, params)
+      req.send_request(options)
+    end
+
     # Deletes the specified workflow.
     #
     # @option params [required, String] :workflow_id
@@ -2035,6 +2167,8 @@ module Aws::Transfer
     #   resp.agreement.tags #=> Array
     #   resp.agreement.tags[0].key #=> String
     #   resp.agreement.tags[0].value #=> String
+    #   resp.agreement.preserve_filename #=> String, one of "ENABLED", "DISABLED"
+    #   resp.agreement.enforce_message_signing #=> String, one of "ENABLED", "DISABLED"
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/transfer-2018-11-05/DescribeAgreement AWS API Documentation
     #
@@ -2118,6 +2252,7 @@ module Aws::Transfer
     #   resp.connector.as_2_config.mdn_signing_algorithm #=> String, one of "SHA256", "SHA384", "SHA512", "SHA1", "NONE", "DEFAULT"
     #   resp.connector.as_2_config.mdn_response #=> String, one of "SYNC", "NONE"
     #   resp.connector.as_2_config.basic_auth_secret_id #=> String
+    #   resp.connector.as_2_config.preserve_content_type #=> String, one of "ENABLED", "DISABLED"
     #   resp.connector.access_role #=> String
     #   resp.connector.logging_role #=> String
     #   resp.connector.tags #=> Array
@@ -2486,6 +2621,77 @@ module Aws::Transfer
       req.send_request(options)
     end
 
+    # Describes the web app that's identified by `WebAppId`.
+    #
+    # @option params [required, String] :web_app_id
+    #   Provide the unique identifier for the web app.
+    #
+    # @return [Types::DescribeWebAppResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::DescribeWebAppResponse#web_app #web_app} => Types::DescribedWebApp
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.describe_web_app({
+    #     web_app_id: "WebAppId", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.web_app.arn #=> String
+    #   resp.web_app.web_app_id #=> String
+    #   resp.web_app.described_identity_provider_details.identity_center_config.application_arn #=> String
+    #   resp.web_app.described_identity_provider_details.identity_center_config.instance_arn #=> String
+    #   resp.web_app.described_identity_provider_details.identity_center_config.role #=> String
+    #   resp.web_app.access_endpoint #=> String
+    #   resp.web_app.web_app_endpoint #=> String
+    #   resp.web_app.web_app_units.provisioned #=> Integer
+    #   resp.web_app.tags #=> Array
+    #   resp.web_app.tags[0].key #=> String
+    #   resp.web_app.tags[0].value #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/transfer-2018-11-05/DescribeWebApp AWS API Documentation
+    #
+    # @overload describe_web_app(params = {})
+    # @param [Hash] params ({})
+    def describe_web_app(params = {}, options = {})
+      req = build_request(:describe_web_app, params)
+      req.send_request(options)
+    end
+
+    # Describes the web app customization object that's identified by
+    # `WebAppId`.
+    #
+    # @option params [required, String] :web_app_id
+    #   Provide the unique identifier for the web app.
+    #
+    # @return [Types::DescribeWebAppCustomizationResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::DescribeWebAppCustomizationResponse#web_app_customization #web_app_customization} => Types::DescribedWebAppCustomization
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.describe_web_app_customization({
+    #     web_app_id: "WebAppId", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.web_app_customization.arn #=> String
+    #   resp.web_app_customization.web_app_id #=> String
+    #   resp.web_app_customization.title #=> String
+    #   resp.web_app_customization.logo_file #=> String
+    #   resp.web_app_customization.favicon_file #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/transfer-2018-11-05/DescribeWebAppCustomization AWS API Documentation
+    #
+    # @overload describe_web_app_customization(params = {})
+    # @param [Hash] params ({})
+    def describe_web_app_customization(params = {}, options = {})
+      req = build_request(:describe_web_app_customization, params)
+      req.send_request(options)
+    end
+
     # Describes the specified workflow.
     #
     # @option params [required, String] :workflow_id
@@ -2757,7 +2963,7 @@ module Aws::Transfer
     # Lists the details for all the accesses you have on your server.
     #
     # @option params [Integer] :max_results
-    #   Specifies the maximum number of access SIDs to return.
+    #   The maximum number of items to return.
     #
     # @option params [String] :next_token
     #   When you can get additional results from the `ListAccesses` call, a
@@ -2812,7 +3018,7 @@ module Aws::Transfer
     # left off.
     #
     # @option params [Integer] :max_results
-    #   The maximum number of agreements to return.
+    #   The maximum number of items to return.
     #
     # @option params [String] :next_token
     #   When you can get additional results from the `ListAgreements` call, a
@@ -2867,7 +3073,7 @@ module Aws::Transfer
     # you left off.
     #
     # @option params [Integer] :max_results
-    #   The maximum number of certificates to return.
+    #   The maximum number of items to return.
     #
     # @option params [String] :next_token
     #   When you can get additional results from the `ListCertificates` call,
@@ -2914,7 +3120,7 @@ module Aws::Transfer
     # Lists the connectors for the specified Region.
     #
     # @option params [Integer] :max_results
-    #   The maximum number of connectors to return.
+    #   The maximum number of items to return.
     #
     # @option params [String] :next_token
     #   When you can get additional results from the `ListConnectors` call, a
@@ -2961,7 +3167,7 @@ module Aws::Transfer
     #  </note>
     #
     # @option params [Integer] :max_results
-    #   Specifies the maximum number of executions to return.
+    #   The maximum number of items to return.
     #
     # @option params [String] :next_token
     #   `ListExecutions` returns the `NextToken` parameter in the output. You
@@ -3101,7 +3307,7 @@ module Aws::Transfer
     # `ServerId` parameter.
     #
     # @option params [Integer] :max_results
-    #   The maximum number of host keys to return.
+    #   The maximum number of items to return.
     #
     # @option params [String] :next_token
     #   When there are additional results that were not returned, a
@@ -3154,7 +3360,7 @@ module Aws::Transfer
     # from where you left off.
     #
     # @option params [Integer] :max_results
-    #   The maximum number of profiles to return.
+    #   The maximum number of items to return.
     #
     # @option params [String] :next_token
     #   When there are additional results that were not returned, a
@@ -3402,11 +3608,54 @@ module Aws::Transfer
       req.send_request(options)
     end
 
+    # Lists all web apps associated with your Amazon Web Services account
+    # for your current region.
+    #
+    # @option params [Integer] :max_results
+    #   The maximum number of items to return.
+    #
+    # @option params [String] :next_token
+    #   Returns the `NextToken` parameter in the output. You can then pass the
+    #   `NextToken` parameter in a subsequent command to continue listing
+    #   additional web apps.
+    #
+    # @return [Types::ListWebAppsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ListWebAppsResponse#next_token #next_token} => String
+    #   * {Types::ListWebAppsResponse#web_apps #web_apps} => Array&lt;Types::ListedWebApp&gt;
+    #
+    # 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.list_web_apps({
+    #     max_results: 1,
+    #     next_token: "NextToken",
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.next_token #=> String
+    #   resp.web_apps #=> Array
+    #   resp.web_apps[0].arn #=> String
+    #   resp.web_apps[0].web_app_id #=> String
+    #   resp.web_apps[0].access_endpoint #=> String
+    #   resp.web_apps[0].web_app_endpoint #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/transfer-2018-11-05/ListWebApps AWS API Documentation
+    #
+    # @overload list_web_apps(params = {})
+    # @param [Hash] params ({})
+    def list_web_apps(params = {}, options = {})
+      req = build_request(:list_web_apps, params)
+      req.send_request(options)
+    end
+
     # Lists all workflows associated with your Amazon Web Services account
     # for your current region.
     #
     # @option params [Integer] :max_results
-    #   Specifies the maximum number of workflows to return.
+    #   The maximum number of items to return.
     #
     # @option params [String] :next_token
     #   `ListWorkflows` returns the `NextToken` parameter in the output. You
@@ -4151,6 +4400,31 @@ module Aws::Transfer
     #   provides `secretsmanager:GetSecretValue` permission to Secrets
     #   Manager.
     #
+    # @option params [String] :preserve_filename
+    #   Determines whether or not Transfer Family appends a unique string of
+    #   characters to the end of the AS2 message payload filename when saving
+    #   it.
+    #
+    #   * `ENABLED`: the filename provided by your trading parter is preserved
+    #     when the file is saved.
+    #
+    #   * `DISABLED` (default value): when Transfer Family saves the file, the
+    #     filename is adjusted, as described in [File names and locations][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/transfer/latest/userguide/send-as2-messages.html#file-names-as2
+    #
+    # @option params [String] :enforce_message_signing
+    #   Determines whether or not unsigned messages from your trading partners
+    #   will be accepted.
+    #
+    #   * `ENABLED`: Transfer Family rejects unsigned messages from your
+    #     trading partner.
+    #
+    #   * `DISABLED` (default value): Transfer Family accepts unsigned
+    #     messages from your trading partner.
+    #
     # @return [Types::UpdateAgreementResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::UpdateAgreementResponse#agreement_id #agreement_id} => String
@@ -4166,6 +4440,8 @@ module Aws::Transfer
     #     partner_profile_id: "ProfileId",
     #     base_directory: "HomeDirectory",
     #     access_role: "Role",
+    #     preserve_filename: "ENABLED", # accepts ENABLED, DISABLED
+    #     enforce_message_signing: "ENABLED", # accepts ENABLED, DISABLED
     #   })
     #
     # @example Response structure
@@ -4299,6 +4575,7 @@ module Aws::Transfer
     #       mdn_signing_algorithm: "SHA256", # accepts SHA256, SHA384, SHA512, SHA1, NONE, DEFAULT
     #       mdn_response: "SYNC", # accepts SYNC, NONE
     #       basic_auth_secret_id: "As2ConnectorSecretId",
+    #       preserve_content_type: "ENABLED", # accepts ENABLED, DISABLED
     #     },
     #     access_role: "Role",
     #     logging_role: "Role",
@@ -4901,6 +5178,98 @@ module Aws::Transfer
       req.send_request(options)
     end
 
+    # Assigns new properties to a web app. You can modify the access point,
+    # identity provider details, and the web app units.
+    #
+    # @option params [required, String] :web_app_id
+    #   Provide the identifier of the web app that you are updating.
+    #
+    # @option params [Types::UpdateWebAppIdentityProviderDetails] :identity_provider_details
+    #   Provide updated identity provider values in a
+    #   `WebAppIdentityProviderDetails` object.
+    #
+    # @option params [String] :access_endpoint
+    #   The `AccessEndpoint` is the URL that you provide to your users for
+    #   them to interact with the Transfer Family web app. You can specify a
+    #   custom URL or use the default value.
+    #
+    # @option params [Types::WebAppUnits] :web_app_units
+    #   A union that contains the value for number of concurrent connections
+    #   or the user sessions on your web app.
+    #
+    # @return [Types::UpdateWebAppResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::UpdateWebAppResponse#web_app_id #web_app_id} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.update_web_app({
+    #     web_app_id: "WebAppId", # required
+    #     identity_provider_details: {
+    #       identity_center_config: {
+    #         role: "Role",
+    #       },
+    #     },
+    #     access_endpoint: "WebAppAccessEndpoint",
+    #     web_app_units: {
+    #       provisioned: 1,
+    #     },
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.web_app_id #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/transfer-2018-11-05/UpdateWebApp AWS API Documentation
+    #
+    # @overload update_web_app(params = {})
+    # @param [Hash] params ({})
+    def update_web_app(params = {}, options = {})
+      req = build_request(:update_web_app, params)
+      req.send_request(options)
+    end
+
+    # Assigns new customization properties to a web app. You can modify the
+    # icon file, logo file, and title.
+    #
+    # @option params [required, String] :web_app_id
+    #   Provide the identifier of the web app that you are updating.
+    #
+    # @option params [String] :title
+    #   Provide an updated title.
+    #
+    # @option params [String, StringIO, File] :logo_file
+    #   Specify logo file data string (in base64 encoding).
+    #
+    # @option params [String, StringIO, File] :favicon_file
+    #   Specify icon file data string (in base64 encoding).
+    #
+    # @return [Types::UpdateWebAppCustomizationResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::UpdateWebAppCustomizationResponse#web_app_id #web_app_id} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.update_web_app_customization({
+    #     web_app_id: "WebAppId", # required
+    #     title: "WebAppTitle",
+    #     logo_file: "data",
+    #     favicon_file: "data",
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.web_app_id #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/transfer-2018-11-05/UpdateWebAppCustomization AWS API Documentation
+    #
+    # @overload update_web_app_customization(params = {})
+    # @param [Hash] params ({})
+    def update_web_app_customization(params = {}, options = {})
+      req = build_request(:update_web_app_customization, params)
+      req.send_request(options)
+    end
+
     # @!endgroup
 
     # @param params ({})
@@ -4919,7 +5288,7 @@ module Aws::Transfer
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-transfer'
-      context[:gem_version] = '1.107.0'
+      context[:gem_version] = '1.109.0'
       Seahorse::Client::Request.new(handlers, context)
     end