@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
@@ -42,563 +42,173 @@ import { StopQueryCommandInput, StopQueryCommandOutput } from "./commands/StopQu
42
42
  import { TagLogGroupCommandInput, TagLogGroupCommandOutput } from "./commands/TagLogGroupCommand";
43
43
  import { TestMetricFilterCommandInput, TestMetricFilterCommandOutput } from "./commands/TestMetricFilterCommand";
44
44
  import { UntagLogGroupCommandInput, UntagLogGroupCommandOutput } from "./commands/UntagLogGroupCommand";
45
- /**
46
- * <p>You can use Amazon CloudWatch Logs to monitor, store, and access your log files from
47
- * EC2 instances, CloudTrail, and other sources. You can then retrieve the associated
48
- * log data from CloudWatch Logs using the CloudWatch console, CloudWatch Logs commands in the
49
- * Amazon Web Services CLI, CloudWatch Logs API, or CloudWatch Logs SDK.</p>
50
- * <p>You can use CloudWatch Logs to:</p>
51
- * <ul>
52
- * <li>
53
- * <p>
54
- * <b>Monitor logs from EC2 instances in real-time</b>: You
55
- * can use CloudWatch Logs to monitor applications and systems using log data. For example,
56
- * CloudWatch Logs can track the number of errors that occur in your application logs and
57
- * send you a notification whenever the rate of errors exceeds a threshold that you specify.
58
- * CloudWatch Logs uses your log data for monitoring so no code changes are required. For
59
- * example, you can monitor application logs for specific literal terms (such as
60
- * "NullReferenceException") or count the number of occurrences of a literal term at a
61
- * particular position in log data (such as "404" status codes in an Apache access log). When
62
- * the term you are searching for is found, CloudWatch Logs reports the data to a CloudWatch
63
- * metric that you specify.</p>
64
- * </li>
65
- * <li>
66
- * <p>
67
- * <b>Monitor CloudTrail logged events</b>: You can
68
- * create alarms in CloudWatch and receive notifications of particular API activity as
69
- * captured by CloudTrail. You can use the notification to perform troubleshooting.</p>
70
- * </li>
71
- * <li>
72
- * <p>
73
- * <b>Archive log data</b>: You can use CloudWatch Logs to
74
- * store your log data in highly durable storage. You can change the log retention setting so
75
- * that any log events older than this setting are automatically deleted. The CloudWatch Logs
76
- * agent makes it easy to quickly send both rotated and non-rotated log data off of a host
77
- * and into the log service. You can then access the raw log data when you need it.</p>
78
- * </li>
79
- * </ul>
80
- */
45
+
81
46
  export declare class CloudWatchLogs extends CloudWatchLogsClient {
82
- /**
83
- * <p>Associates the specified Key Management Service customer master key (CMK) with the specified log group.</p>
84
- * <p>Associating an KMS CMK with a log group overrides any existing associations between the log group and a CMK.
85
- * After a CMK is associated with a log group, all newly ingested data for the log group is encrypted using the CMK.
86
- * This association is stored as long as the data encrypted with the CMK is still within CloudWatch Logs.
87
- * This enables CloudWatch Logs to decrypt this data whenever it is requested.</p>
88
- * <important>
89
- * <p>CloudWatch Logs supports only symmetric CMKs. Do not use an associate an asymmetric CMK
90
- * 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
91
- * Keys</a>.</p>
92
- * </important>
93
- * <p>It can take up to 5 minutes for this operation to take effect.</p>
94
- * <p>If you attempt to associate a CMK with a log group but the CMK does not exist or the
95
- * CMK is disabled, you receive an <code>InvalidParameterException</code> error. </p>
96
- */
47
+
97
48
  associateKmsKey(args: AssociateKmsKeyCommandInput, options?: __HttpHandlerOptions): Promise<AssociateKmsKeyCommandOutput>;
98
49
  associateKmsKey(args: AssociateKmsKeyCommandInput, cb: (err: any, data?: AssociateKmsKeyCommandOutput) => void): void;
99
50
  associateKmsKey(args: AssociateKmsKeyCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: AssociateKmsKeyCommandOutput) => void): void;
100
- /**
101
- * <p>Cancels the specified export task.</p>
102
- * <p>The task must be in the <code>PENDING</code> or <code>RUNNING</code> state.</p>
103
- */
51
+
104
52
  cancelExportTask(args: CancelExportTaskCommandInput, options?: __HttpHandlerOptions): Promise<CancelExportTaskCommandOutput>;
105
53
  cancelExportTask(args: CancelExportTaskCommandInput, cb: (err: any, data?: CancelExportTaskCommandOutput) => void): void;
106
54
  cancelExportTask(args: CancelExportTaskCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: CancelExportTaskCommandOutput) => void): void;
107
- /**
108
- * <p>Creates an export task, which allows you to efficiently export data from a
109
- * log group to an Amazon S3 bucket. When you perform a <code>CreateExportTask</code>
110
- * operation, you must use credentials that have permission to write to the S3 bucket
111
- * that you specify as the destination.</p>
112
- * <p>This is an asynchronous call. If all the required information is provided, this
113
- * operation initiates an export task and responds with the ID of the task. After the task has started,
114
- * 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
115
- * only have one active (<code>RUNNING</code> or <code>PENDING</code>) export task at a time.
116
- * To cancel an export task, use <a href="https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_CancelExportTask.html">CancelExportTask</a>.</p>
117
- * <p>You can export logs from multiple log groups or multiple time ranges to the same S3
118
- * bucket. To separate out log data for each export task, you can specify a prefix to be used as
119
- * the Amazon S3 key prefix for all exported objects.</p>
120
- * <p>Exporting to S3 buckets that are encrypted with AES-256 is supported. Exporting to S3 buckets
121
- * encrypted with SSE-KMS is not supported. </p>
122
- */
55
+
123
56
  createExportTask(args: CreateExportTaskCommandInput, options?: __HttpHandlerOptions): Promise<CreateExportTaskCommandOutput>;
