@aws-sdk/client-iam 3.288.0 → 3.289.0

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

@@ -32,6 +32,18 @@ export interface AddClientIDToOpenIDConnectProviderCommandOutput extends __Metad
  * @see {@link AddClientIDToOpenIDConnectProviderCommandOutput} for command's `response` shape.
  * @see {@link IAMClientResolvedConfig | config} for IAMClient's `config` shape.
  *
+ * @example To add a client ID (audience) to an Open-ID Connect (OIDC) provider
+ * ```javascript
+ * // The following add-client-id-to-open-id-connect-provider command adds the client ID my-application-ID to the OIDC provider named server.example.com:
+ * const input = {
+ *   "ClientID": "my-application-ID",
+ *   "OpenIDConnectProviderArn": "arn:aws:iam::123456789012:oidc-provider/server.example.com"
+ * };
+ * const command = new AddClientIDToOpenIDConnectProviderCommand(input);
+ * await client.send(command);
+ * // example id: 028e91f4-e2a6-4d59-9e3b-4965a3fb19be
+ * ```
+ *
  */
 export declare class AddClientIDToOpenIDConnectProviderCommand extends $Command<AddClientIDToOpenIDConnectProviderCommandInput, AddClientIDToOpenIDConnectProviderCommandOutput, IAMClientResolvedConfig> {
     readonly input: AddClientIDToOpenIDConnectProviderCommandInput;

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

@@ -41,6 +41,18 @@ export interface AddRoleToInstanceProfileCommandOutput extends __MetadataBearer
  * @see {@link AddRoleToInstanceProfileCommandOutput} for command's `response` shape.
  * @see {@link IAMClientResolvedConfig | config} for IAMClient's `config` shape.
  *
+ * @example To add a role to an instance profile
+ * ```javascript
+ * // The following command adds the role named S3Access to the instance profile named Webserver:
+ * const input = {
+ *   "InstanceProfileName": "Webserver",
+ *   "RoleName": "S3Access"
+ * };
+ * const command = new AddRoleToInstanceProfileCommand(input);
+ * await client.send(command);
+ * // example id: c107fac3-edb6-4827-8a71-8863ec91c81f
+ * ```
+ *
  */
 export declare class AddRoleToInstanceProfileCommand extends $Command<AddRoleToInstanceProfileCommandInput, AddRoleToInstanceProfileCommandOutput, IAMClientResolvedConfig> {
     readonly input: AddRoleToInstanceProfileCommandInput;

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

@@ -29,6 +29,18 @@ export interface AddUserToGroupCommandOutput extends __MetadataBearer {
  * @see {@link AddUserToGroupCommandOutput} for command's `response` shape.
  * @see {@link IAMClientResolvedConfig | config} for IAMClient's `config` shape.
  *
+ * @example To add a user to an IAM group
+ * ```javascript
+ * // The following command adds an IAM user named Bob to the IAM group named Admins:
+ * const input = {
+ *   "GroupName": "Admins",
+ *   "UserName": "Bob"
+ * };
+ * const command = new AddUserToGroupCommand(input);
+ * await client.send(command);
+ * // example id: 619c7e6b-09f8-4036-857b-51a6ea5027ca
+ * ```
+ *
  */
 export declare class AddUserToGroupCommand extends $Command<AddUserToGroupCommandInput, AddUserToGroupCommandOutput, IAMClientResolvedConfig> {
     readonly input: AddUserToGroupCommandInput;

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

@@ -36,6 +36,18 @@ export interface AttachGroupPolicyCommandOutput extends __MetadataBearer {
  * @see {@link AttachGroupPolicyCommandOutput} for command's `response` shape.
  * @see {@link IAMClientResolvedConfig | config} for IAMClient's `config` shape.
  *
+ * @example To attach a managed policy to an IAM group
+ * ```javascript
+ * // The following command attaches the AWS managed policy named ReadOnlyAccess to the IAM group named Finance.
+ * const input = {
+ *   "GroupName": "Finance",
+ *   "PolicyArn": "arn:aws:iam::aws:policy/ReadOnlyAccess"
+ * };
+ * const command = new AttachGroupPolicyCommand(input);
+ * await client.send(command);
+ * // example id: 87551489-86f0-45db-9889-759936778f2b
+ * ```
+ *
  */
 export declare class AttachGroupPolicyCommand extends $Command<AttachGroupPolicyCommandInput, AttachGroupPolicyCommandOutput, IAMClientResolvedConfig> {
     readonly input: AttachGroupPolicyCommandInput;

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

@@ -43,6 +43,18 @@ export interface AttachRolePolicyCommandOutput extends __MetadataBearer {
  * @see {@link AttachRolePolicyCommandOutput} for command's `response` shape.
  * @see {@link IAMClientResolvedConfig | config} for IAMClient's `config` shape.
  *
+ * @example To attach a managed policy to an IAM role
+ * ```javascript
+ * // The following command attaches the AWS managed policy named ReadOnlyAccess to the IAM role named ReadOnlyRole.
+ * const input = {
+ *   "PolicyArn": "arn:aws:iam::aws:policy/ReadOnlyAccess",
+ *   "RoleName": "ReadOnlyRole"
+ * };
+ * const command = new AttachRolePolicyCommand(input);
+ * await client.send(command);
+ * // example id: 3e1b8c7c-99c8-4fc4-a20c-131fe3f22c7e
+ * ```
+ *
  */
 export declare class AttachRolePolicyCommand extends $Command<AttachRolePolicyCommandInput, AttachRolePolicyCommandOutput, IAMClientResolvedConfig> {
     readonly input: AttachRolePolicyCommandInput;

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

@@ -36,6 +36,18 @@ export interface AttachUserPolicyCommandOutput extends __MetadataBearer {
  * @see {@link AttachUserPolicyCommandOutput} for command's `response` shape.
  * @see {@link IAMClientResolvedConfig | config} for IAMClient's `config` shape.
  *
+ * @example To attach a managed policy to an IAM user
+ * ```javascript
+ * // The following command attaches the AWS managed policy named AdministratorAccess to the IAM user named Alice.
+ * const input = {
+ *   "PolicyArn": "arn:aws:iam::aws:policy/AdministratorAccess",
+ *   "UserName": "Alice"
+ * };
+ * const command = new AttachUserPolicyCommand(input);
+ * await client.send(command);
+ * // example id: 1372ebd8-9475-4b1a-a479-23b6fd4b8b3e
+ * ```
+ *
  */
 export declare class AttachUserPolicyCommand extends $Command<AttachUserPolicyCommandInput, AttachUserPolicyCommandOutput, IAMClientResolvedConfig> {
     readonly input: AttachUserPolicyCommandInput;

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

@@ -36,6 +36,18 @@ export interface ChangePasswordCommandOutput extends __MetadataBearer {
  * @see {@link ChangePasswordCommandOutput} for command's `response` shape.
  * @see {@link IAMClientResolvedConfig | config} for IAMClient's `config` shape.
  *
+ * @example To change the password for your IAM user
+ * ```javascript
+ * // The following command changes the password for the current IAM user.
+ * const input = {
+ *   "NewPassword": "]35d/{pB9Fo9wJ",
+ *   "OldPassword": "3s0K_;xh4~8XXI"
+ * };
+ * const command = new ChangePasswordCommand(input);
+ * await client.send(command);
+ * // example id: 3a80c66f-bffb-46df-947c-1e8fa583b470
+ * ```
+ *
  */
 export declare class ChangePasswordCommand extends $Command<ChangePasswordCommandInput, ChangePasswordCommandOutput, IAMClientResolvedConfig> {
     readonly input: ChangePasswordCommandInput;

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

@@ -42,6 +42,28 @@ export interface CreateAccessKeyCommandOutput extends CreateAccessKeyResponse, _
  * @see {@link CreateAccessKeyCommandOutput} for command's `response` shape.
  * @see {@link IAMClientResolvedConfig | config} for IAMClient's `config` shape.
  *
+ * @example To create an access key for an IAM user
+ * ```javascript
+ * // The following command creates an access key (access key ID and secret access key) for the IAM user named Bob.
+ * const input = {
+ *   "UserName": "Bob"
+ * };
+ * const command = new CreateAccessKeyCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "AccessKey": {
+ *     "AccessKeyId": "AKIAIOSFODNN7EXAMPLE",
+ *     "CreateDate": "2015-03-09T18:39:23.411Z",
+ *     "SecretAccessKey": "wJalrXUtnFEMI/K7MDENG/bPxRfiCYzEXAMPLEKEY",
+ *     "Status": "Active",
+ *     "UserName": "Bob"
+ *   }
+ * }
+ * *\/
+ * // example id: 1fbb3211-4cf2-41db-8c20-ba58d9f5802d
+ * ```
+ *
  */
 export declare class CreateAccessKeyCommand extends $Command<CreateAccessKeyCommandInput, CreateAccessKeyCommandOutput, IAMClientResolvedConfig> {
     readonly input: CreateAccessKeyCommandInput;

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

@@ -32,6 +32,17 @@ export interface CreateAccountAliasCommandOutput extends __MetadataBearer {
  * @see {@link CreateAccountAliasCommandOutput} for command's `response` shape.
  * @see {@link IAMClientResolvedConfig | config} for IAMClient's `config` shape.
  *
+ * @example To create an account alias
+ * ```javascript
+ * // The following command associates the alias examplecorp to your AWS account.
+ * const input = {
+ *   "AccountAlias": "examplecorp"
+ * };
+ * const command = new CreateAccountAliasCommand(input);
+ * await client.send(command);
+ * // example id: 5adaf6fb-94fc-4ca2-b825-2fbc2062add1
+ * ```
+ *
  */
 export declare class CreateAccountAliasCommand extends $Command<CreateAccountAliasCommandInput, CreateAccountAliasCommandOutput, IAMClientResolvedConfig> {
     readonly input: CreateAccountAliasCommandInput;

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

@@ -31,6 +31,28 @@ export interface CreateGroupCommandOutput extends CreateGroupResponse, __Metadat
  * @see {@link CreateGroupCommandOutput} for command's `response` shape.
  * @see {@link IAMClientResolvedConfig | config} for IAMClient's `config` shape.
  *
+ * @example To create an IAM group
+ * ```javascript
+ * // The following command creates an IAM group named Admins.
+ * const input = {
+ *   "GroupName": "Admins"
+ * };
+ * const command = new CreateGroupCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "Group": {
+ *     "Arn": "arn:aws:iam::123456789012:group/Admins",
+ *     "CreateDate": "2015-03-09T20:30:24.940Z",
+ *     "GroupId": "AIDGPMS9RO4H3FEXAMPLE",
+ *     "GroupName": "Admins",
+ *     "Path": "/"
+ *   }
+ * }
+ * *\/
+ * // example id: d5da2a90-5e69-4ef7-8ae8-4c33dc21fd21
+ * ```
+ *
  */
 export declare class CreateGroupCommand extends $Command<CreateGroupCommandInput, CreateGroupCommandOutput, IAMClientResolvedConfig> {
     readonly input: CreateGroupCommandInput;

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

@@ -33,6 +33,29 @@ export interface CreateInstanceProfileCommandOutput extends CreateInstanceProfil
  * @see {@link CreateInstanceProfileCommandOutput} for command's `response` shape.
  * @see {@link IAMClientResolvedConfig | config} for IAMClient's `config` shape.
  *
+ * @example To create an instance profile
+ * ```javascript
+ * // The following command creates an instance profile named Webserver that is ready to have a role attached and then be associated with an EC2 instance.
+ * const input = {
+ *   "InstanceProfileName": "Webserver"
+ * };
+ * const command = new CreateInstanceProfileCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "InstanceProfile": {
+ *     "Arn": "arn:aws:iam::123456789012:instance-profile/Webserver",
+ *     "CreateDate": "2015-03-09T20:33:19.626Z",
+ *     "InstanceProfileId": "AIPAJMBYC7DLSPEXAMPLE",
+ *     "InstanceProfileName": "Webserver",
+ *     "Path": "/",
+ *     "Roles": []
+ *   }
+ * }
+ * *\/
+ * // example id: 5d84e6ae-5921-4e39-8454-10232cd9ff9a
+ * ```
+ *
  */
 export declare class CreateInstanceProfileCommand extends $Command<CreateInstanceProfileCommandInput, CreateInstanceProfileCommandOutput, IAMClientResolvedConfig> {
     readonly input: CreateInstanceProfileCommandInput;

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

@@ -34,6 +34,28 @@ export interface CreateLoginProfileCommandOutput extends CreateLoginProfileRespo
  * @see {@link CreateLoginProfileCommandOutput} for command's `response` shape.
  * @see {@link IAMClientResolvedConfig | config} for IAMClient's `config` shape.
  *
+ * @example To create an instance profile
+ * ```javascript
+ * // The following command changes IAM user Bob's password and sets the flag that required Bob to change the password the next time he signs in.
+ * const input = {
+ *   "Password": "h]6EszR}vJ*m",
+ *   "PasswordResetRequired": true,
+ *   "UserName": "Bob"
+ * };
+ * const command = new CreateLoginProfileCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "LoginProfile": {
+ *     "CreateDate": "2015-03-10T20:55:40.274Z",
+ *     "PasswordResetRequired": true,
+ *     "UserName": "Bob"
+ *   }
+ * }
+ * *\/
+ * // example id: c63795bc-3444-40b3-89df-83c474ef88be
+ * ```
+ *
  */
 export declare class CreateLoginProfileCommand extends $Command<CreateLoginProfileCommandInput, CreateLoginProfileCommandOutput, IAMClientResolvedConfig> {
     readonly input: CreateLoginProfileCommandInput;

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

@@ -67,6 +67,28 @@ export interface CreateOpenIDConnectProviderCommandOutput extends CreateOpenIDCo
  * @see {@link CreateOpenIDConnectProviderCommandOutput} for command's `response` shape.
  * @see {@link IAMClientResolvedConfig | config} for IAMClient's `config` shape.
  *
+ * @example To create an instance profile
+ * ```javascript
+ * // The following example defines a new OIDC provider in IAM with a client ID of my-application-id and pointing at the server with a URL of https://server.example.com.
+ * const input = {
+ *   "ClientIDList": [
+ *     "my-application-id"
+ *   ],
+ *   "ThumbprintList": [
+ *     "3768084dfb3d2b68b7897bf5f565da8efEXAMPLE"
+ *   ],
+ *   "Url": "https://server.example.com"
+ * };
+ * const command = new CreateOpenIDConnectProviderCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "OpenIDConnectProviderArn": "arn:aws:iam::123456789012:oidc-provider/server.example.com"
+ * }
+ * *\/
+ * // example id: 4e4a6bff-cc97-4406-922e-0ab4a82cdb63
+ * ```
+ *
  */
 export declare class CreateOpenIDConnectProviderCommand extends $Command<CreateOpenIDConnectProviderCommandInput, CreateOpenIDConnectProviderCommandOutput, IAMClientResolvedConfig> {
     readonly input: CreateOpenIDConnectProviderCommandInput;

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

@@ -33,6 +33,31 @@ export interface CreateRoleCommandOutput extends CreateRoleResponse, __MetadataB
  * @see {@link CreateRoleCommandOutput} for command's `response` shape.
  * @see {@link IAMClientResolvedConfig | config} for IAMClient's `config` shape.
  *
+ * @example To create an IAM role
+ * ```javascript
+ * // The following command creates a role named Test-Role and attaches a trust policy that you must convert from JSON to a string. Upon success, the response includes the same policy as a URL-encoded JSON string.
+ * const input = {
+ *   "AssumeRolePolicyDocument": "<Stringified-JSON>",
+ *   "Path": "/",
+ *   "RoleName": "Test-Role"
+ * };
+ * const command = new CreateRoleCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "Role": {
+ *     "Arn": "arn:aws:iam::123456789012:role/Test-Role",
+ *     "AssumeRolePolicyDocument": "<URL-encoded-JSON>",
+ *     "CreateDate": "2013-06-07T20:43:32.821Z",
+ *     "Path": "/",
+ *     "RoleId": "AKIAIOSFODNN7EXAMPLE",
+ *     "RoleName": "Test-Role"
+ *   }
+ * }
+ * *\/
+ * // example id: eaaa4b5f-51f1-4f73-b0d3-30127040eff8
+ * ```
+ *
  */
 export declare class CreateRoleCommand extends $Command<CreateRoleCommandInput, CreateRoleCommandOutput, IAMClientResolvedConfig> {
     readonly input: CreateRoleCommandInput;

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

@@ -31,6 +31,28 @@ export interface CreateUserCommandOutput extends CreateUserResponse, __MetadataB
  * @see {@link CreateUserCommandOutput} for command's `response` shape.
  * @see {@link IAMClientResolvedConfig | config} for IAMClient's `config` shape.
  *
+ * @example To create an IAM user
+ * ```javascript
+ * // The following create-user command creates an IAM user named Bob in the current account.
+ * const input = {
+ *   "UserName": "Bob"
+ * };
+ * const command = new CreateUserCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "User": {
+ *     "Arn": "arn:aws:iam::123456789012:user/Bob",
+ *     "CreateDate": "2013-06-08T03:20:41.270Z",
+ *     "Path": "/",
+ *     "UserId": "AKIAIOSFODNN7EXAMPLE",
+ *     "UserName": "Bob"
+ *   }
+ * }
+ * *\/
+ * // example id: eb15f90b-e5f5-4af8-a594-e4e82b181a62
+ * ```
+ *
  */
 export declare class CreateUserCommand extends $Command<CreateUserCommandInput, CreateUserCommandOutput, IAMClientResolvedConfig> {
     readonly input: CreateUserCommandInput;

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

@@ -33,6 +33,18 @@ export interface DeleteAccessKeyCommandOutput extends __MetadataBearer {
  * @see {@link DeleteAccessKeyCommandOutput} for command's `response` shape.
  * @see {@link IAMClientResolvedConfig | config} for IAMClient's `config` shape.
  *
+ * @example To delete an access key for an IAM user
+ * ```javascript
+ * // The following command deletes one access key (access key ID and secret access key) assigned to the IAM user named Bob.
+ * const input = {
+ *   "AccessKeyId": "AKIDPMS9RO4H3FEXAMPLE",
+ *   "UserName": "Bob"
+ * };
+ * const command = new DeleteAccessKeyCommand(input);
+ * await client.send(command);
+ * // example id: 61a785a7-d30a-415a-ae18-ab9236e56871
+ * ```
+ *
  */
 export declare class DeleteAccessKeyCommand extends $Command<DeleteAccessKeyCommandInput, DeleteAccessKeyCommandOutput, IAMClientResolvedConfig> {
     readonly input: DeleteAccessKeyCommandInput;

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

@@ -31,6 +31,17 @@ export interface DeleteAccountAliasCommandOutput extends __MetadataBearer {
  * @see {@link DeleteAccountAliasCommandOutput} for command's `response` shape.
  * @see {@link IAMClientResolvedConfig | config} for IAMClient's `config` shape.
  *
+ * @example To delete an account alias
+ * ```javascript
+ * // The following command removes the alias mycompany from the current AWS account:
+ * const input = {
+ *   "AccountAlias": "mycompany"
+ * };
+ * const command = new DeleteAccountAliasCommand(input);
+ * await client.send(command);
+ * // example id: 7abeca65-04a8-4500-a890-47f1092bf766
+ * ```
+ *
  */
 export declare class DeleteAccountAliasCommand extends $Command<DeleteAccountAliasCommandInput, DeleteAccountAliasCommandOutput, IAMClientResolvedConfig> {
     readonly input: DeleteAccountAliasCommandInput;

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

@@ -28,6 +28,15 @@ export interface DeleteAccountPasswordPolicyCommandOutput extends __MetadataBear
  * @see {@link DeleteAccountPasswordPolicyCommandOutput} for command's `response` shape.
  * @see {@link IAMClientResolvedConfig | config} for IAMClient's `config` shape.
  *
+ * @example To delete the current account password policy
+ * ```javascript
+ * // The following command removes the password policy from the current AWS account:
+ * const input = undefined;
+ * const command = new DeleteAccountPasswordPolicyCommand(input);
+ * await client.send(command);
+ * // example id: 9ddf755e-495c-49bc-ae3b-ea6cc9b8ebcf
+ * ```
+ *
  */
 export declare class DeleteAccountPasswordPolicyCommand extends $Command<DeleteAccountPasswordPolicyCommandInput, DeleteAccountPasswordPolicyCommandOutput, IAMClientResolvedConfig> {
     readonly input: DeleteAccountPasswordPolicyCommandInput;

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

@@ -34,6 +34,18 @@ export interface DeleteGroupPolicyCommandOutput extends __MetadataBearer {
  * @see {@link DeleteGroupPolicyCommandOutput} for command's `response` shape.
  * @see {@link IAMClientResolvedConfig | config} for IAMClient's `config` shape.
  *
+ * @example To delete a policy from an IAM group
+ * ```javascript
+ * // The following command deletes the policy named ExamplePolicy from the group named Admins:
+ * const input = {
+ *   "GroupName": "Admins",
+ *   "PolicyName": "ExamplePolicy"
+ * };
+ * const command = new DeleteGroupPolicyCommand(input);
+ * await client.send(command);
+ * // example id: e683f2bd-98a4-4fe0-bb66-33169c692d4a
+ * ```
+ *
  */
 export declare class DeleteGroupPolicyCommand extends $Command<DeleteGroupPolicyCommandInput, DeleteGroupPolicyCommandOutput, IAMClientResolvedConfig> {
     readonly input: DeleteGroupPolicyCommandInput;

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

@@ -38,6 +38,17 @@ export interface DeleteInstanceProfileCommandOutput extends __MetadataBearer {
  * @see {@link DeleteInstanceProfileCommandOutput} for command's `response` shape.
  * @see {@link IAMClientResolvedConfig | config} for IAMClient's `config` shape.
  *
+ * @example To delete an instance profile
+ * ```javascript
+ * // The following command deletes the instance profile named ExampleInstanceProfile
+ * const input = {
+ *   "InstanceProfileName": "ExampleInstanceProfile"
+ * };
+ * const command = new DeleteInstanceProfileCommand(input);
+ * await client.send(command);
+ * // example id: 12d74fb8-3433-49db-8171-a1fc764e354d
+ * ```
+ *
  */
 export declare class DeleteInstanceProfileCommand extends $Command<DeleteInstanceProfileCommandInput, DeleteInstanceProfileCommandOutput, IAMClientResolvedConfig> {
     readonly input: DeleteInstanceProfileCommandInput;

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

@@ -41,6 +41,17 @@ export interface DeleteLoginProfileCommandOutput extends __MetadataBearer {
  * @see {@link DeleteLoginProfileCommandOutput} for command's `response` shape.
  * @see {@link IAMClientResolvedConfig | config} for IAMClient's `config` shape.
  *
+ * @example To delete a password for an IAM user
+ * ```javascript
+ * // The following command deletes the password for the IAM user named Bob.
+ * const input = {
+ *   "UserName": "Bob"
+ * };
+ * const command = new DeleteLoginProfileCommand(input);
+ * await client.send(command);
+ * // example id: 1fe57059-fc73-42e2-b992-517b7d573b5c
+ * ```
+ *
  */
 export declare class DeleteLoginProfileCommand extends $Command<DeleteLoginProfileCommandInput, DeleteLoginProfileCommandOutput, IAMClientResolvedConfig> {
     readonly input: DeleteLoginProfileCommandInput;

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

@@ -52,6 +52,17 @@ export interface DeleteRoleCommandOutput extends __MetadataBearer {
  * @see {@link DeleteRoleCommandOutput} for command's `response` shape.
  * @see {@link IAMClientResolvedConfig | config} for IAMClient's `config` shape.
  *
+ * @example To delete an IAM role
+ * ```javascript
+ * // The following command removes the role named Test-Role.
+ * const input = {
+ *   "RoleName": "Test-Role"
+ * };
+ * const command = new DeleteRoleCommand(input);
+ * await client.send(command);
+ * // example id: 053cdf74-9bda-44b8-bdbb-140fd5a32603
+ * ```
+ *
  */
 export declare class DeleteRoleCommand extends $Command<DeleteRoleCommandInput, DeleteRoleCommandOutput, IAMClientResolvedConfig> {
     readonly input: DeleteRoleCommandInput;

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

@@ -34,6 +34,18 @@ export interface DeleteRolePolicyCommandOutput extends __MetadataBearer {
  * @see {@link DeleteRolePolicyCommandOutput} for command's `response` shape.
  * @see {@link IAMClientResolvedConfig | config} for IAMClient's `config` shape.
  *
+ * @example To remove a policy from an IAM role
+ * ```javascript
+ * // The following command removes the policy named ExamplePolicy from the role named Test-Role.
+ * const input = {
+ *   "PolicyName": "ExamplePolicy",
+ *   "RoleName": "Test-Role"
+ * };
+ * const command = new DeleteRolePolicyCommand(input);
+ * await client.send(command);
+ * // example id: 9c667336-fde3-462c-b8f3-950800821e27
+ * ```
+ *
  */
 export declare class DeleteRolePolicyCommand extends $Command<DeleteRolePolicyCommandInput, DeleteRolePolicyCommandOutput, IAMClientResolvedConfig> {
     readonly input: DeleteRolePolicyCommandInput;

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

@@ -33,6 +33,18 @@ export interface DeleteSigningCertificateCommandOutput extends __MetadataBearer
  * @see {@link DeleteSigningCertificateCommandOutput} for command's `response` shape.
  * @see {@link IAMClientResolvedConfig | config} for IAMClient's `config` shape.
  *
+ * @example To delete a signing certificate for an IAM user
+ * ```javascript
+ * // The following command deletes the specified signing certificate for the IAM user named Anika.
+ * const input = {
+ *   "CertificateId": "TA7SMP42TDN5Z26OBPJE7EXAMPLE",
+ *   "UserName": "Anika"
+ * };
+ * const command = new DeleteSigningCertificateCommand(input);
+ * await client.send(command);
+ * // example id: e3357586-ba9c-4070-b35b-d1a899b71987
+ * ```
+ *
  */
 export declare class DeleteSigningCertificateCommand extends $Command<DeleteSigningCertificateCommandInput, DeleteSigningCertificateCommandOutput, IAMClientResolvedConfig> {
     readonly input: DeleteSigningCertificateCommandInput;

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

@@ -61,6 +61,17 @@ export interface DeleteUserCommandOutput extends __MetadataBearer {
  * @see {@link DeleteUserCommandOutput} for command's `response` shape.
  * @see {@link IAMClientResolvedConfig | config} for IAMClient's `config` shape.
  *
+ * @example To delete an IAM user
+ * ```javascript
+ * // The following command removes the IAM user named Bob from the current account.
+ * const input = {
+ *   "UserName": "Bob"
+ * };
+ * const command = new DeleteUserCommand(input);
+ * await client.send(command);
+ * // example id: a13dc3f9-59fe-42d9-abbb-fb98b204fdf0
+ * ```
+ *
  */
 export declare class DeleteUserCommand extends $Command<DeleteUserCommandInput, DeleteUserCommandOutput, IAMClientResolvedConfig> {
     readonly input: DeleteUserCommandInput;

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

@@ -34,6 +34,18 @@ export interface DeleteUserPolicyCommandOutput extends __MetadataBearer {
  * @see {@link DeleteUserPolicyCommandOutput} for command's `response` shape.
  * @see {@link IAMClientResolvedConfig | config} for IAMClient's `config` shape.
  *
+ * @example To remove a policy from an IAM user
+ * ```javascript
+ * // The following delete-user-policy command removes the specified policy from the IAM user named Juan:
+ * const input = {
+ *   "PolicyName": "ExamplePolicy",
+ *   "UserName": "Juan"
+ * };
+ * const command = new DeleteUserPolicyCommand(input);
+ * await client.send(command);
+ * // example id: 34f07ddc-9bc1-4f52-bc59-cd0a3ccd06c8
+ * ```
+ *
  */
 export declare class DeleteUserPolicyCommand extends $Command<DeleteUserPolicyCommandInput, DeleteUserPolicyCommandOutput, IAMClientResolvedConfig> {
     readonly input: DeleteUserPolicyCommandInput;

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

@@ -33,6 +33,17 @@ export interface DeleteVirtualMFADeviceCommandOutput extends __MetadataBearer {
  * @see {@link DeleteVirtualMFADeviceCommandOutput} for command's `response` shape.
  * @see {@link IAMClientResolvedConfig | config} for IAMClient's `config` shape.
  *
+ * @example To remove a virtual MFA device
+ * ```javascript
+ * // The following delete-virtual-mfa-device command removes the specified MFA device from the current AWS account.
+ * const input = {
+ *   "SerialNumber": "arn:aws:iam::123456789012:mfa/ExampleName"
+ * };
+ * const command = new DeleteVirtualMFADeviceCommand(input);
+ * await client.send(command);
+ * // example id: 2933b08b-dbe7-4b89-b8c1-fdf75feea1ee
+ * ```
+ *
  */
 export declare class DeleteVirtualMFADeviceCommand extends $Command<DeleteVirtualMFADeviceCommandInput, DeleteVirtualMFADeviceCommandOutput, IAMClientResolvedConfig> {
     readonly input: DeleteVirtualMFADeviceCommandInput;

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

@@ -160,6 +160,22 @@ export interface GenerateOrganizationsAccessReportCommandOutput extends Generate
  * @see {@link GenerateOrganizationsAccessReportCommandOutput} for command's `response` shape.
  * @see {@link IAMClientResolvedConfig | config} for IAMClient's `config` shape.
  *
+ * @example To generate a service last accessed data report for an organizational unit
+ * ```javascript
+ * // The following operation generates a report for the organizational unit ou-rge0-awexample
+ * const input = {
+ *   "EntityPath": "o-a1b2c3d4e5/r-f6g7h8i9j0example/ou-1a2b3c-k9l8m7n6o5example"
+ * };
+ * const command = new GenerateOrganizationsAccessReportCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "JobId": "examplea-1234-b567-cde8-90fg123abcd4"
+ * }
+ * *\/
+ * // example id: generateorganizationsaccessreport-ou
+ * ```
+ *
  */
 export declare class GenerateOrganizationsAccessReportCommand extends $Command<GenerateOrganizationsAccessReportCommandInput, GenerateOrganizationsAccessReportCommandOutput, IAMClientResolvedConfig> {
     readonly input: GenerateOrganizationsAccessReportCommandInput;

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

@@ -82,6 +82,22 @@ export interface GenerateServiceLastAccessedDetailsCommandOutput extends Generat
  * @see {@link GenerateServiceLastAccessedDetailsCommandOutput} for command's `response` shape.
  * @see {@link IAMClientResolvedConfig | config} for IAMClient's `config` shape.
  *
+ * @example To generate a service last accessed data report for a policy
+ * ```javascript
+ * // The following operation generates a report for the policy: ExamplePolicy1
+ * const input = {
+ *   "Arn": "arn:aws:iam::123456789012:policy/ExamplePolicy1"
+ * };
+ * const command = new GenerateServiceLastAccessedDetailsCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "JobId": "examplef-1305-c245-eba4-71fe298bcda7"
+ * }
+ * *\/
+ * // example id: generateaccessdata-policy-1541695178514
+ * ```
+ *
  */
 export declare class GenerateServiceLastAccessedDetailsCommand extends $Command<GenerateServiceLastAccessedDetailsCommandInput, GenerateServiceLastAccessedDetailsCommandOutput, IAMClientResolvedConfig> {
     readonly input: GenerateServiceLastAccessedDetailsCommandInput;