@aws-sdk/client-cloudwatch-logs 3.36.0 → 3.39.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (122) hide show
  1. package/CHANGELOG.md +42 -0
  2. package/dist-cjs/CloudWatchLogs.js +0 -36
  3. package/dist-cjs/CloudWatchLogsClient.js +0 -41
  4. package/dist-cjs/commands/AssociateKmsKeyCommand.js +0 -36
  5. package/dist-cjs/commands/CancelExportTaskCommand.js +0 -25
  6. package/dist-cjs/commands/CreateExportTaskCommand.js +0 -37
  7. package/dist-cjs/commands/CreateLogGroupCommand.js +0 -50
  8. package/dist-cjs/commands/CreateLogStreamCommand.js +0 -40
  9. package/dist-cjs/commands/DeleteDestinationCommand.js +0 -26
  10. package/dist-cjs/commands/DeleteLogGroupCommand.js +0 -25
  11. package/dist-cjs/commands/DeleteLogStreamCommand.js +0 -25
  12. package/dist-cjs/commands/DeleteMetricFilterCommand.js +0 -24
  13. package/dist-cjs/commands/DeleteQueryDefinitionCommand.js +0 -28
  14. package/dist-cjs/commands/DeleteResourcePolicyCommand.js +0 -25
  15. package/dist-cjs/commands/DeleteRetentionPolicyCommand.js +0 -25
  16. package/dist-cjs/commands/DeleteSubscriptionFilterCommand.js +0 -24
  17. package/dist-cjs/commands/DescribeDestinationsCommand.js +0 -24
  18. package/dist-cjs/commands/DescribeExportTasksCommand.js +0 -25
  19. package/dist-cjs/commands/DescribeLogGroupsCommand.js +0 -32
  20. package/dist-cjs/commands/DescribeLogStreamsCommand.js +0 -27
  21. package/dist-cjs/commands/DescribeMetricFiltersCommand.js +0 -26
  22. package/dist-cjs/commands/DescribeQueriesCommand.js +0 -26
  23. package/dist-cjs/commands/DescribeQueryDefinitionsCommand.js +0 -26
  24. package/dist-cjs/commands/DescribeResourcePoliciesCommand.js +0 -24
  25. package/dist-cjs/commands/DescribeSubscriptionFiltersCommand.js +0 -25
  26. package/dist-cjs/commands/DisassociateKmsKeyCommand.js +0 -27
  27. package/dist-cjs/commands/FilterLogEventsCommand.js +0 -32
  28. package/dist-cjs/commands/GetLogEventsCommand.js +0 -29
  29. package/dist-cjs/commands/GetLogGroupFieldsCommand.js +0 -31
  30. package/dist-cjs/commands/GetLogRecordCommand.js +0 -27
  31. package/dist-cjs/commands/GetQueryResultsCommand.js +0 -34
  32. package/dist-cjs/commands/ListTagsLogGroupCommand.js +0 -24
  33. package/dist-cjs/commands/PutDestinationCommand.js +0 -33
  34. package/dist-cjs/commands/PutDestinationPolicyCommand.js +0 -29
  35. package/dist-cjs/commands/PutLogEventsCommand.js +0 -61
  36. package/dist-cjs/commands/PutMetricFilterCommand.js +0 -46
  37. package/dist-cjs/commands/PutQueryDefinitionCommand.js +0 -35
  38. package/dist-cjs/commands/PutResourcePolicyCommand.js +0 -26
  39. package/dist-cjs/commands/PutRetentionPolicyCommand.js +0 -26
  40. package/dist-cjs/commands/PutSubscriptionFilterCommand.js +0 -52
  41. package/dist-cjs/commands/StartQueryCommand.js +0 -29
  42. package/dist-cjs/commands/StopQueryCommand.js +0 -25
  43. package/dist-cjs/commands/TagLogGroupCommand.js +0 -33
  44. package/dist-cjs/commands/TestMetricFilterCommand.js +0 -25
  45. package/dist-cjs/commands/UntagLogGroupCommand.js +0 -30
  46. package/dist-cjs/commands/index.js +45 -0
  47. package/dist-cjs/endpoints.js +6 -1
  48. package/dist-cjs/index.js +4 -52
  49. package/dist-cjs/models/models_0.js +0 -300
  50. package/dist-cjs/pagination/DescribeDestinationsPaginator.js +0 -10
  51. package/dist-cjs/pagination/DescribeLogGroupsPaginator.js +0 -10
  52. package/dist-cjs/pagination/DescribeLogStreamsPaginator.js +0 -10
  53. package/dist-cjs/pagination/DescribeMetricFiltersPaginator.js +0 -10
  54. package/dist-cjs/pagination/DescribeSubscriptionFiltersPaginator.js +0 -10
  55. package/dist-cjs/pagination/FilterLogEventsPaginator.js +0 -10
  56. package/dist-cjs/pagination/GetLogEventsPaginator.js +0 -10
  57. package/dist-cjs/pagination/index.js +11 -0
  58. package/dist-cjs/protocols/Aws_json1_1.js +0 -5
  59. package/dist-cjs/runtimeConfig.browser.js +1 -5
  60. package/dist-cjs/runtimeConfig.js +1 -5
  61. package/dist-cjs/runtimeConfig.native.js +0 -3
  62. package/dist-cjs/runtimeConfig.shared.js +0 -3
  63. package/dist-es/commands/index.js +42 -0
  64. package/dist-es/endpoints.js +6 -1
  65. package/dist-es/index.js +4 -52
  66. package/dist-es/pagination/index.js +8 -0
  67. package/dist-types/commands/index.d.ts +42 -0
  68. package/dist-types/index.d.ts +4 -52
  69. package/dist-types/pagination/index.d.ts +8 -0
  70. package/dist-types/ts3.4/CloudWatchLogs.d.ts +43 -433
  71. package/dist-types/ts3.4/CloudWatchLogsClient.d.ts +24 -122
  72. package/dist-types/ts3.4/commands/AssociateKmsKeyCommand.d.ts +2 -32
  73. package/dist-types/ts3.4/commands/CancelExportTaskCommand.d.ts +2 -21
  74. package/dist-types/ts3.4/commands/CreateExportTaskCommand.d.ts +2 -33
  75. package/dist-types/ts3.4/commands/CreateLogGroupCommand.d.ts +2 -46
  76. package/dist-types/ts3.4/commands/CreateLogStreamCommand.d.ts +2 -36
  77. package/dist-types/ts3.4/commands/DeleteDestinationCommand.d.ts +2 -22
  78. package/dist-types/ts3.4/commands/DeleteLogGroupCommand.d.ts +2 -21
  79. package/dist-types/ts3.4/commands/DeleteLogStreamCommand.d.ts +2 -21
  80. package/dist-types/ts3.4/commands/DeleteMetricFilterCommand.d.ts +2 -20
  81. package/dist-types/ts3.4/commands/DeleteQueryDefinitionCommand.d.ts +2 -24
  82. package/dist-types/ts3.4/commands/DeleteResourcePolicyCommand.d.ts +2 -21
  83. package/dist-types/ts3.4/commands/DeleteRetentionPolicyCommand.d.ts +2 -21
  84. package/dist-types/ts3.4/commands/DeleteSubscriptionFilterCommand.d.ts +2 -20
  85. package/dist-types/ts3.4/commands/DescribeDestinationsCommand.d.ts +2 -20
  86. package/dist-types/ts3.4/commands/DescribeExportTasksCommand.d.ts +2 -21
  87. package/dist-types/ts3.4/commands/DescribeLogGroupsCommand.d.ts +2 -28
  88. package/dist-types/ts3.4/commands/DescribeLogStreamsCommand.d.ts +2 -23
  89. package/dist-types/ts3.4/commands/DescribeMetricFiltersCommand.d.ts +2 -22
  90. package/dist-types/ts3.4/commands/DescribeQueriesCommand.d.ts +2 -22
  91. package/dist-types/ts3.4/commands/DescribeQueryDefinitionsCommand.d.ts +2 -22
  92. package/dist-types/ts3.4/commands/DescribeResourcePoliciesCommand.d.ts +2 -20
  93. package/dist-types/ts3.4/commands/DescribeSubscriptionFiltersCommand.d.ts +2 -21
  94. package/dist-types/ts3.4/commands/DisassociateKmsKeyCommand.d.ts +2 -23
  95. package/dist-types/ts3.4/commands/FilterLogEventsCommand.d.ts +2 -28
  96. package/dist-types/ts3.4/commands/GetLogEventsCommand.d.ts +2 -25
  97. package/dist-types/ts3.4/commands/GetLogGroupFieldsCommand.d.ts +2 -27
  98. package/dist-types/ts3.4/commands/GetLogRecordCommand.d.ts +2 -23
  99. package/dist-types/ts3.4/commands/GetQueryResultsCommand.d.ts +2 -30
  100. package/dist-types/ts3.4/commands/ListTagsLogGroupCommand.d.ts +2 -20
  101. package/dist-types/ts3.4/commands/PutDestinationCommand.d.ts +2 -29
  102. package/dist-types/ts3.4/commands/PutDestinationPolicyCommand.d.ts +2 -25
  103. package/dist-types/ts3.4/commands/PutLogEventsCommand.d.ts +2 -57
  104. package/dist-types/ts3.4/commands/PutMetricFilterCommand.d.ts +2 -42
  105. package/dist-types/ts3.4/commands/PutQueryDefinitionCommand.d.ts +2 -31
  106. package/dist-types/ts3.4/commands/PutResourcePolicyCommand.d.ts +2 -22
  107. package/dist-types/ts3.4/commands/PutRetentionPolicyCommand.d.ts +2 -22
  108. package/dist-types/ts3.4/commands/PutSubscriptionFilterCommand.d.ts +2 -48
  109. package/dist-types/ts3.4/commands/StartQueryCommand.d.ts +2 -25
  110. package/dist-types/ts3.4/commands/StopQueryCommand.d.ts +2 -21
  111. package/dist-types/ts3.4/commands/TagLogGroupCommand.d.ts +2 -29
  112. package/dist-types/ts3.4/commands/TestMetricFilterCommand.d.ts +2 -21
  113. package/dist-types/ts3.4/commands/UntagLogGroupCommand.d.ts +2 -26
  114. package/dist-types/ts3.4/commands/index.d.ts +42 -0
  115. package/dist-types/ts3.4/index.d.ts +4 -52
  116. package/dist-types/ts3.4/models/models_0.d.ts +392 -1434
  117. package/dist-types/ts3.4/pagination/index.d.ts +8 -0
  118. package/dist-types/ts3.4/runtimeConfig.browser.d.ts +1 -3
  119. package/dist-types/ts3.4/runtimeConfig.d.ts +1 -3
  120. package/dist-types/ts3.4/runtimeConfig.native.d.ts +1 -3
  121. package/dist-types/ts3.4/runtimeConfig.shared.d.ts +1 -3
  122. package/package.json +32 -32
