@aws-sdk/client-iam 3.287.0 → 3.289.0

package/dist-types/commands/GetAccountPasswordPolicyCommand.d.ts

@@ -32,6 +32,31 @@ export interface GetAccountPasswordPolicyCommandOutput extends GetAccountPasswor
  * @see {@link GetAccountPasswordPolicyCommandOutput} for command's `response` shape.
  * @see {@link IAMClientResolvedConfig | config} for IAMClient's `config` shape.
  *
+ * @example To see the current account password policy
+ * ```javascript
+ * // The following command displays details about the password policy for the current AWS account.
+ * const input = undefined;
+ * const command = new GetAccountPasswordPolicyCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "PasswordPolicy": {
+ *     "AllowUsersToChangePassword": false,
+ *     "ExpirePasswords": false,
+ *     "HardExpiry": false,
+ *     "MaxPasswordAge": 90,
+ *     "MinimumPasswordLength": 8,
+ *     "PasswordReusePrevention": 12,
+ *     "RequireLowercaseCharacters": false,
+ *     "RequireNumbers": true,
+ *     "RequireSymbols": true,
+ *     "RequireUppercaseCharacters": false
+ *   }
+ * }
+ * *\/
+ * // example id: 5e4598c7-c425-431f-8af1-19073b3c4a5f
+ * ```
+ *
  */
 export declare class GetAccountPasswordPolicyCommand extends $Command<GetAccountPasswordPolicyCommandInput, GetAccountPasswordPolicyCommandOutput, IAMClientResolvedConfig> {
     readonly input: GetAccountPasswordPolicyCommandInput;

package/dist-types/commands/GetAccountSummaryCommand.d.ts

@@ -32,6 +32,47 @@ export interface GetAccountSummaryCommandOutput extends GetAccountSummaryRespons
  * @see {@link GetAccountSummaryCommandOutput} for command's `response` shape.
  * @see {@link IAMClientResolvedConfig | config} for IAMClient's `config` shape.
  *
+ * @example To get information about IAM entity quotas and usage in the current account
+ * ```javascript
+ * // The following command returns information about the IAM entity quotas and usage in the current AWS account.
+ * const input = undefined;
+ * const command = new GetAccountSummaryCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "SummaryMap": {
+ *     "AccessKeysPerUserQuota": 2,
+ *     "AccountAccessKeysPresent": 1,
+ *     "AccountMFAEnabled": 0,
+ *     "AccountSigningCertificatesPresent": 0,
+ *     "AttachedPoliciesPerGroupQuota": 10,
+ *     "AttachedPoliciesPerRoleQuota": 10,
+ *     "AttachedPoliciesPerUserQuota": 10,
+ *     "GlobalEndpointTokenVersion": 2,
+ *     "GroupPolicySizeQuota": 5120,
+ *     "Groups": 15,
+ *     "GroupsPerUserQuota": 10,
+ *     "GroupsQuota": 100,
+ *     "MFADevices": 6,
+ *     "MFADevicesInUse": 3,
+ *     "Policies": 8,
+ *     "PoliciesQuota": 1000,
+ *     "PolicySizeQuota": 5120,
+ *     "PolicyVersionsInUse": 22,
+ *     "PolicyVersionsInUseQuota": 10000,
+ *     "ServerCertificates": 1,
+ *     "ServerCertificatesQuota": 20,
+ *     "SigningCertificatesPerUserQuota": 2,
+ *     "UserPolicySizeQuota": 2048,
+ *     "Users": 27,
+ *     "UsersQuota": 5000,
+ *     "VersionsPerPolicyQuota": 5
+ *   }
+ * }
+ * *\/
+ * // example id: 9d8447af-f344-45de-8219-2cebc3cce7f2
+ * ```
+ *
  */
 export declare class GetAccountSummaryCommand extends $Command<GetAccountSummaryCommandInput, GetAccountSummaryCommandOutput, IAMClientResolvedConfig> {
     readonly input: GetAccountSummaryCommandInput;

package/dist-types/commands/GetInstanceProfileCommand.d.ts

@@ -32,6 +32,38 @@ export interface GetInstanceProfileCommandOutput extends GetInstanceProfileRespo
  * @see {@link GetInstanceProfileCommandOutput} for command's `response` shape.
  * @see {@link IAMClientResolvedConfig | config} for IAMClient's `config` shape.
  *
+ * @example To get information about an instance profile
+ * ```javascript
+ * // The following command gets information about the instance profile named ExampleInstanceProfile.
+ * const input = {
+ *   "InstanceProfileName": "ExampleInstanceProfile"
+ * };
+ * const command = new GetInstanceProfileCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "InstanceProfile": {
+ *     "Arn": "arn:aws:iam::336924118301:instance-profile/ExampleInstanceProfile",
+ *     "CreateDate": "2013-06-12T23:52:02Z",
+ *     "InstanceProfileId": "AID2MAB8DPLSRHEXAMPLE",
+ *     "InstanceProfileName": "ExampleInstanceProfile",
+ *     "Path": "/",
+ *     "Roles": [
+ *       {
+ *         "Arn": "arn:aws:iam::336924118301:role/Test-Role",
+ *         "AssumeRolePolicyDocument": "<URL-encoded-JSON>",
+ *         "CreateDate": "2013-01-09T06:33:26Z",
+ *         "Path": "/",
+ *         "RoleId": "AIDGPMS9RO4H3FEXAMPLE",
+ *         "RoleName": "Test-Role"
+ *       }
+ *     ]
+ *   }
+ * }
+ * *\/
+ * // example id: 463b9ba5-18cc-4608-9ccb-5a7c6b6e5fe7
+ * ```
+ *
  */
 export declare class GetInstanceProfileCommand extends $Command<GetInstanceProfileCommandInput, GetInstanceProfileCommandOutput, IAMClientResolvedConfig> {
     readonly input: GetInstanceProfileCommandInput;

package/dist-types/commands/GetLoginProfileCommand.d.ts

@@ -38,6 +38,25 @@ export interface GetLoginProfileCommandOutput extends GetLoginProfileResponse, _
  * @see {@link GetLoginProfileCommandOutput} for command's `response` shape.
  * @see {@link IAMClientResolvedConfig | config} for IAMClient's `config` shape.
  *
+ * @example To get password information for an IAM user
+ * ```javascript
+ * // The following command gets information about the password for the IAM user named Anika.
+ * const input = {
+ *   "UserName": "Anika"
+ * };
+ * const command = new GetLoginProfileCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "LoginProfile": {
+ *     "CreateDate": "2012-09-21T23:03:39Z",
+ *     "UserName": "Anika"
+ *   }
+ * }
+ * *\/
+ * // example id: d6b580cc-909f-4925-9caa-d425cbc1ad47
+ * ```
+ *
  */
 export declare class GetLoginProfileCommand extends $Command<GetLoginProfileCommandInput, GetLoginProfileCommandOutput, IAMClientResolvedConfig> {
     readonly input: GetLoginProfileCommandInput;

package/dist-types/commands/GetOrganizationsAccessReportCommand.d.ts

@@ -47,6 +47,50 @@ export interface GetOrganizationsAccessReportCommandOutput extends GetOrganizati
  * @see {@link GetOrganizationsAccessReportCommandOutput} for command's `response` shape.
  * @see {@link IAMClientResolvedConfig | config} for IAMClient's `config` shape.
  *
+ * @example To get details from a previously generated organizational unit report
+ * ```javascript
+ * // The following operation gets details about the report with the job ID: examplea-1234-b567-cde8-90fg123abcd4
+ * const input = {
+ *   "JobId": "examplea-1234-b567-cde8-90fg123abcd4"
+ * };
+ * const command = new GetOrganizationsAccessReportCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "AccessDetails": [
+ *     {
+ *       "EntityPath": "o-a1b2c3d4e5/r-f6g7h8i9j0example/ou-1a2b3c-k9l8m7n6o5example/111122223333",
+ *       "LastAuthenticatedTime": "2019-05-25T16:29:52Z",
+ *       "Region": "us-east-1",
+ *       "ServiceName": "Amazon DynamoDB",
+ *       "ServiceNamespace": "dynamodb",
+ *       "TotalAuthenticatedEntities": 2
+ *     },
+ *     {
+ *       "EntityPath": "o-a1b2c3d4e5/r-f6g7h8i9j0example/ou-1a2b3c-k9l8m7n6o5example/123456789012",
+ *       "LastAuthenticatedTime": "2019-06-15T13:12:06Z",
+ *       "Region": "us-east-1",
+ *       "ServiceName": "AWS Identity and Access Management",
+ *       "ServiceNamespace": "iam",
+ *       "TotalAuthenticatedEntities": 4
+ *     },
+ *     {
+ *       "ServiceName": "Amazon Simple Storage Service",
+ *       "ServiceNamespace": "s3",
+ *       "TotalAuthenticatedEntities": 0
+ *     }
+ *   ],
+ *   "IsTruncated": false,
+ *   "JobCompletionDate": "2019-06-18T19:47:35.241Z",
+ *   "JobCreationDate": "2019-06-18T19:47:31.466Z",
+ *   "JobStatus": "COMPLETED",
+ *   "NumberOfServicesAccessible": 3,
+ *   "NumberOfServicesNotAccessed": 1
+ * }
+ * *\/
+ * // example id: getorganizationsaccessreport-ou
+ * ```
+ *
  */
 export declare class GetOrganizationsAccessReportCommand extends $Command<GetOrganizationsAccessReportCommandInput, GetOrganizationsAccessReportCommandOutput, IAMClientResolvedConfig> {
     readonly input: GetOrganizationsAccessReportCommandInput;

package/dist-types/commands/GetRoleCommand.d.ts

@@ -38,6 +38,34 @@ export interface GetRoleCommandOutput extends GetRoleResponse, __MetadataBearer
  * @see {@link GetRoleCommandOutput} for command's `response` shape.
  * @see {@link IAMClientResolvedConfig | config} for IAMClient's `config` shape.
  *
+ * @example To get information about an IAM role
+ * ```javascript
+ * // The following command gets information about the role named Test-Role.
+ * const input = {
+ *   "RoleName": "Test-Role"
+ * };
+ * const command = new GetRoleCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "Role": {
+ *     "Arn": "arn:aws:iam::123456789012:role/Test-Role",
+ *     "AssumeRolePolicyDocument": "<URL-encoded-JSON>",
+ *     "CreateDate": "2013-04-18T05:01:58Z",
+ *     "MaxSessionDuration": 3600,
+ *     "Path": "/",
+ *     "RoleId": "AROADBQP57FF2AEXAMPLE",
+ *     "RoleLastUsed": {
+ *       "LastUsedDate": "2019-11-18T05:01:58Z",
+ *       "Region": "us-east-1"
+ *     },
+ *     "RoleName": "Test-Role"
+ *   }
+ * }
+ * *\/
+ * // example id: 5b7d03a6-340c-472d-aa77-56425950d8b0
+ * ```
+ *
  */
 export declare class GetRoleCommand extends $Command<GetRoleCommandInput, GetRoleCommandOutput, IAMClientResolvedConfig> {
     readonly input: GetRoleCommandInput;

package/dist-types/commands/GetServiceLastAccessedDetailsCommand.d.ts

@@ -80,6 +80,39 @@ export interface GetServiceLastAccessedDetailsCommandOutput extends GetServiceLa
  * @see {@link GetServiceLastAccessedDetailsCommandOutput} for command's `response` shape.
  * @see {@link IAMClientResolvedConfig | config} for IAMClient's `config` shape.
  *
+ * @example To get details from a previously-generated report
+ * ```javascript
+ * // The following operation gets details about the report with the job ID: examplef-1305-c245-eba4-71fe298bcda7
+ * const input = {
+ *   "JobId": "examplef-1305-c245-eba4-71fe298bcda7"
+ * };
+ * const command = new GetServiceLastAccessedDetailsCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "IsTruncated": false,
+ *   "JobCompletionDate": "2018-10-24T19:47:35.241Z",
+ *   "JobCreationDate": "2018-10-24T19:47:31.466Z",
+ *   "JobStatus": "COMPLETED",
+ *   "ServicesLastAccessed": [
+ *     {
+ *       "LastAuthenticated": "2018-10-24T19:11:00Z",
+ *       "LastAuthenticatedEntity": "arn:aws:iam::123456789012:user/AWSExampleUser01",
+ *       "ServiceName": "AWS Identity and Access Management",
+ *       "ServiceNamespace": "iam",
+ *       "TotalAuthenticatedEntities": 2
+ *     },
+ *     {
+ *       "ServiceName": "Amazon Simple Storage Service",
+ *       "ServiceNamespace": "s3",
+ *       "TotalAuthenticatedEntities": 0
+ *     }
+ *   ]
+ * }
+ * *\/
+ * // example id: getserviceaccessdetails-policy-1541696298085
+ * ```
+ *
  */
 export declare class GetServiceLastAccessedDetailsCommand extends $Command<GetServiceLastAccessedDetailsCommandInput, GetServiceLastAccessedDetailsCommandOutput, IAMClientResolvedConfig> {
     readonly input: GetServiceLastAccessedDetailsCommandInput;

package/dist-types/commands/GetServiceLastAccessedDetailsWithEntitiesCommand.d.ts

@@ -54,6 +54,47 @@ export interface GetServiceLastAccessedDetailsWithEntitiesCommandOutput extends
  * @see {@link GetServiceLastAccessedDetailsWithEntitiesCommandOutput} for command's `response` shape.
  * @see {@link IAMClientResolvedConfig | config} for IAMClient's `config` shape.
  *
+ * @example To get sntity details from a previously-generated report
+ * ```javascript
+ * // The following operation returns details about the entities that attempted to access the IAM service.
+ * const input = {
+ *   "JobId": "examplef-1305-c245-eba4-71fe298bcda7",
+ *   "ServiceNamespace": "iam"
+ * };
+ * const command = new GetServiceLastAccessedDetailsWithEntitiesCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "EntityDetailsList": [
+ *     {
+ *       "EntityInfo": {
+ *         "Arn": "arn:aws:iam::123456789012:user/AWSExampleUser01",
+ *         "Id": "AIDAEX2EXAMPLEB6IGCDC",
+ *         "Name": "AWSExampleUser01",
+ *         "Path": "/",
+ *         "Type": "USER"
+ *       },
+ *       "LastAuthenticated": "2018-10-24T19:10:00Z"
+ *     },
+ *     {
+ *       "EntityInfo": {
+ *         "Arn": "arn:aws:iam::123456789012:role/AWSExampleRole01",
+ *         "Id": "AROAEAEXAMPLEIANXSIU4",
+ *         "Name": "AWSExampleRole01",
+ *         "Path": "/",
+ *         "Type": "ROLE"
+ *       }
+ *     }
+ *   ],
+ *   "IsTruncated": false,
+ *   "JobCompletionDate": "2018-10-24T19:47:35.241Z",
+ *   "JobCreationDate": "2018-10-24T19:47:31.466Z",
+ *   "JobStatus": "COMPLETED"
+ * }
+ * *\/
+ * // example id: getserviceaccessdetailsentity-policy-1541697621384
+ * ```
+ *
  */
 export declare class GetServiceLastAccessedDetailsWithEntitiesCommand extends $Command<GetServiceLastAccessedDetailsWithEntitiesCommandInput, GetServiceLastAccessedDetailsWithEntitiesCommandOutput, IAMClientResolvedConfig> {
     readonly input: GetServiceLastAccessedDetailsWithEntitiesCommandInput;

package/dist-types/commands/GetUserCommand.d.ts

@@ -32,6 +32,28 @@ export interface GetUserCommandOutput extends GetUserResponse, __MetadataBearer
  * @see {@link GetUserCommandOutput} for command's `response` shape.
  * @see {@link IAMClientResolvedConfig | config} for IAMClient's `config` shape.
  *
+ * @example To get information about an IAM user
+ * ```javascript
+ * // The following command gets information about the IAM user named Bob.
+ * const input = {
+ *   "UserName": "Bob"
+ * };
+ * const command = new GetUserCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "User": {
+ *     "Arn": "arn:aws:iam::123456789012:user/Bob",
+ *     "CreateDate": "2012-09-21T23:03:13Z",
+ *     "Path": "/",
+ *     "UserId": "AKIAIOSFODNN7EXAMPLE",
+ *     "UserName": "Bob"
+ *   }
+ * }
+ * *\/
+ * // example id: ede000a1-9e4c-40db-bd0a-d4f95e41a6ab
+ * ```
+ *
  */
 export declare class GetUserCommand extends $Command<GetUserCommandInput, GetUserCommandOutput, IAMClientResolvedConfig> {
     readonly input: GetUserCommandInput;

package/dist-types/commands/ListAccessKeysCommand.d.ts

@@ -43,6 +43,35 @@ export interface ListAccessKeysCommandOutput extends ListAccessKeysResponse, __M
  * @see {@link ListAccessKeysCommandOutput} for command's `response` shape.
  * @see {@link IAMClientResolvedConfig | config} for IAMClient's `config` shape.
  *
+ * @example To list the access key IDs for an IAM user
+ * ```javascript
+ * // The following command lists the access keys IDs for the IAM user named Alice.
+ * const input = {
+ *   "UserName": "Alice"
+ * };
+ * const command = new ListAccessKeysCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "AccessKeyMetadata": [
+ *     {
+ *       "AccessKeyId": "AKIA111111111EXAMPLE",
+ *       "CreateDate": "2016-12-01T22:19:58Z",
+ *       "Status": "Active",
+ *       "UserName": "Alice"
+ *     },
+ *     {
+ *       "AccessKeyId": "AKIA222222222EXAMPLE",
+ *       "CreateDate": "2016-12-01T22:20:01Z",
+ *       "Status": "Active",
+ *       "UserName": "Alice"
+ *     }
+ *   ]
+ * }
+ * *\/
+ * // example id: 15571463-ebea-411a-a021-1c76bd2a3625
+ * ```
+ *
  */
 export declare class ListAccessKeysCommand extends $Command<ListAccessKeysCommandInput, ListAccessKeysCommandOutput, IAMClientResolvedConfig> {
     readonly input: ListAccessKeysCommandInput;

package/dist-types/commands/ListAccountAliasesCommand.d.ts

@@ -31,6 +31,22 @@ export interface ListAccountAliasesCommandOutput extends ListAccountAliasesRespo
  * @see {@link ListAccountAliasesCommandOutput} for command's `response` shape.
  * @see {@link IAMClientResolvedConfig | config} for IAMClient's `config` shape.
  *
+ * @example To list account aliases
+ * ```javascript
+ * // The following command lists the aliases for the current account.
+ * const input = {};
+ * const command = new ListAccountAliasesCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "AccountAliases": [
+ *     "exmaple-corporation"
+ *   ]
+ * }
+ * *\/
+ * // example id: e27b457a-16f9-4e05-a006-3df7b3472741
+ * ```
+ *
  */
 export declare class ListAccountAliasesCommand extends $Command<ListAccountAliasesCommandInput, ListAccountAliasesCommandOutput, IAMClientResolvedConfig> {
     readonly input: ListAccountAliasesCommandInput;

package/dist-types/commands/ListGroupPoliciesCommand.d.ts

@@ -37,6 +37,25 @@ export interface ListGroupPoliciesCommandOutput extends ListGroupPoliciesRespons
  * @see {@link ListGroupPoliciesCommandOutput} for command's `response` shape.
  * @see {@link IAMClientResolvedConfig | config} for IAMClient's `config` shape.
  *
+ * @example To list the in-line policies for an IAM group
+ * ```javascript
+ * // The following command lists the names of in-line policies that are embedded in the IAM group named Admins.
+ * const input = {
+ *   "GroupName": "Admins"
+ * };
+ * const command = new ListGroupPoliciesCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "PolicyNames": [
+ *     "AdminRoot",
+ *     "KeyPolicy"
+ *   ]
+ * }
+ * *\/
+ * // example id: 02de5095-2410-4d3a-ac1b-cc40234af68f
+ * ```
+ *
  */
 export declare class ListGroupPoliciesCommand extends $Command<ListGroupPoliciesCommandInput, ListGroupPoliciesCommandOutput, IAMClientResolvedConfig> {
     readonly input: ListGroupPoliciesCommandInput;

package/dist-types/commands/ListGroupsCommand.d.ts

@@ -31,6 +31,42 @@ export interface ListGroupsCommandOutput extends ListGroupsResponse, __MetadataB
  * @see {@link ListGroupsCommandOutput} for command's `response` shape.
  * @see {@link IAMClientResolvedConfig | config} for IAMClient's `config` shape.
  *
+ * @example To list the IAM groups for the current account
+ * ```javascript
+ * // The following command lists the IAM groups in the current account:
+ * const input = {};
+ * const command = new ListGroupsCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "Groups": [
+ *     {
+ *       "Arn": "arn:aws:iam::123456789012:group/Admins",
+ *       "CreateDate": "2016-12-15T21:40:08.121Z",
+ *       "GroupId": "AGPA1111111111EXAMPLE",
+ *       "GroupName": "Admins",
+ *       "Path": "/division_abc/subdivision_xyz/"
+ *     },
+ *     {
+ *       "Arn": "arn:aws:iam::123456789012:group/division_abc/subdivision_xyz/product_1234/engineering/Test",
+ *       "CreateDate": "2016-11-30T14:10:01.156Z",
+ *       "GroupId": "AGP22222222222EXAMPLE",
+ *       "GroupName": "Test",
+ *       "Path": "/division_abc/subdivision_xyz/product_1234/engineering/"
+ *     },
+ *     {
+ *       "Arn": "arn:aws:iam::123456789012:group/division_abc/subdivision_xyz/product_1234/Managers",
+ *       "CreateDate": "2016-06-12T20:14:52.032Z",
+ *       "GroupId": "AGPI3333333333EXAMPLE",
+ *       "GroupName": "Managers",
+ *       "Path": "/division_abc/subdivision_xyz/product_1234/"
+ *     }
+ *   ]
+ * }
+ * *\/
+ * // example id: b3ab1380-2a21-42fb-8e85-503f65512c66
+ * ```
+ *
  */
 export declare class ListGroupsCommand extends $Command<ListGroupsCommandInput, ListGroupsCommandOutput, IAMClientResolvedConfig> {
     readonly input: ListGroupsCommandInput;

package/dist-types/commands/ListGroupsForUserCommand.d.ts

@@ -31,6 +31,37 @@ export interface ListGroupsForUserCommandOutput extends ListGroupsForUserRespons
  * @see {@link ListGroupsForUserCommandOutput} for command's `response` shape.
  * @see {@link IAMClientResolvedConfig | config} for IAMClient's `config` shape.
  *
+ * @example To list the groups that an IAM user belongs to
+ * ```javascript
+ * // The following command displays the groups that the IAM user named Bob belongs to.
+ * const input = {
+ *   "UserName": "Bob"
+ * };
+ * const command = new ListGroupsForUserCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "Groups": [
+ *     {
+ *       "Arn": "arn:aws:iam::123456789012:group/division_abc/subdivision_xyz/product_1234/engineering/Test",
+ *       "CreateDate": "2016-11-30T14:10:01.156Z",
+ *       "GroupId": "AGP2111111111EXAMPLE",
+ *       "GroupName": "Test",
+ *       "Path": "/division_abc/subdivision_xyz/product_1234/engineering/"
+ *     },
+ *     {
+ *       "Arn": "arn:aws:iam::123456789012:group/division_abc/subdivision_xyz/product_1234/Managers",
+ *       "CreateDate": "2016-06-12T20:14:52.032Z",
+ *       "GroupId": "AGPI222222222SEXAMPLE",
+ *       "GroupName": "Managers",
+ *       "Path": "/division_abc/subdivision_xyz/product_1234/"
+ *     }
+ *   ]
+ * }
+ * *\/
+ * // example id: 278ec2ee-fc28-4136-83fb-433af0ae46a2
+ * ```
+ *
  */
 export declare class ListGroupsForUserCommand extends $Command<ListGroupsForUserCommandInput, ListGroupsForUserCommandOutput, IAMClientResolvedConfig> {
     readonly input: ListGroupsForUserCommandInput;

package/dist-types/commands/ListPoliciesGrantingServiceAccessCommand.d.ts

@@ -68,6 +68,54 @@ export interface ListPoliciesGrantingServiceAccessCommandOutput extends ListPoli
  * @see {@link ListPoliciesGrantingServiceAccessCommandOutput} for command's `response` shape.
  * @see {@link IAMClientResolvedConfig | config} for IAMClient's `config` shape.
  *
+ * @example To list policies that allow access to a service
+ * ```javascript
+ * // The following operation lists policies that allow ExampleUser01 to access IAM or EC2.
+ * const input = {
+ *   "Arn": "arn:aws:iam::123456789012:user/ExampleUser01",
+ *   "ServiceNamespaces": [
+ *     "iam",
+ *     "ec2"
+ *   ]
+ * };
+ * const command = new ListPoliciesGrantingServiceAccessCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "IsTruncated": false,
+ *   "PoliciesGrantingServiceAccess": [
+ *     {
+ *       "Policies": [
+ *         {
+ *           "PolicyArn": "arn:aws:iam::123456789012:policy/ExampleIamPolicy",
+ *           "PolicyName": "ExampleIamPolicy",
+ *           "PolicyType": "MANAGED"
+ *         },
+ *         {
+ *           "EntityName": "AWSExampleGroup1",
+ *           "EntityType": "GROUP",
+ *           "PolicyName": "ExampleGroup1Policy",
+ *           "PolicyType": "INLINE"
+ *         }
+ *       ],
+ *       "ServiceNamespace": "iam"
+ *     },
+ *     {
+ *       "Policies": [
+ *         {
+ *           "PolicyArn": "arn:aws:iam::123456789012:policy/ExampleEc2Policy",
+ *           "PolicyName": "ExampleEc2Policy",
+ *           "PolicyType": "MANAGED"
+ *         }
+ *       ],
+ *       "ServiceNamespace": "ec2"
+ *     }
+ *   ]
+ * }
+ * *\/
+ * // example id: listpoliciesaccess-user-1541698749508
+ * ```
+ *
  */
 export declare class ListPoliciesGrantingServiceAccessCommand extends $Command<ListPoliciesGrantingServiceAccessCommandInput, ListPoliciesGrantingServiceAccessCommandOutput, IAMClientResolvedConfig> {
     readonly input: ListPoliciesGrantingServiceAccessCommandInput;

package/dist-types/commands/ListRoleTagsCommand.d.ts

@@ -31,6 +31,32 @@ export interface ListRoleTagsCommandOutput extends ListRoleTagsResponse, __Metad
  * @see {@link ListRoleTagsCommandOutput} for command's `response` shape.
  * @see {@link IAMClientResolvedConfig | config} for IAMClient's `config` shape.
  *
+ * @example To list the tags attached to an IAM role
+ * ```javascript
+ * // The following example shows how to list the tags attached to a role.
+ * const input = {
+ *   "RoleName": "taggedrole1"
+ * };
+ * const command = new ListRoleTagsCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "IsTruncated": false,
+ *   "Tags": [
+ *     {
+ *       "Key": "Dept",
+ *       "Value": "12345"
+ *     },
+ *     {
+ *       "Key": "Team",
+ *       "Value": "Accounting"
+ *     }
+ *   ]
+ * }
+ * *\/
+ * // example id: to-list-the-tags-attached-to-an-iam-role-1506719238376
+ * ```
+ *
  */
 export declare class ListRoleTagsCommand extends $Command<ListRoleTagsCommandInput, ListRoleTagsCommandOutput, IAMClientResolvedConfig> {
     readonly input: ListRoleTagsCommandInput;

package/dist-types/commands/ListSigningCertificatesCommand.d.ts

@@ -38,6 +38,30 @@ export interface ListSigningCertificatesCommandOutput extends ListSigningCertifi
  * @see {@link ListSigningCertificatesCommandOutput} for command's `response` shape.
  * @see {@link IAMClientResolvedConfig | config} for IAMClient's `config` shape.
  *
+ * @example To list the signing certificates for an IAM user
+ * ```javascript
+ * // The following command lists the signing certificates for the IAM user named Bob.
+ * const input = {
+ *   "UserName": "Bob"
+ * };
+ * const command = new ListSigningCertificatesCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "Certificates": [
+ *     {
+ *       "CertificateBody": "-----BEGIN CERTIFICATE-----<certificate-body>-----END CERTIFICATE-----",
+ *       "CertificateId": "TA7SMP42TDN5Z26OBPJE7EXAMPLE",
+ *       "Status": "Active",
+ *       "UploadDate": "2013-06-06T21:40:08Z",
+ *       "UserName": "Bob"
+ *     }
+ *   ]
+ * }
+ * *\/
+ * // example id: b4c10256-4fc9-457e-b3fd-4a110d4d73dc
+ * ```
+ *
  */
 export declare class ListSigningCertificatesCommand extends $Command<ListSigningCertificatesCommandInput, ListSigningCertificatesCommandOutput, IAMClientResolvedConfig> {
     readonly input: ListSigningCertificatesCommandInput;