feat(client-elasticache): AWS ElastiCache SDK now supports using MemcachedUpgradeConfig parameter with ModifyCacheCluster API to enable updating Memcached cache node types. Please refer to updated AWS ElastiCache public documentation for detailed information on API usage and implementation.

awstools · awstools · commit 7be36747d443 · 2025-04-10T18:18:03.000Z
diff --git a/clients/client-elasticache/src/commands/CreateCacheClusterCommand.ts b/clients/client-elasticache/src/commands/CreateCacheClusterCommand.ts
@@ -143,6 +143,10 @@ export interface CreateCacheClusterCommandOutput extends CreateCacheClusterResul
  * //       ],
  * //       TransitEncryptionEnabled: true || false,
  * //       TransitEncryptionMode: "preferred" || "required",
+ * //       ScaleConfig: { // ScaleConfig
+ * //         ScalePercentage: Number("int"),
+ * //         ScaleIntervalMinutes: Number("int"),
+ * //       },
  * //     },
  * //     NotificationConfiguration: { // NotificationConfiguration
  * //       TopicArn: "STRING_VALUE",
diff --git a/clients/client-elasticache/src/commands/DeleteCacheClusterCommand.ts b/clients/client-elasticache/src/commands/DeleteCacheClusterCommand.ts
@@ -110,6 +110,10 @@ export interface DeleteCacheClusterCommandOutput extends DeleteCacheClusterResul
  * //       ],
  * //       TransitEncryptionEnabled: true || false,
  * //       TransitEncryptionMode: "preferred" || "required",
+ * //       ScaleConfig: { // ScaleConfig
+ * //         ScalePercentage: Number("int"),
+ * //         ScaleIntervalMinutes: Number("int"),
+ * //       },
  * //     },
  * //     NotificationConfiguration: { // NotificationConfiguration
  * //       TopicArn: "STRING_VALUE",
diff --git a/clients/client-elasticache/src/commands/DescribeCacheClustersCommand.ts b/clients/client-elasticache/src/commands/DescribeCacheClustersCommand.ts
@@ -103,6 +103,10 @@ export interface DescribeCacheClustersCommandOutput extends CacheClusterMessage,
  * //         ],
  * //         TransitEncryptionEnabled: true || false,
  * //         TransitEncryptionMode: "preferred" || "required",
+ * //         ScaleConfig: { // ScaleConfig
+ * //           ScalePercentage: Number("int"),
+ * //           ScaleIntervalMinutes: Number("int"),
+ * //         },
  * //       },
  * //       NotificationConfiguration: { // NotificationConfiguration
  * //         TopicArn: "STRING_VALUE",
diff --git a/clients/client-elasticache/src/commands/ModifyCacheClusterCommand.ts b/clients/client-elasticache/src/commands/ModifyCacheClusterCommand.ts
@@ -82,6 +82,10 @@ export interface ModifyCacheClusterCommandOutput extends ModifyCacheClusterResul
  *     },
  *   ],
  *   IpDiscovery: "ipv4" || "ipv6",
+ *   ScaleConfig: { // ScaleConfig
+ *     ScalePercentage: Number("int"),
+ *     ScaleIntervalMinutes: Number("int"),
+ *   },
  * };
  * const command = new ModifyCacheClusterCommand(input);
  * const response = await client.send(command);
@@ -127,6 +131,10 @@ export interface ModifyCacheClusterCommandOutput extends ModifyCacheClusterResul
  * //       ],
  * //       TransitEncryptionEnabled: true || false,
  * //       TransitEncryptionMode: "preferred" || "required",
+ * //       ScaleConfig: { // ScaleConfig
+ * //         ScalePercentage: Number("int"),
+ * //         ScaleIntervalMinutes: Number("int"),
+ * //       },
  * //     },
  * //     NotificationConfiguration: { // NotificationConfiguration
  * //       TopicArn: "STRING_VALUE",
diff --git a/clients/client-elasticache/src/commands/RebootCacheClusterCommand.ts b/clients/client-elasticache/src/commands/RebootCacheClusterCommand.ts
@@ -96,6 +96,10 @@ export interface RebootCacheClusterCommandOutput extends RebootCacheClusterResul
  * //       ],
  * //       TransitEncryptionEnabled: true || false,
  * //       TransitEncryptionMode: "preferred" || "required",
+ * //       ScaleConfig: { // ScaleConfig
+ * //         ScalePercentage: Number("int"),
+ * //         ScaleIntervalMinutes: Number("int"),
+ * //       },
  * //     },
  * //     NotificationConfiguration: { // NotificationConfiguration
  * //       TopicArn: "STRING_VALUE",