124
57
  createExportTask(args: CreateExportTaskCommandInput, cb: (err: any, data?: CreateExportTaskCommandOutput) => void): void;
125
58
  createExportTask(args: CreateExportTaskCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: CreateExportTaskCommandOutput) => void): void;
126
- /**
127
- * <p>Creates a log group with the specified name. You can create up to 20,000 log groups per account.</p>
128
- * <p>You must use the following guidelines when naming a log group:</p>
129
- * <ul>
130
- * <li>
131
- * <p>Log group names must be unique within a region for an Amazon Web Services account.</p>
132
- * </li>
133
- * <li>
134
- * <p>Log group names can be between 1 and 512 characters long.</p>
135
- * </li>
136
- * <li>
137
- * <p>Log group names consist of the following characters: a-z, A-Z, 0-9, '_' (underscore), '-' (hyphen),
138
- * '/' (forward slash), '.' (period), and '#' (number sign)</p>
139
- * </li>
140
- * </ul>
141
- * <p>When you create a log group, by default the log events in the log group never expire. To set
142
- * a retention policy so that events expire and are deleted after a specified time, use
143
- * <a href="https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutRetentionPolicy.html">PutRetentionPolicy</a>.</p>
144
- * <p>If you associate a Key Management Service customer master key (CMK) with the log group, ingested data is encrypted using the CMK.
145
- * This association is stored as long as the data encrypted with the CMK is still within CloudWatch Logs.
146
- * This enables CloudWatch Logs to decrypt this data whenever it is requested.</p>
147
- * <p>If you attempt to associate a CMK with the log group but the CMK does not exist or the
148
- * CMK is disabled, you receive an <code>InvalidParameterException</code> error. </p>
149
- * <important>
150
- * <p>CloudWatch Logs supports only symmetric CMKs. Do not associate an asymmetric CMK with
151
- * your log group. For more information, see <a href="https://docs.aws.amazon.com/kms/latest/developerguide/symmetric-asymmetric.html">Using Symmetric and Asymmetric
152
- * Keys</a>.</p>
153
- * </important>
154
- */
59
+
155
60
  createLogGroup(args: CreateLogGroupCommandInput, options?: __HttpHandlerOptions): Promise<CreateLogGroupCommandOutput>;
156
61
  createLogGroup(args: CreateLogGroupCommandInput, cb: (err: any, data?: CreateLogGroupCommandOutput) => void): void;
157
62
  createLogGroup(args: CreateLogGroupCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: CreateLogGroupCommandOutput) => void): void;
158
- /**
159
- * <p>Creates a log stream for the specified log group. A log stream is a sequence of log events
160
- * that originate from a single source, such as an application instance or a resource that is
161
- * being monitored.</p>
162
- * <p>There is no limit on the number of log streams that you can create for a log group. There is a limit
163
- * of 50 TPS on <code>CreateLogStream</code> operations, after which transactions are throttled.</p>
164
- * <p>You must use the following guidelines when naming a log stream:</p>
165
- * <ul>
166
- * <li>
167
- * <p>Log stream names must be unique within the log group.</p>
168
- * </li>
169
- * <li>
170
- * <p>Log stream names can be between 1 and 512 characters long.</p>
171
- * </li>
172
- * <li>
173
- * <p>The ':' (colon) and '*' (asterisk) characters are not allowed.</p>
174
- * </li>
175
- * </ul>
176
- */
63
+
177
64
  createLogStream(args: CreateLogStreamCommandInput, options?: __HttpHandlerOptions): Promise<CreateLogStreamCommandOutput>;
178
65
  createLogStream(args: CreateLogStreamCommandInput, cb: (err: any, data?: CreateLogStreamCommandOutput) => void): void;
179
66
  createLogStream(args: CreateLogStreamCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: CreateLogStreamCommandOutput) => void): void;
180
- /**
181
- * <p>Deletes the specified destination, and eventually disables all the
182
- * subscription filters that publish to it. This operation does not delete the
183
- * physical resource encapsulated by the destination.</p>
184
- */
67
+
185
68
  deleteDestination(args: DeleteDestinationCommandInput, options?: __HttpHandlerOptions): Promise<DeleteDestinationCommandOutput>;
186
69
  deleteDestination(args: DeleteDestinationCommandInput, cb: (err: any, data?: DeleteDestinationCommandOutput) => void): void;
187
70
  deleteDestination(args: DeleteDestinationCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: DeleteDestinationCommandOutput) => void): void;
188
- /**
189
- * <p>Deletes the specified log group and permanently deletes all the archived
190
- * log events associated with the log group.</p>
191
- */
71
+
192
72
  deleteLogGroup(args: DeleteLogGroupCommandInput, options?: __HttpHandlerOptions): Promise<DeleteLogGroupCommandOutput>;
193
73
  deleteLogGroup(args: DeleteLogGroupCommandInput, cb: (err: any, data?: DeleteLogGroupCommandOutput) => void): void;
