aws-sdk-opensearchservice 1.103.0 → 1.105.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1701d64074b5dd02a7ad39e145636c89d390f33868d05a69101ba10065a1d587
-  data.tar.gz: abc776a9bab7a4782d3d332e1d48683027b816ada09342bb1692b76fdef6db4d
+  metadata.gz: 90333fd0c72b1c35edc01291aa59726e712b113a2a68d8374038c959c6bc3079
+  data.tar.gz: cfb90ac0b7562e9b43201f7dafcbfa39a9adbd0a174923a1cbbf85e658012605
 SHA512:
-  metadata.gz: fc1b05b96e97d093d900533136ae38fc6aff5cdb8db2a2d614d864e70bfa624558079ef65ac36d4e294a01d9a7bcad754b223889f97bb2c81341e70941dfb5b2
-  data.tar.gz: 16cf00d713a78905b485c8fe2684783743620713c4b9ed8ad14edb0d74c22a522756b73115ccc562f66a6938fc8fb0e0e2e6be5a847488ea1e95a063350d0bdd
+  metadata.gz: f0cd6aaba61ad21962022a7afbce4a9d83cb1991be2a938116108d827af3444f2f495b4e4a9b3e55c69315bfe12b751a91d0f667c367b6b344270d7bc407fe45
+  data.tar.gz: 27a263f80ffd3e8b4fa4a022d04ae204cc8d43770e2d431e11d3471ffa7dfd6bf151ab8d9cb9cf232d982eb1cc07f3f92db5b6e8c12a7f296058408f74e1b328

data/CHANGELOG.md

@@ -1,6 +1,16 @@
 Unreleased Changes
 ------------------
 
+1.105.0 (2026-07-01)
+------------------
+
+* Feature - To create a Mustang domain via the AWS CLI, you must pass EngineMode OPTIMIZED (along with UseCase OBSERVABILITY or MIXED)  without it, the domain defaults to a regular (GENERAL) domain. Also this release includes Insights Feedback API which user can use to provide feedback for Insight API.
+
+1.104.0 (2026-06-19)
+------------------
+
+* Feature - This release introduces data source attachment APIs, enabling users to attach and detach Amazon OpenSearch Service domains and Amazon OpenSearch Serverless collections to an OpenSearch application.
+
 1.103.0 (2026-06-17)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.103.0
+1.105.0

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

@@ -810,6 +810,85 @@ module Aws::OpenSearchService
       req.send_request(options)
     end
 
+    # Attaches a data source to an OpenSearch application. The data source
+    # can be an Amazon OpenSearch Service domain or an Amazon OpenSearch
+    # Serverless collection. If both the application and data source are in
+    # the `ACTIVE` state, the attachment completes immediately and returns a
+    # status of `ATTACHED`. If either resource is not yet active, the
+    # operation stores the request and returns a status of `PENDING`. A
+    # background process then completes the attachment when both resources
+    # become active. Pending attachments that are not completed within 24
+    # hours are marked as `FAILED`. This operation is idempotent. If a data
+    # source is already attached or pending for the same application, the
+    # existing attachment is returned.
+    #
+    # @option params [required, String] :id
+    #   The unique identifier or name of the OpenSearch application to attach
+    #   the data source to. This is the same identifier used with
+    #   `UpdateApplication`, `GetApplication`, and `DeleteApplication`.
+    #
+    # @option params [required, String] :data_source_arn
+    #   The Amazon Resource Name (ARN) of the domain. See [Identifiers for IAM
+    #   Entities ][1] in *Using Amazon Web Services Identity and Access
+    #   Management* for more information.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/index.html
+    #
+    # @option params [String] :workspace_id
+    #   The identifier of an existing workspace to update with the new data
+    #   source. Mutually exclusive with `workspaceConfiguration`.
+    #
+    # @option params [Types::WorkspaceConfigurationInput] :workspace_configuration
+    #   Configuration for creating a new workspace during the attachment. If
+    #   specified, a workspace is created and linked to the data source after
+    #   the attachment completes. Mutually exclusive with `workspaceId`.
+    #
+    # @option params [String] :client_token
+    #   A unique, case-sensitive identifier to ensure idempotency of the
+    #   request. If you retry a request with the same client token and the
+    #   same parameters, the retry succeeds without performing any further
+    #   actions.
+    #
+    # @return [Types::AttachDataSourceResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::AttachDataSourceResponse#attachment_id #attachment_id} => String
+    #   * {Types::AttachDataSourceResponse#id #id} => String
+    #   * {Types::AttachDataSourceResponse#arn #arn} => String
+    #   * {Types::AttachDataSourceResponse#data_source_arn #data_source_arn} => String
+    #   * {Types::AttachDataSourceResponse#status #status} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.attach_data_source({
+    #     id: "Id", # required
+    #     data_source_arn: "ARN", # required
+    #     workspace_id: "String",
+    #     workspace_configuration: {
+    #       name: "String", # required
+    #       workspace_type: "String", # required
+    #     },
+    #     client_token: "ClientToken",
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.attachment_id #=> String
+    #   resp.id #=> String
+    #   resp.arn #=> String
+    #   resp.data_source_arn #=> String
+    #   resp.status #=> String, one of "PENDING", "ATTACHED", "FAILED"
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/opensearch-2021-01-01/AttachDataSource AWS API Documentation
+    #
+    # @overload attach_data_source(params = {})
+    # @param [Hash] params ({})
+    def attach_data_source(params = {}, options = {})
+      req = build_request(:attach_data_source, params)
+      req.send_request(options)
+    end
+
     # Provides access to an Amazon OpenSearch Service domain through the use
     # of an interface VPC endpoint.
     #
@@ -1207,6 +1286,14 @@ module Aws::OpenSearchService
     #
     #   Maximum suspension duration: 3 days.
     #
+    # @option params [String] :use_case
+    #   The primary use case for the domain. For valid values, see
+    #   `DomainUseCase`.
+    #
+    # @option params [String] :engine_mode
+    #   The engine mode for the domain. For valid values and requirements, see
+    #   `EngineMode`.
+    #
     # @return [Types::CreateDomainResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::CreateDomainResponse#domain_status #domain_status} => Types::DomainStatus
@@ -1383,6 +1470,8 @@ module Aws::OpenSearchService
     #       start_time: Time.now,
     #       end_time: Time.now,
     #     },
+    #     use_case: "SEARCH", # accepts SEARCH, VECTOR, OBSERVABILITY, MIXED
+    #     engine_mode: "GENERAL", # accepts GENERAL, OPTIMIZED
     #   })
     #
     # @example Response structure
@@ -1512,6 +1601,8 @@ module Aws::OpenSearchService
     #   resp.domain_status.automated_snapshot_pause_options.start_time #=> Time
     #   resp.domain_status.automated_snapshot_pause_options.end_time #=> Time
     #   resp.domain_status.automated_snapshot_pause_options.state #=> String, one of "Active", "Completed", "Scheduled", "Disabled"
+    #   resp.domain_status.use_case #=> String, one of "SEARCH", "VECTOR", "OBSERVABILITY", "MIXED"
+    #   resp.domain_status.engine_mode #=> String, one of "GENERAL", "OPTIMIZED"
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/opensearch-2021-01-01/CreateDomain AWS API Documentation
     #
@@ -2051,6 +2142,8 @@ module Aws::OpenSearchService
     #   resp.domain_status.automated_snapshot_pause_options.start_time #=> Time
     #   resp.domain_status.automated_snapshot_pause_options.end_time #=> Time
     #   resp.domain_status.automated_snapshot_pause_options.state #=> String, one of "Active", "Completed", "Scheduled", "Disabled"
+    #   resp.domain_status.use_case #=> String, one of "SEARCH", "VECTOR", "OBSERVABILITY", "MIXED"
+    #   resp.domain_status.engine_mode #=> String, one of "GENERAL", "OPTIMIZED"
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/opensearch-2021-01-01/DeleteDomain AWS API Documentation
     #
@@ -2311,6 +2404,55 @@ module Aws::OpenSearchService
       req.send_request(options)
     end
 
+    # Returns the current status and details of a specific data source
+    # attachment for an OpenSearch application. Throws a
+    # `ResourceNotFoundException` if no attachment record exists for the
+    # specified application and data source combination.
+    #
+    # @option params [required, String] :id
+    #   The unique identifier or name of the OpenSearch application.
+    #
+    # @option params [required, String] :data_source_arn
+    #   The Amazon Resource Name (ARN) of the domain. See [Identifiers for IAM
+    #   Entities ][1] in *Using Amazon Web Services Identity and Access
+    #   Management* for more information.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/index.html
+    #
+    # @return [Types::DescribeDataSourceAttachmentResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::DescribeDataSourceAttachmentResponse#attachment_id #attachment_id} => String
+    #   * {Types::DescribeDataSourceAttachmentResponse#id #id} => String
+    #   * {Types::DescribeDataSourceAttachmentResponse#arn #arn} => String
+    #   * {Types::DescribeDataSourceAttachmentResponse#data_source_arn #data_source_arn} => String
+    #   * {Types::DescribeDataSourceAttachmentResponse#status #status} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.describe_data_source_attachment({
+    #     id: "Id", # required
+    #     data_source_arn: "ARN", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.attachment_id #=> String
+    #   resp.id #=> String
+    #   resp.arn #=> String
+    #   resp.data_source_arn #=> String
+    #   resp.status #=> String, one of "PENDING", "ATTACHED", "FAILED"
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/opensearch-2021-01-01/DescribeDataSourceAttachment AWS API Documentation
+    #
+    # @overload describe_data_source_attachment(params = {})
+    # @param [Hash] params ({})
+    def describe_data_source_attachment(params = {}, options = {})
+      req = build_request(:describe_data_source_attachment, params)
+      req.send_request(options)
+    end
+
     # Describes the domain configuration for the specified Amazon OpenSearch
     # Service domain, including the domain ID, domain service endpoint, and
     # domain ARN.
@@ -2455,6 +2597,8 @@ module Aws::OpenSearchService
     #   resp.domain_status.automated_snapshot_pause_options.start_time #=> Time
     #   resp.domain_status.automated_snapshot_pause_options.end_time #=> Time
     #   resp.domain_status.automated_snapshot_pause_options.state #=> String, one of "Active", "Completed", "Scheduled", "Disabled"
+    #   resp.domain_status.use_case #=> String, one of "SEARCH", "VECTOR", "OBSERVABILITY", "MIXED"
+    #   resp.domain_status.engine_mode #=> String, one of "GENERAL", "OPTIMIZED"
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/opensearch-2021-01-01/DescribeDomain AWS API Documentation
     #
@@ -2808,6 +2952,18 @@ module Aws::OpenSearchService
     #   resp.domain_config.automated_snapshot_pause_options.status.update_version #=> Integer
     #   resp.domain_config.automated_snapshot_pause_options.status.state #=> String, one of "RequiresIndexDocuments", "Processing", "Active"
     #   resp.domain_config.automated_snapshot_pause_options.status.pending_deletion #=> Boolean
+    #   resp.domain_config.use_case.options #=> String, one of "SEARCH", "VECTOR", "OBSERVABILITY", "MIXED"
+    #   resp.domain_config.use_case.status.creation_date #=> Time
+    #   resp.domain_config.use_case.status.update_date #=> Time
+    #   resp.domain_config.use_case.status.update_version #=> Integer
+    #   resp.domain_config.use_case.status.state #=> String, one of "RequiresIndexDocuments", "Processing", "Active"
+    #   resp.domain_config.use_case.status.pending_deletion #=> Boolean
+    #   resp.domain_config.engine_mode.options #=> String, one of "GENERAL", "OPTIMIZED"
+    #   resp.domain_config.engine_mode.status.creation_date #=> Time
+    #   resp.domain_config.engine_mode.status.update_date #=> Time
+    #   resp.domain_config.engine_mode.status.update_version #=> Integer
+    #   resp.domain_config.engine_mode.status.state #=> String, one of "RequiresIndexDocuments", "Processing", "Active"
+    #   resp.domain_config.engine_mode.status.pending_deletion #=> Boolean
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/opensearch-2021-01-01/DescribeDomainConfig AWS API Documentation
     #
@@ -3062,6 +3218,8 @@ module Aws::OpenSearchService
     #   resp.domain_status_list[0].automated_snapshot_pause_options.start_time #=> Time
     #   resp.domain_status_list[0].automated_snapshot_pause_options.end_time #=> Time
     #   resp.domain_status_list[0].automated_snapshot_pause_options.state #=> String, one of "Active", "Completed", "Scheduled", "Disabled"
+    #   resp.domain_status_list[0].use_case #=> String, one of "SEARCH", "VECTOR", "OBSERVABILITY", "MIXED"
+    #   resp.domain_status_list[0].engine_mode #=> String, one of "GENERAL", "OPTIMIZED"
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/opensearch-2021-01-01/DescribeDomains AWS API Documentation
     #
@@ -3239,6 +3397,8 @@ module Aws::OpenSearchService
     #   resp.dry_run_config.automated_snapshot_pause_options.start_time #=> Time
     #   resp.dry_run_config.automated_snapshot_pause_options.end_time #=> Time
     #   resp.dry_run_config.automated_snapshot_pause_options.state #=> String, one of "Active", "Completed", "Scheduled", "Disabled"
