@aws-sdk/client-application-signals 3.899.0 → 3.900.0

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

@@ -0,0 +1,124 @@
+import { Command as $Command } from "@smithy/smithy-client";
+import { MetadataBearer as __MetadataBearer } from "@smithy/types";
+import { ApplicationSignalsClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../ApplicationSignalsClient";
+import { ListServiceStatesInput, ListServiceStatesOutput } from "../models/models_0";
+/**
+ * @public
+ */
+export type { __MetadataBearer };
+export { $Command };
+/**
+ * @public
+ *
+ * The input for {@link ListServiceStatesCommand}.
+ */
+export interface ListServiceStatesCommandInput extends ListServiceStatesInput {
+}
+/**
+ * @public
+ *
+ * The output of {@link ListServiceStatesCommand}.
+ */
+export interface ListServiceStatesCommandOutput extends ListServiceStatesOutput, __MetadataBearer {
+}
+declare const ListServiceStatesCommand_base: {
+    new (input: ListServiceStatesCommandInput): import("@smithy/smithy-client").CommandImpl<ListServiceStatesCommandInput, ListServiceStatesCommandOutput, ApplicationSignalsClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
+    new (input: ListServiceStatesCommandInput): import("@smithy/smithy-client").CommandImpl<ListServiceStatesCommandInput, ListServiceStatesCommandOutput, ApplicationSignalsClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
+    getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
+};
+/**
+ * <p>Returns information about the last deployment and other change states of services. This API provides visibility into recent changes that may have affected service performance, helping with troubleshooting and change correlation.</p>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { ApplicationSignalsClient, ListServiceStatesCommand } from "@aws-sdk/client-application-signals"; // ES Modules import
+ * // const { ApplicationSignalsClient, ListServiceStatesCommand } = require("@aws-sdk/client-application-signals"); // CommonJS import
+ * // import type { ApplicationSignalsClientConfig } from "@aws-sdk/client-application-signals";
+ * const config = {}; // type is ApplicationSignalsClientConfig
+ * const client = new ApplicationSignalsClient(config);
+ * const input = { // ListServiceStatesInput
+ *   StartTime: new Date("TIMESTAMP"), // required
+ *   EndTime: new Date("TIMESTAMP"), // required
+ *   MaxResults: Number("int"),
+ *   NextToken: "STRING_VALUE",
+ *   IncludeLinkedAccounts: true || false,
+ *   AwsAccountId: "STRING_VALUE",
+ *   AttributeFilters: [ // AttributeFilters
+ *     { // AttributeFilter
+ *       AttributeFilterName: "STRING_VALUE", // required
+ *       AttributeFilterValues: [ // AttributeFilterValues // required
+ *         "STRING_VALUE",
+ *       ],
+ *     },
+ *   ],
+ * };
+ * const command = new ListServiceStatesCommand(input);
+ * const response = await client.send(command);
+ * // { // ListServiceStatesOutput
+ * //   StartTime: new Date("TIMESTAMP"), // required
+ * //   EndTime: new Date("TIMESTAMP"), // required
+ * //   ServiceStates: [ // ServiceStates // required
+ * //     { // ServiceState
+ * //       AttributeFilters: [ // AttributeFilters
+ * //         { // AttributeFilter
+ * //           AttributeFilterName: "STRING_VALUE", // required
+ * //           AttributeFilterValues: [ // AttributeFilterValues // required
+ * //             "STRING_VALUE",
+ * //           ],
+ * //         },
+ * //       ],
+ * //       Service: { // Attributes // required
+ * //         "<keys>": "STRING_VALUE",
+ * //       },
+ * //       LatestChangeEvents: [ // LatestChangeEvents // required
+ * //         { // ChangeEvent
+ * //           Timestamp: new Date("TIMESTAMP"), // required
+ * //           AccountId: "STRING_VALUE", // required
+ * //           Region: "STRING_VALUE", // required
+ * //           Entity: { // required
+ * //             "<keys>": "STRING_VALUE",
+ * //           },
+ * //           ChangeEventType: "DEPLOYMENT", // required
+ * //           EventId: "STRING_VALUE", // required
+ * //           UserName: "STRING_VALUE",
+ * //           EventName: "STRING_VALUE",
+ * //         },
+ * //       ],
+ * //     },
+ * //   ],
+ * //   NextToken: "STRING_VALUE",
+ * // };
+ *
+ * ```
+ *
+ * @param ListServiceStatesCommandInput - {@link ListServiceStatesCommandInput}
+ * @returns {@link ListServiceStatesCommandOutput}
+ * @see {@link ListServiceStatesCommandInput} for command's `input` shape.
+ * @see {@link ListServiceStatesCommandOutput} for command's `response` shape.
+ * @see {@link ApplicationSignalsClientResolvedConfig | config} for ApplicationSignalsClient's `config` shape.
+ *
+ * @throws {@link ThrottlingException} (client fault)
+ *  <p>The request was throttled because of quota limits.</p>
+ *
+ * @throws {@link ValidationException} (client fault)
+ *  <p>The resource is not valid.</p>
+ *
+ * @throws {@link ApplicationSignalsServiceException}
+ * <p>Base exception class for all service exceptions from ApplicationSignals service.</p>
+ *
+ *
+ * @public
+ */
+export declare class ListServiceStatesCommand extends ListServiceStatesCommand_base {
+    /** @internal type navigation helper, not in runtime. */
+    protected static __types: {
+        api: {
+            input: ListServiceStatesInput;
+            output: ListServiceStatesOutput;
+        };
+        sdk: {
+            input: ListServiceStatesCommandInput;
+            output: ListServiceStatesCommandOutput;
+        };
+    };
+}

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

@@ -27,9 +27,7 @@ declare const ListServicesCommand_base: {
     getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
 };
 /**
- * <p>Returns a list of services that have been discovered by Application Signals.
- *          A service represents a minimum logical and transactional unit that completes a business function. Services
- *          are discovered through Application Signals instrumentation.</p>
+ * <p>Returns a list of services that have been discovered by Application Signals. A service represents a minimum logical and transactional unit that completes a business function. Services are discovered through Application Signals instrumentation.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -75,6 +73,14 @@ declare const ListServicesCommand_base: {
  * //           AccountId: "STRING_VALUE",
  * //         },
  * //       ],
+ * //       ServiceGroups: [ // ServiceGroups
+ * //         { // ServiceGroup
+ * //           GroupName: "STRING_VALUE", // required
+ * //           GroupValue: "STRING_VALUE", // required
+ * //           GroupSource: "STRING_VALUE", // required
+ * //           GroupIdentifier: "STRING_VALUE", // required
+ * //         },
+ * //       ],
  * //     },
  * //   ],
  * //   NextToken: "STRING_VALUE",

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

@@ -0,0 +1,102 @@
+import { Command as $Command } from "@smithy/smithy-client";
+import { MetadataBearer as __MetadataBearer } from "@smithy/types";
+import { ApplicationSignalsClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../ApplicationSignalsClient";
+import { PutGroupingConfigurationInput, PutGroupingConfigurationOutput } from "../models/models_0";
+/**
+ * @public
+ */
+export type { __MetadataBearer };
+export { $Command };
+/**
+ * @public
+ *
+ * The input for {@link PutGroupingConfigurationCommand}.
+ */
+export interface PutGroupingConfigurationCommandInput extends PutGroupingConfigurationInput {
+}
+/**
+ * @public
+ *
+ * The output of {@link PutGroupingConfigurationCommand}.
+ */
+export interface PutGroupingConfigurationCommandOutput extends PutGroupingConfigurationOutput, __MetadataBearer {
+}
+declare const PutGroupingConfigurationCommand_base: {
+    new (input: PutGroupingConfigurationCommandInput): import("@smithy/smithy-client").CommandImpl<PutGroupingConfigurationCommandInput, PutGroupingConfigurationCommandOutput, ApplicationSignalsClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
+    new (input: PutGroupingConfigurationCommandInput): import("@smithy/smithy-client").CommandImpl<PutGroupingConfigurationCommandInput, PutGroupingConfigurationCommandOutput, ApplicationSignalsClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
+    getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
+};
+/**
+ * <p>Creates or updates the grouping configuration for this account. This operation allows you to define custom grouping attributes that determine how services are logically grouped based on telemetry attributes, Amazon Web Services tags, or predefined mappings. These grouping attributes can then be used to organize and filter services in the Application Signals console and APIs.</p>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { ApplicationSignalsClient, PutGroupingConfigurationCommand } from "@aws-sdk/client-application-signals"; // ES Modules import
+ * // const { ApplicationSignalsClient, PutGroupingConfigurationCommand } = require("@aws-sdk/client-application-signals"); // CommonJS import
+ * // import type { ApplicationSignalsClientConfig } from "@aws-sdk/client-application-signals";
+ * const config = {}; // type is ApplicationSignalsClientConfig
+ * const client = new ApplicationSignalsClient(config);
+ * const input = { // PutGroupingConfigurationInput
+ *   GroupingAttributeDefinitions: [ // GroupingAttributeDefinitions // required
+ *     { // GroupingAttributeDefinition
+ *       GroupingName: "STRING_VALUE", // required
+ *       GroupingSourceKeys: [ // GroupingSourceKeyStringList
+ *         "STRING_VALUE",
+ *       ],
+ *       DefaultGroupingValue: "STRING_VALUE",
+ *     },
+ *   ],
+ * };
+ * const command = new PutGroupingConfigurationCommand(input);
+ * const response = await client.send(command);
+ * // { // PutGroupingConfigurationOutput
+ * //   GroupingConfiguration: { // GroupingConfiguration
+ * //     GroupingAttributeDefinitions: [ // GroupingAttributeDefinitions // required
+ * //       { // GroupingAttributeDefinition
+ * //         GroupingName: "STRING_VALUE", // required
+ * //         GroupingSourceKeys: [ // GroupingSourceKeyStringList
+ * //           "STRING_VALUE",
+ * //         ],
+ * //         DefaultGroupingValue: "STRING_VALUE",
+ * //       },
+ * //     ],
+ * //     UpdatedAt: new Date("TIMESTAMP"), // required
+ * //   },
+ * // };
+ *
+ * ```
+ *
+ * @param PutGroupingConfigurationCommandInput - {@link PutGroupingConfigurationCommandInput}
+ * @returns {@link PutGroupingConfigurationCommandOutput}
+ * @see {@link PutGroupingConfigurationCommandInput} for command's `input` shape.
+ * @see {@link PutGroupingConfigurationCommandOutput} for command's `response` shape.
+ * @see {@link ApplicationSignalsClientResolvedConfig | config} for ApplicationSignalsClient's `config` shape.
+ *
+ * @throws {@link AccessDeniedException} (client fault)
+ *  <p>You don't have sufficient permissions to perform this action.</p>
+ *
+ * @throws {@link ThrottlingException} (client fault)
+ *  <p>The request was throttled because of quota limits.</p>
+ *
+ * @throws {@link ValidationException} (client fault)
+ *  <p>The resource is not valid.</p>
+ *
+ * @throws {@link ApplicationSignalsServiceException}
+ * <p>Base exception class for all service exceptions from ApplicationSignals service.</p>
+ *
+ *
+ * @public
+ */
+export declare class PutGroupingConfigurationCommand extends PutGroupingConfigurationCommand_base {
+    /** @internal type navigation helper, not in runtime. */
+    protected static __types: {
+        api: {
+            input: PutGroupingConfigurationInput;
+            output: PutGroupingConfigurationOutput;
+        };
+        sdk: {
+            input: PutGroupingConfigurationCommandInput;
+            output: PutGroupingConfigurationCommandOutput;
+        };
+    };
+}

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

@@ -27,50 +27,7 @@ declare const StartDiscoveryCommand_base: {
     getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
 };
 /**
- * <p>Enables this Amazon Web Services account to be able to use CloudWatch Application Signals
- *          by creating the <i>AWSServiceRoleForCloudWatchApplicationSignals</i> service-linked role. This service-
- *          linked role has the following permissions:</p>
- *          <ul>
- *             <li>
- *                <p>
- *                   <code>xray:GetServiceGraph</code>
- *                </p>
- *             </li>
- *             <li>
- *                <p>
- *                   <code>logs:StartQuery</code>
- *                </p>
- *             </li>
- *             <li>
- *                <p>
- *                   <code>logs:GetQueryResults</code>
- *                </p>
- *             </li>
- *             <li>
- *                <p>
- *                   <code>cloudwatch:GetMetricData</code>
- *                </p>
- *             </li>
- *             <li>
- *                <p>
- *                   <code>cloudwatch:ListMetrics</code>
- *                </p>
- *             </li>
- *             <li>
- *                <p>
- *                   <code>tag:GetResources</code>
- *                </p>
- *             </li>
- *             <li>
- *                <p>
- *                   <code>autoscaling:DescribeAutoScalingGroups</code>
- *                </p>
- *             </li>
- *          </ul>
- *          <p>After completing this step, you still need to instrument your Java and Python applications to send data
- *          to Application Signals. For more information, see
- *          <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Application-Signals-Enable.html">
- *             Enabling Application Signals</a>.</p>
+ * <p>Enables this Amazon Web Services account to be able to use CloudWatch Application Signals by creating the <i>AWSServiceRoleForCloudWatchApplicationSignals</i> service-linked role. This service- linked role has the following permissions:</p> <ul> <li> <p> <code>xray:GetServiceGraph</code> </p> </li> <li> <p> <code>logs:StartQuery</code> </p> </li> <li> <p> <code>logs:GetQueryResults</code> </p> </li> <li> <p> <code>cloudwatch:GetMetricData</code> </p> </li> <li> <p> <code>cloudwatch:ListMetrics</code> </p> </li> <li> <p> <code>tag:GetResources</code> </p> </li> <li> <p> <code>autoscaling:DescribeAutoScalingGroups</code> </p> </li> </ul> <p>After completing this step, you still need to instrument your Java and Python applications to send data to Application Signals. For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Application-Signals-Enable.html"> Enabling Application Signals</a>.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

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

@@ -27,16 +27,7 @@ declare const TagResourceCommand_base: {
     getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
 };
 /**
- * <p>Assigns one or more tags (key-value pairs) to the specified CloudWatch resource, such as a service level objective.</p>
- *          <p>Tags can help you organize and categorize your resources. You can also use them to scope user
- *          permissions by granting a user
- *          permission to access or change only resources with certain tag values.</p>
- *          <p>Tags don't have any semantic meaning to Amazon Web Services and are interpreted strictly as strings of characters.</p>
- *          <p>You can use the <code>TagResource</code> action with an alarm that already has tags. If you specify a new tag key for the alarm,
- *          this tag is appended to the list of tags associated
- *          with the alarm. If you specify a tag key that is already associated with the alarm, the new tag value that you specify replaces
- *          the previous value for that tag.</p>
- *          <p>You can associate as many as 50 tags with a CloudWatch resource.</p>
+ * <p>Assigns one or more tags (key-value pairs) to the specified CloudWatch resource, such as a service level objective.</p> <p>Tags can help you organize and categorize your resources. You can also use them to scope user permissions by granting a user permission to access or change only resources with certain tag values.</p> <p>Tags don't have any semantic meaning to Amazon Web Services and are interpreted strictly as strings of characters.</p> <p>You can use the <code>TagResource</code> action with an alarm that already has tags. If you specify a new tag key for the alarm, this tag is appended to the list of tags associated with the alarm. If you specify a tag key that is already associated with the alarm, the new tag value that you specify replaces the previous value for that tag.</p> <p>You can associate as many as 50 tags with a CloudWatch resource.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

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

@@ -27,10 +27,7 @@ declare const UpdateServiceLevelObjectiveCommand_base: {
     getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
 };
 /**
- * <p>Updates an existing service level objective (SLO). If you omit parameters, the previous values
- *          of those parameters are retained. </p>
- *          <p>You cannot change from a period-based SLO to a request-based SLO,
- *          or change from a request-based SLO to a period-based SLO.</p>
+ * <p>Updates an existing service level objective (SLO). If you omit parameters, the previous values of those parameters are retained. </p> <p>You cannot change from a period-based SLO to a request-based SLO, or change from a request-based SLO to a period-based SLO.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -49,6 +46,7 @@ declare const UpdateServiceLevelObjectiveCommand_base: {
  *       },
  *       OperationName: "STRING_VALUE",
  *       MetricType: "LATENCY" || "AVAILABILITY",
+ *       MetricName: "STRING_VALUE",
  *       Statistic: "STRING_VALUE",
  *       PeriodSeconds: Number("int"),
  *       MetricDataQueries: [ // MetricDataQueries

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

@@ -1,16 +1,21 @@
 export * from "./BatchGetServiceLevelObjectiveBudgetReportCommand";
 export * from "./BatchUpdateExclusionWindowsCommand";
 export * from "./CreateServiceLevelObjectiveCommand";
+export * from "./DeleteGroupingConfigurationCommand";
 export * from "./DeleteServiceLevelObjectiveCommand";
 export * from "./GetServiceCommand";
 export * from "./GetServiceLevelObjectiveCommand";
+export * from "./ListAuditFindingsCommand";
+export * from "./ListGroupingAttributeDefinitionsCommand";
 export * from "./ListServiceDependenciesCommand";
 export * from "./ListServiceDependentsCommand";
 export * from "./ListServiceLevelObjectiveExclusionWindowsCommand";
 export * from "./ListServiceLevelObjectivesCommand";
 export * from "./ListServiceOperationsCommand";
+export * from "./ListServiceStatesCommand";
 export * from "./ListServicesCommand";
 export * from "./ListTagsForResourceCommand";
+export * from "./PutGroupingConfigurationCommand";
 export * from "./StartDiscoveryCommand";
 export * from "./TagResourceCommand";
 export * from "./UntagResourceCommand";

package/dist-types/index.d.ts

@@ -1,23 +1,5 @@
 /**
- * <p>Use CloudWatch Application Signals for comprehensive observability of your cloud-based applications.
- *         It enables real-time service health dashboards and helps you track long-term performance trends against your business goals.
- *         The application-centric view provides you with unified visibility across your applications, services, and
- *         dependencies, so you can proactively monitor and efficiently triage any issues that may arise,
- *         ensuring optimal customer experience.</p>
- *          <p>Application Signals provides the following benefits:</p>
- *          <ul>
- *             <li>
- *                <p>Automatically collect metrics and traces from your applications, and display key metrics such as call volume, availability, latency, faults, and errors. </p>
- *             </li>
- *             <li>
- *                <p>Create and monitor service level objectives (SLOs). </p>
- *             </li>
- *             <li>
- *                <p>See a map of your application topology that Application Signals automatically discovers, that gives you a visual representation of your applications, dependencies, and their connectivity.</p>
- *             </li>
- *          </ul>
- *          <p>Application Signals works with CloudWatch RUM, CloudWatch Synthetics canaries, and Amazon Web Services Service Catalog AppRegistry, to display your client pages, Synthetics canaries,
- *         and application names within dashboards and maps.</p>
+ * <p>Use CloudWatch Application Signals for comprehensive observability of your cloud-based applications. It enables real-time service health dashboards and helps you track long-term performance trends against your business goals. The application-centric view provides you with unified visibility across your applications, services, and dependencies, so you can proactively monitor and efficiently triage any issues that may arise, ensuring optimal customer experience.</p> <p>Application Signals provides the following benefits:</p> <ul> <li> <p>Automatically collect metrics and traces from your applications, and display key metrics such as call volume, availability, latency, faults, and errors. </p> </li> <li> <p>Create and monitor service level objectives (SLOs). </p> </li> <li> <p>See a map of your application topology that Application Signals automatically discovers, that gives you a visual representation of your applications, dependencies, and their connectivity.</p> </li> </ul> <p>Application Signals works with CloudWatch RUM, CloudWatch Synthetics canaries, and Amazon Web Services Service Catalog AppRegistry, to display your client pages, Synthetics canaries, and application names within dashboards and maps.</p>
  *
  * @packageDocumentation
  */