@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
@@ -51,157 +51,59 @@ import { UntagLogGroupCommandInput, UntagLogGroupCommandOutput } from "./command
51
51
  export declare type ServiceInputTypes = AssociateKmsKeyCommandInput | CancelExportTaskCommandInput | CreateExportTaskCommandInput | CreateLogGroupCommandInput | CreateLogStreamCommandInput | DeleteDestinationCommandInput | DeleteLogGroupCommandInput | DeleteLogStreamCommandInput | DeleteMetricFilterCommandInput | DeleteQueryDefinitionCommandInput | DeleteResourcePolicyCommandInput | DeleteRetentionPolicyCommandInput | DeleteSubscriptionFilterCommandInput | DescribeDestinationsCommandInput | DescribeExportTasksCommandInput | DescribeLogGroupsCommandInput | DescribeLogStreamsCommandInput | DescribeMetricFiltersCommandInput | DescribeQueriesCommandInput | DescribeQueryDefinitionsCommandInput | DescribeResourcePoliciesCommandInput | DescribeSubscriptionFiltersCommandInput | DisassociateKmsKeyCommandInput | FilterLogEventsCommandInput | GetLogEventsCommandInput | GetLogGroupFieldsCommandInput | GetLogRecordCommandInput | GetQueryResultsCommandInput | ListTagsLogGroupCommandInput | PutDestinationCommandInput | PutDestinationPolicyCommandInput | PutLogEventsCommandInput | PutMetricFilterCommandInput | PutQueryDefinitionCommandInput | PutResourcePolicyCommandInput | PutRetentionPolicyCommandInput | PutSubscriptionFilterCommandInput | StartQueryCommandInput | StopQueryCommandInput | TagLogGroupCommandInput | TestMetricFilterCommandInput | UntagLogGroupCommandInput;
52
52
  export declare type ServiceOutputTypes = AssociateKmsKeyCommandOutput | CancelExportTaskCommandOutput | CreateExportTaskCommandOutput | CreateLogGroupCommandOutput | CreateLogStreamCommandOutput | DeleteDestinationCommandOutput | DeleteLogGroupCommandOutput | DeleteLogStreamCommandOutput | DeleteMetricFilterCommandOutput | DeleteQueryDefinitionCommandOutput | DeleteResourcePolicyCommandOutput | DeleteRetentionPolicyCommandOutput | DeleteSubscriptionFilterCommandOutput | DescribeDestinationsCommandOutput | DescribeExportTasksCommandOutput | DescribeLogGroupsCommandOutput | DescribeLogStreamsCommandOutput | DescribeMetricFiltersCommandOutput | DescribeQueriesCommandOutput | DescribeQueryDefinitionsCommandOutput | DescribeResourcePoliciesCommandOutput | DescribeSubscriptionFiltersCommandOutput | DisassociateKmsKeyCommandOutput | FilterLogEventsCommandOutput | GetLogEventsCommandOutput | GetLogGroupFieldsCommandOutput | GetLogRecordCommandOutput | GetQueryResultsCommandOutput | ListTagsLogGroupCommandOutput | PutDestinationCommandOutput | PutDestinationPolicyCommandOutput | PutLogEventsCommandOutput | PutMetricFilterCommandOutput | PutQueryDefinitionCommandOutput | PutResourcePolicyCommandOutput | PutRetentionPolicyCommandOutput | PutSubscriptionFilterCommandOutput | StartQueryCommandOutput | StopQueryCommandOutput | TagLogGroupCommandOutput | TestMetricFilterCommandOutput | UntagLogGroupCommandOutput;
