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

package/src/adminapi.yaml

@@ -3363,6 +3363,47 @@ paths:
       tags:
         - cluster
         - shared
+  /admin/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
   /admin/v1/organizations/{orgName}/clusters/{clusterName}/instances/metrics:
     get:
       operationId: getInstacesMetrics
@@ -19083,6 +19124,41 @@ paths:
           $ref: '#/components/responses/403'
         '500':
           $ref: '#/components/responses/500'
+  /admin/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'
   /admin/v1/organizations/{orgName}/clusters/{clusterName}/diagnostics/postgresql/sessions/{pid}/lockAnalysis:
     get:
       tags:
@@ -23580,6 +23656,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:
@@ -35620,6 +35745,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:

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

@@ -256,6 +256,8 @@ models/cluster-slow-log-explain-response.ts
 models/cluster-slow-log-stats.ts
 models/cluster-slow-log-template-list.ts
 models/cluster-slow-log-template.ts
+models/cluster-storage-usage-history-point.ts
+models/cluster-storage-usage-history.ts
 models/cluster-tags.ts
 models/cluster-termination-policy.ts
 models/cluster-type.ts
@@ -650,10 +652,18 @@ models/phone-verification-request.ts
 models/platform-parameter-constraints.ts
 models/platform-parameter-list.ts
 models/platform-parameter.ts
+models/postgresql-database-space.ts
 models/postgresql-deadlock-evidence.ts
+models/postgresql-index-space.ts
 models/postgresql-lock-analysis.ts
 models/postgresql-lock-row.ts
 models/postgresql-session.ts
+models/postgresql-space-analysis.ts
+models/postgresql-space-source.ts
+models/postgresql-space-summary.ts
+models/postgresql-storage-overview.ts
+models/postgresql-table-space.ts
+models/postgresql-toast-relation-space.ts
 models/postgresql-wait-graph-edge-evidence.ts
 models/postgresql-wait-graph-edge.ts
 models/postgresql-wait-graph-node.ts

package/src/openapi/apis/cluster-api.ts

@@ -36,6 +36,8 @@ import type { ClusterMetrics } from '../models';
 // @ts-ignore
 import type { ClusterModeTransition } from '../models';
 // @ts-ignore
+import type { ClusterStorageUsageHistory } from '../models';
+// @ts-ignore
 import type { ClusterUpdate } from '../models';
 // @ts-ignore
 import type { EndpointList } from '../models';
