@aws-sdk/client-xray 3.693.0 → 3.698.0

package/dist-types/models/models_0.d.ts

@@ -161,8 +161,8 @@ export interface BatchGetTracesRequest {
  *       compiled from documents uploaded with <a href="https://docs.aws.amazon.com/xray/latest/api/API_PutTraceSegments.html">PutTraceSegments</a>, or an
  *         <code>inferred</code> segment for a downstream service, generated from a subsegment sent by
  *       the service that called it.</p>
- *          <p>For the full segment document schema, see <a href="https://docs.aws.amazon.com/xray/latest/devguide/xray-api-segmentdocuments.html">Amazon Web Services X-Ray Segment
- *       Documents</a> in the <i>Amazon Web Services X-Ray Developer Guide</i>.</p>
+ *          <p>For the full segment document schema, see <a href="https://docs.aws.amazon.com/xray/latest/devguide/aws-xray-interface-api.html#xray-api-segmentdocuments">Amazon Web Services X-Ray segment
+ *       documents</a> in the <i>Amazon Web Services X-Ray Developer Guide</i>.</p>
  * @public
  */
 export interface Segment {
@@ -252,6 +252,38 @@ export declare class ThrottledException extends __BaseException {
      */
     constructor(opts: __ExceptionOptionType<ThrottledException, __BaseException>);
 }
+/**
+ * @public
+ */
+export interface CancelTraceRetrievalRequest {
+    /**
+     * <p>
+     * Retrieval token.
+     * </p>
+     * @public
+     */
+    RetrievalToken: string | undefined;
+}
+/**
+ * @public
+ */
+export interface CancelTraceRetrievalResult {
+}
+/**
+ * <p>The resource was not found. Verify that the name or Amazon Resource Name (ARN) of the resource is
+ *       correct.</p>
+ * @public
+ */
+export declare class ResourceNotFoundException extends __BaseException {
+    readonly name: "ResourceNotFoundException";
+    readonly $fault: "client";
+    Message?: string | undefined;
+    ResourceName?: string | undefined;
+    /**
+     * @internal
+     */
+    constructor(opts: __ExceptionOptionType<ResourceNotFoundException, __BaseException>);
+}
 /**
  * <p>The structure containing configurations related to insights.</p>
  * @public
@@ -805,6 +837,123 @@ export interface GetGroupsResult {
      */
     NextToken?: string | undefined;
 }
+/**
+ * @public
+ */
+export interface GetIndexingRulesRequest {
+    /**
+     * <p>
+     * Specify the pagination token returned by a previous request to retrieve the next page of indexes.
+     *
+     *
+     * </p>
+     * @public
+     */
+    NextToken?: string | undefined;
+}
+/**
+ * <p>
+ *   The indexing rule configuration for probabilistic sampling.
+ * </p>
+ * @public
+ */
+export interface ProbabilisticRuleValue {
+    /**
+     * <p>
+     *   Configured sampling percentage of traceIds. Note that sampling can be subject to limits to ensure completeness of data.
+     * </p>
+     * @public
+     */
+    DesiredSamplingPercentage: number | undefined;
+    /**
+     * <p>
+     *   Applied sampling percentage of traceIds.
+     * </p>
+     * @public
+     */
+    ActualSamplingPercentage?: number | undefined;
+}
+/**
+ * <p>
+ *   The indexing rule configuration.
+ * </p>
+ * @public
+ */
+export type IndexingRuleValue = IndexingRuleValue.ProbabilisticMember | IndexingRuleValue.$UnknownMember;
+/**
+ * @public
+ */
+export declare namespace IndexingRuleValue {
+    /**
+     * <p>
+     *   Indexing rule configuration that is used to probabilistically  sample traceIds.
+     * </p>
+     * @public
+     */
+    interface ProbabilisticMember {
+        Probabilistic: ProbabilisticRuleValue;
+        $unknown?: never;
+    }
+    /**
+     * @public
+     */
+    interface $UnknownMember {
+        Probabilistic?: never;
+        $unknown: [string, any];
+    }
+    interface Visitor<T> {
+        Probabilistic: (value: ProbabilisticRuleValue) => T;
+        _: (name: string, value: any) => T;
+    }
+    const visit: <T>(value: IndexingRuleValue, visitor: Visitor<T>) => T;
+}
+/**
+ * <p>
+ * Rule used to determine the server-side sampling rate for spans ingested through the CloudWatchLogs destination and indexed by X-Ray.
+ * </p>
+ * @public
+ */
+export interface IndexingRule {
+    /**
+     * <p>
+     *   The name of the indexing rule.
+     * </p>
+     * @public
+     */
+    Name?: string | undefined;
+    /**
+     * <p>
+     * Displays when the rule was last modified, in Unix time seconds.
+     * </p>
+     * @public
+     */
+    ModifiedAt?: Date | undefined;
+    /**
+     * <p>
+     *   The indexing rule.
+     * </p>
+     * @public
+     */
+    Rule?: IndexingRuleValue | undefined;
+}
+/**
+ * @public
+ */
+export interface GetIndexingRulesResult {
+    /**
+     * <p>
+     *     Retrieves all indexing rules.</p>
+     * @public
+     */
+    IndexingRules?: IndexingRule[] | undefined;
+    /**
+     * <p>
+     *       Specify the pagination token returned by a previous request to retrieve the next page of indexes.
+     *     </p>
+     * @public
+     */
+    NextToken?: string | undefined;
+}
 /**
  * @public
  */
@@ -1275,503 +1424,618 @@ export interface GetInsightSummariesResult {
 /**
  * @public
  */
-export interface GetSamplingRulesRequest {
+export interface GetRetrievedTracesGraphRequest {
     /**
-     * <p>Pagination token.</p>
+     * <p>
+     *     Retrieval token.
+     *   </p>
+     * @public
+     */
+    RetrievalToken: string | undefined;
+    /**
+     * <p>
+     *     Specify the pagination token returned by a previous request to retrieve the next page of indexes.
+     *
+     *
+     *   </p>
      * @public
      */
     NextToken?: string | undefined;
 }
 /**
  * @public
+ * @enum
  */
-export interface GetSamplingRulesResult {
+export declare const RetrievalStatus: {
+    readonly CANCELLED: "CANCELLED";
+    readonly COMPLETE: "COMPLETE";
+    readonly FAILED: "FAILED";
+    readonly RUNNING: "RUNNING";
+    readonly SCHEDULED: "SCHEDULED";
+    readonly TIMEOUT: "TIMEOUT";
+};
+/**
+ * @public
+ */
+export type RetrievalStatus = (typeof RetrievalStatus)[keyof typeof RetrievalStatus];
+/**
+ * <p>
+ * The relation between two services.
+ * </p>
+ * @public
+ */
+export interface GraphLink {
     /**
-     * <p>Rule definitions and metadata.</p>
+     * <p>
+     * Relationship of a trace to the corresponding service.
+     * </p>
      * @public
      */
-    SamplingRuleRecords?: SamplingRuleRecord[] | undefined;
+    ReferenceType?: string | undefined;
     /**
-     * <p>Pagination token.</p>
+     * <p>
+     * Source trace of a link relationship.
+     * </p>
      * @public
      */
-    NextToken?: string | undefined;
-}
-/**
- * @public
- */
-export interface GetSamplingStatisticSummariesRequest {
+    SourceTraceId?: string | undefined;
     /**
-     * <p>Pagination token.</p>
+     * <p>
+     * Destination traces of a link relationship.
+     * </p>
      * @public
      */
-    NextToken?: string | undefined;
+    DestinationTraceIds?: string[] | undefined;
 }
 /**
- * <p>Aggregated request sampling data for a sampling rule across all services for a 10-second window.</p>
+ * <p>An entry in a histogram for a statistic. A histogram maps the range of observed values
+ *       on the X axis, and the prevalence of each value on the Y axis.</p>
  * @public
  */
-export interface SamplingStatisticSummary {
+export interface HistogramEntry {
     /**
-     * <p>The name of the sampling rule.</p>
+     * <p>The value of the entry.</p>
      * @public
      */
-    RuleName?: string | undefined;
+    Value?: number | undefined;
     /**
-     * <p>The start time of the reporting window.</p>
+     * <p>The prevalence of the entry.</p>
      * @public
      */
-    Timestamp?: Date | undefined;
+    Count?: number | undefined;
+}
+/**
+ * <p>Information about requests that failed with a 4xx Client Error status code.</p>
+ * @public
+ */
+export interface ErrorStatistics {
     /**
-     * <p>The number of requests that matched the rule.</p>
+     * <p>The number of requests that failed with a 429 throttling status code.</p>
      * @public
      */
-    RequestCount?: number | undefined;
+    ThrottleCount?: number | undefined;
     /**
-     * <p>The number of requests recorded with borrowed reservoir quota.</p>
+     * <p>The number of requests that failed with untracked 4xx Client Error status
+     *       codes.</p>
      * @public
      */
-    BorrowCount?: number | undefined;
+    OtherCount?: number | undefined;
     /**
-     * <p>The number of requests recorded.</p>
+     * <p>The total number of requests that failed with a 4xx Client Error status code.</p>
      * @public
      */
-    SampledCount?: number | undefined;
+    TotalCount?: number | undefined;
 }
 /**
+ * <p>Information about requests that failed with a 5xx Server Error status code.</p>
  * @public
  */
-export interface GetSamplingStatisticSummariesResult {
+export interface FaultStatistics {
     /**
-     * <p>Information about the number of requests instrumented for each sampling
-     *          rule.</p>
+     * <p>The number of requests that failed with untracked 5xx Server Error status
+     *       codes.</p>
      * @public
      */
-    SamplingStatisticSummaries?: SamplingStatisticSummary[] | undefined;
+    OtherCount?: number | undefined;
     /**
-     * <p>Pagination token.</p>
+     * <p>The total number of requests that failed with a 5xx Server Error status code.</p>
      * @public
      */
-    NextToken?: string | undefined;
+    TotalCount?: number | undefined;
 }
 /**
- * <p>Request sampling results for a single rule from a service. Results are for the last 10
- *       seconds unless the service has been assigned a longer reporting interval after a previous call
- *       to <a href="https://docs.aws.amazon.com/xray/latest/api/API_GetSamplingTargets.html">GetSamplingTargets</a>.</p>
+ * <p>Response statistics for an edge.</p>
  * @public
  */
-export interface SamplingStatisticsDocument {
-    /**
-     * <p>The name of the sampling rule.</p>
-     * @public
-     */
-    RuleName: string | undefined;
-    /**
-     * <p>A unique identifier for the service in hexadecimal.</p>
-     * @public
-     */
-    ClientID: string | undefined;
+export interface EdgeStatistics {
     /**
-     * <p>The current time.</p>
+     * <p>The number of requests that completed with a 2xx Success status code.</p>
      * @public
      */
-    Timestamp: Date | undefined;
+    OkCount?: number | undefined;
     /**
-     * <p>The number of requests that matched the rule.</p>
+     * <p>Information about requests that failed with a 4xx Client Error status code.</p>
      * @public
      */
-    RequestCount: number | undefined;
+    ErrorStatistics?: ErrorStatistics | undefined;
     /**
-     * <p>The number of requests recorded.</p>
+     * <p>Information about requests that failed with a 5xx Server Error status code.</p>
      * @public
      */
-    SampledCount: number | undefined;
+    FaultStatistics?: FaultStatistics | undefined;
     /**
-     * <p>The number of requests recorded with borrowed reservoir quota.</p>
+     * <p>The total number of completed requests.</p>
      * @public
      */
-    BorrowCount?: number | undefined;
-}
-/**
- * @public
- */
-export interface GetSamplingTargetsRequest {
+    TotalCount?: number | undefined;
     /**
-     * <p>Information about rules that the service is using to sample requests.</p>
+     * <p>The aggregate response time of completed requests.</p>
      * @public
      */
-    SamplingStatisticsDocuments: SamplingStatisticsDocument[] | undefined;
+    TotalResponseTime?: number | undefined;
 }
 /**
- * <p>Temporary changes to a sampling rule configuration. To meet the global sampling target for a rule, X-Ray
- *       calculates a new reservoir for each service based on the recent sampling results of all services that called
- *       <a href="https://docs.aws.amazon.com/xray/latest/api/API_GetSamplingTargets.html">GetSamplingTargets</a>.</p>
+ * <p>Information about a connection between two services. An edge can be a synchronous connection, such as typical
+ *     call between client and service, or an asynchronous link, such as a Lambda function which retrieves an event from an
+ *     SNS queue.</p>
  * @public
  */
-export interface SamplingTargetDocument {
+export interface Edge {
     /**
-     * <p>The name of the sampling rule.</p>
+     * <p>Identifier of the edge. Unique within a service map.</p>
      * @public
      */
-    RuleName?: string | undefined;
+    ReferenceId?: number | undefined;
     /**
-     * <p>The percentage of matching requests to instrument, after the reservoir is
-     *       exhausted.</p>
+     * <p>The start time of the first segment on the edge.</p>
      * @public
      */
-    FixedRate?: number | undefined;
+    StartTime?: Date | undefined;
     /**
-     * <p>The number of requests per second that X-Ray allocated for this service.</p>
+     * <p>The end time of the last segment on the edge.</p>
      * @public
      */
-    ReservoirQuota?: number | undefined;
+    EndTime?: Date | undefined;
     /**
-     * <p>When the reservoir quota expires.</p>
+     * <p>Response statistics for segments on the edge.</p>
      * @public
      */
-    ReservoirQuotaTTL?: Date | undefined;
+    SummaryStatistics?: EdgeStatistics | undefined;
     /**
-     * <p>The number of seconds for the service to wait before getting sampling targets
-     *       again.</p>
+     * <p>A histogram that maps the spread of client response times on an edge. Only populated
+     *              for synchronous edges.</p>
      * @public
      */
-    Interval?: number | undefined;
-}
-/**
- * <p>Sampling statistics from a call to <a href="https://docs.aws.amazon.com/xray/latest/api/API_GetSamplingTargets.html">GetSamplingTargets</a> that X-Ray
- *       could not process.</p>
- * @public
- */
-export interface UnprocessedStatistics {
+    ResponseTimeHistogram?: HistogramEntry[] | undefined;
     /**
-     * <p>The name of the sampling rule.</p>
+     * <p>Aliases for the edge.</p>
      * @public
      */
-    RuleName?: string | undefined;
+    Aliases?: Alias[] | undefined;
     /**
-     * <p>The error code.</p>
+     * <p>Describes an asynchronous connection, with a value of <code>link</code>.</p>
      * @public
      */
-    ErrorCode?: string | undefined;
+    EdgeType?: string | undefined;
     /**
-     * <p>The error message.</p>
+     * <p>A histogram that maps the spread of event age when received by consumers.
+     *       Age is calculated each time an event is received. Only populated when <i>EdgeType</i> is
+     *       <code>link</code>.</p>
      * @public
      */
-    Message?: string | undefined;
+    ReceivedEventAgeHistogram?: HistogramEntry[] | undefined;
 }
 /**
+ * <p>Response statistics for a service.</p>
  * @public
  */
-export interface GetSamplingTargetsResult {
+export interface ServiceStatistics {
     /**
-     * <p>Updated rules that the service should use to sample requests.</p>
+     * <p>The number of requests that completed with a 2xx Success status code.</p>
      * @public
      */
-    SamplingTargetDocuments?: SamplingTargetDocument[] | undefined;
+    OkCount?: number | undefined;
     /**
-     * <p>The last time a user changed the sampling rule configuration. If
-     *          the sampling rule configuration changed since the service last retrieved it, the service
-     *          should call <a href="https://docs.aws.amazon.com/xray/latest/api/API_GetSamplingRules.html">GetSamplingRules</a> to get the latest version.</p>
+     * <p>Information about requests that failed with a 4xx Client Error status code.</p>
      * @public
      */
-    LastRuleModification?: Date | undefined;
+    ErrorStatistics?: ErrorStatistics | undefined;
     /**
-     * <p>Information about <a href="https://docs.aws.amazon.com/xray/latest/api/API_SamplingStatisticsDocument.html">SamplingStatisticsDocument</a> that X-Ray could not
-     *          process.</p>
+     * <p>Information about requests that failed with a 5xx Server Error status code.</p>
      * @public
      */
-    UnprocessedStatistics?: UnprocessedStatistics[] | undefined;
+    FaultStatistics?: FaultStatistics | undefined;
+    /**
+     * <p>The total number of completed requests.</p>
+     * @public
+     */
+    TotalCount?: number | undefined;
+    /**
+     * <p>The aggregate response time of completed requests.</p>
+     * @public
+     */
+    TotalResponseTime?: number | undefined;
 }
 /**
+ * <p>Information about an application that processed requests, users that made requests, or downstream services,
+ *       resources, and applications that an application used.</p>
  * @public
  */
-export interface GetServiceGraphRequest {
+export interface Service {
     /**
-     * <p>The start of the time frame for which to generate a graph.</p>
+     * <p>Identifier for the service. Unique within the service map.</p>
      * @public
      */
-    StartTime: Date | undefined;
+    ReferenceId?: number | undefined;
     /**
-     * <p>The end of the timeframe for which to generate a graph.</p>
+     * <p>The canonical name of the service.</p>
      * @public
      */
-    EndTime: Date | undefined;
+    Name?: string | undefined;
     /**
-     * <p>The name of a group based on which you want to generate a graph.</p>
+     * <p>A list of names for the service, including the canonical name.</p>
      * @public
      */
-    GroupName?: string | undefined;
+    Names?: string[] | undefined;
     /**
-     * <p>The Amazon Resource Name (ARN) of a group based on which you want to generate a graph.</p>
+     * <p>Indicates that the service was the first service to process a request.</p>
      * @public
      */
-    GroupARN?: string | undefined;
+    Root?: boolean | undefined;
     /**
-     * <p>Pagination token.</p>
+     * <p>Identifier of the Amazon Web Services account in which the service runs.</p>
      * @public
      */
-    NextToken?: string | undefined;
-}
-/**
- * <p>An entry in a histogram for a statistic. A histogram maps the range of observed values
- *       on the X axis, and the prevalence of each value on the Y axis.</p>
- * @public
- */
-export interface HistogramEntry {
+    AccountId?: string | undefined;
     /**
-     * <p>The value of the entry.</p>
+     * <p>The type of service.</p>
+     *          <ul>
+     *             <li>
+     *                <p>Amazon Web Services Resource - The type of an Amazon Web Services resource. For example, <code>AWS::EC2::Instance</code> for an
+     *           application running on Amazon EC2 or <code>AWS::DynamoDB::Table</code> for an Amazon DynamoDB table that the
+     *           application used.</p>
+     *             </li>
+     *             <li>
+     *                <p>Amazon Web Services Service - The type of an Amazon Web Services service. For example, <code>AWS::DynamoDB</code>
+     *           for downstream calls to Amazon DynamoDB that didn't target a specific table.</p>
+     *             </li>
+     *             <li>
+     *                <p>
+     *                   <code>client</code> - Represents the clients that sent requests to a root
+     *           service.</p>
+     *             </li>
+     *             <li>
+     *                <p>
+     *                   <code>remote</code> - A downstream service of indeterminate type.</p>
+     *             </li>
+     *          </ul>
      * @public
      */
-    Value?: number | undefined;
+    Type?: string | undefined;
     /**
-     * <p>The prevalence of the entry.</p>
+     * <p>The service's state.</p>
      * @public
      */
-    Count?: number | undefined;
-}
-/**
- * <p>Information about requests that failed with a 4xx Client Error status code.</p>
- * @public
- */
-export interface ErrorStatistics {
+    State?: string | undefined;
     /**
-     * <p>The number of requests that failed with a 419 throttling status code.</p>
+     * <p>The start time of the first segment that the service generated.</p>
      * @public
      */
-    ThrottleCount?: number | undefined;
+    StartTime?: Date | undefined;
     /**
-     * <p>The number of requests that failed with untracked 4xx Client Error status
-     *       codes.</p>
+     * <p>The end time of the last segment that the service generated.</p>
      * @public
      */
-    OtherCount?: number | undefined;
+    EndTime?: Date | undefined;
     /**
-     * <p>The total number of requests that failed with a 4xx Client Error status code.</p>
+     * <p>Connections to downstream services.</p>
      * @public
      */
-    TotalCount?: number | undefined;
+    Edges?: Edge[] | undefined;
+    /**
+     * <p>Aggregated statistics for the service.</p>
+     * @public
+     */
+    SummaryStatistics?: ServiceStatistics | undefined;
+    /**
+     * <p>A histogram that maps the spread of service durations.</p>
+     * @public
+     */
+    DurationHistogram?: HistogramEntry[] | undefined;
+    /**
+     * <p>A histogram that maps the spread of service response times.</p>
+     * @public
+     */
+    ResponseTimeHistogram?: HistogramEntry[] | undefined;
 }
 /**
- * <p>Information about requests that failed with a 5xx Server Error status code.</p>
+ * <p>
+ *   Retrieved information about an application that processed requests, users that made requests, or downstream services, resources, and applications that an application used.
+ * </p>
  * @public
  */
-export interface FaultStatistics {
+export interface RetrievedService {
     /**
-     * <p>The number of requests that failed with untracked 5xx Server Error status
-     *       codes.</p>
+     * <p>Information about an application that processed requests, users that made requests, or downstream services,
+     *       resources, and applications that an application used.</p>
      * @public
      */
-    OtherCount?: number | undefined;
+    Service?: Service | undefined;
     /**
-     * <p>The total number of requests that failed with a 5xx Server Error status code.</p>
+     * <p>
+     *  Relation between two 2 services.
+     * </p>
      * @public
      */
-    TotalCount?: number | undefined;
+    Links?: GraphLink[] | undefined;
 }
 /**
- * <p>Response statistics for an edge.</p>
  * @public
  */
-export interface EdgeStatistics {
+export interface GetRetrievedTracesGraphResult {
     /**
-     * <p>The number of requests that completed with a 2xx Success status code.</p>
+     * <p>
+     * Status of the retrieval.
+     * </p>
      * @public
      */
-    OkCount?: number | undefined;
+    RetrievalStatus?: RetrievalStatus | undefined;
     /**
-     * <p>Information about requests that failed with a 4xx Client Error status code.</p>
+     * <p>
+     * Retrieved services.
+     * </p>
      * @public
      */
-    ErrorStatistics?: ErrorStatistics | undefined;
+    Services?: RetrievedService[] | undefined;
     /**
-     * <p>Information about requests that failed with a 5xx Server Error status code.</p>
+     * <p>
+     *     Specify the pagination token returned by a previous request to retrieve the next page of indexes.
+     *
+     *
+     *   </p>
      * @public
      */
-    FaultStatistics?: FaultStatistics | undefined;
+    NextToken?: string | undefined;
+}
+/**
+ * @public
+ */
+export interface GetSamplingRulesRequest {
     /**
-     * <p>The total number of completed requests.</p>
+     * <p>Pagination token.</p>
      * @public
      */
-    TotalCount?: number | undefined;
+    NextToken?: string | undefined;
+}
+/**
+ * @public
+ */
+export interface GetSamplingRulesResult {
     /**
-     * <p>The aggregate response time of completed requests.</p>
+     * <p>Rule definitions and metadata.</p>
      * @public
      */
-    TotalResponseTime?: number | undefined;
+    SamplingRuleRecords?: SamplingRuleRecord[] | undefined;
+    /**
+     * <p>Pagination token.</p>
+     * @public
+     */
+    NextToken?: string | undefined;
 }
 /**
- * <p>Information about a connection between two services. An edge can be a synchronous connection, such as typical
- *     call between client and service, or an asynchronous link, such as a Lambda function which retrieves an event from an
- *     SNS queue.</p>
  * @public
  */
-export interface Edge {
+export interface GetSamplingStatisticSummariesRequest {
     /**
-     * <p>Identifier of the edge. Unique within a service map.</p>
+     * <p>Pagination token.</p>
      * @public
      */
-    ReferenceId?: number | undefined;
+    NextToken?: string | undefined;
+}
+/**
+ * <p>Aggregated request sampling data for a sampling rule across all services for a 10-second window.</p>
+ * @public
+ */
+export interface SamplingStatisticSummary {
     /**
-     * <p>The start time of the first segment on the edge.</p>
+     * <p>The name of the sampling rule.</p>
      * @public
      */
-    StartTime?: Date | undefined;
+    RuleName?: string | undefined;
     /**
-     * <p>The end time of the last segment on the edge.</p>
+     * <p>The start time of the reporting window.</p>
      * @public
      */
-    EndTime?: Date | undefined;
+    Timestamp?: Date | undefined;
     /**
-     * <p>Response statistics for segments on the edge.</p>
+     * <p>The number of requests that matched the rule.</p>
      * @public
      */
-    SummaryStatistics?: EdgeStatistics | undefined;
+    RequestCount?: number | undefined;
     /**
-     * <p>A histogram that maps the spread of client response times on an edge. Only populated
-     *              for synchronous edges.</p>
+     * <p>The number of requests recorded with borrowed reservoir quota.</p>
      * @public
      */
-    ResponseTimeHistogram?: HistogramEntry[] | undefined;
+    BorrowCount?: number | undefined;
     /**
-     * <p>Aliases for the edge.</p>
+     * <p>The number of requests recorded.</p>
      * @public
      */
-    Aliases?: Alias[] | undefined;
+    SampledCount?: number | undefined;
+}
+/**
+ * @public
+ */
+export interface GetSamplingStatisticSummariesResult {
     /**
-     * <p>Describes an asynchronous connection, with a value of <code>link</code>.</p>
+     * <p>Information about the number of requests instrumented for each sampling
+     *          rule.</p>
      * @public
      */
-    EdgeType?: string | undefined;
+    SamplingStatisticSummaries?: SamplingStatisticSummary[] | undefined;
     /**
-     * <p>A histogram that maps the spread of event age when received by consumers.
-     *       Age is calculated each time an event is received. Only populated when <i>EdgeType</i> is
-     *       <code>link</code>.</p>
+     * <p>Pagination token.</p>
      * @public
      */
-    ReceivedEventAgeHistogram?: HistogramEntry[] | undefined;
+    NextToken?: string | undefined;
 }
 /**
- * <p>Response statistics for a service.</p>
+ * <p>Request sampling results for a single rule from a service. Results are for the last 10
+ *       seconds unless the service has been assigned a longer reporting interval after a previous call
+ *       to <a href="https://docs.aws.amazon.com/xray/latest/api/API_GetSamplingTargets.html">GetSamplingTargets</a>.</p>
  * @public
  */
-export interface ServiceStatistics {
+export interface SamplingStatisticsDocument {
     /**
-     * <p>The number of requests that completed with a 2xx Success status code.</p>
+     * <p>The name of the sampling rule.</p>
      * @public
      */
-    OkCount?: number | undefined;
+    RuleName: string | undefined;
     /**
-     * <p>Information about requests that failed with a 4xx Client Error status code.</p>
+     * <p>A unique identifier for the service in hexadecimal.</p>
      * @public
      */
-    ErrorStatistics?: ErrorStatistics | undefined;
+    ClientID: string | undefined;
     /**
-     * <p>Information about requests that failed with a 5xx Server Error status code.</p>
+     * <p>The current time.</p>
      * @public
      */
-    FaultStatistics?: FaultStatistics | undefined;
+    Timestamp: Date | undefined;
     /**
-     * <p>The total number of completed requests.</p>
+     * <p>The number of requests that matched the rule.</p>
      * @public
      */
-    TotalCount?: number | undefined;
+    RequestCount: number | undefined;
     /**
-     * <p>The aggregate response time of completed requests.</p>
+     * <p>The number of requests recorded.</p>
      * @public
      */
-    TotalResponseTime?: number | undefined;
+    SampledCount: number | undefined;
+    /**
+     * <p>The number of requests recorded with borrowed reservoir quota.</p>
+     * @public
+     */
+    BorrowCount?: number | undefined;
 }
 /**
- * <p>Information about an application that processed requests, users that made requests, or downstream services,
- *       resources, and applications that an application used.</p>
  * @public
  */
-export interface Service {
+export interface GetSamplingTargetsRequest {
     /**
-     * <p>Identifier for the service. Unique within the service map.</p>
+     * <p>Information about rules that the service is using to sample requests.</p>
      * @public
      */
-    ReferenceId?: number | undefined;
+    SamplingStatisticsDocuments: SamplingStatisticsDocument[] | undefined;
+}
+/**
+ * <p>Temporary changes to a sampling rule configuration. To meet the global sampling target for a rule, X-Ray
+ *       calculates a new reservoir for each service based on the recent sampling results of all services that called
+ *       <a href="https://docs.aws.amazon.com/xray/latest/api/API_GetSamplingTargets.html">GetSamplingTargets</a>.</p>
+ * @public
+ */
+export interface SamplingTargetDocument {
     /**
-     * <p>The canonical name of the service.</p>
+     * <p>The name of the sampling rule.</p>
      * @public
      */
-    Name?: string | undefined;
+    RuleName?: string | undefined;
     /**
-     * <p>A list of names for the service, including the canonical name.</p>
+     * <p>The percentage of matching requests to instrument, after the reservoir is
+     *       exhausted.</p>
      * @public
      */
-    Names?: string[] | undefined;
+    FixedRate?: number | undefined;
     /**
-     * <p>Indicates that the service was the first service to process a request.</p>
+     * <p>The number of requests per second that X-Ray allocated for this service.</p>
      * @public
      */
-    Root?: boolean | undefined;
+    ReservoirQuota?: number | undefined;
     /**
-     * <p>Identifier of the Amazon Web Services account in which the service runs.</p>
+     * <p>When the reservoir quota expires.</p>
      * @public
      */
-    AccountId?: string | undefined;
+    ReservoirQuotaTTL?: Date | undefined;
     /**
-     * <p>The type of service.</p>
-     *          <ul>
-     *             <li>
-     *                <p>Amazon Web Services Resource - The type of an Amazon Web Services resource. For example, <code>AWS::EC2::Instance</code> for an
-     *           application running on Amazon EC2 or <code>AWS::DynamoDB::Table</code> for an Amazon DynamoDB table that the
-     *           application used.</p>
-     *             </li>
-     *             <li>
-     *                <p>Amazon Web Services Service - The type of an Amazon Web Services service. For example, <code>AWS::DynamoDB</code>
-     *           for downstream calls to Amazon DynamoDB that didn't target a specific table.</p>
-     *             </li>
-     *             <li>
-     *                <p>
-     *                   <code>client</code> - Represents the clients that sent requests to a root
-     *           service.</p>
-     *             </li>
-     *             <li>
-     *                <p>
-     *                   <code>remote</code> - A downstream service of indeterminate type.</p>
-     *             </li>
-     *          </ul>
+     * <p>The number of seconds for the service to wait before getting sampling targets
+     *       again.</p>
+     * @public
+     */
+    Interval?: number | undefined;
+}
+/**
+ * <p>Sampling statistics from a call to <a href="https://docs.aws.amazon.com/xray/latest/api/API_GetSamplingTargets.html">GetSamplingTargets</a> that X-Ray
+ *       could not process.</p>
+ * @public
+ */
+export interface UnprocessedStatistics {
+    /**
+     * <p>The name of the sampling rule.</p>
      * @public
      */
-    Type?: string | undefined;
+    RuleName?: string | undefined;
     /**
-     * <p>The service's state.</p>
+     * <p>The error code.</p>
      * @public
      */
-    State?: string | undefined;
+    ErrorCode?: string | undefined;
     /**
-     * <p>The start time of the first segment that the service generated.</p>
+     * <p>The error message.</p>
      * @public
      */
-    StartTime?: Date | undefined;
+    Message?: string | undefined;
+}
+/**
+ * @public
+ */
+export interface GetSamplingTargetsResult {
     /**
-     * <p>The end time of the last segment that the service generated.</p>
+     * <p>Updated rules that the service should use to sample requests.</p>
      * @public
      */
-    EndTime?: Date | undefined;
+    SamplingTargetDocuments?: SamplingTargetDocument[] | undefined;
     /**
-     * <p>Connections to downstream services.</p>
+     * <p>The last time a user changed the sampling rule configuration. If
+     *          the sampling rule configuration changed since the service last retrieved it, the service
+     *          should call <a href="https://docs.aws.amazon.com/xray/latest/api/API_GetSamplingRules.html">GetSamplingRules</a> to get the latest version.</p>
      * @public
      */
-    Edges?: Edge[] | undefined;
+    LastRuleModification?: Date | undefined;
     /**
-     * <p>Aggregated statistics for the service.</p>
+     * <p>Information about <a href="https://docs.aws.amazon.com/xray/latest/api/API_SamplingStatisticsDocument.html">SamplingStatisticsDocument</a> that X-Ray could not
+     *          process.</p>
      * @public
      */
-    SummaryStatistics?: ServiceStatistics | undefined;
+    UnprocessedStatistics?: UnprocessedStatistics[] | undefined;
+}
+/**
+ * @public
+ */
+export interface GetServiceGraphRequest {
     /**
-     * <p>A histogram that maps the spread of service durations.</p>
+     * <p>The start of the time frame for which to generate a graph.</p>
      * @public
      */
-    DurationHistogram?: HistogramEntry[] | undefined;
+    StartTime: Date | undefined;
     /**
-     * <p>A histogram that maps the spread of service response times.</p>
+     * <p>The end of the timeframe for which to generate a graph.</p>
      * @public
      */
-    ResponseTimeHistogram?: HistogramEntry[] | undefined;
+    EndTime: Date | undefined;
+    /**
+     * <p>The name of a group based on which you want to generate a graph.</p>
+     * @public
+     */
+    GroupName?: string | undefined;
+    /**
+     * <p>The Amazon Resource Name (ARN) of a group based on which you want to generate a graph.</p>
+     * @public
+     */
+    GroupARN?: string | undefined;
+    /**
+     * <p>Pagination token.</p>
+     * @public
+     */
+    NextToken?: string | undefined;
 }
 /**
  * @public
@@ -1953,6 +2217,54 @@ export interface GetTraceGraphResult {
      */
     NextToken?: string | undefined;
 }
+/**
+ * @public
+ */
+export interface GetTraceSegmentDestinationRequest {
+}
+/**
+ * @public
+ * @enum
+ */
+export declare const TraceSegmentDestination: {
+    readonly CloudWatchLogs: "CloudWatchLogs";
+    readonly XRay: "XRay";
+};
+/**
+ * @public
+ */
+export type TraceSegmentDestination = (typeof TraceSegmentDestination)[keyof typeof TraceSegmentDestination];
+/**
+ * @public
+ * @enum
+ */
+export declare const TraceSegmentDestinationStatus: {
+    readonly ACTIVE: "ACTIVE";
+    readonly PENDING: "PENDING";
+};
+/**
+ * @public
+ */
+export type TraceSegmentDestinationStatus = (typeof TraceSegmentDestinationStatus)[keyof typeof TraceSegmentDestinationStatus];
+/**
+ * @public
+ */
+export interface GetTraceSegmentDestinationResult {
+    /**
+     * <p>
+     * Retrieves the current destination.
+     * </p>
+     * @public
+     */
+    Destination?: TraceSegmentDestination | undefined;
+    /**
+     * <p>
+     *     Status of the retrieval.
+     *   </p>
+     * @public
+     */
+    Status?: TraceSegmentDestinationStatus | undefined;
+}
 /**
  * @public
  * @enum
@@ -2009,7 +2321,7 @@ export interface GetTraceSummariesRequest {
      */
     EndTime: Date | undefined;
     /**
-     * <p>A parameter to indicate whether to query trace summaries by TraceId, Event (trace update time), or Service (segment end time).</p>
+     * <p>Query trace summaries by TraceId (trace start time), Event (trace update time), or Service (trace segment end time).</p>
      * @public
      */
     TimeRangeType?: TimeRangeType | undefined;
@@ -2548,6 +2860,129 @@ export interface ListResourcePoliciesResult {
      */
     NextToken?: string | undefined;
 }
+/**
+ * @public
+ * @enum
+ */
+export declare const TraceFormatType: {
+    readonly OTEL: "OTEL";
+    readonly XRAY: "XRAY";
+};
+/**
+ * @public
+ */
+export type TraceFormatType = (typeof TraceFormatType)[keyof typeof TraceFormatType];
+/**
+ * @public
+ */
+export interface ListRetrievedTracesRequest {
+    /**
+     * <p>
+     * Retrieval token.
+     * </p>
+     * @public
+     */
+    RetrievalToken: string | undefined;
+    /**
+     * <p>
+     * Format of the requested traces.
+     * </p>
+     * @public
+     */
+    TraceFormat?: TraceFormatType | undefined;
+    /**
+     * <p>
+     *     Specify the pagination token returned by a previous request to retrieve the next page of indexes.
+     *
+     *
+     *   </p>
+     * @public
+     */
+    NextToken?: string | undefined;
+}
+/**
+ * <p>
+ *   A span from a trace that has been ingested by the X-Ray service. A span represents a unit of work or an operation performed by a service.
+ * </p>
+ * @public
+ */
+export interface Span {
+    /**
+     * <p>The span ID.</p>
+     * @public
+     */
+    Id?: string | undefined;
+    /**
+     * <p>
+     * The span document.</p>
+     * @public
+     */
+    Document?: string | undefined;
+}
+/**
+ * <p>
+ *   Retrieved collection of spans with matching trace IDs.
+ * </p>
+ * @public
+ */
+export interface RetrievedTrace {
+    /**
+     * <p>
+     *   The unique identifier for the span.
+     * </p>
+     * @public
+     */
+    Id?: string | undefined;
+    /**
+     * <p>
+     *   The length of time in seconds between the start time of the root span and the end time of the last span that completed.
+     * </p>
+     * @public
+     */
+    Duration?: number | undefined;
+    /**
+     * <p>
+     *   Spans that comprise the trace.
+     * </p>
+     * @public
+     */
+    Spans?: Span[] | undefined;
+}
+/**
+ * @public
+ */
+export interface ListRetrievedTracesResult {
+    /**
+     * <p>
+     *     Status of the retrieval.
+     *   </p>
+     * @public
+     */
+    RetrievalStatus?: RetrievalStatus | undefined;
+    /**
+     * <p>
+     *     Format of the requested traces.
+     *   </p>
+     * @public
+     */
+    TraceFormat?: TraceFormatType | undefined;
+    /**
+     * <p>
+     * Full traces for the specified requests.
+     * </p>
+     * @public
+     */
+    Traces?: RetrievedTrace[] | undefined;
+    /**
+     * <p>
+     *     Specify the pagination token returned by a previous request to retrieve the next page of indexes.
+     *
+     *
+     *   </p>
+     * @public
+     */
+    NextToken?: string | undefined;
+}
 /**
  * @public
  */
@@ -2580,21 +3015,6 @@ export interface ListTagsForResourceResponse {
      */
     NextToken?: string | undefined;
 }
-/**
- * <p>The resource was not found. Verify that the name or Amazon Resource Name (ARN) of the resource is
- *       correct.</p>
- * @public
- */
-export declare class ResourceNotFoundException extends __BaseException {
-    readonly name: "ResourceNotFoundException";
-    readonly $fault: "client";
-    Message?: string | undefined;
-    ResourceName?: string | undefined;
-    /**
-     * @internal
-     */
-    constructor(opts: __ExceptionOptionType<ResourceNotFoundException, __BaseException>);
-}
 /**
  * @public
  */
@@ -2881,6 +3301,45 @@ export interface PutTraceSegmentsResult {
      */
     UnprocessedTraceSegments?: UnprocessedTraceSegment[] | undefined;
 }
+/**
+ * @public
+ */
+export interface StartTraceRetrievalRequest {
+    /**
+     * <p>
+     *   Specify the trace IDs of the traces to be retrieved.
+     * </p>
+     * @public
+     */
+    TraceIds: string[] | undefined;
+    /**
+     * <p>
+     *   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.
+     * </p>
+     * @public
+     */
+    StartTime: Date | undefined;
+    /**
+     * <p>
+     *   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.</p>
+     * @public
+     */
+    EndTime: Date | undefined;
+}
+/**
+ * @public
+ */
+export interface StartTraceRetrievalResult {
+    /**
+     * <p>
+     * Retrieval token.
+     * </p>
+     * @public
+     */
+    RetrievalToken?: string | undefined;
+}
 /**
  * @public
  */
@@ -3007,6 +3466,86 @@ export interface UpdateGroupResult {
      */
     Group?: Group | undefined;
 }
+/**
+ * <p>
+ *   Update to the indexing rule configuration for probabilistic sampling.
+ * </p>
+ * @public
+ */
+export interface ProbabilisticRuleValueUpdate {
+    /**
+     * <p>
+     *   Configured sampling percentage of traceIds. Note that sampling can be subject to limits to ensure completeness of data.
+     * </p>
+     * @public
+     */
+    DesiredSamplingPercentage: number | undefined;
+}
+/**
+ * <p>
+ *   Update to an indexing rule.
+ * </p>
+ * @public
+ */
+export type IndexingRuleValueUpdate = IndexingRuleValueUpdate.ProbabilisticMember | IndexingRuleValueUpdate.$UnknownMember;
+/**
+ * @public
+ */
+export declare namespace IndexingRuleValueUpdate {
+    /**
+     * <p>
+     *     Indexing rule configuration that is used to probabilistically  sample traceIds.
+     *   </p>
+     * @public
+     */
+    interface ProbabilisticMember {
+        Probabilistic: ProbabilisticRuleValueUpdate;
+        $unknown?: never;
+    }
+    /**
+     * @public
+     */
+    interface $UnknownMember {
+        Probabilistic?: never;
+        $unknown: [string, any];
+    }
+    interface Visitor<T> {
+        Probabilistic: (value: ProbabilisticRuleValueUpdate) => T;
+        _: (name: string, value: any) => T;
+    }
+    const visit: <T>(value: IndexingRuleValueUpdate, visitor: Visitor<T>) => T;
+}
+/**
+ * @public
+ */
+export interface UpdateIndexingRuleRequest {
+    /**
+     * <p>
+     *   Name of the indexing rule to be updated.
+     * </p>
+     * @public
+     */
+    Name: string | undefined;
+    /**
+     * <p>
+     *     Rule configuration to be updated.
+     *   </p>
+     * @public
+     */
+    Rule: IndexingRuleValueUpdate | undefined;
+}
+/**
+ * @public
+ */
+export interface UpdateIndexingRuleResult {
+    /**
+     * <p>
+     *     Updated indexing rule.
+     *   </p>
+     * @public
+     */
+    IndexingRule?: IndexingRule | undefined;
+}
 /**
  * <p>A document specifying changes to a sampling rule's configuration.</p>
  * @public
@@ -3095,3 +3634,34 @@ export interface UpdateSamplingRuleResult {
      */
     SamplingRuleRecord?: SamplingRuleRecord | undefined;
 }
+/**
+ * @public
+ */
+export interface UpdateTraceSegmentDestinationRequest {
+    /**
+     * <p>
+     * The configured destination of trace segments.
+     * </p>
+     * @public
+     */
+    Destination?: TraceSegmentDestination | undefined;
+}
+/**
+ * @public
+ */
+export interface UpdateTraceSegmentDestinationResult {
+    /**
+     * <p>
+     *     The destination of the trace segments.
+     *   </p>
+     * @public
+     */
+    Destination?: TraceSegmentDestination | undefined;
+    /**
+     * <p>
+     * The status of the update.
+     * </p>
+     * @public
+     */
+    Status?: TraceSegmentDestinationStatus | undefined;
+}