@aws-sdk/client-cloudwatch-logs 3.750.0 → 3.767.0

package/dist-cjs/index.js

@@ -19,8 +19,8 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/index.ts
-var src_exports = {};
-__export(src_exports, {
+var index_exports = {};
+__export(index_exports, {
   AccessDeniedException: () => AccessDeniedException,
   AnomalyDetectorStatus: () => AnomalyDetectorStatus,
   AssociateKmsKeyCommand: () => AssociateKmsKeyCommand,
@@ -179,7 +179,7 @@ __export(src_exports, {
   paginateListLogAnomalyDetectors: () => paginateListLogAnomalyDetectors,
   paginateListLogGroupsForQuery: () => paginateListLogGroupsForQuery
 });
-module.exports = __toCommonJS(src_exports);
+module.exports = __toCommonJS(index_exports);
 
 // src/CloudWatchLogsClient.ts
 var import_middleware_host_header = require("@aws-sdk/middleware-host-header");
@@ -308,9 +308,9 @@ var CloudWatchLogsClient = class extends import_smithy_client.Client {
     this.middlewareStack.use(
       (0, import_core.getHttpAuthSchemeEndpointRuleSetPlugin)(this.config, {
         httpAuthSchemeParametersProvider: import_httpAuthSchemeProvider.defaultCloudWatchLogsHttpAuthSchemeParametersProvider,
-        identityProviderConfigProvider: async (config) => new import_core.DefaultIdentityProviderConfig({
+        identityProviderConfigProvider: /* @__PURE__ */ __name(async (config) => new import_core.DefaultIdentityProviderConfig({
           "aws.auth#sigv4": config.credentials
-        })
+        }), "identityProviderConfigProvider")
       })
     );
     this.middlewareStack.use((0, import_core.getHttpSigningPlugin)(this.config));
@@ -838,10 +838,8 @@ var SessionTimeoutException = class _SessionTimeoutException extends CloudWatchL
 var StartLiveTailResponseStream;
 ((StartLiveTailResponseStream3) => {
   StartLiveTailResponseStream3.visit = /* @__PURE__ */ __name((value, visitor) => {
-    if (value.sessionStart !== void 0)
-      return visitor.sessionStart(value.sessionStart);
-    if (value.sessionUpdate !== void 0)
-      return visitor.sessionUpdate(value.sessionUpdate);
+    if (value.sessionStart !== void 0) return visitor.sessionStart(value.sessionStart);
+    if (value.sessionUpdate !== void 0) return visitor.sessionUpdate(value.sessionUpdate);
     if (value.SessionTimeoutException !== void 0)
       return visitor.SessionTimeoutException(value.SessionTimeoutException);
     if (value.SessionStreamingException !== void 0)
@@ -907,16 +905,11 @@ var SuppressionType = {
   LIMITED: "LIMITED"
 };
 var StartLiveTailResponseStreamFilterSensitiveLog = /* @__PURE__ */ __name((obj) => {
-  if (obj.sessionStart !== void 0)
-    return { sessionStart: obj.sessionStart };
-  if (obj.sessionUpdate !== void 0)
-    return { sessionUpdate: obj.sessionUpdate };
-  if (obj.SessionTimeoutException !== void 0)
-    return { SessionTimeoutException: obj.SessionTimeoutException };
-  if (obj.SessionStreamingException !== void 0)
-    return { SessionStreamingException: obj.SessionStreamingException };
-  if (obj.$unknown !== void 0)
-    return { [obj.$unknown[0]]: "UNKNOWN" };
+  if (obj.sessionStart !== void 0) return { sessionStart: obj.sessionStart };
+  if (obj.sessionUpdate !== void 0) return { sessionUpdate: obj.sessionUpdate };
+  if (obj.SessionTimeoutException !== void 0) return { SessionTimeoutException: obj.SessionTimeoutException };
+  if (obj.SessionStreamingException !== void 0) return { SessionStreamingException: obj.SessionStreamingException };
+  if (obj.$unknown !== void 0) return { [obj.$unknown[0]]: "UNKNOWN" };
 }, "StartLiveTailResponseStreamFilterSensitiveLog");
 var StartLiveTailResponseFilterSensitiveLog = /* @__PURE__ */ __name((obj) => ({
   ...obj,
@@ -2840,7 +2833,7 @@ var se_PutMetricFilterRequest = /* @__PURE__ */ __name((input, context) => {
     filterName: [],
     filterPattern: [],
     logGroupName: [],
-    metricTransformations: (_) => se_MetricTransformations(_, context)
+    metricTransformations: /* @__PURE__ */ __name((_) => se_MetricTransformations(_, context), "metricTransformations")
   });
 }, "se_PutMetricFilterRequest");
 var se_PutQueryDefinitionRequest = /* @__PURE__ */ __name((input, context) => {
@@ -2855,7 +2848,7 @@ var se_PutQueryDefinitionRequest = /* @__PURE__ */ __name((input, context) => {
 }, "se_PutQueryDefinitionRequest");
 var de_DescribeMetricFiltersResponse = /* @__PURE__ */ __name((output, context) => {
   return (0, import_smithy_client.take)(output, {
-    metricFilters: (_) => de_MetricFilters(_, context),
+    metricFilters: /* @__PURE__ */ __name((_) => de_MetricFilters(_, context), "metricFilters"),
     nextToken: import_smithy_client.expectString
   });
 }, "de_DescribeMetricFiltersResponse");
@@ -2864,7 +2857,7 @@ var de_GetQueryResultsResponse = /* @__PURE__ */ __name((output, context) => {
     encryptionKey: import_smithy_client.expectString,
     queryLanguage: import_smithy_client.expectString,
     results: import_smithy_client._json,
-    statistics: (_) => de_QueryStatistics(_, context),
+    statistics: /* @__PURE__ */ __name((_) => de_QueryStatistics(_, context), "statistics"),
     status: import_smithy_client.expectString
   });
 }, "de_GetQueryResultsResponse");
@@ -2875,7 +2868,7 @@ var de_MetricFilter = /* @__PURE__ */ __name((output, context) => {
     filterName: import_smithy_client.expectString,
     filterPattern: import_smithy_client.expectString,
     logGroupName: import_smithy_client.expectString,
-    metricTransformations: (_) => de_MetricTransformations(_, context)
+    metricTransformations: /* @__PURE__ */ __name((_) => de_MetricTransformations(_, context), "metricTransformations")
   });
 }, "de_MetricFilter");
 var de_MetricFilters = /* @__PURE__ */ __name((output, context) => {

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

@@ -28,21 +28,43 @@ declare const FilterLogEventsCommand_base: {
 };
 /**
  * <p>Lists log events from the specified log group. You can list all the log events or filter the results
- *       using a filter pattern, a time range, and the name of the log stream.</p>
+ *       using one or more of the following:</p>
+ *          <ul>
+ *             <li>
+ *                <p>A filter pattern</p>
+ *             </li>
+ *             <li>
+ *                <p>A time range</p>
+ *             </li>
+ *             <li>
+ *                <p>The log stream name, or a log stream name prefix that matches mutltiple log streams</p>
+ *             </li>
+ *          </ul>
  *          <p>You must have the <code>logs:FilterLogEvents</code> permission to perform this operation.</p>
  *          <p>You can specify the log group to search by using either <code>logGroupIdentifier</code> or <code>logGroupName</code>.
  *       You must include one of these two parameters, but you can't include both.
  *     </p>
- *          <p>By default, this operation returns as many log events as can fit in 1 MB (up to 10,000
- *       log events) or all the events found within the specified time range. If the results include a
- *       token, that means there are more log events available. You can get additional results by
- *       specifying the token in a subsequent call. This operation can return empty results while there
- *       are more log events available through the token.</p>
+ *          <p>
+ *             <code>FilterLogEvents</code> is a paginated operation. Each page returned can contain up to 1 MB of log events or up to 10,000 log events. A returned page might only be partially full, or even empty.
+ *       For example, if the result of a query would return 15,000 log events, the first page isn't guaranteed to have 10,000 log events even if they all fit into 1 MB.</p>
+ *          <p>Partially full or empty pages
+ *       don't necessarily mean that pagination is finished. If the results include a <code>nextToken</code>, there might be more log events available. You can return these additional log events by providing the nextToken in a subsequent
+ *       <code>FilterLogEvents</code> operation. If the results don't include a <code>nextToken</code>, then pagination is finished. </p>
+ *          <note>
+ *             <p>If you set <code>startFromHead</code> to <code>true</code> and you don’t include <code>endTime</code> in your request, you can end up in a situation where the pagination doesn't terminate.
+ *       This can happen when the new log events are being added to the target log streams
+ *       faster than they are being read. This situation is a good use case for the CloudWatch Logs <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CloudWatchLogs_LiveTail.html">Live Tail</a> feature.</p>
+ *          </note>
  *          <p>The returned log events are sorted by event timestamp, the timestamp when the event was ingested
  *     by CloudWatch Logs, and the ID of the <code>PutLogEvents</code> request.</p>
  *          <p>If you are using CloudWatch cross-account observability, you can use this operation in a monitoring account and
  *       view data from the linked source accounts. For more information, see
  *       <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html">CloudWatch cross-account observability</a>.</p>
+ *          <note>
+ *             <p>If you are using <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CloudWatch-Logs-Transformation.html">log transformation</a>, the <code>FilterLogEvents</code> operation returns only the original versions of log events, before they
+ *       were transformed. To view the transformed versions, you must use a <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AnalyzingLogData.html">CloudWatch Logs query.</a>
+ *             </p>
+ *          </note>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

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

@@ -27,7 +27,7 @@ declare const GetLogAnomalyDetectorCommand_base: {
     getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
 };
 /**
- * <p>Retrieves information about the log anomaly detector that you specify.</p>
+ * <p>Retrieves information about the log anomaly detector that you specify. The KMS key ARN detected is valid.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

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

@@ -29,15 +29,29 @@ declare const GetLogEventsCommand_base: {
 /**
  * <p>Lists log events from the specified log stream. You can list all of the log events or
  *       filter using a time range.</p>
- *          <p>By default, this operation returns as many log events as can fit in a response size of 1MB (up to 10,000 log events).
- *       You can get additional log events by specifying one of the tokens in a subsequent call.
- *       This operation can return empty results while there are more log events available through the token.</p>
+ *          <p>
+ *             <code>GetLogEvents</code> is a paginated operation. Each page returned can contain up to 1 MB of log events or up to 10,000 log events. A returned page might only be partially full, or even empty.
+ *       For example, if the result of a query would return 15,000 log events, the first page isn't guaranteed to have 10,000 log events even if they all fit into 1 MB.</p>
+ *          <p>Partially full or empty pages
+ *       don't necessarily mean that pagination is finished. As long as the <code>nextBackwardToken</code> or <code>nextForwardToken</code> returned is NOT equal to the <code>nextToken</code>
+ *       that you passed into the API call, there might be more
+ *       log events available. The token that you use depends on the direction you want to move in along the log stream. The returned tokens are never null.</p>
+ *          <note>
+ *             <p>If you set <code>startFromHead</code> to <code>true</code> and you don’t include <code>endTime</code> in your request, you can end up in a situation where the pagination doesn't terminate.
+ *       This can happen when the new log events are being added to the target log streams
+ *       faster than they are being read. This situation is a good use case for the CloudWatch Logs <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CloudWatchLogs_LiveTail.html">Live Tail</a> feature.</p>
+ *          </note>
  *          <p>If you are using CloudWatch cross-account observability, you can use this operation in a monitoring account and
  *       view data from the linked source accounts. For more information, see
  *       <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html">CloudWatch cross-account observability</a>.</p>
  *          <p>You can specify the log group to search by using either <code>logGroupIdentifier</code> or <code>logGroupName</code>.
  *       You must include one of these two parameters, but you can't include both.
  *     </p>
+ *          <note>
+ *             <p>If you are using <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CloudWatch-Logs-Transformation.html">log transformation</a>, the <code>GetLogEvents</code> operation returns only the original versions of log events, before they
+ *       were transformed. To view the transformed versions, you must use a <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AnalyzingLogData.html">CloudWatch Logs query.</a>
+ *             </p>
+ *          </note>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

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

@@ -398,7 +398,7 @@ export interface AnomalyDetector {
      */
     anomalyDetectorStatus?: AnomalyDetectorStatus | undefined;
     /**
-     * <p>The ID of the KMS key assigned to this anomaly detector, if any.</p>
+     * <p>The ARN of the KMS key assigned to this anomaly detector, if any.</p>
      * @public
      */
     kmsKeyId?: string | undefined;
@@ -982,7 +982,7 @@ export interface CreateLogAnomalyDetectorRequest {
      *        assigned, the anomalies found and the model used by this detector are encrypted at rest with the key. If
      *        a key is assigned to an anomaly detector, a user must have permissions for both this key and for the
      *        anomaly detector to retrieve information about the anomalies that it finds.</p>
-     *          <p>For more information about using a KMS key and to see the required IAM
+     *          <p> Make sure the value provided is a valid KMS key ARN. For more information about using a KMS key and to see the required IAM
      *        policy, see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/LogsAnomalyDetection-KMS.html">Use a KMS key with an anomaly detector</a>.</p>
      * @public
      */
@@ -3301,6 +3301,7 @@ export interface FilterLogEventsResponse {
     searchedLogStreams?: SearchedLogStream[] | undefined;
     /**
      * <p>The token to use when requesting the next set of items. The token expires after 24 hours.</p>
+     *          <p>If the results don't include a <code>nextToken</code>, then pagination is finished. </p>
      * @public
      */
     nextToken?: string | undefined;
@@ -3844,7 +3845,7 @@ export interface GetLogAnomalyDetectorResponse {
      */
     anomalyDetectorStatus?: AnomalyDetectorStatus | undefined;
     /**
-     * <p>The ID of the KMS key assigned to this anomaly detector, if any.</p>
+     * <p>The ARN of the KMS key assigned to this anomaly detector, if any.</p>
      * @public
      */
     kmsKeyId?: string | undefined;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@aws-sdk/client-cloudwatch-logs",
   "description": "AWS SDK for JavaScript Cloudwatch Logs Client for Node.js, Browser and React Native",
-  "version": "3.750.0",
+  "version": "3.767.0",
   "scripts": {
     "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
     "build:cjs": "node ../../scripts/compilation/inline client-cloudwatch-logs",
@@ -20,19 +20,19 @@
   "dependencies": {
     "@aws-crypto/sha256-browser": "5.2.0",
     "@aws-crypto/sha256-js": "5.2.0",
-    "@aws-sdk/core": "3.750.0",
-    "@aws-sdk/credential-provider-node": "3.750.0",
+    "@aws-sdk/core": "3.758.0",
+    "@aws-sdk/credential-provider-node": "3.758.0",
     "@aws-sdk/middleware-host-header": "3.734.0",
     "@aws-sdk/middleware-logger": "3.734.0",
     "@aws-sdk/middleware-recursion-detection": "3.734.0",
-    "@aws-sdk/middleware-user-agent": "3.750.0",
+    "@aws-sdk/middleware-user-agent": "3.758.0",
     "@aws-sdk/region-config-resolver": "3.734.0",
     "@aws-sdk/types": "3.734.0",
     "@aws-sdk/util-endpoints": "3.743.0",
     "@aws-sdk/util-user-agent-browser": "3.734.0",
-    "@aws-sdk/util-user-agent-node": "3.750.0",
+    "@aws-sdk/util-user-agent-node": "3.758.0",
     "@smithy/config-resolver": "^4.0.1",
-    "@smithy/core": "^3.1.4",
+    "@smithy/core": "^3.1.5",
     "@smithy/eventstream-serde-browser": "^4.0.1",
     "@smithy/eventstream-serde-config-resolver": "^4.0.1",
     "@smithy/eventstream-serde-node": "^4.0.1",
@@ -40,21 +40,21 @@
     "@smithy/hash-node": "^4.0.1",
     "@smithy/invalid-dependency": "^4.0.1",
     "@smithy/middleware-content-length": "^4.0.1",
-    "@smithy/middleware-endpoint": "^4.0.5",
-    "@smithy/middleware-retry": "^4.0.6",
+    "@smithy/middleware-endpoint": "^4.0.6",
+    "@smithy/middleware-retry": "^4.0.7",
     "@smithy/middleware-serde": "^4.0.2",
     "@smithy/middleware-stack": "^4.0.1",
     "@smithy/node-config-provider": "^4.0.1",
-    "@smithy/node-http-handler": "^4.0.2",
+    "@smithy/node-http-handler": "^4.0.3",
     "@smithy/protocol-http": "^5.0.1",
-    "@smithy/smithy-client": "^4.1.5",
+    "@smithy/smithy-client": "^4.1.6",
     "@smithy/types": "^4.1.0",
     "@smithy/url-parser": "^4.0.1",
     "@smithy/util-base64": "^4.0.0",
     "@smithy/util-body-length-browser": "^4.0.0",
     "@smithy/util-body-length-node": "^4.0.0",
-    "@smithy/util-defaults-mode-browser": "^4.0.6",
-    "@smithy/util-defaults-mode-node": "^4.0.6",
+    "@smithy/util-defaults-mode-browser": "^4.0.7",
+    "@smithy/util-defaults-mode-node": "^4.0.7",
     "@smithy/util-endpoints": "^3.0.1",
     "@smithy/util-middleware": "^4.0.1",
     "@smithy/util-retry": "^4.0.1",