kb-cloud-client-typescript 2.3.0-alpha.117 → 2.3.0-alpha.119

package/src/openapi.yaml

@@ -4837,6 +4837,41 @@ paths:
           $ref: '#/components/responses/403'
         '500':
           $ref: '#/components/responses/500'
+  /api/v1/organizations/{orgName}/clusters/{clusterName}/diagnostics/postgresql/spaceAnalysis:
+    get:
+      tags:
+        - diagnostics
+      summary: Get PostgreSQL space analysis
+      description: Get a read-only PostgreSQL space snapshot from DMS and fixed backend-owned storage metrics. The response does not expose SQL, PromQL, storage history, or remediation actions.
+      operationId: getDiagnosticsPostgresqlSpaceAnalysis
+      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
+      responses:
+        '200':
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/postgresqlSpaceAnalysis'
+        '400':
+          $ref: '#/components/responses/400'
+        '401':
+          $ref: '#/components/responses/401'
+        '403':
+          $ref: '#/components/responses/403'
+        '500':
+          $ref: '#/components/responses/500'
   /api/v1/organizations/{orgName}/clusters/{clusterName}/diagnostics/postgresql/sessions/{pid}/lockAnalysis:
     get:
       tags:
@@ -4971,6 +5006,47 @@ paths:
       tags:
         - cluster
         - shared
+  /api/v1/organizations/{orgName}/clusters/{clusterName}/storageUsageHistory:
+    get:
+      description: Get cluster storage usage history from backend-owned fixed metrics.
+      operationId: getClusterStorageUsageHistory
+      summary: Get cluster storage usage history
+      parameters:
+        - description: name of the Org
+          in: path
+          name: orgName
+          required: true
+          schema:
+            type: string
+        - description: name of the cluster
+          in: path
+          name: clusterName
+          required: true
+          schema:
+            type: string
+        - name: timeRange
+          in: query
+          description: Requested history range. Supported values are 24h and 7d. Defaults to 24h.
+          schema:
+            type: string
+      responses:
+        '200':
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/clusterStorageUsageHistory'
+        '400':
+          $ref: '#/components/responses/400'
+        '401':
+          $ref: '#/components/responses/401'
+        '403':
+          $ref: '#/components/responses/403'
+        '404':
+          $ref: '#/components/responses/404'
+      tags:
+        - cluster
+        - shared
   /api/v1/organizations/{orgName}/clusters/{clusterName}/instances/metrics:
     get:
       operationId: getInstacesMetrics
@@ -21658,6 +21734,228 @@ components:
       type: array
       items:
         $ref: '#/components/schemas/postgresqlSession'
