@aws-sdk/client-oam 3.810.0 → 3.814.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 CHANGED
@@ -6,21 +6,7 @@
6
6
 
7
7
  AWS SDK for JavaScript OAM Client for Node.js, Browser and React Native.
8
8
 
9
- <p>Use Amazon CloudWatch Observability Access Manager to create and manage links between source accounts and
10
- monitoring accounts by using <i>CloudWatch cross-account observability</i>. With
11
- CloudWatch cross-account observability, you can monitor and troubleshoot applications that span
12
- multiple accounts within a Region. Seamlessly search, visualize, and analyze your metrics,
13
- logs, traces, Application Signals services, service level objectives (SLOs), Application Insights applications, and internet monitors in any of the linked accounts without account boundaries.</p>
14
- <p>Set up one or more Amazon Web Services accounts as <i>monitoring
15
- accounts</i> and link them with multiple <i>source accounts</i>. A
16
- monitoring account is a central Amazon Web Services account that can view and interact with
17
- observability data generated from source accounts. A source account is an individual Amazon Web Services account that generates observability data for the resources that reside in it.
18
- Source accounts share their observability data with the monitoring account. The shared
19
- observability data can include metrics in Amazon CloudWatch, logs in Amazon CloudWatch Logs, traces in X-Ray, Application Signals services, service level objectives (SLOs), applications in Amazon CloudWatch Application Insights, and internet monitors
20
- in CloudWatch Internet Monitor.</p>
21
- <p>When you set up a link, you can choose to share the metrics from all namespaces with the monitoring account, or filter to a subset of namespaces.
22
- And for CloudWatch Logs, you can choose to share all log groups with the monitoring account, or filter to a subset of log groups.
23
- </p>
9
+ <p>Use Amazon CloudWatch Observability Access Manager to create and manage links between source accounts and monitoring accounts by using <i>CloudWatch cross-account observability</i>. With CloudWatch cross-account observability, you can monitor and troubleshoot applications that span multiple accounts within a Region. Seamlessly search, visualize, and analyze your metrics, logs, traces, Application Signals services and service level objectives (SLOs), Application Insights applications, and internet monitors in any of the linked accounts without account boundaries.</p> <p>Set up one or more Amazon Web Services accounts as <i>monitoring accounts</i> and link them with multiple <i>source accounts</i>. A monitoring account is a central Amazon Web Services account that can view and interact with observability data generated from source accounts. A source account is an individual Amazon Web Services account that generates observability data for the resources that reside in it. Source accounts share their observability data with the monitoring account. The shared observability data can include metrics in Amazon CloudWatch, logs in Amazon CloudWatch Logs, traces in X-Ray, Application Signals services and service level objectives (SLOs), applications in Amazon CloudWatch Application Insights, and internet monitors in CloudWatch Internet Monitor.</p> <p>When you set up a link, you can choose to share the metrics from all namespaces with the monitoring account, or filter to a subset of namespaces. And for CloudWatch Logs, you can choose to share all log groups with the monitoring account, or filter to a subset of log groups. </p>
24
10
 
25
11
  ## Installing
26
12
 
