aws-sdk-xray 1.77.0 → 1.79.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0d06e60443dca534268705fcf2f5e666f814a36184cde08b292b6108a5ac373a
-  data.tar.gz: c80fe86b26e516ef37b18192b037e422f57f8fa48356ef515f9e0712bc84ffd8
+  metadata.gz: 45faebf65dac03920c0185775fdb5284ca472d0de08420c9b4253c68b6bb703e
+  data.tar.gz: 8bb96f7afb187182171e06297e5bfd86532b95a530b54fd2946c17ae38b35937
 SHA512:
-  metadata.gz: cb8288668ef382c0a687d26a3a36c3d1a4a3a71f0d6e187020935e1636f89f1a15b2e2f19e133f3cef0f317ba36c03a27fc701b6d0a246262b7d280b57eb3311
-  data.tar.gz: 04b0c831b71565503829e6c16e67733c84571f7d5ca32ca33cd5aeee203d5c55c8f34d34759597e9cf59be43418ed09ce4ab09938b08ed3ee6280c09223fbd5a
+  metadata.gz: 0b4ed769773dd6229f6db3b9a8e796d2d1a13f4bac21b21fea43a82ae2d2cb84deffe1daa6a490ddc509dd872e91b21af2420b18afa070a7d49825d7bb0993a5
+  data.tar.gz: 603370adf275299a99e69fca9edaa4603b3aac20e10ce68af597a5aad30628645ec40b24cf0974d68c1054dcb905c50f8d7880d72b9789d031fd2d33546b65a5

data/CHANGELOG.md

@@ -1,6 +1,16 @@
 Unreleased Changes
 ------------------
 
+1.79.0 (2025-01-15)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
+1.78.0 (2024-11-21)
+------------------
+
+* Feature - AWS X-Ray introduces Transaction Search APIs, enabling span ingestion into CloudWatch Logs for high-scale trace data indexing. These APIs support span-level queries, trace graph generation, and metric correlation for deeper application insights.
+
 1.77.0 (2024-10-18)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.77.0
+1.79.0

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

@@ -257,11 +257,34 @@ module Aws::XRay
     #     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:
+    #
+    #     * `when_supported` - (default) When set, a checksum will be
+    #       calculated for all request payloads of operations modeled with the
+    #       `httpChecksum` trait where `requestChecksumRequired` is `true` and/or a
+    #       `requestAlgorithmMember` is modeled.
+    #     * `when_required` - When set, a checksum will only be calculated for
+    #       request payloads of operations modeled with the  `httpChecksum` trait where
+    #       `requestChecksumRequired` is `true` or where a `requestAlgorithmMember`
+    #       is modeled and supplied.
+    #
     #   @option options [Integer] :request_min_compression_size_bytes (10240)
     #     The minimum size in bytes that triggers compression for request
     #     bodies. The value must be non-negative integer value between 0
     #     and 10485780 bytes inclusive.
     #
+    #   @option options [String] :response_checksum_validation ("when_supported")
+    #     Determines when checksum validation will be performed on response payloads. Values are:
+    #
+    #     * `when_supported` - (default) When set, checksum validation is performed on all
+    #       response payloads of operations modeled with the `httpChecksum` trait where
+    #       `responseAlgorithms` is modeled, except when no modeled checksum algorithms
+    #       are supported.
+    #     * `when_required` - When set, checksum validation is not performed on
+    #       response payloads of operations unless the checksum algorithm is supported and
+    #       the `requestValidationModeMember` member is set to `ENABLED`.
+    #
     #   @option options [Proc] :retry_backoff
     #     A proc or lambda used for backoff. Defaults to 2**retries * retry_base_delay.
     #     This option is only used in the `legacy` retry mode.
@@ -447,6 +470,11 @@ module Aws::XRay
 
     # @!group API Operations
 
+    # <note markdown="1"> You cannot find traces through this API if Transaction Search is
+    # enabled since trace is not indexed in X-Ray.
+    #
+    #  </note>
+    #
     # Retrieves a list of traces specified by ID. Each trace is a collection
     # of segment documents that originates from a single request. Use
     # `GetTraceSummaries` to get a list of trace IDs.
@@ -494,6 +522,30 @@ module Aws::XRay
       req.send_request(options)
     end
 
+    # Cancels an ongoing trace retrieval job initiated by
+    # `StartTraceRetrieval` using the provided `RetrievalToken`. A
+    # successful cancellation will return an HTTP 200 response.
+    #
+    # @option params [required, String] :retrieval_token
+    #   Retrieval token.
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.cancel_trace_retrieval({
+    #     retrieval_token: "RetrievalToken", # required
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/CancelTraceRetrieval AWS API Documentation
+    #
+    # @overload cancel_trace_retrieval(params = {})
+    # @param [Hash] params ({})
+    def cancel_trace_retrieval(params = {}, options = {})
+      req = build_request(:cancel_trace_retrieval, params)
+      req.send_request(options)
+    end
+
     # Creates a group resource with a name and a filter expression.
     #
     # @option params [required, String] :group_name
@@ -878,6 +930,49 @@ module Aws::XRay
       req.send_request(options)
     end
 
+    # Retrieves all indexing rules.
+    #
+    # Indexing rules are used to determine the server-side sampling rate for
+    # spans ingested through the CloudWatchLogs destination and indexed by
+    # X-Ray. For more information, see [Transaction Search][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Transaction-Search.html
+    #
+    # @option params [String] :next_token
+    #   Specify the pagination token returned by a previous request to
+    #   retrieve the next page of indexes.
+    #
+    # @return [Types::GetIndexingRulesResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::GetIndexingRulesResult#indexing_rules #indexing_rules} => Array&lt;Types::IndexingRule&gt;
+    #   * {Types::GetIndexingRulesResult#next_token #next_token} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.get_indexing_rules({
+    #     next_token: "String",
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.indexing_rules #=> Array
+    #   resp.indexing_rules[0].name #=> String
+    #   resp.indexing_rules[0].modified_at #=> Time
+    #   resp.indexing_rules[0].rule.probabilistic.desired_sampling_percentage #=> Float
+    #   resp.indexing_rules[0].rule.probabilistic.actual_sampling_percentage #=> Float
+    #   resp.next_token #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/GetIndexingRules AWS API Documentation
+    #
+    # @overload get_indexing_rules(params = {})
+    # @param [Hash] params ({})
+    def get_indexing_rules(params = {}, options = {})
+      req = build_request(:get_indexing_rules, params)
+      req.send_request(options)
+    end
+
     # Retrieves the summary information of an insight. This includes impact
     # to clients and root cause services, the top anomalous services, the
     # category, the state of the insight, and the start and end time of the
@@ -1149,6 +1244,119 @@ module Aws::XRay
       req.send_request(options)
     end
 
+    # Retrieves a service graph for traces based on the specified
+    # `RetrievalToken` from the CloudWatch log group generated by
+    # Transaction Search. This API does not initiate a retrieval job. You
+    # must first execute `StartTraceRetrieval` to obtain the required
+    # `RetrievalToken`.
+    #
+    # The trace graph describes services that process incoming requests and
+    # any downstream services they call, which may include Amazon Web
+    # Services resources, external APIs, or databases.
+    #
+    # The response is empty until the `RetrievalStatus` is *COMPLETE*. Retry
+    # the request after the status changes from *RUNNING* or *SCHEDULED* to
+    # *COMPLETE* to access the full service graph.
+    #
+    # When CloudWatch log is the destination, this API can support
+    # cross-account observability and service graph retrieval across linked
+    # accounts.
+    #
+    # For retrieving graphs from X-Ray directly as opposed to the
+    # Transaction-Search Log group, see [GetTraceGraph][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/xray/latest/api/API_GetTraceGraph.html
+    #
+    # @option params [required, String] :retrieval_token
+    #   Retrieval token.
+    #
+    # @option params [String] :next_token
+    #   Specify the pagination token returned by a previous request to
+    #   retrieve the next page of indexes.
+    #
+    # @return [Types::GetRetrievedTracesGraphResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::GetRetrievedTracesGraphResult#retrieval_status #retrieval_status} => String
+    #   * {Types::GetRetrievedTracesGraphResult#services #services} => Array&lt;Types::RetrievedService&gt;
+    #   * {Types::GetRetrievedTracesGraphResult#next_token #next_token} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.get_retrieved_traces_graph({
+    #     retrieval_token: "RetrievalToken", # required
+    #     next_token: "String",
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.retrieval_status #=> String, one of "SCHEDULED", "RUNNING", "COMPLETE", "FAILED", "CANCELLED", "TIMEOUT"
+    #   resp.services #=> Array
+    #   resp.services[0].service.reference_id #=> Integer
+    #   resp.services[0].service.name #=> String
+    #   resp.services[0].service.names #=> Array
+    #   resp.services[0].service.names[0] #=> String
+    #   resp.services[0].service.root #=> Boolean
+    #   resp.services[0].service.account_id #=> String
+    #   resp.services[0].service.type #=> String
+    #   resp.services[0].service.state #=> String
+    #   resp.services[0].service.start_time #=> Time
+    #   resp.services[0].service.end_time #=> Time
+    #   resp.services[0].service.edges #=> Array
+    #   resp.services[0].service.edges[0].reference_id #=> Integer
+    #   resp.services[0].service.edges[0].start_time #=> Time
+    #   resp.services[0].service.edges[0].end_time #=> Time
+    #   resp.services[0].service.edges[0].summary_statistics.ok_count #=> Integer
+    #   resp.services[0].service.edges[0].summary_statistics.error_statistics.throttle_count #=> Integer
+    #   resp.services[0].service.edges[0].summary_statistics.error_statistics.other_count #=> Integer
+    #   resp.services[0].service.edges[0].summary_statistics.error_statistics.total_count #=> Integer
+    #   resp.services[0].service.edges[0].summary_statistics.fault_statistics.other_count #=> Integer
+    #   resp.services[0].service.edges[0].summary_statistics.fault_statistics.total_count #=> Integer
+    #   resp.services[0].service.edges[0].summary_statistics.total_count #=> Integer
+    #   resp.services[0].service.edges[0].summary_statistics.total_response_time #=> Float
+    #   resp.services[0].service.edges[0].response_time_histogram #=> Array
+    #   resp.services[0].service.edges[0].response_time_histogram[0].value #=> Float
+    #   resp.services[0].service.edges[0].response_time_histogram[0].count #=> Integer
+    #   resp.services[0].service.edges[0].aliases #=> Array
+    #   resp.services[0].service.edges[0].aliases[0].name #=> String
+    #   resp.services[0].service.edges[0].aliases[0].names #=> Array
+    #   resp.services[0].service.edges[0].aliases[0].names[0] #=> String
+    #   resp.services[0].service.edges[0].aliases[0].type #=> String
+    #   resp.services[0].service.edges[0].edge_type #=> String
+    #   resp.services[0].service.edges[0].received_event_age_histogram #=> Array
+    #   resp.services[0].service.edges[0].received_event_age_histogram[0].value #=> Float
+    #   resp.services[0].service.edges[0].received_event_age_histogram[0].count #=> Integer
+    #   resp.services[0].service.summary_statistics.ok_count #=> Integer
+    #   resp.services[0].service.summary_statistics.error_statistics.throttle_count #=> Integer
+    #   resp.services[0].service.summary_statistics.error_statistics.other_count #=> Integer
+    #   resp.services[0].service.summary_statistics.error_statistics.total_count #=> Integer
+    #   resp.services[0].service.summary_statistics.fault_statistics.other_count #=> Integer
+    #   resp.services[0].service.summary_statistics.fault_statistics.total_count #=> Integer
+    #   resp.services[0].service.summary_statistics.total_count #=> Integer
+    #   resp.services[0].service.summary_statistics.total_response_time #=> Float
+    #   resp.services[0].service.duration_histogram #=> Array
+    #   resp.services[0].service.duration_histogram[0].value #=> Float
+    #   resp.services[0].service.duration_histogram[0].count #=> Integer
+    #   resp.services[0].service.response_time_histogram #=> Array
+    #   resp.services[0].service.response_time_histogram[0].value #=> Float
+    #   resp.services[0].service.response_time_histogram[0].count #=> Integer
+    #   resp.services[0].links #=> Array
+    #   resp.services[0].links[0].reference_type #=> String
+    #   resp.services[0].links[0].source_trace_id #=> String
+    #   resp.services[0].links[0].destination_trace_ids #=> Array
+    #   resp.services[0].links[0].destination_trace_ids[0] #=> String
+    #   resp.next_token #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/GetRetrievedTracesGraph AWS API Documentation
+    #
+    # @overload get_retrieved_traces_graph(params = {})
+    # @param [Hash] params ({})
+    def get_retrieved_traces_graph(params = {}, options = {})
+      req = build_request(:get_retrieved_traces_graph, params)
+      req.send_request(options)
+    end
+
     # Retrieves all sampling rules.
     #
     # @option params [String] :next_token
@@ -1571,6 +1779,35 @@ module Aws::XRay
       req.send_request(options)
     end
 
+    # Retrieves the current destination of data sent to `PutTraceSegments`
+    # and *OpenTelemetry* API. The Transaction Search feature requires a
+    # CloudWatchLogs destination. For more information, see [Transaction
+    # Search][1] and [OpenTelemetry][2].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Transaction-Search.html
+    # [2]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-OpenTelemetry-Sections.html
+    #
+    # @return [Types::GetTraceSegmentDestinationResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::GetTraceSegmentDestinationResult#destination #destination} => String
+    #   * {Types::GetTraceSegmentDestinationResult#status #status} => String
+    #
+    # @example Response structure
+    #
+    #   resp.destination #=> String, one of "XRay", "CloudWatchLogs"
+    #   resp.status #=> String, one of "PENDING", "ACTIVE"
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/GetTraceSegmentDestination AWS API Documentation
+    #
+    # @overload get_trace_segment_destination(params = {})
+    # @param [Hash] params ({})
+    def get_trace_segment_destination(params = {}, options = {})
+      req = build_request(:get_trace_segment_destination, params)
+      req.send_request(options)
+    end
+
     # Retrieves IDs and annotations for traces available for a specified
     # time frame using an optional filter. To get the full traces, pass the
     # trace IDs to `BatchGetTraces`.
@@ -1588,12 +1825,12 @@ module Aws::XRay
     # `annotation.account = "12345"`
     #
     # For a full list of indexed fields and keywords that you can use in
-    # filter expressions, see [Using Filter Expressions][1] in the *Amazon
-    # Web Services X-Ray Developer Guide*.
+    # filter expressions, see [Use filter expressions][1] in the *Amazon Web
+    # Services X-Ray Developer Guide*.
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/xray/latest/devguide/xray-console-filters.html
+    # [1]: https://docs.aws.amazon.com/xray/latest/devguide/aws-xray-interface-console.html#xray-console-filters
     #
     # @option params [required, Time,DateTime,Date,Integer,String] :start_time
     #   The start of the time frame for which to retrieve traces.
@@ -1602,8 +1839,8 @@ module Aws::XRay
     #   The end of the time frame for which to retrieve traces.
     #
     # @option params [String] :time_range_type
-    #   A parameter to indicate whether to query trace summaries by TraceId,
-    #   Event (trace update time), or Service (segment end time).
+    #   Query trace summaries by TraceId (trace start time), Event (trace
+    #   update time), or Service (trace segment end time).
     #
     # @option params [Boolean] :sampling
     #   Set to `true` to get summaries for only a subset of available traces.
@@ -1791,6 +2028,77 @@ module Aws::XRay
       req.send_request(options)
     end
 
+    # Retrieves a list of traces for a given `RetrievalToken` from the
+    # CloudWatch log group generated by Transaction Search. For information
+    # on what each trace returns, see [BatchGetTraces][1].
+    #
+    # This API does not initiate a retrieval job. To start a trace
+    # retrieval, use `StartTraceRetrieval`, which generates the required
+    # `RetrievalToken`.
+    #
+    # When the `RetrievalStatus` is not *COMPLETE*, the API will return an
+    # empty response. Retry the request once the retrieval has completed to
+    # access the full list of traces.
+    #
+    # For cross-account observability, this API can retrieve traces from
+    # linked accounts when CloudWatch log is the destination across relevant
+    # accounts. For more details, see [CloudWatch cross-account
+    # observability][2].
+    #
+    # For retrieving data from X-Ray directly as opposed to the
+    # Transaction-Search Log group, see [BatchGetTraces][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/xray/latest/api/API_BatchGetTraces.html
+    # [2]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html
+    #
+    # @option params [required, String] :retrieval_token
+    #   Retrieval token.
+    #
+    # @option params [String] :trace_format
+    #   Format of the requested traces.
+    #
+    # @option params [String] :next_token
+    #   Specify the pagination token returned by a previous request to
+    #   retrieve the next page of indexes.
+    #
+    # @return [Types::ListRetrievedTracesResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ListRetrievedTracesResult#retrieval_status #retrieval_status} => String
+    #   * {Types::ListRetrievedTracesResult#trace_format #trace_format} => String
+    #   * {Types::ListRetrievedTracesResult#traces #traces} => Array&lt;Types::RetrievedTrace&gt;
+    #   * {Types::ListRetrievedTracesResult#next_token #next_token} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.list_retrieved_traces({
+    #     retrieval_token: "RetrievalToken", # required
+    #     trace_format: "XRAY", # accepts XRAY, OTEL
+    #     next_token: "String",
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.retrieval_status #=> String, one of "SCHEDULED", "RUNNING", "COMPLETE", "FAILED", "CANCELLED", "TIMEOUT"
+    #   resp.trace_format #=> String, one of "XRAY", "OTEL"
+    #   resp.traces #=> Array
+    #   resp.traces[0].id #=> String
+    #   resp.traces[0].duration #=> Float
+    #   resp.traces[0].spans #=> Array
+    #   resp.traces[0].spans[0].id #=> String
+    #   resp.traces[0].spans[0].document #=> String
+    #   resp.next_token #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/ListRetrievedTraces AWS API Documentation
+    #
+    # @overload list_retrieved_traces(params = {})
+    # @param [Hash] params ({})
+    def list_retrieved_traces(params = {}, options = {})
+      req = build_request(:list_retrieved_traces, params)
+      req.send_request(options)
+    end
+
     # Returns a list of tags that are applied to the specified Amazon Web
     # Services X-Ray group or sampling rule.
     #
@@ -1995,13 +2303,12 @@ module Aws::XRay
       req.send_request(options)
     end
 
-    # Uploads segment documents to Amazon Web Services X-Ray. The [X-Ray
-    # SDK][1] generates segment documents and sends them to the X-Ray
-    # daemon, which uploads them in batches. A segment document can be a
-    # completed segment, an in-progress segment, or an array of subsegments.
+    # Uploads segment documents to Amazon Web Services X-Ray. A segment
+    # document can be a completed segment, an in-progress segment, or an
+    # array of subsegments.
     #
     # Segments must include the following fields. For the full segment
-    # document schema, see [Amazon Web Services X-Ray Segment Documents][2]
+    # document schema, see [Amazon Web Services X-Ray Segment Documents][1]
     # in the *Amazon Web Services X-Ray Developer Guide*.
     #
     # **Required segment document fields**
@@ -2030,7 +2337,9 @@ module Aws::XRay
     #   overwrite the in-progress segment.
     #
     # A `trace_id` consists of three numbers separated by hyphens. For
-    # example, 1-58406520-a006649127e371903a2de979. This includes:
+    # example, 1-58406520-a006649127e371903a2de979. For trace IDs created by
+    # an X-Ray SDK, or by Amazon Web Services services integrated with
+    # X-Ray, a trace ID includes:
     #
     # **Trace ID Format**
     #
@@ -2043,10 +2352,20 @@ module Aws::XRay
     # * A 96-bit identifier for the trace, globally unique, in 24
     #   hexadecimal digits.
     #
+    # <note markdown="1"> Trace IDs created via OpenTelemetry have a different format based on
+    # the [W3C Trace Context specification][2]. A W3C trace ID must be
+    # formatted in the X-Ray trace ID format when sending to X-Ray. For
+    # example, a W3C trace ID `4efaaf4d1e8720b39541901950019ee5` should be
+    # formatted as `1-4efaaf4d-1e8720b39541901950019ee5` when sending to
+    # X-Ray. While X-Ray trace IDs include the original request timestamp in
+    # Unix epoch time, this is not required or validated.
     #
+    #  </note>
     #
-    # [1]: https://docs.aws.amazon.com/xray/index.html
-    # [2]: https://docs.aws.amazon.com/xray/latest/devguide/xray-api-segmentdocuments.html
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/xray/latest/devguide/aws-xray-interface-api.html#xray-api-segmentdocuments.html
+    # [2]: https://www.w3.org/TR/trace-context/
     #
     # @option params [required, Array<String>] :trace_segment_documents
     #   A string containing a JSON document defining one or more segments or
@@ -2078,6 +2397,69 @@ module Aws::XRay
       req.send_request(options)
     end
 
+    # Initiates a trace retrieval process using the specified time range and
+    # for the give trace IDs on Transaction Search generated by the
+    # CloudWatch log group. For more information, see [Transaction
+    # Search][1].
+    #
+    # API returns a `RetrievalToken`, which can be used with
+    # `ListRetrievedTraces` or `GetRetrievedTracesGraph` to fetch results.
+    # Retrievals will time out after 60 minutes. To execute long time
+    # ranges, consider segmenting into multiple retrievals.
+    #
+    # If you are using [CloudWatch cross-account observability][2], you can
+    # use this operation in a monitoring account to retrieve data from a
+    # linked source account, as long as both accounts have transaction
+    # search enabled.
+    #
+    # For retrieving data from X-Ray directly as opposed to the
+    # Transaction-Search Log group, see [BatchGetTraces][3].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Transaction-Search.html
+    # [2]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html
+    # [3]: https://docs.aws.amazon.com/xray/latest/api/API_BatchGetTraces.html
+    #
+    # @option params [required, Array<String>] :trace_ids
+    #   Specify the trace IDs of the traces to be retrieved.
+    #
+    # @option params [required, Time,DateTime,Date,Integer,String] :start_time
+    #   The start of the time range to retrieve traces. The range is
+    #   inclusive, so the specified start time is included in the query.
+    #   Specified as epoch time, the number of seconds since January 1, 1970,
+    #   00:00:00 UTC.
+    #
+    # @option params [required, Time,DateTime,Date,Integer,String] :end_time
+    #   The end of the time range to retrieve traces. The range is inclusive,
+    #   so the specified end time is included in the query. Specified as epoch
+    #   time, the number of seconds since January 1, 1970, 00:00:00 UTC.
+    #
+    # @return [Types::StartTraceRetrievalResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::StartTraceRetrievalResult#retrieval_token #retrieval_token} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.start_trace_retrieval({
+    #     trace_ids: ["TraceId"], # required
+    #     start_time: Time.now, # required
+    #     end_time: Time.now, # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.retrieval_token #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/StartTraceRetrieval AWS API Documentation
+    #
+    # @overload start_trace_retrieval(params = {})
+    # @param [Hash] params ({})
+    def start_trace_retrieval(params = {}, options = {})
+      req = build_request(:start_trace_retrieval, params)
+      req.send_request(options)
+    end
+
     # Applies tags to an existing Amazon Web Services X-Ray group or
     # sampling rule.
     #
@@ -2216,6 +2598,53 @@ module Aws::XRay
       req.send_request(options)
     end
 
+    # Modifies an indexing rule’s configuration.
+    #
+    # Indexing rules are used for determining the sampling rate for spans
+    # indexed from CloudWatch Logs. For more information, see [Transaction
+    # Search][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Transaction-Search.html
+    #
+    # @option params [required, String] :name
+    #   Name of the indexing rule to be updated.
+    #
+    # @option params [required, Types::IndexingRuleValueUpdate] :rule
+    #   Rule configuration to be updated.
+    #
+    # @return [Types::UpdateIndexingRuleResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::UpdateIndexingRuleResult#indexing_rule #indexing_rule} => Types::IndexingRule
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.update_indexing_rule({
+    #     name: "String", # required
+    #     rule: { # required
+    #       probabilistic: {
+    #         desired_sampling_percentage: 1.0, # required
+    #       },
+    #     },
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.indexing_rule.name #=> String
+    #   resp.indexing_rule.modified_at #=> Time
+    #   resp.indexing_rule.rule.probabilistic.desired_sampling_percentage #=> Float
+    #   resp.indexing_rule.rule.probabilistic.actual_sampling_percentage #=> Float
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/UpdateIndexingRule AWS API Documentation
+    #
+    # @overload update_indexing_rule(params = {})
+    # @param [Hash] params ({})
+    def update_indexing_rule(params = {}, options = {})
+      req = build_request(:update_indexing_rule, params)
+      req.send_request(options)
+    end
+
     # Modifies a sampling rule's configuration.
     #
     # @option params [required, Types::SamplingRuleUpdate] :sampling_rule_update
@@ -2274,6 +2703,42 @@ module Aws::XRay
       req.send_request(options)
     end
 
+    # Modifies the destination of data sent to `PutTraceSegments`. The
+    # Transaction Search feature requires the CloudWatchLogs destination.
+    # For more information, see [Transaction Search][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Transaction-Search.html
+    #
+    # @option params [String] :destination
+    #   The configured destination of trace segments.
+    #
+    # @return [Types::UpdateTraceSegmentDestinationResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::UpdateTraceSegmentDestinationResult#destination #destination} => String
+    #   * {Types::UpdateTraceSegmentDestinationResult#status #status} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.update_trace_segment_destination({
+    #     destination: "XRay", # accepts XRay, CloudWatchLogs
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.destination #=> String, one of "XRay", "CloudWatchLogs"
+    #   resp.status #=> String, one of "PENDING", "ACTIVE"
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/UpdateTraceSegmentDestination AWS API Documentation
+    #
+    # @overload update_trace_segment_destination(params = {})
+    # @param [Hash] params ({})
+    def update_trace_segment_destination(params = {}, options = {})
+      req = build_request(:update_trace_segment_destination, params)
+      req.send_request(options)
+    end
+
     # @!endgroup
 
     # @param params ({})
@@ -2292,7 +2757,7 @@ module Aws::XRay
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-xray'
-      context[:gem_version] = '1.77.0'
+      context[:gem_version] = '1.79.0'
       Seahorse::Client::Request.new(handlers, context)
     end