+    #   resp.dry_run_config.use_case #=> String, one of "SEARCH", "VECTOR", "OBSERVABILITY", "MIXED"
+    #   resp.dry_run_config.engine_mode #=> String, one of "GENERAL", "OPTIMIZED"
     #   resp.dry_run_results.deployment_type #=> String
     #   resp.dry_run_results.message #=> String
     #
@@ -3744,6 +3904,54 @@ module Aws::OpenSearchService
       req.send_request(options)
     end
 
+    # Removes a data source from an OpenSearch application. The application
+    # must be in the `ACTIVE` state. This operation removes the data source
+    # saved object from the application and deletes the attachment record.
+    # Throws a `ConflictException` if the specified data source has a
+    # `PENDING` attachment, and a `ResourceNotFoundException` if the data
+    # source is not currently attached to the application.
+    #
+    # @option params [required, String] :id
+    #   The unique identifier or name of the OpenSearch application to detach
+    #   the data source from.
+    #
+    # @option params [required, String] :data_source_arn
+    #   The Amazon Resource Name (ARN) of the domain. See [Identifiers for IAM
+    #   Entities ][1] in *Using Amazon Web Services Identity and Access
+    #   Management* for more information.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/index.html
+    #
+    # @return [Types::DetachDataSourceResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::DetachDataSourceResponse#id #id} => String
+    #   * {Types::DetachDataSourceResponse#arn #arn} => String
+    #   * {Types::DetachDataSourceResponse#data_source_arn #data_source_arn} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.detach_data_source({
+    #     id: "Id", # required
+    #     data_source_arn: "ARN", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.id #=> String
+    #   resp.arn #=> String
+    #   resp.data_source_arn #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/opensearch-2021-01-01/DetachDataSource AWS API Documentation
+    #
+    # @overload detach_data_source(params = {})
+    # @param [Hash] params ({})
+    def detach_data_source(params = {}, options = {})
+      req = build_request(:detach_data_source, params)
+      req.send_request(options)
+    end
+
     # Removes a package from the specified Amazon OpenSearch Service domain.
     # The package can't be in use with any OpenSearch index for the
     # dissociation to succeed. The package is still available in OpenSearch
@@ -4312,6 +4520,54 @@ module Aws::OpenSearchService
       req.send_request(options)
     end
 
+    # Submits feedback for an existing insight in an Amazon OpenSearch
+    # Service domain. Allows users to provide a thumbs up or thumbs down
+    # rating and optional text feedback for a specific insight.
+    #
+    # @option params [required, Types::InsightFeedbackEntity] :entity
+    #   The entity for which to submit insight feedback. Specifies the type
+    #   and value of the entity, such as a domain name.
+    #
+    # @option params [required, String] :insight_id
+    #   The unique identifier of the insight for which to submit feedback.
+    #
+    # @option params [required, String] :thumbs
+    #   The thumbs up or thumbs down feedback for the insight. Possible values
+    #   are `Up` and `Down`.
+    #
+    # @option params [String] :feedback_text
+    #   Optional text feedback providing additional details about the insight.
+    #   Maximum length is 1000 characters.
+    #
+    # @return [Types::InsightFeedbackResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::InsightFeedbackResponse#status #status} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.insight_feedback({
+    #     entity: { # required
+    #       type: "DomainName", # required, accepts DomainName
+    #       value: "InsightEntityValue", # required
+    #     },
+    #     insight_id: "GUID", # required
+    #     thumbs: "Up", # required, accepts Up, Down
+    #     feedback_text: "InsightFeedbackText",
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.status #=> String, one of "SUCCESS", "ERROR"
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/opensearch-2021-01-01/InsightFeedback AWS API Documentation
+    #
+    # @overload insight_feedback(params = {})
+    # @param [Hash] params ({})
+    def insight_feedback(params = {}, options = {})
+      req = build_request(:insight_feedback, params)
+      req.send_request(options)
+    end
+
     # Lists all OpenSearch applications under your account.
     #
     # @option params [String] :next_token
@@ -4364,6 +4620,51 @@ module Aws::OpenSearchService
       req.send_request(options)
     end
 