package/dist-cjs/index.js CHANGED
@@ -502,7 +502,8 @@ var se_GetLinkCommand = /* @__PURE__ */ __name(async (input, context) => {
502
502
  let body;
503
503
  body = JSON.stringify(
504
504
  (0, import_smithy_client.take)(input, {
505
- Identifier: []
505
+ Identifier: [],
506
+ IncludeTags: []
506
507
  })
507
508
  );
508
509
  b.m("POST").h(headers).b(body);
@@ -517,7 +518,8 @@ var se_GetSinkCommand = /* @__PURE__ */ __name(async (input, context) => {
517
518
  let body;
518
519
  body = JSON.stringify(
519
520
  (0, import_smithy_client.take)(input, {
520
- Identifier: []
521
+ Identifier: [],
522
+ IncludeTags: []
521
523
  })
522
524
  );
523
525
  b.m("POST").h(headers).b(body);
@@ -650,6 +652,7 @@ var se_UpdateLinkCommand = /* @__PURE__ */ __name(async (input, context) => {
650
652
  body = JSON.stringify(
651
653
  (0, import_smithy_client.take)(input, {
652
654
  Identifier: [],
655
+ IncludeTags: [],
653
656
  LinkConfiguration: /* @__PURE__ */ __name((_) => (0, import_smithy_client._json)(_), "LinkConfiguration"),
654
657
  ResourceTypes: /* @__PURE__ */ __name((_) => (0, import_smithy_client._json)(_), "ResourceTypes")
655
658
  })
@@ -69,6 +69,7 @@ export const se_GetLinkCommand = async (input, context) => {
69
69
  let body;
70
70
  body = JSON.stringify(take(input, {
71
71
  Identifier: [],
72
+ IncludeTags: [],
72
73
  }));
73
74
  b.m("POST").h(headers).b(body);
74
75
  return b.build();
@@ -82,6 +83,7 @@ export const se_GetSinkCommand = async (input, context) => {
82
83
  let body;
83
84
  body = JSON.stringify(take(input, {
84
85
  Identifier: [],
86
+ IncludeTags: [],
85
87
  }));
86
88
  b.m("POST").h(headers).b(body);
87
89
  return b.build();
@@ -200,6 +202,7 @@ export const se_UpdateLinkCommand = async (input, context) => {
200
202
  let body;
201
203
  body = JSON.stringify(take(input, {
202
204
  Identifier: [],
205
+ IncludeTags: [],
203
206
  LinkConfiguration: (_) => _json(_),
204
207
  ResourceTypes: (_) => _json(_),
205
208
  }));
@@ -110,21 +110,7 @@ export interface OAM {
110
110
  updateLink(args: UpdateLinkCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: UpdateLinkCommandOutput) => void): void;
111
111
  }
112
112
  /**
113
- * <p>Use Amazon CloudWatch Observability Access Manager to create and manage links between source accounts and
114
- * monitoring accounts by using <i>CloudWatch cross-account observability</i>. With
115
- * CloudWatch cross-account observability, you can monitor and troubleshoot applications that span
116
- * multiple accounts within a Region. Seamlessly search, visualize, and analyze your metrics,
117
- * logs, traces, Application Signals services, service level objectives (SLOs), Application Insights applications, and internet monitors in any of the linked accounts without account boundaries.</p>
118
- * <p>Set up one or more Amazon Web Services accounts as <i>monitoring
119
- * accounts</i> and link them with multiple <i>source accounts</i>. A
120
- * monitoring account is a central Amazon Web Services account that can view and interact with
121
- * observability data generated from source accounts. A source account is an individual Amazon Web Services account that generates observability data for the resources that reside in it.
122
- * Source accounts share their observability data with the monitoring account. The shared
123
- * observability data can include metrics in Amazon CloudWatch, logs in Amazon CloudWatch Logs, traces in X-Ray, Application Signals services, service level objectives (SLOs), applications in Amazon CloudWatch Application Insights, and internet monitors
124
- * in CloudWatch Internet Monitor.</p>
125
- * <p>When you set up a link, you can choose to share the metrics from all namespaces with the monitoring account, or filter to a subset of namespaces.
126
- * And for CloudWatch Logs, you can choose to share all log groups with the monitoring account, or filter to a subset of log groups.
127
- * </p>
113
+ * <p>Use Amazon CloudWatch Observability Access Manager to create and manage links between source accounts and monitoring accounts by using <i>CloudWatch cross-account observability</i>. With CloudWatch cross-account observability, you can monitor and troubleshoot applications that span multiple accounts within a Region. Seamlessly search, visualize, and analyze your metrics, logs, traces, Application Signals services and service level objectives (SLOs), Application Insights applications, and internet monitors in any of the linked accounts without account boundaries.</p> <p>Set up one or more Amazon Web Services accounts as <i>monitoring accounts</i> and link them with multiple <i>source accounts</i>. A monitoring account is a central Amazon Web Services account that can view and interact with observability data generated from source accounts. A source account is an individual Amazon Web Services account that generates observability data for the resources that reside in it. Source accounts share their observability data with the monitoring account. The shared observability data can include metrics in Amazon CloudWatch, logs in Amazon CloudWatch Logs, traces in X-Ray, Application Signals services and service level objectives (SLOs), applications in Amazon CloudWatch Application Insights, and internet monitors in CloudWatch Internet Monitor.</p> <p>When you set up a link, you can choose to share the metrics from all namespaces with the monitoring account, or filter to a subset of namespaces. And for CloudWatch Logs, you can choose to share all log groups with the monitoring account, or filter to a subset of log groups. </p>
128
114
  * @public
129
115
  */
130
116
  export declare class OAM extends OAMClient implements OAM {
@@ -184,21 +184,7 @@ export type OAMClientResolvedConfigType = __SmithyResolvedConfiguration<__HttpHa
184
184
  export interface OAMClientResolvedConfig extends OAMClientResolvedConfigType {
185
185
  }
186
186
  /**
187
- * <p>Use Amazon CloudWatch Observability Access Manager to create and manage links between source accounts and
188
- * monitoring accounts by using <i>CloudWatch cross-account observability</i>. With
189
- * CloudWatch cross-account observability, you can monitor and troubleshoot applications that span
190
- * multiple accounts within a Region. Seamlessly search, visualize, and analyze your metrics,
191
- * logs, traces, Application Signals services, service level objectives (SLOs), Application Insights applications, and internet monitors in any of the linked accounts without account boundaries.</p>
192
- * <p>Set up one or more Amazon Web Services accounts as <i>monitoring
193
- * accounts</i> and link them with multiple <i>source accounts</i>. A
194
- * monitoring account is a central Amazon Web Services account that can view and interact with
195
- * observability data generated from source accounts. A source account is an individual Amazon Web Services account that generates observability data for the resources that reside in it.
196
- * Source accounts share their observability data with the monitoring account. The shared
197
- * observability data can include metrics in Amazon CloudWatch, logs in Amazon CloudWatch Logs, traces in X-Ray, Application Signals services, service level objectives (SLOs), applications in Amazon CloudWatch Application Insights, and internet monitors
198
- * in CloudWatch Internet Monitor.</p>
199
- * <p>When you set up a link, you can choose to share the metrics from all namespaces with the monitoring account, or filter to a subset of namespaces.
200
- * And for CloudWatch Logs, you can choose to share all log groups with the monitoring account, or filter to a subset of log groups.
201
- * </p>
187
+ * <p>Use Amazon CloudWatch Observability Access Manager to create and manage links between source accounts and monitoring accounts by using <i>CloudWatch cross-account observability</i>. With CloudWatch cross-account observability, you can monitor and troubleshoot applications that span multiple accounts within a Region. Seamlessly search, visualize, and analyze your metrics, logs, traces, Application Signals services and service level objectives (SLOs), Application Insights applications, and internet monitors in any of the linked accounts without account boundaries.</p> <p>Set up one or more Amazon Web Services accounts as <i>monitoring accounts</i> and link them with multiple <i>source accounts</i>. A monitoring account is a central Amazon Web Services account that can view and interact with observability data generated from source accounts. A source account is an individual Amazon Web Services account that generates observability data for the resources that reside in it. Source accounts share their observability data with the monitoring account. The shared observability data can include metrics in Amazon CloudWatch, logs in Amazon CloudWatch Logs, traces in X-Ray, Application Signals services and service level objectives (SLOs), applications in Amazon CloudWatch Application Insights, and internet monitors in CloudWatch Internet Monitor.</p> <p>When you set up a link, you can choose to share the metrics from all namespaces with the monitoring account, or filter to a subset of namespaces. And for CloudWatch Logs, you can choose to share all log groups with the monitoring account, or filter to a subset of log groups. </p>
202
188
  * @public
203
189
  */
204
190
  export declare class OAMClient extends __Client<__HttpHandlerOptions, ServiceInputTypes, ServiceOutputTypes, OAMClientResolvedConfig> {
@@ -27,18 +27,7 @@ declare const CreateLinkCommand_base: {
27
27
  getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
28
28
  };
29
29
  /**
30
- * <p>Creates a link between a source account and a sink that you have created in a monitoring account. After the link is created,
31
- * data is sent from the source account to the monitoring account. When you create a link, you can optionally specify filters
32
- * that specify which metric namespaces and which log groups are shared from the source account to the monitoring account.</p>
33
- * <p>Before you create a link, you must create a sink in the monitoring account and create a
34
- * sink policy in that account. The sink policy must permit the source account to link to it. You
35
- * can grant permission to source accounts by granting permission to an entire organization or to
36
- * individual accounts.</p>
37
- * <p>For more information, see
38
- * <a href="https://docs.aws.amazon.com/OAM/latest/APIReference/API_CreateSink.html">CreateSink</a> and
39
- * <a href="https://docs.aws.amazon.com/OAM/latest/APIReference/API_PutSinkPolicy.html">PutSinkPolicy</a>.</p>
40
- * <p>Each monitoring account can be linked to as many as 100,000 source accounts.</p>
41
- * <p>Each source account can be linked to as many as five monitoring accounts.</p>
30
+ * <p>Creates a link between a source account and a sink that you have created in a monitoring account. After the link is created, data is sent from the source account to the monitoring account. When you create a link, you can optionally specify filters that specify which metric namespaces and which log groups are shared from the source account to the monitoring account.</p> <p>Before you create a link, you must create a sink in the monitoring account and create a sink policy in that account. The sink policy must permit the source account to link to it. You can grant permission to source accounts by granting permission to an entire organization or to individual accounts.</p> <p>For more information, see <a href="https://docs.aws.amazon.com/OAM/latest/APIReference/API_CreateSink.html">CreateSink</a> and <a href="https://docs.aws.amazon.com/OAM/latest/APIReference/API_PutSinkPolicy.html">PutSinkPolicy</a>.</p> <p>Each monitoring account can be linked to as many as 100,000 source accounts.</p> <p>Each source account can be linked to as many as five monitoring accounts.</p>
42
31
  * @example
43
32
  * Use a bare-bones client and the command you need to make an API call.
44
33
  * ```javascript
@@ -27,13 +27,7 @@ declare const CreateSinkCommand_base: {
27
27
  getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
28
28
  };
29
29
  /**
30
- * <p>Use this to create a <i>sink</i> in the current account, so that it can be
31
- * used as a monitoring account in CloudWatch cross-account observability. A sink is a resource that
32
- * represents an attachment point in a monitoring account. Source accounts can link to the sink
33
- * to send observability data.</p>
34
- * <p>After you create a sink, you must create a sink policy that allows source accounts to attach to it.
35
- * For more information, see <a href="https://docs.aws.amazon.com/OAM/latest/APIReference/API_PutSinkPolicy.html">PutSinkPolicy</a>.</p>
36
- * <p>Each account can contain one sink per Region. If you delete a sink, you can then create a new one in that Region.</p>
30
+ * <p>Use this to create a <i>sink</i> in the current account, so that it can be used as a monitoring account in CloudWatch cross-account observability. A sink is a resource that represents an attachment point in a monitoring account. Source accounts can link to the sink to send observability data.</p> <p>After you create a sink, you must create a sink policy that allows source accounts to attach to it. For more information, see <a href="https://docs.aws.amazon.com/OAM/latest/APIReference/API_PutSinkPolicy.html">PutSinkPolicy</a>.</p> <p>Each account can contain one sink per Region. If you delete a sink, you can then create a new one in that Region.</p>
37
31
  * @example
38
32
  * Use a bare-bones client and the command you need to make an API call.
39
33
  * ```javascript
@@ -27,8 +27,7 @@ declare const DeleteLinkCommand_base: {
27
27
  getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
28
28
  };
29
29
  /**
30
- * <p>Deletes a link between a monitoring account sink and a source account. You must run this operation
31
- * in the source account.</p>
30
+ * <p>Deletes a link between a monitoring account sink and a source account. You must run this operation in the source account.</p>
32
31
  * @example
33
32
  * Use a bare-bones client and the command you need to make an API call.
34
33
  * ```javascript
@@ -27,8 +27,7 @@ declare const GetLinkCommand_base: {
27
27
  getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
28
28
  };
29
29
  /**
30
- * <p>Returns complete information about one link.</p>
31
- * <p>To use this operation, provide the link ARN. To retrieve a list of link ARNs, use <a href="https://docs.aws.amazon.com/OAM/latest/APIReference/API_ListLinks.html">ListLinks</a>.</p>
30
+ * <p>Returns complete information about one link.</p> <p>To use this operation, provide the link ARN. To retrieve a list of link ARNs, use <a href="https://docs.aws.amazon.com/OAM/latest/APIReference/API_ListLinks.html">ListLinks</a>.</p>
32
31
  * @example
33
32
  * Use a bare-bones client and the command you need to make an API call.
34
33
  * ```javascript
@@ -37,6 +36,7 @@ declare const GetLinkCommand_base: {
37
36
  * const client = new OAMClient(config);
38
37
  * const input = { // GetLinkInput
39
38
  * Identifier: "STRING_VALUE", // required
39
+ * IncludeTags: true || false,
40
40
  * };
41
41
  * const command = new GetLinkCommand(input);
42
42
  * const response = await client.send(command);
@@ -27,8 +27,7 @@ declare const GetSinkCommand_base: {
27
27
  getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
28
28
  };
29
29
  /**
30
- * <p>Returns complete information about one monitoring account sink.</p>
31
- * <p>To use this operation, provide the sink ARN. To retrieve a list of sink ARNs, use <a href="https://docs.aws.amazon.com/OAM/latest/APIReference/API_ListSinks.html">ListSinks</a>.</p>
30
+ * <p>Returns complete information about one monitoring account sink.</p> <p>To use this operation, provide the sink ARN. To retrieve a list of sink ARNs, use <a href="https://docs.aws.amazon.com/OAM/latest/APIReference/API_ListSinks.html">ListSinks</a>.</p>
32
31
  * @example
33
32
  * Use a bare-bones client and the command you need to make an API call.
34
33
  * ```javascript
@@ -37,6 +36,7 @@ declare const GetSinkCommand_base: {
37
36
  * const client = new OAMClient(config);
38
37
  * const input = { // GetSinkInput
39
38
  * Identifier: "STRING_VALUE", // required
39
+ * IncludeTags: true || false,
40
40
  * };
41
41
  * const command = new GetSinkCommand(input);
42
42
  * const response = await client.send(command);
@@ -27,8 +27,7 @@ declare const GetSinkPolicyCommand_base: {
27
27
  getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
28
28
  };
29
29
  /**
30
- * <p>Returns the current sink policy attached to this sink. The sink policy specifies what
31
- * accounts can attach to this sink as source accounts, and what types of data they can share.</p>
30
+ * <p>Returns the current sink policy attached to this sink. The sink policy specifies what accounts can attach to this sink as source accounts, and what types of data they can share.</p>
32
31
  * @example
33
32
  * Use a bare-bones client and the command you need to make an API call.
34
33
  * ```javascript
@@ -27,9 +27,7 @@ declare const ListAttachedLinksCommand_base: {
27
27
  getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
28
28
  };
29
29
  /**
30
- * <p>Returns a list of source account links that are linked to this monitoring account sink.</p>
31
- * <p>To use this operation, provide the sink ARN. To retrieve a list of sink ARNs, use <a href="https://docs.aws.amazon.com/OAM/latest/APIReference/API_ListSinks.html">ListSinks</a>.</p>
32
- * <p>To find a list of links for one source account, use <a href="https://docs.aws.amazon.com/OAM/latest/APIReference/API_ListLinks.html">ListLinks</a>.</p>
30
+ * <p>Returns a list of source account links that are linked to this monitoring account sink.</p> <p>To use this operation, provide the sink ARN. To retrieve a list of sink ARNs, use <a href="https://docs.aws.amazon.com/OAM/latest/APIReference/API_ListSinks.html">ListSinks</a>.</p> <p>To find a list of links for one source account, use <a href="https://docs.aws.amazon.com/OAM/latest/APIReference/API_ListLinks.html">ListLinks</a>.</p>
33
31
  * @example
34
32
  * Use a bare-bones client and the command you need to make an API call.
35
33
  * ```javascript
@@ -27,9 +27,7 @@ declare const ListLinksCommand_base: {
27
27
  getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
28
28
  };
29
29
  /**
30
- * <p>Use this operation in a source account to return a list of links to monitoring account sinks that
31
- * this source account has.</p>
32
- * <p>To find a list of links for one monitoring account sink, use <a href="https://docs.aws.amazon.com/OAM/latest/APIReference/API_ListAttachedLinks.html">ListAttachedLinks</a> from within the monitoring account.</p>
30
+ * <p>Use this operation in a source account to return a list of links to monitoring account sinks that this source account has.</p> <p>To find a list of links for one monitoring account sink, use <a href="https://docs.aws.amazon.com/OAM/latest/APIReference/API_ListAttachedLinks.html">ListAttachedLinks</a> from within the monitoring account.</p>
33
31
  * @example
34
32
  * Use a bare-bones client and the command you need to make an API call.
35
33
  * ```javascript
@@ -27,35 +27,7 @@ declare const PutSinkPolicyCommand_base: {
27
27
  getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
28
28
  };
29
29
  /**
30
- * <p>Creates or updates the resource policy that grants permissions to source
31
- * accounts to link to the monitoring account sink. When you create a sink policy, you can grant
32
- * permissions to all accounts in an organization or to individual accounts.</p>
33
- * <p>You can also use a sink policy to limit the types of data that is shared. The three types that
34
- * you can allow or deny are:</p>
35
- * <ul>
36
- * <li>
37
- * <p>
38
- * <b>Metrics</b> - Specify with
39
- * <code>AWS::CloudWatch::Metric</code>
40
- * </p>
41
- * </li>
42
- * <li>
43
- * <p>
44
- * <b>Log groups</b> - Specify with <code>AWS::Logs::LogGroup</code>
45
- * </p>
46
- * </li>
47
- * <li>
48
- * <p>
49
- * <b>Traces</b> - Specify with <code>AWS::XRay::Trace</code>
50
- * </p>
51
- * </li>
52
- * <li>
53
- * <p>
54
- * <b>Application Insights - Applications</b> - Specify with <code>AWS::ApplicationInsights::Application</code>
55
- * </p>
56
- * </li>
57
- * </ul>
58
- * <p>See the examples in this section to see how to specify permitted source accounts and data types.</p>
30
+ * <p>Creates or updates the resource policy that grants permissions to source accounts to link to the monitoring account sink. When you create a sink policy, you can grant permissions to all accounts in an organization or to individual accounts.</p> <p>You can also use a sink policy to limit the types of data that is shared. The six types of services with their respective resource types that you can allow or deny are:</p> <ul> <li> <p> <b>Metrics</b> - Specify with <code>AWS::CloudWatch::Metric</code> </p> </li> <li> <p> <b>Log groups</b> - Specify with <code>AWS::Logs::LogGroup</code> </p> </li> <li> <p> <b>Traces</b> - Specify with <code>AWS::XRay::Trace</code> </p> </li> <li> <p> <b>Application Insights - Applications</b> - Specify with <code>AWS::ApplicationInsights::Application</code> </p> </li> <li> <p> <b>Internet Monitor</b> - Specify with <code>AWS::InternetMonitor::Monitor</code> </p> </li> <li> <p> <b>Application Signals</b> - Specify with <code>AWS::ApplicationSignals::Service</code> and <code>AWS::ApplicationSignals::ServiceLevelObjective</code> </p> </li> </ul> <p>See the examples in this section to see how to specify permitted source accounts and data types.</p>
59
31
  * @example
60
32
  * Use a bare-bones client and the command you need to make an API call.
61
33
  * ```javascript
@@ -27,23 +27,7 @@ declare const TagResourceCommand_base: {
27
27
  getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
28
28
  };
29
29
  /**
30
- * <p>Assigns one or more tags (key-value pairs) to the specified resource.
31
- * Both sinks and links can be tagged. </p>
32
- * <p>Tags can help you organize and categorize your resources. You can also use them to scope user
33
- * permissions by granting a user
34
- * permission to access or change only resources with certain tag values.</p>
35
- * <p>Tags don't have any semantic meaning to Amazon Web Services and are interpreted strictly as strings of characters.</p>
36
- * <p>You can use the <code>TagResource</code> action with a resource that already has tags. If you specify a new tag key for the alarm,
37
- * this tag is appended to the list of tags associated
38
- * with the alarm. If you specify a tag key that is already associated with the alarm, the new tag value that you specify replaces
39
- * the previous value for that tag.</p>
40
- * <p>You can associate as many as 50 tags with a resource.</p>
41
- * <important>
42
- * <p>Unlike tagging permissions in other Amazon Web Services services, to tag or untag links and
43
- * sinks you must have the <code>oam:ResourceTag</code> permission. The
44
- * <code>iam:ResourceTag</code> permission does not allow you to tag and untag links and
45
- * sinks.</p>
46
- * </important>
30
+ * <p>Assigns one or more tags (key-value pairs) to the specified resource. Both sinks and links can be tagged. </p> <p>Tags can help you organize and categorize your resources. You can also use them to scope user permissions by granting a user permission to access or change only resources with certain tag values.</p> <p>Tags don't have any semantic meaning to Amazon Web Services and are interpreted strictly as strings of characters.</p> <p>You can use the <code>TagResource</code> action with a resource that already has tags. If you specify a new tag key for the alarm, this tag is appended to the list of tags associated with the alarm. If you specify a tag key that is already associated with the alarm, the new tag value that you specify replaces the previous value for that tag.</p> <p>You can associate as many as 50 tags with a resource.</p> <important> <p>Unlike tagging permissions in other Amazon Web Services services, to tag or untag links and sinks you must have the <code>oam:ResourceTag</code> permission. The <code>iam:ResourceTag</code> permission does not allow you to tag and untag links and sinks.</p> </important>
47
31
  * @example
48
32
  * Use a bare-bones client and the command you need to make an API call.
49
33
  * ```javascript
@@ -27,13 +27,7 @@ declare const UntagResourceCommand_base: {
27
27
  getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
28
28
  };
29
29
  /**
30
- * <p>Removes one or more tags from the specified resource.</p>
31
- * <important>
32
- * <p>Unlike tagging permissions in other Amazon Web Services services, to tag or untag links and
33
- * sinks you must have the <code>oam:ResourceTag</code> permission. The
34
- * <code>iam:TagResource</code> permission does not allow you to tag and untag links and
35
- * sinks.</p>
36
- * </important>
30
+ * <p>Removes one or more tags from the specified resource.</p> <important> <p>Unlike tagging permissions in other Amazon Web Services services, to tag or untag links and sinks you must have the <code>oam:ResourceTag</code> permission. The <code>iam:TagResource</code> permission does not allow you to tag and untag links and sinks.</p> </important>
37
31
  * @example
38
32
  * Use a bare-bones client and the command you need to make an API call.
39
33
  * ```javascript
@@ -27,12 +27,7 @@ declare const UpdateLinkCommand_base: {
27
27
  getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
28
28
  };
29
29
  /**
30
- * <p>Use this operation to change what types of data are shared from a source account to its linked
31
- * monitoring account sink. You can't change the sink or change the monitoring account with this operation.</p>
32
- * <p>When you update a link, you can optionally specify filters
33
- * that specify which metric namespaces and which log groups are shared from the source account to the monitoring account.</p>
34
- * <p>To update the list of tags associated with the sink, use
35
- * <a href="https://docs.aws.amazon.com/OAM/latest/APIReference/API_TagResource.html">TagResource</a>.</p>
30
+ * <p>Use this operation to change what types of data are shared from a source account to its linked monitoring account sink. You can't change the sink or change the monitoring account with this operation.</p> <p>When you update a link, you can optionally specify filters that specify which metric namespaces and which log groups are shared from the source account to the monitoring account.</p> <p>To update the list of tags associated with the sink, use <a href="https://docs.aws.amazon.com/OAM/latest/APIReference/API_TagResource.html">TagResource</a>.</p>
36
31
  * @example
37
32
  * Use a bare-bones client and the command you need to make an API call.
38
33
  * ```javascript
@@ -52,6 +47,7 @@ declare const UpdateLinkCommand_base: {
52
47
  * Filter: "STRING_VALUE", // required
53
48
  * },
54
49
  * },
50
+ * IncludeTags: true || false,
55
51
  * };
56
52
  * const command = new UpdateLinkCommand(input);
57
53
  * const response = await client.send(command);
@@ -1,19 +1,5 @@
1
1
  /**
2
- * <p>Use Amazon CloudWatch Observability Access Manager to create and manage links between source accounts and
3
- * monitoring accounts by using <i>CloudWatch cross-account observability</i>. With
4
- * CloudWatch cross-account observability, you can monitor and troubleshoot applications that span
5
- * multiple accounts within a Region. Seamlessly search, visualize, and analyze your metrics,
6
- * logs, traces, Application Signals services, service level objectives (SLOs), Application Insights applications, and internet monitors in any of the linked accounts without account boundaries.</p>
7
- * <p>Set up one or more Amazon Web Services accounts as <i>monitoring
8
- * accounts</i> and link them with multiple <i>source accounts</i>. A
9
- * monitoring account is a central Amazon Web Services account that can view and interact with
10
- * observability data generated from source accounts. A source account is an individual Amazon Web Services account that generates observability data for the resources that reside in it.
11
- * Source accounts share their observability data with the monitoring account. The shared
12
- * observability data can include metrics in Amazon CloudWatch, logs in Amazon CloudWatch Logs, traces in X-Ray, Application Signals services, service level objectives (SLOs), applications in Amazon CloudWatch Application Insights, and internet monitors
13
- * in CloudWatch Internet Monitor.</p>
14
- * <p>When you set up a link, you can choose to share the metrics from all namespaces with the monitoring account, or filter to a subset of namespaces.
15
- * And for CloudWatch Logs, you can choose to share all log groups with the monitoring account, or filter to a subset of log groups.
16
- * </p>
2
+ * <p>Use Amazon CloudWatch Observability Access Manager to create and manage links between source accounts and monitoring accounts by using <i>CloudWatch cross-account observability</i>. With CloudWatch cross-account observability, you can monitor and troubleshoot applications that span multiple accounts within a Region. Seamlessly search, visualize, and analyze your metrics, logs, traces, Application Signals services and service level objectives (SLOs), Application Insights applications, and internet monitors in any of the linked accounts without account boundaries.</p> <p>Set up one or more Amazon Web Services accounts as <i>monitoring accounts</i> and link them with multiple <i>source accounts</i>. A monitoring account is a central Amazon Web Services account that can view and interact with observability data generated from source accounts. A source account is an individual Amazon Web Services account that generates observability data for the resources that reside in it. Source accounts share their observability data with the monitoring account. The shared observability data can include metrics in Amazon CloudWatch, logs in Amazon CloudWatch Logs, traces in X-Ray, Application Signals services and service level objectives (SLOs), applications in Amazon CloudWatch Application Insights, and internet monitors in CloudWatch Internet Monitor.</p> <p>When you set up a link, you can choose to share the metrics from all namespaces with the monitoring account, or filter to a subset of namespaces. And for CloudWatch Logs, you can choose to share all log groups with the monitoring account, or filter to a subset of log groups. </p>
17
3
  *
18
4
  * @packageDocumentation
19
5
  */
@@ -19,143 +19,39 @@ export declare class ConflictException extends __BaseException {
19
19
  constructor(opts: __ExceptionOptionType<ConflictException, __BaseException>);
20
20
  }
21
21
  /**
22
- * <p>This structure contains the <code>Filter</code> parameter which you can use to specify which log groups are to
23
- * share log events from this source account to the monitoring account.</p>
22
+ * <p>This structure contains the <code>Filter</code> parameter which you can use to specify which log groups are to share log events from this source account to the monitoring account.</p>
24
23
  * @public
25
24
  */
26
25
  export interface LogGroupConfiguration {
27
26
  /**
28
- * <p>Use this field to specify which log groups are to share their log events with the monitoring account. Use the term <code>LogGroupName</code> and one or
29
- * more of the following operands. Use single quotation marks (') around log group names. The matching of log group names is case sensitive.
30
- * Each filter has a limit of five conditional operands. Conditional operands are <code>AND</code> and <code>OR</code>.</p>
31
- * <ul>
32
- * <li>
33
- * <p>
34
- * <code>=</code> and <code>!=</code>
35
- * </p>
36
- * </li>
37
- * <li>
38
- * <p>
39
- * <code>AND</code>
40
- * </p>
41
- * </li>
42
- * <li>
43
- * <p>
44
- * <code>OR</code>
45
- * </p>
46
- * </li>
47
- * <li>
48
- * <p>
49
- * <code>LIKE</code> and <code>NOT LIKE</code>. These can be used only as prefix searches. Include a <code>%</code> at the end
50
- * of the string that you want to search for and include.</p>
51
- * </li>
52
- * <li>
53
- * <p>
54
- * <code>IN</code> and <code>NOT IN</code>, using parentheses <code>( )</code>
55
- * </p>
56
- * </li>
57
- * </ul>
58
- * <p>Examples:</p>
59
- * <ul>
60
- * <li>
61
- * <p>
62
- * <code>LogGroupName IN ('This-Log-Group', 'Other-Log-Group')</code> includes only the log groups with names <code>This-Log-Group</code> and
63
- * <code>Other-Log-Group</code>.</p>
64
- * </li>
65
- * <li>
66
- * <p>
67
- * <code>LogGroupName NOT IN ('Private-Log-Group', 'Private-Log-Group-2')</code> includes all log groups except the log groups with names <code>Private-Log-Group</code> and
68
- * <code>Private-Log-Group-2</code>.</p>
69
- * </li>
70
- * <li>
71
- * <p>
72
- * <code>LogGroupName LIKE 'aws/lambda/%' OR LogGroupName LIKE 'AWSLogs%'</code> includes all log groups that have names that start with <code>aws/lambda/</code> or
73
- * <code>AWSLogs</code>.</p>
74
- * </li>
75
- * </ul>
76
- * <note>
77
- * <p>If you are updating a link that uses filters, you can specify <code>*</code> as the only value for the
78
- * <code>filter</code> parameter to delete the filter and share all log groups with the monitoring account.</p>
79
- * </note>
27
+ * <p>Use this field to specify which log groups are to share their log events with the monitoring account. Use the term <code>LogGroupName</code> and one or more of the following operands. Use single quotation marks (') around log group names. The matching of log group names is case sensitive. Each filter has a limit of five conditional operands. Conditional operands are <code>AND</code> and <code>OR</code>.</p> <ul> <li> <p> <code>=</code> and <code>!=</code> </p> </li> <li> <p> <code>AND</code> </p> </li> <li> <p> <code>OR</code> </p> </li> <li> <p> <code>LIKE</code> and <code>NOT LIKE</code>. These can be used only as prefix searches. Include a <code>%</code> at the end of the string that you want to search for and include.</p> </li> <li> <p> <code>IN</code> and <code>NOT IN</code>, using parentheses <code>( )</code> </p> </li> </ul> <p>Examples:</p> <ul> <li> <p> <code>LogGroupName IN ('This-Log-Group', 'Other-Log-Group')</code> includes only the log groups with names <code>This-Log-Group</code> and <code>Other-Log-Group</code>.</p> </li> <li> <p> <code>LogGroupName NOT IN ('Private-Log-Group', 'Private-Log-Group-2')</code> includes all log groups except the log groups with names <code>Private-Log-Group</code> and <code>Private-Log-Group-2</code>.</p> </li> <li> <p> <code>LogGroupName LIKE 'aws/lambda/%' OR LogGroupName LIKE 'AWSLogs%'</code> includes all log groups that have names that start with <code>aws/lambda/</code> or <code>AWSLogs</code>.</p> </li> </ul> <note> <p>If you are updating a link that uses filters, you can specify <code>*</code> as the only value for the <code>filter</code> parameter to delete the filter and share all log groups with the monitoring account.</p> </note>
80
28
  * @public
81
29
  */
82
30
  Filter: string | undefined;
83
31
  }
84
32
  /**
85
- * <p>This structure contains the <code>Filter</code> parameter which you can use to specify which metric namespaces are to
86
- * be shared from this source account to the monitoring account.</p>
33
+ * <p>This structure contains the <code>Filter</code> parameter which you can use to specify which metric namespaces are to be shared from this source account to the monitoring account.</p>
87
34
  * @public
88
35
  */
89
36
  export interface MetricConfiguration {
90
37
  /**
91
- * <p>Use this field to specify which metrics are to be shared with the monitoring account. Use the term <code>Namespace</code> and one or
92
- * more of the following operands. Use single quotation marks (') around namespace names. The matching of namespace names is case sensitive.
93
- * Each filter has a limit of five conditional operands. Conditional operands are <code>AND</code> and <code>OR</code>.</p>
94
- * <ul>
95
- * <li>
96
- * <p>
97
- * <code>=</code> and <code>!=</code>
98
- * </p>
99
- * </li>
100
- * <li>
101
- * <p>
102
- * <code>AND</code>
103
- * </p>
104
- * </li>
105
- * <li>
106
- * <p>
107
- * <code>OR</code>
108
- * </p>
109
- * </li>
110
- * <li>
111
- * <p>
112
- * <code>LIKE</code> and <code>NOT LIKE</code>. These can be used only as prefix searches. Include a <code>%</code> at the end
113
- * of the string that you want to search for and include.</p>
114
- * </li>
115
- * <li>
116
- * <p>
117
- * <code>IN</code> and <code>NOT IN</code>, using parentheses <code>( )</code>
118
- * </p>
119
- * </li>
120
- * </ul>
121
- * <p>Examples:</p>
122
- * <ul>
123
- * <li>
124
- * <p>
125
- * <code>Namespace NOT LIKE 'AWS/%'</code> includes only namespaces that don't start with <code>AWS/</code>, such as custom namespaces.</p>
126
- * </li>
127
- * <li>
128
- * <p>
129
- * <code>Namespace IN ('AWS/EC2', 'AWS/ELB', 'AWS/S3')</code> includes only the metrics in the EC2, Elastic Load Balancing, and Amazon S3 namespaces. </p>
130
- * </li>
131
- * <li>
132
- * <p>
133
- * <code>Namespace = 'AWS/EC2' OR Namespace NOT LIKE 'AWS/%'</code> includes only the EC2 namespace and your custom namespaces.</p>
134
- * </li>
135
- * </ul>
136
- * <note>
137
- * <p>If you are updating a link that uses filters, you can specify <code>*</code> as the only value for the
138
- * <code>filter</code> parameter to delete the filter and share all metric namespaces with the monitoring account.</p>
139
- * </note>
38
+ * <p>Use this field to specify which metrics are to be shared with the monitoring account. Use the term <code>Namespace</code> and one or more of the following operands. Use single quotation marks (') around namespace names. The matching of namespace names is case sensitive. Each filter has a limit of five conditional operands. Conditional operands are <code>AND</code> and <code>OR</code>.</p> <ul> <li> <p> <code>=</code> and <code>!=</code> </p> </li> <li> <p> <code>AND</code> </p> </li> <li> <p> <code>OR</code> </p> </li> <li> <p> <code>LIKE</code> and <code>NOT LIKE</code>. These can be used only as prefix searches. Include a <code>%</code> at the end of the string that you want to search for and include.</p> </li> <li> <p> <code>IN</code> and <code>NOT IN</code>, using parentheses <code>( )</code> </p> </li> </ul> <p>Examples:</p> <ul> <li> <p> <code>Namespace NOT LIKE 'AWS/%'</code> includes only namespaces that don't start with <code>AWS/</code>, such as custom namespaces.</p> </li> <li> <p> <code>Namespace IN ('AWS/EC2', 'AWS/ELB', 'AWS/S3')</code> includes only the metrics in the EC2, Elastic Load Balancing, and Amazon S3 namespaces. </p> </li> <li> <p> <code>Namespace = 'AWS/EC2' OR Namespace NOT LIKE 'AWS/%'</code> includes only the EC2 namespace and your custom namespaces.</p> </li> </ul> <note> <p>If you are updating a link that uses filters, you can specify <code>*</code> as the only value for the <code>filter</code> parameter to delete the filter and share all metric namespaces with the monitoring account.</p> </note>
140
39
  * @public
141
40
  */
142
41
  Filter: string | undefined;
143
42
  }
144
43
  /**
145
- * <p>Use this structure to optionally create filters that specify that only some metric namespaces or log groups are to be shared from
146
- * the source account to the monitoring account.</p>
44
+ * <p>Use this structure to optionally create filters that specify that only some metric namespaces or log groups are to be shared from the source account to the monitoring account.</p>
147
45
  * @public
148
46
  */
149
47
  export interface LinkConfiguration {
150
48
  /**
151
- * <p>Use this structure to filter which log groups are to send log events from
152
- * the source account to the monitoring account.</p>
49
+ * <p>Use this structure to filter which log groups are to send log events from the source account to the monitoring account.</p>
153
50
  * @public
154
51
  */
155
52
  LogGroupConfiguration?: LogGroupConfiguration | undefined;
156
53
  /**
157
- * <p>Use this structure to filter which metric namespaces are to be shared from
158
- * the source account to the monitoring account.</p>
54
+ * <p>Use this structure to filter which metric namespaces are to be shared from the source account to the monitoring account.</p>
159
55
  * @public
160
56
  */
161
57
  MetricConfiguration?: MetricConfiguration | undefined;
@@ -182,52 +78,27 @@ export type ResourceType = (typeof ResourceType)[keyof typeof ResourceType];
182
78
  */
183
79
  export interface CreateLinkInput {
184
80
  /**
185
- * <p>Specify a friendly human-readable name to use to identify this source account when you are viewing data from it in the monitoring
186
- * account.</p>
187
- * <p>You can use a custom label or use the following variables:</p>
188
- * <ul>
189
- * <li>
190
- * <p>
191
- * <code>$AccountName</code> is the name of the account</p>
192
- * </li>
193
- * <li>
194
- * <p>
195
- * <code>$AccountEmail</code> is the globally unique email address of the account</p>
196
- * </li>
197
- * <li>
198
- * <p>
199
- * <code>$AccountEmailNoDomain</code> is the email address of the account without the domain name</p>
200
- * </li>
201
- * </ul>
81
+ * <p>Specify a friendly human-readable name to use to identify this source account when you are viewing data from it in the monitoring account.</p> <p>You can use a custom label or use the following variables:</p> <ul> <li> <p> <code>$AccountName</code> is the name of the account</p> </li> <li> <p> <code>$AccountEmail</code> is the globally unique email address of the account</p> </li> <li> <p> <code>$AccountEmailNoDomain</code> is the email address of the account without the domain name</p> </li> </ul> <note> <p>In the Amazon Web Services GovCloud (US-East) and Amazon Web Services GovCloud (US-West) Regions, the only supported option is to use custom labels, and the <code>$AccountName</code>, <code>$AccountEmail</code>, and <code>$AccountEmailNoDomain</code> variables all resolve as <i>account-id</i> instead of the specified variable.</p> </note>
202
82
  * @public
203
83
  */
204
84
  LabelTemplate: string | undefined;
205
85
  /**
206
- * <p>An array of strings that define which types of data that the source account shares with the monitoring
207
- * account.</p>
86
+ * <p>An array of strings that define which types of data that the source account shares with the monitoring account.</p>
208
87
  * @public
209
88
  */
210
89
  ResourceTypes: ResourceType[] | undefined;
211
90
  /**
212
- * <p>The ARN of the sink to use to create this link. You can use <a href="https://docs.aws.amazon.com/OAM/latest/APIReference/API_ListSinks.html">ListSinks</a> to find the ARNs of sinks.</p>
213
- * <p>For more information about sinks, see
214
- * <a href="https://docs.aws.amazon.com/OAM/latest/APIReference/API_CreateSink.html">CreateSink</a>.</p>
91
+ * <p>The ARN of the sink to use to create this link. You can use <a href="https://docs.aws.amazon.com/OAM/latest/APIReference/API_ListSinks.html">ListSinks</a> to find the ARNs of sinks.</p> <p>For more information about sinks, see <a href="https://docs.aws.amazon.com/OAM/latest/APIReference/API_CreateSink.html">CreateSink</a>.</p>
215
92
  * @public
216
93
  */
217
94
  SinkIdentifier: string | undefined;
218
95
  /**
219
- * <p>Assigns one or more tags (key-value pairs) to the link. </p>
220
- * <p>Tags can help you organize and categorize your resources. You can also use them to scope user
221
- * permissions by granting a user
222
- * permission to access or change only resources with certain tag values.</p>
223
- * <p>For more information about using tags to control access, see
224
- * <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html">Controlling access to Amazon Web Services resources using tags</a>.</p>
96
+ * <p>Assigns one or more tags (key-value pairs) to the link. </p> <p>Tags can help you organize and categorize your resources. You can also use them to scope user permissions by granting a user permission to access or change only resources with certain tag values.</p> <p>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 resources using tags</a>.</p>
225
97
  * @public
226
98
  */
227
99
  Tags?: Record<string, string> | undefined;
228
100
  /**
229
- * <p>Use this structure to optionally create filters that specify that only some metric namespaces or log groups are to be shared from
230
- * the source account to the monitoring account.</p>
101
+ * <p>Use this structure to optionally create filters that specify that only some metric namespaces or log groups are to be shared from the source account to the monitoring account.</p>
231
102
  * @public
232
103
  */
233
104
  LinkConfiguration?: LinkConfiguration | undefined;
@@ -247,8 +118,7 @@ export interface CreateLinkOutput {
247
118
  */
248
119
  Id?: string | undefined;
249
120
  /**
250
- * <p>The label that you assigned to this link. If the <code>labelTemplate</code> includes variables,
251
- * this field displays the variables resolved to their actual values.</p>
121
+ * <p>The label that you assigned to this link. If the <code>labelTemplate</code> includes variables, this field displays the variables resolved to their actual values.</p>
252
122
  * @public
253
123
  */
254
124
  Label?: string | undefined;
@@ -273,8 +143,7 @@ export interface CreateLinkOutput {
273
143
  */
274
144
  Tags?: Record<string, string> | undefined;
275
145
  /**
276
- * <p>This structure includes filters that specify which metric namespaces and which log groups are shared from
277
- * the source account to the monitoring account.</p>
146
+ * <p>This structure includes filters that specify which metric namespaces and which log groups are shared from the source account to the monitoring account.</p>
278
147
  * @public
279
148
  */
280
149
  LinkConfiguration?: LinkConfiguration | undefined;
@@ -359,12 +228,7 @@ export interface CreateSinkInput {
359
228
  */
360
229
  Name: string | undefined;
361
230
  /**
362
- * <p>Assigns one or more tags (key-value pairs) to the link. </p>
363
- * <p>Tags can help you organize and categorize your resources. You can also use them to scope user
364
- * permissions by granting a user
365
- * permission to access or change only resources with certain tag values.</p>
366
- * <p>For more information about using tags to control access, see
367
- * <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html">Controlling access to Amazon Web Services resources using tags</a>.</p>
231
+ * <p>Assigns one or more tags (key-value pairs) to the link. </p> <p>Tags can help you organize and categorize your resources. You can also use them to scope user permissions by granting a user permission to access or change only resources with certain tag values.</p> <p>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 resources using tags</a>.</p>
368
232
  * @public
369
233
  */
370
234
  Tags?: Record<string, string> | undefined;
@@ -451,6 +315,11 @@ export interface GetLinkInput {
451
315
  * @public
452
316
  */
453
317
  Identifier: string | undefined;
318
+ /**
319
+ * <p>Specifies whether to include the tags associated with the link in the response. When <code>IncludeTags</code> is set to <code>true</code> and the caller has the required permission, <code>oam:ListTagsForResource</code>, the API will return the tags for the specified resource. If the caller doesn't have the required permission, <code>oam:ListTagsForResource</code>, the API will raise an exception.</p> <p>The default value is <code>false</code>.</p>
320
+ * @public
321
+ */
322
+ IncludeTags?: boolean | undefined;
454
323
  }
455
324
  /**
456
325
  * @public
@@ -492,8 +361,7 @@ export interface GetLinkOutput {
492
361
  */
493
362
  Tags?: Record<string, string> | undefined;
494
363
  /**
495
- * <p>This structure includes filters that specify which metric namespaces and which log groups are shared from
496
- * the source account to the monitoring account.</p>
364
+ * <p>This structure includes filters that specify which metric namespaces and which log groups are shared from the source account to the monitoring account.</p>
497
365
  * @public
498
366
  */
499
367
  LinkConfiguration?: LinkConfiguration | undefined;
@@ -507,6 +375,11 @@ export interface GetSinkInput {
507
375
  * @public
508
376
  */
509
377
  Identifier: string | undefined;
378
+ /**
379
+ * <p>Specifies whether to include the tags associated with the sink in the response. When <code>IncludeTags</code> is set to <code>true</code> and the caller has the required permission, <code>oam:ListTagsForResource</code>, the API will return the tags for the specified resource. If the caller doesn't have the required permission, <code>oam:ListTagsForResource</code>, the API will raise an exception.</p> <p>The default value is <code>false</code>.</p>
380
+ * @public
381
+ */
382
+ IncludeTags?: boolean | undefined;
510
383
  }
511
384
  /**
512
385
  * @public
@@ -584,8 +457,7 @@ export interface ListAttachedLinksInput {
584
457
  SinkIdentifier: string | undefined;
585
458
  }
586
459
  /**
587
- * <p>A structure that contains information about one link attached to this monitoring
588
- * account sink.</p>
460
+ * <p>A structure that contains information about one link attached to this monitoring account sink.</p>
589
461
  * @public
590
462
  */
591
463
  export interface ListAttachedLinksItem {
@@ -737,23 +609,7 @@ export interface ListSinksOutput {
737
609
  */
738
610
  export interface ListTagsForResourceInput {
739
611
  /**
740
- * <p>The ARN of the resource that you want to view tags for.</p>
741
- * <p>The ARN format of a sink is
742
- * <code>arn:aws:oam:<i>Region</i>:<i>account-id</i>:sink/<i>sink-id</i>
743
- * </code>
744
- * </p>
745
- * <p>The ARN format of a link is
746
- * <code>arn:aws:oam:<i>Region</i>:<i>account-id</i>:link/<i>link-id</i>
747
- * </code>
748
- * </p>
749
- * <p>For more information about ARN format, see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/iam-access-control-overview-cwl.html">CloudWatch Logs
750
- * resources and operations</a>.</p>
751
- * <important>
752
- * <p>Unlike tagging permissions in other Amazon Web Services services, to retrieve the list of tags
753
- * for links or sinks you must have the <code>oam:RequestTag</code> permission. The
754
- * <code>aws:ReguestTag</code> permission does not allow you to tag and untag links and
755
- * sinks.</p>
756
- * </important>
612
+ * <p>The ARN of the resource that you want to view tags for.</p> <p>The ARN format of a sink is <code>arn:aws:oam:<i>Region</i>:<i>account-id</i>:sink/<i>sink-id</i> </code> </p> <p>The ARN format of a link is <code>arn:aws:oam:<i>Region</i>:<i>account-id</i>:link/<i>link-id</i> </code> </p> <p>For more information about ARN format, see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/iam-access-control-overview-cwl.html">CloudWatch Logs resources and operations</a>.</p> <important> <p>Unlike tagging permissions in other Amazon Web Services services, to retrieve the list of tags for links or sinks you must have the <code>oam:RequestTag</code> permission. The <code>aws:ReguestTag</code> permission does not allow you to tag and untag links and sinks.</p> </important>
757
613
  * @public
758
614
  */
759
615
  ResourceArn: string | undefined;
@@ -791,10 +647,7 @@ export interface PutSinkPolicyInput {
791
647
  */
792
648
  SinkIdentifier: string | undefined;
793
649
  /**
794
- * <p>The JSON policy to use. If you are updating an existing policy, the entire existing policy is
795
- * replaced by what you specify here.</p>
796
- * <p>The policy must be in JSON string format with quotation marks escaped and no newlines.</p>
797
- * <p>For examples of different types of policies, see the <b>Examples</b> section on this page.</p>
650
+ * <p>The JSON policy to use. If you are updating an existing policy, the entire existing policy is replaced by what you specify here.</p> <p>The policy must be in JSON string format with quotation marks escaped and no newlines.</p> <p>For examples of different types of policies, see the <b>Examples</b> section on this page.</p>
798
651
  * @public
799
652
  */
800
653
  Policy: string | undefined;
@@ -824,17 +677,7 @@ export interface PutSinkPolicyOutput {
824
677
  */
825
678
  export interface TagResourceInput {
826
679
  /**
827
- * <p>The ARN of the resource that you're adding tags to.</p>
828
- * <p>The ARN format of a sink is
829
- * <code>arn:aws:oam:<i>Region</i>:<i>account-id</i>:sink/<i>sink-id</i>
830
- * </code>
831
- * </p>
832
- * <p>The ARN format of a link is
833
- * <code>arn:aws:oam:<i>Region</i>:<i>account-id</i>:link/<i>link-id</i>
834
- * </code>
835
- * </p>
836
- * <p>For more information about ARN format, see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/iam-access-control-overview-cwl.html">CloudWatch Logs
837
- * resources and operations</a>.</p>
680
+ * <p>The ARN of the resource that you're adding tags to.</p> <p>The ARN format of a sink is <code>arn:aws:oam:<i>Region</i>:<i>account-id</i>:sink/<i>sink-id</i> </code> </p> <p>The ARN format of a link is <code>arn:aws:oam:<i>Region</i>:<i>account-id</i>:link/<i>link-id</i> </code> </p> <p>For more information about ARN format, see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/iam-access-control-overview-cwl.html">CloudWatch Logs resources and operations</a>.</p>
838
681
  * @public
839
682
  */
840
683
  ResourceArn: string | undefined;
@@ -867,17 +710,7 @@ export declare class TooManyTagsException extends __BaseException {
867
710
  */
868
711
  export interface UntagResourceInput {
869
712
  /**
870
- * <p>The ARN of the resource that you're removing tags from.</p>
871
- * <p>The ARN format of a sink is
872
- * <code>arn:aws:oam:<i>Region</i>:<i>account-id</i>:sink/<i>sink-id</i>
873
- * </code>
874
- * </p>
875
- * <p>The ARN format of a link is
876
- * <code>arn:aws:oam:<i>Region</i>:<i>account-id</i>:link/<i>link-id</i>
877
- * </code>
878
- * </p>
879
- * <p>For more information about ARN format, see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/iam-access-control-overview-cwl.html">CloudWatch Logs
880
- * resources and operations</a>.</p>
713
+ * <p>The ARN of the resource that you're removing tags from.</p> <p>The ARN format of a sink is <code>arn:aws:oam:<i>Region</i>:<i>account-id</i>:sink/<i>sink-id</i> </code> </p> <p>The ARN format of a link is <code>arn:aws:oam:<i>Region</i>:<i>account-id</i>:link/<i>link-id</i> </code> </p> <p>For more information about ARN format, see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/iam-access-control-overview-cwl.html">CloudWatch Logs resources and operations</a>.</p>
881
714
  * @public
882
715
  */
883
716
  ResourceArn: string | undefined;
@@ -902,18 +735,20 @@ export interface UpdateLinkInput {
902
735
  */
903
736
  Identifier: string | undefined;
904
737
  /**
905
- * <p>An array of strings that define which types of data that the source account will send to the monitoring
906
- * account.</p>
907
- * <p>Your input here replaces the current set of data types that are shared.</p>
738
+ * <p>An array of strings that define which types of data that the source account will send to the monitoring account.</p> <p>Your input here replaces the current set of data types that are shared.</p>
908
739
  * @public
909
740
  */
910
741
  ResourceTypes: ResourceType[] | undefined;
911
742
  /**
912
- * <p>Use this structure to filter which metric namespaces and which log groups are to be shared from
913
- * the source account to the monitoring account.</p>
743
+ * <p>Use this structure to filter which metric namespaces and which log groups are to be shared from the source account to the monitoring account.</p>
914
744
  * @public
915
745
  */
916
746
  LinkConfiguration?: LinkConfiguration | undefined;
747
+ /**
748
+ * <p>Specifies whether to include the tags associated with the link in the response after the update operation. When <code>IncludeTags</code> is set to <code>true</code> and the caller has the required permission, <code>oam:ListTagsForResource</code>, the API will return the tags for the specified resource. If the caller doesn't have the required permission, <code>oam:ListTagsForResource</code>, the API will raise an exception. </p> <p>The default value is <code>false</code>.</p>
749
+ * @public
750
+ */
751
+ IncludeTags?: boolean | undefined;
917
752
  }
918
753
  /**
919
754
  * @public
@@ -955,8 +790,7 @@ export interface UpdateLinkOutput {
955
790
  */
956
791
  Tags?: Record<string, string> | undefined;
957
792
  /**
958
- * <p>This structure includes filters that specify which metric namespaces and which log groups are shared from
959
- * the source account to the monitoring account.</p>
793
+ * <p>This structure includes filters that specify which metric namespaces and which log groups are shared from the source account to the monitoring account.</p>
960
794
  * @public
961
795
  */
962
796
  LinkConfiguration?: LinkConfiguration | undefined;
@@ -110,6 +110,7 @@ export interface DeleteSinkInput {
110
110
  export interface DeleteSinkOutput {}
111
111
  export interface GetLinkInput {
112
112
  Identifier: string | undefined;
113
+ IncludeTags?: boolean | undefined;
113
114
  }
114
115
  export interface GetLinkOutput {
115
116
  Arn?: string | undefined;
@@ -123,6 +124,7 @@ export interface GetLinkOutput {
123
124
  }
124
125
  export interface GetSinkInput {
125
126
  Identifier: string | undefined;
127
+ IncludeTags?: boolean | undefined;
126
128
  }
127
129
  export interface GetSinkOutput {
128
130
  Arn?: string | undefined;
@@ -225,6 +227,7 @@ export interface UpdateLinkInput {
225
227
  Identifier: string | undefined;
226
228
  ResourceTypes: ResourceType[] | undefined;
227
229
  LinkConfiguration?: LinkConfiguration | undefined;
230
+ IncludeTags?: boolean | undefined;
228
231
  }
229
232
  export interface UpdateLinkOutput {
230
233
  Arn?: string | undefined;
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@aws-sdk/client-oam",
3
3
  "description": "AWS SDK for JavaScript Oam Client for Node.js, Browser and React Native",
4
- "version": "3.810.0",
4
+ "version": "3.814.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-oam",
@@ -20,17 +20,17 @@
20
20
  "dependencies": {
21
21
  "@aws-crypto/sha256-browser": "5.2.0",
22
22
  "@aws-crypto/sha256-js": "5.2.0",
23
- "@aws-sdk/core": "3.810.0",
24
- "@aws-sdk/credential-provider-node": "3.810.0",
23
+ "@aws-sdk/core": "3.812.0",
24
+ "@aws-sdk/credential-provider-node": "3.812.0",
25
25
  "@aws-sdk/middleware-host-header": "3.804.0",
26
26
  "@aws-sdk/middleware-logger": "3.804.0",
27
27
  "@aws-sdk/middleware-recursion-detection": "3.804.0",
28
- "@aws-sdk/middleware-user-agent": "3.810.0",
28
+ "@aws-sdk/middleware-user-agent": "3.812.0",
29
29
  "@aws-sdk/region-config-resolver": "3.808.0",
30
30
  "@aws-sdk/types": "3.804.0",
31
31
  "@aws-sdk/util-endpoints": "3.808.0",
32
32
  "@aws-sdk/util-user-agent-browser": "3.804.0",
33
- "@aws-sdk/util-user-agent-node": "3.810.0",
33
+ "@aws-sdk/util-user-agent-node": "3.812.0",
34
34
  "@smithy/config-resolver": "^4.1.2",
35
35
  "@smithy/core": "^3.3.3",
36
36
  "@smithy/fetch-http-handler": "^5.0.2",