@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
@@ -5,45 +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>Returns the results from the specified query.</p>
10
- * <p>Only the fields requested in the query are returned, along with a <code>@ptr</code>
11
- * field, which is the identifier for the log record. You can use the value of <code>@ptr</code>
12
- * in a <a href="https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_GetLogRecord.html">GetLogRecord</a>
13
- * operation to get the full log record.</p>
14
- * <p>
15
- * <code>GetQueryResults</code>
16
- * does not start a query execution. To run a query, use <a href="https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_StartQuery.html">StartQuery</a>.</p>
17
- * <p>If the value of the <code>Status</code> field in the output is <code>Running</code>, this operation
18
- * returns only partial results. If you see a value of <code>Scheduled</code> or <code>Running</code> for the status,
19
- * you can retry the operation later to see the final results. </p>
20
- * @example
21
- * Use a bare-bones client and the command you need to make an API call.
22
- * ```javascript
23
- * import { CloudWatchLogsClient, GetQueryResultsCommand } from "@aws-sdk/client-cloudwatch-logs"; // ES Modules import
24
- * // const { CloudWatchLogsClient, GetQueryResultsCommand } = require("@aws-sdk/client-cloudwatch-logs"); // CommonJS import
25
- * const client = new CloudWatchLogsClient(config);
26
- * const command = new GetQueryResultsCommand(input);
27
- * const response = await client.send(command);
28
- * ```
29
- *
30
- * @see {@link GetQueryResultsCommandInput} for command's `input` shape.
31
- * @see {@link GetQueryResultsCommandOutput} for command's `response` shape.
32
- * @see {@link CloudWatchLogsClientResolvedConfig | config} for command's `input` shape.
33
- *
34
- */
35
8
  class GetQueryResultsCommand extends smithy_client_1.Command {
36
- // Start section: command_properties
37
- // End section: command_properties
38
9
  constructor(input) {
39
- // Start section: command_constructor
40
10
  super();
41
11
  this.input = input;
42
- // End section: command_constructor
43
12
  }
44
- /**
45
- * @internal
46
- */
47
13
  resolveMiddleware(clientStack, configuration, options) {
48
14
  this.middlewareStack.use(middleware_serde_1.getSerdePlugin(configuration, this.serialize, this.deserialize));
49
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>Lists the tags for the specified log group.</p>
10
- * @example
11
- * Use a bare-bones client and the command you need to make an API call.
12
- * ```javascript
13
- * import { CloudWatchLogsClient, ListTagsLogGroupCommand } from "@aws-sdk/client-cloudwatch-logs"; // ES Modules import
14
- * // const { CloudWatchLogsClient, ListTagsLogGroupCommand } = require("@aws-sdk/client-cloudwatch-logs"); // CommonJS import
15
- * const client = new CloudWatchLogsClient(config);
16
- * const command = new ListTagsLogGroupCommand(input);
17
- * const response = await client.send(command);
18
- * ```
19
- *
20
- * @see {@link ListTagsLogGroupCommandInput} for command's `input` shape.
21
- * @see {@link ListTagsLogGroupCommandOutput} for command's `response` shape.
22
- * @see {@link CloudWatchLogsClientResolvedConfig | config} for command's `input` shape.
23
- *
24
- */
25
8
  class ListTagsLogGroupCommand 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,44 +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 or updates a destination. This operation is used only to create destinations for cross-account subscriptions.</p>
10
- * <p>A destination encapsulates a physical resource (such
11
- * as an Amazon Kinesis stream) and enables you to subscribe to a real-time stream of log events
12
- * for a different account, ingested using <a href="https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutLogEvents.html">PutLogEvents</a>.</p>
13
- * <p>Through an access policy, a destination controls what is written to it.
14
- * By default, <code>PutDestination</code> does not set any access policy with the destination,
15
- * which means a cross-account user cannot call <a href="https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutSubscriptionFilter.html">PutSubscriptionFilter</a> against
16
- * this destination. To enable this, the destination owner must call <a href="https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDestinationPolicy.html">PutDestinationPolicy</a> after <code>PutDestination</code>.</p>
17
- * <p>To perform a <code>PutDestination</code> operation, you must also have the
18
- * <code>iam:PassRole</code> permission.</p>
19
- * @example
20
- * Use a bare-bones client and the command you need to make an API call.
21
- * ```javascript
22
- * import { CloudWatchLogsClient, PutDestinationCommand } from "@aws-sdk/client-cloudwatch-logs"; // ES Modules import
23
- * // const { CloudWatchLogsClient, PutDestinationCommand } = require("@aws-sdk/client-cloudwatch-logs"); // CommonJS import
24
- * const client = new CloudWatchLogsClient(config);
25
- * const command = new PutDestinationCommand(input);
26
- * const response = await client.send(command);
27
- * ```
28
- *
29
- * @see {@link PutDestinationCommandInput} for command's `input` shape.
30
- * @see {@link PutDestinationCommandOutput} for command's `response` shape.
31
- * @see {@link CloudWatchLogsClientResolvedConfig | config} for command's `input` shape.
32
- *
33
- */
34
8
  class PutDestinationCommand extends smithy_client_1.Command {
35
- // Start section: command_properties
36
- // End section: command_properties
37
9
  constructor(input) {
38
- // Start section: command_constructor
39
10
  super();
40
11
  this.input = input;
41
- // End section: command_constructor
42
12
  }
43
- /**
44
- * @internal
45
- */
46
13
  resolveMiddleware(clientStack, configuration, options) {
47
14
  this.middlewareStack.use(middleware_serde_1.getSerdePlugin(configuration, this.serialize, this.deserialize));
48
15
  const stack = clientStack.concat(this.middlewareStack);
@@ -5,40 +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 or updates an access policy associated with an existing
10
- * destination. An access policy is an <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/policies_overview.html">IAM policy document</a> that is used
11
- * to authorize claims to register a subscription filter against a given destination.</p>
12
- * <p>If multiple Amazon Web Services accounts are sending logs to this destination, each sender account must be
13
- * listed separately in the policy. The policy does not support specifying <code>*</code>
14
- * as the Principal or the use of the <code>aws:PrincipalOrgId</code> global key.</p>
15
- * @example
16
- * Use a bare-bones client and the command you need to make an API call.
17
- * ```javascript
18
- * import { CloudWatchLogsClient, PutDestinationPolicyCommand } from "@aws-sdk/client-cloudwatch-logs"; // ES Modules import
19
- * // const { CloudWatchLogsClient, PutDestinationPolicyCommand } = require("@aws-sdk/client-cloudwatch-logs"); // CommonJS import
20
- * const client = new CloudWatchLogsClient(config);
21
- * const command = new PutDestinationPolicyCommand(input);
22
- * const response = await client.send(command);
23
- * ```
24
- *
25
- * @see {@link PutDestinationPolicyCommandInput} for command's `input` shape.
26
- * @see {@link PutDestinationPolicyCommandOutput} for command's `response` shape.
27
- * @see {@link CloudWatchLogsClientResolvedConfig | config} for command's `input` shape.
28
- *
29
- */
30
8
  class PutDestinationPolicyCommand extends smithy_client_1.Command {
31
- // Start section: command_properties
32
- // End section: command_properties
33
9
  constructor(input) {
34
- // Start section: command_constructor
35
10
  super();
36
11
  this.input = input;
37
- // End section: command_constructor
38
12
  }
39
- /**
40
- * @internal
41
- */
42
13
  resolveMiddleware(clientStack, configuration, options) {
43
14
  this.middlewareStack.use(middleware_serde_1.getSerdePlugin(configuration, this.serialize, this.deserialize));
44
15
  const stack = clientStack.concat(this.middlewareStack);
@@ -5,72 +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>Uploads a batch of log events to the specified log stream.</p>
10
- * <p>You must include the sequence token obtained from the response of the previous call. An
11
- * upload in a newly created log stream does not require a sequence token. You can also get the
12
- * sequence token in the <code>expectedSequenceToken</code> field from
13
- * <code>InvalidSequenceTokenException</code>. If you call <code>PutLogEvents</code> twice
14
- * within a narrow time period using the same value for <code>sequenceToken</code>, both calls
15
- * might be successful or one might be rejected.</p>
16
- * <p>The batch of events must satisfy the following constraints:</p>
17
- * <ul>
18
- * <li>
19
- * <p>The maximum batch size is 1,048,576 bytes. This size is calculated as the sum of
20
- * all event messages in UTF-8, plus 26 bytes for each log event.</p>
21
- * </li>
22
- * <li>
23
- * <p>None of the log events in the batch can be more than 2 hours in the future.</p>
24
- * </li>
25
- * <li>
26
- * <p>None of the log events in the batch can be older than 14 days or older than the retention
27
- * period of the log group.</p>
28
- * </li>
29
- * <li>
30
- * <p>The log events in the batch must be in chronological order by their timestamp. The
31
- * timestamp is the time the event occurred, expressed as the number of milliseconds after
32
- * Jan 1, 1970 00:00:00 UTC. (In Amazon Web Services Tools for PowerShell and the Amazon Web Services SDK for .NET, the
33
- * timestamp is specified in .NET format: yyyy-mm-ddThh:mm:ss. For example,
34
- * 2017-09-15T13:45:30.) </p>
35
- * </li>
36
- * <li>
37
- * <p>A batch of log events in a single request cannot span more than 24 hours. Otherwise, the operation fails.</p>
38
- * </li>
39
- * <li>
40
- * <p>The maximum number of log events in a batch is 10,000.</p>
41
- * </li>
42
- * <li>
43
- * <p>There is a quota of 5 requests per second per log stream. Additional requests are throttled. This quota can't be changed.</p>
44
- * </li>
45
- * </ul>
46
- * <p>If a call to <code>PutLogEvents</code> returns "UnrecognizedClientException" the most likely cause is an invalid Amazon Web Services access key ID or secret key. </p>
47
- * @example
48
- * Use a bare-bones client and the command you need to make an API call.
49
- * ```javascript
50
- * import { CloudWatchLogsClient, PutLogEventsCommand } from "@aws-sdk/client-cloudwatch-logs"; // ES Modules import
51
- * // const { CloudWatchLogsClient, PutLogEventsCommand } = require("@aws-sdk/client-cloudwatch-logs"); // CommonJS import
52
- * const client = new CloudWatchLogsClient(config);
53
- * const command = new PutLogEventsCommand(input);
54
- * const response = await client.send(command);
55
- * ```
56
- *
57
- * @see {@link PutLogEventsCommandInput} for command's `input` shape.
58
- * @see {@link PutLogEventsCommandOutput} for command's `response` shape.
59
- * @see {@link CloudWatchLogsClientResolvedConfig | config} for command's `input` shape.
60
- *
61
- */
62
8
  class PutLogEventsCommand extends smithy_client_1.Command {
63
- // Start section: command_properties
64
- // End section: command_properties
65
9
  constructor(input) {
66
- // Start section: command_constructor
67
10
  super();
68
11
  this.input = input;
69
- // End section: command_constructor
70
12
  }
71
- /**
72
- * @internal
73
- */
74
13
  resolveMiddleware(clientStack, configuration, options) {
75
14
  this.middlewareStack.use(middleware_serde_1.getSerdePlugin(configuration, this.serialize, this.deserialize));
76
15
  const stack = clientStack.concat(this.middlewareStack);
@@ -5,57 +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 or updates a metric filter and associates it with the specified log group.
10
- * Metric filters allow you to configure rules to extract metric data from log events ingested
11
- * through <a href="https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutLogEvents.html">PutLogEvents</a>.</p>
12
- * <p>The maximum number of metric filters that can be associated with a log group is
13
- * 100.</p>
14
- * <p>When you create a metric filter, you can also optionally assign a unit and dimensions
15
- * to the metric that is created.</p>
16
- * <important>
17
- * <p>Metrics extracted from log events are charged as custom metrics.
18
- * To prevent unexpected high charges, do not specify high-cardinality fields such as
19
- * <code>IPAddress</code> or <code>requestID</code> as dimensions. Each different value
20
- * found for
21
- * a dimension is treated as a separate metric and accrues charges as a separate custom metric.
22
- * </p>
23
- * <p>To help prevent accidental high charges, Amazon disables a metric filter
24
- * if it generates 1000 different name/value pairs for the dimensions that you
25
- * have specified within a certain amount of time.</p>
26
- * <p>You can also set up a billing alarm to alert you if your charges are higher than
27
- * expected. For more information,
28
- * see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/monitor_estimated_charges_with_cloudwatch.html">
29
- * Creating a Billing Alarm to Monitor Your Estimated Amazon Web Services Charges</a>.
30
- * </p>
31
- * </important>
32
- * @example
33
- * Use a bare-bones client and the command you need to make an API call.
34
- * ```javascript
35
- * import { CloudWatchLogsClient, PutMetricFilterCommand } from "@aws-sdk/client-cloudwatch-logs"; // ES Modules import
36
- * // const { CloudWatchLogsClient, PutMetricFilterCommand } = require("@aws-sdk/client-cloudwatch-logs"); // CommonJS import
37
- * const client = new CloudWatchLogsClient(config);
38
- * const command = new PutMetricFilterCommand(input);
39
- * const response = await client.send(command);
40
- * ```
41
- *
42
- * @see {@link PutMetricFilterCommandInput} for command's `input` shape.
43
- * @see {@link PutMetricFilterCommandOutput} for command's `response` shape.
44
- * @see {@link CloudWatchLogsClientResolvedConfig | config} for command's `input` shape.
45
- *
46
- */
47
8
  class PutMetricFilterCommand extends smithy_client_1.Command {
48
- // Start section: command_properties
49
- // End section: command_properties
50
9
  constructor(input) {
51
- // Start section: command_constructor
52
10
  super();
53
11
  this.input = input;
54
- // End section: command_constructor
55
12
  }
56
- /**
57
- * @internal
58
- */
59
13
  resolveMiddleware(clientStack, configuration, options) {
60
14
  this.middlewareStack.use(middleware_serde_1.getSerdePlugin(configuration, this.serialize, this.deserialize));
61
15
  const stack = clientStack.concat(this.middlewareStack);
@@ -5,46 +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 or updates a query definition for CloudWatch Logs Insights. For
10
- * more information, see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AnalyzingLogData.html">Analyzing Log Data with CloudWatch Logs Insights</a>.</p>
11
- *
12
- * <p>To update a query definition, specify its
13
- * <code>queryDefinitionId</code> in your request. The values of <code>name</code>, <code>queryString</code>,
14
- * and <code>logGroupNames</code> are changed to the values that you specify in your update
15
- * operation. No current values are retained from the current query definition. For example, if
16
- * you update a current query definition that includes log groups, and you don't specify the
17
- * <code>logGroupNames</code> parameter in your update operation, the query definition changes
18
- * to contain no log groups.</p>
19
- * <p>You must have the <code>logs:PutQueryDefinition</code> permission to be able to perform
20
- * this operation.</p>
21
- * @example
22
- * Use a bare-bones client and the command you need to make an API call.
23
- * ```javascript
24
- * import { CloudWatchLogsClient, PutQueryDefinitionCommand } from "@aws-sdk/client-cloudwatch-logs"; // ES Modules import
25
- * // const { CloudWatchLogsClient, PutQueryDefinitionCommand } = require("@aws-sdk/client-cloudwatch-logs"); // CommonJS import
26
- * const client = new CloudWatchLogsClient(config);
27
- * const command = new PutQueryDefinitionCommand(input);
28
- * const response = await client.send(command);
29
- * ```
30
- *
31
- * @see {@link PutQueryDefinitionCommandInput} for command's `input` shape.
32
- * @see {@link PutQueryDefinitionCommandOutput} for command's `response` shape.
33
- * @see {@link CloudWatchLogsClientResolvedConfig | config} for command's `input` shape.
34
- *
35
- */
36
8
  class PutQueryDefinitionCommand extends smithy_client_1.Command {
37
- // Start section: command_properties
38
- // End section: command_properties
39
9
  constructor(input) {
40
- // Start section: command_constructor
41
10
  super();
42
11
  this.input = input;
43
- // End section: command_constructor
44
12
  }
45
- /**
46
- * @internal
47
- */
48
13
  resolveMiddleware(clientStack, configuration, options) {
49
14
  this.middlewareStack.use(middleware_serde_1.getSerdePlugin(configuration, this.serialize, this.deserialize));
50
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>Creates or updates a resource policy allowing other Amazon Web Services services to put log events to
10
- * this account, such as Amazon Route 53. An account can have up to 10 resource policies per Amazon Web Services
11
- * Region.</p>
12
- * @example
13
- * Use a bare-bones client and the command you need to make an API call.
14
- * ```javascript
15
- * import { CloudWatchLogsClient, PutResourcePolicyCommand } from "@aws-sdk/client-cloudwatch-logs"; // ES Modules import
16
- * // const { CloudWatchLogsClient, PutResourcePolicyCommand } = require("@aws-sdk/client-cloudwatch-logs"); // CommonJS import
17
- * const client = new CloudWatchLogsClient(config);
18
- * const command = new PutResourcePolicyCommand(input);
19
- * const response = await client.send(command);
20
- * ```
21
- *
22
- * @see {@link PutResourcePolicyCommandInput} for command's `input` shape.
23
- * @see {@link PutResourcePolicyCommandOutput} for command's `response` shape.
24
- * @see {@link CloudWatchLogsClientResolvedConfig | config} for command's `input` shape.
25
- *
26
- */
27
8
  class PutResourcePolicyCommand 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,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>Sets the retention of the specified log group. A retention policy allows you to
10
- * configure the number of days for which to retain log events in the specified log
11
- * group.</p>
12
- * @example
13
- * Use a bare-bones client and the command you need to make an API call.
14
- * ```javascript
15
- * import { CloudWatchLogsClient, PutRetentionPolicyCommand } from "@aws-sdk/client-cloudwatch-logs"; // ES Modules import
16
- * // const { CloudWatchLogsClient, PutRetentionPolicyCommand } = require("@aws-sdk/client-cloudwatch-logs"); // CommonJS import
17
- * const client = new CloudWatchLogsClient(config);
18
- * const command = new PutRetentionPolicyCommand(input);
19
- * const response = await client.send(command);
20
- * ```
21
- *
22
- * @see {@link PutRetentionPolicyCommandInput} for command's `input` shape.
23
- * @see {@link PutRetentionPolicyCommandOutput} for command's `response` shape.
24
- * @see {@link CloudWatchLogsClientResolvedConfig | config} for command's `input` shape.
25
- *
26
- */
27
8
  class PutRetentionPolicyCommand 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,63 +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 or updates a subscription filter and associates it with the specified log
10
- * group. Subscription filters allow you to subscribe to a real-time stream of log events
11
- * ingested through <a href="https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutLogEvents.html">PutLogEvents</a> and have them delivered to a specific
12
- * destination. When log events are sent to the
13
- * receiving service, they are Base64 encoded
14
- * and compressed with the gzip format.</p>
15
- * <p>The following destinations are supported for subscription filters:</p>
16
- * <ul>
17
- * <li>
18
- * <p>An Amazon Kinesis stream belonging to the same account as the subscription filter,
19
- * for same-account delivery.</p>
20
- * </li>
21
- * <li>
22
- * <p>A logical destination that belongs to a different account, for cross-account delivery.</p>
23
- * </li>
24
- * <li>
25
- * <p>An Amazon Kinesis Firehose delivery stream that belongs to the same account as the
26
- * subscription filter, for same-account delivery.</p>
27
- * </li>
28
- * <li>
29
- * <p>An Lambda function that belongs to the same account as the subscription filter,
30
- * for same-account delivery.</p>
31
- * </li>
32
- * </ul>
33
- * <p>Each log group can have up to two subscription filters associated with it. If you are
34
- * updating an existing filter, you must specify the correct name in <code>filterName</code>.
35
- * </p>
36
- * <p>To perform a <code>PutSubscriptionFilter</code> operation, you must also have the
37
- * <code>iam:PassRole</code> permission.</p>
38
- * @example
39
- * Use a bare-bones client and the command you need to make an API call.
40
- * ```javascript
41
- * import { CloudWatchLogsClient, PutSubscriptionFilterCommand } from "@aws-sdk/client-cloudwatch-logs"; // ES Modules import
42
- * // const { CloudWatchLogsClient, PutSubscriptionFilterCommand } = require("@aws-sdk/client-cloudwatch-logs"); // CommonJS import
43
- * const client = new CloudWatchLogsClient(config);
44
- * const command = new PutSubscriptionFilterCommand(input);
45
- * const response = await client.send(command);
46
- * ```
47
- *
48
- * @see {@link PutSubscriptionFilterCommandInput} for command's `input` shape.
49
- * @see {@link PutSubscriptionFilterCommandOutput} for command's `response` shape.
50
- * @see {@link CloudWatchLogsClientResolvedConfig | config} for command's `input` shape.
51
- *
52
- */
53
8
  class PutSubscriptionFilterCommand extends smithy_client_1.Command {
54
- // Start section: command_properties
55
- // End section: command_properties
56
9
  constructor(input) {
57
- // Start section: command_constructor
58
10
  super();
59
11
  this.input = input;
60
- // End section: command_constructor
61
12
  }
62
- /**
63
- * @internal
64
- */
65
13
  resolveMiddleware(clientStack, configuration, options) {
66
14
  this.middlewareStack.use(middleware_serde_1.getSerdePlugin(configuration, this.serialize, this.deserialize));
67
15
  const stack = clientStack.concat(this.middlewareStack);
@@ -5,40 +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>Schedules a query of a log group using CloudWatch Logs Insights. You specify the log group
10
- * and time range to query and the query string to use.</p>
11
- * <p>For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CWL_QuerySyntax.html">CloudWatch Logs Insights Query Syntax</a>.</p>
12
- *
13
- * <p>Queries time out after 15 minutes of execution. If your queries are timing out, reduce the
14
- * time range being searched or partition your query into a number of queries.</p>
15
- * @example
16
- * Use a bare-bones client and the command you need to make an API call.
17
- * ```javascript
18
- * import { CloudWatchLogsClient, StartQueryCommand } from "@aws-sdk/client-cloudwatch-logs"; // ES Modules import
19
- * // const { CloudWatchLogsClient, StartQueryCommand } = require("@aws-sdk/client-cloudwatch-logs"); // CommonJS import
20
- * const client = new CloudWatchLogsClient(config);
21
- * const command = new StartQueryCommand(input);
22
- * const response = await client.send(command);
23
- * ```
24
- *
25
- * @see {@link StartQueryCommandInput} for command's `input` shape.
26
- * @see {@link StartQueryCommandOutput} for command's `response` shape.
27
- * @see {@link CloudWatchLogsClientResolvedConfig | config} for command's `input` shape.
28
- *
29
- */
30
8
  class StartQueryCommand extends smithy_client_1.Command {
31
- // Start section: command_properties
32
- // End section: command_properties
33
9
  constructor(input) {
34
- // Start section: command_constructor
35
10
  super();
36
11
  this.input = input;
37
- // End section: command_constructor
38
12
  }
39
- /**
40
- * @internal
41
- */
42
13
  resolveMiddleware(clientStack, configuration, options) {
43
14
  this.middlewareStack.use(middleware_serde_1.getSerdePlugin(configuration, this.serialize, this.deserialize));
44
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>Stops a CloudWatch Logs Insights query that is in progress. If the query has already ended, the operation
10
- * returns an error indicating that the specified query is not running.</p>
11
- * @example
12
- * Use a bare-bones client and the command you need to make an API call.
13
- * ```javascript
14
- * import { CloudWatchLogsClient, StopQueryCommand } from "@aws-sdk/client-cloudwatch-logs"; // ES Modules import
15
- * // const { CloudWatchLogsClient, StopQueryCommand } = require("@aws-sdk/client-cloudwatch-logs"); // CommonJS import
16
- * const client = new CloudWatchLogsClient(config);
17
- * const command = new StopQueryCommand(input);
18
- * const response = await client.send(command);
19
- * ```
20
- *
21
- * @see {@link StopQueryCommandInput} for command's `input` shape.
22
- * @see {@link StopQueryCommandOutput} for command's `response` shape.
23
- * @see {@link CloudWatchLogsClientResolvedConfig | config} for command's `input` shape.
24
- *
25
- */
26
8
  class StopQueryCommand 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,44 +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>Adds or updates the specified tags for the specified log group.</p>
10
- * <p>To list the tags for a log group, use <a href="https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_ListTagsLogGroup.html">ListTagsLogGroup</a>.
11
- * To remove tags, use <a href="https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_UntagLogGroup.html">UntagLogGroup</a>.</p>
12
- * <p>For more information about tags, see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html#log-group-tagging">Tag Log Groups in Amazon CloudWatch Logs</a>
13
- * in the <i>Amazon CloudWatch Logs User Guide</i>.</p>
14
- * <p>CloudWatch Logs doesn’t support IAM policies that prevent users from assigning specified tags to
15
- * log groups using the <code>aws:Resource/<i>key-name</i>
16
- * </code> or <code>aws:TagKeys</code> condition keys.
17
- * For more information about using tags to control access, see
18
- * <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html">Controlling access to Amazon Web Services resources using tags</a>.</p>
19
- * @example
20
- * Use a bare-bones client and the command you need to make an API call.
21
- * ```javascript
22
- * import { CloudWatchLogsClient, TagLogGroupCommand } from "@aws-sdk/client-cloudwatch-logs"; // ES Modules import
23
- * // const { CloudWatchLogsClient, TagLogGroupCommand } = require("@aws-sdk/client-cloudwatch-logs"); // CommonJS import
24
- * const client = new CloudWatchLogsClient(config);
25
- * const command = new TagLogGroupCommand(input);
26
- * const response = await client.send(command);
27
- * ```
28
- *
29
- * @see {@link TagLogGroupCommandInput} for command's `input` shape.
30
- * @see {@link TagLogGroupCommandOutput} for command's `response` shape.
31
- * @see {@link CloudWatchLogsClientResolvedConfig | config} for command's `input` shape.
32
- *
33
- */
34
8
  class TagLogGroupCommand extends smithy_client_1.Command {
35
- // Start section: command_properties
36
- // End section: command_properties
37
9
  constructor(input) {
38
- // Start section: command_constructor
39
10
  super();
40
11
  this.input = input;
41
- // End section: command_constructor
42
12
  }
43
- /**
44
- * @internal
45
- */
46
13
  resolveMiddleware(clientStack, configuration, options) {
47
14
  this.middlewareStack.use(middleware_serde_1.getSerdePlugin(configuration, this.serialize, this.deserialize));
48
15
  const stack = clientStack.concat(this.middlewareStack);