aws-sdk-iam 1.43.0 → 1.48.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.
@@ -25,7 +25,10 @@ module Aws::IAM
25
25
  # @!group Read-Only Attributes
26
26
 
27
27
  # The path to the user. For more information about paths, see [IAM
28
- # Identifiers][1] in the *IAM User Guide*.
28
+ # identifiers][1] in the *IAM User Guide*.
29
+ #
30
+ # The ARN of the policy used to set the permissions boundary for the
31
+ # user.
29
32
  #
30
33
  #
31
34
  #
@@ -42,7 +45,7 @@ module Aws::IAM
42
45
  end
43
46
 
44
47
  # The stable and unique string identifying the user. For more
45
- # information about IDs, see [IAM Identifiers][1] in the *IAM User
48
+ # information about IDs, see [IAM identifiers][1] in the *IAM User
46
49
  # Guide*.
47
50
  #
48
51
  #
@@ -79,7 +82,7 @@ module Aws::IAM
79
82
  # The date and time, in [ISO 8601 date-time format][1], when the user's
80
83
  # password was last used to sign in to an AWS website. For a list of AWS
81
84
  # websites that capture a user's last sign-in time, see the [Credential
82
- # Reports][2] topic in the *IAM User Guide*. If a password is used more
85
+ # reports][2] topic in the *IAM User Guide*. If a password is used more
83
86
  # than once in a five-minute span, only the first use is returned in
84
87
  # this field. If the field is null (no value), then it indicates that
85
88
  # they never signed in with a password. This can be because:
@@ -105,11 +108,8 @@ module Aws::IAM
105
108
  data[:password_last_used]
106
109
  end
107
110
 
108
- # The ARN of the policy used to set the permissions boundary for the
109
- # user.
110
- #
111
111
  # For more information about permissions boundaries, see [Permissions
112
- # Boundaries for IAM Identities ][1] in the *IAM User Guide*.
112
+ # boundaries for IAM identities ][1] in the *IAM User Guide*.
113
113
  #
114
114
  #
115
115
  #
@@ -119,9 +119,8 @@ module Aws::IAM
119
119
  data[:permissions_boundary]
120
120
  end
121
121
 
122
- # A list of tags that are associated with the specified user. For more
123
- # information about tagging, see [Tagging IAM Identities][1] in the *IAM
124
- # User Guide*.
122
+ # A list of tags that are associated with the user. For more information
123
+ # about tagging, see [Tagging IAM resources][1] in the *IAM User Guide*.
125
124
  #
126
125
  #
127
126
  #
@@ -36,7 +36,7 @@ module Aws::IAM
36
36
  alias :group_name :name
37
37
 
38
38
  # The path to the group. For more information about paths, see [IAM
39
- # Identifiers][1] in the *IAM User Guide*.
39
+ # identifiers][1] in the *IAM User Guide*.
40
40
  #
41
41
  #
42
42
  #
@@ -47,7 +47,7 @@ module Aws::IAM
47
47
  end
48
48
 
49
49
  # The stable and unique string identifying the group. For more
50
- # information about IDs, see [IAM Identifiers][1] in the *IAM User
50
+ # information about IDs, see [IAM identifiers][1] in the *IAM User
51
51
  # Guide*.
52
52
  #
53
53
  #
@@ -60,7 +60,7 @@ module Aws::IAM
60
60
 
61
61
  # The Amazon Resource Name (ARN) specifying the group. For more
62
62
  # information about ARNs and how to use them in policies, see [IAM
63
- # Identifiers][1] in the *IAM User Guide*.
63
+ # identifiers][1] in the *IAM User Guide*.
64
64
  #
65
65
  #
66
66
  #
@@ -248,8 +248,8 @@ module Aws::IAM
248
248
  # @option options [required, String] :policy_arn
249
249
  # The Amazon Resource Name (ARN) of the IAM policy you want to attach.
250
250
  #
251
- # For more information about ARNs, see [Amazon Resource Names (ARNs) and
252
- # AWS Service Namespaces][1] in the *AWS General Reference*.
251
+ # For more information about ARNs, see [Amazon Resource Names (ARNs)][1]
252
+ # in the *AWS General Reference*.
253
253
  #
254
254
  #
255
255
  #
@@ -269,7 +269,7 @@ module Aws::IAM
269
269
  # @param [Hash] options ({})
270
270
  # @option options [String] :path
271
271
  # The path to the group. For more information about paths, see [IAM
272
- # Identifiers][1] in the *IAM User Guide*.
272
+ # identifiers][1] in the *IAM User Guide*.
273
273
  #
274
274
  # This parameter is optional. If it is not included, it defaults to a
275
275
  # slash (/).
@@ -368,8 +368,8 @@ module Aws::IAM
368
368
  # @option options [required, String] :policy_arn
369
369
  # The Amazon Resource Name (ARN) of the IAM policy you want to detach.
370
370
  #
371
- # For more information about ARNs, see [Amazon Resource Names (ARNs) and
372
- # AWS Service Namespaces][1] in the *AWS General Reference*.
371
+ # For more information about ARNs, see [Amazon Resource Names (ARNs)][1]
372
+ # in the *AWS General Reference*.
373
373
  #
374
374
  #
375
375
  #
@@ -36,7 +36,7 @@ module Aws::IAM
36
36
  alias :instance_profile_name :name
37
37
 
38
38
  # The path to the instance profile. For more information about paths,
39
- # see [IAM Identifiers][1] in the *IAM User Guide*.
39
+ # see [IAM identifiers][1] in the *IAM User Guide*.
40
40
  #
41
41
  #
42
42
  #
@@ -47,7 +47,7 @@ module Aws::IAM
47
47
  end
48
48
 
49
49
  # The stable and unique string identifying the instance profile. For
50
- # more information about IDs, see [IAM Identifiers][1] in the *IAM User
50
+ # more information about IDs, see [IAM identifiers][1] in the *IAM User
51
51
  # Guide*.
52
52
  #
53
53
  #
@@ -60,7 +60,7 @@ module Aws::IAM
60
60
 
61
61
  # The Amazon Resource Name (ARN) specifying the instance profile. For
62
62
  # more information about ARNs and how to use them in policies, see [IAM
63
- # Identifiers][1] in the *IAM User Guide*.
63
+ # identifiers][1] in the *IAM User Guide*.
64
64
  #
65
65
  #
66
66
  #
@@ -76,6 +76,18 @@ module Aws::IAM
76
76
  data[:create_date]
77
77
  end
78
78
 
79
+ # A list of tags that are attached to the instance profile. For more
80
+ # information about tagging, see [Tagging IAM resources][1] in the *IAM
81
+ # User Guide*.
82
+ #
83
+ #
84
+ #
85
+ # [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/id_tags.html
86
+ # @return [Array<Types::Tag>]
87
+ def tags
88
+ data[:tags]
89
+ end
90
+
79
91
  # @!endgroup
80
92
 
81
93
  # @return [Client]
@@ -42,7 +42,7 @@ module Aws::IAM
42
42
 
43
43
  # The stable and unique string identifying the policy.
44
44
  #
45
- # For more information about IDs, see [IAM Identifiers][1] in the *IAM
45
+ # For more information about IDs, see [IAM identifiers][1] in the *IAM
46
46
  # User Guide*.
47
47
  #
48
48
  #
@@ -55,7 +55,7 @@ module Aws::IAM
55
55
 
56
56
  # The path to the policy.
57
57
  #
58
- # For more information about paths, see [IAM Identifiers][1] in the *IAM
58
+ # For more information about paths, see [IAM identifiers][1] in the *IAM
59
59
  # User Guide*.
60
60
  #
61
61
  #
@@ -84,7 +84,7 @@ module Aws::IAM
84
84
  # to set the permissions boundary.
85
85
  #
86
86
  # For more information about permissions boundaries, see [Permissions
87
- # Boundaries for IAM Identities ][1] in the *IAM User Guide*.
87
+ # boundaries for IAM identities ][1] in the *IAM User Guide*.
88
88
  #
89
89
  #
90
90
  #
@@ -137,6 +137,18 @@ module Aws::IAM
137
137
  data[:update_date]
138
138
  end
139
139
 
140
+ # A list of tags that are attached to the instance profile. For more
141
+ # information about tagging, see [Tagging IAM resources][1] in the *IAM
142
+ # User Guide*.
143
+ #
144
+ #
145
+ #
146
+ # [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/id_tags.html
147
+ # @return [Array<Types::Tag>]
148
+ def tags
149
+ data[:tags]
150
+ end
151
+
140
152
  # @!endgroup
141
153
 
142
154
  # @return [Client]
@@ -385,7 +397,7 @@ module Aws::IAM
385
397
  # for the IAM users, groups, and roles that the policy is attached to.
386
398
  #
387
399
  # For more information about managed policy versions, see [Versioning
388
- # for Managed Policies][1] in the *IAM User Guide*.
400
+ # for managed policies][1] in the *IAM User Guide*.
389
401
  #
390
402
  #
391
403
  #
@@ -141,7 +141,7 @@ module Aws::IAM
141
141
  # @option options [Boolean] :allow_users_to_change_password
142
142
  # Allows all IAM users in your account to use the AWS Management Console
143
143
  # to change their own passwords. For more information, see [Letting IAM
144
- # Users Change Their Own Passwords][1] in the *IAM User Guide*.
144
+ # users change their own passwords][1] in the *IAM User Guide*.
145
145
  #
146
146
  # If you do not specify a value for this parameter, then the operation
147
147
  # uses the default value of `false`. The result is that IAM users in the
@@ -188,7 +188,7 @@ module Aws::IAM
188
188
  # @param [Hash] options ({})
189
189
  # @option options [String] :path
190
190
  # The path to the group. For more information about paths, see [IAM
191
- # Identifiers][1] in the *IAM User Guide*.
191
+ # identifiers][1] in the *IAM User Guide*.
192
192
  #
193
193
  # This parameter is optional. If it is not included, it defaults to a
194
194
  # slash (/).
@@ -226,6 +226,12 @@ module Aws::IAM
226
226
  # instanceprofile = iam.create_instance_profile({
227
227
  # instance_profile_name: "instanceProfileNameType", # required
228
228
  # path: "pathType",
229
+ # tags: [
230
+ # {
231
+ # key: "tagKeyType", # required
232
+ # value: "tagValueType", # required
233
+ # },
234
+ # ],
229
235
  # })
230
236
  # @param [Hash] options ({})
231
237
  # @option options [required, String] :instance_profile_name
@@ -257,6 +263,21 @@ module Aws::IAM
257
263
  #
258
264
  # [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/Using_Identifiers.html
259
265
  # [2]: http://wikipedia.org/wiki/regex
266
+ # @option options [Array<Types::Tag>] :tags
267
+ # A list of tags that you want to attach to the newly created IAM
268
+ # instance profile. Each tag consists of a key name and an associated
269
+ # value. For more information about tagging, see [Tagging IAM
270
+ # resources][1] in the *IAM User Guide*.
271
+ #
272
+ # <note markdown="1"> If any one of the tags is invalid or if you exceed the allowed maximum
273
+ # number of tags, then the entire request fails and the resource is not
274
+ # created.
275
+ #
276
+ # </note>
277
+ #
278
+ #
279
+ #
280
+ # [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/id_tags.html
260
281
  # @return [InstanceProfile]
261
282
  def create_instance_profile(options = {})
262
283
  resp = @client.create_instance_profile(options)
@@ -274,6 +295,12 @@ module Aws::IAM
274
295
  # path: "policyPathType",
275
296
  # policy_document: "policyDocumentType", # required
276
297
  # description: "policyDescriptionType",
298
+ # tags: [
299
+ # {
300
+ # key: "tagKeyType", # required
301
+ # value: "tagValueType", # required
302
+ # },
303
+ # ],
277
304
  # })
278
305
  # @param [Hash] options ({})
279
306
  # @option options [required, String] :policy_name
@@ -285,7 +312,7 @@ module Aws::IAM
285
312
  # @option options [String] :path
286
313
  # The path for the policy.
287
314
  #
288
- # For more information about paths, see [IAM Identifiers][1] in the *IAM
315
+ # For more information about paths, see [IAM identifiers][1] in the *IAM
289
316
  # User Guide*.
290
317
  #
291
318
  # This parameter is optional. If it is not included, it defaults to a
@@ -335,6 +362,21 @@ module Aws::IAM
335
362
  #
336
363
  # The policy description is immutable. After a value is assigned, it
337
364
  # cannot be changed.
365
+ # @option options [Array<Types::Tag>] :tags
366
+ # A list of tags that you want to attach to the new IAM customer managed
367
+ # policy. Each tag consists of a key name and an associated value. For
368
+ # more information about tagging, see [Tagging IAM resources][1] in the
369
+ # *IAM User Guide*.
370
+ #
371
+ # <note markdown="1"> If any one of the tags is invalid or if you exceed the allowed maximum
372
+ # number of tags, then the entire request fails and the resource is not
373
+ # created.
374
+ #
375
+ # </note>
376
+ #
377
+ #
378
+ #
379
+ # [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/id_tags.html
338
380
  # @return [Policy]
339
381
  def create_policy(options = {})
340
382
  resp = @client.create_policy(options)
@@ -430,7 +472,7 @@ module Aws::IAM
430
472
  # for one hour by default. This applies when you use the `AssumeRole*`
431
473
  # API operations or the `assume-role*` CLI operations but does not apply
432
474
  # when you use those operations to create a console URL. For more
433
- # information, see [Using IAM Roles][1] in the *IAM User Guide*.
475
+ # information, see [Using IAM roles][1] in the *IAM User Guide*.
434
476
  #
435
477
  #
436
478
  #
@@ -439,13 +481,12 @@ module Aws::IAM
439
481
  # The ARN of the policy that is used to set the permissions boundary for
440
482
  # the role.
441
483
  # @option options [Array<Types::Tag>] :tags
442
- # A list of tags that you want to attach to the newly created role. Each
443
- # tag consists of a key name and an associated value. For more
444
- # information about tagging, see [Tagging IAM Identities][1] in the *IAM
445
- # User Guide*.
484
+ # A list of tags that you want to attach to the new role. Each tag
485
+ # consists of a key name and an associated value. For more information
486
+ # about tagging, see [Tagging IAM resources][1] in the *IAM User Guide*.
446
487
  #
447
- # <note markdown="1"> If any one of the tags is invalid or if you exceed the allowed number
448
- # of tags per role, then the entire request fails and the role is not
488
+ # <note markdown="1"> If any one of the tags is invalid or if you exceed the allowed maximum
489
+ # number of tags, then the entire request fails and the resource is not
449
490
  # created.
450
491
  #
451
492
  # </note>
@@ -468,6 +509,12 @@ module Aws::IAM
468
509
  # samlprovider = iam.create_saml_provider({
469
510
  # saml_metadata_document: "SAMLMetadataDocumentType", # required
470
511
  # name: "SAMLProviderNameType", # required
512
+ # tags: [
513
+ # {
514
+ # key: "tagKeyType", # required
515
+ # value: "tagValueType", # required
516
+ # },
517
+ # ],
471
518
  # })
472
519
  # @param [Hash] options ({})
473
520
  # @option options [required, String] :saml_metadata_document
@@ -478,7 +525,7 @@ module Aws::IAM
478
525
  # You must generate the metadata document using the identity management
479
526
  # software that is used as your organization's IdP.
480
527
  #
481
- # For more information, see [About SAML 2.0-based Federation][1] in the
528
+ # For more information, see [About SAML 2.0-based federation][1] in the
482
529
  # *IAM User Guide*
483
530
  #
484
531
  #
@@ -495,6 +542,21 @@ module Aws::IAM
495
542
  #
496
543
  #
497
544
  # [1]: http://wikipedia.org/wiki/regex
545
+ # @option options [Array<Types::Tag>] :tags
546
+ # A list of tags that you want to attach to the new IAM SAML provider.
547
+ # Each tag consists of a key name and an associated value. For more
548
+ # information about tagging, see [Tagging IAM resources][1] in the *IAM
549
+ # User Guide*.
550
+ #
551
+ # <note markdown="1"> If any one of the tags is invalid or if you exceed the allowed maximum
552
+ # number of tags, then the entire request fails and the resource is not
553
+ # created.
554
+ #
555
+ # </note>
556
+ #
557
+ #
558
+ #
559
+ # [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/id_tags.html
498
560
  # @return [SamlProvider]
499
561
  def create_saml_provider(options = {})
500
562
  resp = @client.create_saml_provider(options)
@@ -512,11 +574,17 @@ module Aws::IAM
512
574
  # certificate_body: "certificateBodyType", # required
513
575
  # private_key: "privateKeyType", # required
514
576
  # certificate_chain: "certificateChainType",
577
+ # tags: [
578
+ # {
579
+ # key: "tagKeyType", # required
580
+ # value: "tagValueType", # required
581
+ # },
582
+ # ],
515
583
  # })
516
584
  # @param [Hash] options ({})
517
585
  # @option options [String] :path
518
586
  # The path for the server certificate. For more information about paths,
519
- # see [IAM Identifiers][1] in the *IAM User Guide*.
587
+ # see [IAM identifiers][1] in the *IAM User Guide*.
520
588
  #
521
589
  # This parameter is optional. If it is not included, it defaults to a
522
590
  # slash (/). This parameter allows (through its [regex pattern][2]) a
@@ -604,6 +672,21 @@ module Aws::IAM
604
672
  #
605
673
  #
606
674
  # [1]: http://wikipedia.org/wiki/regex
675
+ # @option options [Array<Types::Tag>] :tags
676
+ # A list of tags that you want to attach to the new IAM server
677
+ # certificate resource. Each tag consists of a key name and an
678
+ # associated value. For more information about tagging, see [Tagging IAM
679
+ # resources][1] in the *IAM User Guide*.
680
+ #
681
+ # <note markdown="1"> If any one of the tags is invalid or if you exceed the allowed maximum
682
+ # number of tags, then the entire request fails and the resource is not
683
+ # created.
684
+ #
685
+ # </note>
686
+ #
687
+ #
688
+ #
689
+ # [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/id_tags.html
607
690
  # @return [ServerCertificate]
608
691
  def create_server_certificate(options = {})
609
692
  @client.upload_server_certificate(options)
@@ -675,7 +758,7 @@ module Aws::IAM
675
758
  # @param [Hash] options ({})
676
759
  # @option options [String] :path
677
760
  # The path for the user name. For more information about paths, see [IAM
678
- # Identifiers][1] in the *IAM User Guide*.
761
+ # identifiers][1] in the *IAM User Guide*.
679
762
  #
680
763
  # This parameter is optional. If it is not included, it defaults to a
681
764
  # slash (/).
@@ -701,13 +784,12 @@ module Aws::IAM
701
784
  # The ARN of the policy that is used to set the permissions boundary for
702
785
  # the user.
703
786
  # @option options [Array<Types::Tag>] :tags
704
- # A list of tags that you want to attach to the newly created user. Each
705
- # tag consists of a key name and an associated value. For more
706
- # information about tagging, see [Tagging IAM Identities][1] in the *IAM
707
- # User Guide*.
787
+ # A list of tags that you want to attach to the new user. Each tag
788
+ # consists of a key name and an associated value. For more information
789
+ # about tagging, see [Tagging IAM resources][1] in the *IAM User Guide*.
708
790
  #
709
- # <note markdown="1"> If any one of the tags is invalid or if you exceed the allowed number
710
- # of tags per user, then the entire request fails and the user is not
791
+ # <note markdown="1"> If any one of the tags is invalid or if you exceed the allowed maximum
792
+ # number of tags, then the entire request fails and the resource is not
711
793
  # created.
712
794
  #
713
795
  # </note>
@@ -730,11 +812,17 @@ module Aws::IAM
730
812
  # virtualmfadevice = iam.create_virtual_mfa_device({
731
813
  # path: "pathType",
732
814
  # virtual_mfa_device_name: "virtualMFADeviceName", # required
815
+ # tags: [
816
+ # {
817
+ # key: "tagKeyType", # required
818
+ # value: "tagValueType", # required
819
+ # },
820
+ # ],
733
821
  # })
734
822
  # @param [Hash] options ({})
735
823
  # @option options [String] :path
736
824
  # The path for the virtual MFA device. For more information about paths,
737
- # see [IAM Identifiers][1] in the *IAM User Guide*.
825
+ # see [IAM identifiers][1] in the *IAM User Guide*.
738
826
  #
739
827
  # This parameter is optional. If it is not included, it defaults to a
740
828
  # slash (/).
@@ -762,6 +850,21 @@ module Aws::IAM
762
850
  #
763
851
  #
764
852
  # [1]: http://wikipedia.org/wiki/regex
853
+ # @option options [Array<Types::Tag>] :tags
854
+ # A list of tags that you want to attach to the new IAM virtual MFA
855
+ # device. Each tag consists of a key name and an associated value. For
856
+ # more information about tagging, see [Tagging IAM resources][1] in the
857
+ # *IAM User Guide*.
858
+ #
859
+ # <note markdown="1"> If any one of the tags is invalid or if you exceed the allowed maximum
860
+ # number of tags, then the entire request fails and the resource is not
861
+ # created.
862
+ #
863
+ # </note>
864
+ #
865
+ #
866
+ #
867
+ # [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/id_tags.html
765
868
  # @return [VirtualMfaDevice]
766
869
  def create_virtual_mfa_device(options = {})
767
870
  resp = @client.create_virtual_mfa_device(options)