@aws-sdk/client-xray 3.696.0 → 3.698.0

package/dist-types/XRayClient.d.ts

@@ -8,6 +8,7 @@ import { Client as __Client, DefaultsMode as __DefaultsMode, SmithyConfiguration
 import { AwsCredentialIdentityProvider, BodyLengthCalculator as __BodyLengthCalculator, CheckOptionalClientConfig as __CheckOptionalClientConfig, ChecksumConstructor as __ChecksumConstructor, Decoder as __Decoder, Encoder as __Encoder, HashConstructor as __HashConstructor, HttpHandlerOptions as __HttpHandlerOptions, Logger as __Logger, Provider as __Provider, Provider, StreamCollector as __StreamCollector, UrlParser as __UrlParser, UserAgent as __UserAgent } from "@smithy/types";
 import { HttpAuthSchemeInputConfig, HttpAuthSchemeResolvedConfig } from "./auth/httpAuthSchemeProvider";
 import { BatchGetTracesCommandInput, BatchGetTracesCommandOutput } from "./commands/BatchGetTracesCommand";
+import { CancelTraceRetrievalCommandInput, CancelTraceRetrievalCommandOutput } from "./commands/CancelTraceRetrievalCommand";
 import { CreateGroupCommandInput, CreateGroupCommandOutput } from "./commands/CreateGroupCommand";
 import { CreateSamplingRuleCommandInput, CreateSamplingRuleCommandOutput } from "./commands/CreateSamplingRuleCommand";
 import { DeleteGroupCommandInput, DeleteGroupCommandOutput } from "./commands/DeleteGroupCommand";
@@ -16,38 +17,45 @@ import { DeleteSamplingRuleCommandInput, DeleteSamplingRuleCommandOutput } from
 import { GetEncryptionConfigCommandInput, GetEncryptionConfigCommandOutput } from "./commands/GetEncryptionConfigCommand";
 import { GetGroupCommandInput, GetGroupCommandOutput } from "./commands/GetGroupCommand";
 import { GetGroupsCommandInput, GetGroupsCommandOutput } from "./commands/GetGroupsCommand";
+import { GetIndexingRulesCommandInput, GetIndexingRulesCommandOutput } from "./commands/GetIndexingRulesCommand";
 import { GetInsightCommandInput, GetInsightCommandOutput } from "./commands/GetInsightCommand";
 import { GetInsightEventsCommandInput, GetInsightEventsCommandOutput } from "./commands/GetInsightEventsCommand";
 import { GetInsightImpactGraphCommandInput, GetInsightImpactGraphCommandOutput } from "./commands/GetInsightImpactGraphCommand";
 import { GetInsightSummariesCommandInput, GetInsightSummariesCommandOutput } from "./commands/GetInsightSummariesCommand";
+import { GetRetrievedTracesGraphCommandInput, GetRetrievedTracesGraphCommandOutput } from "./commands/GetRetrievedTracesGraphCommand";
 import { GetSamplingRulesCommandInput, GetSamplingRulesCommandOutput } from "./commands/GetSamplingRulesCommand";
 import { GetSamplingStatisticSummariesCommandInput, GetSamplingStatisticSummariesCommandOutput } from "./commands/GetSamplingStatisticSummariesCommand";
 import { GetSamplingTargetsCommandInput, GetSamplingTargetsCommandOutput } from "./commands/GetSamplingTargetsCommand";
 import { GetServiceGraphCommandInput, GetServiceGraphCommandOutput } from "./commands/GetServiceGraphCommand";
 import { GetTimeSeriesServiceStatisticsCommandInput, GetTimeSeriesServiceStatisticsCommandOutput } from "./commands/GetTimeSeriesServiceStatisticsCommand";
 import { GetTraceGraphCommandInput, GetTraceGraphCommandOutput } from "./commands/GetTraceGraphCommand";
+import { GetTraceSegmentDestinationCommandInput, GetTraceSegmentDestinationCommandOutput } from "./commands/GetTraceSegmentDestinationCommand";
 import { GetTraceSummariesCommandInput, GetTraceSummariesCommandOutput } from "./commands/GetTraceSummariesCommand";
 import { ListResourcePoliciesCommandInput, ListResourcePoliciesCommandOutput } from "./commands/ListResourcePoliciesCommand";
+import { ListRetrievedTracesCommandInput, ListRetrievedTracesCommandOutput } from "./commands/ListRetrievedTracesCommand";
 import { ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput } from "./commands/ListTagsForResourceCommand";
 import { PutEncryptionConfigCommandInput, PutEncryptionConfigCommandOutput } from "./commands/PutEncryptionConfigCommand";
 import { PutResourcePolicyCommandInput, PutResourcePolicyCommandOutput } from "./commands/PutResourcePolicyCommand";
 import { PutTelemetryRecordsCommandInput, PutTelemetryRecordsCommandOutput } from "./commands/PutTelemetryRecordsCommand";
 import { PutTraceSegmentsCommandInput, PutTraceSegmentsCommandOutput } from "./commands/PutTraceSegmentsCommand";
+import { StartTraceRetrievalCommandInput, StartTraceRetrievalCommandOutput } from "./commands/StartTraceRetrievalCommand";
 import { TagResourceCommandInput, TagResourceCommandOutput } from "./commands/TagResourceCommand";
 import { UntagResourceCommandInput, UntagResourceCommandOutput } from "./commands/UntagResourceCommand";
 import { UpdateGroupCommandInput, UpdateGroupCommandOutput } from "./commands/UpdateGroupCommand";
+import { UpdateIndexingRuleCommandInput, UpdateIndexingRuleCommandOutput } from "./commands/UpdateIndexingRuleCommand";
 import { UpdateSamplingRuleCommandInput, UpdateSamplingRuleCommandOutput } from "./commands/UpdateSamplingRuleCommand";
+import { UpdateTraceSegmentDestinationCommandInput, UpdateTraceSegmentDestinationCommandOutput } from "./commands/UpdateTraceSegmentDestinationCommand";
 import { ClientInputEndpointParameters, ClientResolvedEndpointParameters, EndpointParameters } from "./endpoint/EndpointParameters";
 import { RuntimeExtension, RuntimeExtensionsConfig } from "./runtimeExtensions";
 export { __Client };
 /**
  * @public
  */
-export type ServiceInputTypes = BatchGetTracesCommandInput | CreateGroupCommandInput | CreateSamplingRuleCommandInput | DeleteGroupCommandInput | DeleteResourcePolicyCommandInput | DeleteSamplingRuleCommandInput | GetEncryptionConfigCommandInput | GetGroupCommandInput | GetGroupsCommandInput | GetInsightCommandInput | GetInsightEventsCommandInput | GetInsightImpactGraphCommandInput | GetInsightSummariesCommandInput | GetSamplingRulesCommandInput | GetSamplingStatisticSummariesCommandInput | GetSamplingTargetsCommandInput | GetServiceGraphCommandInput | GetTimeSeriesServiceStatisticsCommandInput | GetTraceGraphCommandInput | GetTraceSummariesCommandInput | ListResourcePoliciesCommandInput | ListTagsForResourceCommandInput | PutEncryptionConfigCommandInput | PutResourcePolicyCommandInput | PutTelemetryRecordsCommandInput | PutTraceSegmentsCommandInput | TagResourceCommandInput | UntagResourceCommandInput | UpdateGroupCommandInput | UpdateSamplingRuleCommandInput;
+export type ServiceInputTypes = BatchGetTracesCommandInput | CancelTraceRetrievalCommandInput | CreateGroupCommandInput | CreateSamplingRuleCommandInput | DeleteGroupCommandInput | DeleteResourcePolicyCommandInput | DeleteSamplingRuleCommandInput | GetEncryptionConfigCommandInput | GetGroupCommandInput | GetGroupsCommandInput | GetIndexingRulesCommandInput | GetInsightCommandInput | GetInsightEventsCommandInput | GetInsightImpactGraphCommandInput | GetInsightSummariesCommandInput | GetRetrievedTracesGraphCommandInput | GetSamplingRulesCommandInput | GetSamplingStatisticSummariesCommandInput | GetSamplingTargetsCommandInput | GetServiceGraphCommandInput | GetTimeSeriesServiceStatisticsCommandInput | GetTraceGraphCommandInput | GetTraceSegmentDestinationCommandInput | GetTraceSummariesCommandInput | ListResourcePoliciesCommandInput | ListRetrievedTracesCommandInput | ListTagsForResourceCommandInput | PutEncryptionConfigCommandInput | PutResourcePolicyCommandInput | PutTelemetryRecordsCommandInput | PutTraceSegmentsCommandInput | StartTraceRetrievalCommandInput | TagResourceCommandInput | UntagResourceCommandInput | UpdateGroupCommandInput | UpdateIndexingRuleCommandInput | UpdateSamplingRuleCommandInput | UpdateTraceSegmentDestinationCommandInput;
 /**
  * @public
  */
-export type ServiceOutputTypes = BatchGetTracesCommandOutput | CreateGroupCommandOutput | CreateSamplingRuleCommandOutput | DeleteGroupCommandOutput | DeleteResourcePolicyCommandOutput | DeleteSamplingRuleCommandOutput | GetEncryptionConfigCommandOutput | GetGroupCommandOutput | GetGroupsCommandOutput | GetInsightCommandOutput | GetInsightEventsCommandOutput | GetInsightImpactGraphCommandOutput | GetInsightSummariesCommandOutput | GetSamplingRulesCommandOutput | GetSamplingStatisticSummariesCommandOutput | GetSamplingTargetsCommandOutput | GetServiceGraphCommandOutput | GetTimeSeriesServiceStatisticsCommandOutput | GetTraceGraphCommandOutput | GetTraceSummariesCommandOutput | ListResourcePoliciesCommandOutput | ListTagsForResourceCommandOutput | PutEncryptionConfigCommandOutput | PutResourcePolicyCommandOutput | PutTelemetryRecordsCommandOutput | PutTraceSegmentsCommandOutput | TagResourceCommandOutput | UntagResourceCommandOutput | UpdateGroupCommandOutput | UpdateSamplingRuleCommandOutput;
+export type ServiceOutputTypes = BatchGetTracesCommandOutput | CancelTraceRetrievalCommandOutput | CreateGroupCommandOutput | CreateSamplingRuleCommandOutput | DeleteGroupCommandOutput | DeleteResourcePolicyCommandOutput | DeleteSamplingRuleCommandOutput | GetEncryptionConfigCommandOutput | GetGroupCommandOutput | GetGroupsCommandOutput | GetIndexingRulesCommandOutput | GetInsightCommandOutput | GetInsightEventsCommandOutput | GetInsightImpactGraphCommandOutput | GetInsightSummariesCommandOutput | GetRetrievedTracesGraphCommandOutput | GetSamplingRulesCommandOutput | GetSamplingStatisticSummariesCommandOutput | GetSamplingTargetsCommandOutput | GetServiceGraphCommandOutput | GetTimeSeriesServiceStatisticsCommandOutput | GetTraceGraphCommandOutput | GetTraceSegmentDestinationCommandOutput | GetTraceSummariesCommandOutput | ListResourcePoliciesCommandOutput | ListRetrievedTracesCommandOutput | ListTagsForResourceCommandOutput | PutEncryptionConfigCommandOutput | PutResourcePolicyCommandOutput | PutTelemetryRecordsCommandOutput | PutTraceSegmentsCommandOutput | StartTraceRetrievalCommandOutput | TagResourceCommandOutput | UntagResourceCommandOutput | UpdateGroupCommandOutput | UpdateIndexingRuleCommandOutput | UpdateSamplingRuleCommandOutput | UpdateTraceSegmentDestinationCommandOutput;
 /**
  * @public
  */

package/dist-types/commands/BatchGetTracesCommand.d.ts

@@ -27,7 +27,10 @@ declare const BatchGetTracesCommand_base: {
     getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
 };
 /**
- * <p>Retrieves a list of traces specified by ID. Each trace is a collection of segment
+ * <note>
+ *             <p>You cannot find traces through this API if Transaction Search is enabled since trace is not indexed in X-Ray.</p>
+ *          </note>
+ *          <p>Retrieves a list of traces specified by ID. Each trace is a collection of segment
  *       documents that originates from a single request. Use <code>GetTraceSummaries</code> to get a
  *       list of trace IDs.</p>
  * @example

package/dist-types/commands/CancelTraceRetrievalCommand.d.ts

@@ -0,0 +1,81 @@
+import { Command as $Command } from "@smithy/smithy-client";
+import { MetadataBearer as __MetadataBearer } from "@smithy/types";
+import { CancelTraceRetrievalRequest, CancelTraceRetrievalResult } from "../models/models_0";
+import { ServiceInputTypes, ServiceOutputTypes, XRayClientResolvedConfig } from "../XRayClient";
+/**
+ * @public
+ */
+export type { __MetadataBearer };
+export { $Command };
+/**
+ * @public
+ *
+ * The input for {@link CancelTraceRetrievalCommand}.
+ */
+export interface CancelTraceRetrievalCommandInput extends CancelTraceRetrievalRequest {
+}
+/**
+ * @public
+ *
+ * The output of {@link CancelTraceRetrievalCommand}.
+ */
+export interface CancelTraceRetrievalCommandOutput extends CancelTraceRetrievalResult, __MetadataBearer {
+}
+declare const CancelTraceRetrievalCommand_base: {
+    new (input: CancelTraceRetrievalCommandInput): import("@smithy/smithy-client").CommandImpl<CancelTraceRetrievalCommandInput, CancelTraceRetrievalCommandOutput, XRayClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
+    new (__0_0: CancelTraceRetrievalCommandInput): import("@smithy/smithy-client").CommandImpl<CancelTraceRetrievalCommandInput, CancelTraceRetrievalCommandOutput, XRayClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
+    getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
+};
+/**
+ * <p>
+ * Cancels an ongoing trace retrieval job initiated by <code>StartTraceRetrieval</code> using the provided <code>RetrievalToken</code>. A successful cancellation will return an HTTP 200 response.
+ * </p>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { XRayClient, CancelTraceRetrievalCommand } from "@aws-sdk/client-xray"; // ES Modules import
+ * // const { XRayClient, CancelTraceRetrievalCommand } = require("@aws-sdk/client-xray"); // CommonJS import
+ * const client = new XRayClient(config);
+ * const input = { // CancelTraceRetrievalRequest
+ *   RetrievalToken: "STRING_VALUE", // required
+ * };
+ * const command = new CancelTraceRetrievalCommand(input);
+ * const response = await client.send(command);
+ * // {};
+ *
+ * ```
+ *
+ * @param CancelTraceRetrievalCommandInput - {@link CancelTraceRetrievalCommandInput}
+ * @returns {@link CancelTraceRetrievalCommandOutput}
+ * @see {@link CancelTraceRetrievalCommandInput} for command's `input` shape.
+ * @see {@link CancelTraceRetrievalCommandOutput} for command's `response` shape.
+ * @see {@link XRayClientResolvedConfig | config} for XRayClient's `config` shape.
+ *
+ * @throws {@link InvalidRequestException} (client fault)
+ *  <p>The request is missing required parameters or has invalid parameters.</p>
+ *
+ * @throws {@link ResourceNotFoundException} (client fault)
+ *  <p>The resource was not found. Verify that the name or Amazon Resource Name (ARN) of the resource is
+ *       correct.</p>
+ *
+ * @throws {@link ThrottledException} (client fault)
+ *  <p>The request exceeds the maximum number of requests per second.</p>
+ *
+ * @throws {@link XRayServiceException}
+ * <p>Base exception class for all service exceptions from XRay service.</p>
+ *
+ * @public
+ */
+export declare class CancelTraceRetrievalCommand extends CancelTraceRetrievalCommand_base {
+    /** @internal type navigation helper, not in runtime. */
+    protected static __types: {
+        api: {
+            input: CancelTraceRetrievalRequest;
+            output: {};
+        };
+        sdk: {
+            input: CancelTraceRetrievalCommandInput;
+            output: CancelTraceRetrievalCommandOutput;
+        };
+    };
+}

package/dist-types/commands/GetIndexingRulesCommand.d.ts

@@ -0,0 +1,91 @@
+import { Command as $Command } from "@smithy/smithy-client";
+import { MetadataBearer as __MetadataBearer } from "@smithy/types";
+import { GetIndexingRulesRequest, GetIndexingRulesResult } from "../models/models_0";
+import { ServiceInputTypes, ServiceOutputTypes, XRayClientResolvedConfig } from "../XRayClient";
+/**
+ * @public
+ */
+export type { __MetadataBearer };
+export { $Command };
+/**
+ * @public
+ *
+ * The input for {@link GetIndexingRulesCommand}.
+ */
+export interface GetIndexingRulesCommandInput extends GetIndexingRulesRequest {
+}
+/**
+ * @public
+ *
+ * The output of {@link GetIndexingRulesCommand}.
+ */
+export interface GetIndexingRulesCommandOutput extends GetIndexingRulesResult, __MetadataBearer {
+}
+declare const GetIndexingRulesCommand_base: {
+    new (input: GetIndexingRulesCommandInput): import("@smithy/smithy-client").CommandImpl<GetIndexingRulesCommandInput, GetIndexingRulesCommandOutput, XRayClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
+    new (...[input]: [] | [GetIndexingRulesCommandInput]): import("@smithy/smithy-client").CommandImpl<GetIndexingRulesCommandInput, GetIndexingRulesCommandOutput, XRayClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
+    getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
+};
+/**
+ * <p>
+ * Retrieves all indexing rules.</p>
+ *          <p>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 <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Transaction-Search.html">Transaction Search</a>.</p>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { XRayClient, GetIndexingRulesCommand } from "@aws-sdk/client-xray"; // ES Modules import
+ * // const { XRayClient, GetIndexingRulesCommand } = require("@aws-sdk/client-xray"); // CommonJS import
+ * const client = new XRayClient(config);
+ * const input = { // GetIndexingRulesRequest
+ *   NextToken: "STRING_VALUE",
+ * };
+ * const command = new GetIndexingRulesCommand(input);
+ * const response = await client.send(command);
+ * // { // GetIndexingRulesResult
+ * //   IndexingRules: [ // IndexingRuleList
+ * //     { // IndexingRule
+ * //       Name: "STRING_VALUE",
+ * //       ModifiedAt: new Date("TIMESTAMP"),
+ * //       Rule: { // IndexingRuleValue Union: only one key present
+ * //         Probabilistic: { // ProbabilisticRuleValue
+ * //           DesiredSamplingPercentage: Number("double"), // required
+ * //           ActualSamplingPercentage: Number("double"),
+ * //         },
+ * //       },
+ * //     },
+ * //   ],
+ * //   NextToken: "STRING_VALUE",
+ * // };
+ *
+ * ```
+ *
+ * @param GetIndexingRulesCommandInput - {@link GetIndexingRulesCommandInput}
+ * @returns {@link GetIndexingRulesCommandOutput}
+ * @see {@link GetIndexingRulesCommandInput} for command's `input` shape.
+ * @see {@link GetIndexingRulesCommandOutput} for command's `response` shape.
+ * @see {@link XRayClientResolvedConfig | config} for XRayClient's `config` shape.
+ *
+ * @throws {@link InvalidRequestException} (client fault)
+ *  <p>The request is missing required parameters or has invalid parameters.</p>
+ *
+ * @throws {@link ThrottledException} (client fault)
+ *  <p>The request exceeds the maximum number of requests per second.</p>
+ *
+ * @throws {@link XRayServiceException}
+ * <p>Base exception class for all service exceptions from XRay service.</p>
+ *
+ * @public
+ */
+export declare class GetIndexingRulesCommand extends GetIndexingRulesCommand_base {
+    /** @internal type navigation helper, not in runtime. */
+    protected static __types: {
+        api: {
+            input: GetIndexingRulesRequest;
+            output: GetIndexingRulesResult;
+        };
+        sdk: {
+            input: GetIndexingRulesCommandInput;
+            output: GetIndexingRulesCommandOutput;
+        };
+    };
+}

package/dist-types/commands/GetRetrievedTracesGraphCommand.d.ts

@@ -0,0 +1,185 @@
+import { Command as $Command } from "@smithy/smithy-client";
+import { MetadataBearer as __MetadataBearer } from "@smithy/types";
+import { GetRetrievedTracesGraphRequest, GetRetrievedTracesGraphResult } from "../models/models_0";
+import { ServiceInputTypes, ServiceOutputTypes, XRayClientResolvedConfig } from "../XRayClient";
+/**
+ * @public
+ */
+export type { __MetadataBearer };
+export { $Command };
+/**
+ * @public
+ *
+ * The input for {@link GetRetrievedTracesGraphCommand}.
+ */
+export interface GetRetrievedTracesGraphCommandInput extends GetRetrievedTracesGraphRequest {
+}
+/**
+ * @public
+ *
+ * The output of {@link GetRetrievedTracesGraphCommand}.
+ */
+export interface GetRetrievedTracesGraphCommandOutput extends GetRetrievedTracesGraphResult, __MetadataBearer {
+}
+declare const GetRetrievedTracesGraphCommand_base: {
+    new (input: GetRetrievedTracesGraphCommandInput): import("@smithy/smithy-client").CommandImpl<GetRetrievedTracesGraphCommandInput, GetRetrievedTracesGraphCommandOutput, XRayClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
+    new (__0_0: GetRetrievedTracesGraphCommandInput): import("@smithy/smithy-client").CommandImpl<GetRetrievedTracesGraphCommandInput, GetRetrievedTracesGraphCommandOutput, XRayClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
+    getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
+};
+/**
+ * <p>
+ *   Retrieves a service graph for traces based on the specified <code>RetrievalToken</code> from the CloudWatch log group generated by Transaction Search. This API does not initiate a retrieval job. You must first execute <code>StartTraceRetrieval</code> to obtain the required <code>RetrievalToken</code>.
+ * </p>
+ *          <p>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.</p>
+ *          <p>The response is empty until the <code>RetrievalStatus</code> is <i>COMPLETE</i>. Retry the request after the status changes from <i>RUNNING</i> or <i>SCHEDULED</i> to <i>COMPLETE</i> to access the full service graph.</p>
+ *          <p>
+ *     When CloudWatch log is the destination, this API can support cross-account observability and service graph retrieval across linked accounts.</p>
+ *          <p>For retrieving graphs from X-Ray directly as opposed to the Transaction-Search Log group, see <a href="https://docs.aws.amazon.com/xray/latest/api/API_GetTraceGraph.html">GetTraceGraph</a>.</p>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { XRayClient, GetRetrievedTracesGraphCommand } from "@aws-sdk/client-xray"; // ES Modules import
+ * // const { XRayClient, GetRetrievedTracesGraphCommand } = require("@aws-sdk/client-xray"); // CommonJS import
+ * const client = new XRayClient(config);
+ * const input = { // GetRetrievedTracesGraphRequest
+ *   RetrievalToken: "STRING_VALUE", // required
+ *   NextToken: "STRING_VALUE",
+ * };
+ * const command = new GetRetrievedTracesGraphCommand(input);
+ * const response = await client.send(command);
+ * // { // GetRetrievedTracesGraphResult
+ * //   RetrievalStatus: "SCHEDULED" || "RUNNING" || "COMPLETE" || "FAILED" || "CANCELLED" || "TIMEOUT",
+ * //   Services: [ // RetrievedServicesList
+ * //     { // RetrievedService
+ * //       Service: { // Service
+ * //         ReferenceId: Number("int"),
+ * //         Name: "STRING_VALUE",
+ * //         Names: [ // ServiceNames
+ * //           "STRING_VALUE",
+ * //         ],
+ * //         Root: true || false,
+ * //         AccountId: "STRING_VALUE",
+ * //         Type: "STRING_VALUE",
+ * //         State: "STRING_VALUE",
+ * //         StartTime: new Date("TIMESTAMP"),
+ * //         EndTime: new Date("TIMESTAMP"),
+ * //         Edges: [ // EdgeList
+ * //           { // Edge
+ * //             ReferenceId: Number("int"),
+ * //             StartTime: new Date("TIMESTAMP"),
+ * //             EndTime: new Date("TIMESTAMP"),
+ * //             SummaryStatistics: { // EdgeStatistics
+ * //               OkCount: Number("long"),
+ * //               ErrorStatistics: { // ErrorStatistics
+ * //                 ThrottleCount: Number("long"),
+ * //                 OtherCount: Number("long"),
+ * //                 TotalCount: Number("long"),
+ * //               },
+ * //               FaultStatistics: { // FaultStatistics
+ * //                 OtherCount: Number("long"),
+ * //                 TotalCount: Number("long"),
+ * //               },
+ * //               TotalCount: Number("long"),
+ * //               TotalResponseTime: Number("double"),
+ * //             },
+ * //             ResponseTimeHistogram: [ // Histogram
+ * //               { // HistogramEntry
+ * //                 Value: Number("double"),
+ * //                 Count: Number("int"),
+ * //               },
+ * //             ],
+ * //             Aliases: [ // AliasList
+ * //               { // Alias
+ * //                 Name: "STRING_VALUE",
+ * //                 Names: [ // AliasNames
+ * //                   "STRING_VALUE",
+ * //                 ],
+ * //                 Type: "STRING_VALUE",
+ * //               },
+ * //             ],
+ * //             EdgeType: "STRING_VALUE",
+ * //             ReceivedEventAgeHistogram: [
+ * //               {
+ * //                 Value: Number("double"),
+ * //                 Count: Number("int"),
+ * //               },
+ * //             ],
+ * //           },
+ * //         ],
+ * //         SummaryStatistics: { // ServiceStatistics
+ * //           OkCount: Number("long"),
+ * //           ErrorStatistics: {
+ * //             ThrottleCount: Number("long"),
+ * //             OtherCount: Number("long"),
+ * //             TotalCount: Number("long"),
+ * //           },
+ * //           FaultStatistics: {
+ * //             OtherCount: Number("long"),
+ * //             TotalCount: Number("long"),
+ * //           },
+ * //           TotalCount: Number("long"),
+ * //           TotalResponseTime: Number("double"),
+ * //         },
+ * //         DurationHistogram: [
+ * //           {
+ * //             Value: Number("double"),
+ * //             Count: Number("int"),
+ * //           },
+ * //         ],
+ * //         ResponseTimeHistogram: [
+ * //           {
+ * //             Value: Number("double"),
+ * //             Count: Number("int"),
+ * //           },
+ * //         ],
+ * //       },
+ * //       Links: [ // LinksList
+ * //         { // GraphLink
+ * //           ReferenceType: "STRING_VALUE",
+ * //           SourceTraceId: "STRING_VALUE",
+ * //           DestinationTraceIds: [ // TraceIdList
+ * //             "STRING_VALUE",
+ * //           ],
+ * //         },
+ * //       ],
+ * //     },
+ * //   ],
+ * //   NextToken: "STRING_VALUE",
+ * // };
+ *
+ * ```
+ *
+ * @param GetRetrievedTracesGraphCommandInput - {@link GetRetrievedTracesGraphCommandInput}
+ * @returns {@link GetRetrievedTracesGraphCommandOutput}
+ * @see {@link GetRetrievedTracesGraphCommandInput} for command's `input` shape.
+ * @see {@link GetRetrievedTracesGraphCommandOutput} for command's `response` shape.
+ * @see {@link XRayClientResolvedConfig | config} for XRayClient's `config` shape.
+ *
+ * @throws {@link InvalidRequestException} (client fault)
+ *  <p>The request is missing required parameters or has invalid parameters.</p>
+ *
+ * @throws {@link ResourceNotFoundException} (client fault)
+ *  <p>The resource was not found. Verify that the name or Amazon Resource Name (ARN) of the resource is
+ *       correct.</p>
+ *
+ * @throws {@link ThrottledException} (client fault)
+ *  <p>The request exceeds the maximum number of requests per second.</p>
+ *
+ * @throws {@link XRayServiceException}
+ * <p>Base exception class for all service exceptions from XRay service.</p>
+ *
+ * @public
+ */
+export declare class GetRetrievedTracesGraphCommand extends GetRetrievedTracesGraphCommand_base {
+    /** @internal type navigation helper, not in runtime. */
+    protected static __types: {
+        api: {
+            input: GetRetrievedTracesGraphRequest;
+            output: GetRetrievedTracesGraphResult;
+        };
+        sdk: {
+            input: GetRetrievedTracesGraphCommandInput;
+            output: GetRetrievedTracesGraphCommandOutput;
+        };
+    };
+}

package/dist-types/commands/GetTraceSegmentDestinationCommand.d.ts

@@ -0,0 +1,78 @@
+import { Command as $Command } from "@smithy/smithy-client";
+import { MetadataBearer as __MetadataBearer } from "@smithy/types";
+import { GetTraceSegmentDestinationRequest, GetTraceSegmentDestinationResult } from "../models/models_0";
+import { ServiceInputTypes, ServiceOutputTypes, XRayClientResolvedConfig } from "../XRayClient";
+/**
+ * @public
+ */
+export type { __MetadataBearer };
+export { $Command };
+/**
+ * @public
+ *
+ * The input for {@link GetTraceSegmentDestinationCommand}.
+ */
+export interface GetTraceSegmentDestinationCommandInput extends GetTraceSegmentDestinationRequest {
+}
+/**
+ * @public
+ *
+ * The output of {@link GetTraceSegmentDestinationCommand}.
+ */
+export interface GetTraceSegmentDestinationCommandOutput extends GetTraceSegmentDestinationResult, __MetadataBearer {
+}
+declare const GetTraceSegmentDestinationCommand_base: {
+    new (input: GetTraceSegmentDestinationCommandInput): import("@smithy/smithy-client").CommandImpl<GetTraceSegmentDestinationCommandInput, GetTraceSegmentDestinationCommandOutput, XRayClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
+    new (...[input]: [] | [GetTraceSegmentDestinationCommandInput]): import("@smithy/smithy-client").CommandImpl<GetTraceSegmentDestinationCommandInput, GetTraceSegmentDestinationCommandOutput, XRayClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
+    getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
+};
+/**
+ * <p>
+ *   Retrieves the current destination of data sent to <code>PutTraceSegments</code> and <i>OpenTelemetry</i> API. The Transaction Search feature requires a CloudWatchLogs destination. For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Transaction-Search.html">Transaction Search</a> and <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-OpenTelemetry-Sections.html">OpenTelemetry</a>.
+ * </p>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { XRayClient, GetTraceSegmentDestinationCommand } from "@aws-sdk/client-xray"; // ES Modules import
+ * // const { XRayClient, GetTraceSegmentDestinationCommand } = require("@aws-sdk/client-xray"); // CommonJS import
+ * const client = new XRayClient(config);
+ * const input = {};
+ * const command = new GetTraceSegmentDestinationCommand(input);
+ * const response = await client.send(command);
+ * // { // GetTraceSegmentDestinationResult
+ * //   Destination: "XRay" || "CloudWatchLogs",
+ * //   Status: "PENDING" || "ACTIVE",
+ * // };
+ *
+ * ```
+ *
+ * @param GetTraceSegmentDestinationCommandInput - {@link GetTraceSegmentDestinationCommandInput}
+ * @returns {@link GetTraceSegmentDestinationCommandOutput}
+ * @see {@link GetTraceSegmentDestinationCommandInput} for command's `input` shape.
+ * @see {@link GetTraceSegmentDestinationCommandOutput} for command's `response` shape.
+ * @see {@link XRayClientResolvedConfig | config} for XRayClient's `config` shape.
+ *
+ * @throws {@link InvalidRequestException} (client fault)
+ *  <p>The request is missing required parameters or has invalid parameters.</p>
+ *
+ * @throws {@link ThrottledException} (client fault)
+ *  <p>The request exceeds the maximum number of requests per second.</p>
+ *
+ * @throws {@link XRayServiceException}
+ * <p>Base exception class for all service exceptions from XRay service.</p>
+ *
+ * @public
+ */
+export declare class GetTraceSegmentDestinationCommand extends GetTraceSegmentDestinationCommand_base {
+    /** @internal type navigation helper, not in runtime. */
+    protected static __types: {
+        api: {
+            input: {};
+            output: GetTraceSegmentDestinationResult;
+        };
+        sdk: {
+            input: GetTraceSegmentDestinationCommandInput;
+            output: GetTraceSegmentDestinationCommandOutput;
+        };
+    };
+}

package/dist-types/commands/GetTraceSummariesCommand.d.ts

@@ -42,8 +42,8 @@ declare const GetTraceSummariesCommand_base: {
  *             <code>annotation.account = "12345"</code>
  *          </p>
  *          <p>For a full list of indexed fields and keywords that you can use in filter expressions,
- *       see <a href="https://docs.aws.amazon.com/xray/latest/devguide/xray-console-filters.html">Using Filter
- *         Expressions</a> in the <i>Amazon Web Services X-Ray Developer Guide</i>.</p>
+ *       see <a href="https://docs.aws.amazon.com/xray/latest/devguide/aws-xray-interface-console.html#xray-console-filters">Use filter
+ *         expressions</a> in the <i>Amazon Web Services X-Ray Developer Guide</i>.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/ListRetrievedTracesCommand.d.ts

@@ -0,0 +1,104 @@
+import { Command as $Command } from "@smithy/smithy-client";
+import { MetadataBearer as __MetadataBearer } from "@smithy/types";
+import { ListRetrievedTracesRequest, ListRetrievedTracesResult } from "../models/models_0";
+import { ServiceInputTypes, ServiceOutputTypes, XRayClientResolvedConfig } from "../XRayClient";
+/**
+ * @public
+ */
+export type { __MetadataBearer };
+export { $Command };
+/**
+ * @public
+ *
+ * The input for {@link ListRetrievedTracesCommand}.
+ */
+export interface ListRetrievedTracesCommandInput extends ListRetrievedTracesRequest {
+}
+/**
+ * @public
+ *
+ * The output of {@link ListRetrievedTracesCommand}.
+ */
+export interface ListRetrievedTracesCommandOutput extends ListRetrievedTracesResult, __MetadataBearer {
+}
+declare const ListRetrievedTracesCommand_base: {
+    new (input: ListRetrievedTracesCommandInput): import("@smithy/smithy-client").CommandImpl<ListRetrievedTracesCommandInput, ListRetrievedTracesCommandOutput, XRayClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
+    new (__0_0: ListRetrievedTracesCommandInput): import("@smithy/smithy-client").CommandImpl<ListRetrievedTracesCommandInput, ListRetrievedTracesCommandOutput, XRayClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
+    getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
+};
+/**
+ * <p>
+ *   Retrieves a list of traces for a given <code>RetrievalToken</code> from the CloudWatch log group generated by Transaction Search. For information on what each trace returns, see <a href="https://docs.aws.amazon.com/xray/latest/api/API_BatchGetTraces.html">BatchGetTraces</a>.
+ * </p>
+ *          <p>This API does not initiate a retrieval job. To start a trace retrieval, use <code>StartTraceRetrieval</code>, which generates the required <code>RetrievalToken</code>.</p>
+ *          <p>
+ *     When the <code>RetrievalStatus</code> is not <i>COMPLETE</i>, the API will return an empty response. Retry the request once the retrieval has completed to access the full list of traces.</p>
+ *          <p>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 <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html">CloudWatch cross-account observability</a>.</p>
+ *          <p>For retrieving data from X-Ray directly as opposed to the Transaction-Search Log group, see <a href="https://docs.aws.amazon.com/xray/latest/api/API_BatchGetTraces.html">BatchGetTraces</a>.</p>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { XRayClient, ListRetrievedTracesCommand } from "@aws-sdk/client-xray"; // ES Modules import
+ * // const { XRayClient, ListRetrievedTracesCommand } = require("@aws-sdk/client-xray"); // CommonJS import
+ * const client = new XRayClient(config);
+ * const input = { // ListRetrievedTracesRequest
+ *   RetrievalToken: "STRING_VALUE", // required
+ *   TraceFormat: "XRAY" || "OTEL",
+ *   NextToken: "STRING_VALUE",
+ * };
+ * const command = new ListRetrievedTracesCommand(input);
+ * const response = await client.send(command);
+ * // { // ListRetrievedTracesResult
+ * //   RetrievalStatus: "SCHEDULED" || "RUNNING" || "COMPLETE" || "FAILED" || "CANCELLED" || "TIMEOUT",
+ * //   TraceFormat: "XRAY" || "OTEL",
+ * //   Traces: [ // TraceSpanList
+ * //     { // RetrievedTrace
+ * //       Id: "STRING_VALUE",
+ * //       Duration: Number("double"),
+ * //       Spans: [ // SpanList
+ * //         { // Span
+ * //           Id: "STRING_VALUE",
+ * //           Document: "STRING_VALUE",
+ * //         },
+ * //       ],
+ * //     },
+ * //   ],
+ * //   NextToken: "STRING_VALUE",
+ * // };
+ *
+ * ```
+ *
+ * @param ListRetrievedTracesCommandInput - {@link ListRetrievedTracesCommandInput}
+ * @returns {@link ListRetrievedTracesCommandOutput}
+ * @see {@link ListRetrievedTracesCommandInput} for command's `input` shape.
+ * @see {@link ListRetrievedTracesCommandOutput} for command's `response` shape.
+ * @see {@link XRayClientResolvedConfig | config} for XRayClient's `config` shape.
+ *
+ * @throws {@link InvalidRequestException} (client fault)
+ *  <p>The request is missing required parameters or has invalid parameters.</p>
+ *
+ * @throws {@link ResourceNotFoundException} (client fault)
+ *  <p>The resource was not found. Verify that the name or Amazon Resource Name (ARN) of the resource is
+ *       correct.</p>
+ *
+ * @throws {@link ThrottledException} (client fault)
+ *  <p>The request exceeds the maximum number of requests per second.</p>
+ *
+ * @throws {@link XRayServiceException}
+ * <p>Base exception class for all service exceptions from XRay service.</p>
+ *
+ * @public
+ */
+export declare class ListRetrievedTracesCommand extends ListRetrievedTracesCommand_base {
+    /** @internal type navigation helper, not in runtime. */
+    protected static __types: {
+        api: {
+            input: ListRetrievedTracesRequest;
+            output: ListRetrievedTracesResult;
+        };
+        sdk: {
+            input: ListRetrievedTracesCommandInput;
+            output: ListRetrievedTracesCommandOutput;
+        };
+    };
+}