+    # Returns a paginated list of all data source attachments for an
+    # OpenSearch application, including attachments in all states
+    # (`PENDING`, `ATTACHED`, and `FAILED`).
+    #
+    # @option params [required, String] :id
+    #   The unique identifier or name of the OpenSearch application to list
+    #   attachments for.
+    #
+    # @option params [String] :next_token
+    #   The pagination token from a previous call to retrieve the next set of
+    #   results.
+    #
+    # @option params [Integer] :max_results
+    #   The maximum number of results to return per page. The default is 50.
+    #
+    # @return [Types::ListDataSourceAttachmentsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ListDataSourceAttachmentsResponse#attachments #attachments} => Array<Types::DataSourceAttachmentSummary>
+    #   * {Types::ListDataSourceAttachmentsResponse#next_token #next_token} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.list_data_source_attachments({
+    #     id: "Id", # required
+    #     next_token: "String",
+    #     max_results: 1,
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.attachments #=> Array
+    #   resp.attachments[0].attachment_id #=> String
+    #   resp.attachments[0].data_source_arn #=> String
+    #   resp.attachments[0].status #=> String, one of "PENDING", "ATTACHED", "FAILED"
+    #   resp.next_token #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/opensearch-2021-01-01/ListDataSourceAttachments AWS API Documentation
+    #
+    # @overload list_data_source_attachments(params = {})
+    # @param [Hash] params ({})
+    def list_data_source_attachments(params = {}, options = {})
+      req = build_request(:list_data_source_attachments, params)
+      req.send_request(options)
+    end
+
     # Lists direct-query data sources for a specific domain. For more
     # information, see For more information, see [Working with Amazon
     # OpenSearch Service direct queries with Amazon S3][1].
@@ -5790,6 +6091,14 @@ module Aws::OpenSearchService
     #
     #   Maximum suspension duration: 3 days.
     #
+    # @option params [String] :use_case
+    #   The primary use case for the domain. For valid values, see
+    #   `DomainUseCase`.
+    #
+    # @option params [String] :engine_mode
+    #   The engine mode for the domain. The engine mode can't be changed
+    #   after the domain is created. For valid values, see `EngineMode`.
+    #
     # @return [Types::UpdateDomainConfigResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::UpdateDomainConfigResponse#domain_config #domain_config} => Types::DomainConfig
@@ -5964,6 +6273,8 @@ module Aws::OpenSearchService
     #       start_time: Time.now,
     #       end_time: Time.now,
     #     },
+    #     use_case: "SEARCH", # accepts SEARCH, VECTOR, OBSERVABILITY, MIXED
+    #     engine_mode: "GENERAL", # accepts GENERAL, OPTIMIZED
     #   })
     #
     # @example Response structure
@@ -6183,6 +6494,18 @@ module Aws::OpenSearchService
     #   resp.domain_config.automated_snapshot_pause_options.status.update_version #=> Integer
     #   resp.domain_config.automated_snapshot_pause_options.status.state #=> String, one of "RequiresIndexDocuments", "Processing", "Active"
     #   resp.domain_config.automated_snapshot_pause_options.status.pending_deletion #=> Boolean
+    #   resp.domain_config.use_case.options #=> String, one of "SEARCH", "VECTOR", "OBSERVABILITY", "MIXED"
+    #   resp.domain_config.use_case.status.creation_date #=> Time
+    #   resp.domain_config.use_case.status.update_date #=> Time
+    #   resp.domain_config.use_case.status.update_version #=> Integer
+    #   resp.domain_config.use_case.status.state #=> String, one of "RequiresIndexDocuments", "Processing", "Active"
+    #   resp.domain_config.use_case.status.pending_deletion #=> Boolean
+    #   resp.domain_config.engine_mode.options #=> String, one of "GENERAL", "OPTIMIZED"
+    #   resp.domain_config.engine_mode.status.creation_date #=> Time
+    #   resp.domain_config.engine_mode.status.update_date #=> Time
+    #   resp.domain_config.engine_mode.status.update_version #=> Integer
+    #   resp.domain_config.engine_mode.status.state #=> String, one of "RequiresIndexDocuments", "Processing", "Active"
+    #   resp.domain_config.engine_mode.status.pending_deletion #=> Boolean
     #   resp.dry_run_results.deployment_type #=> String
     #   resp.dry_run_results.message #=> String
     #   resp.dry_run_progress_status.dry_run_id #=> String
@@ -6600,7 +6923,7 @@ module Aws::OpenSearchService
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-opensearchservice'
-      context[:gem_version] = '1.103.0'
+      context[:gem_version] = '1.105.0'
       Seahorse::Client::Request.new(handlers, context)
     end