@aws-sdk/client-cloudwatch-logs 3.940.0 → 3.943.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 (61) hide show
  1. package/README.md +40 -0
  2. package/dist-cjs/index.js +328 -71
  3. package/dist-es/CloudWatchLogs.js +10 -0
  4. package/dist-es/commands/AssociateSourceToS3TableIntegrationCommand.js +16 -0
  5. package/dist-es/commands/DisassociateSourceFromS3TableIntegrationCommand.js +16 -0
  6. package/dist-es/commands/GetLogFieldsCommand.js +16 -0
  7. package/dist-es/commands/ListAggregateLogGroupSummariesCommand.js +16 -0
  8. package/dist-es/commands/ListSourcesForS3TableIntegrationCommand.js +16 -0
  9. package/dist-es/commands/index.js +5 -0
  10. package/dist-es/models/enums.js +14 -0
  11. package/dist-es/models/errors.js +32 -32
  12. package/dist-es/pagination/ListSourcesForS3TableIntegrationPaginator.js +4 -0
  13. package/dist-es/pagination/index.js +1 -0
  14. package/dist-es/schemas/schemas_0.js +207 -39
  15. package/dist-types/CloudWatchLogs.d.ts +35 -0
  16. package/dist-types/CloudWatchLogsClient.d.ts +7 -2
  17. package/dist-types/commands/AssociateSourceToS3TableIntegrationCommand.d.ts +97 -0
  18. package/dist-types/commands/CreateScheduledQueryCommand.d.ts +4 -2
  19. package/dist-types/commands/DeleteAccountPolicyCommand.d.ts +8 -3
  20. package/dist-types/commands/DeleteIndexPolicyCommand.d.ts +8 -3
  21. package/dist-types/commands/DeleteScheduledQueryCommand.d.ts +4 -2
  22. package/dist-types/commands/DescribeFieldIndexesCommand.d.ts +1 -0
  23. package/dist-types/commands/DescribeLogGroupsCommand.d.ts +3 -2
  24. package/dist-types/commands/DescribeQueriesCommand.d.ts +4 -0
  25. package/dist-types/commands/DisassociateSourceFromS3TableIntegrationCommand.d.ts +92 -0
  26. package/dist-types/commands/GetLogFieldsCommand.d.ts +107 -0
  27. package/dist-types/commands/GetLogGroupFieldsCommand.d.ts +2 -0
  28. package/dist-types/commands/GetQueryResultsCommand.d.ts +3 -0
  29. package/dist-types/commands/GetScheduledQueryCommand.d.ts +4 -2
  30. package/dist-types/commands/GetScheduledQueryHistoryCommand.d.ts +4 -2
  31. package/dist-types/commands/ListAggregateLogGroupSummariesCommand.d.ts +118 -0
  32. package/dist-types/commands/ListLogGroupsCommand.d.ts +14 -2
  33. package/dist-types/commands/ListScheduledQueriesCommand.d.ts +4 -2
  34. package/dist-types/commands/ListSourcesForS3TableIntegrationCommand.d.ts +106 -0
  35. package/dist-types/commands/PutAccountPolicyCommand.d.ts +19 -6
  36. package/dist-types/commands/PutIndexPolicyCommand.d.ts +12 -4
  37. package/dist-types/commands/StartQueryCommand.d.ts +9 -3
  38. package/dist-types/commands/StopQueryCommand.d.ts +4 -0
  39. package/dist-types/commands/UpdateScheduledQueryCommand.d.ts +4 -2
  40. package/dist-types/commands/index.d.ts +5 -0
  41. package/dist-types/models/enums.d.ts +38 -0
  42. package/dist-types/models/errors.d.ts +34 -32
  43. package/dist-types/models/models_0.d.ts +479 -102
  44. package/dist-types/pagination/ListSourcesForS3TableIntegrationPaginator.d.ts +7 -0
  45. package/dist-types/pagination/index.d.ts +1 -0
  46. package/dist-types/schemas/schemas_0.d.ts +28 -0
  47. package/dist-types/ts3.4/CloudWatchLogs.d.ts +97 -0
  48. package/dist-types/ts3.4/CloudWatchLogsClient.d.ts +30 -0
  49. package/dist-types/ts3.4/commands/AssociateSourceToS3TableIntegrationCommand.d.ts +51 -0
  50. package/dist-types/ts3.4/commands/DisassociateSourceFromS3TableIntegrationCommand.d.ts +51 -0
  51. package/dist-types/ts3.4/commands/GetLogFieldsCommand.d.ts +47 -0
  52. package/dist-types/ts3.4/commands/ListAggregateLogGroupSummariesCommand.d.ts +51 -0
  53. package/dist-types/ts3.4/commands/ListSourcesForS3TableIntegrationCommand.d.ts +51 -0
  54. package/dist-types/ts3.4/commands/index.d.ts +5 -0
  55. package/dist-types/ts3.4/models/enums.d.ts +19 -0
  56. package/dist-types/ts3.4/models/errors.d.ts +21 -21
  57. package/dist-types/ts3.4/models/models_0.d.ts +81 -0
  58. package/dist-types/ts3.4/pagination/ListSourcesForS3TableIntegrationPaginator.d.ts +11 -0
  59. package/dist-types/ts3.4/pagination/index.d.ts +1 -0
  60. package/dist-types/ts3.4/schemas/schemas_0.d.ts +28 -0
  61. package/package.json +5 -5
@@ -27,7 +27,7 @@ declare const GetScheduledQueryCommand_base: {
27
27
  getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
28
28
  };
29
29
  /**
30
- * <p>Returns detailed information about a specified scheduled query, including its configuration, current state, and execution history.</p>
30
+ * <p>Retrieves details about a specific scheduled query, including its configuration, execution status, and metadata.</p>
31
31
  * @example
32
32
  * Use a bare-bones client and the command you need to make an API call.
33
33
  * ```javascript
@@ -81,7 +81,9 @@ declare const GetScheduledQueryCommand_base: {
81
81
  * <p>You don't have sufficient permissions to perform this action.</p>
82
82
  *
83
83
  * @throws {@link InternalServerException} (server fault)
84
- * <p>An internal server error occurred while processing the request. This is typically a temporary issue and the request can be retried.</p>
84
+ * <p>An internal server error occurred while processing the request. This exception is returned
85
+ * when the service encounters an unexpected condition that prevents it from fulfilling the
86
+ * request.</p>
85
87
  *
86
88
  * @throws {@link ResourceNotFoundException} (client fault)
87
89
  * <p>The specified resource does not exist.</p>
@@ -27,7 +27,7 @@ declare const GetScheduledQueryHistoryCommand_base: {
27
27
  getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
28
28
  };
29
29
  /**
30
- * <p>Retrieves the execution history of a scheduled query within a specified time range, including execution status and destination processing metadata.</p>
30
+ * <p>Retrieves the execution history of a scheduled query within a specified time range, including query results and destination processing status.</p>
31
31
  * @example
32
32
  * Use a bare-bones client and the command you need to make an API call.
33
33
  * ```javascript
@@ -83,7 +83,9 @@ declare const GetScheduledQueryHistoryCommand_base: {
83
83
  * <p>You don't have sufficient permissions to perform this action.</p>
84
84
  *
85
85
  * @throws {@link InternalServerException} (server fault)
86
- * <p>An internal server error occurred while processing the request. This is typically a temporary issue and the request can be retried.</p>
86
+ * <p>An internal server error occurred while processing the request. This exception is returned
87
+ * when the service encounters an unexpected condition that prevents it from fulfilling the
88
+ * request.</p>
87
89
  *
88
90
  * @throws {@link ResourceNotFoundException} (client fault)
89
91
  * <p>The specified resource does not exist.</p>
@@ -0,0 +1,118 @@
1
+ import { Command as $Command } from "@smithy/smithy-client";
2
+ import { MetadataBearer as __MetadataBearer } from "@smithy/types";
3
+ import { CloudWatchLogsClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../CloudWatchLogsClient";
4
+ import { ListAggregateLogGroupSummariesRequest, ListAggregateLogGroupSummariesResponse } from "../models/models_0";
5
+ /**
6
+ * @public
7
+ */
8
+ export type { __MetadataBearer };
9
+ export { $Command };
10
+ /**
11
+ * @public
12
+ *
13
+ * The input for {@link ListAggregateLogGroupSummariesCommand}.
14
+ */
15
+ export interface ListAggregateLogGroupSummariesCommandInput extends ListAggregateLogGroupSummariesRequest {
16
+ }
17
+ /**
18
+ * @public
19
+ *
20
+ * The output of {@link ListAggregateLogGroupSummariesCommand}.
21
+ */
22
+ export interface ListAggregateLogGroupSummariesCommandOutput extends ListAggregateLogGroupSummariesResponse, __MetadataBearer {
23
+ }
24
+ declare const ListAggregateLogGroupSummariesCommand_base: {
25
+ new (input: ListAggregateLogGroupSummariesCommandInput): import("@smithy/smithy-client").CommandImpl<ListAggregateLogGroupSummariesCommandInput, ListAggregateLogGroupSummariesCommandOutput, CloudWatchLogsClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
26
+ new (input: ListAggregateLogGroupSummariesCommandInput): import("@smithy/smithy-client").CommandImpl<ListAggregateLogGroupSummariesCommandInput, ListAggregateLogGroupSummariesCommandOutput, CloudWatchLogsClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
27
+ getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
28
+ };
29
+ /**
30
+ * <p>Returns an aggregate summary of all log groups in the Region grouped by specified data
31
+ * source characteristics. Supports optional filtering by log group class, name patterns, and
32
+ * data sources. If you perform this action in a monitoring account, you can also return
33
+ * aggregated summaries of log groups from source accounts that are linked to the monitoring
34
+ * account. For more information about using cross-account observability to set up monitoring
35
+ * accounts and source accounts, see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html">CloudWatch
36
+ * cross-account observability</a>.</p>
37
+ * <p>The operation aggregates log groups by data source name and type and optionally format,
38
+ * providing counts of log groups that share these characteristics. The operation paginates
39
+ * results. By default, it returns up to 50 results and includes a token to retrieve more
40
+ * results.</p>
41
+ * @example
42
+ * Use a bare-bones client and the command you need to make an API call.
43
+ * ```javascript
44
+ * import { CloudWatchLogsClient, ListAggregateLogGroupSummariesCommand } from "@aws-sdk/client-cloudwatch-logs"; // ES Modules import
45
+ * // const { CloudWatchLogsClient, ListAggregateLogGroupSummariesCommand } = require("@aws-sdk/client-cloudwatch-logs"); // CommonJS import
46
+ * // import type { CloudWatchLogsClientConfig } from "@aws-sdk/client-cloudwatch-logs";
47
+ * const config = {}; // type is CloudWatchLogsClientConfig
48
+ * const client = new CloudWatchLogsClient(config);
49
+ * const input = { // ListAggregateLogGroupSummariesRequest
50
+ * accountIdentifiers: [ // AccountIds
51
+ * "STRING_VALUE",
52
+ * ],
53
+ * includeLinkedAccounts: true || false,
54
+ * logGroupClass: "STANDARD" || "INFREQUENT_ACCESS" || "DELIVERY",
55
+ * logGroupNamePattern: "STRING_VALUE",
56
+ * dataSources: [ // DataSourceFilters
57
+ * { // DataSourceFilter
58
+ * name: "STRING_VALUE", // required
59
+ * type: "STRING_VALUE",
60
+ * },
61
+ * ],
62
+ * groupBy: "DATA_SOURCE_NAME_TYPE_AND_FORMAT" || "DATA_SOURCE_NAME_AND_TYPE", // required
63
+ * nextToken: "STRING_VALUE",
64
+ * limit: Number("int"),
65
+ * };
66
+ * const command = new ListAggregateLogGroupSummariesCommand(input);
67
+ * const response = await client.send(command);
68
+ * // { // ListAggregateLogGroupSummariesResponse
69
+ * // aggregateLogGroupSummaries: [ // AggregateLogGroupSummaries
70
+ * // { // AggregateLogGroupSummary
71
+ * // logGroupCount: Number("int"),
72
+ * // groupingIdentifiers: [ // GroupingIdentifiers
73
+ * // { // GroupingIdentifier
74
+ * // key: "STRING_VALUE",
75
+ * // value: "STRING_VALUE",
76
+ * // },
77
+ * // ],
78
+ * // },
79
+ * // ],
80
+ * // nextToken: "STRING_VALUE",
81
+ * // };
82
+ *
83
+ * ```
84
+ *
85
+ * @param ListAggregateLogGroupSummariesCommandInput - {@link ListAggregateLogGroupSummariesCommandInput}
86
+ * @returns {@link ListAggregateLogGroupSummariesCommandOutput}
87
+ * @see {@link ListAggregateLogGroupSummariesCommandInput} for command's `input` shape.
88
+ * @see {@link ListAggregateLogGroupSummariesCommandOutput} for command's `response` shape.
89
+ * @see {@link CloudWatchLogsClientResolvedConfig | config} for CloudWatchLogsClient's `config` shape.
90
+ *
91
+ * @throws {@link InvalidParameterException} (client fault)
92
+ * <p>A parameter is specified incorrectly.</p>
93
+ *
94
+ * @throws {@link ServiceUnavailableException} (server fault)
95
+ * <p>The service cannot complete the request.</p>
96
+ *
97
+ * @throws {@link ValidationException} (client fault)
98
+ * <p>One of the parameters for the request is not valid.</p>
99
+ *
100
+ * @throws {@link CloudWatchLogsServiceException}
101
+ * <p>Base exception class for all service exceptions from CloudWatchLogs service.</p>
102
+ *
103
+ *
104
+ * @public
105
+ */
106
+ export declare class ListAggregateLogGroupSummariesCommand extends ListAggregateLogGroupSummariesCommand_base {
107
+ /** @internal type navigation helper, not in runtime. */
108
+ protected static __types: {
109
+ api: {
110
+ input: ListAggregateLogGroupSummariesRequest;
111
+ output: ListAggregateLogGroupSummariesResponse;
112
+ };
113
+ sdk: {
114
+ input: ListAggregateLogGroupSummariesCommandInput;
115
+ output: ListAggregateLogGroupSummariesCommandOutput;
116
+ };
117
+ };
118
+ }
@@ -32,8 +32,11 @@ declare const ListLogGroupsCommand_base: {
32
32
  * that are linked to the monitoring account. For more information about using cross-account
33
33
  * observability to set up monitoring accounts and source accounts, see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html">
34
34
  * CloudWatch cross-account observability</a>.</p>
35
- * <p>You can optionally filter the list by log group class and by using regular expressions in
36
- * your request to match strings in the log group names.</p>
35
+ * <p>You can optionally filter the list by log group class, by using regular expressions in
36
+ * your request to match strings in the log group names, by using the fieldIndexes parameter to
37
+ * filter log groups based on which field indexes are configured, by using the dataSources
38
+ * parameter to filter log groups by data source types, and by using the fieldIndexNames
39
+ * parameter to filter by specific field index names.</p>
37
40
  * <p>This operation is paginated. By default, your first use of this operation returns 50
38
41
  * results, and includes a token to use in a subsequent operation to return more results.</p>
39
42
  * @example
@@ -53,6 +56,15 @@ declare const ListLogGroupsCommand_base: {
53
56
  * ],
54
57
  * nextToken: "STRING_VALUE",
55
58
  * limit: Number("int"),
59
+ * dataSources: [ // DataSourceFilters
60
+ * { // DataSourceFilter
61
+ * name: "STRING_VALUE", // required
62
+ * type: "STRING_VALUE",
63
+ * },
64
+ * ],
65
+ * fieldIndexNames: [ // FieldIndexNames
66
+ * "STRING_VALUE",
67
+ * ],
56
68
  * };
57
69
  * const command = new ListLogGroupsCommand(input);
58
70
  * const response = await client.send(command);
@@ -27,7 +27,7 @@ declare const ListScheduledQueriesCommand_base: {
27
27
  getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
28
28
  };
29
29
  /**
30
- * <p>Lists all scheduled queries in the current AWS account and region with optional filtering by state.</p>
30
+ * <p>Lists all scheduled queries in your account and region. You can filter results by state to show only enabled or disabled queries.</p>
31
31
  * @example
32
32
  * Use a bare-bones client and the command you need to make an API call.
33
33
  * ```javascript
@@ -78,7 +78,9 @@ declare const ListScheduledQueriesCommand_base: {
78
78
  * <p>You don't have sufficient permissions to perform this action.</p>
79
79
  *
80
80
  * @throws {@link InternalServerException} (server fault)
81
- * <p>An internal server error occurred while processing the request. This is typically a temporary issue and the request can be retried.</p>
81
+ * <p>An internal server error occurred while processing the request. This exception is returned
82
+ * when the service encounters an unexpected condition that prevents it from fulfilling the
83
+ * request.</p>
82
84
  *
83
85
  * @throws {@link ThrottlingException} (client fault)
84
86
  * <p>The request was throttled because of quota limits.</p>
@@ -0,0 +1,106 @@
1
+ import { Command as $Command } from "@smithy/smithy-client";
2
+ import { MetadataBearer as __MetadataBearer } from "@smithy/types";
3
+ import { CloudWatchLogsClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../CloudWatchLogsClient";
4
+ import { ListSourcesForS3TableIntegrationRequest, ListSourcesForS3TableIntegrationResponse } from "../models/models_0";
5
+ /**
6
+ * @public
7
+ */
8
+ export type { __MetadataBearer };
9
+ export { $Command };
10
+ /**
11
+ * @public
12
+ *
13
+ * The input for {@link ListSourcesForS3TableIntegrationCommand}.
14
+ */
15
+ export interface ListSourcesForS3TableIntegrationCommandInput extends ListSourcesForS3TableIntegrationRequest {
16
+ }
17
+ /**
18
+ * @public
19
+ *
20
+ * The output of {@link ListSourcesForS3TableIntegrationCommand}.
21
+ */
22
+ export interface ListSourcesForS3TableIntegrationCommandOutput extends ListSourcesForS3TableIntegrationResponse, __MetadataBearer {
23
+ }
24
+ declare const ListSourcesForS3TableIntegrationCommand_base: {
25
+ new (input: ListSourcesForS3TableIntegrationCommandInput): import("@smithy/smithy-client").CommandImpl<ListSourcesForS3TableIntegrationCommandInput, ListSourcesForS3TableIntegrationCommandOutput, CloudWatchLogsClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
26
+ new (input: ListSourcesForS3TableIntegrationCommandInput): import("@smithy/smithy-client").CommandImpl<ListSourcesForS3TableIntegrationCommandInput, ListSourcesForS3TableIntegrationCommandOutput, CloudWatchLogsClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
27
+ getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
28
+ };
29
+ /**
30
+ * <p>Returns a list of data source associations for a specified S3 Table Integration, showing
31
+ * which data sources are currently associated for query access.</p>
32
+ * @example
33
+ * Use a bare-bones client and the command you need to make an API call.
34
+ * ```javascript
35
+ * import { CloudWatchLogsClient, ListSourcesForS3TableIntegrationCommand } from "@aws-sdk/client-cloudwatch-logs"; // ES Modules import
36
+ * // const { CloudWatchLogsClient, ListSourcesForS3TableIntegrationCommand } = require("@aws-sdk/client-cloudwatch-logs"); // CommonJS import
37
+ * // import type { CloudWatchLogsClientConfig } from "@aws-sdk/client-cloudwatch-logs";
38
+ * const config = {}; // type is CloudWatchLogsClientConfig
39
+ * const client = new CloudWatchLogsClient(config);
40
+ * const input = { // ListSourcesForS3TableIntegrationRequest
41
+ * integrationArn: "STRING_VALUE", // required
42
+ * maxResults: Number("int"),
43
+ * nextToken: "STRING_VALUE",
44
+ * };
45
+ * const command = new ListSourcesForS3TableIntegrationCommand(input);
46
+ * const response = await client.send(command);
47
+ * // { // ListSourcesForS3TableIntegrationResponse
48
+ * // sources: [ // S3TableIntegrationSources
49
+ * // { // S3TableIntegrationSource
50
+ * // identifier: "STRING_VALUE",
51
+ * // dataSource: { // DataSource
52
+ * // name: "STRING_VALUE", // required
53
+ * // type: "STRING_VALUE",
54
+ * // },
55
+ * // status: "ACTIVE" || "UNHEALTHY" || "FAILED" || "DATA_SOURCE_DELETE_IN_PROGRESS",
56
+ * // statusReason: "STRING_VALUE",
57
+ * // createdTimeStamp: Number("long"),
58
+ * // },
59
+ * // ],
60
+ * // nextToken: "STRING_VALUE",
61
+ * // };
62
+ *
63
+ * ```
64
+ *
65
+ * @param ListSourcesForS3TableIntegrationCommandInput - {@link ListSourcesForS3TableIntegrationCommandInput}
66
+ * @returns {@link ListSourcesForS3TableIntegrationCommandOutput}
67
+ * @see {@link ListSourcesForS3TableIntegrationCommandInput} for command's `input` shape.
68
+ * @see {@link ListSourcesForS3TableIntegrationCommandOutput} for command's `response` shape.
69
+ * @see {@link CloudWatchLogsClientResolvedConfig | config} for CloudWatchLogsClient's `config` shape.
70
+ *
71
+ * @throws {@link AccessDeniedException} (client fault)
72
+ * <p>You don't have sufficient permissions to perform this action.</p>
73
+ *
74
+ * @throws {@link InternalServerException} (server fault)
75
+ * <p>An internal server error occurred while processing the request. This exception is returned
76
+ * when the service encounters an unexpected condition that prevents it from fulfilling the
77
+ * request.</p>
78
+ *
79
+ * @throws {@link ResourceNotFoundException} (client fault)
80
+ * <p>The specified resource does not exist.</p>
81
+ *
82
+ * @throws {@link ThrottlingException} (client fault)
83
+ * <p>The request was throttled because of quota limits.</p>
84
+ *
85
+ * @throws {@link ValidationException} (client fault)
86
+ * <p>One of the parameters for the request is not valid.</p>
87
+ *
88
+ * @throws {@link CloudWatchLogsServiceException}
89
+ * <p>Base exception class for all service exceptions from CloudWatchLogs service.</p>
90
+ *
91
+ *
92
+ * @public
93
+ */
94
+ export declare class ListSourcesForS3TableIntegrationCommand extends ListSourcesForS3TableIntegrationCommand_base {
95
+ /** @internal type navigation helper, not in runtime. */
96
+ protected static __types: {
97
+ api: {
98
+ input: ListSourcesForS3TableIntegrationRequest;
99
+ output: ListSourcesForS3TableIntegrationResponse;
100
+ };
101
+ sdk: {
102
+ input: ListSourcesForS3TableIntegrationCommandInput;
103
+ output: ListSourcesForS3TableIntegrationCommandOutput;
104
+ };
105
+ };
106
+ }
@@ -30,6 +30,11 @@ declare const PutAccountPolicyCommand_base: {
30
30
  * <p>Creates an account-level data protection policy, subscription filter policy, field index
31
31
  * policy, transformer policy, or metric extraction policy that applies to all log groups or a
32
32
  * subset of log groups in the account.</p>
33
+ * <p>For field index policies, you can configure indexed fields as
34
+ * <i>facets</i> to enable interactive exploration of your logs. Facets provide
35
+ * value distributions and counts for indexed fields in the CloudWatch Logs Insights console
36
+ * without requiring query execution. For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CloudWatchLogs-Facets.html">Use facets to group and
37
+ * explore logs</a>.</p>
33
38
  * <p>To use this operation, you must be signed on with the correct permissions depending on the
34
39
  * type of policy that you are creating.</p>
35
40
  * <ul>
@@ -52,6 +57,11 @@ declare const PutAccountPolicyCommand_base: {
52
57
  * <code>logs:PutAccountPolicy</code> permissions.</p>
53
58
  * </li>
54
59
  * <li>
60
+ * <p>To configure facets for field index policies, you must have the
61
+ * <code>logs:PutIndexPolicy</code> and <code>logs:PutAccountPolicy</code>
62
+ * permissions.</p>
63
+ * </li>
64
+ * <li>
55
65
  * <p>To create a metric extraction policy, you must have the
56
66
  * <code>logs:PutMetricExtractionPolicy</code> and <code>logs:PutAccountPolicy</code>
57
67
  * permissions.</p>
@@ -207,12 +217,15 @@ declare const PutAccountPolicyCommand_base: {
207
217
  * indexed field of <code>RequestId</code> won't match a log event containing
208
218
  * <code>requestId</code>.</p>
209
219
  * <p>You can have one account-level field index policy that applies to all log groups in the
210
- * account. Or you can create as many as 20 account-level field index policies that are each
211
- * scoped to a subset of log groups with the <code>selectionCriteria</code> parameter. If you
212
- * have multiple account-level index policies with selection criteria, no two of them can use the
213
- * same or overlapping log group name prefixes. For example, if you have one policy filtered to
214
- * log groups that start with <code>my-log</code>, you can't have another field index policy
215
- * filtered to <code>my-logpprod</code> or <code>my-logging</code>.</p>
220
+ * account. Or you can create as many as 40 account-level field index policies (20 for log group
221
+ * prefix selection, 20 for data source selection) that are each scoped to a subset of log groups
222
+ * or data sources with the <code>selectionCriteria</code> parameter. Field index policies can
223
+ * now be created for specific data source name and type combinations using DataSourceName and
224
+ * DataSourceType selection criteria. If you have multiple account-level index policies with
225
+ * selection criteria, no two of them can use the same or overlapping log group name prefixes.
226
+ * For example, if you have one policy filtered to log groups that start with
227
+ * <code>my-log</code>, you can't have another field index policy filtered to
228
+ * <code>my-logpprod</code> or <code>my-logging</code>.</p>
216
229
  * <p>If you create an account-level field index policy in a monitoring account in cross-account
217
230
  * observability, the policy is applied only to the monitoring account and not to any source
218
231
  * accounts.</p>
@@ -38,6 +38,12 @@ declare const PutIndexPolicyCommand_base: {
38
38
  * field. Good fields to index are fields that you often need to query for and fields or values
39
39
  * that match only a small fraction of the total log events. Common examples of indexes include
40
40
  * request ID, session ID, userID, and instance IDs. For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CloudWatchLogs-Field-Indexing.html">Create field indexes to improve query performance and reduce costs</a>.</p>
41
+ * <p>You can configure indexed fields as <i>facets</i> to enable
42
+ * interactive exploration and filtering of your logs in the CloudWatch Logs Insights console. Facets
43
+ * allow you to view value distributions and counts for indexed fields without running queries.
44
+ * When you create a field index, you can optionally set it as a facet to enable this interactive
45
+ * analysis capability. For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CloudWatchLogs-Facets.html">Use facets to group and
46
+ * explore logs</a>.</p>
41
47
  * <p>To find the fields that are in your log group events, use the <a href="https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_GetLogGroupFields.html">GetLogGroupFields</a> operation.</p>
42
48
  * <p>For example, suppose you have created a field index for <code>requestId</code>. Then, any
43
49
  * CloudWatch Logs Insights query on that log group that includes <code>requestId =
@@ -88,10 +94,12 @@ declare const PutIndexPolicyCommand_base: {
88
94
  * <p>Matches of log events to the names of indexed fields are case-sensitive. For example, a
89
95
  * field index of <code>RequestId</code> won't match a log event containing
90
96
  * <code>requestId</code>.</p>
91
- * <p>Log group-level field index policies created with <code>PutIndexPolicy</code> override
92
- * account-level field index policies created with <a href="https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutAccountPolicy.html">PutAccountPolicy</a>. If you use <code>PutIndexPolicy</code> to create a field index
93
- * policy for a log group, that log group uses only that policy. The log group ignores any
94
- * account-wide field index policy that you might have created.</p>
97
+ * <p>Log group-level field index policies created with
98
+ * <code>PutIndexPolicy</code> override account-level field index policies created with <a href="https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutAccountPolicy.html">PutAccountPolicy</a> that apply to log groups. If you use <code>PutIndexPolicy</code>
99
+ * to create a field index policy for a log group, that log group uses only that policy for log
100
+ * group-level indexing, including any facet configurations. The log group ignores any
101
+ * account-wide field index policy that applies to log groups, but data source-based account
102
+ * policies may still apply.</p>
95
103
  * @example
96
104
  * Use a bare-bones client and the command you need to make an API call.
97
105
  * ```javascript
@@ -27,13 +27,18 @@ declare const StartQueryCommand_base: {
27
27
  getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
28
28
  };
29
29
  /**
30
- * <p>Starts a query of one or more log groups using CloudWatch Logs Insights. You specify
31
- * the log groups and time range to query and the query string to use.</p>
30
+ * <p>Starts a query of one or more log groups or data sources using CloudWatch Logs
31
+ * Insights. You specify the log groups or data sources and time range to query and the query
32
+ * string to use. You can query up to 10 data sources in a single query.</p>
32
33
  * <p>For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CWL_QuerySyntax.html">CloudWatch Logs Insights Query
33
34
  * Syntax</a>.</p>
34
35
  * <p>After you run a query using <code>StartQuery</code>, the query results are stored by
35
36
  * CloudWatch Logs. You can use <a href="https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_GetQueryResults.html">GetQueryResults</a> to retrieve the results of a query, using the <code>queryId</code>
36
37
  * that <code>StartQuery</code> returns. </p>
38
+ * <p>Interactive queries started with <code>StartQuery</code> share concurrency limits with
39
+ * automated scheduled query executions. Both types of queries count toward the same regional
40
+ * concurrent query quota, so high scheduled query activity may affect the availability of
41
+ * concurrent slots for interactive queries.</p>
37
42
  * <note>
38
43
  * <p>To specify the log groups to query, a <code>StartQuery</code> operation must include one
39
44
  * of the following:</p>
@@ -46,7 +51,8 @@ declare const StartQueryCommand_base: {
46
51
  * <li>
47
52
  * <p>Or the <code>queryString</code> must include a <code>SOURCE</code> command to select
48
53
  * log groups for the query. The <code>SOURCE</code> command can select log groups based on
49
- * log group name prefix, account ID, and log class.
54
+ * log group name prefix, account ID, and log class, or select data sources using
55
+ * dataSource syntax in LogsQL, PPL, and SQL.
50
56
  * </p>
51
57
  * <p>For more information about the <code>SOURCE</code> command, see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CWL_QuerySyntax-Source.html">SOURCE</a>.</p>
52
58
  * </li>
@@ -30,6 +30,10 @@ declare const StopQueryCommand_base: {
30
30
  * <p>Stops a CloudWatch Logs Insights query that is in progress. If the query has already
31
31
  * ended, the operation returns an error indicating that the specified query is not
32
32
  * running.</p>
33
+ * <p>This operation can be used to cancel both interactive queries and individual scheduled
34
+ * query executions. When used with scheduled queries, <code>StopQuery</code> cancels only the
35
+ * specific execution identified by the query ID, not the scheduled query configuration
36
+ * itself.</p>
33
37
  * @example
34
38
  * Use a bare-bones client and the command you need to make an API call.
35
39
  * ```javascript
@@ -27,7 +27,7 @@ declare const UpdateScheduledQueryCommand_base: {
27
27
  getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
28
28
  };
29
29
  /**
30
- * <p>Updates the configuration of an existing scheduled query. This operation follows PUT semantics, replacing the existing configuration with the provided values.</p>
30
+ * <p>Updates an existing scheduled query with new configuration. This operation uses PUT semantics, allowing modification of query parameters, schedule, and destinations.</p>
31
31
  * @example
32
32
  * Use a bare-bones client and the command you need to make an API call.
33
33
  * ```javascript
@@ -100,7 +100,9 @@ declare const UpdateScheduledQueryCommand_base: {
100
100
  * <p>You don't have sufficient permissions to perform this action.</p>
101
101
  *
102
102
  * @throws {@link InternalServerException} (server fault)
103
- * <p>An internal server error occurred while processing the request. This is typically a temporary issue and the request can be retried.</p>
103
+ * <p>An internal server error occurred while processing the request. This exception is returned
104
+ * when the service encounters an unexpected condition that prevents it from fulfilling the
105
+ * request.</p>
104
106
  *
105
107
  * @throws {@link ResourceNotFoundException} (client fault)
106
108
  * <p>The specified resource does not exist.</p>
@@ -1,4 +1,5 @@
1
1
  export * from "./AssociateKmsKeyCommand";
2
+ export * from "./AssociateSourceToS3TableIntegrationCommand";
2
3
  export * from "./CancelExportTaskCommand";
3
4
  export * from "./CreateDeliveryCommand";
4
5
  export * from "./CreateExportTaskCommand";
@@ -42,6 +43,7 @@ export * from "./DescribeQueryDefinitionsCommand";
42
43
  export * from "./DescribeResourcePoliciesCommand";
43
44
  export * from "./DescribeSubscriptionFiltersCommand";
44
45
  export * from "./DisassociateKmsKeyCommand";
46
+ export * from "./DisassociateSourceFromS3TableIntegrationCommand";
45
47
  export * from "./FilterLogEventsCommand";
46
48
  export * from "./GetDataProtectionPolicyCommand";
47
49
  export * from "./GetDeliveryCommand";
@@ -51,6 +53,7 @@ export * from "./GetDeliverySourceCommand";
51
53
  export * from "./GetIntegrationCommand";
52
54
  export * from "./GetLogAnomalyDetectorCommand";
53
55
  export * from "./GetLogEventsCommand";
56
+ export * from "./GetLogFieldsCommand";
54
57
  export * from "./GetLogGroupFieldsCommand";
55
58
  export * from "./GetLogObjectCommand";
56
59
  export * from "./GetLogRecordCommand";
@@ -58,12 +61,14 @@ export * from "./GetQueryResultsCommand";
58
61
  export * from "./GetScheduledQueryCommand";
59
62
  export * from "./GetScheduledQueryHistoryCommand";
60
63
  export * from "./GetTransformerCommand";
64
+ export * from "./ListAggregateLogGroupSummariesCommand";
61
65
  export * from "./ListAnomaliesCommand";
62
66
  export * from "./ListIntegrationsCommand";
63
67
  export * from "./ListLogAnomalyDetectorsCommand";
64
68
  export * from "./ListLogGroupsCommand";
65
69
  export * from "./ListLogGroupsForQueryCommand";
66
70
  export * from "./ListScheduledQueriesCommand";
71
+ export * from "./ListSourcesForS3TableIntegrationCommand";
67
72
  export * from "./ListTagsForResourceCommand";
68
73
  export * from "./ListTagsLogGroupCommand";
69
74
  export * from "./PutAccountPolicyCommand";
@@ -180,6 +180,18 @@ export declare const ExportTaskStatusCode: {
180
180
  * @public
181
181
  */
182
182
  export type ExportTaskStatusCode = (typeof ExportTaskStatusCode)[keyof typeof ExportTaskStatusCode];
183
+ /**
184
+ * @public
185
+ * @enum
186
+ */
187
+ export declare const IndexType: {
188
+ readonly FACET: "FACET";
189
+ readonly FIELD_INDEX: "FIELD_INDEX";
190
+ };
191
+ /**
192
+ * @public
193
+ */
194
+ export type IndexType = (typeof IndexType)[keyof typeof IndexType];
183
195
  /**
184
196
  * @public
185
197
  * @enum
@@ -426,6 +438,18 @@ export declare const Type: {
426
438
  * @public
427
439
  */
428
440
  export type Type = (typeof Type)[keyof typeof Type];
441
+ /**
442
+ * @public
443
+ * @enum
444
+ */
445
+ export declare const ListAggregateLogGroupSummariesGroupBy: {
446
+ readonly DATA_SOURCE_NAME_AND_TYPE: "DATA_SOURCE_NAME_AND_TYPE";
447
+ readonly DATA_SOURCE_NAME_TYPE_AND_FORMAT: "DATA_SOURCE_NAME_TYPE_AND_FORMAT";
448
+ };
449
+ /**
450
+ * @public
451
+ */
452
+ export type ListAggregateLogGroupSummariesGroupBy = (typeof ListAggregateLogGroupSummariesGroupBy)[keyof typeof ListAggregateLogGroupSummariesGroupBy];
429
453
  /**
430
454
  * @public
431
455
  * @enum
@@ -438,6 +462,20 @@ export declare const SuppressionState: {
438
462
  * @public
439
463
  */
440
464
  export type SuppressionState = (typeof SuppressionState)[keyof typeof SuppressionState];
465
+ /**
466
+ * @public
467
+ * @enum
468
+ */
469
+ export declare const S3TableIntegrationSourceStatus: {
470
+ readonly ACTIVE: "ACTIVE";
471
+ readonly DATA_SOURCE_DELETE_IN_PROGRESS: "DATA_SOURCE_DELETE_IN_PROGRESS";
472
+ readonly FAILED: "FAILED";
473
+ readonly UNHEALTHY: "UNHEALTHY";
474
+ };
475
+ /**
476
+ * @public
477
+ */
478
+ export type S3TableIntegrationSourceStatus = (typeof S3TableIntegrationSourceStatus)[keyof typeof S3TableIntegrationSourceStatus];
441
479
  /**
442
480
  * @public
443
481
  * @enum