forked from aws/aws-sdk-js
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathiam-2010-05-08.normal.json
6724 lines (6724 loc) · 401 KB
/
iam-2010-05-08.normal.json
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
{
"version":"2.0",
"metadata":{
"apiVersion":"2010-05-08",
"endpointPrefix":"iam",
"globalEndpoint":"iam.amazonaws.com",
"protocol":"query",
"serviceAbbreviation":"IAM",
"serviceFullName":"AWS Identity and Access Management",
"signatureVersion":"v4",
"uid":"iam-2010-05-08",
"xmlNamespace":"https://iam.amazonaws.com/doc/2010-05-08/"
},
"operations":{
"AddClientIDToOpenIDConnectProvider":{
"name":"AddClientIDToOpenIDConnectProvider",
"http":{
"method":"POST",
"requestUri":"/"
},
"input":{"shape":"AddClientIDToOpenIDConnectProviderRequest"},
"errors":[
{"shape":"InvalidInputException"},
{"shape":"NoSuchEntityException"},
{"shape":"LimitExceededException"},
{"shape":"ServiceFailureException"}
],
"documentation":"<p>Adds a new client ID (also known as audience) to the list of client IDs already registered for the specified IAM OpenID Connect (OIDC) provider resource.</p> <p>This action is idempotent; it does not fail or return an error if you add an existing client ID to the provider.</p>"
},
"AddRoleToInstanceProfile":{
"name":"AddRoleToInstanceProfile",
"http":{
"method":"POST",
"requestUri":"/"
},
"input":{"shape":"AddRoleToInstanceProfileRequest"},
"errors":[
{"shape":"NoSuchEntityException"},
{"shape":"EntityAlreadyExistsException"},
{"shape":"LimitExceededException"},
{"shape":"ServiceFailureException"}
],
"documentation":"<p>Adds the specified IAM role to the specified instance profile.</p> <note> <p>The caller of this API must be granted the <code>PassRole</code> permission on the IAM role by a permission policy.</p> </note> <p>For more information about roles, go to <a href=\"http://docs.aws.amazon.com/IAM/latest/UserGuide/WorkingWithRoles.html\">Working with Roles</a>. For more information about instance profiles, go to <a href=\"http://docs.aws.amazon.com/IAM/latest/UserGuide/AboutInstanceProfiles.html\">About Instance Profiles</a>.</p>"
},
"AddUserToGroup":{
"name":"AddUserToGroup",
"http":{
"method":"POST",
"requestUri":"/"
},
"input":{"shape":"AddUserToGroupRequest"},
"errors":[
{"shape":"NoSuchEntityException"},
{"shape":"LimitExceededException"},
{"shape":"ServiceFailureException"}
],
"documentation":"<p>Adds the specified user to the specified group.</p>"
},
"AttachGroupPolicy":{
"name":"AttachGroupPolicy",
"http":{
"method":"POST",
"requestUri":"/"
},
"input":{"shape":"AttachGroupPolicyRequest"},
"errors":[
{"shape":"NoSuchEntityException"},
{"shape":"LimitExceededException"},
{"shape":"InvalidInputException"},
{"shape":"ServiceFailureException"}
],
"documentation":"<p>Attaches the specified managed policy to the specified IAM group.</p> <p>You use this API to attach a managed policy to a group. To embed an inline policy in a group, use <a>PutGroupPolicy</a>.</p> <p>For more information about policies, see <a href=\"http://docs.aws.amazon.com/IAM/latest/UserGuide/policies-managed-vs-inline.html\">Managed Policies and Inline Policies</a> in the <i>IAM User Guide</i>.</p>"
},
"AttachRolePolicy":{
"name":"AttachRolePolicy",
"http":{
"method":"POST",
"requestUri":"/"
},
"input":{"shape":"AttachRolePolicyRequest"},
"errors":[
{"shape":"NoSuchEntityException"},
{"shape":"LimitExceededException"},
{"shape":"InvalidInputException"},
{"shape":"ServiceFailureException"}
],
"documentation":"<p>Attaches the specified managed policy to the specified IAM role.</p> <p>When you attach a managed policy to a role, the managed policy becomes part of the role's permission (access) policy. You cannot use a managed policy as the role's trust policy. The role's trust policy is created at the same time as the role, using <a>CreateRole</a>. You can update a role's trust policy using <a>UpdateAssumeRolePolicy</a>.</p> <p>Use this API to attach a <i>managed</i> policy to a role. To embed an inline policy in a role, use <a>PutRolePolicy</a>. For more information about policies, see <a href=\"http://docs.aws.amazon.com/IAM/latest/UserGuide/policies-managed-vs-inline.html\">Managed Policies and Inline Policies</a> in the <i>IAM User Guide</i>.</p>"
},
"AttachUserPolicy":{
"name":"AttachUserPolicy",
"http":{
"method":"POST",
"requestUri":"/"
},
"input":{"shape":"AttachUserPolicyRequest"},
"errors":[
{"shape":"NoSuchEntityException"},
{"shape":"LimitExceededException"},
{"shape":"InvalidInputException"},
{"shape":"ServiceFailureException"}
],
"documentation":"<p>Attaches the specified managed policy to the specified user.</p> <p>You use this API to attach a <i>managed</i> policy to a user. To embed an inline policy in a user, use <a>PutUserPolicy</a>.</p> <p>For more information about policies, see <a href=\"http://docs.aws.amazon.com/IAM/latest/UserGuide/policies-managed-vs-inline.html\">Managed Policies and Inline Policies</a> in the <i>IAM User Guide</i>.</p>"
},
"ChangePassword":{
"name":"ChangePassword",
"http":{
"method":"POST",
"requestUri":"/"
},
"input":{"shape":"ChangePasswordRequest"},
"errors":[
{"shape":"NoSuchEntityException"},
{"shape":"InvalidUserTypeException"},
{"shape":"LimitExceededException"},
{"shape":"EntityTemporarilyUnmodifiableException"},
{"shape":"PasswordPolicyViolationException"},
{"shape":"ServiceFailureException"}
],
"documentation":"<p>Changes the password of the IAM user who is calling this action. The root account password is not affected by this action.</p> <p>To change the password for a different user, see <a>UpdateLoginProfile</a>. For more information about modifying passwords, see <a href=\"http://docs.aws.amazon.com/IAM/latest/UserGuide/Using_ManagingLogins.html\">Managing Passwords</a> in the <i>IAM User Guide</i>.</p>"
},
"CreateAccessKey":{
"name":"CreateAccessKey",
"http":{
"method":"POST",
"requestUri":"/"
},
"input":{"shape":"CreateAccessKeyRequest"},
"output":{
"shape":"CreateAccessKeyResponse",
"resultWrapper":"CreateAccessKeyResult"
},
"errors":[
{"shape":"NoSuchEntityException"},
{"shape":"LimitExceededException"},
{"shape":"ServiceFailureException"}
],
"documentation":"<p> Creates a new AWS secret access key and corresponding AWS access key ID for the specified user. The default status for new keys is <code>Active</code>.</p> <p>If you do not specify a user name, IAM determines the user name implicitly based on the AWS access key ID signing the request. Because this action works for access keys under the AWS account, you can use this action to manage root credentials even if the AWS account has no associated users.</p> <p> For information about limits on the number of keys you can create, see <a href=\"http://docs.aws.amazon.com/IAM/latest/UserGuide/LimitationsOnEntities.html\">Limitations on IAM Entities</a> in the <i>IAM User Guide</i>.</p> <important> <p>To ensure the security of your AWS account, the secret access key is accessible only during key and user creation. You must save the key (for example, in a text file) if you want to be able to access it again. If a secret key is lost, you can delete the access keys for the associated user and then create new keys.</p> </important>"
},
"CreateAccountAlias":{
"name":"CreateAccountAlias",
"http":{
"method":"POST",
"requestUri":"/"
},
"input":{"shape":"CreateAccountAliasRequest"},
"errors":[
{"shape":"EntityAlreadyExistsException"},
{"shape":"LimitExceededException"},
{"shape":"ServiceFailureException"}
],
"documentation":"<p>Creates an alias for your AWS account. For information about using an AWS account alias, see <a href=\"http://docs.aws.amazon.com/IAM/latest/UserGuide/AccountAlias.html\">Using an Alias for Your AWS Account ID</a> in the <i>IAM User Guide</i>.</p>"
},
"CreateGroup":{
"name":"CreateGroup",
"http":{
"method":"POST",
"requestUri":"/"
},
"input":{"shape":"CreateGroupRequest"},
"output":{
"shape":"CreateGroupResponse",
"resultWrapper":"CreateGroupResult"
},
"errors":[
{"shape":"LimitExceededException"},
{"shape":"EntityAlreadyExistsException"},
{"shape":"NoSuchEntityException"},
{"shape":"ServiceFailureException"}
],
"documentation":"<p>Creates a new group.</p> <p> For information about the number of groups you can create, see <a href=\"http://docs.aws.amazon.com/IAM/latest/UserGuide/LimitationsOnEntities.html\">Limitations on IAM Entities</a> in the <i>IAM User Guide</i>.</p>"
},
"CreateInstanceProfile":{
"name":"CreateInstanceProfile",
"http":{
"method":"POST",
"requestUri":"/"
},
"input":{"shape":"CreateInstanceProfileRequest"},
"output":{
"shape":"CreateInstanceProfileResponse",
"resultWrapper":"CreateInstanceProfileResult"
},
"errors":[
{"shape":"EntityAlreadyExistsException"},
{"shape":"LimitExceededException"},
{"shape":"ServiceFailureException"}
],
"documentation":"<p> Creates a new instance profile. For information about instance profiles, go to <a href=\"http://docs.aws.amazon.com/IAM/latest/UserGuide/AboutInstanceProfiles.html\">About Instance Profiles</a>.</p> <p> For information about the number of instance profiles you can create, see <a href=\"http://docs.aws.amazon.com/IAM/latest/UserGuide/LimitationsOnEntities.html\">Limitations on IAM Entities</a> in the <i>IAM User Guide</i>.</p>"
},
"CreateLoginProfile":{
"name":"CreateLoginProfile",
"http":{
"method":"POST",
"requestUri":"/"
},
"input":{"shape":"CreateLoginProfileRequest"},
"output":{
"shape":"CreateLoginProfileResponse",
"resultWrapper":"CreateLoginProfileResult"
},
"errors":[
{"shape":"EntityAlreadyExistsException"},
{"shape":"NoSuchEntityException"},
{"shape":"PasswordPolicyViolationException"},
{"shape":"LimitExceededException"},
{"shape":"ServiceFailureException"}
],
"documentation":"<p> Creates a password for the specified user, giving the user the ability to access AWS services through the AWS Management Console. For more information about managing passwords, see <a href=\"http://docs.aws.amazon.com/IAM/latest/UserGuide/Using_ManagingLogins.html\">Managing Passwords</a> in the <i>IAM User Guide</i>.</p>"
},
"CreateOpenIDConnectProvider":{
"name":"CreateOpenIDConnectProvider",
"http":{
"method":"POST",
"requestUri":"/"
},
"input":{"shape":"CreateOpenIDConnectProviderRequest"},
"output":{
"shape":"CreateOpenIDConnectProviderResponse",
"resultWrapper":"CreateOpenIDConnectProviderResult"
},
"errors":[
{"shape":"InvalidInputException"},
{"shape":"EntityAlreadyExistsException"},
{"shape":"LimitExceededException"},
{"shape":"ServiceFailureException"}
],
"documentation":"<p>Creates an IAM entity to describe an identity provider (IdP) that supports <a href=\"http://openid.net/connect/\">OpenID Connect (OIDC)</a>.</p> <p>The OIDC provider that you create with this operation can be used as a principal in a role's trust policy to establish a trust relationship between AWS and the OIDC provider.</p> <p>When you create the IAM OIDC provider, you specify the URL of the OIDC identity provider (IdP) to trust, a list of client IDs (also known as audiences) that identify the application or applications that are allowed to authenticate using the OIDC provider, and a list of thumbprints of the server certificate(s) that the IdP uses. You get all of this information from the OIDC IdP that you want to use for access to AWS.</p> <note> <p>Because trust for the OIDC provider is ultimately derived from the IAM provider that this action creates, it is a best practice to limit access to the <a>CreateOpenIDConnectProvider</a> action to highly-privileged users.</p> </note>"
},
"CreatePolicy":{
"name":"CreatePolicy",
"http":{
"method":"POST",
"requestUri":"/"
},
"input":{"shape":"CreatePolicyRequest"},
"output":{
"shape":"CreatePolicyResponse",
"resultWrapper":"CreatePolicyResult"
},
"errors":[
{"shape":"InvalidInputException"},
{"shape":"LimitExceededException"},
{"shape":"EntityAlreadyExistsException"},
{"shape":"MalformedPolicyDocumentException"},
{"shape":"ServiceFailureException"}
],
"documentation":"<p>Creates a new managed policy for your AWS account.</p> <p>This operation creates a policy version with a version identifier of <code>v1</code> and sets v1 as the policy's default version. For more information about policy versions, see <a href=\"http://docs.aws.amazon.com/IAM/latest/UserGuide/policies-managed-versions.html\">Versioning for Managed Policies</a> in the <i>IAM User Guide</i>.</p> <p>For more information about managed policies in general, see <a href=\"http://docs.aws.amazon.com/IAM/latest/UserGuide/policies-managed-vs-inline.html\">Managed Policies and Inline Policies</a> in the <i>IAM User Guide</i>.</p>"
},
"CreatePolicyVersion":{
"name":"CreatePolicyVersion",
"http":{
"method":"POST",
"requestUri":"/"
},
"input":{"shape":"CreatePolicyVersionRequest"},
"output":{
"shape":"CreatePolicyVersionResponse",
"resultWrapper":"CreatePolicyVersionResult"
},
"errors":[
{"shape":"NoSuchEntityException"},
{"shape":"MalformedPolicyDocumentException"},
{"shape":"InvalidInputException"},
{"shape":"LimitExceededException"},
{"shape":"ServiceFailureException"}
],
"documentation":"<p>Creates a new version of the specified managed policy. To update a managed policy, you create a new policy version. A managed policy can have up to five versions. If the policy has five versions, you must delete an existing version using <a>DeletePolicyVersion</a> before you create a new version.</p> <p>Optionally, you can set the new version as the policy's default version. The default version is the version that is in effect for the IAM users, groups, and roles to which the policy is attached.</p> <p>For more information about managed policy versions, see <a href=\"http://docs.aws.amazon.com/IAM/latest/UserGuide/policies-managed-versions.html\">Versioning for Managed Policies</a> in the <i>IAM User Guide</i>.</p>"
},
"CreateRole":{
"name":"CreateRole",
"http":{
"method":"POST",
"requestUri":"/"
},
"input":{"shape":"CreateRoleRequest"},
"output":{
"shape":"CreateRoleResponse",
"resultWrapper":"CreateRoleResult"
},
"errors":[
{"shape":"LimitExceededException"},
{"shape":"EntityAlreadyExistsException"},
{"shape":"MalformedPolicyDocumentException"},
{"shape":"ServiceFailureException"}
],
"documentation":"<p>Creates a new role for your AWS account. For more information about roles, go to <a href=\"http://docs.aws.amazon.com/IAM/latest/UserGuide/WorkingWithRoles.html\">Working with Roles</a>. For information about limitations on role names and the number of roles you can create, go to <a href=\"http://docs.aws.amazon.com/IAM/latest/UserGuide/LimitationsOnEntities.html\">Limitations on IAM Entities</a> in the <i>IAM User Guide</i>.</p>"
},
"CreateSAMLProvider":{
"name":"CreateSAMLProvider",
"http":{
"method":"POST",
"requestUri":"/"
},
"input":{"shape":"CreateSAMLProviderRequest"},
"output":{
"shape":"CreateSAMLProviderResponse",
"resultWrapper":"CreateSAMLProviderResult"
},
"errors":[
{"shape":"InvalidInputException"},
{"shape":"EntityAlreadyExistsException"},
{"shape":"LimitExceededException"},
{"shape":"ServiceFailureException"}
],
"documentation":"<p>Creates an IAM resource that describes an identity provider (IdP) that supports SAML 2.0.</p> <p>The SAML provider resource that you create with this operation can be used as a principal in an IAM role's trust policy to enable federated users who sign-in using the SAML IdP to assume the role. You can create an IAM role that supports Web-based single sign-on (SSO) to the AWS Management Console or one that supports API access to AWS.</p> <p>When you create the SAML provider resource, you upload an a SAML metadata document that you get from your IdP and that includes the issuer's name, expiration information, and keys that can be used to validate the SAML authentication response (assertions) that the IdP sends. You must generate the metadata document using the identity management software that is used as your organization's IdP.</p> <note> <p> This operation requires <a href=\"http://docs.aws.amazon.com/general/latest/gr/signature-version-4.html\">Signature Version 4</a>.</p> </note> <p> For more information, see <a href=\"http://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_providers_enable-console-saml.html\">Enabling SAML 2.0 Federated Users to Access the AWS Management Console</a> and <a href=\"http://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_providers_saml.html\">About SAML 2.0-based Federation</a> in the <i>IAM User Guide</i>.</p>"
},
"CreateServiceSpecificCredential":{
"name":"CreateServiceSpecificCredential",
"http":{
"method":"POST",
"requestUri":"/"
},
"input":{"shape":"CreateServiceSpecificCredentialRequest"},
"output":{
"shape":"CreateServiceSpecificCredentialResponse",
"resultWrapper":"CreateServiceSpecificCredentialResult"
},
"errors":[
{"shape":"LimitExceededException"},
{"shape":"NoSuchEntityException"},
{"shape":"ServiceNotSupportedException"}
],
"documentation":"<p>Generates a set of credentials consisting of a user name and password that can be used to access the service specified in the request. These credentials are generated by IAM, and can be used only for the specified service. </p> <p>You can have a maximum of two sets of service-specific credentials for each supported service per user.</p> <p>The only supported service at this time is AWS CodeCommit.</p> <p>You can reset the password to a new service-generated value by calling <a>ResetServiceSpecificCredential</a>.</p> <p>For more information about service-specific credentials, see <a href=\"http://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_ssh-keys.html\">Using IAM with AWS CodeCommit: Git Credentials, SSH Keys, and AWS Access Keys</a> in the <i>IAM User Guide</i>.</p>"
},
"CreateUser":{
"name":"CreateUser",
"http":{
"method":"POST",
"requestUri":"/"
},
"input":{"shape":"CreateUserRequest"},
"output":{
"shape":"CreateUserResponse",
"resultWrapper":"CreateUserResult"
},
"errors":[
{"shape":"LimitExceededException"},
{"shape":"EntityAlreadyExistsException"},
{"shape":"NoSuchEntityException"},
{"shape":"ServiceFailureException"}
],
"documentation":"<p>Creates a new IAM user for your AWS account.</p> <p> For information about limitations on the number of IAM users you can create, see <a href=\"http://docs.aws.amazon.com/IAM/latest/UserGuide/LimitationsOnEntities.html\">Limitations on IAM Entities</a> in the <i>IAM User Guide</i>.</p>"
},
"CreateVirtualMFADevice":{
"name":"CreateVirtualMFADevice",
"http":{
"method":"POST",
"requestUri":"/"
},
"input":{"shape":"CreateVirtualMFADeviceRequest"},
"output":{
"shape":"CreateVirtualMFADeviceResponse",
"resultWrapper":"CreateVirtualMFADeviceResult"
},
"errors":[
{"shape":"LimitExceededException"},
{"shape":"EntityAlreadyExistsException"},
{"shape":"ServiceFailureException"}
],
"documentation":"<p>Creates a new virtual MFA device for the AWS account. After creating the virtual MFA, use <a>EnableMFADevice</a> to attach the MFA device to an IAM user. For more information about creating and working with virtual MFA devices, go to <a href=\"http://docs.aws.amazon.com/IAM/latest/UserGuide/Using_VirtualMFA.html\">Using a Virtual MFA Device</a> in the <i>IAM User Guide</i>.</p> <p>For information about limits on the number of MFA devices you can create, see <a href=\"http://docs.aws.amazon.com/IAM/latest/UserGuide/LimitationsOnEntities.html\">Limitations on Entities</a> in the <i>IAM User Guide</i>.</p> <important> <p>The seed information contained in the QR code and the Base32 string should be treated like any other secret access information, such as your AWS access keys or your passwords. After you provision your virtual device, you should ensure that the information is destroyed following secure procedures.</p> </important>"
},
"DeactivateMFADevice":{
"name":"DeactivateMFADevice",
"http":{
"method":"POST",
"requestUri":"/"
},
"input":{"shape":"DeactivateMFADeviceRequest"},
"errors":[
{"shape":"EntityTemporarilyUnmodifiableException"},
{"shape":"NoSuchEntityException"},
{"shape":"LimitExceededException"},
{"shape":"ServiceFailureException"}
],
"documentation":"<p>Deactivates the specified MFA device and removes it from association with the user name for which it was originally enabled.</p> <p>For more information about creating and working with virtual MFA devices, go to <a href=\"http://docs.aws.amazon.com/IAM/latest/UserGuide/Using_VirtualMFA.html\">Using a Virtual MFA Device</a> in the <i>IAM User Guide</i>.</p>"
},
"DeleteAccessKey":{
"name":"DeleteAccessKey",
"http":{
"method":"POST",
"requestUri":"/"
},
"input":{"shape":"DeleteAccessKeyRequest"},
"errors":[
{"shape":"NoSuchEntityException"},
{"shape":"LimitExceededException"},
{"shape":"ServiceFailureException"}
],
"documentation":"<p>Deletes the access key pair associated with the specified IAM user.</p> <p>If you do not specify a user name, IAM determines the user name implicitly based on the AWS access key ID signing the request. Because this action works for access keys under the AWS account, you can use this action to manage root credentials even if the AWS account has no associated users.</p>"
},
"DeleteAccountAlias":{
"name":"DeleteAccountAlias",
"http":{
"method":"POST",
"requestUri":"/"
},
"input":{"shape":"DeleteAccountAliasRequest"},
"errors":[
{"shape":"NoSuchEntityException"},
{"shape":"LimitExceededException"},
{"shape":"ServiceFailureException"}
],
"documentation":"<p> Deletes the specified AWS account alias. For information about using an AWS account alias, see <a href=\"http://docs.aws.amazon.com/IAM/latest/UserGuide/AccountAlias.html\">Using an Alias for Your AWS Account ID</a> in the <i>IAM User Guide</i>.</p>"
},
"DeleteAccountPasswordPolicy":{
"name":"DeleteAccountPasswordPolicy",
"http":{
"method":"POST",
"requestUri":"/"
},
"errors":[
{"shape":"NoSuchEntityException"},
{"shape":"LimitExceededException"},
{"shape":"ServiceFailureException"}
],
"documentation":"<p>Deletes the password policy for the AWS account. There are no parameters.</p>"
},
"DeleteGroup":{
"name":"DeleteGroup",
"http":{
"method":"POST",
"requestUri":"/"
},
"input":{"shape":"DeleteGroupRequest"},
"errors":[
{"shape":"NoSuchEntityException"},
{"shape":"DeleteConflictException"},
{"shape":"LimitExceededException"},
{"shape":"ServiceFailureException"}
],
"documentation":"<p>Deletes the specified IAM group. The group must not contain any users or have any attached policies.</p>"
},
"DeleteGroupPolicy":{
"name":"DeleteGroupPolicy",
"http":{
"method":"POST",
"requestUri":"/"
},
"input":{"shape":"DeleteGroupPolicyRequest"},
"errors":[
{"shape":"NoSuchEntityException"},
{"shape":"LimitExceededException"},
{"shape":"ServiceFailureException"}
],
"documentation":"<p>Deletes the specified inline policy that is embedded in the specified IAM group.</p> <p>A group can also have managed policies attached to it. To detach a managed policy from a group, use <a>DetachGroupPolicy</a>. For more information about policies, refer to <a href=\"http://docs.aws.amazon.com/IAM/latest/UserGuide/policies-managed-vs-inline.html\">Managed Policies and Inline Policies</a> in the <i>IAM User Guide</i>.</p>"
},
"DeleteInstanceProfile":{
"name":"DeleteInstanceProfile",
"http":{
"method":"POST",
"requestUri":"/"
},
"input":{"shape":"DeleteInstanceProfileRequest"},
"errors":[
{"shape":"NoSuchEntityException"},
{"shape":"DeleteConflictException"},
{"shape":"LimitExceededException"},
{"shape":"ServiceFailureException"}
],
"documentation":"<p>Deletes the specified instance profile. The instance profile must not have an associated role.</p> <important> <p>Make sure you do not have any Amazon EC2 instances running with the instance profile you are about to delete. Deleting a role or instance profile that is associated with a running instance will break any applications running on the instance.</p> </important> <p>For more information about instance profiles, go to <a href=\"http://docs.aws.amazon.com/IAM/latest/UserGuide/AboutInstanceProfiles.html\">About Instance Profiles</a>.</p>"
},
"DeleteLoginProfile":{
"name":"DeleteLoginProfile",
"http":{
"method":"POST",
"requestUri":"/"
},
"input":{"shape":"DeleteLoginProfileRequest"},
"errors":[
{"shape":"EntityTemporarilyUnmodifiableException"},
{"shape":"NoSuchEntityException"},
{"shape":"LimitExceededException"},
{"shape":"ServiceFailureException"}
],
"documentation":"<p>Deletes the password for the specified IAM user, which terminates the user's ability to access AWS services through the AWS Management Console.</p> <important> <p> Deleting a user's password does not prevent a user from accessing AWS through the command line interface or the API. To prevent all user access you must also either make any access keys inactive or delete them. For more information about making keys inactive or deleting them, see <a>UpdateAccessKey</a> and <a>DeleteAccessKey</a>. </p> </important>"
},
"DeleteOpenIDConnectProvider":{
"name":"DeleteOpenIDConnectProvider",
"http":{
"method":"POST",
"requestUri":"/"
},
"input":{"shape":"DeleteOpenIDConnectProviderRequest"},
"errors":[
{"shape":"InvalidInputException"},
{"shape":"NoSuchEntityException"},
{"shape":"ServiceFailureException"}
],
"documentation":"<p>Deletes an OpenID Connect identity provider (IdP) resource object in IAM.</p> <p>Deleting an IAM OIDC provider resource does not update any roles that reference the provider as a principal in their trust policies. Any attempt to assume a role that references a deleted provider fails.</p> <p>This action is idempotent; it does not fail or return an error if you call the action for a provider that does not exist.</p>"
},
"DeletePolicy":{
"name":"DeletePolicy",
"http":{
"method":"POST",
"requestUri":"/"
},
"input":{"shape":"DeletePolicyRequest"},
"errors":[
{"shape":"NoSuchEntityException"},
{"shape":"LimitExceededException"},
{"shape":"InvalidInputException"},
{"shape":"DeleteConflictException"},
{"shape":"ServiceFailureException"}
],
"documentation":"<p>Deletes the specified managed policy.</p> <p>Before you can delete a managed policy, you must first detach the policy from all users, groups, and roles that it is attached to, and you must delete all of the policy's versions. The following steps describe the process for deleting a managed policy:</p> <ul> <li> <p>Detach the policy from all users, groups, and roles that the policy is attached to, using the <a>DetachUserPolicy</a>, <a>DetachGroupPolicy</a>, or <a>DetachRolePolicy</a> APIs. To list all the users, groups, and roles that a policy is attached to, use <a>ListEntitiesForPolicy</a>.</p> </li> <li> <p>Delete all versions of the policy using <a>DeletePolicyVersion</a>. To list the policy's versions, use <a>ListPolicyVersions</a>. You cannot use <a>DeletePolicyVersion</a> to delete the version that is marked as the default version. You delete the policy's default version in the next step of the process.</p> </li> <li> <p>Delete the policy (this automatically deletes the policy's default version) using this API.</p> </li> </ul> <p>For information about managed policies, see <a href=\"http://docs.aws.amazon.com/IAM/latest/UserGuide/policies-managed-vs-inline.html\">Managed Policies and Inline Policies</a> in the <i>IAM User Guide</i>.</p>"
},
"DeletePolicyVersion":{
"name":"DeletePolicyVersion",
"http":{
"method":"POST",
"requestUri":"/"
},
"input":{"shape":"DeletePolicyVersionRequest"},
"errors":[
{"shape":"NoSuchEntityException"},
{"shape":"LimitExceededException"},
{"shape":"InvalidInputException"},
{"shape":"DeleteConflictException"},
{"shape":"ServiceFailureException"}
],
"documentation":"<p>Deletes the specified version from the specified managed policy.</p> <p>You cannot delete the default version from a policy using this API. To delete the default version from a policy, use <a>DeletePolicy</a>. To find out which version of a policy is marked as the default version, use <a>ListPolicyVersions</a>.</p> <p>For information about versions for managed policies, see <a href=\"http://docs.aws.amazon.com/IAM/latest/UserGuide/policies-managed-versions.html\">Versioning for Managed Policies</a> in the <i>IAM User Guide</i>.</p>"
},
"DeleteRole":{
"name":"DeleteRole",
"http":{
"method":"POST",
"requestUri":"/"
},
"input":{"shape":"DeleteRoleRequest"},
"errors":[
{"shape":"NoSuchEntityException"},
{"shape":"DeleteConflictException"},
{"shape":"LimitExceededException"},
{"shape":"ServiceFailureException"}
],
"documentation":"<p>Deletes the specified role. The role must not have any policies attached. For more information about roles, go to <a href=\"http://docs.aws.amazon.com/IAM/latest/UserGuide/WorkingWithRoles.html\">Working with Roles</a>.</p> <important> <p>Make sure you do not have any Amazon EC2 instances running with the role you are about to delete. Deleting a role or instance profile that is associated with a running instance will break any applications running on the instance.</p> </important>"
},
"DeleteRolePolicy":{
"name":"DeleteRolePolicy",
"http":{
"method":"POST",
"requestUri":"/"
},
"input":{"shape":"DeleteRolePolicyRequest"},
"errors":[
{"shape":"NoSuchEntityException"},
{"shape":"LimitExceededException"},
{"shape":"ServiceFailureException"}
],
"documentation":"<p>Deletes the specified inline policy that is embedded in the specified IAM role.</p> <p>A role can also have managed policies attached to it. To detach a managed policy from a role, use <a>DetachRolePolicy</a>. For more information about policies, refer to <a href=\"http://docs.aws.amazon.com/IAM/latest/UserGuide/policies-managed-vs-inline.html\">Managed Policies and Inline Policies</a> in the <i>IAM User Guide</i>.</p>"
},
"DeleteSAMLProvider":{
"name":"DeleteSAMLProvider",
"http":{
"method":"POST",
"requestUri":"/"
},
"input":{"shape":"DeleteSAMLProviderRequest"},
"errors":[
{"shape":"InvalidInputException"},
{"shape":"LimitExceededException"},
{"shape":"NoSuchEntityException"},
{"shape":"ServiceFailureException"}
],
"documentation":"<p>Deletes a SAML provider resource in IAM.</p> <p>Deleting the provider resource from IAM does not update any roles that reference the SAML provider resource's ARN as a principal in their trust policies. Any attempt to assume a role that references a non-existent provider resource ARN fails.</p> <note> <p> This operation requires <a href=\"http://docs.aws.amazon.com/general/latest/gr/signature-version-4.html\">Signature Version 4</a>.</p> </note>"
},
"DeleteSSHPublicKey":{
"name":"DeleteSSHPublicKey",
"http":{
"method":"POST",
"requestUri":"/"
},
"input":{"shape":"DeleteSSHPublicKeyRequest"},
"errors":[
{"shape":"NoSuchEntityException"}
],
"documentation":"<p>Deletes the specified SSH public key.</p> <p>The SSH public key deleted by this action is used only for authenticating the associated IAM user to an AWS CodeCommit repository. For more information about using SSH keys to authenticate to an AWS CodeCommit repository, see <a href=\"http://docs.aws.amazon.com/codecommit/latest/userguide/setting-up-credentials-ssh.html\">Set up AWS CodeCommit for SSH Connections</a> in the <i>AWS CodeCommit User Guide</i>.</p>"
},
"DeleteServerCertificate":{
"name":"DeleteServerCertificate",
"http":{
"method":"POST",
"requestUri":"/"
},
"input":{"shape":"DeleteServerCertificateRequest"},
"errors":[
{"shape":"NoSuchEntityException"},
{"shape":"DeleteConflictException"},
{"shape":"LimitExceededException"},
{"shape":"ServiceFailureException"}
],
"documentation":"<p>Deletes the specified server certificate.</p> <p>For more information about working with server certificates, including a list of AWS services that can use the server certificates that you manage with IAM, go to <a href=\"http://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_server-certs.html\">Working with Server Certificates</a> in the <i>IAM User Guide</i>.</p> <important> <p> If you are using a server certificate with Elastic Load Balancing, deleting the certificate could have implications for your application. If Elastic Load Balancing doesn't detect the deletion of bound certificates, it may continue to use the certificates. This could cause Elastic Load Balancing to stop accepting traffic. We recommend that you remove the reference to the certificate from Elastic Load Balancing before using this command to delete the certificate. For more information, go to <a href=\"http://docs.aws.amazon.com/ElasticLoadBalancing/latest/APIReference/API_DeleteLoadBalancerListeners.html\">DeleteLoadBalancerListeners</a> in the <i>Elastic Load Balancing API Reference</i>.</p> </important>"
},
"DeleteServiceSpecificCredential":{
"name":"DeleteServiceSpecificCredential",
"http":{
"method":"POST",
"requestUri":"/"
},
"input":{"shape":"DeleteServiceSpecificCredentialRequest"},
"errors":[
{"shape":"NoSuchEntityException"}
],
"documentation":"<p>Deletes the specified service-specific credential.</p>"
},
"DeleteSigningCertificate":{
"name":"DeleteSigningCertificate",
"http":{
"method":"POST",
"requestUri":"/"
},
"input":{"shape":"DeleteSigningCertificateRequest"},
"errors":[
{"shape":"NoSuchEntityException"},
{"shape":"LimitExceededException"},
{"shape":"ServiceFailureException"}
],
"documentation":"<p>Deletes a signing certificate associated with the specified IAM user.</p> <p>If you do not specify a user name, IAM determines the user name implicitly based on the AWS access key ID signing the request. Because this action works for access keys under the AWS account, you can use this action to manage root credentials even if the AWS account has no associated IAM users.</p>"
},
"DeleteUser":{
"name":"DeleteUser",
"http":{
"method":"POST",
"requestUri":"/"
},
"input":{"shape":"DeleteUserRequest"},
"errors":[
{"shape":"LimitExceededException"},
{"shape":"NoSuchEntityException"},
{"shape":"DeleteConflictException"},
{"shape":"ServiceFailureException"}
],
"documentation":"<p>Deletes the specified IAM user. The user must not belong to any groups or have any access keys, signing certificates, or attached policies.</p>"
},
"DeleteUserPolicy":{
"name":"DeleteUserPolicy",
"http":{
"method":"POST",
"requestUri":"/"
},
"input":{"shape":"DeleteUserPolicyRequest"},
"errors":[
{"shape":"NoSuchEntityException"},
{"shape":"LimitExceededException"},
{"shape":"ServiceFailureException"}
],
"documentation":"<p>Deletes the specified inline policy that is embedded in the specified IAM user.</p> <p>A user can also have managed policies attached to it. To detach a managed policy from a user, use <a>DetachUserPolicy</a>. For more information about policies, refer to <a href=\"http://docs.aws.amazon.com/IAM/latest/UserGuide/policies-managed-vs-inline.html\">Managed Policies and Inline Policies</a> in the <i>IAM User Guide</i>.</p>"
},
"DeleteVirtualMFADevice":{
"name":"DeleteVirtualMFADevice",
"http":{
"method":"POST",
"requestUri":"/"
},
"input":{"shape":"DeleteVirtualMFADeviceRequest"},
"errors":[
{"shape":"NoSuchEntityException"},
{"shape":"DeleteConflictException"},
{"shape":"LimitExceededException"},
{"shape":"ServiceFailureException"}
],
"documentation":"<p>Deletes a virtual MFA device.</p> <note> <p> You must deactivate a user's virtual MFA device before you can delete it. For information about deactivating MFA devices, see <a>DeactivateMFADevice</a>. </p> </note>"
},
"DetachGroupPolicy":{
"name":"DetachGroupPolicy",
"http":{
"method":"POST",
"requestUri":"/"
},
"input":{"shape":"DetachGroupPolicyRequest"},
"errors":[
{"shape":"NoSuchEntityException"},
{"shape":"LimitExceededException"},
{"shape":"InvalidInputException"},
{"shape":"ServiceFailureException"}
],
"documentation":"<p>Removes the specified managed policy from the specified IAM group.</p> <p>A group can also have inline policies embedded with it. To delete an inline policy, use the <a>DeleteGroupPolicy</a> API. For information about policies, see <a href=\"http://docs.aws.amazon.com/IAM/latest/UserGuide/policies-managed-vs-inline.html\">Managed Policies and Inline Policies</a> in the <i>IAM User Guide</i>.</p>"
},
"DetachRolePolicy":{
"name":"DetachRolePolicy",
"http":{
"method":"POST",
"requestUri":"/"
},
"input":{"shape":"DetachRolePolicyRequest"},
"errors":[
{"shape":"NoSuchEntityException"},
{"shape":"LimitExceededException"},
{"shape":"InvalidInputException"},
{"shape":"ServiceFailureException"}
],
"documentation":"<p>Removes the specified managed policy from the specified role.</p> <p>A role can also have inline policies embedded with it. To delete an inline policy, use the <a>DeleteRolePolicy</a> API. For information about policies, see <a href=\"http://docs.aws.amazon.com/IAM/latest/UserGuide/policies-managed-vs-inline.html\">Managed Policies and Inline Policies</a> in the <i>IAM User Guide</i>.</p>"
},
"DetachUserPolicy":{
"name":"DetachUserPolicy",
"http":{
"method":"POST",
"requestUri":"/"
},
"input":{"shape":"DetachUserPolicyRequest"},
"errors":[
{"shape":"NoSuchEntityException"},
{"shape":"LimitExceededException"},
{"shape":"InvalidInputException"},
{"shape":"ServiceFailureException"}
],
"documentation":"<p>Removes the specified managed policy from the specified user.</p> <p>A user can also have inline policies embedded with it. To delete an inline policy, use the <a>DeleteUserPolicy</a> API. For information about policies, see <a href=\"http://docs.aws.amazon.com/IAM/latest/UserGuide/policies-managed-vs-inline.html\">Managed Policies and Inline Policies</a> in the <i>IAM User Guide</i>.</p>"
},
"EnableMFADevice":{
"name":"EnableMFADevice",
"http":{
"method":"POST",
"requestUri":"/"
},
"input":{"shape":"EnableMFADeviceRequest"},
"errors":[
{"shape":"EntityAlreadyExistsException"},
{"shape":"EntityTemporarilyUnmodifiableException"},
{"shape":"InvalidAuthenticationCodeException"},
{"shape":"LimitExceededException"},
{"shape":"NoSuchEntityException"},
{"shape":"ServiceFailureException"}
],
"documentation":"<p>Enables the specified MFA device and associates it with the specified IAM user. When enabled, the MFA device is required for every subsequent login by the IAM user associated with the device.</p>"
},
"GenerateCredentialReport":{
"name":"GenerateCredentialReport",
"http":{
"method":"POST",
"requestUri":"/"
},
"output":{
"shape":"GenerateCredentialReportResponse",
"resultWrapper":"GenerateCredentialReportResult"
},
"errors":[
{"shape":"LimitExceededException"},
{"shape":"ServiceFailureException"}
],
"documentation":"<p> Generates a credential report for the AWS account. For more information about the credential report, see <a href=\"http://docs.aws.amazon.com/IAM/latest/UserGuide/credential-reports.html\">Getting Credential Reports</a> in the <i>IAM User Guide</i>.</p>"
},
"GetAccessKeyLastUsed":{
"name":"GetAccessKeyLastUsed",
"http":{
"method":"POST",
"requestUri":"/"
},
"input":{"shape":"GetAccessKeyLastUsedRequest"},
"output":{
"shape":"GetAccessKeyLastUsedResponse",
"resultWrapper":"GetAccessKeyLastUsedResult"
},
"errors":[
{"shape":"NoSuchEntityException"}
],
"documentation":"<p>Retrieves information about when the specified access key was last used. The information includes the date and time of last use, along with the AWS service and region that were specified in the last request made with that key.</p>"
},
"GetAccountAuthorizationDetails":{
"name":"GetAccountAuthorizationDetails",
"http":{
"method":"POST",
"requestUri":"/"
},
"input":{"shape":"GetAccountAuthorizationDetailsRequest"},
"output":{
"shape":"GetAccountAuthorizationDetailsResponse",
"resultWrapper":"GetAccountAuthorizationDetailsResult"
},
"errors":[
{"shape":"ServiceFailureException"}
],
"documentation":"<p>Retrieves information about all IAM users, groups, roles, and policies in your AWS account, including their relationships to one another. Use this API to obtain a snapshot of the configuration of IAM permissions (users, groups, roles, and policies) in your account.</p> <p>You can optionally filter the results using the <code>Filter</code> parameter. You can paginate the results using the <code>MaxItems</code> and <code>Marker</code> parameters.</p>"
},
"GetAccountPasswordPolicy":{
"name":"GetAccountPasswordPolicy",
"http":{
"method":"POST",
"requestUri":"/"
},
"output":{
"shape":"GetAccountPasswordPolicyResponse",
"resultWrapper":"GetAccountPasswordPolicyResult"
},
"errors":[
{"shape":"NoSuchEntityException"},
{"shape":"ServiceFailureException"}
],
"documentation":"<p>Retrieves the password policy for the AWS account. For more information about using a password policy, go to <a href=\"http://docs.aws.amazon.com/IAM/latest/UserGuide/Using_ManagingPasswordPolicies.html\">Managing an IAM Password Policy</a>.</p>"
},
"GetAccountSummary":{
"name":"GetAccountSummary",
"http":{
"method":"POST",
"requestUri":"/"
},
"output":{
"shape":"GetAccountSummaryResponse",
"resultWrapper":"GetAccountSummaryResult"
},
"errors":[
{"shape":"ServiceFailureException"}
],
"documentation":"<p>Retrieves information about IAM entity usage and IAM quotas in the AWS account.</p> <p> For information about limitations on IAM entities, see <a href=\"http://docs.aws.amazon.com/IAM/latest/UserGuide/LimitationsOnEntities.html\">Limitations on IAM Entities</a> in the <i>IAM User Guide</i>.</p>"
},
"GetContextKeysForCustomPolicy":{
"name":"GetContextKeysForCustomPolicy",
"http":{
"method":"POST",
"requestUri":"/"
},
"input":{"shape":"GetContextKeysForCustomPolicyRequest"},
"output":{
"shape":"GetContextKeysForPolicyResponse",
"resultWrapper":"GetContextKeysForCustomPolicyResult"
},
"errors":[
{"shape":"InvalidInputException"}
],
"documentation":"<p>Gets a list of all of the context keys referenced in the input policies. The policies are supplied as a list of one or more strings. To get the context keys from policies associated with an IAM user, group, or role, use <a>GetContextKeysForPrincipalPolicy</a>.</p> <p>Context keys are variables maintained by AWS and its services that provide details about the context of an API query request, and can be evaluated by testing against a value specified in an IAM policy. Use GetContextKeysForCustomPolicy to understand what key names and values you must supply when you call <a>SimulateCustomPolicy</a>. Note that all parameters are shown in unencoded form here for clarity, but must be URL encoded to be included as a part of a real HTML request.</p>"
},
"GetContextKeysForPrincipalPolicy":{
"name":"GetContextKeysForPrincipalPolicy",
"http":{
"method":"POST",
"requestUri":"/"
},
"input":{"shape":"GetContextKeysForPrincipalPolicyRequest"},
"output":{
"shape":"GetContextKeysForPolicyResponse",
"resultWrapper":"GetContextKeysForPrincipalPolicyResult"
},
"errors":[
{"shape":"NoSuchEntityException"},
{"shape":"InvalidInputException"}
],
"documentation":"<p>Gets a list of all of the context keys referenced in all of the IAM policies attached to the specified IAM entity. The entity can be an IAM user, group, or role. If you specify a user, then the request also includes all of the policies attached to groups that the user is a member of.</p> <p>You can optionally include a list of one or more additional policies, specified as strings. If you want to include <i>only</i> a list of policies by string, use <a>GetContextKeysForCustomPolicy</a> instead.</p> <p> <b>Note:</b> This API discloses information about the permissions granted to other users. If you do not want users to see other user's permissions, then consider allowing them to use <a>GetContextKeysForCustomPolicy</a> instead.</p> <p>Context keys are variables maintained by AWS and its services that provide details about the context of an API query request, and can be evaluated by testing against a value in an IAM policy. Use <a>GetContextKeysForPrincipalPolicy</a> to understand what key names and values you must supply when you call <a>SimulatePrincipalPolicy</a>.</p>"
},
"GetCredentialReport":{
"name":"GetCredentialReport",
"http":{
"method":"POST",
"requestUri":"/"
},
"output":{
"shape":"GetCredentialReportResponse",
"resultWrapper":"GetCredentialReportResult"
},
"errors":[
{"shape":"CredentialReportNotPresentException"},
{"shape":"CredentialReportExpiredException"},
{"shape":"CredentialReportNotReadyException"},
{"shape":"ServiceFailureException"}
],
"documentation":"<p> Retrieves a credential report for the AWS account. For more information about the credential report, see <a href=\"http://docs.aws.amazon.com/IAM/latest/UserGuide/credential-reports.html\">Getting Credential Reports</a> in the <i>IAM User Guide</i>.</p>"
},
"GetGroup":{
"name":"GetGroup",
"http":{
"method":"POST",
"requestUri":"/"
},
"input":{"shape":"GetGroupRequest"},
"output":{
"shape":"GetGroupResponse",
"resultWrapper":"GetGroupResult"
},
"errors":[
{"shape":"NoSuchEntityException"},
{"shape":"ServiceFailureException"}
],
"documentation":"<p> Returns a list of IAM users that are in the specified IAM group. You can paginate the results using the <code>MaxItems</code> and <code>Marker</code> parameters.</p>"
},
"GetGroupPolicy":{
"name":"GetGroupPolicy",
"http":{
"method":"POST",
"requestUri":"/"
},
"input":{"shape":"GetGroupPolicyRequest"},
"output":{
"shape":"GetGroupPolicyResponse",
"resultWrapper":"GetGroupPolicyResult"
},
"errors":[
{"shape":"NoSuchEntityException"},
{"shape":"ServiceFailureException"}
],
"documentation":"<p>Retrieves the specified inline policy document that is embedded in the specified IAM group.</p> <note> <p>Policies returned by this API are URL-encoded compliant with <a href=\"https://tools.ietf.org/html/rfc3986\">RFC 3986</a>. You can use a URL decoding method to convert the policy back to plain JSON text. For example, if you use Java, you can use the <code>decode</code> method of the <code>java.net.URLDecoder</code> utility class in the Java SDK. Other languages and SDKs provide similar functionality.</p> </note> <p>An IAM group can also have managed policies attached to it. To retrieve a managed policy document that is attached to a group, use <a>GetPolicy</a> to determine the policy's default version, then use <a>GetPolicyVersion</a> to retrieve the policy document.</p> <p>For more information about policies, see <a href=\"http://docs.aws.amazon.com/IAM/latest/UserGuide/policies-managed-vs-inline.html\">Managed Policies and Inline Policies</a> in the <i>IAM User Guide</i>.</p>"
},
"GetInstanceProfile":{
"name":"GetInstanceProfile",
"http":{
"method":"POST",
"requestUri":"/"
},
"input":{"shape":"GetInstanceProfileRequest"},
"output":{
"shape":"GetInstanceProfileResponse",
"resultWrapper":"GetInstanceProfileResult"
},
"errors":[
{"shape":"NoSuchEntityException"},
{"shape":"ServiceFailureException"}
],
"documentation":"<p> Retrieves information about the specified instance profile, including the instance profile's path, GUID, ARN, and role. For more information about instance profiles, see <a href=\"http://docs.aws.amazon.com/IAM/latest/UserGuide/AboutInstanceProfiles.html\">About Instance Profiles</a> in the <i>IAM User Guide</i>.</p>"
},
"GetLoginProfile":{
"name":"GetLoginProfile",
"http":{
"method":"POST",
"requestUri":"/"
},
"input":{"shape":"GetLoginProfileRequest"},
"output":{
"shape":"GetLoginProfileResponse",
"resultWrapper":"GetLoginProfileResult"
},
"errors":[
{"shape":"NoSuchEntityException"},
{"shape":"ServiceFailureException"}
],
"documentation":"<p>Retrieves the user name and password-creation date for the specified IAM user. If the user has not been assigned a password, the action returns a 404 (<code>NoSuchEntity</code>) error.</p>"
},
"GetOpenIDConnectProvider":{
"name":"GetOpenIDConnectProvider",
"http":{
"method":"POST",
"requestUri":"/"
},
"input":{"shape":"GetOpenIDConnectProviderRequest"},
"output":{
"shape":"GetOpenIDConnectProviderResponse",
"resultWrapper":"GetOpenIDConnectProviderResult"
},
"errors":[
{"shape":"InvalidInputException"},
{"shape":"NoSuchEntityException"},
{"shape":"ServiceFailureException"}
],
"documentation":"<p>Returns information about the specified OpenID Connect (OIDC) provider resource object in IAM.</p>"
},
"GetPolicy":{
"name":"GetPolicy",
"http":{
"method":"POST",
"requestUri":"/"
},
"input":{"shape":"GetPolicyRequest"},
"output":{
"shape":"GetPolicyResponse",
"resultWrapper":"GetPolicyResult"
},
"errors":[
{"shape":"NoSuchEntityException"},
{"shape":"InvalidInputException"},
{"shape":"ServiceFailureException"}
],
"documentation":"<p>Retrieves information about the specified managed policy, including the policy's default version and the total number of IAM users, groups, and roles to which the policy is attached. To retrieve the list of the specific users, groups, and roles that the policy is attached to, use the <a>ListEntitiesForPolicy</a> API. This API returns metadata about the policy. To retrieve the actual policy document for a specific version of the policy, use <a>GetPolicyVersion</a>.</p> <p>This API retrieves information about managed policies. To retrieve information about an inline policy that is embedded with an IAM user, group, or role, use the <a>GetUserPolicy</a>, <a>GetGroupPolicy</a>, or <a>GetRolePolicy</a> API.</p> <p>For more information about policies, see <a href=\"http://docs.aws.amazon.com/IAM/latest/UserGuide/policies-managed-vs-inline.html\">Managed Policies and Inline Policies</a> in the <i>IAM User Guide</i>.</p>"
},
"GetPolicyVersion":{
"name":"GetPolicyVersion",
"http":{
"method":"POST",
"requestUri":"/"
},
"input":{"shape":"GetPolicyVersionRequest"},
"output":{
"shape":"GetPolicyVersionResponse",
"resultWrapper":"GetPolicyVersionResult"
},
"errors":[
{"shape":"NoSuchEntityException"},
{"shape":"InvalidInputException"},
{"shape":"ServiceFailureException"}
],
"documentation":"<p>Retrieves information about the specified version of the specified managed policy, including the policy document.</p> <note> <p>Policies returned by this API are URL-encoded compliant with <a href=\"https://tools.ietf.org/html/rfc3986\">RFC 3986</a>. You can use a URL decoding method to convert the policy back to plain JSON text. For example, if you use Java, you can use the <code>decode</code> method of the <code>java.net.URLDecoder</code> utility class in the Java SDK. Other languages and SDKs provide similar functionality.</p> </note> <p>To list the available versions for a policy, use <a>ListPolicyVersions</a>.</p> <p>This API retrieves information about managed policies. To retrieve information about an inline policy that is embedded in a user, group, or role, use the <a>GetUserPolicy</a>, <a>GetGroupPolicy</a>, or <a>GetRolePolicy</a> API.</p> <p>For more information about the types of policies, see <a href=\"http://docs.aws.amazon.com/IAM/latest/UserGuide/policies-managed-vs-inline.html\">Managed Policies and Inline Policies</a> in the <i>IAM User Guide</i>.</p> <p>For more information about managed policy versions, see <a href=\"http://docs.aws.amazon.com/IAM/latest/UserGuide/policies-managed-versions.html\">Versioning for Managed Policies</a> in the <i>IAM User Guide</i>.</p>"
},
"GetRole":{
"name":"GetRole",
"http":{
"method":"POST",
"requestUri":"/"
},
"input":{"shape":"GetRoleRequest"},
"output":{
"shape":"GetRoleResponse",
"resultWrapper":"GetRoleResult"
},
"errors":[
{"shape":"NoSuchEntityException"},
{"shape":"ServiceFailureException"}
],
"documentation":"<p>Retrieves information about the specified role, including the role's path, GUID, ARN, and the role's trust policy that grants permission to assume the role. For more information about roles, see <a href=\"http://docs.aws.amazon.com/IAM/latest/UserGuide/WorkingWithRoles.html\">Working with Roles</a>.</p> <note> <p>Policies returned by this API are URL-encoded compliant with <a href=\"https://tools.ietf.org/html/rfc3986\">RFC 3986</a>. You can use a URL decoding method to convert the policy back to plain JSON text. For example, if you use Java, you can use the <code>decode</code> method of the <code>java.net.URLDecoder</code> utility class in the Java SDK. Other languages and SDKs provide similar functionality.</p> </note>"
},
"GetRolePolicy":{
"name":"GetRolePolicy",
"http":{
"method":"POST",
"requestUri":"/"
},