aws-sdk-connect 1.225.0 → 1.226.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f54b21c409b8e6605097543e7c445b3268f5f4c44479222efe1cc4ffe5782cd1
-  data.tar.gz: 618793bb3f5538a5e94417702c8ea8bfc0d78a7769a579cdacd10a5f5542ff65
+  metadata.gz: c0f38fc1a55fe9ce8d8e5f727bfaebf06faea88b464810ca9f77e715e2a34da3
+  data.tar.gz: da011bfea2dc3fa2df5117a8e30633c68017b0dcc88f9aa6ec34d6e846880b65
 SHA512:
-  metadata.gz: 251ea227026da2ece77d62b2a3ae41b872a09e01157febcd89e382d24c2eb8d363e00891523d49832976481107f5082c5b4f2e2e28a58bdf428b410940263ef5
-  data.tar.gz: 70753afcdbea8feb353eb41840030f6c09ee0415d8f01668338843ea03ef37e1a87ec692de456cdc91fac107fdbceb6df54e0e76b84d4bb8e4d5d0b90b4ba614
+  metadata.gz: 0d673b8c658862f0cdee24c80b450bbd4dfc438dff0de0968e2161d9225052a2cbe9c90b428e486136fd2c3178a91d2adcc9f8e57f5cd2b7f1dab303419a3fc6
+  data.tar.gz: 4a480b427cee3451fd5cb9f7dcd5e01fc48280a97e509b42336ff6171e81052e4d957f45bdef3da0e291320302a03d9cfd2885a74acebd24e2d76d5ff5576609

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.226.0 (2025-11-21)
+------------------
+
+* Feature - New APIs to support aliases and versions for ContactFlowModule. Updated ContactFlowModule APIs to support custom blocks.
+
 1.225.0 (2025-11-20)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.225.0
+1.226.0

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

@@ -2313,6 +2313,12 @@ module Aws::Connect
     #
     #   [1]: https://aws.amazon.com/builders-library/making-retries-safe-with-idempotent-APIs/
     #
+    # @option params [String] :settings
+    #   The configuration settings for the flow module.
+    #
+    # @option params [Types::ExternalInvocationConfiguration] :external_invocation_configuration
+    #   The external invocation configuration for the flow module.
+    #
     # @return [Types::CreateContactFlowModuleResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::CreateContactFlowModuleResponse#id #id} => String
@@ -2329,6 +2335,10 @@ module Aws::Connect
     #       "TagKey" => "TagValue",
     #     },
     #     client_token: "ClientToken",
+    #     settings: "FlowModuleSettings",
+    #     external_invocation_configuration: {
+    #       enabled: false,
+    #     },
     #   })
     #
     # @example Response structure
@@ -2345,6 +2355,107 @@ module Aws::Connect
       req.send_request(options)
     end
 
+    # Creates a named alias that points to a specific version of a contact
+    # flow module.
+    #
+    # @option params [required, String] :instance_id
+    #   The identifier of the Amazon Connect instance. You can [find the
+    #   instance ID][1] in the Amazon Resource Name (ARN) of the instance.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/connect/latest/adminguide/find-instance-arn.html
+    #
+    # @option params [String] :description
+    #   The description of the alias.
+    #
+    # @option params [required, String] :contact_flow_module_id
+    #   The identifier of the flow module.
+    #
+    # @option params [required, Integer] :contact_flow_module_version
+    #   The version of the flow module.
+    #
+    # @option params [required, String] :alias_name
+    #   The name of the alias.
+    #
+    # @return [Types::CreateContactFlowModuleAliasResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::CreateContactFlowModuleAliasResponse#contact_flow_module_arn #contact_flow_module_arn} => String
+    #   * {Types::CreateContactFlowModuleAliasResponse#id #id} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.create_contact_flow_module_alias({
+    #     instance_id: "InstanceIdOrArn", # required
+    #     description: "ContactFlowDescription",
+    #     contact_flow_module_id: "ContactFlowModuleId", # required
+    #     contact_flow_module_version: 1, # required
+    #     alias_name: "ContactFlowModuleAlias", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.contact_flow_module_arn #=> String
+    #   resp.id #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/CreateContactFlowModuleAlias AWS API Documentation
+    #
+    # @overload create_contact_flow_module_alias(params = {})
+    # @param [Hash] params ({})
+    def create_contact_flow_module_alias(params = {}, options = {})
+      req = build_request(:create_contact_flow_module_alias, params)
+      req.send_request(options)
+    end
+
+    # Creates an immutable snapshot of a contact flow module, preserving its
+    # content and settings at a specific point in time for version control
+    # and rollback capabilities.
+    #
+    # @option params [required, String] :instance_id
+    #   The identifier of the Amazon Connect instance. You can [find the
+    #   instance ID][1] in the Amazon Resource Name (ARN) of the instance.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/connect/latest/adminguide/find-instance-arn.html
+    #
+    # @option params [String] :description
+    #   The description of the flow module version.
+    #
+    # @option params [required, String] :contact_flow_module_id
+    #   The identifier of the flow module.
+    #
+    # @option params [String] :flow_module_content_sha_256
+    #   Indicates the checksum value of the flow module content.
+    #
+    # @return [Types::CreateContactFlowModuleVersionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::CreateContactFlowModuleVersionResponse#contact_flow_module_arn #contact_flow_module_arn} => String
+    #   * {Types::CreateContactFlowModuleVersionResponse#version #version} => Integer
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.create_contact_flow_module_version({
+    #     instance_id: "InstanceId", # required
+    #     description: "ContactFlowModuleDescription",
+    #     contact_flow_module_id: "ARN", # required
+    #     flow_module_content_sha_256: "FlowModuleContentSha256",
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.contact_flow_module_arn #=> String
+    #   resp.version #=> Integer
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/CreateContactFlowModuleVersion AWS API Documentation
+    #
+    # @overload create_contact_flow_module_version(params = {})
+    # @param [Hash] params ({})
+    def create_contact_flow_module_version(params = {}, options = {})
+      req = build_request(:create_contact_flow_module_version, params)
+      req.send_request(options)
+    end
+
     # Publishes a new version of the flow provided. Versions are immutable
     # and monotonically increasing. If the `FlowContentSha256` provided is
     # different from the `FlowContentSha256` of the `$LATEST` published flow
@@ -4814,6 +4925,77 @@ module Aws::Connect
       req.send_request(options)
     end
 
+    # Removes an alias reference, breaking the named connection to the
+    # underlying module version without affecting the version itself.
+    #
+    # @option params [required, String] :instance_id
+    #   The identifier of the Amazon Connect instance. You can [find the
+    #   instance ID][1] in the Amazon Resource Name (ARN) of the instance.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/connect/latest/adminguide/find-instance-arn.html
+    #
+    # @option params [required, String] :contact_flow_module_id
+    #   The identifier of the flow module.
+    #
+    # @option params [required, String] :alias_id
+    #   The identifier of the alias.
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.delete_contact_flow_module_alias({
+    #     instance_id: "InstanceIdOrArn", # required
+    #     contact_flow_module_id: "ResourceId", # required
+    #     alias_id: "ResourceId", # required
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/DeleteContactFlowModuleAlias AWS API Documentation
+    #
+    # @overload delete_contact_flow_module_alias(params = {})
+    # @param [Hash] params ({})
+    def delete_contact_flow_module_alias(params = {}, options = {})
+      req = build_request(:delete_contact_flow_module_alias, params)
+      req.send_request(options)
+    end
+
+    # Removes a specific version of a contact flow module.
+    #
+    # @option params [required, String] :instance_id
+    #   The identifier of the Amazon Connect instance. You can [find the
+    #   instance ID][1] in the Amazon Resource Name (ARN) of the instance.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/connect/latest/adminguide/find-instance-arn.html
+    #
+    # @option params [required, String] :contact_flow_module_id
+    #   The identifier of the flow module.
+    #
+    # @option params [required, Integer] :contact_flow_module_version
+    #   The version of the flow module to delete.
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.delete_contact_flow_module_version({
+    #     instance_id: "InstanceId", # required
+    #     contact_flow_module_id: "ARN", # required
+    #     contact_flow_module_version: 1, # required
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/DeleteContactFlowModuleVersion AWS API Documentation
+    #
+    # @overload delete_contact_flow_module_version(params = {})
+    # @param [Hash] params ({})
+    def delete_contact_flow_module_version(params = {}, options = {})
+      req = build_request(:delete_contact_flow_module_version, params)
+      req.send_request(options)
+    end
+
     # Deletes the particular version specified in flow version identifier.
     #
     # @option params [required, String] :instance_id
@@ -6218,6 +6400,11 @@ module Aws::Connect
     #   resp.contact_flow_module.status #=> String, one of "PUBLISHED", "SAVED"
     #   resp.contact_flow_module.tags #=> Hash
     #   resp.contact_flow_module.tags["TagKey"] #=> String
+    #   resp.contact_flow_module.flow_module_content_sha_256 #=> String
+    #   resp.contact_flow_module.version #=> Integer
+    #   resp.contact_flow_module.version_description #=> String
+    #   resp.contact_flow_module.settings #=> String
+    #   resp.contact_flow_module.external_invocation_configuration.enabled #=> Boolean
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/DescribeContactFlowModule AWS API Documentation
     #
@@ -6228,6 +6415,55 @@ module Aws::Connect
       req.send_request(options)
     end
 
+    # Retrieves detailed information about a specific alias, including which
+    # version it currently points to and its metadata.
+    #
+    # @option params [required, String] :instance_id
+    #   The identifier of the Amazon Connect instance. You can [find the
+    #   instance ID][1] in the Amazon Resource Name (ARN) of the instance.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/connect/latest/adminguide/find-instance-arn.html
+    #
+    # @option params [required, String] :contact_flow_module_id
+    #   The identifier of the flow module.
+    #
+    # @option params [required, String] :alias_id
+    #   The identifier of the alias.
+    #
+    # @return [Types::DescribeContactFlowModuleAliasResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::DescribeContactFlowModuleAliasResponse#contact_flow_module_alias #contact_flow_module_alias} => Types::ContactFlowModuleAliasInfo
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.describe_contact_flow_module_alias({
+    #     instance_id: "InstanceIdOrArn", # required
+    #     contact_flow_module_id: "ContactFlowModuleId", # required
+    #     alias_id: "ResourceId", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.contact_flow_module_alias.contact_flow_module_id #=> String
+    #   resp.contact_flow_module_alias.contact_flow_module_arn #=> String
+    #   resp.contact_flow_module_alias.alias_id #=> String
+    #   resp.contact_flow_module_alias.version #=> Integer
+    #   resp.contact_flow_module_alias.name #=> String
+    #   resp.contact_flow_module_alias.description #=> String
+    #   resp.contact_flow_module_alias.last_modified_region #=> String
+    #   resp.contact_flow_module_alias.last_modified_time #=> Time
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/DescribeContactFlowModuleAlias AWS API Documentation
+    #
+    # @overload describe_contact_flow_module_alias(params = {})
+    # @param [Hash] params ({})
+    def describe_contact_flow_module_alias(params = {}, options = {})
+      req = build_request(:describe_contact_flow_module_alias, params)
+      req.send_request(options)
+    end
+
     # Describe email address form the specified Amazon Connect instance.
     #
     # @option params [required, String] :instance_id
@@ -12017,6 +12253,119 @@ module Aws::Connect
       req.send_request(options)
     end
 
+    # Lists all aliases associated with a contact flow module, showing their
+    # current version mappings and metadata.
+    #
+    # @option params [required, String] :instance_id
+    #   The identifier of the Amazon Connect instance. You can [find the
+    #   instance ID][1] in the Amazon Resource Name (ARN) of the instance.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/connect/latest/adminguide/find-instance-arn.html
+    #
+    # @option params [required, String] :contact_flow_module_id
+    #   The identifier of the flow module.
+    #
+    # @option params [String] :next_token
+    #   The token for the next set of results. Use the value returned in the
+    #   previous response in the next request to retrieve the next set of
+    #   results.
+    #
+    # @option params [Integer] :max_results
+    #   The maximum number of results to return per page.
+    #
+    # @return [Types::ListContactFlowModuleAliasesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ListContactFlowModuleAliasesResponse#contact_flow_module_alias_summary_list #contact_flow_module_alias_summary_list} => Array<Types::ContactFlowModuleAliasSummary>
+    #   * {Types::ListContactFlowModuleAliasesResponse#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.list_contact_flow_module_aliases({
+    #     instance_id: "InstanceIdOrArn", # required
+    #     contact_flow_module_id: "ARN", # required
+    #     next_token: "NextToken",
+    #     max_results: 1,
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.contact_flow_module_alias_summary_list #=> Array
+    #   resp.contact_flow_module_alias_summary_list[0].arn #=> String
+    #   resp.contact_flow_module_alias_summary_list[0].alias_id #=> String
+    #   resp.contact_flow_module_alias_summary_list[0].version #=> Integer
+    #   resp.contact_flow_module_alias_summary_list[0].alias_name #=> String
+    #   resp.contact_flow_module_alias_summary_list[0].alias_description #=> String
+    #   resp.contact_flow_module_alias_summary_list[0].last_modified_time #=> Time
+    #   resp.next_token #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/ListContactFlowModuleAliases AWS API Documentation
+    #
+    # @overload list_contact_flow_module_aliases(params = {})
+    # @param [Hash] params ({})
+    def list_contact_flow_module_aliases(params = {}, options = {})
+      req = build_request(:list_contact_flow_module_aliases, params)
+      req.send_request(options)
+    end
+
+    # Retrieves a paginated list of all versions for a specific contact flow
+    # module.
+    #
+    # @option params [required, String] :instance_id
+    #   The identifier of the Amazon Connect instance. You can [find the
+    #   instance ID][1] in the Amazon Resource Name (ARN) of the instance.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/connect/latest/adminguide/find-instance-arn.html
+    #
+    # @option params [required, String] :contact_flow_module_id
+    #   The identifier of the flow module.
+    #
+    # @option params [String] :next_token
+    #   The token for the next set of results. Use the value returned in the
+    #   previous response in the next request to retrieve the next set of
+    #   results.
+    #
+    # @option params [Integer] :max_results
+    #   The maximum number of results to return per page.
+    #
+    # @return [Types::ListContactFlowModuleVersionsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ListContactFlowModuleVersionsResponse#contact_flow_module_version_summary_list #contact_flow_module_version_summary_list} => Array<Types::ContactFlowModuleVersionSummary>
+    #   * {Types::ListContactFlowModuleVersionsResponse#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.list_contact_flow_module_versions({
+    #     instance_id: "InstanceId", # required
+    #     contact_flow_module_id: "ARN", # required
+    #     next_token: "NextToken",
+    #     max_results: 1,
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.contact_flow_module_version_summary_list #=> Array
+    #   resp.contact_flow_module_version_summary_list[0].arn #=> String
+    #   resp.contact_flow_module_version_summary_list[0].version_description #=> String
+    #   resp.contact_flow_module_version_summary_list[0].version #=> Integer
+    #   resp.next_token #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/ListContactFlowModuleVersions AWS API Documentation
+    #
+    # @overload list_contact_flow_module_versions(params = {})
+    # @param [Hash] params ({})
+    def list_contact_flow_module_versions(params = {}, options = {})
+      req = build_request(:list_contact_flow_module_versions, params)
+      req.send_request(options)
+    end
+
     # Provides information about the flow modules for the specified Amazon
     # Connect instance.
     #
@@ -15464,6 +15813,11 @@ module Aws::Connect
     #   resp.contact_flow_modules[0].status #=> String, one of "PUBLISHED", "SAVED"
     #   resp.contact_flow_modules[0].tags #=> Hash
     #   resp.contact_flow_modules[0].tags["TagKey"] #=> String
+    #   resp.contact_flow_modules[0].flow_module_content_sha_256 #=> String
+    #   resp.contact_flow_modules[0].version #=> Integer
+    #   resp.contact_flow_modules[0].version_description #=> String
+    #   resp.contact_flow_modules[0].settings #=> String
+    #   resp.contact_flow_modules[0].external_invocation_configuration.enabled #=> Boolean
     #   resp.next_token #=> String
     #   resp.approximate_total_count #=> Integer
     #
@@ -20291,6 +20645,54 @@ module Aws::Connect
       req.send_request(options)
     end
 
+    # Updates a specific Aliases metadata, including the version it’s tied
+    # to, it’s name, and description.
+    #
+    # @option params [required, String] :instance_id
+    #   The identifier of the Amazon Connect instance. You can [find the
+    #   instance ID][1] in the Amazon Resource Name (ARN) of the instance.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/connect/latest/adminguide/find-instance-arn.html
+    #
+    # @option params [required, String] :contact_flow_module_id
+    #   The identifier of the flow module.
+    #
+    # @option params [required, String] :alias_id
+    #   The identifier of the alias.
+    #
+    # @option params [String] :name
+    #   The name of the alias.
+    #
+    # @option params [String] :description
+    #   The description of the alias.
+    #
+    # @option params [Integer] :contact_flow_module_version
+    #   The version of the flow module.
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.update_contact_flow_module_alias({
+    #     instance_id: "InstanceIdOrArn", # required
+    #     contact_flow_module_id: "ContactFlowModuleId", # required
+    #     alias_id: "ResourceId", # required
+    #     name: "ContactFlowModuleName",
+    #     description: "ContactFlowModuleDescription",
+    #     contact_flow_module_version: 1,
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/UpdateContactFlowModuleAlias AWS API Documentation
+    #
+    # @overload update_contact_flow_module_alias(params = {})
+    # @param [Hash] params ({})
+    def update_contact_flow_module_alias(params = {}, options = {})
+      req = build_request(:update_contact_flow_module_alias, params)
+      req.send_request(options)
+    end
+
     # Updates specified flow module for the specified Amazon Connect
     # instance.
     #
@@ -20310,7 +20712,7 @@ module Aws::Connect
     # @option params [required, String] :contact_flow_module_id
     #   The identifier of the flow module.
     #
-    # @option params [required, String] :content
+    # @option params [String] :content
     #   The JSON string that represents the content of the flow. For an
     #   example, see [Example flow in Amazon Connect Flow language][1].
     #
@@ -20318,6 +20720,9 @@ module Aws::Connect
     #
     #   [1]: https://docs.aws.amazon.com/connect/latest/APIReference/flow-language-example.html
     #
+    # @option params [String] :settings
+    #   Serialized JSON string of the flow module Settings schema.
+    #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
     # @example Request syntax with placeholder values
@@ -20325,7 +20730,8 @@ module Aws::Connect
     #   resp = client.update_contact_flow_module_content({
     #     instance_id: "InstanceId", # required
     #     contact_flow_module_id: "ContactFlowModuleId", # required
-    #     content: "ContactFlowModuleContent", # required
+    #     content: "ContactFlowModuleContent",
+    #     settings: "FlowModuleSettings",
     #   })
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/UpdateContactFlowModuleContent AWS API Documentation
@@ -22960,7 +23366,7 @@ module Aws::Connect
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-connect'
-      context[:gem_version] = '1.225.0'
+      context[:gem_version] = '1.226.0'
       Seahorse::Client::Request.new(handlers, context)
     end