53
53
  export interface ClientDefaults extends Partial<__SmithyResolvedConfiguration<__HttpHandlerOptions>> {
54
- /**
55
- * The HTTP handler to use. Fetch in browser and Https in Nodejs.
56
- */
54
+
57
55
  requestHandler?: __HttpHandler;
58
- /**
59
- * A constructor for a class implementing the {@link __Hash} interface
60
- * that computes the SHA-256 HMAC or checksum of a string or binary buffer.
61
- * @internal
62
- */
56
+
63
57
  sha256?: __HashConstructor;
64
- /**
65
- * The function that will be used to convert strings into HTTP endpoints.
66
- * @internal
67
- */
58
+
68
59
  urlParser?: __UrlParser;
69
- /**
70
- * A function that can calculate the length of a request body.
71
- * @internal
72
- */
60
+
73
61
  bodyLengthChecker?: (body: any) => number | undefined;
74
- /**
75
- * A function that converts a stream into an array of bytes.
76
- * @internal
77
- */
62
+
78
63
  streamCollector?: __StreamCollector;
79
- /**
80
- * The function that will be used to convert a base64-encoded string to a byte array.
81
- * @internal
82
- */
64
+
83
65
  base64Decoder?: __Decoder;
84
- /**
85
- * The function that will be used to convert binary data to a base64-encoded string.
86
- * @internal
87
- */
66
+
88
67
  base64Encoder?: __Encoder;
89
- /**
90
- * The function that will be used to convert a UTF8-encoded string to a byte array.
91
- * @internal
92
- */
68
+
93
69
  utf8Decoder?: __Decoder;
94
- /**
95
- * The function that will be used to convert binary data to a UTF-8 encoded string.
96
- * @internal
97
- */
70
+
98
71
  utf8Encoder?: __Encoder;
99
- /**
100
- * The runtime environment.
101
- * @internal
102
- */
72
+
103
73
  runtime?: string;
104
- /**
105
- * Disable dyanamically changing the endpoint of the client based on the hostPrefix
106
- * trait of an operation.
107
- */
74
+
108
75
  disableHostPrefix?: boolean;
109
- /**
110
- * Value for how many times a request will be made at most in case of retry.
111
- */
76
+
112
77
  maxAttempts?: number | __Provider<number>;
113
- /**
114
- * Specifies which retry algorithm to use.
115
- */
78
+
116
79
  retryMode?: string | __Provider<string>;
117
- /**
118
- * Optional logger for logging debug/info/warn/error.
119
- */
80
+
120
81
  logger?: __Logger;
121
- /**
122
- * Unique service identifier.
123
- * @internal
124
- */
82
+
125
83
  serviceId?: string;
126
- /**
127
- * The AWS region to which this client will send requests
128
- */
84
+
129
85
  region?: string | __Provider<string>;
130
- /**
131
- * Default credentials provider; Not available in browser runtime.
132
- * @internal
133
- */
86
+
134
87
  credentialDefaultProvider?: (input: any) => __Provider<__Credentials>;
135
- /**
136
- * Fetch related hostname, signing name or signing region with given region.
137
- * @internal
138
- */
88
+
139
89
  regionInfoProvider?: RegionInfoProvider;
140
- /**
141
- * The provider populating default tracking information to be sent with `user-agent`, `x-amz-user-agent` header
142
- * @internal
143
- */
90
+
144
91
  defaultUserAgentProvider?: Provider<__UserAgent>;
145
92
  }
146
93
  declare type CloudWatchLogsClientConfigType = Partial<__SmithyConfiguration<__HttpHandlerOptions>> & ClientDefaults & RegionInputConfig & EndpointsInputConfig & RetryInputConfig & HostHeaderInputConfig & AwsAuthInputConfig & UserAgentInputConfig;
147
- /**
148
- * The configuration interface of CloudWatchLogsClient class constructor that set the region, credentials and other options.
149
- */
94
+
150
95
  export interface CloudWatchLogsClientConfig extends CloudWatchLogsClientConfigType {
151
96
  }
152
97
  declare type CloudWatchLogsClientResolvedConfigType = __SmithyResolvedConfiguration<__HttpHandlerOptions> & Required<ClientDefaults> & RegionResolvedConfig & EndpointsResolvedConfig & RetryResolvedConfig & HostHeaderResolvedConfig & AwsAuthResolvedConfig & UserAgentResolvedConfig;
153
- /**
154
- * The resolved configuration interface of CloudWatchLogsClient class. This is resolved and normalized from the {@link CloudWatchLogsClientConfig | constructor configuration interface}.
155
- */
98
+
156
99
  export interface CloudWatchLogsClientResolvedConfig extends CloudWatchLogsClientResolvedConfigType {
157
100
  }