diff --git a/clients/client-elasticache/src/commands/RevokeCacheSecurityGroupIngressCommand.ts b/clients/client-elasticache/src/commands/RevokeCacheSecurityGroupIngressCommand.ts
@@ -6,7 +6,8 @@ import { MetadataBearer as __MetadataBearer } from "@smithy/types";
 
 import { ElastiCacheClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../ElastiCacheClient";
 import { commonParams } from "../endpoint/EndpointParameters";
-import { RevokeCacheSecurityGroupIngressMessage, RevokeCacheSecurityGroupIngressResult } from "../models/models_0";
+import { RevokeCacheSecurityGroupIngressMessage } from "../models/models_0";
+import { RevokeCacheSecurityGroupIngressResult } from "../models/models_1";
 import {
   de_RevokeCacheSecurityGroupIngressCommand,
   se_RevokeCacheSecurityGroupIngressCommand,
diff --git a/clients/client-elasticache/src/models/models_0.ts b/clients/client-elasticache/src/models/models_0.ts
@@ -3458,6 +3458,24 @@ export interface NotificationConfiguration {
   TopicStatus?: string | undefined;
 }
 
+/**
+ * <p>Configuration settings for horizontal or vertical scaling operations on Memcached clusters.</p>
+ * @public
+ */
+export interface ScaleConfig {
+  /**
+   * <p>The percentage by which to scale the Memcached cluster, either horizontally by adding nodes or vertically by increasing resources.</p>
+   * @public
+   */
+  ScalePercentage?: number | undefined;
+
+  /**
+   * <p>The time interval in seconds between scaling operations when performing gradual scaling for a Memcached cluster.</p>
+   * @public
+   */
+  ScaleIntervalMinutes?: number | undefined;
+}
+
 /**
  * <p>A group of settings that are applied to the cluster in the future, or that are
  *             currently being applied.</p>
@@ -3515,6 +3533,12 @@ export interface PendingModifiedValues {
    * @public
    */
   TransitEncryptionMode?: TransitEncryptionMode | undefined;
+
+  /**
+   * <p>The scaling configuration changes that are pending for the Memcached cluster.</p>
+   * @public
+   */
+  ScaleConfig?: ScaleConfig | undefined;
 }
 
 /**
@@ -10653,7 +10677,7 @@ export interface ModifyCacheClusterMessage {
   ApplyImmediately?: boolean | undefined;
 
   /**
-   * <p>Modifies the engine listed in a cluster message. The options are redis, memcached or valkey.</p>
+   * <p>The engine type used by the cache cluster. The options are valkey, memcached or redis.</p>
    * @public
    */
   Engine?: string | undefined;
@@ -10757,6 +10781,12 @@ export interface ModifyCacheClusterMessage {
    * @public
    */
   IpDiscovery?: IpDiscovery | undefined;
+
+  /**
+   * <p>Configures horizontal or vertical scaling for Memcached clusters, specifying the scaling percentage and interval.</p>
+   * @public
+   */
+  ScaleConfig?: ScaleConfig | undefined;
 }
 
 /**
@@ -11844,31 +11874,3 @@ export interface RevokeCacheSecurityGroupIngressMessage {
    */
   EC2SecurityGroupOwnerId: string | undefined;
 }
-
-/**
- * @public
- */
-export interface RevokeCacheSecurityGroupIngressResult {
-  /**
-   * <p>Represents the output of one of the following operations:</p>
-   *          <ul>
-   *             <li>
-   *                <p>
-   *                   <code>AuthorizeCacheSecurityGroupIngress</code>
-   *                </p>
-   *             </li>
-   *             <li>
-   *                <p>
-   *                   <code>CreateCacheSecurityGroup</code>
-   *                </p>
-   *             </li>
-   *             <li>
-   *                <p>
-   *                   <code>RevokeCacheSecurityGroupIngress</code>
-   *                </p>
-   *             </li>
-   *          </ul>
-   * @public
-   */
-  CacheSecurityGroup?: CacheSecurityGroup | undefined;
-}
diff --git a/clients/client-elasticache/src/models/models_1.ts b/clients/client-elasticache/src/models/models_1.ts
@@ -3,7 +3,35 @@ import { ExceptionOptionType as __ExceptionOptionType } from "@smithy/smithy-cli
 
 import { ElastiCacheServiceException as __BaseException } from "./ElastiCacheServiceException";
 
-import { ReplicationGroup } from "./models_0";
+import { CacheSecurityGroup, ReplicationGroup } from "./models_0";
+
+/**
+ * @public
+ */
+export interface RevokeCacheSecurityGroupIngressResult {
+  /**
+   * <p>Represents the output of one of the following operations:</p>
+   *          <ul>
+   *             <li>
+   *                <p>
+   *                   <code>AuthorizeCacheSecurityGroupIngress</code>
+   *                </p>
+   *             </li>
+   *             <li>
+   *                <p>
+   *                   <code>CreateCacheSecurityGroup</code>
+   *                </p>
+   *             </li>
+   *             <li>
+   *                <p>
+   *                   <code>RevokeCacheSecurityGroupIngress</code>
+   *                </p>
+   *             </li>
+   *          </ul>
+   * @public
+   */
+  CacheSecurityGroup?: CacheSecurityGroup | undefined;
+}
 
 /**
  * <p>The targeted replication group is not available. </p>
diff --git a/clients/client-elasticache/src/protocols/Aws_query.ts b/clients/client-elasticache/src/protocols/Aws_query.ts
@@ -487,7 +487,7 @@ import {
   ReshardingConfiguration,
   ReshardingStatus,
   RevokeCacheSecurityGroupIngressMessage,
-  RevokeCacheSecurityGroupIngressResult,
+  ScaleConfig,
   SecurityGroupMembership,
   ServerlessCache,
   ServerlessCacheAlreadyExistsFault,
@@ -539,6 +539,7 @@ import {
   CustomerNodeEndpoint,
   NodeGroupNotFoundFault,
   ReplicationGroupAlreadyUnderMigrationFault,
+  RevokeCacheSecurityGroupIngressResult,
   StartMigrationMessage,
   StartMigrationResponse,
   TestFailoverMessage,
@@ -6956,6 +6957,13 @@ const se_ModifyCacheClusterMessage = (input: ModifyCacheClusterMessage, context:
   if (input[_ID] != null) {
     entries[_ID] = input[_ID];
   }
+  if (input[_SC] != null) {
+    const memberEntries = se_ScaleConfig(input[_SC], context);
+    Object.entries(memberEntries).forEach(([key, value]) => {
+      const loc = `ScaleConfig.${key}`;
+      entries[loc] = value;
+    });
+  }
   return entries;
 };
 
@@ -7803,6 +7811,20 @@ const se_RevokeCacheSecurityGroupIngressMessage = (
   return entries;
 };
 
+/**
+ * serializeAws_queryScaleConfig
+ */
+const se_ScaleConfig = (input: ScaleConfig, context: __SerdeContext): any => {
+  const entries: any = {};
+  if (input[_SP] != null) {
+    entries[_SP] = input[_SP];
+  }
+  if (input[_SIM] != null) {
+    entries[_SIM] = input[_SIM];
+  }
+  return entries;
+};
+
 /**
  * serializeAws_querySecurityGroupIdsList
  */
