kb-cloud-client-typescript 2.4.0-alpha.70 → 2.4.0-alpha.71

package/src/adminapi/models/mode-component-instance-template.ts

@@ -24,19 +24,19 @@ import type { InstanceTemplateEnv } from './instance-template-env';
 import type { InstanceTemplateOp } from './instance-template-op';
 
 /**
- * Frontend catalog of instance templates for this mode component. names, ops, attributes, and env are for UI rendering. Create validates the request against chart-rendered Cluster instances, not this catalog. HScale does not re-check this catalog; it builds the OpsRequest from the request and the live Cluster. HScale instanceTemplates still requires top-level replicas. ops lists hscale and vscale for the UI (vscale is reserved; class stays component-level). Only HScale processes instance templates. VolumeExpansion, VScale, Upgrade, Restart, and other operations silently ignore instance templates and keep their component-level behavior. Template-level volumeexpansion is not implemented. The platform does not even-split or fill in missing templates. When absent, the frontend should use component-level operations. 
+ * Template fields and operations shared by the frontend and backend. Declaring storageExpansion in ops requires explicit volume expansion targets for every name. Components without this capability use component-level expansion. 
  * @export
  * @interface ModeComponentInstanceTemplate
  */
 export interface ModeComponentInstanceTemplate {
     /**
-     * Instance template names the frontend should render. Create and hscale check names against the chart or live Cluster, not this list. 
+     * Instance template names the frontend should render. Create and hscale check names against the chart or live Cluster, not this list. Explicit volume expansion targets must include every name in this list. 
      * @type {Set<string>}
      * @memberof ModeComponentInstanceTemplate
      */
     'names': Set<string>;
     /**
-     * Operations the frontend should offer per template: hscale, vscale. Not re-checked when creating a cluster or building an hscale OpsRequest. Only hscale currently acts per template; vscale is reserved. VolumeExpansion, VScale, Upgrade, and Restart ignore instance templates and keep their component-level behavior. 
+     * Template operations: hscale, storageExpansion, and reserved vscale. Explicit volume expansion targets must match component volume names and target capacities. 
      * @type {Array<InstanceTemplateOp>}
      * @memberof ModeComponentInstanceTemplate
      */

package/src/adminapi/models/{ops-volume-expand-volumes-inner.ts → ops-volume-expand-volumes-items0.ts}

@@ -17,19 +17,19 @@
 /**
  * 
  * @export
- * @interface OpsVolumeExpandVolumesInner
+ * @interface OpsVolumeExpandVolumesItems0
  */
-export interface OpsVolumeExpandVolumesInner {
+export interface OpsVolumeExpandVolumesItems0 {
     /**
-     * volume name
+     * Volume name.
      * @type {string}
-     * @memberof OpsVolumeExpandVolumesInner
+     * @memberof OpsVolumeExpandVolumesItems0
      */
     'name': string;
     /**
-     * Storage size, the unit is Gi.
+     * Desired size with Gi suffix, for example 30Gi.
      * @type {string}
-     * @memberof OpsVolumeExpandVolumesInner
+     * @memberof OpsVolumeExpandVolumesItems0
      */
     'storage': string;
 }

package/src/adminapi/models/ops-volume-expand.ts

@@ -15,14 +15,23 @@
 
 // May contain unused imports in some cases
 // @ts-ignore
-import type { OpsVolumeExpandVolumesInner } from './ops-volume-expand-volumes-inner';
+import type { InstanceTemplateVolumeExpand } from './instance-template-volume-expand';
+// May contain unused imports in some cases
+// @ts-ignore
+import type { OpsVolumeExpandVolumesItems0 } from './ops-volume-expand-volumes-items0';
 
 /**
- * OpsVolumeExpand is the payload to expand volume for a KubeBlocks cluster
+ * Expand component volumes and explicit targets for components with template expansion enabled.
  * @export
  * @interface OpsVolumeExpand
  */
 export interface OpsVolumeExpand {
+    /**
+     * Required when the current mode component instanceTemplate.ops includes storageExpansion; otherwise omit for component-level expansion. Explicit targets require this capability. Every configured template must explicitly specify the same volume names and target capacities as component-level volumes. Names identify templates, not Pods. Targets are forwarded together in one OpsRequest without filling in, merging, or removing template targets. KubeBlocks may materialize template volumeClaimTemplates for explicitly targeted inherited volumes.
+     * @type {Array<InstanceTemplateVolumeExpand>}
+     * @memberof OpsVolumeExpand
+     */
+    'instanceTemplates'?: Array<InstanceTemplateVolumeExpand>;
     /**
      * 
      * @type {string}
@@ -31,9 +40,9 @@ export interface OpsVolumeExpand {
     'component': string;
     /**
      * 
-     * @type {Array<OpsVolumeExpandVolumesInner>}
+     * @type {Array<OpsVolumeExpandVolumesItems0>}
      * @memberof OpsVolumeExpand
      */
-    'volumes': Array<OpsVolumeExpandVolumesInner>;
+    'volumes': Array<OpsVolumeExpandVolumesItems0>;
 }
 

package/src/adminapi.yaml

@@ -30114,7 +30114,7 @@ components:
       type: object
       additionalProperties: false
       description: |
-        Create assignment for one instance template. name and replicas are required. env, annotations, and labels are optional overlays onto the chart-rendered instance. The request must include every chart-rendered instance template exactly once.
+        Create assignment for one instance template. name and replicas are required. env, annotations, labels, availabilityZone, and storageClass are optional overlays onto the chart-rendered instance. The request must include every chart-rendered instance template exactly once. A template with an explicit zone uses single-zone scheduling: hostname anti-affinity follows the scheduling policy, while explicit rules and additional topology keys are preserved. Component scheduling remains unchanged; templates without a zone inherit it, including its zone anti-affinity constraints. Chart instance scheduling policies are cleared; an omitted or empty availabilityZone leaves the instance policy unset to inherit the component policy.
       required:
         - name
         - replicas
@@ -30127,6 +30127,12 @@ components:
           type: integer
           minimum: 0
           description: Replica count for this instance template.
+        availabilityZone:
+          type: string
+          description: Availability zone for this template (topology.kubernetes.io/zone); omitted or empty inherits the component zone selection. Must be enabled in the environment. If the request explicitly supplies a non-empty cluster availabilityZones list, the template zone must also belong to that list.
+        storageClass:
+          type: string
+          description: StorageClass name for all persistent volumes in this template. Copied from component volumeClaimTemplates, preserving volume sizes and other settings while overriding storageClassName. Chart instance volume templates are cleared; omitted or empty leaves instance volumeClaimTemplates unset.
         env:
           type: array
           description: Simple env vars (name and value only) merged into this template. valueFrom is not supported; overlaying a name clears any chart valueFrom.
@@ -35694,9 +35700,43 @@ components:
           type: array
           items:
             $ref: '#/components/schemas/engineServiceVersionsItem'
+    opsVolumeExpandVolumesItems0:
+      type: object
+      required:
+        - name
+        - storage
+      properties:
+        name:
+          type: string
+          minLength: 1
+          description: Volume name.
+        storage:
+          type: string
+          description: Desired size with Gi suffix, for example 30Gi.
+    instanceTemplateVolumeExpand:
+      type: object
+      required:
+        - name
+        - volumes
+      properties:
+        name:
+          type: string
+          minLength: 1
+          description: Template name from the current mode component instanceTemplate.names.
+        volumes:
+          type: array
+          minItems: 1
+          items:
+            $ref: '#/components/schemas/opsVolumeExpandVolumesItems0'
     opsVolumeExpand:
-      description: OpsVolumeExpand is the payload to expand volume for a KubeBlocks cluster
+      description: Expand component volumes and explicit targets for components with template expansion enabled.
       properties:
+        instanceTemplates:
+          type: array
+          minItems: 1
+          description: Required when the current mode component instanceTemplate.ops includes storageExpansion; otherwise omit for component-level expansion. Explicit targets require this capability. Every configured template must explicitly specify the same volume names and target capacities as component-level volumes. Names identify templates, not Pods. Targets are forwarded together in one OpsRequest without filling in, merging, or removing template targets. KubeBlocks may materialize template volumeClaimTemplates for explicitly targeted inherited volumes.
+          items:
+            $ref: '#/components/schemas/instanceTemplateVolumeExpand'
         component:
           type: string
           minLength: 1
@@ -35704,17 +35744,7 @@ components:
           type: array
           minItems: 1
           items:
-            type: object
-            properties:
-              name:
-                type: string
-                description: volume name
-              storage:
-                type: string
-                description: Storage size, the unit is Gi.
-            required:
-              - name
-              - storage
+            $ref: '#/components/schemas/opsVolumeExpandVolumesItems0'
       required:
         - volumes
         - component
@@ -39442,6 +39472,7 @@ components:
       enum:
         - hscale
         - vscale
+        - storageExpansion
     instanceTemplateAttribute:
       type: string
       description: Heterogeneous attribute the frontend may render on an instance template at create.
@@ -39449,6 +39480,8 @@ components:
         - env
         - annotations
         - labels
+        - availabilityZone
+        - storageClass
     instanceTemplateEnv:
       type: object
       description: One fillable env var on an instance template, for frontend rendering.
@@ -39493,19 +39526,9 @@ components:
         instanceTemplate:
           type: object
           description: |
-            Frontend catalog of instance templates for this mode component.
-            names, ops, attributes, and env are for UI rendering. Create
-            validates the request against chart-rendered Cluster instances,
-            not this catalog. HScale does not re-check this catalog; it
-            builds the OpsRequest from the request and the live Cluster.
-            HScale instanceTemplates still requires top-level replicas.
-            ops lists hscale and vscale for the UI (vscale is reserved;
-            class stays component-level). Only HScale processes instance templates.
-            VolumeExpansion, VScale, Upgrade, Restart, and other operations silently
-            ignore instance templates and keep their component-level behavior.
-            Template-level volumeexpansion is not implemented.
-            The platform does not even-split or fill in missing templates.
-            When absent, the frontend should use component-level operations.
+            Template fields and operations shared by the frontend and backend.
+            Declaring storageExpansion in ops requires explicit volume expansion targets
+            for every name. Components without this capability use component-level expansion.
           required:
             - names
             - ops
@@ -39519,18 +39542,16 @@ components:
               description: |
                 Instance template names the frontend should render.
                 Create and hscale check names against the chart or live Cluster,
-                not this list.
+                not this list. Explicit volume expansion targets must include every name in this list.
             ops:
               type: array
               minItems: 1
               items:
                 $ref: '#/components/schemas/instanceTemplateOp'
               description: |
-                Operations the frontend should offer per template: hscale, vscale.
-                Not re-checked when creating a cluster or building an hscale OpsRequest.
-                Only hscale currently acts per template; vscale is reserved.
-                VolumeExpansion, VScale, Upgrade, and Restart ignore instance templates
-                and keep their component-level behavior.
+                Template operations: hscale, storageExpansion, and reserved vscale.
+                Explicit volume expansion targets must match component volume names
+                and target capacities.
             attributes:
               type: array
               uniqueItems: true

package/src/openapi/.openapi-generator/FILES

@@ -610,6 +610,7 @@ models/instance-template-create.ts
 models/instance-template-env.ts
 models/instance-template-op.ts
 models/instance-template-replicas.ts
+models/instance-template-volume-expand.ts
 models/instance.ts
 models/integer-option.ts
 models/international-desc.ts
@@ -771,7 +772,7 @@ models/ops-restart.ts
 models/ops-start.ts
 models/ops-stop.ts
 models/ops-upgrade.ts
-models/ops-volume-expand-volumes-inner.ts
+models/ops-volume-expand-volumes-items0.ts
 models/ops-volume-expand.ts
 models/ops-vscale.ts
 models/oracle-tablespace-contents.ts

package/src/openapi/models/index.ts

@@ -516,6 +516,7 @@ export * from './instance-template-create-env-inner';
 export * from './instance-template-env';
 export * from './instance-template-op';
 export * from './instance-template-replicas';
+export * from './instance-template-volume-expand';
 export * from './integer-option';
 export * from './international-desc';
 export * from './io-quantity';
@@ -678,7 +679,7 @@ export * from './ops-stop';
 export * from './ops-upgrade';
 export * from './ops-vscale';
 export * from './ops-volume-expand';
-export * from './ops-volume-expand-volumes-inner';
+export * from './ops-volume-expand-volumes-items0';
 export * from './oracle-tablespace';
 export * from './oracle-tablespace-contents';
 export * from './oracle-tablespace-create';

package/src/openapi/models/instance-template-attribute.ts

@@ -23,7 +23,9 @@
 export const InstanceTemplateAttribute = {
     env: 'env',
     annotations: 'annotations',
-    labels: 'labels'
+    labels: 'labels',
+    availabilityZone: 'availabilityZone',
+    storageClass: 'storageClass'
 } as const;
 
 export type InstanceTemplateAttribute = typeof InstanceTemplateAttribute[keyof typeof InstanceTemplateAttribute];

package/src/openapi/models/instance-template-create.ts

@@ -18,7 +18,7 @@
 import type { InstanceTemplateCreateEnvInner } from './instance-template-create-env-inner';
 
 /**
- * Create assignment for one instance template. name and replicas are required. env, annotations, and labels are optional overlays onto the chart-rendered instance. The request must include every chart-rendered instance template exactly once. 
+ * Create assignment for one instance template. name and replicas are required. env, annotations, labels, availabilityZone, and storageClass are optional overlays onto the chart-rendered instance. The request must include every chart-rendered instance template exactly once. A template with an explicit zone uses single-zone scheduling: hostname anti-affinity follows the scheduling policy, while explicit rules and additional topology keys are preserved. Component scheduling remains unchanged; templates without a zone inherit it, including its zone anti-affinity constraints. Chart instance scheduling policies are cleared; an omitted or empty availabilityZone leaves the instance policy unset to inherit the component policy. 
  * @export
  * @interface InstanceTemplateCreate
  */
@@ -35,6 +35,18 @@ export interface InstanceTemplateCreate {
      * @memberof InstanceTemplateCreate
      */
     'replicas': number;
+    /**
+     * Availability zone for this template (topology.kubernetes.io/zone); omitted or empty inherits the component zone selection. Must be enabled in the environment. If the request explicitly supplies a non-empty cluster availabilityZones list, the template zone must also belong to that list.
+     * @type {string}
+     * @memberof InstanceTemplateCreate
+     */
+    'availabilityZone'?: string;
+    /**
+     * StorageClass name for all persistent volumes in this template. Copied from component volumeClaimTemplates, preserving volume sizes and other settings while overriding storageClassName. Chart instance volume templates are cleared; omitted or empty leaves instance volumeClaimTemplates unset.
+     * @type {string}
+     * @memberof InstanceTemplateCreate
+     */
+    'storageClass'?: string;
     /**
      * Simple env vars (name and value only) merged into this template. valueFrom is not supported; overlaying a name clears any chart valueFrom.
      * @type {Array<InstanceTemplateCreateEnvInner>}

package/src/openapi/models/instance-template-op.ts

@@ -22,7 +22,8 @@
 
 export const InstanceTemplateOp = {
     hscale: 'hscale',
-    vscale: 'vscale'
+    vscale: 'vscale',
+    storageExpansion: 'storageExpansion'
 } as const;
 
 export type InstanceTemplateOp = typeof InstanceTemplateOp[keyof typeof InstanceTemplateOp];

package/src/openapi/models/instance-template-volume-expand.ts

@@ -0,0 +1,39 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * KubeBlocks Cloud API
+ * KubeBlocks Cloud API is a RESTful API for managing KubeBlocks Cloud resources.  The API is organized around REST.  Our API has predictable resource-oriented URLs, accepts `JSON-encoded` request bodies, returns `JSON-encoded` responses, and uses standard HTTP response codes, authentication, and verbs.  We use standard HTTP authentication and provide API keys to identify who you are. Your API keys carry many privileges, so be sure to keep them secret! Do not share your secret API keys in publicly accessible areas such as GitHub, client-side code, and so forth. 
+ *
+ * The version of the OpenAPI document: 1.0.0
+ * Contact: support@apecloud.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+
+// May contain unused imports in some cases
+// @ts-ignore
+import type { OpsVolumeExpandVolumesItems0 } from './ops-volume-expand-volumes-items0';
+
+/**
+ * 
+ * @export
+ * @interface InstanceTemplateVolumeExpand
+ */
+export interface InstanceTemplateVolumeExpand {
+    /**
+     * Template name from the current mode component instanceTemplate.names.
+     * @type {string}
+     * @memberof InstanceTemplateVolumeExpand
+     */
+    'name': string;
+    /**
+     * 
+     * @type {Array<OpsVolumeExpandVolumesItems0>}
+     * @memberof InstanceTemplateVolumeExpand
+     */
+    'volumes': Array<OpsVolumeExpandVolumesItems0>;
+}
+

package/src/openapi/models/mode-component-instance-template.ts

@@ -24,19 +24,19 @@ import type { InstanceTemplateEnv } from './instance-template-env';
 import type { InstanceTemplateOp } from './instance-template-op';
 
 /**
- * Frontend catalog of instance templates for this mode component. names, ops, attributes, and env are for UI rendering. Create validates the request against chart-rendered Cluster instances, not this catalog. HScale does not re-check this catalog; it builds the OpsRequest from the request and the live Cluster. HScale instanceTemplates still requires top-level replicas. ops lists hscale and vscale for the UI (vscale is reserved; class stays component-level). Only HScale processes instance templates. VolumeExpansion, VScale, Upgrade, Restart, and other operations silently ignore instance templates and keep their component-level behavior. Template-level volumeexpansion is not implemented. The platform does not even-split or fill in missing templates. When absent, the frontend should use component-level operations. 
+ * Template fields and operations shared by the frontend and backend. Declaring storageExpansion in ops requires explicit volume expansion targets for every name. Components without this capability use component-level expansion. 
  * @export
  * @interface ModeComponentInstanceTemplate
  */
 export interface ModeComponentInstanceTemplate {
     /**
-     * Instance template names the frontend should render. Create and hscale check names against the chart or live Cluster, not this list. 
+     * Instance template names the frontend should render. Create and hscale check names against the chart or live Cluster, not this list. Explicit volume expansion targets must include every name in this list. 
      * @type {Set<string>}
      * @memberof ModeComponentInstanceTemplate
      */
     'names': Set<string>;
     /**
-     * Operations the frontend should offer per template: hscale, vscale. Not re-checked when creating a cluster or building an hscale OpsRequest. Only hscale currently acts per template; vscale is reserved. VolumeExpansion, VScale, Upgrade, and Restart ignore instance templates and keep their component-level behavior. 
+     * Template operations: hscale, storageExpansion, and reserved vscale. Explicit volume expansion targets must match component volume names and target capacities. 
      * @type {Array<InstanceTemplateOp>}
      * @memberof ModeComponentInstanceTemplate
      */

package/src/openapi/models/{ops-volume-expand-volumes-inner.ts → ops-volume-expand-volumes-items0.ts}

@@ -17,19 +17,19 @@
 /**
  * 
  * @export
- * @interface OpsVolumeExpandVolumesInner
+ * @interface OpsVolumeExpandVolumesItems0
  */
-export interface OpsVolumeExpandVolumesInner {
+export interface OpsVolumeExpandVolumesItems0 {
     /**
-     * volume name
+     * Volume name.
      * @type {string}
-     * @memberof OpsVolumeExpandVolumesInner
+     * @memberof OpsVolumeExpandVolumesItems0
      */
     'name': string;
     /**
-     * Storage size, the unit is Gi.
+     * Desired size with Gi suffix, for example 30Gi.
      * @type {string}
-     * @memberof OpsVolumeExpandVolumesInner
+     * @memberof OpsVolumeExpandVolumesItems0
      */
     'storage': string;
 }

package/src/openapi/models/ops-volume-expand.ts

@@ -15,14 +15,23 @@
 
 // May contain unused imports in some cases
 // @ts-ignore
-import type { OpsVolumeExpandVolumesInner } from './ops-volume-expand-volumes-inner';
+import type { InstanceTemplateVolumeExpand } from './instance-template-volume-expand';
+// May contain unused imports in some cases
+// @ts-ignore
+import type { OpsVolumeExpandVolumesItems0 } from './ops-volume-expand-volumes-items0';
 
 /**
- * OpsVolumeExpand is the payload to expand volume for a KubeBlocks cluster
+ * Expand component volumes and explicit targets for components with template expansion enabled.
  * @export
  * @interface OpsVolumeExpand
  */
 export interface OpsVolumeExpand {
+    /**
+     * Required when the current mode component instanceTemplate.ops includes storageExpansion; otherwise omit for component-level expansion. Explicit targets require this capability. Every configured template must explicitly specify the same volume names and target capacities as component-level volumes. Names identify templates, not Pods. Targets are forwarded together in one OpsRequest without filling in, merging, or removing template targets. KubeBlocks may materialize template volumeClaimTemplates for explicitly targeted inherited volumes.
+     * @type {Array<InstanceTemplateVolumeExpand>}
+     * @memberof OpsVolumeExpand
+     */
+    'instanceTemplates'?: Array<InstanceTemplateVolumeExpand>;
     /**
      * 
      * @type {string}
@@ -31,9 +40,9 @@ export interface OpsVolumeExpand {
     'component': string;
     /**
      * 
-     * @type {Array<OpsVolumeExpandVolumesInner>}
+     * @type {Array<OpsVolumeExpandVolumesItems0>}
      * @memberof OpsVolumeExpand
      */
-    'volumes': Array<OpsVolumeExpandVolumesInner>;
+    'volumes': Array<OpsVolumeExpandVolumesItems0>;
 }
 

package/src/openapi.yaml

@@ -25671,7 +25671,7 @@ components:
       type: object
       additionalProperties: false
       description: |
-        Create assignment for one instance template. name and replicas are required. env, annotations, and labels are optional overlays onto the chart-rendered instance. The request must include every chart-rendered instance template exactly once.
+        Create assignment for one instance template. name and replicas are required. env, annotations, labels, availabilityZone, and storageClass are optional overlays onto the chart-rendered instance. The request must include every chart-rendered instance template exactly once. A template with an explicit zone uses single-zone scheduling: hostname anti-affinity follows the scheduling policy, while explicit rules and additional topology keys are preserved. Component scheduling remains unchanged; templates without a zone inherit it, including its zone anti-affinity constraints. Chart instance scheduling policies are cleared; an omitted or empty availabilityZone leaves the instance policy unset to inherit the component policy.
       required:
         - name
         - replicas
@@ -25684,6 +25684,12 @@ components:
           type: integer
           minimum: 0
           description: Replica count for this instance template.
+        availabilityZone:
+          type: string
+          description: Availability zone for this template (topology.kubernetes.io/zone); omitted or empty inherits the component zone selection. Must be enabled in the environment. If the request explicitly supplies a non-empty cluster availabilityZones list, the template zone must also belong to that list.
+        storageClass:
+          type: string
+          description: StorageClass name for all persistent volumes in this template. Copied from component volumeClaimTemplates, preserving volume sizes and other settings while overriding storageClassName. Chart instance volume templates are cleared; omitted or empty leaves instance volumeClaimTemplates unset.
         env:
           type: array
           description: Simple env vars (name and value only) merged into this template. valueFrom is not supported; overlaying a name clears any chart valueFrom.
@@ -27686,9 +27692,43 @@ components:
           type: array
           items:
             $ref: '#/components/schemas/engineServiceVersionsItem'
+    opsVolumeExpandVolumesItems0:
+      type: object
+      required:
+        - name
+        - storage
+      properties:
+        name:
+          type: string
+          minLength: 1
+          description: Volume name.
+        storage:
+          type: string
+          description: Desired size with Gi suffix, for example 30Gi.
+    instanceTemplateVolumeExpand:
+      type: object
+      required:
+        - name
+        - volumes
+      properties:
+        name:
+          type: string
+          minLength: 1
+          description: Template name from the current mode component instanceTemplate.names.
+        volumes:
+          type: array
+          minItems: 1
+          items:
+            $ref: '#/components/schemas/opsVolumeExpandVolumesItems0'
     opsVolumeExpand:
-      description: OpsVolumeExpand is the payload to expand volume for a KubeBlocks cluster
+      description: Expand component volumes and explicit targets for components with template expansion enabled.
       properties:
+        instanceTemplates:
+          type: array
+          minItems: 1
+          description: Required when the current mode component instanceTemplate.ops includes storageExpansion; otherwise omit for component-level expansion. Explicit targets require this capability. Every configured template must explicitly specify the same volume names and target capacities as component-level volumes. Names identify templates, not Pods. Targets are forwarded together in one OpsRequest without filling in, merging, or removing template targets. KubeBlocks may materialize template volumeClaimTemplates for explicitly targeted inherited volumes.
+          items:
+            $ref: '#/components/schemas/instanceTemplateVolumeExpand'
         component:
           type: string
           minLength: 1
@@ -27696,17 +27736,7 @@ components:
           type: array
           minItems: 1
           items:
-            type: object
-            properties:
-              name:
-                type: string
-                description: volume name
-              storage:
-                type: string
-                description: Storage size, the unit is Gi.
-            required:
-              - name
-              - storage
+            $ref: '#/components/schemas/opsVolumeExpandVolumesItems0'
       required:
         - volumes
         - component
@@ -32924,6 +32954,7 @@ components:
       enum:
         - hscale
         - vscale
+        - storageExpansion
     instanceTemplateAttribute:
       type: string
       description: Heterogeneous attribute the frontend may render on an instance template at create.
@@ -32931,6 +32962,8 @@ components:
         - env
         - annotations
         - labels
+        - availabilityZone
+        - storageClass
     instanceTemplateEnv:
       type: object
       description: One fillable env var on an instance template, for frontend rendering.
@@ -32975,19 +33008,9 @@ components:
         instanceTemplate:
           type: object
           description: |
-            Frontend catalog of instance templates for this mode component.
-            names, ops, attributes, and env are for UI rendering. Create
-            validates the request against chart-rendered Cluster instances,
-            not this catalog. HScale does not re-check this catalog; it
-            builds the OpsRequest from the request and the live Cluster.
-            HScale instanceTemplates still requires top-level replicas.
-            ops lists hscale and vscale for the UI (vscale is reserved;
-            class stays component-level). Only HScale processes instance templates.
-            VolumeExpansion, VScale, Upgrade, Restart, and other operations silently
-            ignore instance templates and keep their component-level behavior.
-            Template-level volumeexpansion is not implemented.
-            The platform does not even-split or fill in missing templates.
-            When absent, the frontend should use component-level operations.
+            Template fields and operations shared by the frontend and backend.
+            Declaring storageExpansion in ops requires explicit volume expansion targets
+            for every name. Components without this capability use component-level expansion.
           required:
             - names
             - ops
@@ -33001,18 +33024,16 @@ components:
               description: |
                 Instance template names the frontend should render.
                 Create and hscale check names against the chart or live Cluster,
-                not this list.
+                not this list. Explicit volume expansion targets must include every name in this list.
             ops:
               type: array
               minItems: 1
               items:
                 $ref: '#/components/schemas/instanceTemplateOp'
               description: |
-                Operations the frontend should offer per template: hscale, vscale.
-                Not re-checked when creating a cluster or building an hscale OpsRequest.
-                Only hscale currently acts per template; vscale is reserved.
-                VolumeExpansion, VScale, Upgrade, and Restart ignore instance templates
-                and keep their component-level behavior.
+                Template operations: hscale, storageExpansion, and reserved vscale.
+                Explicit volume expansion targets must match component volume names
+                and target capacities.
             attributes:
               type: array
               uniqueItems: true

package/dist/adminapi/models/ops-volume-expand-volumes-inner.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ops-volume-expand-volumes-inner.d.ts","sourceRoot":"","sources":["../../../src/adminapi/models/ops-volume-expand-volumes-inner.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AAIH;;;;GAIG;AACH,MAAM,WAAW,2BAA2B;IACxC;;;;OAIG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,SAAS,EAAE,MAAM,CAAC;CACrB"}

package/dist/adminapi/models/ops-volume-expand-volumes-inner.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ops-volume-expand-volumes-inner.js","sourceRoot":"","sources":["../../../src/adminapi/models/ops-volume-expand-volumes-inner.ts"],"names":[],"mappings":";AAAA,oBAAoB;AACpB,oBAAoB;AACpB;;;;;;;;;;GAUG"}

package/dist/openapi/models/ops-volume-expand-volumes-inner.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ops-volume-expand-volumes-inner.d.ts","sourceRoot":"","sources":["../../../src/openapi/models/ops-volume-expand-volumes-inner.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AAIH;;;;GAIG;AACH,MAAM,WAAW,2BAA2B;IACxC;;;;OAIG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,SAAS,EAAE,MAAM,CAAC;CACrB"}

package/dist/openapi/models/ops-volume-expand-volumes-inner.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ops-volume-expand-volumes-inner.js","sourceRoot":"","sources":["../../../src/openapi/models/ops-volume-expand-volumes-inner.ts"],"names":[],"mappings":";AAAA,oBAAoB;AACpB,oBAAoB;AACpB;;;;;;;;;;GAUG"}