kb-cloud-client-typescript 2.4.0-alpha.46 → 2.4.0-alpha.48

package/src/adminapi.yaml

@@ -16843,6 +16843,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:
@@ -20751,6 +20823,228 @@ paths:
           $ref: '#/components/responses/404'
         '500':
           $ref: '#/components/responses/500'
+  /admin/v1/data/oracle/organizations/{orgName}/clusters/{clusterName}/tablespaces:
+    get:
+      tags:
+        - oracle
+      summary: List Oracle tablespaces
+      description: List tablespaces for a Oracle cluster.
+      operationId: listOracleTablespaces
+      parameters:
+        - name: orgName
+          in: path
+          required: true
+          schema:
+            type: string
+          description: Organization name
+        - name: clusterName
+          in: path
+          required: true
+          schema:
+            type: string
+          description: Cluster name
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                type: array
+                items:
+                  $ref: '#/components/schemas/OracleTablespace'
+          description: A successful response.
+        '400':
+          $ref: '#/components/responses/400'
+        '401':
+          $ref: '#/components/responses/401'
+        '403':
+          $ref: '#/components/responses/403'
+        '404':
+          $ref: '#/components/responses/404'
+        '500':
+          $ref: '#/components/responses/500'
+    post:
+      tags:
+        - oracle
+      summary: Create Oracle tablespace
+      description: Create tablespace for a Oracle cluster.
+      operationId: createOracleTablespace
+      parameters:
+        - name: orgName
+          in: path
+          required: true
+          schema:
+            type: string
+          description: Organization name
+        - name: clusterName
+          in: path
+          required: true
+          schema:
+            type: string
+          description: Cluster name
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/OracleTablespaceCreate'
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/OracleTablespace'
+          description: A successful response.
+        '400':
+          $ref: '#/components/responses/400'
+        '401':
+          $ref: '#/components/responses/401'
+        '403':
+          $ref: '#/components/responses/403'
+        '404':
+          $ref: '#/components/responses/404'
+        '500':
+          $ref: '#/components/responses/500'
+  /admin/v1/data/oracle/organizations/{orgName}/clusters/{clusterName}/tablespaces/{tablespaceName}:
+    get:
+      tags:
+        - oracle
+      summary: Get Oracle tablespace info
+      operationId: getOracleTablespace
+      parameters:
+        - name: orgName
+          in: path
+          required: true
+          schema:
+            type: string
+          description: Organization name
+        - name: clusterName
+          in: path
+          required: true
+          schema:
+            type: string
+          description: Cluster name
+        - name: tablespaceName
+          in: path
+          required: true
+          schema:
+            type: string
+          description: Tablespace name
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/OracleTablespace'
+          description: A successful response.
+        '400':
+          $ref: '#/components/responses/400'
+        '401':
+          $ref: '#/components/responses/401'
+        '403':
+          $ref: '#/components/responses/403'
+        '404':
+          $ref: '#/components/responses/404'
+        '500':
+          $ref: '#/components/responses/500'
+    delete:
+      tags:
+        - oracle
+      summary: Delete Oracle tablespace
+      description: Delete tablespace for a Oracle cluster.
+      operationId: deleteOracleTablespace
+      parameters:
+        - name: orgName
+          in: path
+          required: true
+          schema:
+            type: string
+          description: Organization name
+        - name: clusterName
+          in: path
+          required: true
+          schema:
+            type: string
+          description: Cluster name
+        - name: tablespaceName
+          in: path
+          required: true
+          schema:
+            type: string
+          description: Tablespace name
+        - name: includingContents
+          in: query
+          schema:
+            type: boolean
+            default: false
+          description: Explicitly delete all objects in the tablespace. Without this flag Oracle rejects nonempty tablespaces.
+        - name: deleteDatafiles
+          in: query
+          schema:
+            type: boolean
+            default: false
+          description: Also remove physical files. Requires includingContents. Otherwise manually managed files are retained.
+      responses:
+        '204':
+          content: {}
+          description: A successful response.
+        '400':
+          $ref: '#/components/responses/400'
+        '401':
+          $ref: '#/components/responses/401'
+        '403':
+          $ref: '#/components/responses/403'
+        '404':
+          $ref: '#/components/responses/404'
+        '500':
+          $ref: '#/components/responses/500'
+    patch:
+      tags:
+        - oracle
+      summary: Expand Oracle tablespace
+      description: Expand one existing datafile/tempfile or add one file in the current container.
+      operationId: expandOracleTablespace
+      parameters:
+        - name: orgName
+          in: path
+          required: true
+          schema:
+            type: string
+          description: Organization name
+        - name: clusterName
+          in: path
+          required: true
+          schema:
+            type: string
+          description: Cluster name
+        - name: tablespaceName
+          in: path
+          required: true
+          schema:
+            type: string
+          description: Tablespace name
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/OracleTablespaceExpand'
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/OracleTablespace'
+          description: A successful response.
+        '400':
+          $ref: '#/components/responses/400'
+        '401':
+          $ref: '#/components/responses/401'
+        '403':
+          $ref: '#/components/responses/403'
+        '404':
+          $ref: '#/components/responses/404'
+        '500':
+          $ref: '#/components/responses/500'
   /admin/v1/data/damengdb/organizations/{orgName}/clusters/{clusterName}/tablespaces:
     get:
       tags:
@@ -22144,13 +22438,13 @@ paths:
         - session
         - rdbms
         - shared
-  /admin/v1/organizations/{orgName}/clusters/{clusterName}/diagnostics/mysql/spaceAnalysis:
+  /admin/v1/organizations/{orgName}/clusters/{clusterName}/diagnostics/mariadb/spaceAnalysis:
     get:
       tags:
         - diagnostics
-      summary: Get MySQL space analysis
-      description: Get a read-only MySQL 5.7, 8.0, or 8.4 compatible space snapshot and fixed backend-owned storage metrics.
-      operationId: getDiagnosticsMysqlSpaceAnalysis
+      summary: Get MariaDB space analysis
+      description: Get a read-only MariaDB compatible space snapshot and fixed backend-owned storage metrics.
+      operationId: getDiagnosticsMariaDBSpaceAnalysis
       parameters:
         - name: orgName
           in: path
@@ -22185,34 +22479,172 @@ paths:
           $ref: '#/components/responses/404'
         '500':
           $ref: '#/components/responses/500'
-  /admin/v1/organizations/{orgName}/clusters/{clusterName}/diagnostics/mssql/sessions:
+  /admin/v1/organizations/{orgName}/clusters/{clusterName}/diagnostics/mariadb/sqlAnalysis:
     get:
       tags:
         - diagnostics
-      operationId: listDiagnosticsMssqlSessions
-      summary: List SQL Server sessions
+      summary: Get MariaDB SQL analysis
+      description: Get a read-only MariaDB SQL fingerprint ranking from Performance Schema statement digests. The response does not expose raw SQL text, time-window aggregation, execution plans, or remediation actions.
+      operationId: getDiagnosticsMariaDBSQLAnalysis
       parameters:
         - name: orgName
           in: path
+          description: Organization name
           required: true
           schema:
             type: string
         - name: clusterName
           in: path
+          description: Cluster name
           required: true
           schema:
             type: string
         - name: limit
           in: query
+          description: Maximum number of SQL fingerprints to return. The backend applies its own upper bound.
           required: false
           schema:
             type: integer
             format: int64
-            minimum: 1
-            maximum: 1000
-            default: 500
-      responses:
-        '200':
+        - name: orderBy
+          in: query
+          description: Sort key. Allowed values are totalTime, meanTime, maxTime, and calls. Defaults to totalTime.
+          required: false
+          schema:
+            type: string
+      responses:
+        '200':
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/mysqlSQLAnalysis'
+        '400':
+          $ref: '#/components/responses/400'
+        '401':
+          $ref: '#/components/responses/401'
+        '403':
+          $ref: '#/components/responses/403'
+        '404':
+          $ref: '#/components/responses/404'
+        '500':
+          $ref: '#/components/responses/500'
+  /admin/v1/organizations/{orgName}/clusters/{clusterName}/diagnostics/mariadb/performanceTrends:
+    get:
+      tags:
+        - diagnostics
+      summary: Get MariaDB performance trends
+      description: Get read-only MariaDB performance trends from backend-owned metrics and database capability checks. The response does not expose SQL, PromQL, internal endpoints, or credentials.
+      operationId: getDiagnosticsMariaDBPerformanceTrends
+      parameters:
+        - name: orgName
+          in: path
+          description: Organization name
+          required: true
+          schema:
+            type: string
+        - name: clusterName
+          in: path
+          description: Cluster name
+          required: true
+          schema:
+            type: string
+        - name: range
+          in: query
+          description: Controlled query range. Allowed values are 1h, 6h, 24h, and 7d. Defaults to 1h.
+          required: false
+          schema:
+            type: string
+        - name: step
+          in: query
+          description: Controlled query granularity. Allowed values are 1m, 5m, 15m, and 1h.
+          required: false
+          schema:
+            type: string
+      responses:
+        '200':
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/performanceTrends'
+        '400':
+          $ref: '#/components/responses/400'
+        '401':
+          $ref: '#/components/responses/401'
+        '403':
+          $ref: '#/components/responses/403'
+        '500':
+          $ref: '#/components/responses/500'
+  /admin/v1/organizations/{orgName}/clusters/{clusterName}/diagnostics/mysql/spaceAnalysis:
+    get:
+      tags:
+        - diagnostics
+      summary: Get MySQL space analysis
+      description: Get a read-only MySQL 5.7, 8.0, or 8.4 compatible space snapshot and fixed backend-owned storage metrics.
+      operationId: getDiagnosticsMysqlSpaceAnalysis
+      parameters:
+        - name: orgName
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: clusterName
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: databaseName
+          in: query
+          description: Optional database name for table and index details. When omitted, the largest non-system database is selected.
+          required: false
+          schema:
+            type: string
+      responses:
+        '200':
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/mysqlSpaceAnalysis'
+        '400':
+          $ref: '#/components/responses/400'
+        '401':
+          $ref: '#/components/responses/401'
+        '403':
+          $ref: '#/components/responses/403'
+        '404':
+          $ref: '#/components/responses/404'
+        '500':
+          $ref: '#/components/responses/500'
+  /admin/v1/organizations/{orgName}/clusters/{clusterName}/diagnostics/mssql/sessions:
+    get:
+      tags:
+        - diagnostics
+      operationId: listDiagnosticsMssqlSessions
+      summary: List SQL Server sessions
+      parameters:
+        - name: orgName
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: clusterName
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: limit
+          in: query
+          required: false
+          schema:
+            type: integer
+            format: int64
+            minimum: 1
+            maximum: 1000
+            default: 500
+      responses:
+        '200':
           description: OK
           content:
             application/json:
