kb-cloud-client-typescript 2.3.12 → 2.3.14

package/src/adminapi.yaml

@@ -28874,6 +28874,11 @@ components:
             type: string
           description: Specify parameters list to be updated
           type: object
+        parametersToRemove:
+          description: Specify parameters list to be removed from the template
+          items:
+            type: string
+          type: array
         newParamTplName:
           description: Specify the new name of the parameter template
           type: string
@@ -32339,11 +32344,11 @@ components:
                 type: integer
         loadBalancerIP:
           type: string
-          description: The IP address of the LoadBalancer service. If not set, the IP address will be assigned by the system. Only available when vpcServiceType is LoadBalancer.
+          description: The requested IPv4 or IPv6 address of the LoadBalancer service. If not set, IP addresses will be assigned by the system. For dual-stack MetalLB services, the system allocates the missing address family from the same VIP pool. Only available when vpcServiceType is LoadBalancer.
           nullable: true
         loadBalancerIPPoolID:
           type: string
-          description: The IP pool ID of the LoadBalancer service. If not set, the IP pool will be assigned by the system. Only available when vpcServiceType is LoadBalancer.
+          description: The IP pool ID of the LoadBalancer service. If not set, the IP pool will be assigned by the system. All VIPs of a dual-stack MetalLB service are allocated from the same pool. Only available when vpcServiceType is LoadBalancer.
           nullable: true
         domain:
           type: string
@@ -33870,7 +33875,7 @@ components:
           items:
             type: string
         availableIPs:
-          description: Used IP addresses
+          description: Available IP address candidates, limited to 4096 per pool. IPv4 and IPv6 share the limit equally, with unused slots reassigned to the other family. Large pools return a partial list.
           type: array
           items:
             type: string
@@ -39240,14 +39245,22 @@ components:
         - vacuumWraparound
         - backup
         - security
+    inspectionEvaluationMode:
+      type: string
+      description: Empty legacy values mean check. Display collects information without scoring. Manual requires type=manual and presents scriptExpr verbatim as instructions; it executes no SQL or templates, returns severity=unknown, and retains rule importance.
+      enum:
+        - check
+        - display
+        - manual
     inspectionCriticality:
       type: string
-      description: First-version criticality assumption for score weighting and red-item veto behavior. Missing legacy values are treated as medium.
+      description: Rule importance used for score weighting. Info marks automatically collected information excluded from scoring. Manual items retain their importance but return unknown and are not scored. Missing legacy values normally default to medium; cluster and node status default to critical.
       enum:
         - critical
         - high
         - medium
         - low
+        - info
     inspectionThresholdDirection:
       type: string
       description: Direction used to interpret warnThreshold and critThreshold. asc means larger values are worse, desc means smaller values are worse, boolean means the check expression decides.
@@ -39276,7 +39289,7 @@ components:
           description: The engine type this script is applicable to, such as cluster, mysql, node
           type: string
         type:
-          description: The type of the script, such as "promQL"
+          description: The type of the script, such as "promQL" or "manual" (requires evaluationMode=manual)
           type: string
         category:
           $ref: '#/components/schemas/inspectionScriptCategory'
@@ -39284,6 +39297,9 @@ components:
           $ref: '#/components/schemas/localizedDescription'
         scriptExpr:
           type: string
+          description: Collector expression for automatic modes; complete user instructions (up to 8192 UTF-8 bytes) for manual mode. Manual placeholders are not rendered.
+        evaluationMode:
+          $ref: '#/components/schemas/inspectionEvaluationMode'
         checkExpr:
           type: string
         criticality:
@@ -39399,29 +39415,35 @@ components:
           $ref: '#/components/schemas/localizedDescription'
         scriptCategory:
           type: string
+          description: Category used to group inspection items, such as availability, performance, capacity, or backup.
         resourceType:
           type: string
+          description: Type of the inspected resource, such as cluster or node; resourceID and resourceName identify the target.
         resourceID:
           type: string
         resourceName:
           type: string
         status:
           type: string
+          description: Execution state, such as Running, Completed, or Failed. Use severity for the health conclusion. For manual items, Completed means instructions are available, not that the user has performed them.
         result:
           type: string
+          description: Textual observation or execution message for display. It may contain nonnumeric information or an error; use severity for the health conclusion. Manual instructions are stored in evidence.ruleSnapshot.scriptExpr.
         valueNum:
           type: number
           format: double
           x-nullable: true
-          description: Numeric form of result when the result is parseable.
+          description: Numeric observation when available, including numeric information collected by info items. Omitted when no numeric observation exists, including manual guidance. Use with unit and thresholds for numeric displays.
         warnThreshold:
           type: number
           format: double
           x-nullable: true
+          description: Warning threshold interpreted using direction and the same unit as valueNum. Omitted when no numeric warning threshold is configured.
         critThreshold:
           type: number
           format: double
           x-nullable: true
+          description: Critical threshold interpreted using direction and the same unit as valueNum. Omitted when no numeric critical threshold is configured.
         direction:
           $ref: '#/components/schemas/inspectionThresholdDirection'
         criticality:
@@ -39436,10 +39458,13 @@ components:
           $ref: '#/components/schemas/localizedDescription'
         docLink:
           type: string
+          description: Link to documentation explaining this inspection item and recommended actions.
         severity:
           type: string
+          description: 'Health conclusion: red (critical), yellow (warning), green (healthy), unknown (cannot evaluate), or info (automatically collected information). Manual guidance returns unknown and retains its criticality. Unknown and info do not contribute to health scoring; Completed for manual guidance means instructions are available, not user completion.'
         unit:
           type: string
+          description: Display unit for the inspection result and thresholds, such as percent, seconds, or bytes. Empty when no unit applies.
         createdAt:
           format: date-time
           type: string
@@ -39481,7 +39506,7 @@ components:
           type: integer
           format: int64
           x-nullable: true
-          description: Weighted health score from 0 to 100 over evaluable inspection items only. Unknown items are excluded from both the numerator and denominator. The field is omitted when no item is evaluable; a present value of 0 is a valid evaluated score.
+          description: Weighted health score from 0 to 100 over evaluable inspection items only. Unknown results and items with info importance are excluded from both the numerator and denominator. The field is omitted when no item is evaluable; a present value of 0 is a valid evaluated score.
         result:
           type: string
           description: Task health conclusion derived from evaluable item states and criticality-aware score caps. Valid conclusions are red, yellow, green, and unknown. Unknown means no item is evaluable. Unknown items remain visible in the item list but do not override a red, yellow, or green conclusion derived from evaluable items.

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

@@ -544,6 +544,7 @@ models/init-option-item.ts
 models/init-option-object.ts
 models/init-option-type.ts
 models/inspection-criticality.ts
+models/inspection-evaluation-mode.ts
 models/inspection-script-category.ts
 models/inspection-script.ts
 models/inspection-task-format.ts

package/src/openapi/models/index.ts

@@ -453,6 +453,7 @@ export * from './init-option-item';
 export * from './init-option-object';
 export * from './init-option-type';
 export * from './inspection-criticality';
+export * from './inspection-evaluation-mode';
 export * from './inspection-script';
 export * from './inspection-script-category';
 export * from './inspection-task';

package/src/openapi/models/inspection-criticality.ts

@@ -15,7 +15,7 @@
 
 
 /**
- * First-version criticality assumption for score weighting and red-item veto behavior. Missing legacy values are treated as medium.
+ * Rule importance used for score weighting. Info marks automatically collected information excluded from scoring. Manual items retain their importance but return unknown and are not scored. Missing legacy values normally default to medium; cluster and node status default to critical.
  * @export
  * @enum {string}
  */
@@ -24,7 +24,8 @@ export const InspectionCriticality = {
     critical: 'critical',
     high: 'high',
     medium: 'medium',
-    low: 'low'
+    low: 'low',
+    info: 'info'
 } as const;
 
 export type InspectionCriticality = typeof InspectionCriticality[keyof typeof InspectionCriticality];

package/src/openapi/models/inspection-evaluation-mode.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.
+ */
+
+
+
+/**
+ * Empty legacy values mean check. Display collects information without scoring. Manual requires type=manual and presents scriptExpr verbatim as instructions; it executes no SQL or templates, returns severity=unknown, and retains rule importance.
+ * @export
+ * @enum {string}
+ */
+
+export const InspectionEvaluationMode = {
+    check: 'check',
+    display: 'display',
+    manual: 'manual'
+} as const;
+
+export type InspectionEvaluationMode = typeof InspectionEvaluationMode[keyof typeof InspectionEvaluationMode];
+
+
+

package/src/openapi/models/inspection-script.ts

@@ -18,6 +18,9 @@
 import type { InspectionCriticality } from './inspection-criticality';
 // May contain unused imports in some cases
 // @ts-ignore
+import type { InspectionEvaluationMode } from './inspection-evaluation-mode';
+// May contain unused imports in some cases
+// @ts-ignore
 import type { InspectionScriptCategory } from './inspection-script-category';
 // May contain unused imports in some cases
 // @ts-ignore
@@ -57,7 +60,7 @@ export interface InspectionScript {
      */
     'engine': string;
     /**
-     * The type of the script, such as \"promQL\"
+     * The type of the script, such as \"promQL\" or \"manual\" (requires evaluationMode=manual)
      * @type {string}
      * @memberof InspectionScript
      */
@@ -75,11 +78,17 @@ export interface InspectionScript {
      */
     'description'?: LocalizedDescription;
     /**
-     * 
+     * Collector expression for automatic modes; complete user instructions (up to 8192 UTF-8 bytes) for manual mode. Manual placeholders are not rendered.
      * @type {string}
      * @memberof InspectionScript
      */
     'scriptExpr': string;
+    /**
+     * 
+     * @type {InspectionEvaluationMode}
+     * @memberof InspectionScript
+     */
+    'evaluationMode'?: InspectionEvaluationMode;
     /**
      * 
      * @type {string}

package/src/openapi/models/inspection-task-item.ts

@@ -60,13 +60,13 @@ export interface InspectionTaskItem {
      */
     'scriptDescription'?: LocalizedDescription;
     /**
-     * 
+     * Category used to group inspection items, such as availability, performance, capacity, or backup.
      * @type {string}
      * @memberof InspectionTaskItem
      */
     'scriptCategory'?: string;
     /**
-     * 
+     * Type of the inspected resource, such as cluster or node; resourceID and resourceName identify the target.
      * @type {string}
      * @memberof InspectionTaskItem
      */
@@ -84,31 +84,31 @@ export interface InspectionTaskItem {
      */
     'resourceName'?: string;
     /**
-     * 
+     * Execution state, such as Running, Completed, or Failed. Use severity for the health conclusion. For manual items, Completed means instructions are available, not that the user has performed them.
      * @type {string}
      * @memberof InspectionTaskItem
      */
     'status'?: string;
     /**
-     * 
+     * Textual observation or execution message for display. It may contain nonnumeric information or an error; use severity for the health conclusion. Manual instructions are stored in evidence.ruleSnapshot.scriptExpr.
      * @type {string}
      * @memberof InspectionTaskItem
      */
     'result'?: string;
     /**
-     * Numeric form of result when the result is parseable.
+     * Numeric observation when available, including numeric information collected by info items. Omitted when no numeric observation exists, including manual guidance. Use with unit and thresholds for numeric displays.
      * @type {number}
      * @memberof InspectionTaskItem
      */
     'valueNum'?: number | null;
     /**
-     * 
+     * Warning threshold interpreted using direction and the same unit as valueNum. Omitted when no numeric warning threshold is configured.
      * @type {number}
      * @memberof InspectionTaskItem
      */
     'warnThreshold'?: number | null;
     /**
-     * 
+     * Critical threshold interpreted using direction and the same unit as valueNum. Omitted when no numeric critical threshold is configured.
      * @type {number}
      * @memberof InspectionTaskItem
      */
@@ -144,19 +144,19 @@ export interface InspectionTaskItem {
      */
     'remediation'?: LocalizedDescription;
     /**
-     * 
+     * Link to documentation explaining this inspection item and recommended actions.
      * @type {string}
      * @memberof InspectionTaskItem
      */
     'docLink'?: string;
     /**
-     * 
+     * Health conclusion: red (critical), yellow (warning), green (healthy), unknown (cannot evaluate), or info (automatically collected information). Manual guidance returns unknown and retains its criticality. Unknown and info do not contribute to health scoring; Completed for manual guidance means instructions are available, not user completion.
      * @type {string}
      * @memberof InspectionTaskItem
      */
     'severity'?: string;
     /**
-     * 
+     * Display unit for the inspection result and thresholds, such as percent, seconds, or bytes. Empty when no unit applies.
      * @type {string}
      * @memberof InspectionTaskItem
      */

package/src/openapi/models/inspection-task.ts

@@ -102,7 +102,7 @@ export interface InspectionTask {
      */
     'expiredAt'?: string;
     /**
-     * Weighted health score from 0 to 100 over evaluable inspection items only. Unknown items are excluded from both the numerator and denominator. The field is omitted when no item is evaluable; a present value of 0 is a valid evaluated score.
+     * Weighted health score from 0 to 100 over evaluable inspection items only. Unknown results and items with info importance are excluded from both the numerator and denominator. The field is omitted when no item is evaluable; a present value of 0 is a valid evaluated score.
      * @type {number}
      * @memberof InspectionTask
      */

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

@@ -66,13 +66,13 @@ export interface OpsExpose {
      */
     'portsMapping'?: Array<OpsExposePortsMappingInner>;
     /**
-     * The IP address of the LoadBalancer service. If not set, the IP address will be assigned by the system. Only available when vpcServiceType is LoadBalancer.
+     * The requested IPv4 or IPv6 address of the LoadBalancer service. If not set, IP addresses will be assigned by the system. For dual-stack MetalLB services, the system allocates the missing address family from the same VIP pool. Only available when vpcServiceType is LoadBalancer.
      * @type {string}
      * @memberof OpsExpose
      */
     'loadBalancerIP'?: string | null;
     /**
-     * The IP pool ID of the LoadBalancer service. If not set, the IP pool will be assigned by the system. Only available when vpcServiceType is LoadBalancer.
+     * The IP pool ID of the LoadBalancer service. If not set, the IP pool will be assigned by the system. All VIPs of a dual-stack MetalLB service are allocated from the same pool. Only available when vpcServiceType is LoadBalancer.
      * @type {string}
      * @memberof OpsExpose
      */

package/src/openapi/models/param-tpl-update.ts

@@ -32,6 +32,12 @@ export interface ParamTplUpdate {
      * @memberof ParamTplUpdate
      */
     'parameters'?: { [key: string]: string; };
+    /**
+     * Specify parameters list to be removed from the template
+     * @type {Array<string>}
+     * @memberof ParamTplUpdate
+     */
+    'parametersToRemove'?: Array<string>;
     /**
      * Specify the new name of the parameter template
      * @type {string}

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

@@ -51,7 +51,7 @@ export interface VipPool {
      */
     'usedIPs'?: Array<string>;
     /**
-     * Used IP addresses
+     * Available IP address candidates, limited to 4096 per pool. IPv4 and IPv6 share the limit equally, with unused slots reassigned to the other family. Large pools return a partial list.
      * @type {Array<string>}
      * @memberof VipPool
      */

package/src/openapi.yaml

@@ -22165,7 +22165,7 @@ components:
           items:
             type: string
         availableIPs:
-          description: Used IP addresses
+          description: Available IP address candidates, limited to 4096 per pool. IPv4 and IPv6 share the limit equally, with unused slots reassigned to the other family. Large pools return a partial list.
           type: array
           items:
             type: string
@@ -25211,11 +25211,11 @@ components:
                 type: integer
         loadBalancerIP:
           type: string
-          description: The IP address of the LoadBalancer service. If not set, the IP address will be assigned by the system. Only available when vpcServiceType is LoadBalancer.
+          description: The requested IPv4 or IPv6 address of the LoadBalancer service. If not set, IP addresses will be assigned by the system. For dual-stack MetalLB services, the system allocates the missing address family from the same VIP pool. Only available when vpcServiceType is LoadBalancer.
           nullable: true
         loadBalancerIPPoolID:
           type: string
-          description: The IP pool ID of the LoadBalancer service. If not set, the IP pool will be assigned by the system. Only available when vpcServiceType is LoadBalancer.
+          description: The IP pool ID of the LoadBalancer service. If not set, the IP pool will be assigned by the system. All VIPs of a dual-stack MetalLB service are allocated from the same pool. Only available when vpcServiceType is LoadBalancer.
           nullable: true
         domain:
           type: string
@@ -28454,6 +28454,11 @@ components:
             type: string
           description: Specify parameters list to be updated
           type: object
+        parametersToRemove:
+          description: Specify parameters list to be removed from the template
+          items:
+            type: string
+          type: array
         newParamTplName:
           description: Specify the new name of the parameter template
           type: string
@@ -38201,14 +38206,22 @@ components:
         - vacuumWraparound
         - backup
         - security
+    inspectionEvaluationMode:
+      type: string
+      description: Empty legacy values mean check. Display collects information without scoring. Manual requires type=manual and presents scriptExpr verbatim as instructions; it executes no SQL or templates, returns severity=unknown, and retains rule importance.
+      enum:
+        - check
+        - display
+        - manual
     inspectionCriticality:
       type: string
-      description: First-version criticality assumption for score weighting and red-item veto behavior. Missing legacy values are treated as medium.
+      description: Rule importance used for score weighting. Info marks automatically collected information excluded from scoring. Manual items retain their importance but return unknown and are not scored. Missing legacy values normally default to medium; cluster and node status default to critical.
       enum:
         - critical
         - high
         - medium
         - low
+        - info
     inspectionThresholdDirection:
       type: string
       description: Direction used to interpret warnThreshold and critThreshold. asc means larger values are worse, desc means smaller values are worse, boolean means the check expression decides.
@@ -38237,7 +38250,7 @@ components:
           description: The engine type this script is applicable to, such as cluster, mysql, node
           type: string
         type:
-          description: The type of the script, such as "promQL"
+          description: The type of the script, such as "promQL" or "manual" (requires evaluationMode=manual)
           type: string
         category:
           $ref: '#/components/schemas/inspectionScriptCategory'
@@ -38245,6 +38258,9 @@ components:
           $ref: '#/components/schemas/localizedDescription'
         scriptExpr:
           type: string
+          description: Collector expression for automatic modes; complete user instructions (up to 8192 UTF-8 bytes) for manual mode. Manual placeholders are not rendered.
+        evaluationMode:
+          $ref: '#/components/schemas/inspectionEvaluationMode'
         checkExpr:
           type: string
         criticality:
@@ -38360,29 +38376,35 @@ components:
           $ref: '#/components/schemas/localizedDescription'
         scriptCategory:
           type: string
+          description: Category used to group inspection items, such as availability, performance, capacity, or backup.
         resourceType:
           type: string
+          description: Type of the inspected resource, such as cluster or node; resourceID and resourceName identify the target.
         resourceID:
           type: string
         resourceName:
           type: string
         status:
           type: string
+          description: Execution state, such as Running, Completed, or Failed. Use severity for the health conclusion. For manual items, Completed means instructions are available, not that the user has performed them.
         result:
           type: string
+          description: Textual observation or execution message for display. It may contain nonnumeric information or an error; use severity for the health conclusion. Manual instructions are stored in evidence.ruleSnapshot.scriptExpr.
         valueNum:
           type: number
           format: double
           x-nullable: true
-          description: Numeric form of result when the result is parseable.
+          description: Numeric observation when available, including numeric information collected by info items. Omitted when no numeric observation exists, including manual guidance. Use with unit and thresholds for numeric displays.
         warnThreshold:
           type: number
           format: double
           x-nullable: true
+          description: Warning threshold interpreted using direction and the same unit as valueNum. Omitted when no numeric warning threshold is configured.
         critThreshold:
           type: number
           format: double
           x-nullable: true
+          description: Critical threshold interpreted using direction and the same unit as valueNum. Omitted when no numeric critical threshold is configured.
         direction:
           $ref: '#/components/schemas/inspectionThresholdDirection'
         criticality:
@@ -38397,10 +38419,13 @@ components:
           $ref: '#/components/schemas/localizedDescription'
         docLink:
           type: string
+          description: Link to documentation explaining this inspection item and recommended actions.
         severity:
           type: string
+          description: 'Health conclusion: red (critical), yellow (warning), green (healthy), unknown (cannot evaluate), or info (automatically collected information). Manual guidance returns unknown and retains its criticality. Unknown and info do not contribute to health scoring; Completed for manual guidance means instructions are available, not user completion.'
         unit:
           type: string
+          description: Display unit for the inspection result and thresholds, such as percent, seconds, or bytes. Empty when no unit applies.
         createdAt:
           format: date-time
           type: string
@@ -38442,7 +38467,7 @@ components:
           type: integer
           format: int64
           x-nullable: true
-          description: Weighted health score from 0 to 100 over evaluable inspection items only. Unknown items are excluded from both the numerator and denominator. The field is omitted when no item is evaluable; a present value of 0 is a valid evaluated score.
+          description: Weighted health score from 0 to 100 over evaluable inspection items only. Unknown results and items with info importance are excluded from both the numerator and denominator. The field is omitted when no item is evaluable; a present value of 0 is a valid evaluated score.
         result:
           type: string
           description: Task health conclusion derived from evaluable item states and criticality-aware score caps. Valid conclusions are red, yellow, green, and unknown. Unknown means no item is evaluable. Unknown items remain visible in the item list but do not override a red, yellow, or green conclusion derived from evaluable items.