package/CHANGELOG.md CHANGED
@@ -3,6 +3,48 @@
3
3
  All notable changes to this project will be documented in this file.
4
4
  See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
5
5
 
6
+ # [3.39.0](https://github.com/aws/aws-sdk-js-v3/compare/v3.38.0...v3.39.0) (2021-10-29)
7
+
8
+ **Note:** Version bump only for package @aws-sdk/client-cloudwatch-logs
9
+
10
+
11
+
12
+
13
+
14
+ # [3.38.0](https://github.com/aws/aws-sdk-js-v3/compare/v3.37.0...v3.38.0) (2021-10-22)
15
+
16
+
17
+ ### Features
18
+
19
+ * **client-documentation-generator:** rename package ([#2916](https://github.com/aws/aws-sdk-js-v3/issues/2916)) ([1a80bfd](https://github.com/aws/aws-sdk-js-v3/commit/1a80bfd2dfc583001ddb4a21b6432eaaad699aa7))
20
+ * **clients:** export folder from index.ts ([#2912](https://github.com/aws/aws-sdk-js-v3/issues/2912)) ([183b46d](https://github.com/aws/aws-sdk-js-v3/commit/183b46dde7f5613128038bf1c076f3c0b693203b))
21
+
22
+
23
+
24
+
25
+
26
+ # [3.37.0](https://github.com/aws/aws-sdk-js-v3/compare/v3.36.1...v3.37.0) (2021-10-15)
27
+
28
+
29
+ ### Features
30
+
31
+ * **clients:** update clients as of 10/15/2021 ([#2902](https://github.com/aws/aws-sdk-js-v3/issues/2902)) ([2730b54](https://github.com/aws/aws-sdk-js-v3/commit/2730b5424377944a5a2ad5e1ad7d3ca4135dae1c))
32
+
33
+
34
+
35
+
36
+
37
+ ## [3.36.1](https://github.com/aws/aws-sdk-js-v3/compare/v3.36.0...v3.36.1) (2021-10-12)
38
+
39
+
40
+ ### Bug Fixes
41
+
42
+ * **clients:** emitDeclarationOnly in tsconfig.types.json ([#2893](https://github.com/aws/aws-sdk-js-v3/issues/2893)) ([6dc3d56](https://github.com/aws/aws-sdk-js-v3/commit/6dc3d56c20809c90cbdc4dd48627eeebc64af99d))
43
+
44
+
45
+
46
+
47
+
6
48
  # [3.36.0](https://github.com/aws/aws-sdk-js-v3/compare/v3.35.0...v3.36.0) (2021-10-08)
7
49
 
8
50
 
@@ -44,42 +44,6 @@ const StopQueryCommand_1 = require("./commands/StopQueryCommand");
44
44
  const TagLogGroupCommand_1 = require("./commands/TagLogGroupCommand");
45
45
  const TestMetricFilterCommand_1 = require("./commands/TestMetricFilterCommand");
46
46
  const UntagLogGroupCommand_1 = require("./commands/UntagLogGroupCommand");
47
- /**
48
- * <p>You can use Amazon CloudWatch Logs to monitor, store, and access your log files from
49
- * EC2 instances, CloudTrail, and other sources. You can then retrieve the associated
50
- * log data from CloudWatch Logs using the CloudWatch console, CloudWatch Logs commands in the
51
- * Amazon Web Services CLI, CloudWatch Logs API, or CloudWatch Logs SDK.</p>
52
- * <p>You can use CloudWatch Logs to:</p>
53
- * <ul>
54
- * <li>
55
- * <p>
56
- * <b>Monitor logs from EC2 instances in real-time</b>: You
57
- * can use CloudWatch Logs to monitor applications and systems using log data. For example,
58
- * CloudWatch Logs can track the number of errors that occur in your application logs and
59
- * send you a notification whenever the rate of errors exceeds a threshold that you specify.
60
- * CloudWatch Logs uses your log data for monitoring so no code changes are required. For
61
- * example, you can monitor application logs for specific literal terms (such as
62
- * "NullReferenceException") or count the number of occurrences of a literal term at a
63
- * particular position in log data (such as "404" status codes in an Apache access log). When
64
- * the term you are searching for is found, CloudWatch Logs reports the data to a CloudWatch
65
- * metric that you specify.</p>
66
- * </li>
67
- * <li>
68
- * <p>
69
- * <b>Monitor CloudTrail logged events</b>: You can
70
- * create alarms in CloudWatch and receive notifications of particular API activity as
71
- * captured by CloudTrail. You can use the notification to perform troubleshooting.</p>
72
- * </li>
73
- * <li>
74
- * <p>
75
- * <b>Archive log data</b>: You can use CloudWatch Logs to
76
- * store your log data in highly durable storage. You can change the log retention setting so
77
- * that any log events older than this setting are automatically deleted. The CloudWatch Logs
78
- * agent makes it easy to quickly send both rotated and non-rotated log data off of a host
79
- * and into the log service. You can then access the raw log data when you need it.</p>
80
- * </li>
81
- * </ul>
82
- */
83
47
  class CloudWatchLogs extends CloudWatchLogsClient_1.CloudWatchLogsClient {
84
48
  associateKmsKey(args, optionsOrCb, cb) {
85
49
  const command = new AssociateKmsKeyCommand_1.AssociateKmsKeyCommand(args);
@@ -10,42 +10,6 @@ const middleware_signing_1 = require("@aws-sdk/middleware-signing");
10
10
  const middleware_user_agent_1 = require("@aws-sdk/middleware-user-agent");
11
11
  const smithy_client_1 = require("@aws-sdk/smithy-client");
12
12
  const runtimeConfig_1 = require("./runtimeConfig");
13
- /**
14
- * <p>You can use Amazon CloudWatch Logs to monitor, store, and access your log files from
15
- * EC2 instances, CloudTrail, and other sources. You can then retrieve the associated
16
- * log data from CloudWatch Logs using the CloudWatch console, CloudWatch Logs commands in the
17
- * Amazon Web Services CLI, CloudWatch Logs API, or CloudWatch Logs SDK.</p>
18
- * <p>You can use CloudWatch Logs to:</p>
19
- * <ul>
20
- * <li>
21
- * <p>
22
- * <b>Monitor logs from EC2 instances in real-time</b>: You
23
- * can use CloudWatch Logs to monitor applications and systems using log data. For example,
24
- * CloudWatch Logs can track the number of errors that occur in your application logs and
25
- * send you a notification whenever the rate of errors exceeds a threshold that you specify.
26
- * CloudWatch Logs uses your log data for monitoring so no code changes are required. For
27
- * example, you can monitor application logs for specific literal terms (such as
28
- * "NullReferenceException") or count the number of occurrences of a literal term at a
29
- * particular position in log data (such as "404" status codes in an Apache access log). When
30
- * the term you are searching for is found, CloudWatch Logs reports the data to a CloudWatch
31
- * metric that you specify.</p>
32
- * </li>
33
- * <li>
34
- * <p>
35
- * <b>Monitor CloudTrail logged events</b>: You can
36
- * create alarms in CloudWatch and receive notifications of particular API activity as
37
- * captured by CloudTrail. You can use the notification to perform troubleshooting.</p>
38
- * </li>
39
- * <li>
40
- * <p>
41
- * <b>Archive log data</b>: You can use CloudWatch Logs to
42
- * store your log data in highly durable storage. You can change the log retention setting so
43
- * that any log events older than this setting are automatically deleted. The CloudWatch Logs
44
- * agent makes it easy to quickly send both rotated and non-rotated log data off of a host
45
- * and into the log service. You can then access the raw log data when you need it.</p>
46
- * </li>
47
- * </ul>
48
- */
49
13
  class CloudWatchLogsClient extends smithy_client_1.Client {
50
14
  constructor(configuration) {
51
15
  const _config_0 = runtimeConfig_1.getRuntimeConfig(configuration);
@@ -64,11 +28,6 @@ class CloudWatchLogsClient extends smithy_client_1.Client {
64
28
  this.middlewareStack.use(middleware_signing_1.getAwsAuthPlugin(this.config));
65
29
  this.middlewareStack.use(middleware_user_agent_1.getUserAgentPlugin(this.config));
66
30
  }
67
- /**
68
- * Destroy underlying resources, like sockets. It's usually not necessary to do this.
69
- * However in Node.js, it's best to explicitly shut down the client's agent when it is no longer needed.
70
- * Otherwise, sockets might stay open for quite a long time before the server terminates them.
71
- */
72
31
  destroy() {
73
32
  super.destroy();
74
33
  }
@@ -5,47 +5,11 @@ const middleware_serde_1 = require("@aws-sdk/middleware-serde");
5
5
  const smithy_client_1 = require("@aws-sdk/smithy-client");
6
6
  const models_0_1 = require("../models/models_0");
7
7
  const Aws_json1_1_1 = require("../protocols/Aws_json1_1");
8
- /**
9
- * <p>Associates the specified Key Management Service customer master key (CMK) with the specified log group.</p>
10
- * <p>Associating an KMS CMK with a log group overrides any existing associations between the log group and a CMK.
11
- * After a CMK is associated with a log group, all newly ingested data for the log group is encrypted using the CMK.
12
- * This association is stored as long as the data encrypted with the CMK is still within CloudWatch Logs.
13
- * This enables CloudWatch Logs to decrypt this data whenever it is requested.</p>
14
- * <important>
15
- * <p>CloudWatch Logs supports only symmetric CMKs. Do not use an associate an asymmetric CMK
16
- * with your log group. For more information, see <a href="https://docs.aws.amazon.com/kms/latest/developerguide/symmetric-asymmetric.html">Using Symmetric and Asymmetric
17
- * Keys</a>.</p>
18
- * </important>
19
- * <p>It can take up to 5 minutes for this operation to take effect.</p>
20
- * <p>If you attempt to associate a CMK with a log group but the CMK does not exist or the
21
- * CMK is disabled, you receive an <code>InvalidParameterException</code> error. </p>
22
- * @example
23
- * Use a bare-bones client and the command you need to make an API call.
24
- * ```javascript
25
- * import { CloudWatchLogsClient, AssociateKmsKeyCommand } from "@aws-sdk/client-cloudwatch-logs"; // ES Modules import
26
- * // const { CloudWatchLogsClient, AssociateKmsKeyCommand } = require("@aws-sdk/client-cloudwatch-logs"); // CommonJS import
27
- * const client = new CloudWatchLogsClient(config);
28
- * const command = new AssociateKmsKeyCommand(input);
29
- * const response = await client.send(command);
30
- * ```
31
- *
32
- * @see {@link AssociateKmsKeyCommandInput} for command's `input` shape.
33
- * @see {@link AssociateKmsKeyCommandOutput} for command's `response` shape.
34
- * @see {@link CloudWatchLogsClientResolvedConfig | config} for command's `input` shape.
35
- *
36
- */
37
8
  class AssociateKmsKeyCommand extends smithy_client_1.Command {
38
- // Start section: command_properties
39
- // End section: command_properties
40
9
  constructor(input) {
41
- // Start section: command_constructor
42
10
  super();
43
11
  this.input = input;
44
- // End section: command_constructor
45
12
  }
46
- /**
47
- * @internal
48
- */
49
13
  resolveMiddleware(clientStack, configuration, options) {
50
14
  this.middlewareStack.use(middleware_serde_1.getSerdePlugin(configuration, this.serialize, this.deserialize));
51
15
  const stack = clientStack.concat(this.middlewareStack);
@@ -5,36 +5,11 @@ const middleware_serde_1 = require("@aws-sdk/middleware-serde");
5
5
  const smithy_client_1 = require("@aws-sdk/smithy-client");
6
6
  const models_0_1 = require("../models/models_0");
7
7
  const Aws_json1_1_1 = require("../protocols/Aws_json1_1");
8
- /**
9
- * <p>Cancels the specified export task.</p>
10
- * <p>The task must be in the <code>PENDING</code> or <code>RUNNING</code> state.</p>
11
- * @example
12
- * Use a bare-bones client and the command you need to make an API call.
13
- * ```javascript
14
- * import { CloudWatchLogsClient, CancelExportTaskCommand } from "@aws-sdk/client-cloudwatch-logs"; // ES Modules import
15
- * // const { CloudWatchLogsClient, CancelExportTaskCommand } = require("@aws-sdk/client-cloudwatch-logs"); // CommonJS import
16
- * const client = new CloudWatchLogsClient(config);
17
- * const command = new CancelExportTaskCommand(input);
18
- * const response = await client.send(command);
19
- * ```
20
- *
21
- * @see {@link CancelExportTaskCommandInput} for command's `input` shape.
22
- * @see {@link CancelExportTaskCommandOutput} for command's `response` shape.
23
- * @see {@link CloudWatchLogsClientResolvedConfig | config} for command's `input` shape.
24
- *
25
- */
26
8
  class CancelExportTaskCommand extends smithy_client_1.Command {
27
- // Start section: command_properties
28
- // End section: command_properties
29
9
  constructor(input) {
30
- // Start section: command_constructor
31
10
  super();
32
11
  this.input = input;
33
- // End section: command_constructor
34
12
  }
35
- /**
36
- * @internal
37
- */
38
13
  resolveMiddleware(clientStack, configuration, options) {
39
14
  this.middlewareStack.use(middleware_serde_1.getSerdePlugin(configuration, this.serialize, this.deserialize));
40
15
  const stack = clientStack.concat(this.middlewareStack);
@@ -5,48 +5,11 @@ const middleware_serde_1 = require("@aws-sdk/middleware-serde");
5
5
  const smithy_client_1 = require("@aws-sdk/smithy-client");
6
6
  const models_0_1 = require("../models/models_0");
7
7
  const Aws_json1_1_1 = require("../protocols/Aws_json1_1");
8
- /**
9
- * <p>Creates an export task, which allows you to efficiently export data from a
10
- * log group to an Amazon S3 bucket. When you perform a <code>CreateExportTask</code>
11
- * operation, you must use credentials that have permission to write to the S3 bucket
12
- * that you specify as the destination.</p>
13
- * <p>This is an asynchronous call. If all the required information is provided, this
14
- * operation initiates an export task and responds with the ID of the task. After the task has started,
15
- * you can use <a href="https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DescribeExportTasks.html">DescribeExportTasks</a> to get the status of the export task. Each account can
16
- * only have one active (<code>RUNNING</code> or <code>PENDING</code>) export task at a time.
17
- * To cancel an export task, use <a href="https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_CancelExportTask.html">CancelExportTask</a>.</p>
18
- * <p>You can export logs from multiple log groups or multiple time ranges to the same S3
19
- * bucket. To separate out log data for each export task, you can specify a prefix to be used as
20
- * the Amazon S3 key prefix for all exported objects.</p>
21
- * <p>Exporting to S3 buckets that are encrypted with AES-256 is supported. Exporting to S3 buckets
22
- * encrypted with SSE-KMS is not supported. </p>
23
- * @example
24
- * Use a bare-bones client and the command you need to make an API call.
25
- * ```javascript
26
- * import { CloudWatchLogsClient, CreateExportTaskCommand } from "@aws-sdk/client-cloudwatch-logs"; // ES Modules import
27
- * // const { CloudWatchLogsClient, CreateExportTaskCommand } = require("@aws-sdk/client-cloudwatch-logs"); // CommonJS import
28
- * const client = new CloudWatchLogsClient(config);
29
- * const command = new CreateExportTaskCommand(input);
30
- * const response = await client.send(command);
31
- * ```
32
- *
33
- * @see {@link CreateExportTaskCommandInput} for command's `input` shape.
34
- * @see {@link CreateExportTaskCommandOutput} for command's `response` shape.
35
- * @see {@link CloudWatchLogsClientResolvedConfig | config} for command's `input` shape.
36
- *
37
- */
38
8
  class CreateExportTaskCommand extends smithy_client_1.Command {
39
- // Start section: command_properties
40
- // End section: command_properties
41
9
  constructor(input) {
42
- // Start section: command_constructor
43
10
  super();
44
11
  this.input = input;
45
- // End section: command_constructor
46
12
  }
47
- /**
48
- * @internal
49
- */
50
13
  resolveMiddleware(clientStack, configuration, options) {
51
14
  this.middlewareStack.use(middleware_serde_1.getSerdePlugin(configuration, this.serialize, this.deserialize));
52
15
  const stack = clientStack.concat(this.middlewareStack);
@@ -5,61 +5,11 @@ const middleware_serde_1 = require("@aws-sdk/middleware-serde");
5
5
  const smithy_client_1 = require("@aws-sdk/smithy-client");
6
6
  const models_0_1 = require("../models/models_0");
7
7
  const Aws_json1_1_1 = require("../protocols/Aws_json1_1");
8
- /**
9
- * <p>Creates a log group with the specified name. You can create up to 20,000 log groups per account.</p>
10
- * <p>You must use the following guidelines when naming a log group:</p>
11
- * <ul>
12
- * <li>
13
- * <p>Log group names must be unique within a region for an Amazon Web Services account.</p>
14
- * </li>
15
- * <li>
16
- * <p>Log group names can be between 1 and 512 characters long.</p>
17
- * </li>
18
- * <li>
19
- * <p>Log group names consist of the following characters: a-z, A-Z, 0-9, '_' (underscore), '-' (hyphen),
20
- * '/' (forward slash), '.' (period), and '#' (number sign)</p>
21
- * </li>
22
- * </ul>
23
- * <p>When you create a log group, by default the log events in the log group never expire. To set
24
- * a retention policy so that events expire and are deleted after a specified time, use
25
- * <a href="https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutRetentionPolicy.html">PutRetentionPolicy</a>.</p>
26
- * <p>If you associate a Key Management Service customer master key (CMK) with the log group, ingested data is encrypted using the CMK.
27
- * This association is stored as long as the data encrypted with the CMK is still within CloudWatch Logs.
28
- * This enables CloudWatch Logs to decrypt this data whenever it is requested.</p>
29
- * <p>If you attempt to associate a CMK with the log group but the CMK does not exist or the
30
- * CMK is disabled, you receive an <code>InvalidParameterException</code> error. </p>
31
- * <important>
32
- * <p>CloudWatch Logs supports only symmetric CMKs. Do not associate an asymmetric CMK with
33
- * your log group. For more information, see <a href="https://docs.aws.amazon.com/kms/latest/developerguide/symmetric-asymmetric.html">Using Symmetric and Asymmetric
34
- * Keys</a>.</p>
35
- * </important>
36
- * @example
37
- * Use a bare-bones client and the command you need to make an API call.
38
- * ```javascript
39
- * import { CloudWatchLogsClient, CreateLogGroupCommand } from "@aws-sdk/client-cloudwatch-logs"; // ES Modules import
40
- * // const { CloudWatchLogsClient, CreateLogGroupCommand } = require("@aws-sdk/client-cloudwatch-logs"); // CommonJS import
41
- * const client = new CloudWatchLogsClient(config);
42
- * const command = new CreateLogGroupCommand(input);
43
- * const response = await client.send(command);
44
- * ```
45
- *
46
- * @see {@link CreateLogGroupCommandInput} for command's `input` shape.
47
- * @see {@link CreateLogGroupCommandOutput} for command's `response` shape.
48
- * @see {@link CloudWatchLogsClientResolvedConfig | config} for command's `input` shape.
49
- *
50
- */
51
8
  class CreateLogGroupCommand extends smithy_client_1.Command {
52
- // Start section: command_properties
53
- // End section: command_properties
54
9
  constructor(input) {
55
- // Start section: command_constructor
56
10
  super();
57
11
  this.input = input;
58
- // End section: command_constructor
59
12
  }
60
- /**
61
- * @internal
62
- */
63
13
  resolveMiddleware(clientStack, configuration, options) {
64
14
  this.middlewareStack.use(middleware_serde_1.getSerdePlugin(configuration, this.serialize, this.deserialize));
65
15
  const stack = clientStack.concat(this.middlewareStack);
@@ -5,51 +5,11 @@ const middleware_serde_1 = require("@aws-sdk/middleware-serde");
5
5
  const smithy_client_1 = require("@aws-sdk/smithy-client");
6
6
  const models_0_1 = require("../models/models_0");
7
7
  const Aws_json1_1_1 = require("../protocols/Aws_json1_1");
8
- /**
9
- * <p>Creates a log stream for the specified log group. A log stream is a sequence of log events
10
- * that originate from a single source, such as an application instance or a resource that is
11
- * being monitored.</p>
12
- * <p>There is no limit on the number of log streams that you can create for a log group. There is a limit
13
- * of 50 TPS on <code>CreateLogStream</code> operations, after which transactions are throttled.</p>
14
- * <p>You must use the following guidelines when naming a log stream:</p>
15
- * <ul>
16
- * <li>
17
- * <p>Log stream names must be unique within the log group.</p>
18
- * </li>
19
- * <li>
20
- * <p>Log stream names can be between 1 and 512 characters long.</p>
21
- * </li>
22
- * <li>
23
- * <p>The ':' (colon) and '*' (asterisk) characters are not allowed.</p>
24
- * </li>
25
- * </ul>
26
- * @example
27
- * Use a bare-bones client and the command you need to make an API call.
28
- * ```javascript
29
- * import { CloudWatchLogsClient, CreateLogStreamCommand } from "@aws-sdk/client-cloudwatch-logs"; // ES Modules import
30
- * // const { CloudWatchLogsClient, CreateLogStreamCommand } = require("@aws-sdk/client-cloudwatch-logs"); // CommonJS import
31
- * const client = new CloudWatchLogsClient(config);
32
- * const command = new CreateLogStreamCommand(input);
33
- * const response = await client.send(command);
34
- * ```
35
- *
36
- * @see {@link CreateLogStreamCommandInput} for command's `input` shape.
37
- * @see {@link CreateLogStreamCommandOutput} for command's `response` shape.
38
- * @see {@link CloudWatchLogsClientResolvedConfig | config} for command's `input` shape.
39
- *
40
- */
41
8
  class CreateLogStreamCommand extends smithy_client_1.Command {
42
- // Start section: command_properties
43
- // End section: command_properties
44
9
  constructor(input) {
45
- // Start section: command_constructor
46
10
  super();
47
11
  this.input = input;
48
- // End section: command_constructor
49
12
  }
50
- /**
51
- * @internal
52
- */
53
13
  resolveMiddleware(clientStack, configuration, options) {
54
14
  this.middlewareStack.use(middleware_serde_1.getSerdePlugin(configuration, this.serialize, this.deserialize));
55
15
  const stack = clientStack.concat(this.middlewareStack);
@@ -5,37 +5,11 @@ const middleware_serde_1 = require("@aws-sdk/middleware-serde");
5
5
  const smithy_client_1 = require("@aws-sdk/smithy-client");
6
6
  const models_0_1 = require("../models/models_0");
7
7
  const Aws_json1_1_1 = require("../protocols/Aws_json1_1");
8
- /**
9
- * <p>Deletes the specified destination, and eventually disables all the
10
- * subscription filters that publish to it. This operation does not delete the
11
- * physical resource encapsulated by the destination.</p>
12
- * @example
13
- * Use a bare-bones client and the command you need to make an API call.
14
- * ```javascript
15
- * import { CloudWatchLogsClient, DeleteDestinationCommand } from "@aws-sdk/client-cloudwatch-logs"; // ES Modules import
16
- * // const { CloudWatchLogsClient, DeleteDestinationCommand } = require("@aws-sdk/client-cloudwatch-logs"); // CommonJS import
17
- * const client = new CloudWatchLogsClient(config);
18
- * const command = new DeleteDestinationCommand(input);
19
- * const response = await client.send(command);
20
- * ```
21
- *
22
- * @see {@link DeleteDestinationCommandInput} for command's `input` shape.
23
- * @see {@link DeleteDestinationCommandOutput} for command's `response` shape.
24
- * @see {@link CloudWatchLogsClientResolvedConfig | config} for command's `input` shape.
25
- *
26
- */
27
8
  class DeleteDestinationCommand extends smithy_client_1.Command {
28
- // Start section: command_properties
29
- // End section: command_properties
30
9
  constructor(input) {
31
- // Start section: command_constructor
32
10
  super();
33
11
  this.input = input;
34
- // End section: command_constructor
35
12
  }
36
- /**
37
- * @internal
38
- */
39
13
  resolveMiddleware(clientStack, configuration, options) {
40
14
  this.middlewareStack.use(middleware_serde_1.getSerdePlugin(configuration, this.serialize, this.deserialize));
41
15
  const stack = clientStack.concat(this.middlewareStack);
@@ -5,36 +5,11 @@ const middleware_serde_1 = require("@aws-sdk/middleware-serde");
5
5
  const smithy_client_1 = require("@aws-sdk/smithy-client");
6
6
  const models_0_1 = require("../models/models_0");
7
7
  const Aws_json1_1_1 = require("../protocols/Aws_json1_1");
8
- /**
9
- * <p>Deletes the specified log group and permanently deletes all the archived
10
- * log events associated with the log group.</p>
11
- * @example
12
- * Use a bare-bones client and the command you need to make an API call.
13
- * ```javascript
14
- * import { CloudWatchLogsClient, DeleteLogGroupCommand } from "@aws-sdk/client-cloudwatch-logs"; // ES Modules import
15
- * // const { CloudWatchLogsClient, DeleteLogGroupCommand } = require("@aws-sdk/client-cloudwatch-logs"); // CommonJS import
16
- * const client = new CloudWatchLogsClient(config);
17
- * const command = new DeleteLogGroupCommand(input);
18
- * const response = await client.send(command);
19
- * ```
20
- *
21
- * @see {@link DeleteLogGroupCommandInput} for command's `input` shape.
22
- * @see {@link DeleteLogGroupCommandOutput} for command's `response` shape.
23
- * @see {@link CloudWatchLogsClientResolvedConfig | config} for command's `input` shape.
24
- *
25
- */
26
8
  class DeleteLogGroupCommand extends smithy_client_1.Command {
27
- // Start section: command_properties
28
- // End section: command_properties
29
9
  constructor(input) {
30
- // Start section: command_constructor
31
10
  super();
32
11
  this.input = input;
33
- // End section: command_constructor
34
12
  }
35
- /**
36
- * @internal
37
- */
38
13
  resolveMiddleware(clientStack, configuration, options) {
39
14
  this.middlewareStack.use(middleware_serde_1.getSerdePlugin(configuration, this.serialize, this.deserialize));
40
15
  const stack = clientStack.concat(this.middlewareStack);
@@ -5,36 +5,11 @@ const middleware_serde_1 = require("@aws-sdk/middleware-serde");
5
5
  const smithy_client_1 = require("@aws-sdk/smithy-client");
6
6
  const models_0_1 = require("../models/models_0");
7
7
  const Aws_json1_1_1 = require("../protocols/Aws_json1_1");
8
- /**
9
- * <p>Deletes the specified log stream and permanently deletes all the archived log events associated
10
- * with the log stream.</p>
11
- * @example
12
- * Use a bare-bones client and the command you need to make an API call.
13
- * ```javascript
14
- * import { CloudWatchLogsClient, DeleteLogStreamCommand } from "@aws-sdk/client-cloudwatch-logs"; // ES Modules import
15
- * // const { CloudWatchLogsClient, DeleteLogStreamCommand } = require("@aws-sdk/client-cloudwatch-logs"); // CommonJS import
16
- * const client = new CloudWatchLogsClient(config);
17
- * const command = new DeleteLogStreamCommand(input);
18
- * const response = await client.send(command);
19
- * ```
20
- *
21
- * @see {@link DeleteLogStreamCommandInput} for command's `input` shape.
22
- * @see {@link DeleteLogStreamCommandOutput} for command's `response` shape.
23
- * @see {@link CloudWatchLogsClientResolvedConfig | config} for command's `input` shape.
24
- *
25
- */
26
8
  class DeleteLogStreamCommand extends smithy_client_1.Command {
27
- // Start section: command_properties
28
- // End section: command_properties
29
9
  constructor(input) {
30
- // Start section: command_constructor
31
10
  super();
32
11
  this.input = input;
33
- // End section: command_constructor
34
12
  }
35
- /**
36
- * @internal
37
- */
38
13
  resolveMiddleware(clientStack, configuration, options) {
39
14
  this.middlewareStack.use(middleware_serde_1.getSerdePlugin(configuration, this.serialize, this.deserialize));
40
15
  const stack = clientStack.concat(this.middlewareStack);
@@ -5,35 +5,11 @@ const middleware_serde_1 = require("@aws-sdk/middleware-serde");
5
5
  const smithy_client_1 = require("@aws-sdk/smithy-client");
6
6
  const models_0_1 = require("../models/models_0");
7
7
  const Aws_json1_1_1 = require("../protocols/Aws_json1_1");
8
- /**
9
- * <p>Deletes the specified metric filter.</p>
10
- * @example
11
- * Use a bare-bones client and the command you need to make an API call.
12
- * ```javascript
13
- * import { CloudWatchLogsClient, DeleteMetricFilterCommand } from "@aws-sdk/client-cloudwatch-logs"; // ES Modules import
14
- * // const { CloudWatchLogsClient, DeleteMetricFilterCommand } = require("@aws-sdk/client-cloudwatch-logs"); // CommonJS import
15
- * const client = new CloudWatchLogsClient(config);
16
- * const command = new DeleteMetricFilterCommand(input);
17
- * const response = await client.send(command);
18
- * ```
19
- *
20
- * @see {@link DeleteMetricFilterCommandInput} for command's `input` shape.
21
- * @see {@link DeleteMetricFilterCommandOutput} for command's `response` shape.
22
- * @see {@link CloudWatchLogsClientResolvedConfig | config} for command's `input` shape.
23
- *
24
- */
25
8
  class DeleteMetricFilterCommand extends smithy_client_1.Command {
26
- // Start section: command_properties
27
- // End section: command_properties
28
9
  constructor(input) {
29
- // Start section: command_constructor
30
10
  super();
31
11
  this.input = input;
32
- // End section: command_constructor
33
12
  }
34
- /**
35
- * @internal
36
- */
37
13
  resolveMiddleware(clientStack, configuration, options) {
38
14
  this.middlewareStack.use(middleware_serde_1.getSerdePlugin(configuration, this.serialize, this.deserialize));
39
15
  const stack = clientStack.concat(this.middlewareStack);
@@ -5,39 +5,11 @@ const middleware_serde_1 = require("@aws-sdk/middleware-serde");
5
5
  const smithy_client_1 = require("@aws-sdk/smithy-client");
6
6
  const models_0_1 = require("../models/models_0");
7
7
  const Aws_json1_1_1 = require("../protocols/Aws_json1_1");
8
- /**
9
- * <p>Deletes a saved CloudWatch Logs Insights query definition.
10
- * A query definition contains details about a saved CloudWatch Logs Insights query.</p>
11
- * <p>Each <code>DeleteQueryDefinition</code> operation can delete one query definition.</p>
12
- * <p>You must have the <code>logs:DeleteQueryDefinition</code> permission to be able to perform
13
- * this operation.</p>
14
- * @example
15
- * Use a bare-bones client and the command you need to make an API call.
16
- * ```javascript
17
- * import { CloudWatchLogsClient, DeleteQueryDefinitionCommand } from "@aws-sdk/client-cloudwatch-logs"; // ES Modules import
18
- * // const { CloudWatchLogsClient, DeleteQueryDefinitionCommand } = require("@aws-sdk/client-cloudwatch-logs"); // CommonJS import
19
- * const client = new CloudWatchLogsClient(config);
20
- * const command = new DeleteQueryDefinitionCommand(input);
21
- * const response = await client.send(command);
22
- * ```
23
- *
24
- * @see {@link DeleteQueryDefinitionCommandInput} for command's `input` shape.
25
- * @see {@link DeleteQueryDefinitionCommandOutput} for command's `response` shape.
26
- * @see {@link CloudWatchLogsClientResolvedConfig | config} for command's `input` shape.
27
- *
28
- */
29
8
  class DeleteQueryDefinitionCommand extends smithy_client_1.Command {
30
- // Start section: command_properties
31
- // End section: command_properties
32
9
  constructor(input) {
33
- // Start section: command_constructor
34
10
  super();
35
11
  this.input = input;
36
- // End section: command_constructor
37
12
  }
38
- /**
39
- * @internal
40
- */
41
13
  resolveMiddleware(clientStack, configuration, options) {
42
14
  this.middlewareStack.use(middleware_serde_1.getSerdePlugin(configuration, this.serialize, this.deserialize));
43
15
  const stack = clientStack.concat(this.middlewareStack);
@@ -5,36 +5,11 @@ const middleware_serde_1 = require("@aws-sdk/middleware-serde");
5
5
  const smithy_client_1 = require("@aws-sdk/smithy-client");
6
6
  const models_0_1 = require("../models/models_0");
7
7
  const Aws_json1_1_1 = require("../protocols/Aws_json1_1");
8
- /**
9
- * <p>Deletes a resource policy from this account. This revokes
10
- * the access of the identities in that policy to put log events to this account.</p>
11
- * @example
12
- * Use a bare-bones client and the command you need to make an API call.
13
- * ```javascript
14
- * import { CloudWatchLogsClient, DeleteResourcePolicyCommand } from "@aws-sdk/client-cloudwatch-logs"; // ES Modules import
15
- * // const { CloudWatchLogsClient, DeleteResourcePolicyCommand } = require("@aws-sdk/client-cloudwatch-logs"); // CommonJS import
16
- * const client = new CloudWatchLogsClient(config);
17
- * const command = new DeleteResourcePolicyCommand(input);
18
- * const response = await client.send(command);
19
- * ```
20
- *
21
- * @see {@link DeleteResourcePolicyCommandInput} for command's `input` shape.
22
- * @see {@link DeleteResourcePolicyCommandOutput} for command's `response` shape.
23
- * @see {@link CloudWatchLogsClientResolvedConfig | config} for command's `input` shape.
24
- *
25
- */
26
8
  class DeleteResourcePolicyCommand extends smithy_client_1.Command {
27
- // Start section: command_properties
28
- // End section: command_properties
29
9
  constructor(input) {
30
- // Start section: command_constructor
31
10
  super();
32
11
  this.input = input;
33
- // End section: command_constructor
34
12
  }
35
- /**
36
- * @internal
37
- */
38
13
  resolveMiddleware(clientStack, configuration, options) {
39
14
  this.middlewareStack.use(middleware_serde_1.getSerdePlugin(configuration, this.serialize, this.deserialize));
40
15
  const stack = clientStack.concat(this.middlewareStack);