194
74
  deleteLogGroup(args: DeleteLogGroupCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: DeleteLogGroupCommandOutput) => void): void;
195
- /**
196
- * <p>Deletes the specified log stream and permanently deletes all the archived log events associated
197
- * with the log stream.</p>
198
- */
75
+
199
76
  deleteLogStream(args: DeleteLogStreamCommandInput, options?: __HttpHandlerOptions): Promise<DeleteLogStreamCommandOutput>;
200
77
  deleteLogStream(args: DeleteLogStreamCommandInput, cb: (err: any, data?: DeleteLogStreamCommandOutput) => void): void;
201
78
  deleteLogStream(args: DeleteLogStreamCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: DeleteLogStreamCommandOutput) => void): void;
202
- /**
203
- * <p>Deletes the specified metric filter.</p>
204
- */
79
+
205
80
  deleteMetricFilter(args: DeleteMetricFilterCommandInput, options?: __HttpHandlerOptions): Promise<DeleteMetricFilterCommandOutput>;
206
81
  deleteMetricFilter(args: DeleteMetricFilterCommandInput, cb: (err: any, data?: DeleteMetricFilterCommandOutput) => void): void;
207
82
  deleteMetricFilter(args: DeleteMetricFilterCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: DeleteMetricFilterCommandOutput) => void): void;
208
- /**
209
- * <p>Deletes a saved CloudWatch Logs Insights query definition.
210
- * A query definition contains details about a saved CloudWatch Logs Insights query.</p>
211
- * <p>Each <code>DeleteQueryDefinition</code> operation can delete one query definition.</p>
212
- * <p>You must have the <code>logs:DeleteQueryDefinition</code> permission to be able to perform
213
- * this operation.</p>
214
- */
83
+
215
84
  deleteQueryDefinition(args: DeleteQueryDefinitionCommandInput, options?: __HttpHandlerOptions): Promise<DeleteQueryDefinitionCommandOutput>;
216
85
  deleteQueryDefinition(args: DeleteQueryDefinitionCommandInput, cb: (err: any, data?: DeleteQueryDefinitionCommandOutput) => void): void;
217
86
  deleteQueryDefinition(args: DeleteQueryDefinitionCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: DeleteQueryDefinitionCommandOutput) => void): void;
218
- /**
219
- * <p>Deletes a resource policy from this account. This revokes
220
- * the access of the identities in that policy to put log events to this account.</p>
221
- */
87
+
222
88
  deleteResourcePolicy(args: DeleteResourcePolicyCommandInput, options?: __HttpHandlerOptions): Promise<DeleteResourcePolicyCommandOutput>;
223
89
  deleteResourcePolicy(args: DeleteResourcePolicyCommandInput, cb: (err: any, data?: DeleteResourcePolicyCommandOutput) => void): void;
224
90
  deleteResourcePolicy(args: DeleteResourcePolicyCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: DeleteResourcePolicyCommandOutput) => void): void;
225
- /**
226
- * <p>Deletes the specified retention policy.</p>
227
- * <p>Log events do not expire if they belong to log groups without a retention policy.</p>
228
- */
91
+
229
92
  deleteRetentionPolicy(args: DeleteRetentionPolicyCommandInput, options?: __HttpHandlerOptions): Promise<DeleteRetentionPolicyCommandOutput>;
230
93
  deleteRetentionPolicy(args: DeleteRetentionPolicyCommandInput, cb: (err: any, data?: DeleteRetentionPolicyCommandOutput) => void): void;
231
94
  deleteRetentionPolicy(args: DeleteRetentionPolicyCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: DeleteRetentionPolicyCommandOutput) => void): void;
232
- /**
233
- * <p>Deletes the specified subscription filter.</p>
234
- */
95
+
235
96
  deleteSubscriptionFilter(args: DeleteSubscriptionFilterCommandInput, options?: __HttpHandlerOptions): Promise<DeleteSubscriptionFilterCommandOutput>;
236
97
  deleteSubscriptionFilter(args: DeleteSubscriptionFilterCommandInput, cb: (err: any, data?: DeleteSubscriptionFilterCommandOutput) => void): void;
237
98
  deleteSubscriptionFilter(args: DeleteSubscriptionFilterCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: DeleteSubscriptionFilterCommandOutput) => void): void;
238
- /**
239
- * <p>Lists all your destinations. The results are ASCII-sorted by destination name.</p>
240
- */
99
+
241
100
  describeDestinations(args: DescribeDestinationsCommandInput, options?: __HttpHandlerOptions): Promise<DescribeDestinationsCommandOutput>;
242
101
  describeDestinations(args: DescribeDestinationsCommandInput, cb: (err: any, data?: DescribeDestinationsCommandOutput) => void): void;
243
102
  describeDestinations(args: DescribeDestinationsCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: DescribeDestinationsCommandOutput) => void): void;
244
- /**
245
- * <p>Lists the specified export tasks. You can list all your export tasks or filter
246
- * the results based on task ID or task status.</p>
247
- */
103
+
248
104
  describeExportTasks(args: DescribeExportTasksCommandInput, options?: __HttpHandlerOptions): Promise<DescribeExportTasksCommandOutput>;
249
105
  describeExportTasks(args: DescribeExportTasksCommandInput, cb: (err: any, data?: DescribeExportTasksCommandOutput) => void): void;
250
106
  describeExportTasks(args: DescribeExportTasksCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: DescribeExportTasksCommandOutput) => void): void;
251
- /**
252
- * <p>Lists the specified log groups. You can list all your log groups or filter the results by prefix.
253
- * The results are ASCII-sorted by log group name.</p>
254
- * <p>CloudWatch Logs doesn’t support IAM policies that control access to the <code>DescribeLogGroups</code> action by using the
255
- * <code>aws:ResourceTag/<i>key-name</i>
256
- * </code> condition key. Other CloudWatch Logs actions
257
- * do support the use of the <code>aws:ResourceTag/<i>key-name</i>
258
- * </code> condition key to control access.
259
- * For more information about using tags to control access, see
260
- * <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html">Controlling access to Amazon Web Services resources using tags</a>.</p>
261
- */
107
+
262
108
  describeLogGroups(args: DescribeLogGroupsCommandInput, options?: __HttpHandlerOptions): Promise<DescribeLogGroupsCommandOutput>;
263
109
  describeLogGroups(args: DescribeLogGroupsCommandInput, cb: (err: any, data?: DescribeLogGroupsCommandOutput) => void): void;
264
110
  describeLogGroups(args: DescribeLogGroupsCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: DescribeLogGroupsCommandOutput) => void): void;
265
- /**
266
- * <p>Lists the log streams for the specified log group.
267
- * You can list all the log streams or filter the results by prefix.
268
- * You can also control how the results are ordered.</p>
269
- * <p>This operation has a limit of five transactions per second, after which transactions are throttled.</p>
270
- */
111
+
271
112
  describeLogStreams(args: DescribeLogStreamsCommandInput, options?: __HttpHandlerOptions): Promise<DescribeLogStreamsCommandOutput>;
272
113
  describeLogStreams(args: DescribeLogStreamsCommandInput, cb: (err: any, data?: DescribeLogStreamsCommandOutput) => void): void;
273
114
  describeLogStreams(args: DescribeLogStreamsCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: DescribeLogStreamsCommandOutput) => void): void;
274
- /**
275
- * <p>Lists the specified metric filters. You can list all of the metric filters or filter
276
- * the results by log name, prefix, metric name, or metric namespace. The results are
277
- * ASCII-sorted by filter name.</p>
278
- */
115
+
279
116
  describeMetricFilters(args: DescribeMetricFiltersCommandInput, options?: __HttpHandlerOptions): Promise<DescribeMetricFiltersCommandOutput>;
280
117
  describeMetricFilters(args: DescribeMetricFiltersCommandInput, cb: (err: any, data?: DescribeMetricFiltersCommandOutput) => void): void;
281
118
  describeMetricFilters(args: DescribeMetricFiltersCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: DescribeMetricFiltersCommandOutput) => void): void;
282
- /**
283
- * <p>Returns a list of CloudWatch Logs Insights queries that are scheduled, executing, or have
284
- * been executed recently in this account. You can request all queries or limit it to queries of
285
- * a specific log group or queries with a certain status.</p>
286
- */
119
+
287
120
  describeQueries(args: DescribeQueriesCommandInput, options?: __HttpHandlerOptions): Promise<DescribeQueriesCommandOutput>;
288
121
  describeQueries(args: DescribeQueriesCommandInput, cb: (err: any, data?: DescribeQueriesCommandOutput) => void): void;
289
122
  describeQueries(args: DescribeQueriesCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: DescribeQueriesCommandOutput) => void): void;
290
- /**
291
- * <p>This operation returns a paginated list of your saved CloudWatch Logs Insights query definitions.</p>
292
- * <p>You can use the <code>queryDefinitionNamePrefix</code> parameter to limit the results to only the
293
- * query definitions that have names that start with a certain string.</p>
294
- */
123
+
295
124
  describeQueryDefinitions(args: DescribeQueryDefinitionsCommandInput, options?: __HttpHandlerOptions): Promise<DescribeQueryDefinitionsCommandOutput>;
296
125
  describeQueryDefinitions(args: DescribeQueryDefinitionsCommandInput, cb: (err: any, data?: DescribeQueryDefinitionsCommandOutput) => void): void;
297
126
  describeQueryDefinitions(args: DescribeQueryDefinitionsCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: DescribeQueryDefinitionsCommandOutput) => void): void;
298
- /**
299
- * <p>Lists the resource policies in this account.</p>
300
- */
127
+
301
128
  describeResourcePolicies(args: DescribeResourcePoliciesCommandInput, options?: __HttpHandlerOptions): Promise<DescribeResourcePoliciesCommandOutput>;
302
129
  describeResourcePolicies(args: DescribeResourcePoliciesCommandInput, cb: (err: any, data?: DescribeResourcePoliciesCommandOutput) => void): void;
303
130
  describeResourcePolicies(args: DescribeResourcePoliciesCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: DescribeResourcePoliciesCommandOutput) => void): void;
304
- /**
305
- * <p>Lists the subscription filters for the specified log group. You can list all the subscription filters or filter the results by prefix.
306
- * The results are ASCII-sorted by filter name.</p>
307
- */
131
+
308
132
  describeSubscriptionFilters(args: DescribeSubscriptionFiltersCommandInput, options?: __HttpHandlerOptions): Promise<DescribeSubscriptionFiltersCommandOutput>;
309
133
  describeSubscriptionFilters(args: DescribeSubscriptionFiltersCommandInput, cb: (err: any, data?: DescribeSubscriptionFiltersCommandOutput) => void): void;
310
134
  describeSubscriptionFilters(args: DescribeSubscriptionFiltersCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: DescribeSubscriptionFiltersCommandOutput) => void): void;
311
- /**
312
- * <p>Disassociates the associated Key Management Service customer master key (CMK) from the specified log group.</p>
313
- * <p>After the KMS CMK is disassociated from the log group, CloudWatch Logs stops encrypting newly ingested data for the log group.
314
- * All previously ingested data remains encrypted, and CloudWatch Logs requires permissions for the CMK whenever the encrypted data is requested.</p>
315
- * <p>Note that it can take up to 5 minutes for this operation to take effect.</p>
316
- */
135
+
317
136
  disassociateKmsKey(args: DisassociateKmsKeyCommandInput, options?: __HttpHandlerOptions): Promise<DisassociateKmsKeyCommandOutput>;
318
137
  disassociateKmsKey(args: DisassociateKmsKeyCommandInput, cb: (err: any, data?: DisassociateKmsKeyCommandOutput) => void): void;
319
138
  disassociateKmsKey(args: DisassociateKmsKeyCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: DisassociateKmsKeyCommandOutput) => void): void;
320
- /**
321
- * <p>Lists log events from the specified log group. You can list all the log events or filter the results
322
- * using a filter pattern, a time range, and the name of the log stream.</p>
323
- * <p>By default, this operation returns as many log events as can fit in 1 MB (up to 10,000
324
- * log events) or all the events found within the time range that you specify. If the results
325
- * include a token, then there are more log events available, and you can get additional results
326
- * by specifying the token in a subsequent call. This operation can return empty results
327
- * while there are more log events available through the token.</p>
328
- * <p>The returned log events are sorted by event timestamp, the timestamp when the event was ingested
329
- * by CloudWatch Logs, and the ID of the <code>PutLogEvents</code> request.</p>
330
- */
139
+
331
140
  filterLogEvents(args: FilterLogEventsCommandInput, options?: __HttpHandlerOptions): Promise<FilterLogEventsCommandOutput>;
332
141
  filterLogEvents(args: FilterLogEventsCommandInput, cb: (err: any, data?: FilterLogEventsCommandOutput) => void): void;
333
142
  filterLogEvents(args: FilterLogEventsCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: FilterLogEventsCommandOutput) => void): void;
334
- /**
335
- * <p>Lists log events from the specified log stream. You can list all of the log events or
336
- * filter using a time range.</p>
337
- *
338
- * <p>By default, this operation returns as many log events as can fit in a response size of 1MB (up to 10,000 log events).
339
- * You can get additional log events by specifying one of the tokens in a subsequent call.
340
- * This operation can return empty results while there are more log events available through the token.</p>
341
- */
143
+
342
144
  getLogEvents(args: GetLogEventsCommandInput, options?: __HttpHandlerOptions): Promise<GetLogEventsCommandOutput>;
343
145
  getLogEvents(args: GetLogEventsCommandInput, cb: (err: any, data?: GetLogEventsCommandOutput) => void): void;
344
146
  getLogEvents(args: GetLogEventsCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: GetLogEventsCommandOutput) => void): void;
345
- /**
346
- * <p>Returns a list of the fields that are included in log events in the specified log group, along with the percentage of log events
347
- * that contain each field. The search is limited to a time period that you specify.</p>
348
- * <p>In the results, fields that start with @ are fields generated by CloudWatch Logs. For
349
- * example, <code>@timestamp</code> is the timestamp of each log event. For more information about the fields that are
350
- * generated by CloudWatch logs, see
351
- * <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CWL_AnalyzeLogData-discoverable-fields.html">Supported Logs and Discovered Fields</a>.</p>
352
- * <p>The response results are sorted by the frequency percentage, starting
353
- * with the highest percentage.</p>
354
- */
147
+
355
148
  getLogGroupFields(args: GetLogGroupFieldsCommandInput, options?: __HttpHandlerOptions): Promise<GetLogGroupFieldsCommandOutput>;
356
149
  getLogGroupFields(args: GetLogGroupFieldsCommandInput, cb: (err: any, data?: GetLogGroupFieldsCommandOutput) => void): void;
357
150
  getLogGroupFields(args: GetLogGroupFieldsCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: GetLogGroupFieldsCommandOutput) => void): void;
358
- /**
359
- * <p>Retrieves all of the fields and values of a single log event. All fields are retrieved,
360
- * even if the original query that produced the <code>logRecordPointer</code> retrieved only a
361
- * subset of fields. Fields are returned as field name/field value pairs.</p>
362
- * <p>The full unparsed log event is returned within <code>@message</code>.</p>
363
- */
151
+
364
152
  getLogRecord(args: GetLogRecordCommandInput, options?: __HttpHandlerOptions): Promise<GetLogRecordCommandOutput>;
365
153
  getLogRecord(args: GetLogRecordCommandInput, cb: (err: any, data?: GetLogRecordCommandOutput) => void): void;
366
154
  getLogRecord(args: GetLogRecordCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: GetLogRecordCommandOutput) => void): void;
367
- /**
368
- * <p>Returns the results from the specified query.</p>
369
- * <p>Only the fields requested in the query are returned, along with a <code>@ptr</code>
370
- * field, which is the identifier for the log record. You can use the value of <code>@ptr</code>
371
- * in a <a href="https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_GetLogRecord.html">GetLogRecord</a>
372
- * operation to get the full log record.</p>
373
- * <p>
374
- * <code>GetQueryResults</code>
375
- * 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>
376
- * <p>If the value of the <code>Status</code> field in the output is <code>Running</code>, this operation
377
- * returns only partial results. If you see a value of <code>Scheduled</code> or <code>Running</code> for the status,
378
- * you can retry the operation later to see the final results. </p>
379
- */
155
+
380
156
  getQueryResults(args: GetQueryResultsCommandInput, options?: __HttpHandlerOptions): Promise<GetQueryResultsCommandOutput>;