@@ -40378,6 +40810,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
@@ -42452,6 +42905,163 @@ components:
       type: array
       items:
         $ref: '#/components/schemas/RbmqExchange'
+    OracleTablespaceFile:
+      type: object
+      required:
+        - id
+        - name
+        - status
+        - allocatedSizeMB
+        - usedSizeMB
+        - autoExtend
+        - nextSizeMB
+        - maxSizeMB
+      properties:
+        id:
+          type: integer
+          format: int64
+        name:
+          type: string
+        status:
+          type: string
+        allocatedSizeMB:
+          type: number
+          format: double
+        usedSizeMB:
+          type: number
+          format: double
+        autoExtend:
+          type: boolean
+        nextSizeMB:
+          type: number
+          format: double
+        maxSizeMB:
+          type: number
+          format: double
+    OracleTablespace:
+      type: object
+      description: Oracle tablespace in the datasource connection's current container. Sizes are in MiB. Supports Oracle 12c and 19c.
+      required:
+        - name
+        - contents
+        - status
+        - bigfile
+        - blockSize
+        - containerName
+        - isDefault
+        - allocatedSizeMB
+        - usedSizeMB
+        - maxSizeMB
+        - files
+      properties:
+        name:
+          type: string
+        contents:
+          type: string
+          description: PERMANENT, TEMPORARY, or UNDO.
+        status:
+          type: string
+        bigfile:
+          type: boolean
+        blockSize:
+          type: integer
+          format: int64
+        containerName:
+          type: string
+        isDefault:
+          type: boolean
+          description: Whether this is a default permanent or temporary tablespace, including default temporary group members.
+        allocatedSizeMB:
+          type: number
+          format: double
+        usedSizeMB:
+          type: number
+          format: double
+          description: Allocated file space minus free extents, or temporary file space currently allocated to temporary segments.
+        maxSizeMB:
+          type: number
+          format: double
+          description: Configured file growth limit; does not imply available disk capacity.
+        files:
+          type: array
+          items:
+            $ref: '#/components/schemas/OracleTablespaceFile'
+    OracleTablespaceContents:
+      type: string
+      enum:
+        - PERMANENT
+        - TEMPORARY
+      description: New tablespaces default to PERMANENT when omitted.
+    OracleTablespaceFileSpec:
+      type: object
+      required:
+        - sizeMB
+      properties:
+        name:
+          type: string
+          description: Absolute database-server file path or ASM destination. Omit to use Oracle Managed Files (DB_CREATE_FILE_DEST must be configured). Existing files are never reused.
+          maxLength: 1024
+        sizeMB:
+          type: integer
+          format: int64
+          minimum: 1
+        autoExtend:
+          type: boolean
+          default: false
+        nextSizeMB:
+          type: integer
+          format: int64
+          minimum: 0
+          description: Required positive increment when autoExtend is true; otherwise omit.
+        maxSizeMB:
+          type: integer
+          format: int64
+          minimum: 0
+          description: Maximum size when autoExtend is true; zero or omitted means UNLIMITED. Otherwise omit.
+    OracleTablespaceCreate:
+      type: object
+      required:
+        - name
+        - files
+      properties:
+        name:
+          type: string
+          pattern: ^[A-Za-z][A-Za-z0-9_$#]{0,29}$
+          description: Converted to uppercase. Limited to 30 ASCII bytes for compatibility with Oracle 12.1.
+        contents:
+          $ref: '#/components/schemas/OracleTablespaceContents'
+        bigfile:
+          type: boolean
+          default: false
+        files:
+          type: array
+          minItems: 1
+          description: Exactly one file for BIGFILE tablespaces.
+          items:
+            $ref: '#/components/schemas/OracleTablespaceFileSpec'
+    OracleTablespaceExpandAction:
+      type: string
+      enum:
+        - resize
+        - addFile
+    OracleTablespaceExpand:
+      type: object
+      description: One DDL operation per request. Use resize with fileId and sizeMB, or addFile with file. Shrinking and adding files to BIGFILE tablespaces are rejected.
+      required:
+        - action
+      properties:
+        action:
+          $ref: '#/components/schemas/OracleTablespaceExpandAction'
+        fileId:
+          type: integer
+          format: int64
+          minimum: 1
+        sizeMB:
+          type: integer
+          format: int64
+          minimum: 1
+        file:
+          $ref: '#/components/schemas/OracleTablespaceFileSpec'
     DmFile:
       type: object
       required:
@@ -42970,10 +43580,351 @@ components:
         collectedAt:
           type: string
           description: Backend collection timestamp in UTC.
-    mssqlRequest:
+    mysqlSQLFingerprint:
       type: object
       required:
-        - requestId
+        - queryID
+        - fingerprint
+        - querySummary
+        - calls
+        - totalTimeMs
+        - meanTimeMs
+        - maxTimeMs
+        - rows
+        - rowsSent
+        - rowsAffected
+        - rowsExamined
+        - lockTimeMs
+        - errors
+        - warnings
+        - tmpTables
+        - tmpDiskTables
+        - noIndexUsed
+        - noGoodIndexUsed
+        - database
+      properties:
+        queryID:
+          type: string
+          description: MySQL Performance Schema DIGEST value.
+        fingerprint:
+          type: string
+          description: Stable SQL fingerprint identifier. M1 uses DIGEST.
+        querySummary:
+          type: string
+          description: Normalized DIGEST_TEXT. Raw SQL text is intentionally not returned.
+        calls:
+          type: integer
+          format: int64
+          description: Number of executions accumulated in the current digest row.
+        totalTimeMs:
+          type: number
+          format: double
+          description: Total statement wait time in milliseconds.
+        meanTimeMs:
+          type: number
+          format: double
+          description: Mean statement wait time in milliseconds.
+        maxTimeMs:
+          type: number
+          format: double
+          description: Maximum statement wait time in milliseconds.
+        rows:
+          type: integer
+          format: int64
+          description: Sum of rows sent and rows affected.
+        rowsSent:
+          type: integer
+          format: int64
+          description: Total rows sent to clients.
+        rowsAffected:
+          type: integer
+          format: int64
+          description: Total rows affected by statements.
+        rowsExamined:
+          type: integer
+          format: int64
+          description: Total rows examined by statements.
+        lockTimeMs:
+          type: number
+          format: double
+          description: Total statement lock time in milliseconds.
+        errors:
+          type: integer
+          format: int64
+          description: Total statement errors.
+        warnings:
+          type: integer
+          format: int64
+          description: Total statement warnings.
+        tmpTables:
+          type: integer
+          format: int64
+          description: Total internal temporary tables created.
+        tmpDiskTables:
+          type: integer
+          format: int64
+          description: Total internal on-disk temporary tables created.
+        noIndexUsed:
+          type: integer
+          format: int64
+          description: Executions that used no index.
+        noGoodIndexUsed:
+          type: integer
+          format: int64
+          description: Executions for which no good index was found.
+        database:
+          type: string
+          description: Default schema name associated with the digest row.
+        firstSeen:
+          type: string
+          description: UTC timestamp when the digest was first observed.
+        lastSeen:
+          type: string
+          description: UTC timestamp when the digest was most recently observed.
+    mysqlSQLAnalysis:
+      type: object
+      required:
+        - source
+        - status
+        - collectedAt
+        - limit
+        - orderBy
+        - items
+      properties:
+        source:
+          type: string
+          description: Data source. M1 uses performance_schema.events_statements_summary_by_digest.
+        status:
+          type: string
+          description: Source status. Expected values are available or unavailable.
+        unavailableReason:
+          type: string
+          description: Reason when status is unavailable, such as performance_schema_disabled, digest_consumer_disabled, permission_denied, or query_failed.
+        message:
+          type: string
+          description: User-facing recovery guidance when SQL analysis is unavailable.
+        collectedAt:
+          type: string
+          description: Backend collection timestamp in UTC. It is not a sampling-window end time.
+        firstSeen:
+          type: string
+          description: Earliest FIRST_SEEN timestamp across currently visible digest rows, when available.
+        lastSeen:
+          type: string
+          description: Latest LAST_SEEN timestamp across currently visible digest rows, when available.
+        limit:
+          type: integer
+          format: int64
+          description: Effective row limit after backend normalization.
+        orderBy:
+          type: string
+          description: Effective sort key. Expected values are totalTime, meanTime, maxTime, or calls.
+        totalTimeMsAll:
+          type: number
+          format: double
+          x-nullable: true
+          description: Total execution time in milliseconds across all visible digest rows, not limited to the returned top-N items.
+        callsAll:
+          type: integer
+          format: int64
+          x-nullable: true
+          description: Total execution count across all visible digest rows, not limited to the returned top-N items.
+        digestLost:
+          type: integer
+          format: int64
+          x-nullable: true
+          description: Number of statement digests not recorded because the digest table was full, when exposed by the server.
+        items:
+          type: array
+          description: SQL fingerprint ranking rows from Performance Schema. The list may be empty when no statement statistics exist.
+          items:
+            $ref: '#/components/schemas/mysqlSQLFingerprint'
+    performanceTrendRange:
+      type: object
+      required:
+        - label
+        - start
+        - end
+        - durationSeconds
+      properties:
+        label:
+          type: string
+          description: Controlled query range label. Values are 1h, 6h, 24h, or 7d.
+        start:
+          type: string
+        end:
+          type: string
+        durationSeconds:
+          type: integer
+          format: int64
+    performanceTrendSummary:
+      type: object
+      required:
+        - metric
+        - displayName
+        - category
+        - unit
+        - min
+        - max
+        - avg
+        - latest
+      properties:
+        metric:
+          type: string
+        displayName:
+          $ref: '#/components/schemas/localizedDescription'
+        category:
+          type: string
+          description: Metric category. Values include availability, performance, connections, resource, capacity, innodb, and vacuumWraparound.
+        dimension:
+          type: string
+          description: Optional series dimension. Values include cluster, instance, pvc, and database.
+        labels:
+          type: object
+          additionalProperties:
+            type: string
+          description: Optional dimension labels, for example instance, pvc, role, or datname.
+        unit:
+          type: string
+        warnThreshold:
+          type: number
+          format: double
+          description: Optional warning threshold in the same unit as this metric.
+        critThreshold:
+          type: number
+          format: double
+          description: Optional critical threshold in the same unit as this metric.
+        thresholdDirection:
+          type: string
+          description: Optional threshold direction. Values are above, below, or boolean.
+        min:
+          type: number
+          format: double
+        max:
+          type: number
+          format: double
+        avg:
+          type: number
+          format: double
+        latest:
+          type: number
+          format: double
+        changeDirection:
+          type: string
+          description: Change direction when at least two samples exist. Values are increasing, decreasing, or stable.
+    performanceTrendPoint:
+      type: object
+      required:
+        - timestamp
+        - value
+      properties:
+        timestamp:
+          type: string
+        value:
+          type: number
+          format: double
+    performanceTrendSeries:
+      type: object
+      required:
+        - metric
+        - displayName
+        - category
+        - unit
+        - points
+      properties:
+        metric:
+          type: string
+        displayName:
+          $ref: '#/components/schemas/localizedDescription'
+        category:
+          type: string
+          description: Metric category. Values include availability, performance, connections, resource, capacity, innodb, and vacuumWraparound.
+        dimension:
+          type: string
+          description: Optional series dimension. Values include cluster, instance, pvc, and database.
+        labels:
+          type: object
+          additionalProperties:
+            type: string
+          description: Optional dimension labels, for example instance, pvc, role, or datname.
+        unit:
+          type: string
+        warnThreshold:
+          type: number
+          format: double
+          description: Optional warning threshold in the same unit as this metric.
+        critThreshold:
+          type: number
+          format: double
+          description: Optional critical threshold in the same unit as this metric.
+        thresholdDirection:
+          type: string
+          description: Optional threshold direction. Values are above, below, or boolean.
+        points:
+          type: array
+          items:
+            $ref: '#/components/schemas/performanceTrendPoint'
+    performanceTrendSource:
+      type: object
+      required:
+        - name
+        - kind
+        - status
+        - collectedAt
+      properties:
+        name:
+          type: string
+        kind:
+          type: string
+        status:
+          type: string
+          description: Coarse source status. Values are success, partial, failed, skipped, or noData.
+        collectedAt:
+          type: string
+        message:
+          type: string
+    performanceTrends:
+      type: object
+      required:
+        - range
+        - granularity
+        - summary
+        - series
+        - sources
+        - warnings
+        - collectedAt
+      properties:
+        range:
+          $ref: '#/components/schemas/performanceTrendRange'
+        granularity:
+          type: string
+          description: Controlled backend query step.
+        summary:
+          type: array
+          description: Per-series numeric summary. changeDirection is present only when at least two points exist.
+          items:
+            $ref: '#/components/schemas/performanceTrendSummary'
+        series:
+          type: array
+          description: Successfully collected and displayable metric series only. Unsupported, empty, or failed metrics are not represented as per-metric entries.
+          items:
+            $ref: '#/components/schemas/performanceTrendSeries'
+        sources:
+          type: array
+          description: Coarse collection source status. Messages are sanitized and do not expose PromQL, endpoints, credentials, or raw internal errors.
+          items:
+            $ref: '#/components/schemas/performanceTrendSource'
+        warnings:
+          type: array
+          items:
+            type: string
+        collectedAt:
+          type: string
+          description: Backend collection timestamp in UTC.
+    mssqlRequest:
+      type: object
+      required:
+        - requestId
         - startedAt
         - status
         - command
@@ -43566,213 +44517,16 @@ components:
           type: integer
           format: int64
           description: Rows returned or affected by the fingerprint, as reported by pg_stat_statements.
-        database:
-          type: string
-          description: Database name resolved from pg_stat_statements.dbid when visible.
-        user:
-          type: string
-          description: Database user name resolved from pg_stat_statements.userid when visible.
-        topLevel:
-          type: boolean
-          description: Whether pg_stat_statements recorded the statement as top-level. Legacy PostgreSQL versions without the toplevel column report true.
-    postgresqlSQLAnalysis:
-      type: object
-      required:
-        - source
-        - status
-        - collectedAt
-        - limit
-        - orderBy
-        - items
-      properties:
-        source:
-          type: string
-          description: Data source. M1 uses pg_stat_statements only.
-        status:
-          type: string
-          description: Source status. Expected values are available or unavailable.
-        unavailableReason:
-          type: string
-          description: Reason when status is unavailable, such as extension_disabled, permission_denied, or query_failed.
-        statsReset:
-          type: string
-          description: UTC timestamp reported by pg_stat_statements_info.stats_reset when available. Empty means the source did not expose this timestamp.
-        collectedAt:
-          type: string
-          description: Backend collection timestamp in UTC. It is not a sampling-window end time.
-        limit:
-          type: integer
-          format: int64
-          description: Effective row limit after backend normalization.
-        orderBy:
-          type: string
-          description: Effective sort key. Expected values are totalTime, meanTime, maxTime, or calls.
-        totalTimeMsAll:
-          type: number
-          format: double
-          x-nullable: true
-          description: Total execution time in milliseconds across all visible pg_stat_statements rows, not limited to the returned top-N items. Present only when the source is available.
-        callsAll:
-          type: integer
-          format: int64
-          x-nullable: true
-          description: Total execution count across all visible pg_stat_statements rows, not limited to the returned top-N items. Present only when the source is available.
-        items:
-          type: array
-          description: SQL fingerprint ranking rows from pg_stat_statements. The list may be empty when no statement statistics exist.
-          items:
-            $ref: '#/components/schemas/postgresqlSQLFingerprint'
-    postgresqlSQLFingerprintExplainResponse:
-      type: object
-      required:
-        - queryID
-        - fingerprint
-        - database
-        - user
-        - topLevel
-        - planMode
-        - parameterized
-        - explainResult
-      properties:
-        queryID:
-          type: string
-          description: PostgreSQL pg_stat_statements queryid represented as a string.
-        fingerprint:
-          type: string
-          description: Stable SQL fingerprint identifier for UI grouping. Currently aligned with PostgreSQL pg_stat_statements queryid.
-        database:
-          type: string
-          description: Database name from the requested SQL fingerprint identity.
-        user:
-          type: string
-          description: Database user from the requested SQL fingerprint identity.
-        topLevel:
-          type: boolean
-          description: Top-level flag from the requested SQL fingerprint identity.
-        statementSource:
-          type: string
-          description: Server-side source used to resolve the parameterized SQL statement. Raw SQL is not returned.
-        statementResolvedAt:
-          type: string
-          description: Timestamp when the parameterized SQL statement was resolved.
-        planMode:
-          $ref: '#/components/schemas/DmsExecutionPlanPlanningMode'
-          description: Whether DMS produced a standard estimated plan or a generic parameterized estimated plan.
-        parameterized:
-          type: boolean
-          description: Whether generic parameterized planning was used (planMode is generic). False means standard planning, not that historical parameter values were used. This endpoint never retrieves historical parameter values.
-          x-omitempty: false
-        parameterCount:
-          type: integer
-          format: int64
-          nullable: true
-          x-omitempty: true
-          description: Number of parameters when DMS can determine it. It may be omitted for PostgreSQL generic-plan paths that do not expose the count.
-        explainResult:
-          $ref: '#/components/schemas/DmsExecutionPlanResult'
-          description: Normalized DMS estimated visual plan. The resolved statement and generated EXPLAIN SQL are intentionally removed.
-    mysqlSQLFingerprint:
-      type: object
-      required:
-        - queryID
-        - fingerprint
-        - querySummary
-        - calls
-        - totalTimeMs
-        - meanTimeMs
-        - maxTimeMs
-        - rows
-        - rowsSent
-        - rowsAffected
-        - rowsExamined
-        - lockTimeMs
-        - errors
-        - warnings
-        - tmpTables
-        - tmpDiskTables
-        - noIndexUsed
-        - noGoodIndexUsed
-        - database
-      properties:
-        queryID:
-          type: string
-          description: MySQL Performance Schema DIGEST value.
-        fingerprint:
-          type: string
-          description: Stable SQL fingerprint identifier. M1 uses DIGEST.
-        querySummary:
-          type: string
-          description: Normalized DIGEST_TEXT. Raw SQL text is intentionally not returned.
-        calls:
-          type: integer
-          format: int64
-          description: Number of executions accumulated in the current digest row.
-        totalTimeMs:
-          type: number
-          format: double
-          description: Total statement wait time in milliseconds.
-        meanTimeMs:
-          type: number
-          format: double
-          description: Mean statement wait time in milliseconds.
-        maxTimeMs:
-          type: number
-          format: double
-          description: Maximum statement wait time in milliseconds.
-        rows:
-          type: integer
-          format: int64
-          description: Sum of rows sent and rows affected.
-        rowsSent:
-          type: integer
-          format: int64
-          description: Total rows sent to clients.
-        rowsAffected:
-          type: integer
-          format: int64
-          description: Total rows affected by statements.
-        rowsExamined:
-          type: integer
-          format: int64
-          description: Total rows examined by statements.
-        lockTimeMs:
-          type: number
-          format: double
-          description: Total statement lock time in milliseconds.
-        errors:
-          type: integer
-          format: int64
-          description: Total statement errors.
-        warnings:
-          type: integer
-          format: int64
-          description: Total statement warnings.
-        tmpTables:
-          type: integer
-          format: int64
-          description: Total internal temporary tables created.
-        tmpDiskTables:
-          type: integer
-          format: int64
-          description: Total internal on-disk temporary tables created.
-        noIndexUsed:
-          type: integer
-          format: int64
-          description: Executions that used no index.
-        noGoodIndexUsed:
-          type: integer
-          format: int64
-          description: Executions for which no good index was found.
-        database:
-          type: string
-          description: Default schema name associated with the digest row.
-        firstSeen:
+        database:
           type: string
-          description: UTC timestamp when the digest was first observed.
-        lastSeen:
+          description: Database name resolved from pg_stat_statements.dbid when visible.
+        user:
           type: string
-          description: UTC timestamp when the digest was most recently observed.
-    mysqlSQLAnalysis:
+          description: Database user name resolved from pg_stat_statements.userid when visible.
+        topLevel:
+          type: boolean
+          description: Whether pg_stat_statements recorded the statement as top-level. Legacy PostgreSQL versions without the toplevel column report true.
+    postgresqlSQLAnalysis:
       type: object
       required:
         - source
@@ -43784,25 +44538,19 @@ components:
       properties:
         source:
           type: string
-          description: Data source. M1 uses performance_schema.events_statements_summary_by_digest.
+          description: Data source. M1 uses pg_stat_statements only.
         status:
           type: string
           description: Source status. Expected values are available or unavailable.
         unavailableReason:
           type: string
-          description: Reason when status is unavailable, such as performance_schema_disabled, digest_consumer_disabled, permission_denied, or query_failed.
-        message:
+          description: Reason when status is unavailable, such as extension_disabled, permission_denied, or query_failed.
+        statsReset:
           type: string
-          description: User-facing recovery guidance when SQL analysis is unavailable.
+          description: UTC timestamp reported by pg_stat_statements_info.stats_reset when available. Empty means the source did not expose this timestamp.
         collectedAt:
           type: string
           description: Backend collection timestamp in UTC. It is not a sampling-window end time.
-        firstSeen:
-          type: string
-          description: Earliest FIRST_SEEN timestamp across currently visible digest rows, when available.
-        lastSeen:
-          type: string
-          description: Latest LAST_SEEN timestamp across currently visible digest rows, when available.
         limit:
           type: integer
           format: int64
@@ -43814,204 +44562,66 @@ components:
           type: number
           format: double
           x-nullable: true
-          description: Total execution time in milliseconds across all visible digest rows, not limited to the returned top-N items.
+          description: Total execution time in milliseconds across all visible pg_stat_statements rows, not limited to the returned top-N items. Present only when the source is available.
         callsAll:
           type: integer
           format: int64
           x-nullable: true
-          description: Total execution count across all visible digest rows, not limited to the returned top-N items.
-        digestLost:
-          type: integer
-          format: int64
-          x-nullable: true
-          description: Number of statement digests not recorded because the digest table was full, when exposed by the server.
+          description: Total execution count across all visible pg_stat_statements rows, not limited to the returned top-N items. Present only when the source is available.
         items:
           type: array
-          description: SQL fingerprint ranking rows from Performance Schema. The list may be empty when no statement statistics exist.
-          items:
-            $ref: '#/components/schemas/mysqlSQLFingerprint'
-    performanceTrendRange:
-      type: object
-      required:
-        - label
-        - start
-        - end
-        - durationSeconds
-      properties:
-        label:
-          type: string
-          description: Controlled query range label. Values are 1h, 6h, 24h, or 7d.
-        start:
-          type: string
-        end:
-          type: string
-        durationSeconds:
-          type: integer
-          format: int64
-    performanceTrendSummary:
-      type: object
-      required:
-        - metric
-        - displayName
-        - category
-        - unit
-        - min
-        - max
-        - avg
-        - latest
-      properties:
-        metric:
-          type: string
-        displayName:
-          $ref: '#/components/schemas/localizedDescription'
-        category:
-          type: string
-          description: Metric category. Values include availability, performance, connections, resource, capacity, innodb, and vacuumWraparound.
-        dimension:
-          type: string
-          description: Optional series dimension. Values include cluster, instance, pvc, and database.
-        labels:
-          type: object
-          additionalProperties:
-            type: string
-          description: Optional dimension labels, for example instance, pvc, role, or datname.
-        unit:
-          type: string
-        warnThreshold:
-          type: number
-          format: double
-          description: Optional warning threshold in the same unit as this metric.
-        critThreshold:
-          type: number
-          format: double
-          description: Optional critical threshold in the same unit as this metric.
-        thresholdDirection:
-          type: string
-          description: Optional threshold direction. Values are above, below, or boolean.
-        min:
-          type: number
-          format: double
-        max:
-          type: number
-          format: double
-        avg:
-          type: number
-          format: double
-        latest:
-          type: number
-          format: double
-        changeDirection:
-          type: string
-          description: Change direction when at least two samples exist. Values are increasing, decreasing, or stable.
-    performanceTrendPoint:
-      type: object
-      required:
-        - timestamp
-        - value
-      properties:
-        timestamp:
-          type: string
-        value:
-          type: number
-          format: double
-    performanceTrendSeries:
-      type: object
-      required:
-        - metric
-        - displayName
-        - category
-        - unit
-        - points
-      properties:
-        metric:
-          type: string
-        displayName:
-          $ref: '#/components/schemas/localizedDescription'
-        category:
-          type: string
-          description: Metric category. Values include availability, performance, connections, resource, capacity, innodb, and vacuumWraparound.
-        dimension:
-          type: string
-          description: Optional series dimension. Values include cluster, instance, pvc, and database.
-        labels:
-          type: object
-          additionalProperties:
-            type: string
-          description: Optional dimension labels, for example instance, pvc, role, or datname.
-        unit:
-          type: string
-        warnThreshold:
-          type: number
-          format: double
-          description: Optional warning threshold in the same unit as this metric.
-        critThreshold:
-          type: number
-          format: double
-          description: Optional critical threshold in the same unit as this metric.
-        thresholdDirection:
-          type: string
-          description: Optional threshold direction. Values are above, below, or boolean.
-        points:
-          type: array
+          description: SQL fingerprint ranking rows from pg_stat_statements. The list may be empty when no statement statistics exist.
           items:
-            $ref: '#/components/schemas/performanceTrendPoint'
-    performanceTrendSource:
+            $ref: '#/components/schemas/postgresqlSQLFingerprint'
+    postgresqlSQLFingerprintExplainResponse:
       type: object
       required:
-        - name
-        - kind
-        - status
-        - collectedAt
+        - queryID
+        - fingerprint
+        - database
+        - user
+        - topLevel
+        - planMode
+        - parameterized
+        - explainResult
       properties:
-        name:
-          type: string
-        kind:
+        queryID:
           type: string
-        status:
+          description: PostgreSQL pg_stat_statements queryid represented as a string.
+        fingerprint:
           type: string
-          description: Coarse source status. Values are success, partial, failed, skipped, or noData.
-        collectedAt:
+          description: Stable SQL fingerprint identifier for UI grouping. Currently aligned with PostgreSQL pg_stat_statements queryid.
+        database:
           type: string
-        message:
+          description: Database name from the requested SQL fingerprint identity.
+        user:
           type: string
-    performanceTrends:
-      type: object
-      required:
-        - range
-        - granularity
-        - summary
-        - series
-        - sources
-        - warnings
-        - collectedAt
-      properties:
-        range:
-          $ref: '#/components/schemas/performanceTrendRange'
-        granularity:
+          description: Database user from the requested SQL fingerprint identity.
+        topLevel:
+          type: boolean
+          description: Top-level flag from the requested SQL fingerprint identity.
+        statementSource:
           type: string
-          description: Controlled backend query step.
-        summary:
-          type: array
-          description: Per-series numeric summary. changeDirection is present only when at least two points exist.
-          items:
-            $ref: '#/components/schemas/performanceTrendSummary'
-        series:
-          type: array
-          description: Successfully collected and displayable metric series only. Unsupported, empty, or failed metrics are not represented as per-metric entries.
-          items:
-            $ref: '#/components/schemas/performanceTrendSeries'
-        sources:
-          type: array
-          description: Coarse collection source status. Messages are sanitized and do not expose PromQL, endpoints, credentials, or raw internal errors.
-          items:
-            $ref: '#/components/schemas/performanceTrendSource'
-        warnings:
-          type: array
-          items:
-            type: string
-        collectedAt:
+          description: Server-side source used to resolve the parameterized SQL statement. Raw SQL is not returned.
+        statementResolvedAt:
           type: string
-          description: Backend collection timestamp in UTC.
+          description: Timestamp when the parameterized SQL statement was resolved.
+        planMode:
+          $ref: '#/components/schemas/DmsExecutionPlanPlanningMode'
+          description: Whether DMS produced a standard estimated plan or a generic parameterized estimated plan.
+        parameterized:
+          type: boolean
+          description: Whether generic parameterized planning was used (planMode is generic). False means standard planning, not that historical parameter values were used. This endpoint never retrieves historical parameter values.
+          x-omitempty: false
+        parameterCount:
+          type: integer
+          format: int64
+          nullable: true
+          x-omitempty: true
+          description: Number of parameters when DMS can determine it. It may be omitted for PostgreSQL generic-plan paths that do not expose the count.
+        explainResult:
+          $ref: '#/components/schemas/DmsExecutionPlanResult'
+          description: Normalized DMS estimated visual plan. The resolved statement and generated EXPLAIN SQL are intentionally removed.
     elasticsearchHotThreadsType:
       type: string
       enum:
@@ -46673,6 +47283,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: