aws-sdk-iam 1.47.0 → 1.48.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -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)