381
157
  getQueryResults(args: GetQueryResultsCommandInput, cb: (err: any, data?: GetQueryResultsCommandOutput) => void): void;
382
158
  getQueryResults(args: GetQueryResultsCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: GetQueryResultsCommandOutput) => void): void;
383
- /**
384
- * <p>Lists the tags for the specified log group.</p>
385
- */
159
+
386
160
  listTagsLogGroup(args: ListTagsLogGroupCommandInput, options?: __HttpHandlerOptions): Promise<ListTagsLogGroupCommandOutput>;
387
161
  listTagsLogGroup(args: ListTagsLogGroupCommandInput, cb: (err: any, data?: ListTagsLogGroupCommandOutput) => void): void;
388
162
  listTagsLogGroup(args: ListTagsLogGroupCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: ListTagsLogGroupCommandOutput) => void): void;
389
- /**
390
- * <p>Creates or updates a destination. This operation is used only to create destinations for cross-account subscriptions.</p>
391
- * <p>A destination encapsulates a physical resource (such
392
- * as an Amazon Kinesis stream) and enables you to subscribe to a real-time stream of log events
393
- * for a different account, ingested using <a href="https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutLogEvents.html">PutLogEvents</a>.</p>
394
- * <p>Through an access policy, a destination controls what is written to it.
395
- * By default, <code>PutDestination</code> does not set any access policy with the destination,
396
- * which means a cross-account user cannot call <a href="https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutSubscriptionFilter.html">PutSubscriptionFilter</a> against
397
- * 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>
398
- * <p>To perform a <code>PutDestination</code> operation, you must also have the
399
- * <code>iam:PassRole</code> permission.</p>
400
- */
163
+
401
164
  putDestination(args: PutDestinationCommandInput, options?: __HttpHandlerOptions): Promise<PutDestinationCommandOutput>;
402
165
  putDestination(args: PutDestinationCommandInput, cb: (err: any, data?: PutDestinationCommandOutput) => void): void;
403
166
  putDestination(args: PutDestinationCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: PutDestinationCommandOutput) => void): void;
404
- /**
405
- * <p>Creates or updates an access policy associated with an existing
406
- * 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
407
- * to authorize claims to register a subscription filter against a given destination.</p>
408
- * <p>If multiple Amazon Web Services accounts are sending logs to this destination, each sender account must be
409
- * listed separately in the policy. The policy does not support specifying <code>*</code>
410
- * as the Principal or the use of the <code>aws:PrincipalOrgId</code> global key.</p>
411
- */
167
+
412
168
  putDestinationPolicy(args: PutDestinationPolicyCommandInput, options?: __HttpHandlerOptions): Promise<PutDestinationPolicyCommandOutput>;
413
169
  putDestinationPolicy(args: PutDestinationPolicyCommandInput, cb: (err: any, data?: PutDestinationPolicyCommandOutput) => void): void;
414
170
  putDestinationPolicy(args: PutDestinationPolicyCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: PutDestinationPolicyCommandOutput) => void): void;
415
- /**
416
- * <p>Uploads a batch of log events to the specified log stream.</p>
417
- * <p>You must include the sequence token obtained from the response of the previous call. An
418
- * upload in a newly created log stream does not require a sequence token. You can also get the
419
- * sequence token in the <code>expectedSequenceToken</code> field from
420
- * <code>InvalidSequenceTokenException</code>. If you call <code>PutLogEvents</code> twice
421
- * within a narrow time period using the same value for <code>sequenceToken</code>, both calls
422
- * might be successful or one might be rejected.</p>
423
- * <p>The batch of events must satisfy the following constraints:</p>
424
- * <ul>
425
- * <li>
426
- * <p>The maximum batch size is 1,048,576 bytes. This size is calculated as the sum of
427
- * all event messages in UTF-8, plus 26 bytes for each log event.</p>
428
- * </li>
429
- * <li>
430
- * <p>None of the log events in the batch can be more than 2 hours in the future.</p>
431
- * </li>
432
- * <li>
433
- * <p>None of the log events in the batch can be older than 14 days or older than the retention
434
- * period of the log group.</p>
435
- * </li>
436
- * <li>
437
- * <p>The log events in the batch must be in chronological order by their timestamp. The
438
- * timestamp is the time the event occurred, expressed as the number of milliseconds after
439
- * Jan 1, 1970 00:00:00 UTC. (In Amazon Web Services Tools for PowerShell and the Amazon Web Services SDK for .NET, the
440
- * timestamp is specified in .NET format: yyyy-mm-ddThh:mm:ss. For example,
441
- * 2017-09-15T13:45:30.) </p>
442
- * </li>
443
- * <li>
444
- * <p>A batch of log events in a single request cannot span more than 24 hours. Otherwise, the operation fails.</p>
445
- * </li>
446
- * <li>
447
- * <p>The maximum number of log events in a batch is 10,000.</p>
448
- * </li>
449
- * <li>
450
- * <p>There is a quota of 5 requests per second per log stream. Additional requests are throttled. This quota can't be changed.</p>
451
- * </li>
452
- * </ul>
453
- * <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>
454
- */
171
+
455
172
  putLogEvents(args: PutLogEventsCommandInput, options?: __HttpHandlerOptions): Promise<PutLogEventsCommandOutput>;
