@aws-sdk/client-cloudwatch-logs 3.637.0 → 3.645.0

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

@@ -72,6 +72,14 @@ declare const CreateDeliveryCommand_base: {
  * const input = { // CreateDeliveryRequest
  *   deliverySourceName: "STRING_VALUE", // required
  *   deliveryDestinationArn: "STRING_VALUE", // required
+ *   recordFields: [ // RecordFields
+ *     "STRING_VALUE",
+ *   ],
+ *   fieldDelimiter: "STRING_VALUE",
+ *   s3DeliveryConfiguration: { // S3DeliveryConfiguration
+ *     suffixPath: "STRING_VALUE",
+ *     enableHiveCompatiblePath: true || false,
+ *   },
  *   tags: { // Tags
  *     "<keys>": "STRING_VALUE",
  *   },
@@ -85,6 +93,14 @@ declare const CreateDeliveryCommand_base: {
  * //     deliverySourceName: "STRING_VALUE",
  * //     deliveryDestinationArn: "STRING_VALUE",
  * //     deliveryDestinationType: "S3" || "CWL" || "FH",
+ * //     recordFields: [ // RecordFields
+ * //       "STRING_VALUE",
+ * //     ],
+ * //     fieldDelimiter: "STRING_VALUE",
+ * //     s3DeliveryConfiguration: { // S3DeliveryConfiguration
+ * //       suffixPath: "STRING_VALUE",
+ * //       enableHiveCompatiblePath: true || false,
+ * //     },
  * //     tags: { // Tags
  * //       "<keys>": "STRING_VALUE",
  * //     },

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

@@ -0,0 +1,118 @@
+import { Command as $Command } from "@smithy/smithy-client";
+import { MetadataBearer as __MetadataBearer } from "@smithy/types";
+import { CloudWatchLogsClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../CloudWatchLogsClient";
+import { DescribeConfigurationTemplatesRequest, DescribeConfigurationTemplatesResponse } from "../models/models_0";
+/**
+ * @public
+ */
+export type { __MetadataBearer };
+export { $Command };
+/**
+ * @public
+ *
+ * The input for {@link DescribeConfigurationTemplatesCommand}.
+ */
+export interface DescribeConfigurationTemplatesCommandInput extends DescribeConfigurationTemplatesRequest {
+}
+/**
+ * @public
+ *
+ * The output of {@link DescribeConfigurationTemplatesCommand}.
+ */
+export interface DescribeConfigurationTemplatesCommandOutput extends DescribeConfigurationTemplatesResponse, __MetadataBearer {
+}
+declare const DescribeConfigurationTemplatesCommand_base: {
+    new (input: DescribeConfigurationTemplatesCommandInput): import("@smithy/smithy-client").CommandImpl<DescribeConfigurationTemplatesCommandInput, DescribeConfigurationTemplatesCommandOutput, CloudWatchLogsClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
+    new (...[input]: [] | [DescribeConfigurationTemplatesCommandInput]): import("@smithy/smithy-client").CommandImpl<DescribeConfigurationTemplatesCommandInput, DescribeConfigurationTemplatesCommandOutput, CloudWatchLogsClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
+    getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
+};
+/**
+ * <p>Use this operation to return the valid and default values that are used when creating delivery sources, delivery destinations, and deliveries.
+ *       For more information about deliveries, see <a href="https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_CreateDelivery.html">CreateDelivery</a>.</p>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { CloudWatchLogsClient, DescribeConfigurationTemplatesCommand } from "@aws-sdk/client-cloudwatch-logs"; // ES Modules import
+ * // const { CloudWatchLogsClient, DescribeConfigurationTemplatesCommand } = require("@aws-sdk/client-cloudwatch-logs"); // CommonJS import
+ * const client = new CloudWatchLogsClient(config);
+ * const input = { // DescribeConfigurationTemplatesRequest
+ *   service: "STRING_VALUE",
+ *   logTypes: [ // LogTypes
+ *     "STRING_VALUE",
+ *   ],
+ *   resourceTypes: [ // ResourceTypes
+ *     "STRING_VALUE",
+ *   ],
+ *   deliveryDestinationTypes: [ // DeliveryDestinationTypes
+ *     "S3" || "CWL" || "FH",
+ *   ],
+ *   nextToken: "STRING_VALUE",
+ *   limit: Number("int"),
+ * };
+ * const command = new DescribeConfigurationTemplatesCommand(input);
+ * const response = await client.send(command);
+ * // { // DescribeConfigurationTemplatesResponse
+ * //   configurationTemplates: [ // ConfigurationTemplates
+ * //     { // ConfigurationTemplate
+ * //       service: "STRING_VALUE",
+ * //       logType: "STRING_VALUE",
+ * //       resourceType: "STRING_VALUE",
+ * //       deliveryDestinationType: "S3" || "CWL" || "FH",
+ * //       defaultDeliveryConfigValues: { // ConfigurationTemplateDeliveryConfigValues
+ * //         recordFields: [ // RecordFields
+ * //           "STRING_VALUE",
+ * //         ],
+ * //         fieldDelimiter: "STRING_VALUE",
+ * //         s3DeliveryConfiguration: { // S3DeliveryConfiguration
+ * //           suffixPath: "STRING_VALUE",
+ * //           enableHiveCompatiblePath: true || false,
+ * //         },
+ * //       },
+ * //       allowedFields: [ // AllowedFields
+ * //         { // RecordField
+ * //           name: "STRING_VALUE",
+ * //           mandatory: true || false,
+ * //         },
+ * //       ],
+ * //       allowedOutputFormats: [ // OutputFormats
+ * //         "json" || "plain" || "w3c" || "raw" || "parquet",
+ * //       ],
+ * //       allowedActionForAllowVendedLogsDeliveryForResource: "STRING_VALUE",
+ * //       allowedFieldDelimiters: [ // AllowedFieldDelimiters
+ * //         "STRING_VALUE",
+ * //       ],
+ * //       allowedSuffixPathFields: [
+ * //         "STRING_VALUE",
+ * //       ],
+ * //     },
+ * //   ],
+ * //   nextToken: "STRING_VALUE",
+ * // };
+ *
+ * ```
+ *
+ * @param DescribeConfigurationTemplatesCommandInput - {@link DescribeConfigurationTemplatesCommandInput}
+ * @returns {@link DescribeConfigurationTemplatesCommandOutput}
+ * @see {@link DescribeConfigurationTemplatesCommandInput} for command's `input` shape.
+ * @see {@link DescribeConfigurationTemplatesCommandOutput} for command's `response` shape.
+ * @see {@link CloudWatchLogsClientResolvedConfig | config} for CloudWatchLogsClient's `config` shape.
+ *
+ * @throws {@link ResourceNotFoundException} (client fault)
+ *  <p>The specified resource does not exist.</p>
+ *
+ * @throws {@link ServiceUnavailableException} (server fault)
+ *  <p>The service cannot complete the request.</p>
+ *
+ * @throws {@link ThrottlingException} (client fault)
+ *  <p>The request was throttled because of quota limits.</p>
+ *
+ * @throws {@link ValidationException} (client fault)
+ *  <p>One of the parameters for the request is not valid.</p>
+ *
+ * @throws {@link CloudWatchLogsServiceException}
+ * <p>Base exception class for all service exceptions from CloudWatchLogs service.</p>
+ *
+ * @public
+ */
+export declare class DescribeConfigurationTemplatesCommand extends DescribeConfigurationTemplatesCommand_base {
+}

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

@@ -61,6 +61,14 @@ declare const DescribeDeliveriesCommand_base: {
  * //       deliverySourceName: "STRING_VALUE",
  * //       deliveryDestinationArn: "STRING_VALUE",
  * //       deliveryDestinationType: "S3" || "CWL" || "FH",
+ * //       recordFields: [ // RecordFields
+ * //         "STRING_VALUE",
+ * //       ],
+ * //       fieldDelimiter: "STRING_VALUE",
+ * //       s3DeliveryConfiguration: { // S3DeliveryConfiguration
+ * //         suffixPath: "STRING_VALUE",
+ * //         enableHiveCompatiblePath: true || false,
+ * //       },
  * //       tags: { // Tags
  * //         "<keys>": "STRING_VALUE",
  * //       },

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

@@ -60,6 +60,14 @@ declare const GetDeliveryCommand_base: {
  * //     deliverySourceName: "STRING_VALUE",
  * //     deliveryDestinationArn: "STRING_VALUE",
  * //     deliveryDestinationType: "S3" || "CWL" || "FH",
+ * //     recordFields: [ // RecordFields
+ * //       "STRING_VALUE",
+ * //     ],
+ * //     fieldDelimiter: "STRING_VALUE",
+ * //     s3DeliveryConfiguration: { // S3DeliveryConfiguration
+ * //       suffixPath: "STRING_VALUE",
+ * //       enableHiveCompatiblePath: true || false,
+ * //     },
  * //     tags: { // Tags
  * //       "<keys>": "STRING_VALUE",
  * //     },

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

@@ -84,7 +84,7 @@ declare const PutAccountPolicyCommand_base: {
  *         delivery. Kinesis Data Streams and Firehose are supported as logical destinations.</p>
  *             </li>
  *          </ul>
- *          <p>Each account can have one account-level subscription filter policy.
+ *          <p>Each account can have one account-level subscription filter policy per Region.
  *       If you are updating an existing filter, you must specify the correct name in <code>PolicyName</code>.
  *       To perform a <code>PutAccountPolicy</code> subscription filter operation for any destination except a Lambda
  *       function, you must also have the <code>iam:PassRole</code> permission.</p>

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

@@ -92,6 +92,14 @@ declare const PutLogEventsCommand_base: {
  *     },
  *   ],
  *   sequenceToken: "STRING_VALUE",
+ *   entity: { // Entity
+ *     keyAttributes: { // EntityKeyAttributes
+ *       "<keys>": "STRING_VALUE",
+ *     },
+ *     attributes: { // EntityAttributes
+ *       "<keys>": "STRING_VALUE",
+ *     },
+ *   },
  * };
  * const command = new PutLogEventsCommand(input);
  * const response = await client.send(command);
@@ -102,6 +110,9 @@ declare const PutLogEventsCommand_base: {
  * //     tooOldLogEventEndIndex: Number("int"),
  * //     expiredLogEventEndIndex: Number("int"),
  * //   },
+ * //   rejectedEntityInfo: { // RejectedEntityInfo
+ * //     errorType: "InvalidEntity" || "InvalidTypeValue" || "InvalidKeyAttributes" || "InvalidAttributes" || "EntitySizeTooLarge" || "UnsupportedLogGroupType" || "MissingRequiredFields", // required
+ * //   },
  * // };
  *
  * ```

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

@@ -32,6 +32,12 @@ declare const PutMetricFilterCommand_base: {
  *       through <a href="https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutLogEvents.html">PutLogEvents</a>.</p>
  *          <p>The maximum number of metric filters that can be associated with a log group is
  *       100.</p>
+ *          <p>Using regular expressions to create metric filters is supported. For these filters,
+ *       there is a quotas of quota of two regular expression patterns within a single filter pattern. There
+ *       is also a quota of five regular expression patterns per log group.
+ *     For more information about using regular expressions in metric filters,
+ *     see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/FilterAndPatternSyntax.html">
+ *       Filter pattern syntax for metric filters, subscription filters, filter log events, and Live Tail</a>.</p>
  *          <p>When you create a metric filter, you can also optionally assign a unit and dimensions
  *     to the metric that is created.</p>
  *          <important>

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

@@ -54,6 +54,12 @@ declare const PutSubscriptionFilterCommand_base: {
  *          <p>Each log group can have up to two subscription filters associated with it. If you are
  *       updating an existing filter, you must specify the correct name in <code>filterName</code>.
  *       </p>
+ *          <p>Using regular expressions to create subscription filters is supported. For these filters,
+ *       there is a quotas of quota of two regular expression patterns within a single filter pattern. There
+ *       is also a quota of five regular expression patterns per log group.
+ *       For more information about using regular expressions in subscription filters,
+ *       see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/FilterAndPatternSyntax.html">
+ *         Filter pattern syntax for metric filters, subscription filters, filter log events, and Live Tail</a>.</p>
  *          <p>To perform a <code>PutSubscriptionFilter</code> operation for any destination except a Lambda function,
  *     you must also have the
  *       <code>iam:PassRole</code> permission.</p>

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

@@ -53,11 +53,11 @@ declare const StartLiveTailCommand_base: {
  *           which it starts dropping the oldest events.</p>
  *             </li>
  *             <li>
- *                <p>A <a href="https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_SessionStreamingException.html">SessionStreamingException</a>
+ *                <p>A <a href="https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_StartLiveTailResponseStream.html#CWL-Type-StartLiveTailResponseStream-SessionStreamingException">SessionStreamingException</a>
  *         object is returned if an unknown error occurs on the server side.</p>
  *             </li>
  *             <li>
- *                <p>A <a href="https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_SessionTimeoutException.html">SessionTimeoutException</a>
+ *                <p>A <a href="https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_StartLiveTailResponseStream.html#CWL-Type-StartLiveTailResponseStream-SessionTimeoutException">SessionTimeoutException</a>
  *         object is returned when the session times out, after it has been kept open for three hours.</p>
  *             </li>
  *          </ul>

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

@@ -0,0 +1,86 @@
+import { Command as $Command } from "@smithy/smithy-client";
+import { MetadataBearer as __MetadataBearer } from "@smithy/types";
+import { CloudWatchLogsClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../CloudWatchLogsClient";
+import { UpdateDeliveryConfigurationRequest, UpdateDeliveryConfigurationResponse } from "../models/models_0";
+/**
+ * @public
+ */
+export type { __MetadataBearer };
+export { $Command };
+/**
+ * @public
+ *
+ * The input for {@link UpdateDeliveryConfigurationCommand}.
+ */
+export interface UpdateDeliveryConfigurationCommandInput extends UpdateDeliveryConfigurationRequest {
+}
+/**
+ * @public
+ *
+ * The output of {@link UpdateDeliveryConfigurationCommand}.
+ */
+export interface UpdateDeliveryConfigurationCommandOutput extends UpdateDeliveryConfigurationResponse, __MetadataBearer {
+}
+declare const UpdateDeliveryConfigurationCommand_base: {
+    new (input: UpdateDeliveryConfigurationCommandInput): import("@smithy/smithy-client").CommandImpl<UpdateDeliveryConfigurationCommandInput, UpdateDeliveryConfigurationCommandOutput, CloudWatchLogsClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
+    new (__0_0: UpdateDeliveryConfigurationCommandInput): import("@smithy/smithy-client").CommandImpl<UpdateDeliveryConfigurationCommandInput, UpdateDeliveryConfigurationCommandOutput, CloudWatchLogsClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
+    getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
+};
+/**
+ * <p>Use this operation to update the configuration of a <a href="https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_Delivery.html">delivery</a> to change either the
+ *       S3 path pattern or the format of the delivered logs. You can't use this operation to change the
+ *       source or destination of the delivery.</p>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { CloudWatchLogsClient, UpdateDeliveryConfigurationCommand } from "@aws-sdk/client-cloudwatch-logs"; // ES Modules import
+ * // const { CloudWatchLogsClient, UpdateDeliveryConfigurationCommand } = require("@aws-sdk/client-cloudwatch-logs"); // CommonJS import
+ * const client = new CloudWatchLogsClient(config);
+ * const input = { // UpdateDeliveryConfigurationRequest
+ *   id: "STRING_VALUE", // required
+ *   recordFields: [ // RecordFields
+ *     "STRING_VALUE",
+ *   ],
+ *   fieldDelimiter: "STRING_VALUE",
+ *   s3DeliveryConfiguration: { // S3DeliveryConfiguration
+ *     suffixPath: "STRING_VALUE",
+ *     enableHiveCompatiblePath: true || false,
+ *   },
+ * };
+ * const command = new UpdateDeliveryConfigurationCommand(input);
+ * const response = await client.send(command);
+ * // {};
+ *
+ * ```
+ *
+ * @param UpdateDeliveryConfigurationCommandInput - {@link UpdateDeliveryConfigurationCommandInput}
+ * @returns {@link UpdateDeliveryConfigurationCommandOutput}
+ * @see {@link UpdateDeliveryConfigurationCommandInput} for command's `input` shape.
+ * @see {@link UpdateDeliveryConfigurationCommandOutput} for command's `response` shape.
+ * @see {@link CloudWatchLogsClientResolvedConfig | config} for CloudWatchLogsClient's `config` shape.
+ *
+ * @throws {@link AccessDeniedException} (client fault)
+ *  <p>You don't have sufficient permissions to perform this action.</p>
+ *
+ * @throws {@link ConflictException} (client fault)
+ *  <p>This operation attempted to create a resource that already exists.</p>
+ *
+ * @throws {@link ResourceNotFoundException} (client fault)
+ *  <p>The specified resource does not exist.</p>
+ *
+ * @throws {@link ServiceUnavailableException} (server fault)
+ *  <p>The service cannot complete the request.</p>
+ *
+ * @throws {@link ThrottlingException} (client fault)
+ *  <p>The request was throttled because of quota limits.</p>
+ *
+ * @throws {@link ValidationException} (client fault)
+ *  <p>One of the parameters for the request is not valid.</p>
+ *
+ * @throws {@link CloudWatchLogsServiceException}
+ * <p>Base exception class for all service exceptions from CloudWatchLogs service.</p>
+ *
+ * @public
+ */
+export declare class UpdateDeliveryConfigurationCommand extends UpdateDeliveryConfigurationCommand_base {
+}

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

@@ -21,6 +21,7 @@ export * from "./DeleteResourcePolicyCommand";
 export * from "./DeleteRetentionPolicyCommand";
 export * from "./DeleteSubscriptionFilterCommand";
 export * from "./DescribeAccountPoliciesCommand";
+export * from "./DescribeConfigurationTemplatesCommand";
 export * from "./DescribeDeliveriesCommand";
 export * from "./DescribeDeliveryDestinationsCommand";
 export * from "./DescribeDeliverySourcesCommand";
@@ -71,4 +72,5 @@ export * from "./TestMetricFilterCommand";
 export * from "./UntagLogGroupCommand";
 export * from "./UntagResourceCommand";
 export * from "./UpdateAnomalyCommand";
+export * from "./UpdateDeliveryConfigurationCommand";
 export * from "./UpdateLogAnomalyDetectorCommand";