feat(client-cloudwatch): Adds cross-account support to the GetMetricData API. Adds cross-account support to the ListMetrics API through the usage of the IncludeLinkedAccounts flag and the new OwningAccounts field.

Author: awstools

clients/client-cloudwatch/src/CloudWatch.ts

@@ -216,7 +216,7 @@ export class CloudWatch extends CloudWatchClient {
    * 			because there is always still a composite alarm that depends on that alarm that you want to delete.</p>
    * 			         <p>To get out of such a situation, you must
    * 				break the cycle by changing the rule of one of the composite alarms in the cycle to remove a dependency that creates the cycle. The simplest
-   * 				change to make to break a cycle is to change the <code>AlarmRule</code> of one of the alarms to <code>False</code>. </p>
+   * 				change to make to break a cycle is to change the <code>AlarmRule</code> of one of the alarms to <code>false</code>. </p>
    * 			         <p>Additionally, the evaluation of composite alarms stops if CloudWatch detects a cycle in the evaluation path.
    * 			</p>
    *          </note>
@@ -1128,14 +1128,15 @@ export class CloudWatch extends CloudWatchClient {
   }
 
   /**
-   * <p>List the specified metrics. You can use the returned metrics with
-   * 			<a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_GetMetricData.html">GetMetricData</a> or
-   * 			<a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_GetMetricStatistics.html">GetMetricStatistics</a> to obtain statistical data.</p>
+   * <p>List the specified metrics. You can use the returned metrics with <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_GetMetricData.html">GetMetricData</a> or <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_GetMetricStatistics.html">GetMetricStatistics</a> to get statistical data.</p>
    * 		       <p>Up to 500 results are returned for any one call. To retrieve additional results,
    * 			use the returned token with subsequent calls.</p>
-   * 		       <p>After you create a metric, allow up to 15 minutes before the metric appears.
-   * 			You can see statistics about the metric sooner by using <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_GetMetricData.html">GetMetricData</a> or
-   * 			<a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_GetMetricStatistics.html">GetMetricStatistics</a>.</p>
+   * 		       <p>After you create a metric, allow up to 15 minutes for the metric to appear. To see metric
+   * 			statistics sooner, use <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_GetMetricData.html">GetMetricData</a> or <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_GetMetricStatistics.html">GetMetricStatistics</a>.</p>
+   *
+   * 		       <p>If you are using CloudWatch cross-account observability, you can use this operation in a monitoring account and
+   * 			view metrics from the linked source accounts. For more information, see
+   * 			<a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html">CloudWatch cross-account observability</a>.</p>
    *
    * 	        <p>
    *             <code>ListMetrics</code> doesn't return information about metrics if those metrics haven't
@@ -1288,7 +1289,7 @@ export class CloudWatch extends CloudWatchClient {
    * 			because there is always still a composite alarm that depends on that alarm that you want to delete.</p>
    * 			         <p>To get out of such a situation, you must
    * 			break the cycle by changing the rule of one of the composite alarms in the cycle to remove a dependency that creates the cycle. The simplest
-   * 			change to make to break a cycle is to change the <code>AlarmRule</code> of one of the alarms to <code>False</code>. </p>
+   * 			change to make to break a cycle is to change the <code>AlarmRule</code> of one of the alarms to <code>false</code>. </p>
    * 			         <p>Additionally, the evaluation of composite alarms stops if CloudWatch detects a cycle in the evaluation path.
    * 		</p>
    *          </note>
@@ -1635,16 +1636,15 @@ export class CloudWatch extends CloudWatchClient {
   }
 
   /**
-   * <p>Creates or updates a metric stream. Metric streams can automatically stream CloudWatch metrics
-   * 			to Amazon Web Services destinations including
-   * 			Amazon S3 and to many third-party solutions.</p>
+   * <p>Creates or updates a metric stream. Metric streams can automatically stream CloudWatch
+   * 			metrics to Amazon Web Services destinations, including Amazon S3, and to many third-party
+   * 			solutions.</p>
    * 		       <p>For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Metric-Streams.html">
    * 		Using Metric Streams</a>.</p>
-   * 		       <p>To create a metric stream,
-   * 			you must be logged on to an account that has the <code>iam:PassRole</code> permission
-   * 			and either the <code>CloudWatchFullAccess</code>
-   * 		policy or the <code>cloudwatch:PutMetricStream</code>
-   * 		permission.</p>
+   * 		       <p>To create a metric stream, you must be signed in to an account that has the
+   * 				<code>iam:PassRole</code> permission and either the
+   * 				<code>CloudWatchFullAccess</code> policy or the
+   * 				<code>cloudwatch:PutMetricStream</code> permission.</p>
    * 		       <p>When you create or update a metric stream, you choose one of the following:</p>
    * 		       <ul>
    *             <li>
@@ -1660,11 +1660,11 @@ export class CloudWatch extends CloudWatchClient {
    *             </li>
    *          </ul>
    *
-   * 		       <p>By default, a metric stream always sends the <code>MAX</code>, <code>MIN</code>, <code>SUM</code>,
-   * 			and <code>SAMPLECOUNT</code> statistics for each metric that is streamed. You can use the
-   * 			<code>StatisticsConfigurations</code> parameter to have
-   * 			the metric stream also send additional statistics in the stream. Streaming additional statistics incurs
-   * 			additional costs. For more information, see <a href="https://aws.amazon.com/cloudwatch/pricing/">Amazon CloudWatch Pricing</a>. </p>
+   * 		       <p>By default, a metric stream always sends the <code>MAX</code>, <code>MIN</code>,
+   * 				<code>SUM</code>, and <code>SAMPLECOUNT</code> statistics for each metric that is
+   * 			streamed. You can use the <code>StatisticsConfigurations</code> parameter to have the
+   * 			metric stream send additional statistics in the stream. Streaming additional statistics
+   * 			incurs additional costs. For more information, see <a href="https://aws.amazon.com/cloudwatch/pricing/">Amazon CloudWatch Pricing</a>. </p>
    *
    * 		       <p>When you use <code>PutMetricStream</code> to create a new metric stream, the stream
    * 		is created in the <code>running</code> state. If you use it to update an existing stream,

clients/client-cloudwatch/src/commands/DeleteAlarmsCommand.ts

@@ -33,7 +33,7 @@ export interface DeleteAlarmsCommandOutput extends __MetadataBearer {}
  * 			because there is always still a composite alarm that depends on that alarm that you want to delete.</p>
  * 			         <p>To get out of such a situation, you must
  * 				break the cycle by changing the rule of one of the composite alarms in the cycle to remove a dependency that creates the cycle. The simplest
- * 				change to make to break a cycle is to change the <code>AlarmRule</code> of one of the alarms to <code>False</code>. </p>
+ * 				change to make to break a cycle is to change the <code>AlarmRule</code> of one of the alarms to <code>false</code>. </p>
  * 			         <p>Additionally, the evaluation of composite alarms stops if CloudWatch detects a cycle in the evaluation path.
  * 			</p>
  *          </note>

clients/client-cloudwatch/src/commands/ListMetricsCommand.ts

@@ -26,14 +26,15 @@ export interface ListMetricsCommandInput extends ListMetricsInput {}
 export interface ListMetricsCommandOutput extends ListMetricsOutput, __MetadataBearer {}
 
 /**
- * <p>List the specified metrics. You can use the returned metrics with
- * 			<a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_GetMetricData.html">GetMetricData</a> or
- * 			<a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_GetMetricStatistics.html">GetMetricStatistics</a> to obtain statistical data.</p>
+ * <p>List the specified metrics. You can use the returned metrics with <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_GetMetricData.html">GetMetricData</a> or <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_GetMetricStatistics.html">GetMetricStatistics</a> to get statistical data.</p>
  * 		       <p>Up to 500 results are returned for any one call. To retrieve additional results,
  * 			use the returned token with subsequent calls.</p>
- * 		       <p>After you create a metric, allow up to 15 minutes before the metric appears.
- * 			You can see statistics about the metric sooner by using <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_GetMetricData.html">GetMetricData</a> or
- * 			<a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_GetMetricStatistics.html">GetMetricStatistics</a>.</p>
+ * 		       <p>After you create a metric, allow up to 15 minutes for the metric to appear. To see metric
+ * 			statistics sooner, use <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_GetMetricData.html">GetMetricData</a> or <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_GetMetricStatistics.html">GetMetricStatistics</a>.</p>
+ *
+ * 		       <p>If you are using CloudWatch cross-account observability, you can use this operation in a monitoring account and
+ * 			view metrics from the linked source accounts. For more information, see
+ * 			<a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html">CloudWatch cross-account observability</a>.</p>
  *
  * 	        <p>
  *             <code>ListMetrics</code> doesn't return information about metrics if those metrics haven't

clients/client-cloudwatch/src/commands/PutCompositeAlarmCommand.ts

@@ -46,7 +46,7 @@ export interface PutCompositeAlarmCommandOutput extends __MetadataBearer {}
  * 			because there is always still a composite alarm that depends on that alarm that you want to delete.</p>
  * 			         <p>To get out of such a situation, you must
  * 			break the cycle by changing the rule of one of the composite alarms in the cycle to remove a dependency that creates the cycle. The simplest
- * 			change to make to break a cycle is to change the <code>AlarmRule</code> of one of the alarms to <code>False</code>. </p>
+ * 			change to make to break a cycle is to change the <code>AlarmRule</code> of one of the alarms to <code>false</code>. </p>
  * 			         <p>Additionally, the evaluation of composite alarms stops if CloudWatch detects a cycle in the evaluation path.
  * 		</p>
  *          </note>

clients/client-cloudwatch/src/commands/PutMetricStreamCommand.ts

@@ -29,16 +29,15 @@ export interface PutMetricStreamCommandInput extends PutMetricStreamInput {}
 export interface PutMetricStreamCommandOutput extends PutMetricStreamOutput, __MetadataBearer {}
 
 /**
- * <p>Creates or updates a metric stream. Metric streams can automatically stream CloudWatch metrics
- * 			to Amazon Web Services destinations including
- * 			Amazon S3 and to many third-party solutions.</p>
+ * <p>Creates or updates a metric stream. Metric streams can automatically stream CloudWatch
+ * 			metrics to Amazon Web Services destinations, including Amazon S3, and to many third-party
+ * 			solutions.</p>
  * 		       <p>For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Metric-Streams.html">
  * 		Using Metric Streams</a>.</p>
- * 		       <p>To create a metric stream,
- * 			you must be logged on to an account that has the <code>iam:PassRole</code> permission
- * 			and either the <code>CloudWatchFullAccess</code>
- * 		policy or the <code>cloudwatch:PutMetricStream</code>
- * 		permission.</p>
+ * 		       <p>To create a metric stream, you must be signed in to an account that has the
+ * 				<code>iam:PassRole</code> permission and either the
+ * 				<code>CloudWatchFullAccess</code> policy or the
+ * 				<code>cloudwatch:PutMetricStream</code> permission.</p>
  * 		       <p>When you create or update a metric stream, you choose one of the following:</p>
  * 		       <ul>
  *             <li>
@@ -54,11 +53,11 @@ export interface PutMetricStreamCommandOutput extends PutMetricStreamOutput, __M
  *             </li>
  *          </ul>
  *
- * 		       <p>By default, a metric stream always sends the <code>MAX</code>, <code>MIN</code>, <code>SUM</code>,
- * 			and <code>SAMPLECOUNT</code> statistics for each metric that is streamed. You can use the
- * 			<code>StatisticsConfigurations</code> parameter to have
- * 			the metric stream also send additional statistics in the stream. Streaming additional statistics incurs
- * 			additional costs. For more information, see <a href="https://aws.amazon.com/cloudwatch/pricing/">Amazon CloudWatch Pricing</a>. </p>
+ * 		       <p>By default, a metric stream always sends the <code>MAX</code>, <code>MIN</code>,
+ * 				<code>SUM</code>, and <code>SAMPLECOUNT</code> statistics for each metric that is
+ * 			streamed. You can use the <code>StatisticsConfigurations</code> parameter to have the
+ * 			metric stream send additional statistics in the stream. Streaming additional statistics
+ * 			incurs additional costs. For more information, see <a href="https://aws.amazon.com/cloudwatch/pricing/">Amazon CloudWatch Pricing</a>. </p>
  *
  * 		       <p>When you use <code>PutMetricStream</code> to create a new metric stream, the stream
  * 		is created in the <code>running</code> state. If you use it to update an existing stream,