456
173
  putLogEvents(args: PutLogEventsCommandInput, cb: (err: any, data?: PutLogEventsCommandOutput) => void): void;
457
174
  putLogEvents(args: PutLogEventsCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: PutLogEventsCommandOutput) => void): void;
458
- /**
459
- * <p>Creates or updates a metric filter and associates it with the specified log group.
460
- * Metric filters allow you to configure rules to extract metric data from log events ingested
461
- * through <a href="https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutLogEvents.html">PutLogEvents</a>.</p>
462
- * <p>The maximum number of metric filters that can be associated with a log group is
463
- * 100.</p>
464
- * <p>When you create a metric filter, you can also optionally assign a unit and dimensions
465
- * to the metric that is created.</p>
466
- * <important>
467
- * <p>Metrics extracted from log events are charged as custom metrics.
468
- * To prevent unexpected high charges, do not specify high-cardinality fields such as
469
- * <code>IPAddress</code> or <code>requestID</code> as dimensions. Each different value
470
- * found for
471
- * a dimension is treated as a separate metric and accrues charges as a separate custom metric.
472
- * </p>
473
- * <p>To help prevent accidental high charges, Amazon disables a metric filter
474
- * if it generates 1000 different name/value pairs for the dimensions that you
475
- * have specified within a certain amount of time.</p>
476
- * <p>You can also set up a billing alarm to alert you if your charges are higher than
477
- * expected. For more information,
478
- * see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/monitor_estimated_charges_with_cloudwatch.html">
479
- * Creating a Billing Alarm to Monitor Your Estimated Amazon Web Services Charges</a>.
480
- * </p>
481
- * </important>
482
- */
175
+
483
176
  putMetricFilter(args: PutMetricFilterCommandInput, options?: __HttpHandlerOptions): Promise<PutMetricFilterCommandOutput>;
484
177
  putMetricFilter(args: PutMetricFilterCommandInput, cb: (err: any, data?: PutMetricFilterCommandOutput) => void): void;
485
178
  putMetricFilter(args: PutMetricFilterCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: PutMetricFilterCommandOutput) => void): void;
486
- /**
487
- * <p>Creates or updates a query definition for CloudWatch Logs Insights. For
488
- * more information, see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AnalyzingLogData.html">Analyzing Log Data with CloudWatch Logs Insights</a>.</p>
489
- *
490
- * <p>To update a query definition, specify its
491
- * <code>queryDefinitionId</code> in your request. The values of <code>name</code>, <code>queryString</code>,
492
- * and <code>logGroupNames</code> are changed to the values that you specify in your update
493
- * operation. No current values are retained from the current query definition. For example, if
494
- * you update a current query definition that includes log groups, and you don't specify the
495
- * <code>logGroupNames</code> parameter in your update operation, the query definition changes
496
- * to contain no log groups.</p>
497
- * <p>You must have the <code>logs:PutQueryDefinition</code> permission to be able to perform
498
- * this operation.</p>
499
- */
179
+
500
180
  putQueryDefinition(args: PutQueryDefinitionCommandInput, options?: __HttpHandlerOptions): Promise<PutQueryDefinitionCommandOutput>;
501
181
  putQueryDefinition(args: PutQueryDefinitionCommandInput, cb: (err: any, data?: PutQueryDefinitionCommandOutput) => void): void;
502
182
  putQueryDefinition(args: PutQueryDefinitionCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: PutQueryDefinitionCommandOutput) => void): void;
503
- /**
504
- * <p>Creates or updates a resource policy allowing other Amazon Web Services services to put log events to
505
- * this account, such as Amazon Route 53. An account can have up to 10 resource policies per Amazon Web Services
506
- * Region.</p>
507
- */
183
+
508
184
  putResourcePolicy(args: PutResourcePolicyCommandInput, options?: __HttpHandlerOptions): Promise<PutResourcePolicyCommandOutput>;
509
185
  putResourcePolicy(args: PutResourcePolicyCommandInput, cb: (err: any, data?: PutResourcePolicyCommandOutput) => void): void;
510
186
  putResourcePolicy(args: PutResourcePolicyCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: PutResourcePolicyCommandOutput) => void): void;
511
- /**
512
- * <p>Sets the retention of the specified log group. A retention policy allows you to
513
- * configure the number of days for which to retain log events in the specified log
514
- * group.</p>
515
- */
187
+
516
188
  putRetentionPolicy(args: PutRetentionPolicyCommandInput, options?: __HttpHandlerOptions): Promise<PutRetentionPolicyCommandOutput>;
517
189
  putRetentionPolicy(args: PutRetentionPolicyCommandInput, cb: (err: any, data?: PutRetentionPolicyCommandOutput) => void): void;
518
190
  putRetentionPolicy(args: PutRetentionPolicyCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: PutRetentionPolicyCommandOutput) => void): void;
