@aws-sdk/client-iam 3.287.0 → 3.289.0

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

@@ -30,6 +30,32 @@ export interface ListUserTagsCommandOutput extends ListUserTagsResponse, __Metad
  * @see {@link ListUserTagsCommandOutput} for command's `response` shape.
  * @see {@link IAMClientResolvedConfig | config} for IAMClient's `config` shape.
  *
+ * @example To list the tags attached to an IAM user
+ * ```javascript
+ * // The following example shows how to list the tags attached to a user.
+ * const input = {
+ *   "UserName": "anika"
+ * };
+ * const command = new ListUserTagsCommand(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-user-1506719473186
+ * ```
+ *
  */
 export declare class ListUserTagsCommand extends $Command<ListUserTagsCommandInput, ListUserTagsCommandOutput, IAMClientResolvedConfig> {
     readonly input: ListUserTagsCommandInput;

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

@@ -37,6 +37,37 @@ export interface ListUsersCommandOutput extends ListUsersResponse, __MetadataBea
  * @see {@link ListUsersCommandOutput} for command's `response` shape.
  * @see {@link IAMClientResolvedConfig | config} for IAMClient's `config` shape.
  *
+ * @example To list IAM users
+ * ```javascript
+ * // The following command lists the IAM users in the current account.
+ * const input = {};
+ * const command = new ListUsersCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "Users": [
+ *     {
+ *       "Arn": "arn:aws:iam::123456789012:user/division_abc/subdivision_xyz/engineering/Juan",
+ *       "CreateDate": "2012-09-05T19:38:48Z",
+ *       "PasswordLastUsed": "2016-09-08T21:47:36Z",
+ *       "Path": "/division_abc/subdivision_xyz/engineering/",
+ *       "UserId": "AID2MAB8DPLSRHEXAMPLE",
+ *       "UserName": "Juan"
+ *     },
+ *     {
+ *       "Arn": "arn:aws:iam::123456789012:user/division_abc/subdivision_xyz/engineering/Anika",
+ *       "CreateDate": "2014-04-09T15:43:45Z",
+ *       "PasswordLastUsed": "2016-09-24T16:18:07Z",
+ *       "Path": "/division_abc/subdivision_xyz/engineering/",
+ *       "UserId": "AIDIODR4TAW7CSEXAMPLE",
+ *       "UserName": "Anika"
+ *     }
+ *   ]
+ * }
+ * *\/
+ * // example id: 9edfbd73-03d8-4d8a-9a79-76c85e8c8298
+ * ```
+ *
  */
 export declare class ListUsersCommand extends $Command<ListUsersCommandInput, ListUsersCommandOutput, IAMClientResolvedConfig> {
     readonly input: ListUsersCommandInput;

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

@@ -38,6 +38,27 @@ export interface ListVirtualMFADevicesCommandOutput extends ListVirtualMFADevice
  * @see {@link ListVirtualMFADevicesCommandOutput} for command's `response` shape.
  * @see {@link IAMClientResolvedConfig | config} for IAMClient's `config` shape.
  *
+ * @example To list virtual MFA devices
+ * ```javascript
+ * // The following command lists the virtual MFA devices that have been configured for the current account.
+ * const input = {};
+ * const command = new ListVirtualMFADevicesCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "VirtualMFADevices": [
+ *     {
+ *       "SerialNumber": "arn:aws:iam::123456789012:mfa/ExampleMFADevice"
+ *     },
+ *     {
+ *       "SerialNumber": "arn:aws:iam::123456789012:mfa/Juan"
+ *     }
+ *   ]
+ * }
+ * *\/
+ * // example id: 54f9ac18-5100-4070-bec4-fe5f612710d5
+ * ```
+ *
  */
 export declare class ListVirtualMFADevicesCommand extends $Command<ListVirtualMFADevicesCommandInput, ListVirtualMFADevicesCommandOutput, IAMClientResolvedConfig> {
     readonly input: ListVirtualMFADevicesCommandInput;

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

@@ -43,6 +43,19 @@ export interface PutGroupPolicyCommandOutput extends __MetadataBearer {
  * @see {@link PutGroupPolicyCommandOutput} for command's `response` shape.
  * @see {@link IAMClientResolvedConfig | config} for IAMClient's `config` shape.
  *
+ * @example To add a policy to a group
+ * ```javascript
+ * // The following command adds a policy named AllPerms to the IAM group named Admins.
+ * const input = {
+ *   "GroupName": "Admins",
+ *   "PolicyDocument": "{\"Version\":\"2012-10-17\",\"Statement\":{\"Effect\":\"Allow\",\"Action\":\"*\",\"Resource\":\"*\"}}",
+ *   "PolicyName": "AllPerms"
+ * };
+ * const command = new PutGroupPolicyCommand(input);
+ * await client.send(command);
+ * // example id: 4bc17418-758f-4d0f-ab0c-4d00265fec2e
+ * ```
+ *
  */
 export declare class PutGroupPolicyCommand extends $Command<PutGroupPolicyCommandInput, PutGroupPolicyCommandOutput, IAMClientResolvedConfig> {
     readonly input: PutGroupPolicyCommandInput;

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

@@ -48,6 +48,19 @@ export interface PutRolePolicyCommandOutput extends __MetadataBearer {
  * @see {@link PutRolePolicyCommandOutput} for command's `response` shape.
  * @see {@link IAMClientResolvedConfig | config} for IAMClient's `config` shape.
  *
+ * @example To attach a permissions policy to an IAM role
+ * ```javascript
+ * // The following command adds a permissions policy to the role named Test-Role.
+ * const input = {
+ *   "PolicyDocument": "{\"Version\":\"2012-10-17\",\"Statement\":{\"Effect\":\"Allow\",\"Action\":\"s3:*\",\"Resource\":\"*\"}}",
+ *   "PolicyName": "S3AccessPolicy",
+ *   "RoleName": "S3Access"
+ * };
+ * const command = new PutRolePolicyCommand(input);
+ * await client.send(command);
+ * // example id: de62fd00-46c7-4601-9e0d-71d5fbb11ecb
+ * ```
+ *
  */
 export declare class PutRolePolicyCommand extends $Command<PutRolePolicyCommandInput, PutRolePolicyCommandOutput, IAMClientResolvedConfig> {
     readonly input: PutRolePolicyCommandInput;

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

@@ -43,6 +43,19 @@ export interface PutUserPolicyCommandOutput extends __MetadataBearer {
  * @see {@link PutUserPolicyCommandOutput} for command's `response` shape.
  * @see {@link IAMClientResolvedConfig | config} for IAMClient's `config` shape.
  *
+ * @example To attach a policy to an IAM user
+ * ```javascript
+ * // The following command attaches a policy to the IAM user named Bob.
+ * const input = {
+ *   "PolicyDocument": "{\"Version\":\"2012-10-17\",\"Statement\":{\"Effect\":\"Allow\",\"Action\":\"*\",\"Resource\":\"*\"}}",
+ *   "PolicyName": "AllAccessPolicy",
+ *   "UserName": "Bob"
+ * };
+ * const command = new PutUserPolicyCommand(input);
+ * await client.send(command);
+ * // example id: 2551ffc6-3576-4d39-823f-30b60bffc2c7
+ * ```
+ *
  */
 export declare class PutUserPolicyCommand extends $Command<PutUserPolicyCommandInput, PutUserPolicyCommandOutput, IAMClientResolvedConfig> {
     readonly input: PutUserPolicyCommandInput;

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

@@ -38,6 +38,18 @@ export interface RemoveRoleFromInstanceProfileCommandOutput extends __MetadataBe
  * @see {@link RemoveRoleFromInstanceProfileCommandOutput} for command's `response` shape.
  * @see {@link IAMClientResolvedConfig | config} for IAMClient's `config` shape.
  *
+ * @example To remove a role from an instance profile
+ * ```javascript
+ * // The following command removes the role named Test-Role from the instance profile named ExampleInstanceProfile.
+ * const input = {
+ *   "InstanceProfileName": "ExampleInstanceProfile",
+ *   "RoleName": "Test-Role"
+ * };
+ * const command = new RemoveRoleFromInstanceProfileCommand(input);
+ * await client.send(command);
+ * // example id: 6d9f46f1-9f4a-4873-b403-51a85c5c627c
+ * ```
+ *
  */
 export declare class RemoveRoleFromInstanceProfileCommand extends $Command<RemoveRoleFromInstanceProfileCommandInput, RemoveRoleFromInstanceProfileCommandOutput, IAMClientResolvedConfig> {
     readonly input: RemoveRoleFromInstanceProfileCommandInput;

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

@@ -29,6 +29,18 @@ export interface RemoveUserFromGroupCommandOutput extends __MetadataBearer {
  * @see {@link RemoveUserFromGroupCommandOutput} for command's `response` shape.
  * @see {@link IAMClientResolvedConfig | config} for IAMClient's `config` shape.
  *
+ * @example To remove a user from an IAM group
+ * ```javascript
+ * // The following command removes the user named Bob from the IAM group named Admins.
+ * const input = {
+ *   "GroupName": "Admins",
+ *   "UserName": "Bob"
+ * };
+ * const command = new RemoveUserFromGroupCommand(input);
+ * await client.send(command);
+ * // example id: fb54d5b4-0caf-41d8-af0e-10a84413f174
+ * ```
+ *
  */
 export declare class RemoveUserFromGroupCommand extends $Command<RemoveUserFromGroupCommandInput, RemoveUserFromGroupCommandOutput, IAMClientResolvedConfig> {
     readonly input: RemoveUserFromGroupCommandInput;

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

@@ -47,6 +47,17 @@ export interface SetSecurityTokenServicePreferencesCommandOutput extends __Metad
  * @see {@link SetSecurityTokenServicePreferencesCommandOutput} 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 sets the STS global endpoint token to version 2. Version 2 tokens are valid in all Regions.
+ * const input = {
+ *   "GlobalEndpointTokenVersion": "v2Token"
+ * };
+ * const command = new SetSecurityTokenServicePreferencesCommand(input);
+ * await client.send(command);
+ * // example id: 61a785a7-d30a-415a-ae18-ab9236e56871
+ * ```
+ *
  */
 export declare class SetSecurityTokenServicePreferencesCommand extends $Command<SetSecurityTokenServicePreferencesCommandInput, SetSecurityTokenServicePreferencesCommandOutput, IAMClientResolvedConfig> {
     readonly input: SetSecurityTokenServicePreferencesCommandInput;

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

@@ -73,6 +73,27 @@ export interface TagRoleCommandOutput extends __MetadataBearer {
  * @see {@link TagRoleCommandOutput} for command's `response` shape.
  * @see {@link IAMClientResolvedConfig | config} for IAMClient's `config` shape.
  *
+ * @example To add a tag key and value to an IAM role
+ * ```javascript
+ * // The following example shows how to add tags to an existing role.
+ * const input = {
+ *   "RoleName": "taggedrole",
+ *   "Tags": [
+ *     {
+ *       "Key": "Dept",
+ *       "Value": "Accounting"
+ *     },
+ *     {
+ *       "Key": "CostCenter",
+ *       "Value": "12345"
+ *     }
+ *   ]
+ * };
+ * const command = new TagRoleCommand(input);
+ * await client.send(command);
+ * // example id: to-add-a-tag-key-and-value-to-an-iam-role-1506718791513
+ * ```
+ *
  */
 export declare class TagRoleCommand extends $Command<TagRoleCommandInput, TagRoleCommandOutput, IAMClientResolvedConfig> {
     readonly input: TagRoleCommandInput;

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

@@ -72,6 +72,27 @@ export interface TagUserCommandOutput extends __MetadataBearer {
  * @see {@link TagUserCommandOutput} for command's `response` shape.
  * @see {@link IAMClientResolvedConfig | config} for IAMClient's `config` shape.
  *
+ * @example To add a tag key and value to an IAM user
+ * ```javascript
+ * // The following example shows how to add tags to an existing user.
+ * const input = {
+ *   "Tags": [
+ *     {
+ *       "Key": "Dept",
+ *       "Value": "Accounting"
+ *     },
+ *     {
+ *       "Key": "CostCenter",
+ *       "Value": "12345"
+ *     }
+ *   ],
+ *   "UserName": "anika"
+ * };
+ * const command = new TagUserCommand(input);
+ * await client.send(command);
+ * // example id: to-add-a-tag-key-and-value-to-an-iam-user-1506719044227
+ * ```
+ *
  */
 export declare class TagUserCommand extends $Command<TagUserCommandInput, TagUserCommandOutput, IAMClientResolvedConfig> {
     readonly input: TagUserCommandInput;

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

@@ -30,6 +30,20 @@ export interface UntagRoleCommandOutput extends __MetadataBearer {
  * @see {@link UntagRoleCommandOutput} for command's `response` shape.
  * @see {@link IAMClientResolvedConfig | config} for IAMClient's `config` shape.
  *
+ * @example To remove a tag from an IAM role
+ * ```javascript
+ * // The following example shows how to remove a tag with the key 'Dept' from a role named 'taggedrole'.
+ * const input = {
+ *   "RoleName": "taggedrole",
+ *   "TagKeys": [
+ *     "Dept"
+ *   ]
+ * };
+ * const command = new UntagRoleCommand(input);
+ * await client.send(command);
+ * // example id: to-remove-a-tag-from-an-iam-role-1506719589943
+ * ```
+ *
  */
 export declare class UntagRoleCommand extends $Command<UntagRoleCommandInput, UntagRoleCommandOutput, IAMClientResolvedConfig> {
     readonly input: UntagRoleCommandInput;

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

@@ -30,6 +30,20 @@ export interface UntagUserCommandOutput extends __MetadataBearer {
  * @see {@link UntagUserCommandOutput} for command's `response` shape.
  * @see {@link IAMClientResolvedConfig | config} for IAMClient's `config` shape.
  *
+ * @example To remove a tag from an IAM user
+ * ```javascript
+ * // The following example shows how to remove tags that are attached to a user named 'anika'.
+ * const input = {
+ *   "TagKeys": [
+ *     "Dept"
+ *   ],
+ *   "UserName": "anika"
+ * };
+ * const command = new UntagUserCommand(input);
+ * await client.send(command);
+ * // example id: to-remove-a-tag-from-an-iam-user-1506719725554
+ * ```
+ *
  */
 export declare class UntagUserCommand extends $Command<UntagUserCommandInput, UntagUserCommandOutput, IAMClientResolvedConfig> {
     readonly input: UntagUserCommandInput;

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

@@ -40,6 +40,19 @@ export interface UpdateAccessKeyCommandOutput extends __MetadataBearer {
  * @see {@link UpdateAccessKeyCommandOutput} for command's `response` shape.
  * @see {@link IAMClientResolvedConfig | config} for IAMClient's `config` shape.
  *
+ * @example To activate or deactivate an access key for an IAM user
+ * ```javascript
+ * // The following command deactivates the specified access key (access key ID and secret access key) for the IAM user named Bob.
+ * const input = {
+ *   "AccessKeyId": "AKIAIOSFODNN7EXAMPLE",
+ *   "Status": "Inactive",
+ *   "UserName": "Bob"
+ * };
+ * const command = new UpdateAccessKeyCommand(input);
+ * await client.send(command);
+ * // example id: 02b556fd-e673-49b7-ab6b-f2f9035967d0
+ * ```
+ *
  */
 export declare class UpdateAccessKeyCommand extends $Command<UpdateAccessKeyCommandInput, UpdateAccessKeyCommandOutput, IAMClientResolvedConfig> {
     readonly input: UpdateAccessKeyCommandInput;

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

@@ -39,6 +39,18 @@ export interface UpdateAccountPasswordPolicyCommandOutput extends __MetadataBear
  * @see {@link UpdateAccountPasswordPolicyCommandOutput} for command's `response` shape.
  * @see {@link IAMClientResolvedConfig | config} for IAMClient's `config` shape.
  *
+ * @example To set or change the current account password policy
+ * ```javascript
+ * // The following command sets the password policy to require a minimum length of eight characters and to require one or more numbers in the password:
+ * const input = {
+ *   "MinimumPasswordLength": 8,
+ *   "RequireNumbers": true
+ * };
+ * const command = new UpdateAccountPasswordPolicyCommand(input);
+ * await client.send(command);
+ * // example id: c263a1af-37dc-4423-8dba-9790284ef5e0
+ * ```
+ *
  */
 export declare class UpdateAccountPasswordPolicyCommand extends $Command<UpdateAccountPasswordPolicyCommandInput, UpdateAccountPasswordPolicyCommandOutput, IAMClientResolvedConfig> {
     readonly input: UpdateAccountPasswordPolicyCommandInput;

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

@@ -32,6 +32,18 @@ export interface UpdateAssumeRolePolicyCommandOutput extends __MetadataBearer {
  * @see {@link UpdateAssumeRolePolicyCommandOutput} for command's `response` shape.
  * @see {@link IAMClientResolvedConfig | config} for IAMClient's `config` shape.
  *
+ * @example To update the trust policy for an IAM role
+ * ```javascript
+ * // The following command updates the role trust policy for the role named Test-Role:
+ * const input = {
+ *   "PolicyDocument": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Principal\":{\"Service\":[\"ec2.amazonaws.com\"]},\"Action\":[\"sts:AssumeRole\"]}]}",
+ *   "RoleName": "S3AccessForEC2Instances"
+ * };
+ * const command = new UpdateAssumeRolePolicyCommand(input);
+ * await client.send(command);
+ * // example id: c9150063-d953-4e99-9576-9685872006c6
+ * ```
+ *
  */
 export declare class UpdateAssumeRolePolicyCommand extends $Command<UpdateAssumeRolePolicyCommandInput, UpdateAssumeRolePolicyCommandOutput, IAMClientResolvedConfig> {
     readonly input: UpdateAssumeRolePolicyCommandInput;

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

@@ -43,6 +43,18 @@ export interface UpdateGroupCommandOutput extends __MetadataBearer {
  * @see {@link UpdateGroupCommandOutput} for command's `response` shape.
  * @see {@link IAMClientResolvedConfig | config} for IAMClient's `config` shape.
  *
+ * @example To rename an IAM group
+ * ```javascript
+ * // The following command changes the name of the IAM group Test to Test-1.
+ * const input = {
+ *   "GroupName": "Test",
+ *   "NewGroupName": "Test-1"
+ * };
+ * const command = new UpdateGroupCommand(input);
+ * await client.send(command);
+ * // example id: f0cf1662-91ae-4278-a80e-7db54256ccba
+ * ```
+ *
  */
 export declare class UpdateGroupCommand extends $Command<UpdateGroupCommandInput, UpdateGroupCommandOutput, IAMClientResolvedConfig> {
     readonly input: UpdateGroupCommandInput;

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

@@ -35,6 +35,18 @@ export interface UpdateLoginProfileCommandOutput extends __MetadataBearer {
  * @see {@link UpdateLoginProfileCommandOutput} for command's `response` shape.
  * @see {@link IAMClientResolvedConfig | config} for IAMClient's `config` shape.
  *
+ * @example To change the password for an IAM user
+ * ```javascript
+ * // The following command creates or changes the password for the IAM user named Bob.
+ * const input = {
+ *   "Password": "SomeKindOfPassword123!@#",
+ *   "UserName": "Bob"
+ * };
+ * const command = new UpdateLoginProfileCommand(input);
+ * await client.send(command);
+ * // example id: 036d9498-ecdb-4ed6-a8d8-366c383d1487
+ * ```
+ *
  */
 export declare class UpdateLoginProfileCommand extends $Command<UpdateLoginProfileCommandInput, UpdateLoginProfileCommandOutput, IAMClientResolvedConfig> {
     readonly input: UpdateLoginProfileCommandInput;

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

@@ -36,6 +36,19 @@ export interface UpdateSigningCertificateCommandOutput extends __MetadataBearer
  * @see {@link UpdateSigningCertificateCommandOutput} for command's `response` shape.
  * @see {@link IAMClientResolvedConfig | config} for IAMClient's `config` shape.
  *
+ * @example To change the active status of a signing certificate for an IAM user
+ * ```javascript
+ * // The following command changes the status of a signing certificate for a user named Bob to Inactive.
+ * const input = {
+ *   "CertificateId": "TA7SMP42TDN5Z26OBPJE7EXAMPLE",
+ *   "Status": "Inactive",
+ *   "UserName": "Bob"
+ * };
+ * const command = new UpdateSigningCertificateCommand(input);
+ * await client.send(command);
+ * // example id: 829aee7b-efc5-4b3b-84a5-7f899b38018d
+ * ```
+ *
  */
 export declare class UpdateSigningCertificateCommand extends $Command<UpdateSigningCertificateCommandInput, UpdateSigningCertificateCommandOutput, IAMClientResolvedConfig> {
     readonly input: UpdateSigningCertificateCommandInput;

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

@@ -41,6 +41,18 @@ export interface UpdateUserCommandOutput extends __MetadataBearer {
  * @see {@link UpdateUserCommandOutput} for command's `response` shape.
  * @see {@link IAMClientResolvedConfig | config} for IAMClient's `config` shape.
  *
+ * @example To change an IAM user's name
+ * ```javascript
+ * // The following command changes the name of the IAM user Bob to Robert. It does not change the user's path.
+ * const input = {
+ *   "NewUserName": "Robert",
+ *   "UserName": "Bob"
+ * };
+ * const command = new UpdateUserCommand(input);
+ * await client.send(command);
+ * // example id: 275d53ed-347a-44e6-b7d0-a96276154352
+ * ```
+ *
  */
 export declare class UpdateUserCommand extends $Command<UpdateUserCommandInput, UpdateUserCommandOutput, IAMClientResolvedConfig> {
     readonly input: UpdateUserCommandInput;

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

@@ -52,6 +52,32 @@ export interface UploadServerCertificateCommandOutput extends UploadServerCertif
  * @see {@link UploadServerCertificateCommandOutput} for command's `response` shape.
  * @see {@link IAMClientResolvedConfig | config} for IAMClient's `config` shape.
  *
+ * @example To upload a server certificate to your AWS account
+ * ```javascript
+ * // The following upload-server-certificate command uploads a server certificate to your AWS account:
+ * const input = {
+ *   "CertificateBody": "-----BEGIN CERTIFICATE-----<a very long certificate text string>-----END CERTIFICATE-----",
+ *   "Path": "/company/servercerts/",
+ *   "PrivateKey": "-----BEGIN DSA PRIVATE KEY-----<a very long private key string>-----END DSA PRIVATE KEY-----",
+ *   "ServerCertificateName": "ProdServerCert"
+ * };
+ * const command = new UploadServerCertificateCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "ServerCertificateMetadata": {
+ *     "Arn": "arn:aws:iam::123456789012:server-certificate/company/servercerts/ProdServerCert",
+ *     "Expiration": "2012-05-08T01:02:03.004Z",
+ *     "Path": "/company/servercerts/",
+ *     "ServerCertificateId": "ASCA1111111111EXAMPLE",
+ *     "ServerCertificateName": "ProdServerCert",
+ *     "UploadDate": "2010-05-08T01:02:03.004Z"
+ *   }
+ * }
+ * *\/
+ * // example id: 06eab6d1-ebf2-4bd9-839d-f7508b9a38b6
+ * ```
+ *
  */
 export declare class UploadServerCertificateCommand extends $Command<UploadServerCertificateCommandInput, UploadServerCertificateCommandOutput, IAMClientResolvedConfig> {
     readonly input: UploadServerCertificateCommandInput;

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

@@ -48,6 +48,29 @@ export interface UploadSigningCertificateCommandOutput extends UploadSigningCert
  * @see {@link UploadSigningCertificateCommandOutput} for command's `response` shape.
  * @see {@link IAMClientResolvedConfig | config} for IAMClient's `config` shape.
  *
+ * @example To upload a signing certificate for an IAM user
+ * ```javascript
+ * // The following command uploads a signing certificate for the IAM user named Bob.
+ * const input = {
+ *   "CertificateBody": "-----BEGIN CERTIFICATE-----<certificate-body>-----END CERTIFICATE-----",
+ *   "UserName": "Bob"
+ * };
+ * const command = new UploadSigningCertificateCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "Certificate": {
+ *     "CertificateBody": "-----BEGIN CERTIFICATE-----<certificate-body>-----END CERTIFICATE-----",
+ *     "CertificateId": "ID123456789012345EXAMPLE",
+ *     "Status": "Active",
+ *     "UploadDate": "2015-06-06T21:40:08.121Z",
+ *     "UserName": "Bob"
+ *   }
+ * }
+ * *\/
+ * // example id: e67489b6-7b73-4e30-9ed3-9a9e0231e458
+ * ```
+ *
  */
 export declare class UploadSigningCertificateCommand extends $Command<UploadSigningCertificateCommandInput, UploadSigningCertificateCommandOutput, IAMClientResolvedConfig> {
     readonly input: UploadSigningCertificateCommandInput;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@aws-sdk/client-iam",
   "description": "AWS SDK for JavaScript Iam Client for Node.js, Browser and React Native",
-  "version": "3.287.0",
+  "version": "3.289.0",
   "scripts": {
     "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
     "build:cjs": "tsc -p tsconfig.cjs.json",
@@ -20,39 +20,39 @@
   "dependencies": {
     "@aws-crypto/sha256-browser": "3.0.0",
     "@aws-crypto/sha256-js": "3.0.0",
-    "@aws-sdk/client-sts": "3.287.0",
-    "@aws-sdk/config-resolver": "3.287.0",
-    "@aws-sdk/credential-provider-node": "3.287.0",
-    "@aws-sdk/fetch-http-handler": "3.282.0",
-    "@aws-sdk/hash-node": "3.272.0",
-    "@aws-sdk/invalid-dependency": "3.272.0",
-    "@aws-sdk/middleware-content-length": "3.282.0",
-    "@aws-sdk/middleware-endpoint": "3.282.0",
-    "@aws-sdk/middleware-host-header": "3.282.0",
-    "@aws-sdk/middleware-logger": "3.287.0",
-    "@aws-sdk/middleware-recursion-detection": "3.282.0",
-    "@aws-sdk/middleware-retry": "3.287.0",
-    "@aws-sdk/middleware-serde": "3.272.0",
-    "@aws-sdk/middleware-signing": "3.282.0",
-    "@aws-sdk/middleware-stack": "3.272.0",
-    "@aws-sdk/middleware-user-agent": "3.282.0",
-    "@aws-sdk/node-config-provider": "3.287.0",
-    "@aws-sdk/node-http-handler": "3.282.0",
-    "@aws-sdk/protocol-http": "3.282.0",
-    "@aws-sdk/smithy-client": "3.279.0",
-    "@aws-sdk/types": "3.272.0",
-    "@aws-sdk/url-parser": "3.272.0",
+    "@aws-sdk/client-sts": "3.289.0",
+    "@aws-sdk/config-resolver": "3.289.0",
+    "@aws-sdk/credential-provider-node": "3.289.0",
+    "@aws-sdk/fetch-http-handler": "3.289.0",
+    "@aws-sdk/hash-node": "3.289.0",
+    "@aws-sdk/invalid-dependency": "3.289.0",
+    "@aws-sdk/middleware-content-length": "3.289.0",
+    "@aws-sdk/middleware-endpoint": "3.289.0",
+    "@aws-sdk/middleware-host-header": "3.289.0",
+    "@aws-sdk/middleware-logger": "3.289.0",
+    "@aws-sdk/middleware-recursion-detection": "3.289.0",
+    "@aws-sdk/middleware-retry": "3.289.0",
+    "@aws-sdk/middleware-serde": "3.289.0",
+    "@aws-sdk/middleware-signing": "3.289.0",
+    "@aws-sdk/middleware-stack": "3.289.0",
+    "@aws-sdk/middleware-user-agent": "3.289.0",
+    "@aws-sdk/node-config-provider": "3.289.0",
+    "@aws-sdk/node-http-handler": "3.289.0",
+    "@aws-sdk/protocol-http": "3.289.0",
+    "@aws-sdk/smithy-client": "3.289.0",
+    "@aws-sdk/types": "3.289.0",
+    "@aws-sdk/url-parser": "3.289.0",
     "@aws-sdk/util-base64": "3.208.0",
     "@aws-sdk/util-body-length-browser": "3.188.0",
     "@aws-sdk/util-body-length-node": "3.208.0",
-    "@aws-sdk/util-defaults-mode-browser": "3.279.0",
-    "@aws-sdk/util-defaults-mode-node": "3.287.0",
-    "@aws-sdk/util-endpoints": "3.272.0",
-    "@aws-sdk/util-retry": "3.272.0",
-    "@aws-sdk/util-user-agent-browser": "3.282.0",
-    "@aws-sdk/util-user-agent-node": "3.287.0",
+    "@aws-sdk/util-defaults-mode-browser": "3.289.0",
+    "@aws-sdk/util-defaults-mode-node": "3.289.0",
+    "@aws-sdk/util-endpoints": "3.289.0",
+    "@aws-sdk/util-retry": "3.289.0",
+    "@aws-sdk/util-user-agent-browser": "3.289.0",
+    "@aws-sdk/util-user-agent-node": "3.289.0",
     "@aws-sdk/util-utf8": "3.254.0",
-    "@aws-sdk/util-waiter": "3.272.0",
+    "@aws-sdk/util-waiter": "3.289.0",
     "fast-xml-parser": "4.1.2",
     "tslib": "^2.3.1"
   },