@@ -9084,8 +9106,8 @@ const de_CreateReplicationGroupResult = (output: any, context: __SerdeContext):
  */
 const de_CreateServerlessCacheResponse = (output: any, context: __SerdeContext): CreateServerlessCacheResponse => {
   const contents: any = {};
-  if (output[_SC] != null) {
-    contents[_SC] = de_ServerlessCache(output[_SC], context);
+  if (output[_SCe] != null) {
+    contents[_SCe] = de_ServerlessCache(output[_SCe], context);
   }
   return contents;
 };
@@ -9223,8 +9245,8 @@ const de_DeleteReplicationGroupResult = (output: any, context: __SerdeContext):
  */
 const de_DeleteServerlessCacheResponse = (output: any, context: __SerdeContext): DeleteServerlessCacheResponse => {
   const contents: any = {};
-  if (output[_SC] != null) {
-    contents[_SC] = de_ServerlessCache(output[_SC], context);
+  if (output[_SCe] != null) {
+    contents[_SCe] = de_ServerlessCache(output[_SCe], context);
   }
   return contents;
 };
@@ -9318,9 +9340,9 @@ const de_DescribeServerlessCachesResponse = (
     contents[_NTe] = __expectString(output[_NTe]);
   }
   if (output.ServerlessCaches === "") {
-    contents[_SCe] = [];
-  } else if (output[_SCe] != null && output[_SCe][_m] != null) {
-    contents[_SCe] = de_ServerlessCacheList(__getArrayIfSingleItem(output[_SCe][_m]), context);
+    contents[_SCer] = [];
+  } else if (output[_SCer] != null && output[_SCer][_m] != null) {
+    contents[_SCer] = de_ServerlessCacheList(__getArrayIfSingleItem(output[_SCer][_m]), context);
   }
   return contents;
 };
@@ -10094,8 +10116,8 @@ const de_ModifyReplicationGroupShardConfigurationResult = (
  */
 const de_ModifyServerlessCacheResponse = (output: any, context: __SerdeContext): ModifyServerlessCacheResponse => {
   const contents: any = {};
-  if (output[_SC] != null) {
-    contents[_SC] = de_ServerlessCache(output[_SC], context);
+  if (output[_SCe] != null) {
+    contents[_SCe] = de_ServerlessCache(output[_SCe], context);
   }
   return contents;
 };
@@ -10546,6 +10568,9 @@ const de_PendingModifiedValues = (output: any, context: __SerdeContext): Pending
   if (output[_TEM] != null) {
     contents[_TEM] = __expectString(output[_TEM]);
   }
+  if (output[_SC] != null) {
+    contents[_SC] = de_ScaleConfig(output[_SC], context);
+  }
   return contents;
 };
 
@@ -11107,6 +11132,20 @@ const de_RevokeCacheSecurityGroupIngressResult = (
   return contents;
 };
 
+/**
+ * deserializeAws_queryScaleConfig
+ */
+const de_ScaleConfig = (output: any, context: __SerdeContext): ScaleConfig => {
+  const contents: any = {};
+  if (output[_SP] != null) {
+    contents[_SP] = __strictParseInt32(output[_SP]) as number;
+  }
+  if (output[_SIM] != null) {
+    contents[_SIM] = __strictParseInt32(output[_SIM]) as number;
+  }
+  return contents;
+};
+
 /**
  * deserializeAws_querySecurityGroupIdsList
  */
@@ -12041,9 +12080,9 @@ const de_UserGroup = (output: any, context: __SerdeContext): UserGroup => {
     contents[_RGe] = de_UGReplicationGroupIdList(__getArrayIfSingleItem(output[_RGe][_m]), context);
   }
   if (output.ServerlessCaches === "") {
-    contents[_SCe] = [];
-  } else if (output[_SCe] != null && output[_SCe][_m] != null) {
-    contents[_SCe] = de_UGServerlessCacheIdList(__getArrayIfSingleItem(output[_SCe][_m]), context);
+    contents[_SCer] = [];
+  } else if (output[_SCer] != null && output[_SCer][_m] != null) {
+    contents[_SCer] = de_UGServerlessCacheIdList(__getArrayIfSingleItem(output[_SCer][_m]), context);
   }
   if (output[_ARN] != null) {
     contents[_ARN] = __expectString(output[_ARN]);
@@ -12553,7 +12592,7 @@ const _SA = "SnapshotArns";
 const _SATR = "SnapshotArnsToRestore";
 const _SAZ = "SubnetAvailabilityZone";
 const _SBN = "S3BucketName";
-const _SC = "ServerlessCache";
+const _SC = "ScaleConfig";
 const _SCC = "ServerlessCacheConfiguration";
 const _SCCNIRG = "ShowCacheClustersNotInReplicationGroups";
 const _SCI = "SnapshottingClusterId";
@@ -12564,12 +12603,14 @@ const _SCS = "ServerlessCacheSnapshot";
 const _SCSN = "ServerlessCacheSnapshotName";
 const _SCSe = "ServerlessCacheSnapshots";
 const _SCT = "SnapshotCreateTime";
-const _SCe = "ServerlessCaches";
+const _SCe = "ServerlessCache";
+const _SCer = "ServerlessCaches";
 const _SDM = "ScaleDownModifications";
 const _SG = "SecurityGroups";
 const _SGI = "SecurityGroupIds";
 const _SGIe = "SecurityGroupId";
 const _SI = "SubnetIds";
+const _SIM = "ScaleIntervalMinutes";
 const _SIo = "SourceIdentifier";
 const _SIu = "SubnetId";
 const _SIub = "SubnetIdentifier";
@@ -12583,6 +12624,7 @@ const _SNLUS = "ShowNodeLevelUpdateStatus";
 const _SNT = "SupportedNetworkTypes";
 const _SO = "SubnetOutpost";
 const _SOA = "SubnetOutpostArn";
+const _SP = "ScalePercentage";
 const _SRL = "SnapshotRetentionLimit";
 const _SS = "SnapshotSource";
 const _SSCSN = "SourceServerlessCacheSnapshotName";
