kb-cloud-client-typescript 2.4.0-alpha.66 → 2.4.0-alpha.67

package/src/openapi/models/index.ts

@@ -510,6 +510,12 @@ export * from './instance-metrics';
 export * from './instance-metrics-list';
 export * from './instance-status';
 export * from './instance-storage-item';
+export * from './instance-template-attribute';
+export * from './instance-template-create';
+export * from './instance-template-create-env-inner';
+export * from './instance-template-env';
+export * from './instance-template-op';
+export * from './instance-template-replicas';
 export * from './integer-option';
 export * from './international-desc';
 export * from './io-quantity';
@@ -572,6 +578,7 @@ export * from './milvus-role-list';
 export * from './milvus-role-request';
 export * from './mode-compatible-kubeblocks-version';
 export * from './mode-component';
+export * from './mode-component-instance-template';
 export * from './mode-object-storage';
 export * from './mode-object-storage-additional-helm-value-path';
 export * from './mode-object-storage-service-ref';

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

@@ -0,0 +1,32 @@
+/* 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.
+ */
+
+
+
+/**
+ * Heterogeneous attribute the frontend may render on an instance template at create.
+ * @export
+ * @enum {string}
+ */
+
+export const InstanceTemplateAttribute = {
+    env: 'env',
+    annotations: 'annotations',
+    labels: 'labels'
+} as const;
+
+export type InstanceTemplateAttribute = typeof InstanceTemplateAttribute[keyof typeof InstanceTemplateAttribute];
+
+
+

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

@@ -0,0 +1,36 @@
+/* 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.
+ */
+
+
+
+/**
+ * 
+ * @export
+ * @interface InstanceTemplateCreateEnvInner
+ */
+export interface InstanceTemplateCreateEnvInner {
+    /**
+     * 
+     * @type {string}
+     * @memberof InstanceTemplateCreateEnvInner
+     */
+    'name': string;
+    /**
+     * Plain string value only. valueFrom is not supported.
+     * @type {string}
+     * @memberof InstanceTemplateCreateEnvInner
+     */
+    'value': string;
+}
+

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

@@ -0,0 +1,57 @@
+/* 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 { 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. 
+ * @export
+ * @interface InstanceTemplateCreate
+ */
+export interface InstanceTemplateCreate {
+    /**
+     * Instance template name; must match a chart-rendered instance.
+     * @type {string}
+     * @memberof InstanceTemplateCreate
+     */
+    'name': string;
+    /**
+     * Replica count for this instance template.
+     * @type {number}
+     * @memberof InstanceTemplateCreate
+     */
+    'replicas': number;
+    /**
+     * 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>}
+     * @memberof InstanceTemplateCreate
+     */
+    'env'?: Array<InstanceTemplateCreateEnvInner>;
+    /**
+     * Annotation map (string key to string value). Merged into this template; same-name keys overwritten. Chart keys are not deleted.
+     * @type {{ [key: string]: string; }}
+     * @memberof InstanceTemplateCreate
+     */
+    'annotations'?: { [key: string]: string; };
+    /**
+     * Label map (string key to string value). Merged into this template; same-name keys overwritten. Chart keys are not deleted.
+     * @type {{ [key: string]: string; }}
+     * @memberof InstanceTemplateCreate
+     */
+    'labels'?: { [key: string]: string; };
+}
+

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

@@ -0,0 +1,57 @@
+/* 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 { LocalizedDescription } from './localized-description';
+
+/**
+ * One fillable env var on an instance template, for frontend rendering.
+ * @export
+ * @interface InstanceTemplateEnv
+ */
+export interface InstanceTemplateEnv {
+    /**
+     * Env var name written to the instance template.
+     * @type {string}
+     * @memberof InstanceTemplateEnv
+     */
+    'name': string;
+    /**
+     * 
+     * @type {LocalizedDescription}
+     * @memberof InstanceTemplateEnv
+     */
+    'label'?: LocalizedDescription;
+    /**
+     * 
+     * @type {LocalizedDescription}
+     * @memberof InstanceTemplateEnv
+     */
+    'description'?: LocalizedDescription;
+    /**
+     * If true, the frontend should treat this env as required. Create does not re-check.
+     * @type {boolean}
+     * @memberof InstanceTemplateEnv
+     */
+    'required'?: boolean;
+    /**
+     * Default value shown by the frontend.
+     * @type {string}
+     * @memberof InstanceTemplateEnv
+     */
+    'default'?: string;
+}
+

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

@@ -0,0 +1,31 @@
+/* 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.
+ */
+
+
+
+/**
+ * Operation that can be declared on instanceTemplate.ops.
+ * @export
+ * @enum {string}
+ */
+
+export const InstanceTemplateOp = {
+    hscale: 'hscale',
+    vscale: 'vscale'
+} as const;
+
+export type InstanceTemplateOp = typeof InstanceTemplateOp[keyof typeof InstanceTemplateOp];
+
+
+

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

@@ -0,0 +1,36 @@
+/* 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.
+ */
+
+
+
+/**
+ * HScale assignment for one instance template. name and replicas only.
+ * @export
+ * @interface InstanceTemplateReplicas
+ */
+export interface InstanceTemplateReplicas {
+    /**
+     * Instance template name on the live Cluster spec.
+     * @type {string}
+     * @memberof InstanceTemplateReplicas
+     */
+    'name': string;
+    /**
+     * Target replica count for this instance template.
+     * @type {number}
+     * @memberof InstanceTemplateReplicas
+     */
+    'replicas': number;
+}
+

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

@@ -0,0 +1,57 @@
+/* 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 { InstanceTemplateAttribute } from './instance-template-attribute';
+// May contain unused imports in some cases
+// @ts-ignore
+import type { InstanceTemplateEnv } from './instance-template-env';
+// May contain unused imports in some cases
+// @ts-ignore
+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. 
+ * @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. 
+     * @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. 
+     * @type {Array<InstanceTemplateOp>}
+     * @memberof ModeComponentInstanceTemplate
+     */
+    'ops': Array<InstanceTemplateOp>;
+    /**
+     * Heterogeneous attributes the frontend should render on each instance template at create. Omitted or empty means only name and replicas. Create overlays the request onto the chart and does not re-check this list. 
+     * @type {Set<InstanceTemplateAttribute>}
+     * @memberof ModeComponentInstanceTemplate
+     */
+    'attributes'?: Set<InstanceTemplateAttribute>;
+    /**
+     * Env vars the frontend may render when attributes includes env. Create does not re-check this list. 
+     * @type {Array<InstanceTemplateEnv>}
+     * @memberof ModeComponentInstanceTemplate
+     */
+    'env'?: Array<InstanceTemplateEnv>;
+}
+

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

@@ -13,6 +13,9 @@
  */
 
 
+// May contain unused imports in some cases
+// @ts-ignore
+import type { ModeComponentInstanceTemplate } from './mode-component-instance-template';
 // May contain unused imports in some cases
 // @ts-ignore
 import type { ModeReadonlyEndpoint } from './mode-readonly-endpoint';
@@ -41,6 +44,12 @@ export interface ModeComponent {
      * @memberof ModeComponent
      */
     'hideOnCreate': boolean;
+    /**
+     * 
+     * @type {ModeComponentInstanceTemplate}
+     * @memberof ModeComponent
+     */
+    'instanceTemplate'?: ModeComponentInstanceTemplate;
     /**
      * the name of the serviceRef defined in mode\'s serviceRefs. If set, it means a serviceRef can be used to replace this component. 
      * @type {string}

package/src/openapi/models/ops-hscale.ts

@@ -13,12 +13,15 @@
  */
 
 
+// May contain unused imports in some cases
+// @ts-ignore
+import type { InstanceTemplateReplicas } from './instance-template-replicas';
 // May contain unused imports in some cases
 // @ts-ignore
 import type { TaskSchedule } from './task-schedule';
 
 /**
- * OpsHScale is the payload to horizontally scale a KubeBlocks cluster. It requires specifying either the number of replicas or the number of shards.
+ * OpsHScale is the payload to horizontally scale a KubeBlocks cluster. Specify replicas or shards. instanceTemplates is an optional overlay and requires top-level replicas.
  * @export
  * @interface OpsHScale
  */
@@ -41,6 +44,12 @@ export interface OpsHScale {
      * @memberof OpsHScale
      */
     'replicas'?: number | null;
+    /**
+     * Target replica count for named instance templates. Requires top-level replicas. Mapped onto the live Cluster spec to build scaleIn/scaleOut.instances. Required for replica scaling when the live component has instance templates. Names must exactly match all live instance templates, without missing, extra, or duplicate names; order does not matter. Top-level replicas must equal the sum of all requested template replica counts. Shard-count scaling does not check templates and cannot include this list.
+     * @type {Array<InstanceTemplateReplicas>}
+     * @memberof OpsHScale
+     */
+    'instanceTemplates'?: Array<InstanceTemplateReplicas>;
     /**
      * List of online instance names to be switched to offline during scaling in.
      * @type {Array<string>}

package/src/openapi/models/ops-vscale.ts

@@ -42,7 +42,7 @@ export interface OpsVScale {
      */
     'memory'?: string;
     /**
-     * class code of the cluster
+     * Class code for component-level vertical scaling.
      * @type {string}
      * @memberof OpsVScale
      */

package/src/openapi/models/vip-pool.ts

@@ -32,6 +32,18 @@ export interface VipPool {
      * @memberof VipPool
      */
     'id'?: string;
+    /**
+     * Name of VIP Pool. It is the MetalLB IPAddressPool resource name, generated as kb-<id>.
+     * @type {string}
+     * @memberof VipPool
+     */
+    'name'?: string;
+    /**
+     * User facing name of the VIP Pool, used to select the pool when creating a cluster. It falls back to the IPAddressPool resource name.
+     * @type {string}
+     * @memberof VipPool
+     */
+    'poolName'?: string;
     /**
      * Total number of IP addresses
      * @type {number}

package/src/openapi.yaml

@@ -24661,6 +24661,14 @@ components:
           description: ID of VIP Pool
           title: ID
           type: string
+        name:
+          description: Name of VIP Pool. It is the MetalLB IPAddressPool resource name, generated as kb-<id>.
+          title: Name
+          type: string
+        poolName:
+          description: User facing name of the VIP Pool, used to select the pool when creating a cluster. It falls back to the IPAddressPool resource name.
+          title: Pool Name
+          type: string
         total:
           description: Total number of IP addresses
           format: int64
@@ -25706,6 +25714,48 @@ components:
       enum:
         - DoNotTerminate
         - Delete
+    instanceTemplateCreate:
+      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.
+      required:
+        - name
+        - replicas
+      properties:
+        name:
+          type: string
+          minLength: 1
+          description: Instance template name; must match a chart-rendered instance.
+        replicas:
+          type: integer
+          minimum: 0
+          description: Replica count for this instance template.
+        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.
+          items:
+            type: object
+            required:
+              - name
+              - value
+            properties:
+              name:
+                type: string
+              value:
+                type: string
+                minLength: 1
+                description: Plain string value only. valueFrom is not supported.
+        annotations:
+          type: object
+          additionalProperties:
+            type: string
+          description: Annotation map (string key to string value). Merged into this template; same-name keys overwritten. Chart keys are not deleted.
+        labels:
+          type: object
+          additionalProperties:
+            type: string
+          description: Label map (string key to string value). Merged into this template; same-name keys overwritten. Chart keys are not deleted.
     ioQuantity:
       description: IO Quantity describes IOPS and BPS of a volume
       properties:
@@ -25784,7 +25834,13 @@ components:
           title: Replicas
           type: integer
           x-nullable: true
-          description: Omit to use the cluster chart default. Set zero to disable the component when its resource constraints allow zero replicas.
+          description: Omit to use the cluster chart default. Set zero to disable the component when its resource constraints allow zero replicas. If the rendered component has instance templates, this must equal the sum of all template replica counts in the complete instanceTemplates list.
+        instanceTemplates:
+          type: array
+          minItems: 1
+          description: Per-template replicas and optional overlays (env, annotations, labels). Required when the chart renders instance templates. Names must exactly match all chart-rendered instances, without missing, extra, or duplicate names; order does not matter. Component replicas must equal the sum of all requested instance template replica counts.
+          items:
+            $ref: '#/components/schemas/instanceTemplateCreate'
         skipResourceConstraints:
           type: boolean
           description: Whether to skip resource constraint validation when creating cluster
@@ -26065,6 +26121,10 @@ components:
         networkMode:
           description: Specify the network mode for intra-cluster communication
           $ref: '#/components/schemas/networkMode'
+        vipPoolName:
+          title: VIP Pool Name
+          description: Name of the VIP Pool (VIP Pool poolName) used as the MetalLB address pool for LoadBalancer services. Only effective when networkMode is LoadBalancer.
+          type: string
         serviceRefs:
           type: array
           items:
@@ -26688,8 +26748,23 @@ components:
           x-nullable: true
       required:
         - type
+    instanceTemplateReplicas:
+      type: object
+      description: HScale assignment for one instance template. name and replicas only.
+      required:
+        - name
+        - replicas
+      properties:
+        name:
+          type: string
+          minLength: 1
+          description: Instance template name on the live Cluster spec.
+        replicas:
+          type: integer
+          minimum: 0
+          description: Target replica count for this instance template.
     opsHScale:
-      description: OpsHScale is the payload to horizontally scale a KubeBlocks cluster. It requires specifying either the number of replicas or the number of shards.
+      description: OpsHScale is the payload to horizontally scale a KubeBlocks cluster. Specify replicas or shards. instanceTemplates is an optional overlay and requires top-level replicas.
       required:
         - component
       properties:
@@ -26705,6 +26780,12 @@ components:
           description: number of replicas
           type: integer
           nullable: true
+        instanceTemplates:
+          type: array
+          minItems: 1
+          description: Target replica count for named instance templates. Requires top-level replicas. Mapped onto the live Cluster spec to build scaleIn/scaleOut.instances. Required for replica scaling when the live component has instance templates. Names must exactly match all live instance templates, without missing, extra, or duplicate names; order does not matter. Top-level replicas must equal the sum of all requested template replica counts. Shard-count scaling does not check templates and cannot include this list.
+          items:
+            $ref: '#/components/schemas/instanceTemplateReplicas'
         onlineInstancesToOffline:
           type: array
           items:
@@ -27665,7 +27746,7 @@ components:
           description: memory size
           type: string
         classCode:
-          description: class code of the cluster
+          description: Class code for component-level vertical scaling.
           type: string
         schedule:
           $ref: '#/components/schemas/taskSchedule'
@@ -32856,6 +32937,39 @@ components:
       enum:
         - '0.9'
         - '1.0'
+    instanceTemplateOp:
+      type: string
+      description: Operation that can be declared on instanceTemplate.ops.
+      enum:
+        - hscale
+        - vscale
+    instanceTemplateAttribute:
+      type: string
+      description: Heterogeneous attribute the frontend may render on an instance template at create.
+      enum:
+        - env
+        - annotations
+        - labels
+    instanceTemplateEnv:
+      type: object
+      description: One fillable env var on an instance template, for frontend rendering.
+      required:
+        - name
+      properties:
+        name:
+          type: string
+          minLength: 1
+          description: Env var name written to the instance template.
+        label:
+          $ref: '#/components/schemas/localizedDescription'
+        description:
+          $ref: '#/components/schemas/localizedDescription'
+        required:
+          type: boolean
+          description: If true, the frontend should treat this env as required. Create does not re-check.
+        default:
+          type: string
+          description: Default value shown by the frontend.
     modeReadonlyEndpoint:
       type: object
       required:
@@ -32877,6 +32991,64 @@ components:
           type: boolean
         hideOnCreate:
           type: boolean
+        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.
+          required:
+            - names
+            - ops
+          properties:
+            names:
+              type: array
+              minItems: 1
+              uniqueItems: true
+              items:
+                type: string
+              description: |
+                Instance template names the frontend should render.
+                Create and hscale check names against the chart or live Cluster,
+                not 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.
+            attributes:
+              type: array
+              uniqueItems: true
+              items:
+                $ref: '#/components/schemas/instanceTemplateAttribute'
+              description: |
+                Heterogeneous attributes the frontend should render on each
+                instance template at create. Omitted or empty means only name
+                and replicas. Create overlays the request onto the chart and
+                does not re-check this list.
+            env:
+              type: array
+              description: |
+                Env vars the frontend may render when attributes includes env.
+                Create does not re-check this list.
+              items:
+                $ref: '#/components/schemas/instanceTemplateEnv'
         serviceRef:
           type: string
           description: |