@aws-sdk/client-cloudwatch-logs 3.507.0 → 3.509.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.
@@ -40,6 +40,10 @@ declare const CreateLogGroupCommand_base: {
40
40
  * <p>Log group names consist of the following characters: a-z, A-Z, 0-9, '_' (underscore), '-' (hyphen),
41
41
  * '/' (forward slash), '.' (period), and '#' (number sign)</p>
42
42
  * </li>
43
+ * <li>
44
+ * <p>Log group names can't start with the string <code>aws/</code>
45
+ * </p>
46
+ * </li>
43
47
  * </ul>
44
48
  * <p>When you create a log group, by default the log events in the log group do not expire.
45
49
  * To set a retention policy so that events expire and are deleted after a specified time, use
@@ -27,6 +27,19 @@ declare const DescribeDeliveriesCommand_base: {
27
27
  /**
28
28
  * @public
29
29
  * <p>Retrieves a list of the deliveries that have been created in the account.</p>
30
+ * <p>A <i>delivery</i> is a
31
+ * connection between a <a href="https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliverySource.html">
32
+ * <i>delivery source</i>
33
+ * </a> and a
34
+ * <a href="https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliveryDestination.html">
35
+ * <i>delivery destination</i>
36
+ * </a>.</p>
37
+ * <p>A delivery source represents an Amazon Web Services resource that sends logs to an logs delivery destination.
38
+ * The destination can be CloudWatch Logs, Amazon S3, or Kinesis Data Firehose.
39
+ * Only some Amazon Web Services services support being configured as a delivery source. These services are listed
40
+ * in <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AWS-logs-and-resource-policy.html">Enable logging from Amazon Web Services
41
+ * services.</a>
42
+ * </p>
30
43
  * @example
31
44
  * Use a bare-bones client and the command you need to make an API call.
32
45
  * ```javascript
@@ -72,6 +72,7 @@ declare const DescribeLogGroupsCommand_base: {
72
72
  * // "ACCOUNT_DATA_PROTECTION",
73
73
  * // ],
74
74
  * // logGroupClass: "STANDARD" || "INFREQUENT_ACCESS",
75
+ * // logGroupArn: "STRING_VALUE",
75
76
  * // },
76
77
  * // ],
77
78
  * // nextToken: "STRING_VALUE",
@@ -26,8 +26,18 @@ declare const GetDeliveryCommand_base: {
26
26
  };
27
27
  /**
28
28
  * @public
29
- * <p>Returns complete information about one <i>delivery</i>. A delivery is a connection between a logical <i>delivery source</i> and a logical
30
- * <i>delivery destination</i>
29
+ * <p>Returns complete information about one logical <i>delivery</i>. A delivery is a
30
+ * connection between a <a href="https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliverySource.html">
31
+ * <i>delivery source</i>
32
+ * </a> and a
33
+ * <a href="https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliveryDestination.html">
34
+ * <i>delivery destination</i>
35
+ * </a>.</p>
36
+ * <p>A delivery source represents an Amazon Web Services resource that sends logs to an logs delivery destination.
37
+ * The destination can be CloudWatch Logs, Amazon S3, or Kinesis Data Firehose.
38
+ * Only some Amazon Web Services services support being configured as a delivery source. These services are listed
39
+ * in <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AWS-logs-and-resource-policy.html">Enable logging from Amazon Web Services
40
+ * services.</a>
31
41
  * </p>
32
42
  * <p>You need to specify the delivery <code>id</code> in this operation. You can find the IDs of the deliveries in your account with the
33
43
  * <a href="https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DescribeDeliveries.html">DescribeDeliveries</a> operation.</p>
@@ -1662,7 +1662,10 @@ export interface LogGroup {
1662
1662
  metricFilterCount?: number;
1663
1663
  /**
1664
1664
  * @public
1665
- * <p>The Amazon Resource Name (ARN) of the log group.</p>
1665
+ * <p>The Amazon Resource Name (ARN) of the log group. This version of the ARN includes a trailing <code>:*</code> after the log group name. </p>
1666
+ * <p>Use this version to refer to the ARN in IAM policies when specifying permissions for most API actions. The exception is when specifying permissions for <a href="https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_TagResource.html">TagResource</a>, <a href="https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_UntagResource.html">UntagResource</a>, and
1667
+ * <a href="https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_ListTagsForResource.html">ListTagsForResource</a>.
1668
+ * The permissions for those three actions require the ARN version that doesn't include a trailing <code>:*</code>.</p>
1666
1669
  */
1667
1670
  arn?: string;
1668
1671
  /**
@@ -1705,6 +1708,24 @@ export interface LogGroup {
1705
1708
  * </p>
1706
1709
  */
1707
1710
  logGroupClass?: LogGroupClass;
1711
+ /**
1712
+ * @public
1713
+ * <p>The Amazon Resource Name (ARN) of the log group. This version of the ARN doesn't include a trailing <code>:*</code> after the log group name. </p>
1714
+ * <p>Use this version to refer to the ARN in the following situations:</p>
1715
+ * <ul>
1716
+ * <li>
1717
+ * <p>In the <code>logGroupIdentifier</code> input field in many CloudWatch Logs APIs.</p>
1718
+ * </li>
1719
+ * <li>
1720
+ * <p>In the <code>resourceArn</code> field in tagging APIs</p>
1721
+ * </li>
1722
+ * <li>
1723
+ * <p>In IAM policies, when specifying permissions for <a href="https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_TagResource.html">TagResource</a>, <a href="https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_UntagResource.html">UntagResource</a>, and
1724
+ * <a href="https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_ListTagsForResource.html">ListTagsForResource</a>.</p>
1725
+ * </li>
1726
+ * </ul>
1727
+ */
1728
+ logGroupArn?: string;
1708
1729
  }
1709
1730
  /**
1710
1731
  * @public
@@ -3647,8 +3668,8 @@ export interface PutDeliverySourceRequest {
3647
3668
  resourceArn: string | undefined;
3648
3669
  /**
3649
3670
  * @public
3650
- * <p>Defines the type of log that the source is sending. For valid values for this parameter, see the documentation for
3651
- * the source service.</p>
3671
+ * <p>Defines the type of log that the source is sending. For Amazon CodeWhisperer, the valid value is
3672
+ * <code>EVENT_LOGS</code>.</p>
3652
3673
  */
3653
3674
  logType: string | undefined;
3654
3675
  /**
@@ -443,6 +443,7 @@ export interface LogGroup {
443
443
  dataProtectionStatus?: DataProtectionStatus;
444
444
  inheritedProperties?: InheritedProperty[];
445
445
  logGroupClass?: LogGroupClass;
446
+ logGroupArn?: string;
446
447
  }
447
448
  export interface DescribeLogGroupsResponse {
448
449
  logGroups?: LogGroup[];
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@aws-sdk/client-cloudwatch-logs",
3
3
  "description": "AWS SDK for JavaScript Cloudwatch Logs Client for Node.js, Browser and React Native",
4
- "version": "3.507.0",
4
+ "version": "3.509.0",
5
5
  "scripts": {
6
6
  "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
7
7
  "build:cjs": "node ../../scripts/compilation/inline client-cloudwatch-logs",
@@ -22,7 +22,7 @@
22
22
  "@aws-crypto/sha256-js": "3.0.0",
23
23
  "@aws-sdk/client-sts": "3.507.0",
24
24
  "@aws-sdk/core": "3.496.0",
25
- "@aws-sdk/credential-provider-node": "3.507.0",
25
+ "@aws-sdk/credential-provider-node": "3.509.0",
26
26
  "@aws-sdk/middleware-host-header": "3.502.0",
27
27
  "@aws-sdk/middleware-logger": "3.502.0",
28
28
  "@aws-sdk/middleware-recursion-detection": "3.502.0",