@aws-sdk/client-iam 3.288.0 → 3.290.0

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

@@ -32,6 +32,23 @@ export interface UpdateSAMLProviderCommandOutput extends UpdateSAMLProviderRespo
  * @see {@link UpdateSAMLProviderCommandOutput} for command's `response` shape.
  * @see {@link IAMClientResolvedConfig | config} for IAMClient's `config` shape.
  *
+ * @throws {@link InvalidInputException} (client fault)
+ *  <p>The request was rejected because an invalid or out-of-range value was supplied for an
+ *       input parameter.</p>
+ *
+ * @throws {@link LimitExceededException} (client fault)
+ *  <p>The request was rejected because it attempted to create resources beyond the current Amazon Web Services
+ *       account limits. The error message describes the limit exceeded.</p>
+ *
+ * @throws {@link NoSuchEntityException} (client fault)
+ *  <p>The request was rejected because it referenced a resource entity that does not exist. The
+ *       error message describes the resource.</p>
+ *
+ * @throws {@link ServiceFailureException} (server fault)
+ *  <p>The request processing has failed because of an unknown error, exception or
+ *       failure.</p>
+ *
+ *
  */
 export declare class UpdateSAMLProviderCommand extends $Command<UpdateSAMLProviderCommandInput, UpdateSAMLProviderCommandOutput, IAMClientResolvedConfig> {
     readonly input: UpdateSAMLProviderCommandInput;

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

@@ -35,6 +35,11 @@ export interface UpdateSSHPublicKeyCommandOutput extends __MetadataBearer {
  * @see {@link UpdateSSHPublicKeyCommandOutput} for command's `response` shape.
  * @see {@link IAMClientResolvedConfig | config} for IAMClient's `config` shape.
  *
+ * @throws {@link NoSuchEntityException} (client fault)
+ *  <p>The request was rejected because it referenced a resource entity that does not exist. The
+ *       error message describes the resource.</p>
+ *
+ *
  */
 export declare class UpdateSSHPublicKeyCommand extends $Command<UpdateSSHPublicKeyCommandInput, UpdateSSHPublicKeyCommandOutput, IAMClientResolvedConfig> {
     readonly input: UpdateSSHPublicKeyCommandInput;

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

@@ -48,6 +48,23 @@ export interface UpdateServerCertificateCommandOutput extends __MetadataBearer {
  * @see {@link UpdateServerCertificateCommandOutput} for command's `response` shape.
  * @see {@link IAMClientResolvedConfig | config} for IAMClient's `config` shape.
  *
+ * @throws {@link EntityAlreadyExistsException} (client fault)
+ *  <p>The request was rejected because it attempted to create a resource that already
+ *       exists.</p>
+ *
+ * @throws {@link LimitExceededException} (client fault)
+ *  <p>The request was rejected because it attempted to create resources beyond the current Amazon Web Services
+ *       account limits. The error message describes the limit exceeded.</p>
+ *
+ * @throws {@link NoSuchEntityException} (client fault)
+ *  <p>The request was rejected because it referenced a resource entity that does not exist. The
+ *       error message describes the resource.</p>
+ *
+ * @throws {@link ServiceFailureException} (server fault)
+ *  <p>The request processing has failed because of an unknown error, exception or
+ *       failure.</p>
+ *
+ *
  */
 export declare class UpdateServerCertificateCommand extends $Command<UpdateServerCertificateCommandInput, UpdateServerCertificateCommandOutput, IAMClientResolvedConfig> {
     readonly input: UpdateServerCertificateCommandInput;

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

@@ -32,6 +32,11 @@ export interface UpdateServiceSpecificCredentialCommandOutput extends __Metadata
  * @see {@link UpdateServiceSpecificCredentialCommandOutput} for command's `response` shape.
  * @see {@link IAMClientResolvedConfig | config} for IAMClient's `config` shape.
  *
+ * @throws {@link NoSuchEntityException} (client fault)
+ *  <p>The request was rejected because it referenced a resource entity that does not exist. The
+ *       error message describes the resource.</p>
+ *
+ *
  */
 export declare class UpdateServiceSpecificCredentialCommand extends $Command<UpdateServiceSpecificCredentialCommandInput, UpdateServiceSpecificCredentialCommandOutput, IAMClientResolvedConfig> {
     readonly input: UpdateServiceSpecificCredentialCommandInput;

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

@@ -36,6 +36,32 @@ export interface UpdateSigningCertificateCommandOutput extends __MetadataBearer
  * @see {@link UpdateSigningCertificateCommandOutput} for command's `response` shape.
  * @see {@link IAMClientResolvedConfig | config} for IAMClient's `config` shape.
  *
+ * @throws {@link LimitExceededException} (client fault)
+ *  <p>The request was rejected because it attempted to create resources beyond the current Amazon Web Services
+ *       account limits. The error message describes the limit exceeded.</p>
+ *
+ * @throws {@link NoSuchEntityException} (client fault)
+ *  <p>The request was rejected because it referenced a resource entity that does not exist. The
+ *       error message describes the resource.</p>
+ *
+ * @throws {@link ServiceFailureException} (server fault)
+ *  <p>The request processing has failed because of an unknown error, exception or
+ *       failure.</p>
+ *
+ *
+ * @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,45 @@ export interface UpdateUserCommandOutput extends __MetadataBearer {
  * @see {@link UpdateUserCommandOutput} for command's `response` shape.
  * @see {@link IAMClientResolvedConfig | config} for IAMClient's `config` shape.
  *
+ * @throws {@link ConcurrentModificationException} (client fault)
+ *  <p>The request was rejected because multiple requests to change this object were submitted
+ *       simultaneously. Wait a few minutes and submit your request again.</p>
+ *
+ * @throws {@link EntityAlreadyExistsException} (client fault)
+ *  <p>The request was rejected because it attempted to create a resource that already
+ *       exists.</p>
+ *
+ * @throws {@link EntityTemporarilyUnmodifiableException} (client fault)
+ *  <p>The request was rejected because it referenced an entity that is temporarily unmodifiable,
+ *       such as a user name that was deleted and then recreated. The error indicates that the request
+ *       is likely to succeed if you try again after waiting several minutes. The error message
+ *       describes the entity.</p>
+ *
+ * @throws {@link LimitExceededException} (client fault)
+ *  <p>The request was rejected because it attempted to create resources beyond the current Amazon Web Services
+ *       account limits. The error message describes the limit exceeded.</p>
+ *
+ * @throws {@link NoSuchEntityException} (client fault)
+ *  <p>The request was rejected because it referenced a resource entity that does not exist. The
+ *       error message describes the resource.</p>
+ *
+ * @throws {@link ServiceFailureException} (server fault)
+ *  <p>The request processing has failed because of an unknown error, exception or
+ *       failure.</p>
+ *
+ *
+ * @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/UploadSSHPublicKeyCommand.d.ts

@@ -33,6 +33,26 @@ export interface UploadSSHPublicKeyCommandOutput extends UploadSSHPublicKeyRespo
  * @see {@link UploadSSHPublicKeyCommandOutput} for command's `response` shape.
  * @see {@link IAMClientResolvedConfig | config} for IAMClient's `config` shape.
  *
+ * @throws {@link DuplicateSSHPublicKeyException} (client fault)
+ *  <p>The request was rejected because the SSH public key is already associated with the
+ *       specified IAM user.</p>
+ *
+ * @throws {@link InvalidPublicKeyException} (client fault)
+ *  <p>The request was rejected because the public key is malformed or otherwise invalid.</p>
+ *
+ * @throws {@link LimitExceededException} (client fault)
+ *  <p>The request was rejected because it attempted to create resources beyond the current Amazon Web Services
+ *       account limits. The error message describes the limit exceeded.</p>
+ *
+ * @throws {@link NoSuchEntityException} (client fault)
+ *  <p>The request was rejected because it referenced a resource entity that does not exist. The
+ *       error message describes the resource.</p>
+ *
+ * @throws {@link UnrecognizedPublicKeyEncodingException} (client fault)
+ *  <p>The request was rejected because the public key encoding format is unsupported or
+ *       unrecognized.</p>
+ *
+ *
  */
 export declare class UploadSSHPublicKeyCommand extends $Command<UploadSSHPublicKeyCommandInput, UploadSSHPublicKeyCommandOutput, IAMClientResolvedConfig> {
     readonly input: UploadSSHPublicKeyCommandInput;

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

@@ -52,6 +52,61 @@ export interface UploadServerCertificateCommandOutput extends UploadServerCertif
  * @see {@link UploadServerCertificateCommandOutput} for command's `response` shape.
  * @see {@link IAMClientResolvedConfig | config} for IAMClient's `config` shape.
  *
+ * @throws {@link ConcurrentModificationException} (client fault)
+ *  <p>The request was rejected because multiple requests to change this object were submitted
+ *       simultaneously. Wait a few minutes and submit your request again.</p>
+ *
+ * @throws {@link EntityAlreadyExistsException} (client fault)
+ *  <p>The request was rejected because it attempted to create a resource that already
+ *       exists.</p>
+ *
+ * @throws {@link InvalidInputException} (client fault)
+ *  <p>The request was rejected because an invalid or out-of-range value was supplied for an
+ *       input parameter.</p>
+ *
+ * @throws {@link KeyPairMismatchException} (client fault)
+ *  <p>The request was rejected because the public key certificate and the private key do not
+ *       match.</p>
+ *
+ * @throws {@link LimitExceededException} (client fault)
+ *  <p>The request was rejected because it attempted to create resources beyond the current Amazon Web Services
+ *       account limits. The error message describes the limit exceeded.</p>
+ *
+ * @throws {@link MalformedCertificateException} (client fault)
+ *  <p>The request was rejected because the certificate was malformed or expired. The error
+ *       message describes the specific error.</p>
+ *
+ * @throws {@link ServiceFailureException} (server fault)
+ *  <p>The request processing has failed because of an unknown error, exception or
+ *       failure.</p>
+ *
+ *
+ * @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,57 @@ export interface UploadSigningCertificateCommandOutput extends UploadSigningCert
  * @see {@link UploadSigningCertificateCommandOutput} for command's `response` shape.
  * @see {@link IAMClientResolvedConfig | config} for IAMClient's `config` shape.
  *
+ * @throws {@link DuplicateCertificateException} (client fault)
+ *  <p>The request was rejected because the same certificate is associated with an IAM user in
+ *       the account.</p>
+ *
+ * @throws {@link EntityAlreadyExistsException} (client fault)
+ *  <p>The request was rejected because it attempted to create a resource that already
+ *       exists.</p>
+ *
+ * @throws {@link InvalidCertificateException} (client fault)
+ *  <p>The request was rejected because the certificate is invalid.</p>
+ *
+ * @throws {@link LimitExceededException} (client fault)
+ *  <p>The request was rejected because it attempted to create resources beyond the current Amazon Web Services
+ *       account limits. The error message describes the limit exceeded.</p>
+ *
+ * @throws {@link MalformedCertificateException} (client fault)
+ *  <p>The request was rejected because the certificate was malformed or expired. The error
+ *       message describes the specific error.</p>
+ *
+ * @throws {@link NoSuchEntityException} (client fault)
+ *  <p>The request was rejected because it referenced a resource entity that does not exist. The
+ *       error message describes the resource.</p>
+ *
+ * @throws {@link ServiceFailureException} (server fault)
+ *  <p>The request processing has failed because of an unknown error, exception or
+ *       failure.</p>
+ *
+ *
+ * @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.288.0",
+  "version": "3.290.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.288.0",
-    "@aws-sdk/config-resolver": "3.287.0",
-    "@aws-sdk/credential-provider-node": "3.288.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.288.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.290.0",
+    "@aws-sdk/config-resolver": "3.290.0",
+    "@aws-sdk/credential-provider-node": "3.290.0",
+    "@aws-sdk/fetch-http-handler": "3.290.0",
+    "@aws-sdk/hash-node": "3.290.0",
+    "@aws-sdk/invalid-dependency": "3.290.0",
+    "@aws-sdk/middleware-content-length": "3.290.0",
+    "@aws-sdk/middleware-endpoint": "3.290.0",
+    "@aws-sdk/middleware-host-header": "3.290.0",
+    "@aws-sdk/middleware-logger": "3.290.0",
+    "@aws-sdk/middleware-recursion-detection": "3.290.0",
+    "@aws-sdk/middleware-retry": "3.290.0",
+    "@aws-sdk/middleware-serde": "3.290.0",
+    "@aws-sdk/middleware-signing": "3.290.0",
+    "@aws-sdk/middleware-stack": "3.290.0",
+    "@aws-sdk/middleware-user-agent": "3.290.0",
+    "@aws-sdk/node-config-provider": "3.290.0",
+    "@aws-sdk/node-http-handler": "3.290.0",
+    "@aws-sdk/protocol-http": "3.290.0",
+    "@aws-sdk/smithy-client": "3.290.0",
+    "@aws-sdk/types": "3.290.0",
+    "@aws-sdk/url-parser": "3.290.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.290.0",
+    "@aws-sdk/util-defaults-mode-node": "3.290.0",
+    "@aws-sdk/util-endpoints": "3.290.0",
+    "@aws-sdk/util-retry": "3.290.0",
+    "@aws-sdk/util-user-agent-browser": "3.290.0",
+    "@aws-sdk/util-user-agent-node": "3.290.0",
     "@aws-sdk/util-utf8": "3.254.0",
-    "@aws-sdk/util-waiter": "3.272.0",
+    "@aws-sdk/util-waiter": "3.290.0",
     "fast-xml-parser": "4.1.2",
     "tslib": "^2.3.1"
   },