158
- /**
159
- * <p>You can use Amazon CloudWatch Logs to monitor, store, and access your log files from
160
- * EC2 instances, CloudTrail, and other sources. You can then retrieve the associated
161
- * log data from CloudWatch Logs using the CloudWatch console, CloudWatch Logs commands in the
162
- * Amazon Web Services CLI, CloudWatch Logs API, or CloudWatch Logs SDK.</p>
163
- * <p>You can use CloudWatch Logs to:</p>
164
- * <ul>
165
- * <li>
166
- * <p>
167
- * <b>Monitor logs from EC2 instances in real-time</b>: You
168
- * can use CloudWatch Logs to monitor applications and systems using log data. For example,
169
- * CloudWatch Logs can track the number of errors that occur in your application logs and
170
- * send you a notification whenever the rate of errors exceeds a threshold that you specify.
171
- * CloudWatch Logs uses your log data for monitoring so no code changes are required. For
172
- * example, you can monitor application logs for specific literal terms (such as
173
- * "NullReferenceException") or count the number of occurrences of a literal term at a
174
- * particular position in log data (such as "404" status codes in an Apache access log). When
175
- * the term you are searching for is found, CloudWatch Logs reports the data to a CloudWatch
176
- * metric that you specify.</p>
177
- * </li>
178
- * <li>
179
- * <p>
180
- * <b>Monitor CloudTrail logged events</b>: You can
181
- * create alarms in CloudWatch and receive notifications of particular API activity as
182
- * captured by CloudTrail. You can use the notification to perform troubleshooting.</p>
183
- * </li>
184
- * <li>
185
- * <p>
186
- * <b>Archive log data</b>: You can use CloudWatch Logs to
187
- * store your log data in highly durable storage. You can change the log retention setting so
188
- * that any log events older than this setting are automatically deleted. The CloudWatch Logs
189
- * agent makes it easy to quickly send both rotated and non-rotated log data off of a host
190
- * and into the log service. You can then access the raw log data when you need it.</p>
191
- * </li>
192
- * </ul>
193
- */
101
+
194
102
  export declare class CloudWatchLogsClient extends __Client<__HttpHandlerOptions, ServiceInputTypes, ServiceOutputTypes, CloudWatchLogsClientResolvedConfig> {
195
- /**
196
- * The resolved configuration of CloudWatchLogsClient class. This is resolved and normalized from the {@link CloudWatchLogsClientConfig | constructor configuration interface}.
197
- */
103
+
198
104
  readonly config: CloudWatchLogsClientResolvedConfig;
199
105
  constructor(configuration: CloudWatchLogsClientConfig);
200
- /**
201
- * Destroy underlying resources, like sockets. It's usually not necessary to do this.
202
- * However in Node.js, it's best to explicitly shut down the client's agent when it is no longer needed.
203
- * Otherwise, sockets might stay open for quite a long time before the server terminates them.
204
- */
106
+
205
107
  destroy(): void;
206
108
  }
207
109
  export {};
@@ -6,41 +6,11 @@ export interface AssociateKmsKeyCommandInput extends AssociateKmsKeyRequest {
6
6
  }
7
7
  export interface AssociateKmsKeyCommandOutput extends __MetadataBearer {
8
8
  }
9
- /**
10
- * <p>Associates the specified Key Management Service customer master key (CMK) with the specified log group.</p>
11
- * <p>Associating an KMS CMK with a log group overrides any existing associations between the log group and a CMK.
12
- * After a CMK is associated with a log group, all newly ingested data for the log group is encrypted using the CMK.
13
- * This association is stored as long as the data encrypted with the CMK is still within CloudWatch Logs.
14
- * This enables CloudWatch Logs to decrypt this data whenever it is requested.</p>
15
- * <important>
16
- * <p>CloudWatch Logs supports only symmetric CMKs. Do not use an associate an asymmetric CMK
17
- * 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
18
- * Keys</a>.</p>
19
- * </important>
20
- * <p>It can take up to 5 minutes for this operation to take effect.</p>
21
- * <p>If you attempt to associate a CMK with a log group but the CMK does not exist or the
22
- * CMK is disabled, you receive an <code>InvalidParameterException</code> error. </p>
23
- * @example
24
- * Use a bare-bones client and the command you need to make an API call.
25
- * ```javascript
26
- * import { CloudWatchLogsClient, AssociateKmsKeyCommand } from "@aws-sdk/client-cloudwatch-logs"; // ES Modules import
27
- * // const { CloudWatchLogsClient, AssociateKmsKeyCommand } = require("@aws-sdk/client-cloudwatch-logs"); // CommonJS import
28
- * const client = new CloudWatchLogsClient(config);
29
- * const command = new AssociateKmsKeyCommand(input);
30
- * const response = await client.send(command);
31
- * ```
32
- *
33
- * @see {@link AssociateKmsKeyCommandInput} for command's `input` shape.
34
- * @see {@link AssociateKmsKeyCommandOutput} for command's `response` shape.
35
- * @see {@link CloudWatchLogsClientResolvedConfig | config} for command's `input` shape.
36
- *
37
- */
9
+
38
10
  export declare class AssociateKmsKeyCommand extends $Command<AssociateKmsKeyCommandInput, AssociateKmsKeyCommandOutput, CloudWatchLogsClientResolvedConfig> {
39
11
  readonly input: AssociateKmsKeyCommandInput;
40
12
  constructor(input: AssociateKmsKeyCommandInput);
41
- /**
42
- * @internal
43
- */
13
+
44
14
  resolveMiddleware(clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>, configuration: CloudWatchLogsClientResolvedConfig, options?: __HttpHandlerOptions): Handler<AssociateKmsKeyCommandInput, AssociateKmsKeyCommandOutput>;
45
15
  private serialize;
46
16
  private deserialize;
@@ -6,30 +6,11 @@ export interface CancelExportTaskCommandInput extends CancelExportTaskRequest {
6
6
  }
7
7
  export interface CancelExportTaskCommandOutput extends __MetadataBearer {
8
8
  }
9
- /**
10
- * <p>Cancels the specified export task.</p>
11
- * <p>The task must be in the <code>PENDING</code> or <code>RUNNING</code> state.</p>
12
- * @example
13
- * Use a bare-bones client and the command you need to make an API call.
14
- * ```javascript
15
- * import { CloudWatchLogsClient, CancelExportTaskCommand } from "@aws-sdk/client-cloudwatch-logs"; // ES Modules import
16
- * // const { CloudWatchLogsClient, CancelExportTaskCommand } = require("@aws-sdk/client-cloudwatch-logs"); // CommonJS import
17
- * const client = new CloudWatchLogsClient(config);
18
- * const command = new CancelExportTaskCommand(input);
19
- * const response = await client.send(command);
20
- * ```
21
- *
22
- * @see {@link CancelExportTaskCommandInput} for command's `input` shape.
23
- * @see {@link CancelExportTaskCommandOutput} for command's `response` shape.
24
- * @see {@link CloudWatchLogsClientResolvedConfig | config} for command's `input` shape.
25
- *
26
- */
9
+
27
10
  export declare class CancelExportTaskCommand extends $Command<CancelExportTaskCommandInput, CancelExportTaskCommandOutput, CloudWatchLogsClientResolvedConfig> {
28
11
  readonly input: CancelExportTaskCommandInput;
29
12
  constructor(input: CancelExportTaskCommandInput);
30
- /**
31
- * @internal
32
- */
13
+
33
14
  resolveMiddleware(clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>, configuration: CloudWatchLogsClientResolvedConfig, options?: __HttpHandlerOptions): Handler<CancelExportTaskCommandInput, CancelExportTaskCommandOutput>;
34
15
  private serialize;
35
16
  private deserialize;
@@ -6,42 +6,11 @@ export interface CreateExportTaskCommandInput extends CreateExportTaskRequest {
6
6
  }
7
7
  export interface CreateExportTaskCommandOutput extends CreateExportTaskResponse, __MetadataBearer {
8
8
  }
9
- /**
10
- * <p>Creates an export task, which allows you to efficiently export data from a
11
- * log group to an Amazon S3 bucket. When you perform a <code>CreateExportTask</code>
12
- * operation, you must use credentials that have permission to write to the S3 bucket
13
- * that you specify as the destination.</p>
14
- * <p>This is an asynchronous call. If all the required information is provided, this
15
- * operation initiates an export task and responds with the ID of the task. After the task has started,
16
- * 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
17
- * only have one active (<code>RUNNING</code> or <code>PENDING</code>) export task at a time.
18
- * To cancel an export task, use <a href="https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_CancelExportTask.html">CancelExportTask</a>.</p>
19
- * <p>You can export logs from multiple log groups or multiple time ranges to the same S3
20
- * bucket. To separate out log data for each export task, you can specify a prefix to be used as
21
- * the Amazon S3 key prefix for all exported objects.</p>
22
- * <p>Exporting to S3 buckets that are encrypted with AES-256 is supported. Exporting to S3 buckets
23
- * encrypted with SSE-KMS is not supported. </p>
24
- * @example
25
- * Use a bare-bones client and the command you need to make an API call.
26
- * ```javascript
27
- * import { CloudWatchLogsClient, CreateExportTaskCommand } from "@aws-sdk/client-cloudwatch-logs"; // ES Modules import
28
- * // const { CloudWatchLogsClient, CreateExportTaskCommand } = require("@aws-sdk/client-cloudwatch-logs"); // CommonJS import
29
- * const client = new CloudWatchLogsClient(config);
30
- * const command = new CreateExportTaskCommand(input);
31
- * const response = await client.send(command);
32
- * ```
33
- *
34
- * @see {@link CreateExportTaskCommandInput} for command's `input` shape.
35
- * @see {@link CreateExportTaskCommandOutput} for command's `response` shape.
36
- * @see {@link CloudWatchLogsClientResolvedConfig | config} for command's `input` shape.
37
- *
38
- */
9
+
39
10
  export declare class CreateExportTaskCommand extends $Command<CreateExportTaskCommandInput, CreateExportTaskCommandOutput, CloudWatchLogsClientResolvedConfig> {
40
11
  readonly input: CreateExportTaskCommandInput;
41
12
  constructor(input: CreateExportTaskCommandInput);
42
- /**
43
- * @internal
44
- */
13
+
45
14
  resolveMiddleware(clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>, configuration: CloudWatchLogsClientResolvedConfig, options?: __HttpHandlerOptions): Handler<CreateExportTaskCommandInput, CreateExportTaskCommandOutput>;
46
15
  private serialize;
47
16
  private deserialize;
@@ -6,55 +6,11 @@ export interface CreateLogGroupCommandInput extends CreateLogGroupRequest {
6
6
  }
7
7
  export interface CreateLogGroupCommandOutput extends __MetadataBearer {
8
8
  }
9
- /**
10
- * <p>Creates a log group with the specified name. You can create up to 20,000 log groups per account.</p>
11
- * <p>You must use the following guidelines when naming a log group:</p>
12
- * <ul>
13
- * <li>
14
- * <p>Log group names must be unique within a region for an Amazon Web Services account.</p>
15
- * </li>
16
- * <li>
17
- * <p>Log group names can be between 1 and 512 characters long.</p>
18
- * </li>
19
- * <li>
20
- * <p>Log group names consist of the following characters: a-z, A-Z, 0-9, '_' (underscore), '-' (hyphen),
21
- * '/' (forward slash), '.' (period), and '#' (number sign)</p>
22
- * </li>
23
- * </ul>
24
- * <p>When you create a log group, by default the log events in the log group never expire. To set
25
- * a retention policy so that events expire and are deleted after a specified time, use
26
- * <a href="https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutRetentionPolicy.html">PutRetentionPolicy</a>.</p>
27
- * <p>If you associate a Key Management Service customer master key (CMK) with the log group, ingested data is encrypted using the CMK.
28
- * This association is stored as long as the data encrypted with the CMK is still within CloudWatch Logs.
29
- * This enables CloudWatch Logs to decrypt this data whenever it is requested.</p>
30
- * <p>If you attempt to associate a CMK with the log group but the CMK does not exist or the
31
- * CMK is disabled, you receive an <code>InvalidParameterException</code> error. </p>
32
- * <important>
33
- * <p>CloudWatch Logs supports only symmetric CMKs. Do not associate an asymmetric CMK with
34
- * your log group. For more information, see <a href="https://docs.aws.amazon.com/kms/latest/developerguide/symmetric-asymmetric.html">Using Symmetric and Asymmetric
35
- * Keys</a>.</p>
36
- * </important>
37
- * @example
38
- * Use a bare-bones client and the command you need to make an API call.
39
- * ```javascript
40
- * import { CloudWatchLogsClient, CreateLogGroupCommand } from "@aws-sdk/client-cloudwatch-logs"; // ES Modules import
41
- * // const { CloudWatchLogsClient, CreateLogGroupCommand } = require("@aws-sdk/client-cloudwatch-logs"); // CommonJS import
42
- * const client = new CloudWatchLogsClient(config);
43
- * const command = new CreateLogGroupCommand(input);
44
- * const response = await client.send(command);
45
- * ```
46
- *
47
- * @see {@link CreateLogGroupCommandInput} for command's `input` shape.
48
- * @see {@link CreateLogGroupCommandOutput} for command's `response` shape.
49
- * @see {@link CloudWatchLogsClientResolvedConfig | config} for command's `input` shape.
50
- *
51
- */
9
+
52
10
  export declare class CreateLogGroupCommand extends $Command<CreateLogGroupCommandInput, CreateLogGroupCommandOutput, CloudWatchLogsClientResolvedConfig> {
53
11
  readonly input: CreateLogGroupCommandInput;
54
12
  constructor(input: CreateLogGroupCommandInput);
55
- /**
56
- * @internal
57
- */
13
+
58
14
  resolveMiddleware(clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>, configuration: CloudWatchLogsClientResolvedConfig, options?: __HttpHandlerOptions): Handler<CreateLogGroupCommandInput, CreateLogGroupCommandOutput>;
59
15
  private serialize;
60
16
  private deserialize;
@@ -6,45 +6,11 @@ export interface CreateLogStreamCommandInput extends CreateLogStreamRequest {
6
6
  }
7
7
  export interface CreateLogStreamCommandOutput extends __MetadataBearer {
8
8
  }
9
- /**
10
- * <p>Creates a log stream for the specified log group. A log stream is a sequence of log events
11
- * that originate from a single source, such as an application instance or a resource that is
12
- * being monitored.</p>
13
- * <p>There is no limit on the number of log streams that you can create for a log group. There is a limit
14
- * of 50 TPS on <code>CreateLogStream</code> operations, after which transactions are throttled.</p>
15
- * <p>You must use the following guidelines when naming a log stream:</p>
16
- * <ul>
17
- * <li>
18
- * <p>Log stream names must be unique within the log group.</p>
19
- * </li>
20
- * <li>
21
- * <p>Log stream names can be between 1 and 512 characters long.</p>
22
- * </li>
23
- * <li>
24
- * <p>The ':' (colon) and '*' (asterisk) characters are not allowed.</p>
25
- * </li>
26
- * </ul>
27
- * @example
28
- * Use a bare-bones client and the command you need to make an API call.
29
- * ```javascript
30
- * import { CloudWatchLogsClient, CreateLogStreamCommand } from "@aws-sdk/client-cloudwatch-logs"; // ES Modules import
31
- * // const { CloudWatchLogsClient, CreateLogStreamCommand } = require("@aws-sdk/client-cloudwatch-logs"); // CommonJS import
32
- * const client = new CloudWatchLogsClient(config);
33
- * const command = new CreateLogStreamCommand(input);
34
- * const response = await client.send(command);
35
- * ```
36
- *
37
- * @see {@link CreateLogStreamCommandInput} for command's `input` shape.
38
- * @see {@link CreateLogStreamCommandOutput} for command's `response` shape.
39
- * @see {@link CloudWatchLogsClientResolvedConfig | config} for command's `input` shape.
40
- *
41
- */
9
+
42
10
  export declare class CreateLogStreamCommand extends $Command<CreateLogStreamCommandInput, CreateLogStreamCommandOutput, CloudWatchLogsClientResolvedConfig> {
43
11
  readonly input: CreateLogStreamCommandInput;
44
12
  constructor(input: CreateLogStreamCommandInput);
45
- /**
46
- * @internal
47
- */
13
+
48
14
  resolveMiddleware(clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>, configuration: CloudWatchLogsClientResolvedConfig, options?: __HttpHandlerOptions): Handler<CreateLogStreamCommandInput, CreateLogStreamCommandOutput>;
49
15
  private serialize;
50
16
  private deserialize;
@@ -6,31 +6,11 @@ export interface DeleteDestinationCommandInput extends DeleteDestinationRequest
6
6
  }
7
7
  export interface DeleteDestinationCommandOutput extends __MetadataBearer {
8
8
  }
9
- /**
10
- * <p>Deletes the specified destination, and eventually disables all the
11
- * subscription filters that publish to it. This operation does not delete the
12
- * physical resource encapsulated by the destination.</p>
13
- * @example
14
- * Use a bare-bones client and the command you need to make an API call.
15
- * ```javascript
16
- * import { CloudWatchLogsClient, DeleteDestinationCommand } from "@aws-sdk/client-cloudwatch-logs"; // ES Modules import
17
- * // const { CloudWatchLogsClient, DeleteDestinationCommand } = require("@aws-sdk/client-cloudwatch-logs"); // CommonJS import
18
- * const client = new CloudWatchLogsClient(config);
19
- * const command = new DeleteDestinationCommand(input);
20
- * const response = await client.send(command);
21
- * ```
22
- *
23
- * @see {@link DeleteDestinationCommandInput} for command's `input` shape.
24
- * @see {@link DeleteDestinationCommandOutput} for command's `response` shape.
25
- * @see {@link CloudWatchLogsClientResolvedConfig | config} for command's `input` shape.
26
- *
27
- */
9
+
28
10
  export declare class DeleteDestinationCommand extends $Command<DeleteDestinationCommandInput, DeleteDestinationCommandOutput, CloudWatchLogsClientResolvedConfig> {
29
11
  readonly input: DeleteDestinationCommandInput;
30
12
  constructor(input: DeleteDestinationCommandInput);
31
- /**
32
- * @internal
33
- */
13
+
34
14
  resolveMiddleware(clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>, configuration: CloudWatchLogsClientResolvedConfig, options?: __HttpHandlerOptions): Handler<DeleteDestinationCommandInput, DeleteDestinationCommandOutput>;
35
15
  private serialize;
36
16
  private deserialize;
@@ -6,30 +6,11 @@ export interface DeleteLogGroupCommandInput extends DeleteLogGroupRequest {
6
6
  }
7
7
  export interface DeleteLogGroupCommandOutput extends __MetadataBearer {
8
8
  }
9
- /**
10
- * <p>Deletes the specified log group and permanently deletes all the archived
11
- * log events associated with the log 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, DeleteLogGroupCommand } from "@aws-sdk/client-cloudwatch-logs"; // ES Modules import
16
- * // const { CloudWatchLogsClient, DeleteLogGroupCommand } = require("@aws-sdk/client-cloudwatch-logs"); // CommonJS import
17
- * const client = new CloudWatchLogsClient(config);
18
- * const command = new DeleteLogGroupCommand(input);
19
- * const response = await client.send(command);
20
- * ```
21
- *
22
- * @see {@link DeleteLogGroupCommandInput} for command's `input` shape.
23
- * @see {@link DeleteLogGroupCommandOutput} for command's `response` shape.
24
- * @see {@link CloudWatchLogsClientResolvedConfig | config} for command's `input` shape.
25
- *
26
- */
9
+
27
10
  export declare class DeleteLogGroupCommand extends $Command<DeleteLogGroupCommandInput, DeleteLogGroupCommandOutput, CloudWatchLogsClientResolvedConfig> {
28
11
  readonly input: DeleteLogGroupCommandInput;
29
12
  constructor(input: DeleteLogGroupCommandInput);
30
- /**
31
- * @internal
32
- */
13
+
33
14
  resolveMiddleware(clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>, configuration: CloudWatchLogsClientResolvedConfig, options?: __HttpHandlerOptions): Handler<DeleteLogGroupCommandInput, DeleteLogGroupCommandOutput>;
34
15
  private serialize;
35
16
  private deserialize;
@@ -6,30 +6,11 @@ export interface DeleteLogStreamCommandInput extends DeleteLogStreamRequest {
6
6
  }
7
7
  export interface DeleteLogStreamCommandOutput extends __MetadataBearer {
8
8
  }
9
- /**
10
- * <p>Deletes the specified log stream and permanently deletes all the archived log events associated
11
- * with the log stream.</p>
12
- * @example
13
- * Use a bare-bones client and the command you need to make an API call.
14
- * ```javascript
15
- * import { CloudWatchLogsClient, DeleteLogStreamCommand } from "@aws-sdk/client-cloudwatch-logs"; // ES Modules import
16
- * // const { CloudWatchLogsClient, DeleteLogStreamCommand } = require("@aws-sdk/client-cloudwatch-logs"); // CommonJS import
17
- * const client = new CloudWatchLogsClient(config);
18
- * const command = new DeleteLogStreamCommand(input);
19
- * const response = await client.send(command);
20
- * ```
21
- *
22
- * @see {@link DeleteLogStreamCommandInput} for command's `input` shape.
23
- * @see {@link DeleteLogStreamCommandOutput} for command's `response` shape.
24
- * @see {@link CloudWatchLogsClientResolvedConfig | config} for command's `input` shape.
25
- *
26
- */
9
+
27
10
  export declare class DeleteLogStreamCommand extends $Command<DeleteLogStreamCommandInput, DeleteLogStreamCommandOutput, CloudWatchLogsClientResolvedConfig> {
28
11
  readonly input: DeleteLogStreamCommandInput;
29
12
  constructor(input: DeleteLogStreamCommandInput);
30
- /**
31
- * @internal
32
- */
13
+
33
14
  resolveMiddleware(clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>, configuration: CloudWatchLogsClientResolvedConfig, options?: __HttpHandlerOptions): Handler<DeleteLogStreamCommandInput, DeleteLogStreamCommandOutput>;
34
15
  private serialize;
35
16
  private deserialize;
@@ -6,29 +6,11 @@ export interface DeleteMetricFilterCommandInput extends DeleteMetricFilterReques
6
6
  }
7
7
  export interface DeleteMetricFilterCommandOutput extends __MetadataBearer {
8
8
  }
9
- /**
10
- * <p>Deletes the specified metric filter.</p>
11
- * @example
12
- * Use a bare-bones client and the command you need to make an API call.
13
- * ```javascript
14
- * import { CloudWatchLogsClient, DeleteMetricFilterCommand } from "@aws-sdk/client-cloudwatch-logs"; // ES Modules import
15
- * // const { CloudWatchLogsClient, DeleteMetricFilterCommand } = require("@aws-sdk/client-cloudwatch-logs"); // CommonJS import
16
- * const client = new CloudWatchLogsClient(config);
17
- * const command = new DeleteMetricFilterCommand(input);
18
- * const response = await client.send(command);
19
- * ```
20
- *
21
- * @see {@link DeleteMetricFilterCommandInput} for command's `input` shape.
22
- * @see {@link DeleteMetricFilterCommandOutput} for command's `response` shape.
23
- * @see {@link CloudWatchLogsClientResolvedConfig | config} for command's `input` shape.
24
- *
25
- */
9
+
26
10
  export declare class DeleteMetricFilterCommand extends $Command<DeleteMetricFilterCommandInput, DeleteMetricFilterCommandOutput, CloudWatchLogsClientResolvedConfig> {
27
11
  readonly input: DeleteMetricFilterCommandInput;
28
12
  constructor(input: DeleteMetricFilterCommandInput);
29
- /**
30
- * @internal
31
- */
13
+
32
14
  resolveMiddleware(clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>, configuration: CloudWatchLogsClientResolvedConfig, options?: __HttpHandlerOptions): Handler<DeleteMetricFilterCommandInput, DeleteMetricFilterCommandOutput>;
33
15
  private serialize;
34
16
  private deserialize;
@@ -6,33 +6,11 @@ export interface DeleteQueryDefinitionCommandInput extends DeleteQueryDefinition
6
6
  }
7
7
  export interface DeleteQueryDefinitionCommandOutput extends DeleteQueryDefinitionResponse, __MetadataBearer {
8
8
  }
9
- /**
10
- * <p>Deletes a saved CloudWatch Logs Insights query definition.
11
- * A query definition contains details about a saved CloudWatch Logs Insights query.</p>
12
- * <p>Each <code>DeleteQueryDefinition</code> operation can delete one query definition.</p>
13
- * <p>You must have the <code>logs:DeleteQueryDefinition</code> permission to be able to perform
14
- * this operation.</p>
15
- * @example
16
- * Use a bare-bones client and the command you need to make an API call.
17
- * ```javascript
18
- * import { CloudWatchLogsClient, DeleteQueryDefinitionCommand } from "@aws-sdk/client-cloudwatch-logs"; // ES Modules import
19
- * // const { CloudWatchLogsClient, DeleteQueryDefinitionCommand } = require("@aws-sdk/client-cloudwatch-logs"); // CommonJS import
20
- * const client = new CloudWatchLogsClient(config);
21
- * const command = new DeleteQueryDefinitionCommand(input);
22
- * const response = await client.send(command);
23
- * ```
24
- *
25
- * @see {@link DeleteQueryDefinitionCommandInput} for command's `input` shape.
26
- * @see {@link DeleteQueryDefinitionCommandOutput} for command's `response` shape.
27
- * @see {@link CloudWatchLogsClientResolvedConfig | config} for command's `input` shape.
28
- *
29
- */
9
+
30
10
  export declare class DeleteQueryDefinitionCommand extends $Command<DeleteQueryDefinitionCommandInput, DeleteQueryDefinitionCommandOutput, CloudWatchLogsClientResolvedConfig> {
31
11
  readonly input: DeleteQueryDefinitionCommandInput;
32
12
  constructor(input: DeleteQueryDefinitionCommandInput);
33
- /**
34
- * @internal
35
- */
13
+
36
14
  resolveMiddleware(clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>, configuration: CloudWatchLogsClientResolvedConfig, options?: __HttpHandlerOptions): Handler<DeleteQueryDefinitionCommandInput, DeleteQueryDefinitionCommandOutput>;
37
15
  private serialize;
38
16
  private deserialize;
@@ -6,30 +6,11 @@ export interface DeleteResourcePolicyCommandInput extends DeleteResourcePolicyRe
6
6
  }
7
7
  export interface DeleteResourcePolicyCommandOutput extends __MetadataBearer {
8
8
  }
9
- /**
10
- * <p>Deletes a resource policy from this account. This revokes
11
- * the access of the identities in that policy to put log events to this account.</p>
12
- * @example
13
- * Use a bare-bones client and the command you need to make an API call.
14
- * ```javascript
15
- * import { CloudWatchLogsClient, DeleteResourcePolicyCommand } from "@aws-sdk/client-cloudwatch-logs"; // ES Modules import
16
- * // const { CloudWatchLogsClient, DeleteResourcePolicyCommand } = require("@aws-sdk/client-cloudwatch-logs"); // CommonJS import
17
- * const client = new CloudWatchLogsClient(config);
18
- * const command = new DeleteResourcePolicyCommand(input);
19
- * const response = await client.send(command);
20
- * ```
21
- *
22
- * @see {@link DeleteResourcePolicyCommandInput} for command's `input` shape.
23
- * @see {@link DeleteResourcePolicyCommandOutput} for command's `response` shape.
24
- * @see {@link CloudWatchLogsClientResolvedConfig | config} for command's `input` shape.
25
- *
26
- */
9
+
27
10
  export declare class DeleteResourcePolicyCommand extends $Command<DeleteResourcePolicyCommandInput, DeleteResourcePolicyCommandOutput, CloudWatchLogsClientResolvedConfig> {
28
11
  readonly input: DeleteResourcePolicyCommandInput;
29
12
  constructor(input: DeleteResourcePolicyCommandInput);
30
- /**
31
- * @internal
32
- */
13
+
33
14
  resolveMiddleware(clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>, configuration: CloudWatchLogsClientResolvedConfig, options?: __HttpHandlerOptions): Handler<DeleteResourcePolicyCommandInput, DeleteResourcePolicyCommandOutput>;
34
15
  private serialize;
35
16
  private deserialize;