@aws-sdk/client-cloudwatch-logs 3.846.0 → 3.848.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.
- package/README.md +2 -2
- package/dist-cjs/index.js +8 -1
- package/dist-es/models/models_0.js +5 -0
- package/dist-types/CloudWatchLogs.d.ts +2 -2
- package/dist-types/CloudWatchLogsClient.d.ts +2 -2
- package/dist-types/commands/AssociateKmsKeyCommand.d.ts +30 -29
- package/dist-types/commands/CreateDeliveryCommand.d.ts +22 -25
- package/dist-types/commands/CreateExportTaskCommand.d.ts +10 -9
- package/dist-types/commands/CreateLogAnomalyDetectorCommand.d.ts +19 -25
- package/dist-types/commands/CreateLogGroupCommand.d.ts +5 -3
- package/dist-types/commands/CreateLogStreamCommand.d.ts +6 -5
- package/dist-types/commands/DeleteAccountPolicyCommand.d.ts +17 -12
- package/dist-types/commands/DeleteDeliveryCommand.d.ts +5 -3
- package/dist-types/commands/DeleteDeliveryDestinationCommand.d.ts +6 -4
- package/dist-types/commands/DeleteDeliveryDestinationPolicyCommand.d.ts +2 -2
- package/dist-types/commands/DeleteDeliverySourceCommand.d.ts +6 -4
- package/dist-types/commands/DeleteDestinationCommand.d.ts +3 -3
- package/dist-types/commands/DeleteIndexPolicyCommand.d.ts +7 -6
- package/dist-types/commands/DeleteIntegrationCommand.d.ts +6 -5
- package/dist-types/commands/DeleteLogGroupCommand.d.ts +2 -2
- package/dist-types/commands/DeleteLogStreamCommand.d.ts +2 -2
- package/dist-types/commands/DeleteQueryDefinitionCommand.d.ts +2 -2
- package/dist-types/commands/DeleteResourcePolicyCommand.d.ts +7 -2
- package/dist-types/commands/DeleteRetentionPolicyCommand.d.ts +2 -1
- package/dist-types/commands/DeleteTransformerCommand.d.ts +6 -6
- package/dist-types/commands/DescribeAccountPoliciesCommand.d.ts +12 -8
- package/dist-types/commands/DescribeConfigurationTemplatesCommand.d.ts +5 -4
- package/dist-types/commands/DescribeDeliveriesCommand.d.ts +9 -11
- package/dist-types/commands/DescribeDeliveryDestinationsCommand.d.ts +3 -2
- package/dist-types/commands/DescribeDestinationsCommand.d.ts +2 -1
- package/dist-types/commands/DescribeExportTasksCommand.d.ts +2 -2
- package/dist-types/commands/DescribeFieldIndexesCommand.d.ts +2 -3
- package/dist-types/commands/DescribeIndexPoliciesCommand.d.ts +6 -6
- package/dist-types/commands/DescribeLogGroupsCommand.d.ts +13 -11
- package/dist-types/commands/DescribeLogStreamsCommand.d.ts +10 -10
- package/dist-types/commands/DescribeQueryDefinitionsCommand.d.ts +5 -4
- package/dist-types/commands/DescribeResourcePoliciesCommand.d.ts +5 -0
- package/dist-types/commands/DescribeSubscriptionFiltersCommand.d.ts +3 -2
- package/dist-types/commands/DisassociateKmsKeyCommand.d.ts +13 -13
- package/dist-types/commands/FilterLogEventsCommand.d.ts +31 -20
- package/dist-types/commands/GetDeliveryCommand.d.ts +12 -13
- package/dist-types/commands/GetDeliveryDestinationCommand.d.ts +1 -1
- package/dist-types/commands/GetDeliveryDestinationPolicyCommand.d.ts +2 -3
- package/dist-types/commands/GetLogEventsCommand.d.ts +25 -17
- package/dist-types/commands/GetLogGroupFieldsCommand.d.ts +8 -8
- package/dist-types/commands/GetQueryResultsCommand.d.ts +13 -11
- package/dist-types/commands/GetTransformerCommand.d.ts +2 -2
- package/dist-types/commands/ListAnomaliesCommand.d.ts +3 -2
- package/dist-types/commands/ListIntegrationsCommand.d.ts +3 -2
- package/dist-types/commands/ListLogGroupsCommand.d.ts +8 -7
- package/dist-types/commands/ListLogGroupsForQueryCommand.d.ts +6 -5
- package/dist-types/commands/ListTagsForResourceCommand.d.ts +2 -2
- package/dist-types/commands/ListTagsLogGroupCommand.d.ts +1 -1
- package/dist-types/commands/PutAccountPolicyCommand.d.ts +113 -98
- package/dist-types/commands/PutDataProtectionPolicyCommand.d.ts +20 -19
- package/dist-types/commands/PutDeliveryDestinationCommand.d.ts +28 -28
- package/dist-types/commands/PutDeliveryDestinationPolicyCommand.d.ts +18 -20
- package/dist-types/commands/PutDeliverySourceCommand.d.ts +23 -25
- package/dist-types/commands/PutDestinationCommand.d.ts +7 -6
- package/dist-types/commands/PutDestinationPolicyCommand.d.ts +4 -3
- package/dist-types/commands/PutIndexPolicyCommand.d.ts +24 -23
- package/dist-types/commands/PutIntegrationCommand.d.ts +8 -6
- package/dist-types/commands/PutLogEventsCommand.d.ts +27 -24
- package/dist-types/commands/PutMetricFilterCommand.d.ts +14 -18
- package/dist-types/commands/PutQueryDefinitionCommand.d.ts +3 -3
- package/dist-types/commands/PutResourcePolicyCommand.d.ts +15 -3
- package/dist-types/commands/PutRetentionPolicyCommand.d.ts +4 -3
- package/dist-types/commands/PutSubscriptionFilterCommand.d.ts +11 -12
- package/dist-types/commands/PutTransformerCommand.d.ts +24 -19
- package/dist-types/commands/StartLiveTailCommand.d.ts +27 -28
- package/dist-types/commands/StartQueryCommand.d.ts +28 -30
- package/dist-types/commands/StopQueryCommand.d.ts +3 -2
- package/dist-types/commands/TagLogGroupCommand.d.ts +10 -10
- package/dist-types/commands/TagResourceCommand.d.ts +11 -10
- package/dist-types/commands/TestTransformerCommand.d.ts +3 -2
- package/dist-types/commands/UntagLogGroupCommand.d.ts +6 -7
- package/dist-types/commands/UpdateAnomalyCommand.d.ts +10 -9
- package/dist-types/commands/UpdateDeliveryConfigurationCommand.d.ts +3 -3
- package/dist-types/index.d.ts +2 -2
- package/dist-types/models/models_0.d.ts +1441 -1201
- package/dist-types/ts3.4/models/models_0.d.ts +18 -1
- package/package.json +5 -5
|
@@ -27,8 +27,8 @@ declare const DeleteResourcePolicyCommand_base: {
|
|
|
27
27
|
getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
|
|
28
28
|
};
|
|
29
29
|
/**
|
|
30
|
-
* <p>Deletes a resource policy from this account. This revokes
|
|
31
|
-
*
|
|
30
|
+
* <p>Deletes a resource policy from this account. This revokes the access of the identities
|
|
31
|
+
* in that policy to put log events to this account.</p>
|
|
32
32
|
* @example
|
|
33
33
|
* Use a bare-bones client and the command you need to make an API call.
|
|
34
34
|
* ```javascript
|
|
@@ -37,6 +37,8 @@ declare const DeleteResourcePolicyCommand_base: {
|
|
|
37
37
|
* const client = new CloudWatchLogsClient(config);
|
|
38
38
|
* const input = { // DeleteResourcePolicyRequest
|
|
39
39
|
* policyName: "STRING_VALUE",
|
|
40
|
+
* resourceArn: "STRING_VALUE",
|
|
41
|
+
* expectedRevisionId: "STRING_VALUE",
|
|
40
42
|
* };
|
|
41
43
|
* const command = new DeleteResourcePolicyCommand(input);
|
|
42
44
|
* const response = await client.send(command);
|
|
@@ -53,6 +55,9 @@ declare const DeleteResourcePolicyCommand_base: {
|
|
|
53
55
|
* @throws {@link InvalidParameterException} (client fault)
|
|
54
56
|
* <p>A parameter is specified incorrectly.</p>
|
|
55
57
|
*
|
|
58
|
+
* @throws {@link OperationAbortedException} (client fault)
|
|
59
|
+
* <p>Multiple concurrent requests to update the same resource were in conflict.</p>
|
|
60
|
+
*
|
|
56
61
|
* @throws {@link ResourceNotFoundException} (client fault)
|
|
57
62
|
* <p>The specified resource does not exist.</p>
|
|
58
63
|
*
|
|
@@ -28,7 +28,8 @@ declare const DeleteRetentionPolicyCommand_base: {
|
|
|
28
28
|
};
|
|
29
29
|
/**
|
|
30
30
|
* <p>Deletes the specified retention policy.</p>
|
|
31
|
-
* <p>Log events do not expire if they belong to log groups without a retention
|
|
31
|
+
* <p>Log events do not expire if they belong to log groups without a retention
|
|
32
|
+
* policy.</p>
|
|
32
33
|
* @example
|
|
33
34
|
* Use a bare-bones client and the command you need to make an API call.
|
|
34
35
|
* ```javascript
|
|
@@ -27,12 +27,12 @@ declare const DeleteTransformerCommand_base: {
|
|
|
27
27
|
getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
|
|
28
28
|
};
|
|
29
29
|
/**
|
|
30
|
-
* <p>Deletes the log transformer for the specified log group. As soon as you do this,
|
|
31
|
-
*
|
|
32
|
-
* account-level transformer that applies to this log group, the log group begins
|
|
33
|
-
*
|
|
34
|
-
* <p>After you delete a transformer, be sure to edit any metric filters or subscription filters
|
|
35
|
-
*
|
|
30
|
+
* <p>Deletes the log transformer for the specified log group. As soon as you do this, the
|
|
31
|
+
* transformation of incoming log events according to that transformer stops. If this account has
|
|
32
|
+
* an account-level transformer that applies to this log group, the log group begins using that
|
|
33
|
+
* account-level transformer when this log-group level transformer is deleted.</p>
|
|
34
|
+
* <p>After you delete a transformer, be sure to edit any metric filters or subscription filters
|
|
35
|
+
* that relied on the transformed versions of the log events.</p>
|
|
36
36
|
* @example
|
|
37
37
|
* Use a bare-bones client and the command you need to make an API call.
|
|
38
38
|
* ```javascript
|
|
@@ -28,22 +28,26 @@ declare const DescribeAccountPoliciesCommand_base: {
|
|
|
28
28
|
};
|
|
29
29
|
/**
|
|
30
30
|
* <p>Returns a list of all CloudWatch Logs account policies in the account.</p>
|
|
31
|
-
* <p>To use this operation, you must be signed on with the correct permissions depending on the
|
|
31
|
+
* <p>To use this operation, you must be signed on with the correct permissions depending on the
|
|
32
|
+
* type of policy that you are retrieving information for.</p>
|
|
32
33
|
* <ul>
|
|
33
34
|
* <li>
|
|
34
|
-
* <p>To see data protection policies, you must have the
|
|
35
|
-
*
|
|
35
|
+
* <p>To see data protection policies, you must have the
|
|
36
|
+
* <code>logs:GetDataProtectionPolicy</code> and <code>logs:DescribeAccountPolicies</code>
|
|
37
|
+
* permissions.</p>
|
|
36
38
|
* </li>
|
|
37
39
|
* <li>
|
|
38
|
-
* <p>To see subscription filter policies, you must have the
|
|
39
|
-
*
|
|
40
|
+
* <p>To see subscription filter policies, you must have the
|
|
41
|
+
* <code>logs:DescribeSubscriptionFilters</code> and
|
|
42
|
+
* <code>logs:DescribeAccountPolicies</code> permissions.</p>
|
|
40
43
|
* </li>
|
|
41
44
|
* <li>
|
|
42
|
-
* <p>To see transformer policies, you must have the <code>logs:GetTransformer</code> and
|
|
45
|
+
* <p>To see transformer policies, you must have the <code>logs:GetTransformer</code> and
|
|
46
|
+
* <code>logs:DescribeAccountPolicies</code> permissions.</p>
|
|
43
47
|
* </li>
|
|
44
48
|
* <li>
|
|
45
|
-
* <p>To see field index policies, you must have the <code>logs:DescribeIndexPolicies</code>
|
|
46
|
-
*
|
|
49
|
+
* <p>To see field index policies, you must have the <code>logs:DescribeIndexPolicies</code>
|
|
50
|
+
* and <code>logs:DescribeAccountPolicies</code> permissions.</p>
|
|
47
51
|
* </li>
|
|
48
52
|
* </ul>
|
|
49
53
|
* @example
|
|
@@ -27,8 +27,9 @@ declare const DescribeConfigurationTemplatesCommand_base: {
|
|
|
27
27
|
getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
|
|
28
28
|
};
|
|
29
29
|
/**
|
|
30
|
-
* <p>Use this operation to return the valid and default values that are used when creating
|
|
31
|
-
*
|
|
30
|
+
* <p>Use this operation to return the valid and default values that are used when creating
|
|
31
|
+
* delivery sources, delivery destinations, and deliveries. For more information about
|
|
32
|
+
* deliveries, see <a href="https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_CreateDelivery.html">CreateDelivery</a>.</p>
|
|
32
33
|
* @example
|
|
33
34
|
* Use a bare-bones client and the command you need to make an API call.
|
|
34
35
|
* ```javascript
|
|
@@ -44,7 +45,7 @@ declare const DescribeConfigurationTemplatesCommand_base: {
|
|
|
44
45
|
* "STRING_VALUE",
|
|
45
46
|
* ],
|
|
46
47
|
* deliveryDestinationTypes: [ // DeliveryDestinationTypes
|
|
47
|
-
* "S3" || "CWL" || "FH",
|
|
48
|
+
* "S3" || "CWL" || "FH" || "XRAY",
|
|
48
49
|
* ],
|
|
49
50
|
* nextToken: "STRING_VALUE",
|
|
50
51
|
* limit: Number("int"),
|
|
@@ -57,7 +58,7 @@ declare const DescribeConfigurationTemplatesCommand_base: {
|
|
|
57
58
|
* // service: "STRING_VALUE",
|
|
58
59
|
* // logType: "STRING_VALUE",
|
|
59
60
|
* // resourceType: "STRING_VALUE",
|
|
60
|
-
* // deliveryDestinationType: "S3" || "CWL" || "FH",
|
|
61
|
+
* // deliveryDestinationType: "S3" || "CWL" || "FH" || "XRAY",
|
|
61
62
|
* // defaultDeliveryConfigValues: { // ConfigurationTemplateDeliveryConfigValues
|
|
62
63
|
* // recordFields: [ // RecordFields
|
|
63
64
|
* // "STRING_VALUE",
|
|
@@ -28,18 +28,16 @@ declare const DescribeDeliveriesCommand_base: {
|
|
|
28
28
|
};
|
|
29
29
|
/**
|
|
30
30
|
* <p>Retrieves a list of the deliveries that have been created in the account.</p>
|
|
31
|
-
* <p>A <i>delivery</i> is a
|
|
32
|
-
*
|
|
33
|
-
*
|
|
34
|
-
* </a> and a
|
|
35
|
-
* <a href="https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliveryDestination.html">
|
|
31
|
+
* <p>A <i>delivery</i> is a connection between a <a href="https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliverySource.html">
|
|
32
|
+
* <i>delivery
|
|
33
|
+
* source</i>
|
|
34
|
+
* </a> and a <a href="https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliveryDestination.html">
|
|
36
35
|
* <i>delivery destination</i>
|
|
37
36
|
* </a>.</p>
|
|
38
|
-
* <p>A delivery source represents an Amazon Web Services resource that sends logs to an logs
|
|
39
|
-
*
|
|
40
|
-
*
|
|
41
|
-
*
|
|
42
|
-
* services.</a>
|
|
37
|
+
* <p>A delivery source represents an Amazon Web Services resource that sends logs to an logs
|
|
38
|
+
* delivery destination. The destination can be CloudWatch Logs, Amazon S3, Firehose or X-Ray. Only some Amazon Web Services services support being configured as a delivery
|
|
39
|
+
* source. These services are listed in <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AWS-logs-and-resource-policy.html">Enable logging from
|
|
40
|
+
* Amazon Web Services services.</a>
|
|
43
41
|
* </p>
|
|
44
42
|
* @example
|
|
45
43
|
* Use a bare-bones client and the command you need to make an API call.
|
|
@@ -60,7 +58,7 @@ declare const DescribeDeliveriesCommand_base: {
|
|
|
60
58
|
* // arn: "STRING_VALUE",
|
|
61
59
|
* // deliverySourceName: "STRING_VALUE",
|
|
62
60
|
* // deliveryDestinationArn: "STRING_VALUE",
|
|
63
|
-
* // deliveryDestinationType: "S3" || "CWL" || "FH",
|
|
61
|
+
* // deliveryDestinationType: "S3" || "CWL" || "FH" || "XRAY",
|
|
64
62
|
* // recordFields: [ // RecordFields
|
|
65
63
|
* // "STRING_VALUE",
|
|
66
64
|
* // ],
|
|
@@ -27,7 +27,8 @@ declare const DescribeDeliveryDestinationsCommand_base: {
|
|
|
27
27
|
getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
|
|
28
28
|
};
|
|
29
29
|
/**
|
|
30
|
-
* <p>Retrieves a list of the delivery destinations that have been created in the
|
|
30
|
+
* <p>Retrieves a list of the delivery destinations that have been created in the
|
|
31
|
+
* account.</p>
|
|
31
32
|
* @example
|
|
32
33
|
* Use a bare-bones client and the command you need to make an API call.
|
|
33
34
|
* ```javascript
|
|
@@ -45,7 +46,7 @@ declare const DescribeDeliveryDestinationsCommand_base: {
|
|
|
45
46
|
* // { // DeliveryDestination
|
|
46
47
|
* // name: "STRING_VALUE",
|
|
47
48
|
* // arn: "STRING_VALUE",
|
|
48
|
-
* // deliveryDestinationType: "S3" || "CWL" || "FH",
|
|
49
|
+
* // deliveryDestinationType: "S3" || "CWL" || "FH" || "XRAY",
|
|
49
50
|
* // outputFormat: "json" || "plain" || "w3c" || "raw" || "parquet",
|
|
50
51
|
* // deliveryDestinationConfiguration: { // DeliveryDestinationConfiguration
|
|
51
52
|
* // destinationResourceArn: "STRING_VALUE", // required
|
|
@@ -27,7 +27,8 @@ declare const DescribeDestinationsCommand_base: {
|
|
|
27
27
|
getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
|
|
28
28
|
};
|
|
29
29
|
/**
|
|
30
|
-
* <p>Lists all your destinations. The results are ASCII-sorted by destination
|
|
30
|
+
* <p>Lists all your destinations. The results are ASCII-sorted by destination
|
|
31
|
+
* name.</p>
|
|
31
32
|
* @example
|
|
32
33
|
* Use a bare-bones client and the command you need to make an API call.
|
|
33
34
|
* ```javascript
|
|
@@ -27,8 +27,8 @@ declare const DescribeExportTasksCommand_base: {
|
|
|
27
27
|
getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
|
|
28
28
|
};
|
|
29
29
|
/**
|
|
30
|
-
* <p>Lists the specified export tasks. You can list all your export tasks or filter
|
|
31
|
-
*
|
|
30
|
+
* <p>Lists the specified export tasks. You can list all your export tasks or filter the
|
|
31
|
+
* results based on task ID or task status.</p>
|
|
32
32
|
* @example
|
|
33
33
|
* Use a bare-bones client and the command you need to make an API call.
|
|
34
34
|
* ```javascript
|
|
@@ -27,9 +27,8 @@ declare const DescribeFieldIndexesCommand_base: {
|
|
|
27
27
|
getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
|
|
28
28
|
};
|
|
29
29
|
/**
|
|
30
|
-
* <p>Returns a list of field indexes listed in the field index policies of
|
|
31
|
-
*
|
|
32
|
-
* <a href="https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutIndexPolicy.html">PutIndexPolicy</a>.</p>
|
|
30
|
+
* <p>Returns a list of field indexes listed in the field index policies of one or more log
|
|
31
|
+
* groups. For more information about field index policies, see <a href="https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutIndexPolicy.html">PutIndexPolicy</a>.</p>
|
|
33
32
|
* @example
|
|
34
33
|
* Use a bare-bones client and the command you need to make an API call.
|
|
35
34
|
* ```javascript
|
|
@@ -27,12 +27,12 @@ declare const DescribeIndexPoliciesCommand_base: {
|
|
|
27
27
|
getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
|
|
28
28
|
};
|
|
29
29
|
/**
|
|
30
|
-
* <p>Returns the field index policies of
|
|
31
|
-
*
|
|
32
|
-
*
|
|
33
|
-
*
|
|
34
|
-
* <p>If a specified log group doesn't have a log-group level index policy, but an account-wide
|
|
35
|
-
* that account-wide policy is returned by this operation.</p>
|
|
30
|
+
* <p>Returns the field index policies of one or more log groups. For more information about
|
|
31
|
+
* field index policies, see <a href="https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutIndexPolicy.html">PutIndexPolicy</a>.</p>
|
|
32
|
+
* <p>If a specified log group has a log-group level index policy, that policy is returned by
|
|
33
|
+
* this operation.</p>
|
|
34
|
+
* <p>If a specified log group doesn't have a log-group level index policy, but an account-wide
|
|
35
|
+
* index policy applies to it, that account-wide policy is returned by this operation.</p>
|
|
36
36
|
* <p>To find information about only account-level policies, use <a href="https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DescribeAccountPolicies.html">DescribeAccountPolicies</a> instead.</p>
|
|
37
37
|
* @example
|
|
38
38
|
* Use a bare-bones client and the command you need to make an API call.
|
|
@@ -27,18 +27,20 @@ declare const DescribeLogGroupsCommand_base: {
|
|
|
27
27
|
getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
|
|
28
28
|
};
|
|
29
29
|
/**
|
|
30
|
-
* <p>Returns information about log groups. You can return all your log groups or filter the
|
|
31
|
-
* The results are ASCII-sorted by log group name.</p>
|
|
32
|
-
* <p>CloudWatch Logs doesn't support IAM policies that control access to the
|
|
33
|
-
*
|
|
34
|
-
*
|
|
35
|
-
*
|
|
30
|
+
* <p>Returns information about log groups. You can return all your log groups or filter the
|
|
31
|
+
* results by prefix. The results are ASCII-sorted by log group name.</p>
|
|
32
|
+
* <p>CloudWatch Logs doesn't support IAM policies that control access to the
|
|
33
|
+
* <code>DescribeLogGroups</code> action by using the
|
|
34
|
+
* <code>aws:ResourceTag/<i>key-name</i>
|
|
35
|
+
* </code> condition key. Other CloudWatch
|
|
36
|
+
* Logs actions do support the use of the
|
|
37
|
+
* <code>aws:ResourceTag/<i>key-name</i>
|
|
36
38
|
* </code> condition key to control access.
|
|
37
|
-
* For more information about using tags to control access, see
|
|
38
|
-
*
|
|
39
|
-
* <p>If you are using CloudWatch cross-account observability, you can use this operation
|
|
40
|
-
*
|
|
41
|
-
* <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html">CloudWatch cross-account observability</a>.</p>
|
|
39
|
+
* For more information about using tags to control access, see <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html">Controlling access to Amazon Web Services
|
|
40
|
+
* resources using tags</a>.</p>
|
|
41
|
+
* <p>If you are using CloudWatch cross-account observability, you can use this operation
|
|
42
|
+
* in a monitoring account and view data from the linked source accounts. For more information,
|
|
43
|
+
* see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html">CloudWatch cross-account observability</a>.</p>
|
|
42
44
|
* @example
|
|
43
45
|
* Use a bare-bones client and the command you need to make an API call.
|
|
44
46
|
* ```javascript
|
|
@@ -27,16 +27,16 @@ declare const DescribeLogStreamsCommand_base: {
|
|
|
27
27
|
getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
|
|
28
28
|
};
|
|
29
29
|
/**
|
|
30
|
-
* <p>Lists the log streams for the specified log group.
|
|
31
|
-
*
|
|
32
|
-
*
|
|
33
|
-
*
|
|
34
|
-
*
|
|
35
|
-
*
|
|
36
|
-
*
|
|
37
|
-
* <p>If you are using CloudWatch cross-account observability, you can use this operation
|
|
38
|
-
* view data from the linked source accounts. For more information,
|
|
39
|
-
* <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html">CloudWatch cross-account observability</a>.</p>
|
|
30
|
+
* <p>Lists the log streams for the specified log group. You can list all the log streams or
|
|
31
|
+
* filter the results by prefix. You can also control how the results are ordered.</p>
|
|
32
|
+
* <p>You can specify the log group to search by using either <code>logGroupIdentifier</code> or
|
|
33
|
+
* <code>logGroupName</code>. You must include one of these two parameters, but you can't
|
|
34
|
+
* include both. </p>
|
|
35
|
+
* <p>This operation has a limit of 25 transactions per second, after which transactions are
|
|
36
|
+
* throttled.</p>
|
|
37
|
+
* <p>If you are using CloudWatch cross-account observability, you can use this operation
|
|
38
|
+
* in a monitoring account and view data from the linked source accounts. For more information,
|
|
39
|
+
* see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html">CloudWatch cross-account observability</a>.</p>
|
|
40
40
|
* @example
|
|
41
41
|
* Use a bare-bones client and the command you need to make an API call.
|
|
42
42
|
* ```javascript
|
|
@@ -27,10 +27,11 @@ declare const DescribeQueryDefinitionsCommand_base: {
|
|
|
27
27
|
getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
|
|
28
28
|
};
|
|
29
29
|
/**
|
|
30
|
-
* <p>This operation returns a paginated list of your saved CloudWatch Logs Insights query
|
|
31
|
-
*
|
|
32
|
-
*
|
|
33
|
-
*
|
|
30
|
+
* <p>This operation returns a paginated list of your saved CloudWatch Logs Insights query
|
|
31
|
+
* definitions. You can retrieve query definitions from the current account or from a source
|
|
32
|
+
* account that is linked to the current account.</p>
|
|
33
|
+
* <p>You can use the <code>queryDefinitionNamePrefix</code> parameter to limit the results to
|
|
34
|
+
* only the query definitions that have names that start with a certain string.</p>
|
|
34
35
|
* @example
|
|
35
36
|
* Use a bare-bones client and the command you need to make an API call.
|
|
36
37
|
* ```javascript
|
|
@@ -37,6 +37,8 @@ declare const DescribeResourcePoliciesCommand_base: {
|
|
|
37
37
|
* const input = { // DescribeResourcePoliciesRequest
|
|
38
38
|
* nextToken: "STRING_VALUE",
|
|
39
39
|
* limit: Number("int"),
|
|
40
|
+
* resourceArn: "STRING_VALUE",
|
|
41
|
+
* policyScope: "ACCOUNT" || "RESOURCE",
|
|
40
42
|
* };
|
|
41
43
|
* const command = new DescribeResourcePoliciesCommand(input);
|
|
42
44
|
* const response = await client.send(command);
|
|
@@ -46,6 +48,9 @@ declare const DescribeResourcePoliciesCommand_base: {
|
|
|
46
48
|
* // policyName: "STRING_VALUE",
|
|
47
49
|
* // policyDocument: "STRING_VALUE",
|
|
48
50
|
* // lastUpdatedTime: Number("long"),
|
|
51
|
+
* // policyScope: "ACCOUNT" || "RESOURCE",
|
|
52
|
+
* // resourceArn: "STRING_VALUE",
|
|
53
|
+
* // revisionId: "STRING_VALUE",
|
|
49
54
|
* // },
|
|
50
55
|
* // ],
|
|
51
56
|
* // nextToken: "STRING_VALUE",
|
|
@@ -27,8 +27,9 @@ declare const DescribeSubscriptionFiltersCommand_base: {
|
|
|
27
27
|
getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
|
|
28
28
|
};
|
|
29
29
|
/**
|
|
30
|
-
* <p>Lists the subscription filters for the specified log group. You can list all the
|
|
31
|
-
* The results are ASCII-sorted by filter
|
|
30
|
+
* <p>Lists the subscription filters for the specified log group. You can list all the
|
|
31
|
+
* subscription filters or filter the results by prefix. The results are ASCII-sorted by filter
|
|
32
|
+
* name.</p>
|
|
32
33
|
* @example
|
|
33
34
|
* Use a bare-bones client and the command you need to make an API call.
|
|
34
35
|
* ```javascript
|
|
@@ -27,23 +27,23 @@ declare const DisassociateKmsKeyCommand_base: {
|
|
|
27
27
|
getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
|
|
28
28
|
};
|
|
29
29
|
/**
|
|
30
|
-
* <p>Disassociates the specified KMS key from the specified log
|
|
31
|
-
*
|
|
32
|
-
* <p>When you use <code>DisassociateKmsKey</code>, you specify either the
|
|
33
|
-
*
|
|
30
|
+
* <p>Disassociates the specified KMS key from the specified log group or
|
|
31
|
+
* from all CloudWatch Logs Insights query results in the account.</p>
|
|
32
|
+
* <p>When you use <code>DisassociateKmsKey</code>, you specify either the
|
|
33
|
+
* <code>logGroupName</code> parameter or the <code>resourceIdentifier</code> parameter. You
|
|
34
|
+
* can't specify both of those parameters in the same operation.</p>
|
|
34
35
|
* <ul>
|
|
35
36
|
* <li>
|
|
36
|
-
* <p>Specify the <code>logGroupName</code> parameter to stop using the KMS key
|
|
37
|
-
*
|
|
38
|
-
*
|
|
39
|
-
*
|
|
40
|
-
*
|
|
41
|
-
* accessed.</p>
|
|
37
|
+
* <p>Specify the <code>logGroupName</code> parameter to stop using the KMS key to encrypt future log events ingested and stored in the log group.
|
|
38
|
+
* Instead, they will be encrypted with the default CloudWatch Logs method. The log events
|
|
39
|
+
* that were ingested while the key was associated with the log group are still encrypted
|
|
40
|
+
* with that key. Therefore, CloudWatch Logs will need permissions for the key whenever
|
|
41
|
+
* that data is accessed.</p>
|
|
42
42
|
* </li>
|
|
43
43
|
* <li>
|
|
44
|
-
* <p>Specify the <code>resourceIdentifier</code> parameter with the
|
|
45
|
-
*
|
|
46
|
-
* future <a href="https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_StartQuery.html">StartQuery</a>
|
|
44
|
+
* <p>Specify the <code>resourceIdentifier</code> parameter with the
|
|
45
|
+
* <code>query-result</code> resource to stop using the KMS key to
|
|
46
|
+
* encrypt the results of all future <a href="https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_StartQuery.html">StartQuery</a>
|
|
47
47
|
* operations in the account. They will instead be encrypted with the default CloudWatch Logs method. The results from queries that ran while the key was associated with
|
|
48
48
|
* the account are still encrypted with that key. Therefore, CloudWatch Logs will need
|
|
49
49
|
* permissions for the key whenever that data is accessed.</p>
|
|
@@ -27,8 +27,8 @@ declare const FilterLogEventsCommand_base: {
|
|
|
27
27
|
getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
|
|
28
28
|
};
|
|
29
29
|
/**
|
|
30
|
-
* <p>Lists log events from the specified log group. You can list all the log events or
|
|
31
|
-
* using one or more of the following:</p>
|
|
30
|
+
* <p>Lists log events from the specified log group. You can list all the log events or
|
|
31
|
+
* filter the results using one or more of the following:</p>
|
|
32
32
|
* <ul>
|
|
33
33
|
* <li>
|
|
34
34
|
* <p>A filter pattern</p>
|
|
@@ -37,28 +37,39 @@ declare const FilterLogEventsCommand_base: {
|
|
|
37
37
|
* <p>A time range</p>
|
|
38
38
|
* </li>
|
|
39
39
|
* <li>
|
|
40
|
-
* <p>The log stream name, or a log stream name prefix that matches mutltiple log
|
|
40
|
+
* <p>The log stream name, or a log stream name prefix that matches mutltiple log
|
|
41
|
+
* streams</p>
|
|
41
42
|
* </li>
|
|
42
43
|
* </ul>
|
|
43
|
-
* <p>You must have the <code>logs:FilterLogEvents</code> permission to perform this
|
|
44
|
-
*
|
|
45
|
-
*
|
|
46
|
-
*
|
|
44
|
+
* <p>You must have the <code>logs:FilterLogEvents</code> permission to perform this
|
|
45
|
+
* operation.</p>
|
|
46
|
+
* <p>You can specify the log group to search by using either <code>logGroupIdentifier</code> or
|
|
47
|
+
* <code>logGroupName</code>. You must include one of these two parameters, but you can't
|
|
48
|
+
* include both. </p>
|
|
47
49
|
* <p>
|
|
48
|
-
* <code>FilterLogEvents</code> is a paginated operation. Each page returned can contain up
|
|
49
|
-
*
|
|
50
|
-
*
|
|
51
|
-
*
|
|
52
|
-
*
|
|
53
|
-
*
|
|
54
|
-
*
|
|
55
|
-
*
|
|
56
|
-
*
|
|
57
|
-
*
|
|
58
|
-
*
|
|
50
|
+
* <code>FilterLogEvents</code> is a paginated operation. Each page returned can contain up
|
|
51
|
+
* to 1 MB of log events or up to 10,000 log events. A returned page might only be partially
|
|
52
|
+
* full, or even empty. For example, if the result of a query would return 15,000 log events, the
|
|
53
|
+
* first page isn't guaranteed to have 10,000 log events even if they all fit into 1 MB.</p>
|
|
54
|
+
* <p>Partially full or empty pages don't necessarily mean that pagination is finished. If the
|
|
55
|
+
* results include a <code>nextToken</code>, there might be more log events available. You can
|
|
56
|
+
* return these additional log events by providing the nextToken in a subsequent
|
|
57
|
+
* <code>FilterLogEvents</code> operation. If the results don't include a
|
|
58
|
+
* <code>nextToken</code>, then pagination is finished. </p>
|
|
59
|
+
* <p>Specifying the <code>limit</code> parameter only guarantees that a single page doesn't
|
|
60
|
+
* return more log events than the specified limit, but it might return fewer events than the
|
|
61
|
+
* limit. This is the expected API behavior.</p>
|
|
62
|
+
* <p>The returned log events are sorted by event timestamp, the timestamp when the event was
|
|
63
|
+
* ingested by CloudWatch Logs, and the ID of the <code>PutLogEvents</code> request.</p>
|
|
64
|
+
* <p>If you are using CloudWatch cross-account observability, you can use this operation
|
|
65
|
+
* in a monitoring account and view data from the linked source accounts. For more information,
|
|
66
|
+
* see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html">CloudWatch cross-account observability</a>.</p>
|
|
59
67
|
* <note>
|
|
60
|
-
* <p>If you are using <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CloudWatch-Logs-Transformation.html">log
|
|
61
|
-
*
|
|
68
|
+
* <p>If you are using <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CloudWatch-Logs-Transformation.html">log
|
|
69
|
+
* transformation</a>, the <code>FilterLogEvents</code> operation returns only the
|
|
70
|
+
* original versions of log events, before they were transformed. To view the transformed
|
|
71
|
+
* versions, you must use a <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AnalyzingLogData.html">CloudWatch Logs
|
|
72
|
+
* query.</a>
|
|
62
73
|
* </p>
|
|
63
74
|
* </note>
|
|
64
75
|
* @example
|
|
@@ -27,21 +27,20 @@ declare const GetDeliveryCommand_base: {
|
|
|
27
27
|
getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
|
|
28
28
|
};
|
|
29
29
|
/**
|
|
30
|
-
* <p>Returns complete information about one logical <i>delivery</i>. A delivery
|
|
31
|
-
*
|
|
32
|
-
* <i>delivery
|
|
33
|
-
*
|
|
34
|
-
*
|
|
30
|
+
* <p>Returns complete information about one logical <i>delivery</i>. A delivery
|
|
31
|
+
* is a connection between a <a href="https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliverySource.html">
|
|
32
|
+
* <i>delivery
|
|
33
|
+
* source</i>
|
|
34
|
+
* </a> and a <a href="https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliveryDestination.html">
|
|
35
35
|
* <i>delivery destination</i>
|
|
36
36
|
* </a>.</p>
|
|
37
|
-
* <p>A delivery source represents an Amazon Web Services resource that sends logs to an logs
|
|
38
|
-
*
|
|
39
|
-
*
|
|
40
|
-
*
|
|
41
|
-
* services.</a>
|
|
37
|
+
* <p>A delivery source represents an Amazon Web Services resource that sends logs to an logs
|
|
38
|
+
* delivery destination. The destination can be CloudWatch Logs, Amazon S3, or Firehose. Only some Amazon Web Services services support being configured as a delivery
|
|
39
|
+
* source. These services are listed in <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AWS-logs-and-resource-policy.html">Enable logging from
|
|
40
|
+
* Amazon Web Services services.</a>
|
|
42
41
|
* </p>
|
|
43
|
-
* <p>You need to specify the delivery <code>id</code> in this operation. You can find the IDs
|
|
44
|
-
*
|
|
42
|
+
* <p>You need to specify the delivery <code>id</code> in this operation. You can find the IDs
|
|
43
|
+
* of the deliveries in your account with the <a href="https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DescribeDeliveries.html">DescribeDeliveries</a> operation.</p>
|
|
45
44
|
* @example
|
|
46
45
|
* Use a bare-bones client and the command you need to make an API call.
|
|
47
46
|
* ```javascript
|
|
@@ -59,7 +58,7 @@ declare const GetDeliveryCommand_base: {
|
|
|
59
58
|
* // arn: "STRING_VALUE",
|
|
60
59
|
* // deliverySourceName: "STRING_VALUE",
|
|
61
60
|
* // deliveryDestinationArn: "STRING_VALUE",
|
|
62
|
-
* // deliveryDestinationType: "S3" || "CWL" || "FH",
|
|
61
|
+
* // deliveryDestinationType: "S3" || "CWL" || "FH" || "XRAY",
|
|
63
62
|
* // recordFields: [ // RecordFields
|
|
64
63
|
* // "STRING_VALUE",
|
|
65
64
|
* // ],
|
|
@@ -43,7 +43,7 @@ declare const GetDeliveryDestinationCommand_base: {
|
|
|
43
43
|
* // deliveryDestination: { // DeliveryDestination
|
|
44
44
|
* // name: "STRING_VALUE",
|
|
45
45
|
* // arn: "STRING_VALUE",
|
|
46
|
-
* // deliveryDestinationType: "S3" || "CWL" || "FH",
|
|
46
|
+
* // deliveryDestinationType: "S3" || "CWL" || "FH" || "XRAY",
|
|
47
47
|
* // outputFormat: "json" || "plain" || "w3c" || "raw" || "parquet",
|
|
48
48
|
* // deliveryDestinationConfiguration: { // DeliveryDestinationConfiguration
|
|
49
49
|
* // destinationResourceArn: "STRING_VALUE", // required
|
|
@@ -27,9 +27,8 @@ declare const GetDeliveryDestinationPolicyCommand_base: {
|
|
|
27
27
|
getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
|
|
28
28
|
};
|
|
29
29
|
/**
|
|
30
|
-
* <p>Retrieves the delivery destination policy assigned to the delivery destination that you
|
|
31
|
-
* For more information about delivery destinations and their policies, see
|
|
32
|
-
* <a href="https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliveryDestinationPolicy.html">PutDeliveryDestinationPolicy</a>.</p>
|
|
30
|
+
* <p>Retrieves the delivery destination policy assigned to the delivery destination that you
|
|
31
|
+
* specify. For more information about delivery destinations and their policies, see <a href="https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliveryDestinationPolicy.html">PutDeliveryDestinationPolicy</a>.</p>
|
|
33
32
|
* @example
|
|
34
33
|
* Use a bare-bones client and the command you need to make an API call.
|
|
35
34
|
* ```javascript
|