@aws-sdk/client-resource-groups-tagging-api 3.379.1 → 3.382.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.
@@ -7,15 +7,18 @@ import { ResourceGroupsTaggingAPIServiceException as __BaseException } from "./R
7
7
  */
8
8
  export interface ComplianceDetails {
9
9
  /**
10
+ * @public
10
11
  * <p>These tag keys on the resource are noncompliant with the effective tag policy.</p>
11
12
  */
12
13
  NoncompliantKeys?: string[];
13
14
  /**
15
+ * @public
14
16
  * <p>These are keys defined in the effective policy that are on the resource with either
15
17
  * incorrect case treatment or noncompliant values. </p>
16
18
  */
17
19
  KeysWithNoncompliantValues?: string[];
18
20
  /**
21
+ * @public
19
22
  * <p>Whether a resource is compliant with the effective tag policy.</p>
20
23
  */
21
24
  ComplianceStatus?: boolean;
@@ -76,6 +79,7 @@ export interface DescribeReportCreationInput {
76
79
  */
77
80
  export interface DescribeReportCreationOutput {
78
81
  /**
82
+ * @public
79
83
  * <p>Reports the status of the operation.</p>
80
84
  * <p>The operation status can be one of the following:</p>
81
85
  * <ul>
@@ -102,14 +106,17 @@ export interface DescribeReportCreationOutput {
102
106
  */
103
107
  Status?: string;
104
108
  /**
109
+ * @public
105
110
  * <p>The path to the Amazon S3 bucket where the report was stored on creation.</p>
106
111
  */
107
112
  S3Location?: string;
108
113
  /**
114
+ * @public
109
115
  * <p>The date and time that the report was started. </p>
110
116
  */
111
117
  StartDate?: string;
112
118
  /**
119
+ * @public
113
120
  * <p>Details of the common errors that all operations return.</p>
114
121
  */
115
122
  ErrorMessage?: string;
@@ -222,10 +229,12 @@ export type ErrorCode = (typeof ErrorCode)[keyof typeof ErrorCode];
222
229
  */
223
230
  export interface FailureInfo {
224
231
  /**
232
+ * @public
225
233
  * <p>The HTTP status code of the common error.</p>
226
234
  */
227
235
  StatusCode?: number;
228
236
  /**
237
+ * @public
229
238
  * <p>The code of the common error. Valid values include
230
239
  * <code>InternalServiceException</code>, <code>InvalidParameterException</code>, and
231
240
  * any valid error code returned by the Amazon Web Services service that hosts the resource that you want
@@ -233,6 +242,7 @@ export interface FailureInfo {
233
242
  */
234
243
  ErrorCode?: ErrorCode | string;
235
244
  /**
245
+ * @public
236
246
  * <p>The message of the common error.</p>
237
247
  */
238
248
  ErrorMessage?: string;
@@ -255,18 +265,21 @@ export type GroupByAttribute = (typeof GroupByAttribute)[keyof typeof GroupByAtt
255
265
  */
256
266
  export interface GetComplianceSummaryInput {
257
267
  /**
268
+ * @public
258
269
  * <p>Specifies target identifiers (usually, specific account IDs) to limit the output by.
259
270
  * If you use this parameter, the count of returned noncompliant resources includes only
260
271
  * resources with the specified target IDs.</p>
261
272
  */
262
273
  TargetIdFilters?: string[];
263
274
  /**
275
+ * @public
264
276
  * <p>Specifies a list of Amazon Web Services Regions to limit the output to. If you use this parameter,
265
277
  * the count of returned noncompliant resources includes only resources in the specified
266
278
  * Regions.</p>
267
279
  */
268
280
  RegionFilters?: string[];
269
281
  /**
282
+ * @public
270
283
  * <p>Specifies that you want the response to include information for only resources of the
271
284
  * specified types. The format of each resource type is
272
285
  * <code>service[:resourceType]</code>. For example, specifying a resource type of
@@ -297,17 +310,20 @@ export interface GetComplianceSummaryInput {
297
310
  */
298
311
  ResourceTypeFilters?: string[];
299
312
  /**
313
+ * @public
300
314
  * <p>Specifies that you want the response to include information for only resources that
301
315
  * have tags with the specified tag keys. If you use this parameter, the count of returned
302
316
  * noncompliant resources includes only resources that have the specified tag keys.</p>
303
317
  */
304
318
  TagKeyFilters?: string[];
305
319
  /**
320
+ * @public
306
321
  * <p>Specifies a list of attributes to group the counts of noncompliant resources by. If
307
322
  * supplied, the counts are sorted by those attributes.</p>
308
323
  */
309
324
  GroupBy?: (GroupByAttribute | string)[];
310
325
  /**
326
+ * @public
311
327
  * <p>Specifies the maximum number of results to be returned in each page. A
312
328
  * query can return fewer than this maximum, even if there are more results still to return. You
313
329
  * should always check the <code>PaginationToken</code> response value to see if there are more
@@ -315,6 +331,7 @@ export interface GetComplianceSummaryInput {
315
331
  */
316
332
  MaxResults?: number;
317
333
  /**
334
+ * @public
318
335
  * <p>Specifies a <code>PaginationToken</code> response value from a
319
336
  * previous request to indicate that you want the next page of results. Leave this parameter empty
320
337
  * in your initial request.</p>
@@ -340,27 +357,33 @@ export type TargetIdType = (typeof TargetIdType)[keyof typeof TargetIdType];
340
357
  */
341
358
  export interface Summary {
342
359
  /**
360
+ * @public
343
361
  * <p>The timestamp that shows when this summary was generated in this Region. </p>
344
362
  */
345
363
  LastUpdated?: string;
346
364
  /**
365
+ * @public
347
366
  * <p>The account identifier or the root identifier of the organization. If you don't know
348
367
  * the root ID, you can call the Organizations <a href="https://docs.aws.amazon.com/organizations/latest/APIReference/API_ListRoots.html">ListRoots</a> API.</p>
349
368
  */
350
369
  TargetId?: string;
351
370
  /**
371
+ * @public
352
372
  * <p>Whether the target is an account, an OU, or the organization root.</p>
353
373
  */
354
374
  TargetIdType?: TargetIdType | string;
355
375
  /**
376
+ * @public
356
377
  * <p>The Amazon Web Services Region that the summary applies to.</p>
357
378
  */
358
379
  Region?: string;
359
380
  /**
381
+ * @public
360
382
  * <p>The Amazon Web Services resource type.</p>
361
383
  */
362
384
  ResourceType?: string;
363
385
  /**
386
+ * @public
364
387
  * <p>The count of noncompliant resources.</p>
365
388
  */
366
389
  NonCompliantResources?: number;
@@ -370,10 +393,12 @@ export interface Summary {
370
393
  */
371
394
  export interface GetComplianceSummaryOutput {
372
395
  /**
396
+ * @public
373
397
  * <p>A table that shows counts of noncompliant resources.</p>
374
398
  */
375
399
  SummaryList?: Summary[];
376
400
  /**
401
+ * @public
377
402
  * <p>A string that indicates that there is more data available than this
378
403
  * response contains. To receive the next part of the response, specify this response value
379
404
  * as the <code>PaginationToken</code> value in the request for the next page.</p>
@@ -387,11 +412,13 @@ export interface GetComplianceSummaryOutput {
387
412
  */
388
413
  export interface TagFilter {
389
414
  /**
415
+ * @public
390
416
  * <p>One part of a key-value pair that makes up a tag. A key is a general label
391
417
  * that acts like a category for more specific tag values.</p>
392
418
  */
393
419
  Key?: string;
394
420
  /**
421
+ * @public
395
422
  * <p>One part of a key-value pair that make up a tag. A value acts as a
396
423
  * descriptor within a tag category (key). The value can be empty or null.</p>
397
424
  */
@@ -402,12 +429,14 @@ export interface TagFilter {
402
429
  */
403
430
  export interface GetResourcesInput {
404
431
  /**
432
+ * @public
405
433
  * <p>Specifies a <code>PaginationToken</code> response value from a
406
434
  * previous request to indicate that you want the next page of results. Leave this parameter empty
407
435
  * in your initial request.</p>
408
436
  */
409
437
  PaginationToken?: string;
410
438
  /**
439
+ * @public
411
440
  * <p>Specifies a list of TagFilters (keys and values) to restrict the output to only those
412
441
  * resources that have tags with the specified keys and, if included, the specified values.
413
442
  * Each <code>TagFilter</code> must contain a key with values optional. A request can
@@ -467,6 +496,7 @@ export interface GetResourcesInput {
467
496
  */
468
497
  TagFilters?: TagFilter[];
469
498
  /**
499
+ * @public
470
500
  * <p>Specifies the maximum number of results to be returned in each page. A
471
501
  * query can return fewer than this maximum, even if there are more results still to return. You
472
502
  * should always check the <code>PaginationToken</code> response value to see if there are more
@@ -474,6 +504,7 @@ export interface GetResourcesInput {
474
504
  */
475
505
  ResourcesPerPage?: number;
476
506
  /**
507
+ * @public
477
508
  * <p>Amazon Web Services recommends using <code>ResourcesPerPage</code> instead of this parameter.</p>
478
509
  * <p>A limit that restricts the number of tags (key and value pairs) returned by
479
510
  * <code>GetResources</code> in paginated output. A resource with no tags is counted as
@@ -493,6 +524,7 @@ export interface GetResourcesInput {
493
524
  */
494
525
  TagsPerPage?: number;
495
526
  /**
527
+ * @public
496
528
  * <p>Specifies the resource types that you want included in the response. The format of
497
529
  * each resource type is <code>service[:resourceType]</code>. For example, specifying a
498
530
  * resource type of <code>ec2</code> returns all Amazon EC2 resources (which includes EC2
@@ -511,12 +543,14 @@ export interface GetResourcesInput {
511
543
  */
512
544
  ResourceTypeFilters?: string[];
513
545
  /**
546
+ * @public
514
547
  * <p>Specifies whether to include details regarding the compliance with the effective tag
515
548
  * policy. Set this to <code>true</code> to determine whether resources are compliant with
516
549
  * the tag policy and to get details.</p>
517
550
  */
518
551
  IncludeComplianceDetails?: boolean;
519
552
  /**
553
+ * @public
520
554
  * <p>Specifies whether to exclude resources that are compliant with the tag policy. Set
521
555
  * this to <code>true</code> if you are interested in retrieving information on
522
556
  * noncompliant resources only.</p>
@@ -525,6 +559,7 @@ export interface GetResourcesInput {
525
559
  */
526
560
  ExcludeCompliantResources?: boolean;
527
561
  /**
562
+ * @public
528
563
  * <p>Specifies a list of ARNs of resources for which you want to retrieve tag data. You
529
564
  * can't specify both this parameter and any of the pagination parameters
530
565
  * (<code>ResourcesPerPage</code>, <code>TagsPerPage</code>,
@@ -547,11 +582,13 @@ export interface GetResourcesInput {
547
582
  */
548
583
  export interface Tag {
549
584
  /**
585
+ * @public
550
586
  * <p>One part of a key-value pair that makes up a tag. A key is a general label
551
587
  * that acts like a category for more specific tag values.</p>
552
588
  */
553
589
  Key: string | undefined;
554
590
  /**
591
+ * @public
555
592
  * <p>One part of a key-value pair that make up a tag. A value acts as a
556
593
  * descriptor within a tag category (key). The value can be empty or null.</p>
557
594
  */
@@ -564,14 +601,17 @@ export interface Tag {
564
601
  */
565
602
  export interface ResourceTagMapping {
566
603
  /**
604
+ * @public
567
605
  * <p>The ARN of the resource.</p>
568
606
  */
569
607
  ResourceARN?: string;
570
608
  /**
609
+ * @public
571
610
  * <p>The tags that have been applied to one or more Amazon Web Services resources.</p>
572
611
  */
573
612
  Tags?: Tag[];
574
613
  /**
614
+ * @public
575
615
  * <p>Information that shows whether a resource is compliant with the effective tag policy,
576
616
  * including details on any noncompliant tag keys.</p>
577
617
  */
@@ -582,12 +622,14 @@ export interface ResourceTagMapping {
582
622
  */
583
623
  export interface GetResourcesOutput {
584
624
  /**
625
+ * @public
585
626
  * <p>A string that indicates that there is more data available than this
586
627
  * response contains. To receive the next part of the response, specify this response value
587
628
  * as the <code>PaginationToken</code> value in the request for the next page.</p>
588
629
  */
589
630
  PaginationToken?: string;
590
631
  /**
632
+ * @public
591
633
  * <p>A list of resource ARNs and the tags (keys and values) associated with
592
634
  * each.</p>
593
635
  */
@@ -612,6 +654,7 @@ export declare class PaginationTokenExpiredException extends __BaseException {
612
654
  */
613
655
  export interface GetTagKeysInput {
614
656
  /**
657
+ * @public
615
658
  * <p>Specifies a <code>PaginationToken</code> response value from a
616
659
  * previous request to indicate that you want the next page of results. Leave this parameter empty
617
660
  * in your initial request.</p>
@@ -623,12 +666,14 @@ export interface GetTagKeysInput {
623
666
  */
624
667
  export interface GetTagKeysOutput {
625
668
  /**
669
+ * @public
626
670
  * <p>A string that indicates that there is more data available than this
627
671
  * response contains. To receive the next part of the response, specify this response value
628
672
  * as the <code>PaginationToken</code> value in the request for the next page.</p>
629
673
  */
630
674
  PaginationToken?: string;
631
675
  /**
676
+ * @public
632
677
  * <p>A list of all tag keys in the Amazon Web Services account.</p>
633
678
  */
634
679
  TagKeys?: string[];
@@ -638,12 +683,14 @@ export interface GetTagKeysOutput {
638
683
  */
639
684
  export interface GetTagValuesInput {
640
685
  /**
686
+ * @public
641
687
  * <p>Specifies a <code>PaginationToken</code> response value from a
642
688
  * previous request to indicate that you want the next page of results. Leave this parameter empty
643
689
  * in your initial request.</p>
644
690
  */
645
691
  PaginationToken?: string;
646
692
  /**
693
+ * @public
647
694
  * <p>Specifies the tag key for which you want to list all existing values that are
648
695
  * currently used in the specified Amazon Web Services Region for the calling account.</p>
649
696
  */
@@ -654,12 +701,14 @@ export interface GetTagValuesInput {
654
701
  */
655
702
  export interface GetTagValuesOutput {
656
703
  /**
704
+ * @public
657
705
  * <p>A string that indicates that there is more data available than this
658
706
  * response contains. To receive the next part of the response, specify this response value
659
707
  * as the <code>PaginationToken</code> value in the request for the next page.</p>
660
708
  */
661
709
  PaginationToken?: string;
662
710
  /**
711
+ * @public
663
712
  * <p>A list of all tag values for the specified key currently used in the specified Amazon Web Services
664
713
  * Region for the calling account.</p>
665
714
  */
@@ -670,6 +719,7 @@ export interface GetTagValuesOutput {
670
719
  */
671
720
  export interface StartReportCreationInput {
672
721
  /**
722
+ * @public
673
723
  * <p>The name of the Amazon S3 bucket where the report will be stored; for example:</p>
674
724
  * <p>
675
725
  * <code>awsexamplebucket</code>
@@ -689,6 +739,7 @@ export interface StartReportCreationOutput {
689
739
  */
690
740
  export interface TagResourcesInput {
691
741
  /**
742
+ * @public
692
743
  * <p>Specifies the list of ARNs of the resources that you want to apply tags to.</p>
693
744
  * <p>An ARN (Amazon Resource Name) uniquely identifies a resource. For more information,
694
745
  * see <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon
@@ -697,6 +748,7 @@ export interface TagResourcesInput {
697
748
  */
698
749
  ResourceARNList: string[] | undefined;
699
750
  /**
751
+ * @public
700
752
  * <p>Specifies a list of tags that you want to add to the specified resources. A tag
701
753
  * consists of a key and a value that you define.</p>
702
754
  */
@@ -707,6 +759,7 @@ export interface TagResourcesInput {
707
759
  */
708
760
  export interface TagResourcesOutput {
709
761
  /**
762
+ * @public
710
763
  * <p>A map containing a key-value pair for each failed item that couldn't be tagged. The
711
764
  * key is the ARN of the failed resource. The value is a <code>FailureInfo</code> object
712
765
  * that contains an error code, a status code, and an error message. If there are no
@@ -719,6 +772,7 @@ export interface TagResourcesOutput {
719
772
  */
720
773
  export interface UntagResourcesInput {
721
774
  /**
775
+ * @public
722
776
  * <p>Specifies a list of ARNs of the resources that you want to remove tags from.</p>
723
777
  * <p>An ARN (Amazon Resource Name) uniquely identifies a resource. For more information,
724
778
  * see <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon
@@ -727,6 +781,7 @@ export interface UntagResourcesInput {
727
781
  */
728
782
  ResourceARNList: string[] | undefined;
729
783
  /**
784
+ * @public
730
785
  * <p>Specifies a list of tag keys that you want to remove from the specified
731
786
  * resources.</p>
732
787
  */
@@ -737,6 +792,7 @@ export interface UntagResourcesInput {
737
792
  */
738
793
  export interface UntagResourcesOutput {
739
794
  /**
795
+ * @public
740
796
  * <p>A map containing a key-value pair for each failed item that couldn't be untagged. The
741
797
  * key is the ARN of the failed resource. The value is a <code>FailureInfo</code> object
742
798
  * that contains an error code, a status code, and an error message. If there are no
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@aws-sdk/client-resource-groups-tagging-api",
3
3
  "description": "AWS SDK for JavaScript Resource Groups Tagging Api Client for Node.js, Browser and React Native",
4
- "version": "3.379.1",
4
+ "version": "3.382.0",
5
5
  "scripts": {
6
6
  "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
7
7
  "build:cjs": "tsc -p tsconfig.cjs.json",
@@ -21,15 +21,15 @@
21
21
  "dependencies": {
22
22
  "@aws-crypto/sha256-browser": "3.0.0",
23
23
  "@aws-crypto/sha256-js": "3.0.0",
24
- "@aws-sdk/client-sts": "3.379.1",
25
- "@aws-sdk/credential-provider-node": "3.379.1",
24
+ "@aws-sdk/client-sts": "3.382.0",
25
+ "@aws-sdk/credential-provider-node": "3.382.0",
26
26
  "@aws-sdk/middleware-host-header": "3.379.1",
27
27
  "@aws-sdk/middleware-logger": "3.378.0",
28
28
  "@aws-sdk/middleware-recursion-detection": "3.378.0",
29
29
  "@aws-sdk/middleware-signing": "3.379.1",
30
- "@aws-sdk/middleware-user-agent": "3.379.1",
30
+ "@aws-sdk/middleware-user-agent": "3.382.0",
31
31
  "@aws-sdk/types": "3.378.0",
32
- "@aws-sdk/util-endpoints": "3.378.0",
32
+ "@aws-sdk/util-endpoints": "3.382.0",
33
33
  "@aws-sdk/util-user-agent-browser": "3.378.0",
34
34
  "@aws-sdk/util-user-agent-node": "3.378.0",
35
35
  "@smithy/config-resolver": "^2.0.1",