@@ -443,6 +445,56 @@ export const ClusterApiAxiosParamCreator = function (configuration?: Configurati
 
 
     
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
+
+            return {
+                url: toPathString(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        },
+        /**
+         * Get cluster storage usage history from backend-owned fixed metrics.
+         * @summary Get cluster storage usage history
+         * @param {string} orgName name of the Org
+         * @param {string} clusterName name of the cluster
+         * @param {string} [timeRange] Requested history range. Supported values are 24h and 7d. Defaults to 24h.
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        getClusterStorageUsageHistory: async (orgName: string, clusterName: string, timeRange?: string, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+            // verify required parameter 'orgName' is not null or undefined
+            assertParamExists('getClusterStorageUsageHistory', 'orgName', orgName)
+            // verify required parameter 'clusterName' is not null or undefined
+            assertParamExists('getClusterStorageUsageHistory', 'clusterName', clusterName)
+            const localVarPath = `/api/v1/organizations/{orgName}/clusters/{clusterName}/storageUsageHistory`
+                .replace(`{${"orgName"}}`, encodeURIComponent(String(orgName)))
+                .replace(`{${"clusterName"}}`, encodeURIComponent(String(clusterName)));
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+
+            const localVarRequestOptions = { method: 'GET', ...baseOptions, ...options};
+            const localVarHeaderParameter = {} as any;
+            const localVarQueryParameter = {} as any;
+
+            // authentication BearerToken required
+            // http bearer authentication required
+            await setBearerAuthToObject(localVarHeaderParameter, configuration)
+
+            // authentication DigestAuth required
+            await setApiKeyToObject(localVarHeaderParameter, "Authorization", configuration)
+
+            if (timeRange !== undefined) {
+                localVarQueryParameter['timeRange'] = timeRange;
+            }
+
+
+    
             setSearchParams(localVarUrlObj, localVarQueryParameter);
             let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
             localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
@@ -1437,6 +1489,21 @@ export const ClusterApiFp = function(configuration?: Configuration) {
             const localVarOperationServerBasePath = operationServerMap['ClusterApi.getClusterInstanceLog']?.[localVarOperationServerIndex]?.url;
             return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
         },
+        /**
+         * Get cluster storage usage history from backend-owned fixed metrics.
+         * @summary Get cluster storage usage history
+         * @param {string} orgName name of the Org
+         * @param {string} clusterName name of the cluster
+         * @param {string} [timeRange] Requested history range. Supported values are 24h and 7d. Defaults to 24h.
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        async getClusterStorageUsageHistory(orgName: string, clusterName: string, timeRange?: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<ClusterStorageUsageHistory>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.getClusterStorageUsageHistory(orgName, clusterName, timeRange, options);
+            const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+            const localVarOperationServerBasePath = operationServerMap['ClusterApi.getClusterStorageUsageHistory']?.[localVarOperationServerIndex]?.url;
+            return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+        },
         /**
          * 
          * @summary Get instaces metrics in cluster
@@ -1767,6 +1834,16 @@ export const ClusterApiFactory = function (configuration?: Configuration, basePa
         getClusterInstanceLog(requestParameters: ClusterApiGetClusterInstanceLogRequest, options?: RawAxiosRequestConfig): AxiosPromise<string> {
             return localVarFp.getClusterInstanceLog(requestParameters.orgName, requestParameters.clusterName, requestParameters.workloadName, requestParameters.workloadType, requestParameters.previous, requestParameters.sinceSeconds, requestParameters.tailLines, options).then((request) => request(axios, basePath));
         },
+        /**
+         * Get cluster storage usage history from backend-owned fixed metrics.
+         * @summary Get cluster storage usage history
+         * @param {ClusterApiGetClusterStorageUsageHistoryRequest} requestParameters Request parameters.
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        getClusterStorageUsageHistory(requestParameters: ClusterApiGetClusterStorageUsageHistoryRequest, options?: RawAxiosRequestConfig): AxiosPromise<ClusterStorageUsageHistory> {
+            return localVarFp.getClusterStorageUsageHistory(requestParameters.orgName, requestParameters.clusterName, requestParameters.timeRange, options).then((request) => request(axios, basePath));
+        },
         /**
          * 
          * @summary Get instaces metrics in cluster
@@ -2006,6 +2083,16 @@ export interface ClusterApiInterface {
      */
     getClusterInstanceLog(requestParameters: ClusterApiGetClusterInstanceLogRequest, options?: RawAxiosRequestConfig): AxiosPromise<string>;
 
+    /**
+     * Get cluster storage usage history from backend-owned fixed metrics.
+     * @summary Get cluster storage usage history
+     * @param {ClusterApiGetClusterStorageUsageHistoryRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof ClusterApiInterface
+     */
+    getClusterStorageUsageHistory(requestParameters: ClusterApiGetClusterStorageUsageHistoryRequest, options?: RawAxiosRequestConfig): AxiosPromise<ClusterStorageUsageHistory>;
+
     /**
      * 
      * @summary Get instaces metrics in cluster
@@ -2392,6 +2479,34 @@ export interface ClusterApiGetClusterInstanceLogRequest {
     readonly tailLines?: number
 }
 
+/**
+ * Request parameters for getClusterStorageUsageHistory operation in ClusterApi.
+ * @export
+ * @interface ClusterApiGetClusterStorageUsageHistoryRequest
+ */
+export interface ClusterApiGetClusterStorageUsageHistoryRequest {
+    /**
+     * name of the Org
+     * @type {string}
+     * @memberof ClusterApiGetClusterStorageUsageHistory
+     */
+    readonly orgName: string
+
+    /**
+     * name of the cluster
+     * @type {string}
+     * @memberof ClusterApiGetClusterStorageUsageHistory
+     */
+    readonly clusterName: string
+
+    /**
+     * Requested history range. Supported values are 24h and 7d. Defaults to 24h.
+     * @type {string}
+     * @memberof ClusterApiGetClusterStorageUsageHistory
+     */
+    readonly timeRange?: string
+}
+
 /**
  * Request parameters for getInstacesMetrics operation in ClusterApi.
  * @export
@@ -3001,6 +3116,18 @@ export class ClusterApi extends BaseAPI implements ClusterApiInterface {
         return ClusterApiFp(this.configuration).getClusterInstanceLog(requestParameters.orgName, requestParameters.clusterName, requestParameters.workloadName, requestParameters.workloadType, requestParameters.previous, requestParameters.sinceSeconds, requestParameters.tailLines, options).then((request) => request(this.axios, this.basePath));
     }
 
+    /**
+     * Get cluster storage usage history from backend-owned fixed metrics.
+     * @summary Get cluster storage usage history
+     * @param {ClusterApiGetClusterStorageUsageHistoryRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof ClusterApi
+     */
+    public getClusterStorageUsageHistory(requestParameters: ClusterApiGetClusterStorageUsageHistoryRequest, options?: RawAxiosRequestConfig) {
+        return ClusterApiFp(this.configuration).getClusterStorageUsageHistory(requestParameters.orgName, requestParameters.clusterName, requestParameters.timeRange, options).then((request) => request(this.axios, this.basePath));
+    }
+
     /**
      * 
      * @summary Get instaces metrics in cluster