519
- /**
520
- * <p>Creates or updates a subscription filter and associates it with the specified log
521
- * group. Subscription filters allow you to subscribe to a real-time stream of log events
522
- * ingested through <a href="https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutLogEvents.html">PutLogEvents</a> and have them delivered to a specific
523
- * destination. When log events are sent to the
524
- * receiving service, they are Base64 encoded
525
- * and compressed with the gzip format.</p>
526
- * <p>The following destinations are supported for subscription filters:</p>
527
- * <ul>
528
- * <li>
529
- * <p>An Amazon Kinesis stream belonging to the same account as the subscription filter,
530
- * for same-account delivery.</p>
531
- * </li>
532
- * <li>
533
- * <p>A logical destination that belongs to a different account, for cross-account delivery.</p>
534
- * </li>
535
- * <li>
536
- * <p>An Amazon Kinesis Firehose delivery stream that belongs to the same account as the
537
- * subscription filter, for same-account delivery.</p>
538
- * </li>
539
- * <li>
540
- * <p>An Lambda function that belongs to the same account as the subscription filter,
541
- * for same-account delivery.</p>
542
- * </li>
543
- * </ul>
544
- * <p>Each log group can have up to two subscription filters associated with it. If you are
545
- * updating an existing filter, you must specify the correct name in <code>filterName</code>.
546
- * </p>
547
- * <p>To perform a <code>PutSubscriptionFilter</code> operation, you must also have the
548
- * <code>iam:PassRole</code> permission.</p>
549
- */
191
+
550
192
  putSubscriptionFilter(args: PutSubscriptionFilterCommandInput, options?: __HttpHandlerOptions): Promise<PutSubscriptionFilterCommandOutput>;
551
193
  putSubscriptionFilter(args: PutSubscriptionFilterCommandInput, cb: (err: any, data?: PutSubscriptionFilterCommandOutput) => void): void;
552
194
  putSubscriptionFilter(args: PutSubscriptionFilterCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: PutSubscriptionFilterCommandOutput) => void): void;
553
- /**
554
- * <p>Schedules a query of a log group using CloudWatch Logs Insights. You specify the log group
555
- * and time range to query and the query string to use.</p>
556
- * <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>
557
- *
558
- * <p>Queries time out after 15 minutes of execution. If your queries are timing out, reduce the
559
- * time range being searched or partition your query into a number of queries.</p>
560
- */
195
+
561
196
  startQuery(args: StartQueryCommandInput, options?: __HttpHandlerOptions): Promise<StartQueryCommandOutput>;
562
197
  startQuery(args: StartQueryCommandInput, cb: (err: any, data?: StartQueryCommandOutput) => void): void;
563
198
  startQuery(args: StartQueryCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: StartQueryCommandOutput) => void): void;
564
- /**
565
- * <p>Stops a CloudWatch Logs Insights query that is in progress. If the query has already ended, the operation
566
- * returns an error indicating that the specified query is not running.</p>
567
- */
199
+
568
200
  stopQuery(args: StopQueryCommandInput, options?: __HttpHandlerOptions): Promise<StopQueryCommandOutput>;
569
201
  stopQuery(args: StopQueryCommandInput, cb: (err: any, data?: StopQueryCommandOutput) => void): void;
570
202
  stopQuery(args: StopQueryCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: StopQueryCommandOutput) => void): void;
571
- /**
572
- * <p>Adds or updates the specified tags for the specified log group.</p>
573
- * <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>.
574
- * To remove tags, use <a href="https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_UntagLogGroup.html">UntagLogGroup</a>.</p>
575
- * <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>
576
- * in the <i>Amazon CloudWatch Logs User Guide</i>.</p>
577
- * <p>CloudWatch Logs doesn’t support IAM policies that prevent users from assigning specified tags to
578
- * log groups using the <code>aws:Resource/<i>key-name</i>
579
- * </code> or <code>aws:TagKeys</code> condition keys.
580
- * For more information about using tags to control access, see
581
- * <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html">Controlling access to Amazon Web Services resources using tags</a>.</p>
582
- */
203
+
583
204
  tagLogGroup(args: TagLogGroupCommandInput, options?: __HttpHandlerOptions): Promise<TagLogGroupCommandOutput>;
584
205
  tagLogGroup(args: TagLogGroupCommandInput, cb: (err: any, data?: TagLogGroupCommandOutput) => void): void;
585
206
  tagLogGroup(args: TagLogGroupCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: TagLogGroupCommandOutput) => void): void;
586
- /**
587
- * <p>Tests the filter pattern of a metric filter against a sample of log event messages. You
588
- * can use this operation to validate the correctness of a metric filter pattern.</p>
589
- */
207
+
590
208
  testMetricFilter(args: TestMetricFilterCommandInput, options?: __HttpHandlerOptions): Promise<TestMetricFilterCommandOutput>;
591
209
  testMetricFilter(args: TestMetricFilterCommandInput, cb: (err: any, data?: TestMetricFilterCommandOutput) => void): void;
592
210
  testMetricFilter(args: TestMetricFilterCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: TestMetricFilterCommandOutput) => void): void;
593
- /**
594
- * <p>Removes the specified tags from the specified log group.</p>
595
- * <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>.
596
- * To add tags, use <a href="https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_TagLogGroup.html">TagLogGroup</a>.</p>
597
- * <p>CloudWatch Logs doesn’t support IAM policies that prevent users from assigning specified tags to
598
- * log groups using the <code>aws:Resource/<i>key-name</i>
599
- * </code> or <code>aws:TagKeys</code> condition keys.
600
- * </p>
601
- */
211
+
602
212
  untagLogGroup(args: UntagLogGroupCommandInput, options?: __HttpHandlerOptions): Promise<UntagLogGroupCommandOutput>;
603
213
  untagLogGroup(args: UntagLogGroupCommandInput, cb: (err: any, data?: UntagLogGroupCommandOutput) => void): void;
604
214
  untagLogGroup(args: UntagLogGroupCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: UntagLogGroupCommandOutput) => void): void;