+    postgresqlSpaceSummary:
+      type: object
+      required:
+        - tableCount
+        - indexCount
+        - toastRelationCount
+        - tableListTruncated
+        - indexListTruncated
+      properties:
+        databaseName:
+          type: string
+        databaseSizeBytes:
+          type: integer
+          format: int64
+        tableCount:
+          type: integer
+          format: int64
+        indexCount:
+          type: integer
+          format: int64
+        toastRelationCount:
+          type: integer
+          format: int64
+        largestTableBytes:
+          type: integer
+          format: int64
+        largestIndexBytes:
+          type: integer
+          format: int64
+        tableListTruncated:
+          type: boolean
+        indexListTruncated:
+          type: boolean
+    postgresqlStorageOverview:
+      type: object
+      required:
+        - source
+      properties:
+        totalBytes:
+          type: integer
+          format: int64
+          description: Current total PVC capacity in bytes when backend-owned metrics are available.
+        usedBytes:
+          type: integer
+          format: int64
+          description: Current PVC used bytes when backend-owned metrics are available.
+        availableBytes:
+          type: integer
+          format: int64
+          description: Current available PVC bytes derived from totalBytes - usedBytes when both values are available.
+        usageRatio:
+          type: number
+          format: double
+          description: Current usedBytes / totalBytes ratio when both values are available.
+        updatedAt:
+          type: string
+          description: Metrics collection timestamp in UTC.
+        source:
+          type: string
+    postgresqlDatabaseSpace:
+      type: object
+      properties:
+        name:
+          type: string
+        sizeBytes:
+          type: integer
+          format: int64
+    postgresqlTableSpace:
+      type: object
+      properties:
+        database:
+          type: string
+        schema:
+          type: string
+        name:
+          type: string
+        relationOid:
+          type: integer
+          format: int64
+        totalBytes:
+          type: integer
+          format: int64
+        tableBytes:
+          type: integer
+          format: int64
+        indexBytes:
+          type: integer
+          format: int64
+        toastBytes:
+          type: integer
+          format: int64
+        toastRelationOid:
+          type: integer
+          format: int64
+        liveTuples:
+          type: integer
+          format: int64
+        deadTuples:
+          type: integer
+          format: int64
+        seqScan:
+          type: integer
+          format: int64
+        indexScan:
+          type: integer
+          format: int64
+        lastVacuum:
+          type: string
+        lastAutoVacuum:
+          type: string
+        lastAnalyze:
+          type: string
+        lastAutoAnalyze:
+          type: string
+    postgresqlIndexSpace:
+      type: object
+      properties:
+        database:
+          type: string
+        schema:
+          type: string
+        table:
+          type: string
+        name:
+          type: string
+        tableRelationOid:
+          type: integer
+          format: int64
+        relationOid:
+          type: integer
+          format: int64
+        sizeBytes:
+          type: integer
+          format: int64
+        isPrimary:
+          type: boolean
+        isUnique:
+          type: boolean
+        scanCount:
+          type: integer
+          format: int64
+        tuplesRead:
+          type: integer
+          format: int64
+        tuplesFetch:
+          type: integer
+          format: int64
+    postgresqlToastRelationSpace:
+      type: object
+      properties:
+        database:
+          type: string
+        schema:
+          type: string
+        table:
+          type: string
+        tableRelationOid:
+          type: integer
+          format: int64
+        toastRelationOid:
+          type: integer
+          format: int64
+        toastBytes:
+          type: integer
+          format: int64
+    postgresqlSpaceSource:
+      type: object
+      required:
+        - name
+        - kind
+        - status
+        - collectedAt
+      properties:
+        name:
+          type: string
+        kind:
+          type: string
+        status:
+          type: string
+        collectedAt:
+          type: string
+        message:
+          type: string
+    postgresqlSpaceAnalysis:
+      type: object
+      required:
+        - summary
+        - storageOverview
+        - databases
+        - tables
+        - indexes
+        - toastRelations
+        - sources
+        - collectedAt
+      properties:
+        summary:
+          $ref: '#/components/schemas/postgresqlSpaceSummary'
+        storageOverview:
+          $ref: '#/components/schemas/postgresqlStorageOverview'
+        databases:
+          type: array
+          items:
+            $ref: '#/components/schemas/postgresqlDatabaseSpace'
+        tables:
+          type: array
+          items:
+            $ref: '#/components/schemas/postgresqlTableSpace'
+        indexes:
+          type: array
+          items:
+            $ref: '#/components/schemas/postgresqlIndexSpace'
+        toastRelations:
+          type: array
+          items:
+            $ref: '#/components/schemas/postgresqlToastRelationSpace'
+        sources:
+          type: array
+          items:
+            $ref: '#/components/schemas/postgresqlSpaceSource'
+        collectedAt:
+          type: string
+          description: Backend collection timestamp in UTC.
     postgresqlLockRow:
       type: object
       required:
@@ -21828,6 +22126,55 @@ components:
             type: array
             items: {}
             nullable: true
+    clusterStorageUsageHistoryPoint:
+      type: object
+      required:
+        - timestamp
+        - usedBytes
+        - totalBytes
+        - usageRatio
+      properties:
+        timestamp:
+          type: string
+        usedBytes:
+          type: integer
+          format: int64
+        totalBytes:
+          type: integer
+          format: int64
+        usageRatio:
+          type: number
+          format: double
+    clusterStorageUsageHistory:
+      type: object
+      description: Cluster storage usage history collected from backend-owned fixed metrics.
+      required:
+        - timeRange
+        - start
+        - end
+        - points
+        - source
+        - collectedAt
+      properties:
+        timeRange:
+          type: string
+          description: Requested history range. Supported values are 24h and 7d.
+        start:
+          type: string
+          description: History query start timestamp in UTC.
+        end:
+          type: string
+          description: History query end timestamp in UTC.
+        points:
+          type: array
+          items:
+            $ref: '#/components/schemas/clusterStorageUsageHistoryPoint'
+        source:
+          type: string
+          description: Metrics source used to build the history.
+        collectedAt:
+          type: string
+          description: Backend collection timestamp in UTC.
     instanceDiskUsageItem:
       description: disk usage with volume name.
       properties: