kb-cloud-client-typescript 2.3.28 → 2.3.30

package/src/adminapi.yaml

@@ -16169,7 +16169,8 @@ paths:
       tags:
         - inspection
       operationId: createInspectionTaskByOrg
-      summary: create inspection task by org
+      summary: Trigger inspection for selected clusters in an organization
+      description: Creates one inspection task per matching non-stopped cluster in the path organization. Omit engines or pass an empty array to select all engines. Omit clusterIDs or pass an empty array to select all clusters. When both arrays are non-empty, clusters must match both filters. All tasks and items are persisted in one transaction before asynchronous execution starts.
       parameters:
         - description: name of the Org
           in: path
@@ -16181,12 +16182,14 @@ paths:
         content:
           application/json:
             schema:
-              $ref: '#/components/schemas/inspectionTask'
+              $ref: '#/components/schemas/inspectionTaskCreate'
         required: true
       responses:
         '204':
-          description: No content.
+          description: Inspection tasks created and accepted for asynchronous execution.
           content: {}
+        '400':
+          description: Invalid request, invalid cluster selection, or no eligible clusters.
         '401':
           $ref: '#/components/responses/401'
         '403':
@@ -16871,6 +16874,78 @@ paths:
           $ref: '#/components/responses/500'
       tags:
         - instance
+  /admin/v1/dashboardConfigs/{key}:
+    get:
+      parameters:
+        - $ref: '#/components/parameters/dashboardConfigKey'
+      tags:
+        - dashboardConfig
+      operationId: getDashboardConfig
+      summary: Get dashboard configuration by key
+      description: Requires platform configuration read access. Missing keys return 200 with a null value.
+      responses:
+        '200':
+          description: Stored configuration or a null value for a missing key.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/dashboardConfig'
+        '400':
+          $ref: '#/components/responses/400'
+        '401':
+          $ref: '#/components/responses/401'
+        '403':
+          $ref: '#/components/responses/403'
+        '500':
+          $ref: '#/components/responses/500'
+    put:
+      parameters:
+        - $ref: '#/components/parameters/dashboardConfigKey'
+      tags:
+        - dashboardConfig
+      operationId: putDashboardConfig
+      summary: Create or replace dashboard configuration by key
+      description: Requires platform configuration write access. Atomic upsert with last-write-wins semantics. Request body is limited to 1 MiB.
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/dashboardConfigUpdate'
+      responses:
+        '200':
+          description: Saved configuration.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/dashboardConfig'
+        '400':
+          $ref: '#/components/responses/400'
+        '401':
+          $ref: '#/components/responses/401'
+        '403':
+          $ref: '#/components/responses/403'
+        '500':
+          $ref: '#/components/responses/500'
+    delete:
+      parameters:
+        - $ref: '#/components/parameters/dashboardConfigKey'
+      tags:
+        - dashboardConfig
+      operationId: deleteDashboardConfig
+      summary: Delete dashboard configuration by key
+      description: Requires platform configuration write access. Deleting a missing key succeeds.
+      responses:
+        '204':
+          description: Configuration is absent.
+        '400':
+          $ref: '#/components/responses/400'
+        '401':
+          $ref: '#/components/responses/401'
+        '403':
+          $ref: '#/components/responses/403'
+        '500':
+          $ref: '#/components/responses/500'
   /admin/v1/platformParameters:
     get:
       tags:
@@ -17727,18 +17802,538 @@ paths:
         '500':
           $ref: '#/components/responses/500'
       tags:
-        - environment
-  /admin/v1/environments/optional-modules:
-    get:
-      operationId: getOptionalEnvironmentModules
-      summary: get option environment module info
+        - environment
+  /admin/v1/environments/optional-modules:
+    get:
+      operationId: getOptionalEnvironmentModules
+      summary: get option environment module info
+      responses:
+        '200':
+          description: Success
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/environmentModuleList'
+        '400':
+          $ref: '#/components/responses/400'
+        '401':
+          $ref: '#/components/responses/401'
+        '403':
+          $ref: '#/components/responses/403'
+        '404':
+          $ref: '#/components/responses/404'
+        '409':
+          $ref: '#/components/responses/409'
+        '429':
+          $ref: '#/components/responses/429'
+        '500':
+          $ref: '#/components/responses/500'
+      tags:
+        - environment
+  /admin/v1/platformComponents:
+    get:
+      description: List platform components with monitoring and log query metadata
+      summary: List platform components
+      operationId: listPlatformComponents
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/platformComponentList'
+          description: OK
+        '401':
+          $ref: '#/components/responses/401'
+        '403':
+          $ref: '#/components/responses/403'
+      tags:
+        - platformComponent
+  /admin/v1/platformComponents/{componentName}:
+    get:
+      description: Get platform component detail by name, including monitoring and log query metadata
+      summary: Get platform component detail
+      operationId: getPlatformComponent
+      parameters:
+        - in: path
+          name: componentName
+          required: true
+          description: Platform component name
+          schema:
+            type: string
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/platformComponentDetails'
+          description: OK
+        '401':
+          $ref: '#/components/responses/401'
+        '403':
+          $ref: '#/components/responses/403'
+        '404':
+          $ref: '#/components/responses/404'
+      tags:
+        - platformComponent
+  /admin/v1/data/{engineName}/organizations/{orgName}/clusters/{clusterName}/computeGroups:
+    get:
+      tags:
+        - computeGroup
+      operationId: listComputeGroups
+      summary: List compute groups
+      parameters:
+        - name: engineName
+          in: path
+          required: true
+          description: Supported engine name (doris or selectdb).
+          schema:
+            type: string
+        - name: orgName
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: clusterName
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        '200':
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/computeGroupList'
+        '400':
+          $ref: '#/components/responses/400'
+        '401':
+          $ref: '#/components/responses/401'
+        '403':
+          $ref: '#/components/responses/403'
+        '404':
+          $ref: '#/components/responses/404'
+        '409':
+          $ref: '#/components/responses/409'
+        '500':
+          $ref: '#/components/responses/500'
+    post:
+      tags:
+        - computeGroup
+      operationId: createComputeGroup
+      summary: Create compute group
+      parameters:
+        - name: engineName
+          in: path
+          required: true
+          description: Supported engine name (doris or selectdb).
+          schema:
+            type: string
+        - name: orgName
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: clusterName
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        '202':
+          description: Accepted; poll taskId for convergence.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/opsRequestName'
+        '400':
+          $ref: '#/components/responses/400'
+        '401':
+          $ref: '#/components/responses/401'
+        '403':
+          $ref: '#/components/responses/403'
+        '404':
+          $ref: '#/components/responses/404'
+        '409':
+          $ref: '#/components/responses/409'
+        '500':
+          $ref: '#/components/responses/500'
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/computeGroupCreate'
+  /admin/v1/data/{engineName}/organizations/{orgName}/clusters/{clusterName}/computeGroups/{groupName}:
+    get:
+      tags:
+        - computeGroup
+      operationId: getComputeGroup
+      summary: Get compute group
+      parameters:
+        - name: engineName
+          in: path
+          required: true
+          description: Supported engine name (doris or selectdb).
+          schema:
+            type: string
+        - name: orgName
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: clusterName
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: groupName
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        '200':
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/computeGroup'
+        '400':
+          $ref: '#/components/responses/400'
+        '401':
+          $ref: '#/components/responses/401'
+        '403':
+          $ref: '#/components/responses/403'
+        '404':
+          $ref: '#/components/responses/404'
+        '409':
+          $ref: '#/components/responses/409'
+        '500':
+          $ref: '#/components/responses/500'
+    delete:
+      tags:
+        - computeGroup
+      operationId: deleteComputeGroup
+      summary: Delete compute group
+      parameters:
+        - name: engineName
+          in: path
+          required: true
+          description: Supported engine name (doris or selectdb).
+          schema:
+            type: string
+        - name: orgName
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: clusterName
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: groupName
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        '202':
+          description: Accepted; poll taskId for convergence.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/opsRequestName'
+        '400':
+          $ref: '#/components/responses/400'
+        '401':
+          $ref: '#/components/responses/401'
+        '403':
+          $ref: '#/components/responses/403'
+        '404':
+          $ref: '#/components/responses/404'
+        '409':
+          $ref: '#/components/responses/409'
+        '500':
+          $ref: '#/components/responses/500'
+  /admin/v1/data/{engineName}/organizations/{orgName}/clusters/{clusterName}/computeGroups/{groupName}/scale:
+    post:
+      tags:
+        - computeGroup
+      operationId: scaleComputeGroup
+      summary: Scale compute group
+      parameters:
+        - name: engineName
+          in: path
+          required: true
+          description: Supported engine name (doris or selectdb).
+          schema:
+            type: string
+        - name: orgName
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: clusterName
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: groupName
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        '202':
+          description: Accepted; poll taskId for convergence.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/opsRequestName'
+        '400':
+          $ref: '#/components/responses/400'
+        '401':
+          $ref: '#/components/responses/401'
+        '403':
+          $ref: '#/components/responses/403'
+        '404':
+          $ref: '#/components/responses/404'
+        '409':
+          $ref: '#/components/responses/409'
+        '500':
+          $ref: '#/components/responses/500'
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/computeGroupScale'
+  /admin/v1/data/{engineName}/organizations/{orgName}/clusters/{clusterName}/computeGroups/{groupName}/start:
+    post:
+      tags:
+        - computeGroup
+      operationId: startComputeGroup
+      summary: Start compute group
+      parameters:
+        - name: engineName
+          in: path
+          required: true
+          description: Supported engine name (doris or selectdb).
+          schema:
+            type: string
+        - name: orgName
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: clusterName
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: groupName
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        '202':
+          description: Accepted; poll taskId for convergence.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/opsRequestName'
+        '400':
+          $ref: '#/components/responses/400'
+        '401':
+          $ref: '#/components/responses/401'
+        '403':
+          $ref: '#/components/responses/403'
+        '404':
+          $ref: '#/components/responses/404'
+        '409':
+          $ref: '#/components/responses/409'
+        '500':
+          $ref: '#/components/responses/500'
+  /admin/v1/data/{engineName}/organizations/{orgName}/clusters/{clusterName}/computeGroups/{groupName}/stop:
+    post:
+      tags:
+        - computeGroup
+      operationId: stopComputeGroup
+      summary: Stop compute group
+      parameters:
+        - name: engineName
+          in: path
+          required: true
+          description: Supported engine name (doris or selectdb).
+          schema:
+            type: string
+        - name: orgName
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: clusterName
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: groupName
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        '202':
+          description: Accepted; poll taskId for convergence.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/opsRequestName'
+        '400':
+          $ref: '#/components/responses/400'
+        '401':
+          $ref: '#/components/responses/401'
+        '403':
+          $ref: '#/components/responses/403'
+        '404':
+          $ref: '#/components/responses/404'
+        '409':
+          $ref: '#/components/responses/409'
+        '500':
+          $ref: '#/components/responses/500'
+  /admin/v1/data/{engineName}/organizations/{orgName}/clusters/{clusterName}/computeGroups/{groupName}/accounts:
+    get:
+      tags:
+        - computeGroup
+      operationId: listComputeGroupAccounts
+      summary: List compute group accounts
+      parameters:
+        - name: engineName
+          in: path
+          required: true
+          description: Supported engine name (doris or selectdb).
+          schema:
+            type: string
+        - name: orgName
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: clusterName
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: groupName
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        '200':
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/computeGroupAccountList'
+        '400':
+          $ref: '#/components/responses/400'
+        '401':
+          $ref: '#/components/responses/401'
+        '403':
+          $ref: '#/components/responses/403'
+        '404':
+          $ref: '#/components/responses/404'
+        '409':
+          $ref: '#/components/responses/409'
+        '500':
+          $ref: '#/components/responses/500'
+  /admin/v1/data/{engineName}/organizations/{orgName}/clusters/{clusterName}/computeGroups/{groupName}/accounts/{accountName}:
+    put:
+      tags:
+        - computeGroup
+      operationId: grantComputeGroupAccount
+      summary: Grant compute group account
+      parameters:
+        - name: engineName
+          in: path
+          required: true
+          description: Supported engine name (doris or selectdb).
+          schema:
+            type: string
+        - name: orgName
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: clusterName
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: groupName
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: accountName
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        '204':
+          description: Updated
+        '400':
+          $ref: '#/components/responses/400'
+        '401':
+          $ref: '#/components/responses/401'
+        '403':
+          $ref: '#/components/responses/403'
+        '404':
+          $ref: '#/components/responses/404'
+        '409':
+          $ref: '#/components/responses/409'
+        '500':
+          $ref: '#/components/responses/500'
+    delete:
+      tags:
+        - computeGroup
+      operationId: revokeComputeGroupAccount
+      summary: Revoke compute group account
+      parameters:
+        - name: engineName
+          in: path
+          required: true
+          description: Supported engine name (doris or selectdb).
+          schema:
+            type: string
+        - name: orgName
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: clusterName
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: groupName
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: accountName
+          in: path
+          required: true
+          schema:
+            type: string
       responses:
-        '200':
-          description: Success
-          content:
-            application/json:
-              schema:
-                $ref: '#/components/schemas/environmentModuleList'
+        '204':
+          description: Updated
         '400':
           $ref: '#/components/responses/400'
         '401':
@@ -17749,57 +18344,56 @@ paths:
           $ref: '#/components/responses/404'
         '409':
           $ref: '#/components/responses/409'
-        '429':
-          $ref: '#/components/responses/429'
         '500':
           $ref: '#/components/responses/500'
+  /admin/v1/data/{engineName}/organizations/{orgName}/clusters/{clusterName}/computeGroups/{groupName}/accounts/{accountName}/default:
+    put:
       tags:
-        - environment
-  /admin/v1/platformComponents:
-    get:
-      description: List platform components with monitoring and log query metadata
-      summary: List platform components
-      operationId: listPlatformComponents
-      responses:
-        '200':
-          content:
-            application/json:
-              schema:
-                $ref: '#/components/schemas/platformComponentList'
-          description: OK
-        '401':
-          $ref: '#/components/responses/401'
-        '403':
-          $ref: '#/components/responses/403'
-      tags:
-        - platformComponent
-  /admin/v1/platformComponents/{componentName}:
-    get:
-      description: Get platform component detail by name, including monitoring and log query metadata
-      summary: Get platform component detail
-      operationId: getPlatformComponent
+        - computeGroup
+      operationId: setDefaultComputeGroup
+      summary: Set default compute group
       parameters:
-        - in: path
-          name: componentName
+        - name: engineName
+          in: path
+          required: true
+          description: Supported engine name (doris or selectdb).
+          schema:
+            type: string
+        - name: orgName
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: clusterName
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: groupName
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: accountName
+          in: path
           required: true
-          description: Platform component name
           schema:
             type: string
       responses:
-        '200':
-          content:
-            application/json:
-              schema:
-                $ref: '#/components/schemas/platformComponentDetails'
-          description: OK
+        '204':
+          description: Updated
+        '400':
+          $ref: '#/components/responses/400'
         '401':
           $ref: '#/components/responses/401'
         '403':
           $ref: '#/components/responses/403'
         '404':
           $ref: '#/components/responses/404'
-      tags:
-        - platformComponent
+        '409':
+          $ref: '#/components/responses/409'
+        '500':
+          $ref: '#/components/responses/500'
   /admin/v1/data/kafka/organizations/{orgName}/clusters/{clusterName}/brokers:
     get:
       summary: Get all brokers in cluster
@@ -41025,6 +41619,35 @@ components:
         timeRangeEnd:
           format: date-time
           type: string
+    inspectionTaskCreate:
+      type: object
+      properties:
+        engines:
+          description: Engine names to inspect in the path organization. Omit or pass an empty array to inspect all engines.
+          type: array
+          uniqueItems: true
+          items:
+            type: string
+            pattern: ^[^,\s]+$
+        clusterIDs:
+          description: Cluster IDs to inspect in the path organization. Omit or pass an empty array to inspect all clusters selected by engines.
+          type: array
+          uniqueItems: true
+          items:
+            type: string
+            pattern: ^[1-9][0-9]*$
+        timeRangeStart:
+          type: string
+          format: date-time
+          description: Start of the inspection window. If either bound is omitted, defaults to the preceding 24 hours.
+        timeRangeEnd:
+          type: string
+          format: date-time
+        savedDays:
+          type: integer
+          format: int64
+          minimum: 0
+          description: Report retention in days. Zero uses the existing default retention policy.
     inspectionTaskFormat:
       description: Specifies the format of the task in the aggregate task result.
       enum:
@@ -41373,6 +41996,27 @@ components:
         isVariable:
           type: boolean
           description: whether the param is tenant variable or param
+    dashboardConfig:
+      type: object
+      required:
+        - key
+      properties:
+        key:
+          type: string
+          description: Frontend-defined platform-wide key. Organization identifiers in this key do not enforce tenant isolation.
+          minLength: 1
+          maxLength: 512
+        value:
+          description: Stored JSON value, or null when the key has no configuration.
+          x-omitempty: false
+    dashboardConfigUpdate:
+      type: object
+      required:
+        - value
+      properties:
+        value:
+          description: Any non-null JSON value. Replaces the complete stored value.
+          x-omitempty: false
     platformParameterCategory:
       type: string
       description: platformParameter category, representing the platformParameter group
@@ -42332,6 +42976,147 @@ components:
       required:
         - name
         - status
+    computeGroupBackend:
+      type: object
+      properties:
+        id:
+          type: string
+          description: Opaque backend ID; do not convert to a JavaScript number.
+        host:
+          type: string
+        heartbeatPort:
+          type: integer
+          format: int64
+        alive:
+          type: boolean
+        decommissioned:
+          type: boolean
+        tabletCount:
+          type: integer
+          format: int64
+        lastHeartbeat:
+          type: string
+        version:
+          type: string
+        errorMessage:
+          type: string
+    computeGroup:
+      type: object
+      properties:
+        name:
+          type: string
+        componentName:
+          type: string
+        managed:
+          type: boolean
+        isDefault:
+          type: boolean
+        phase:
+          type: string
+          description: Kubernetes component phase, independent of engine membership.
+        stopped:
+          type: boolean
+        replicas:
+          type: integer
+          format: int64
+        classCode:
+          type: string
+        cpu:
+          type: number
+        memory:
+          type: number
+        backendCount:
+          type: integer
+          format: int64
+        aliveBackendCount:
+          type: integer
+          format: int64
+        defaultUsers:
+          type: array
+          items:
+            type: string
+        backends:
+          type: array
+          items:
+            $ref: '#/components/schemas/computeGroupBackend'
+        allowedActions:
+          type: array
+          items:
+            type: string
+    computeGroupList:
+      type: object
+      required:
+        - items
+      properties:
+        items:
+          type: array
+          items:
+            $ref: '#/components/schemas/computeGroup'
+        managementSupported:
+          type: boolean
+        unsupportedReason:
+          type: string
+    computeGroupCreate:
+      type: object
+      required:
+        - name
+        - replicas
+        - classCode
+      properties:
+        name:
+          type: string
+          pattern: ^[A-Za-z][A-Za-z0-9_]{0,63}$
+        replicas:
+          type: integer
+          format: int64
+          minimum: 1
+          maximum: 1000
+        classCode:
+          type: string
+          minLength: 1
+          maxLength: 128
+      additionalProperties: false
+    computeGroupScale:
+      type: object
+      properties:
+        replicas:
+          x-nullable: true
+          type: integer
+          format: int64
+          minimum: 1
+          maximum: 1000
+        classCode:
+          type: string
+          minLength: 1
+          maxLength: 128
+      additionalProperties: false
+    computeGroupAccount:
+      type: object
+      properties:
+        identity:
+          type: string
+        accountName:
+          type: string
+        manageable:
+          type: boolean
+        globalGrants:
+          type: string
+        computeGrants:
+          type: string
+        roles:
+          type: string
+        isDefault:
+          type: boolean
+      description: Grants reported by the engine can include role inheritance. Revoking a direct grant does not remove inherited permissions.
+    computeGroupAccountList:
+      type: object
+      required:
+        - items
+      properties:
+        items:
+          type: array
+          items:
+            $ref: '#/components/schemas/computeGroupAccount'
     Broker:
       x-go-name: KafkaBroker
       type: object
@@ -48287,6 +49072,15 @@ components:
       name: query
       schema:
         type: string
+    dashboardConfigKey:
+      in: path
+      name: key
+      required: true
+      description: Frontend-defined non-blank configuration key, up to 512 Unicode characters. URL-encode the key when used in a request path.
+      schema:
+        type: string
+        minLength: 1
+        maxLength: 512
 x-tagGroups:
   - name: User
     tags: