@nexgencloud/hyperstack-sdk-typescript 1.54.7-alpha → 1.55.1-alpha

package/README.md

@@ -1,4 +1,4 @@
-## @nexgencloud/hyperstack-sdk-typescript@v1.54.7-alpha
+## @nexgencloud/hyperstack-sdk-typescript@v1.55.1-alpha
 
 This generator creates TypeScript/JavaScript client that utilizes [axios](https://github.com/axios/axios). The generated Node module can be used in the following environments:
 
@@ -36,7 +36,7 @@ navigate to the folder of your consuming project and run one of the following co
 _published:_
 
 ```
-npm install @nexgencloud/hyperstack-sdk-typescript@v1.54.7-alpha --save
+npm install @nexgencloud/hyperstack-sdk-typescript@v1.55.1-alpha --save
 ```
 
 _unPublished (not recommended):_

package/api.ts

@@ -2696,6 +2696,12 @@ export interface CreateInstancesPayload {
      * @memberof CreateInstancesPayload
      */
     'enable_port_randomization'?: boolean;
+    /**
+     * When true, the Hyperstack VM Agent is opted in for this VM and metrics ingestion is allowed by the prom-gateway. The agent must still be installed on the VM (typically via user_data cloud-init).
+     * @type {boolean}
+     * @memberof CreateInstancesPayload
+     */
+    'enhanced_monitoring_enabled'?: boolean;
     /**
      * The name of the [environment](https://docs.hyperstack.cloud/docs/api-reference/core-resources/environments/) in which the virtual machine is to be created.
      * @type {string}
@@ -4994,6 +5000,19 @@ export interface Instance {
      */
     'status'?: boolean;
 }
+/**
+ * 
+ * @export
+ * @interface InstanceEnhancedMetricsFields
+ */
+export interface InstanceEnhancedMetricsFields {
+    /**
+     * 
+     * @type {boolean}
+     * @memberof InstanceEnhancedMetricsFields
+     */
+    'enabled'?: boolean;
+}
 /**
  * 
  * @export
@@ -5135,6 +5154,12 @@ export interface InstanceFields {
      * @memberof InstanceFields
      */
     'created_at'?: string;
+    /**
+     * 
+     * @type {InstanceEnhancedMetricsFields}
+     * @memberof InstanceFields
+     */
+    'enhanced_metrics'?: InstanceEnhancedMetricsFields;
     /**
      * 
      * @type {InstanceEnvironmentFields}
@@ -10200,6 +10225,63 @@ export interface UserDefaultChoicesForUserResponse {
      */
     'user_default_choices'?: Array<UserDefaultChoiceForUserFields>;
 }
+/**
+ * 
+ * @export
+ * @interface UserEnhancedMetricsPayload
+ */
+export interface UserEnhancedMetricsPayload {
+    /**
+     * Set to true to opt this VM into Enhanced Metrics, false to opt out.
+     * @type {boolean}
+     * @memberof UserEnhancedMetricsPayload
+     */
+    'enabled': boolean;
+}
+/**
+ * 
+ * @export
+ * @interface UserEnhancedMetricsResponse
+ */
+export interface UserEnhancedMetricsResponse {
+    /**
+     * One-liner the user can run inside the VM to install the agent when enabling. Omitted when disabling.
+     * @type {string}
+     * @memberof UserEnhancedMetricsResponse
+     */
+    'install_command'?: string;
+    /**
+     * 
+     * @type {string}
+     * @memberof UserEnhancedMetricsResponse
+     */
+    'message'?: string;
+    /**
+     * 
+     * @type {UserEnhancedMetricsResponseFields}
+     * @memberof UserEnhancedMetricsResponse
+     */
+    'metrics'?: UserEnhancedMetricsResponseFields;
+    /**
+     * 
+     * @type {boolean}
+     * @memberof UserEnhancedMetricsResponse
+     */
+    'status'?: boolean;
+}
+/**
+ * 
+ * @export
+ * @interface UserEnhancedMetricsResponseFields
+ */
+export interface UserEnhancedMetricsResponseFields {
+    /**
+     * 
+     * @type {boolean}
+     * @memberof UserEnhancedMetricsResponseFields
+     */
+    'enabled'?: boolean;
+}
 /**
  * 
  * @export
@@ -28441,6 +28523,49 @@ export const VirtualMachineApiAxiosParamCreator = function (configuration?: Conf
             let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
             localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
 
+            return {
+                url: toPathString(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        },
+        /**
+         * Enable or disable the Hyperstack VM Agent (Enhanced Metrics) for an existing virtual machine. The agent itself must be installed/removed manually inside the VM — the response includes the install command when enabling.
+         * @summary Enable or disable Enhanced Metrics for a virtual machine
+         * @param {number} vmId 
+         * @param {UserEnhancedMetricsPayload} payload 
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        toggleEnhancedMetricsForAVM: async (vmId: number, payload: UserEnhancedMetricsPayload, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+            // verify required parameter 'vmId' is not null or undefined
+            assertParamExists('toggleEnhancedMetricsForAVM', 'vmId', vmId)
+            // verify required parameter 'payload' is not null or undefined
+            assertParamExists('toggleEnhancedMetricsForAVM', 'payload', payload)
+            const localVarPath = `/core/virtual-machines/{vm_id}/enhanced-metrics`
+                .replace(`{${"vm_id"}}`, encodeURIComponent(String(vmId)));
+            // 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: 'PATCH', ...baseOptions, ...options};
+            const localVarHeaderParameter = {} as any;
+            const localVarQueryParameter = {} as any;
+
+            // authentication apiKey required
+            await setApiKeyToObject(localVarHeaderParameter, "api_key", configuration)
+
+
+    
+            localVarHeaderParameter['Content-Type'] = 'application/json';
+
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
+            localVarRequestOptions.data = serializeDataIfNeeded(payload, localVarRequestOptions, configuration)
+
             return {
                 url: toPathString(localVarUrlObj),
                 options: localVarRequestOptions,
@@ -28735,6 +28860,20 @@ export const VirtualMachineApiFp = function(configuration?: Configuration) {
             const localVarOperationServerBasePath = operationServerMap['VirtualMachineApi.stopVM']?.[localVarOperationServerIndex]?.url;
             return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
         },
+        /**
+         * Enable or disable the Hyperstack VM Agent (Enhanced Metrics) for an existing virtual machine. The agent itself must be installed/removed manually inside the VM — the response includes the install command when enabling.
+         * @summary Enable or disable Enhanced Metrics for a virtual machine
+         * @param {number} vmId 
+         * @param {UserEnhancedMetricsPayload} payload 
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        async toggleEnhancedMetricsForAVM(vmId: number, payload: UserEnhancedMetricsPayload, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<UserEnhancedMetricsResponse>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.toggleEnhancedMetricsForAVM(vmId, payload, options);
+            const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+            const localVarOperationServerBasePath = operationServerMap['VirtualMachineApi.toggleEnhancedMetricsForAVM']?.[localVarOperationServerIndex]?.url;
+            return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+        },
     }
 };
 
@@ -28964,6 +29103,17 @@ export const VirtualMachineApiFactory = function (configuration?: Configuration,
         stopVM(vmId: number, options?: RawAxiosRequestConfig): AxiosPromise<ResponseModel> {
             return localVarFp.stopVM(vmId, options).then((request) => request(axios, basePath));
         },
+        /**
+         * Enable or disable the Hyperstack VM Agent (Enhanced Metrics) for an existing virtual machine. The agent itself must be installed/removed manually inside the VM — the response includes the install command when enabling.
+         * @summary Enable or disable Enhanced Metrics for a virtual machine
+         * @param {number} vmId 
+         * @param {UserEnhancedMetricsPayload} payload 
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        toggleEnhancedMetricsForAVM(vmId: number, payload: UserEnhancedMetricsPayload, options?: RawAxiosRequestConfig): AxiosPromise<UserEnhancedMetricsResponse> {
+            return localVarFp.toggleEnhancedMetricsForAVM(vmId, payload, options).then((request) => request(axios, basePath));
+        },
     };
 };
 
@@ -29232,6 +29382,19 @@ export class VirtualMachineApi extends BaseAPI {
     public stopVM(vmId: number, options?: RawAxiosRequestConfig) {
         return VirtualMachineApiFp(this.configuration).stopVM(vmId, options).then((request) => request(this.axios, this.basePath));
     }
+
+    /**
+     * Enable or disable the Hyperstack VM Agent (Enhanced Metrics) for an existing virtual machine. The agent itself must be installed/removed manually inside the VM — the response includes the install command when enabling.
+     * @summary Enable or disable Enhanced Metrics for a virtual machine
+     * @param {number} vmId 
+     * @param {UserEnhancedMetricsPayload} payload 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof VirtualMachineApi
+     */
+    public toggleEnhancedMetricsForAVM(vmId: number, payload: UserEnhancedMetricsPayload, options?: RawAxiosRequestConfig) {
+        return VirtualMachineApiFp(this.configuration).toggleEnhancedMetricsForAVM(vmId, payload, options).then((request) => request(this.axios, this.basePath));
+    }
 }
 
 /**

package/dist/api.d.ts

@@ -2665,6 +2665,12 @@ export interface CreateInstancesPayload {
      * @memberof CreateInstancesPayload
      */
     'enable_port_randomization'?: boolean;
+    /**
+     * When true, the Hyperstack VM Agent is opted in for this VM and metrics ingestion is allowed by the prom-gateway. The agent must still be installed on the VM (typically via user_data cloud-init).
+     * @type {boolean}
+     * @memberof CreateInstancesPayload
+     */
+    'enhanced_monitoring_enabled'?: boolean;
     /**
      * The name of the [environment](https://docs.hyperstack.cloud/docs/api-reference/core-resources/environments/) in which the virtual machine is to be created.
      * @type {string}
@@ -4959,6 +4965,19 @@ export interface Instance {
      */
     'status'?: boolean;
 }
+/**
+ *
+ * @export
+ * @interface InstanceEnhancedMetricsFields
+ */
+export interface InstanceEnhancedMetricsFields {
+    /**
+     *
+     * @type {boolean}
+     * @memberof InstanceEnhancedMetricsFields
+     */
+    'enabled'?: boolean;
+}
 /**
  *
  * @export
@@ -5100,6 +5119,12 @@ export interface InstanceFields {
      * @memberof InstanceFields
      */
     'created_at'?: string;
+    /**
+     *
+     * @type {InstanceEnhancedMetricsFields}
+     * @memberof InstanceFields
+     */
+    'enhanced_metrics'?: InstanceEnhancedMetricsFields;
     /**
      *
      * @type {InstanceEnvironmentFields}
@@ -10140,6 +10165,63 @@ export interface UserDefaultChoicesForUserResponse {
      */
     'user_default_choices'?: Array<UserDefaultChoiceForUserFields>;
 }
+/**
+ *
+ * @export
+ * @interface UserEnhancedMetricsPayload
+ */
+export interface UserEnhancedMetricsPayload {
+    /**
+     * Set to true to opt this VM into Enhanced Metrics, false to opt out.
+     * @type {boolean}
+     * @memberof UserEnhancedMetricsPayload
+     */
+    'enabled': boolean;
+}
+/**
+ *
+ * @export
+ * @interface UserEnhancedMetricsResponse
+ */
+export interface UserEnhancedMetricsResponse {
+    /**
+     * One-liner the user can run inside the VM to install the agent when enabling. Omitted when disabling.
+     * @type {string}
+     * @memberof UserEnhancedMetricsResponse
+     */
+    'install_command'?: string;
+    /**
+     *
+     * @type {string}
+     * @memberof UserEnhancedMetricsResponse
+     */
+    'message'?: string;
+    /**
+     *
+     * @type {UserEnhancedMetricsResponseFields}
+     * @memberof UserEnhancedMetricsResponse
+     */
+    'metrics'?: UserEnhancedMetricsResponseFields;
+    /**
+     *
+     * @type {boolean}
+     * @memberof UserEnhancedMetricsResponse
+     */
+    'status'?: boolean;
+}
+/**
+ *
+ * @export
+ * @interface UserEnhancedMetricsResponseFields
+ */
+export interface UserEnhancedMetricsResponseFields {
+    /**
+     *
+     * @type {boolean}
+     * @memberof UserEnhancedMetricsResponseFields
+     */
+    'enabled'?: boolean;
+}
 /**
  *
  * @export
@@ -19085,6 +19167,15 @@ export declare const VirtualMachineApiAxiosParamCreator: (configuration?: Config
      * @throws {RequiredError}
      */
     stopVM: (vmId: number, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * Enable or disable the Hyperstack VM Agent (Enhanced Metrics) for an existing virtual machine. The agent itself must be installed/removed manually inside the VM — the response includes the install command when enabling.
+     * @summary Enable or disable Enhanced Metrics for a virtual machine
+     * @param {number} vmId
+     * @param {UserEnhancedMetricsPayload} payload
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    toggleEnhancedMetricsForAVM: (vmId: number, payload: UserEnhancedMetricsPayload, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
 };
 /**
  * VirtualMachineApi - functional programming interface
@@ -19270,6 +19361,15 @@ export declare const VirtualMachineApiFp: (configuration?: Configuration) => {
      * @throws {RequiredError}
      */
     stopVM(vmId: number, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<ResponseModel>>;
+    /**
+     * Enable or disable the Hyperstack VM Agent (Enhanced Metrics) for an existing virtual machine. The agent itself must be installed/removed manually inside the VM — the response includes the install command when enabling.
+     * @summary Enable or disable Enhanced Metrics for a virtual machine
+     * @param {number} vmId
+     * @param {UserEnhancedMetricsPayload} payload
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    toggleEnhancedMetricsForAVM(vmId: number, payload: UserEnhancedMetricsPayload, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<UserEnhancedMetricsResponse>>;
 };
 /**
  * VirtualMachineApi - factory interface
@@ -19455,6 +19555,15 @@ export declare const VirtualMachineApiFactory: (configuration?: Configuration, b
      * @throws {RequiredError}
      */
     stopVM(vmId: number, options?: RawAxiosRequestConfig): AxiosPromise<ResponseModel>;
+    /**
+     * Enable or disable the Hyperstack VM Agent (Enhanced Metrics) for an existing virtual machine. The agent itself must be installed/removed manually inside the VM — the response includes the install command when enabling.
+     * @summary Enable or disable Enhanced Metrics for a virtual machine
+     * @param {number} vmId
+     * @param {UserEnhancedMetricsPayload} payload
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    toggleEnhancedMetricsForAVM(vmId: number, payload: UserEnhancedMetricsPayload, options?: RawAxiosRequestConfig): AxiosPromise<UserEnhancedMetricsResponse>;
 };
 /**
  * VirtualMachineApi - object-oriented interface
@@ -19662,6 +19771,16 @@ export declare class VirtualMachineApi extends BaseAPI {
      * @memberof VirtualMachineApi
      */
     stopVM(vmId: number, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<ResponseModel, any, {}, any>>;
+    /**
+     * Enable or disable the Hyperstack VM Agent (Enhanced Metrics) for an existing virtual machine. The agent itself must be installed/removed manually inside the VM — the response includes the install command when enabling.
+     * @summary Enable or disable Enhanced Metrics for a virtual machine
+     * @param {number} vmId
+     * @param {UserEnhancedMetricsPayload} payload
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof VirtualMachineApi
+     */
+    toggleEnhancedMetricsForAVM(vmId: number, payload: UserEnhancedMetricsPayload, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<UserEnhancedMetricsResponse, any, {}, any>>;
 }
 /**
  * @export

package/dist/api.js

@@ -16466,6 +16466,42 @@ const VirtualMachineApiAxiosParamCreator = function (configuration) {
                 options: localVarRequestOptions,
             };
         }),
+        /**
+         * Enable or disable the Hyperstack VM Agent (Enhanced Metrics) for an existing virtual machine. The agent itself must be installed/removed manually inside the VM — the response includes the install command when enabling.
+         * @summary Enable or disable Enhanced Metrics for a virtual machine
+         * @param {number} vmId
+         * @param {UserEnhancedMetricsPayload} payload
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        toggleEnhancedMetricsForAVM: (vmId_1, payload_1, ...args_1) => __awaiter(this, [vmId_1, payload_1, ...args_1], void 0, function* (vmId, payload, options = {}) {
+            // verify required parameter 'vmId' is not null or undefined
+            (0, common_1.assertParamExists)('toggleEnhancedMetricsForAVM', 'vmId', vmId);
+            // verify required parameter 'payload' is not null or undefined
+            (0, common_1.assertParamExists)('toggleEnhancedMetricsForAVM', 'payload', payload);
+            const localVarPath = `/core/virtual-machines/{vm_id}/enhanced-metrics`
+                .replace(`{${"vm_id"}}`, encodeURIComponent(String(vmId)));
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, common_1.DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+            const localVarRequestOptions = Object.assign(Object.assign({ method: 'PATCH' }, baseOptions), options);
+            const localVarHeaderParameter = {};
+            const localVarQueryParameter = {};
+            // authentication apiKey required
+            yield (0, common_1.setApiKeyToObject)(localVarHeaderParameter, "api_key", configuration);
+            localVarHeaderParameter['Content-Type'] = 'application/json';
+            (0, common_1.setSearchParams)(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = Object.assign(Object.assign(Object.assign({}, localVarHeaderParameter), headersFromBaseOptions), options.headers);
+            localVarRequestOptions.data = (0, common_1.serializeDataIfNeeded)(payload, localVarRequestOptions, configuration);
+            return {
+                url: (0, common_1.toPathString)(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        }),
     };
 };
 exports.VirtualMachineApiAxiosParamCreator = VirtualMachineApiAxiosParamCreator;
@@ -16815,6 +16851,23 @@ const VirtualMachineApiFp = function (configuration) {
                 return (axios, basePath) => (0, common_1.createRequestFunction)(localVarAxiosArgs, axios_1.default, base_1.BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
             });
         },
+        /**
+         * Enable or disable the Hyperstack VM Agent (Enhanced Metrics) for an existing virtual machine. The agent itself must be installed/removed manually inside the VM — the response includes the install command when enabling.
+         * @summary Enable or disable Enhanced Metrics for a virtual machine
+         * @param {number} vmId
+         * @param {UserEnhancedMetricsPayload} payload
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        toggleEnhancedMetricsForAVM(vmId, payload, options) {
+            return __awaiter(this, void 0, void 0, function* () {
+                var _a, _b, _c;
+                const localVarAxiosArgs = yield localVarAxiosParamCreator.toggleEnhancedMetricsForAVM(vmId, payload, options);
+                const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
+                const localVarOperationServerBasePath = (_c = (_b = base_1.operationServerMap['VirtualMachineApi.toggleEnhancedMetricsForAVM']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
+                return (axios, basePath) => (0, common_1.createRequestFunction)(localVarAxiosArgs, axios_1.default, base_1.BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+            });
+        },
     };
 };
 exports.VirtualMachineApiFp = VirtualMachineApiFp;
@@ -17044,6 +17097,17 @@ const VirtualMachineApiFactory = function (configuration, basePath, axios) {
         stopVM(vmId, options) {
             return localVarFp.stopVM(vmId, options).then((request) => request(axios, basePath));
         },
+        /**
+         * Enable or disable the Hyperstack VM Agent (Enhanced Metrics) for an existing virtual machine. The agent itself must be installed/removed manually inside the VM — the response includes the install command when enabling.
+         * @summary Enable or disable Enhanced Metrics for a virtual machine
+         * @param {number} vmId
+         * @param {UserEnhancedMetricsPayload} payload
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        toggleEnhancedMetricsForAVM(vmId, payload, options) {
+            return localVarFp.toggleEnhancedMetricsForAVM(vmId, payload, options).then((request) => request(axios, basePath));
+        },
     };
 };
 exports.VirtualMachineApiFactory = VirtualMachineApiFactory;
@@ -17293,6 +17357,18 @@ class VirtualMachineApi extends base_1.BaseAPI {
     stopVM(vmId, options) {
         return (0, exports.VirtualMachineApiFp)(this.configuration).stopVM(vmId, options).then((request) => request(this.axios, this.basePath));
     }
+    /**
+     * Enable or disable the Hyperstack VM Agent (Enhanced Metrics) for an existing virtual machine. The agent itself must be installed/removed manually inside the VM — the response includes the install command when enabling.
+     * @summary Enable or disable Enhanced Metrics for a virtual machine
+     * @param {number} vmId
+     * @param {UserEnhancedMetricsPayload} payload
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof VirtualMachineApi
+     */
+    toggleEnhancedMetricsForAVM(vmId, payload, options) {
+        return (0, exports.VirtualMachineApiFp)(this.configuration).toggleEnhancedMetricsForAVM(vmId, payload, options).then((request) => request(this.axios, this.basePath));
+    }
 }
 exports.VirtualMachineApi = VirtualMachineApi;
 /**

package/dist/esm/api.d.ts

@@ -2665,6 +2665,12 @@ export interface CreateInstancesPayload {
      * @memberof CreateInstancesPayload
      */
     'enable_port_randomization'?: boolean;
+    /**
+     * When true, the Hyperstack VM Agent is opted in for this VM and metrics ingestion is allowed by the prom-gateway. The agent must still be installed on the VM (typically via user_data cloud-init).
+     * @type {boolean}
+     * @memberof CreateInstancesPayload
+     */
+    'enhanced_monitoring_enabled'?: boolean;
     /**
      * The name of the [environment](https://docs.hyperstack.cloud/docs/api-reference/core-resources/environments/) in which the virtual machine is to be created.
      * @type {string}
@@ -4959,6 +4965,19 @@ export interface Instance {
      */
     'status'?: boolean;
 }
+/**
+ *
+ * @export
+ * @interface InstanceEnhancedMetricsFields
+ */
+export interface InstanceEnhancedMetricsFields {
+    /**
+     *
+     * @type {boolean}
+     * @memberof InstanceEnhancedMetricsFields
+     */
+    'enabled'?: boolean;
+}
 /**
  *
  * @export
@@ -5100,6 +5119,12 @@ export interface InstanceFields {
      * @memberof InstanceFields
      */
     'created_at'?: string;
+    /**
+     *
+     * @type {InstanceEnhancedMetricsFields}
+     * @memberof InstanceFields
+     */
+    'enhanced_metrics'?: InstanceEnhancedMetricsFields;
     /**
      *
      * @type {InstanceEnvironmentFields}
@@ -10140,6 +10165,63 @@ export interface UserDefaultChoicesForUserResponse {
      */
     'user_default_choices'?: Array<UserDefaultChoiceForUserFields>;
 }
+/**
+ *
+ * @export
+ * @interface UserEnhancedMetricsPayload
+ */
+export interface UserEnhancedMetricsPayload {
+    /**
+     * Set to true to opt this VM into Enhanced Metrics, false to opt out.
+     * @type {boolean}
+     * @memberof UserEnhancedMetricsPayload
+     */
+    'enabled': boolean;
+}
+/**
+ *
+ * @export
+ * @interface UserEnhancedMetricsResponse
+ */
+export interface UserEnhancedMetricsResponse {
+    /**
+     * One-liner the user can run inside the VM to install the agent when enabling. Omitted when disabling.
+     * @type {string}
+     * @memberof UserEnhancedMetricsResponse
+     */
+    'install_command'?: string;
+    /**
+     *
+     * @type {string}
+     * @memberof UserEnhancedMetricsResponse
+     */
+    'message'?: string;
+    /**
+     *
+     * @type {UserEnhancedMetricsResponseFields}
+     * @memberof UserEnhancedMetricsResponse
+     */
+    'metrics'?: UserEnhancedMetricsResponseFields;
+    /**
+     *
+     * @type {boolean}
+     * @memberof UserEnhancedMetricsResponse
+     */
+    'status'?: boolean;
+}
+/**
+ *
+ * @export
+ * @interface UserEnhancedMetricsResponseFields
+ */
+export interface UserEnhancedMetricsResponseFields {
+    /**
+     *
+     * @type {boolean}
+     * @memberof UserEnhancedMetricsResponseFields
+     */
+    'enabled'?: boolean;
+}
 /**
  *
  * @export
@@ -19085,6 +19167,15 @@ export declare const VirtualMachineApiAxiosParamCreator: (configuration?: Config
      * @throws {RequiredError}
      */
     stopVM: (vmId: number, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * Enable or disable the Hyperstack VM Agent (Enhanced Metrics) for an existing virtual machine. The agent itself must be installed/removed manually inside the VM — the response includes the install command when enabling.
+     * @summary Enable or disable Enhanced Metrics for a virtual machine
+     * @param {number} vmId
+     * @param {UserEnhancedMetricsPayload} payload
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    toggleEnhancedMetricsForAVM: (vmId: number, payload: UserEnhancedMetricsPayload, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
 };
 /**
  * VirtualMachineApi - functional programming interface
@@ -19270,6 +19361,15 @@ export declare const VirtualMachineApiFp: (configuration?: Configuration) => {
      * @throws {RequiredError}
      */
     stopVM(vmId: number, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<ResponseModel>>;
+    /**
+     * Enable or disable the Hyperstack VM Agent (Enhanced Metrics) for an existing virtual machine. The agent itself must be installed/removed manually inside the VM — the response includes the install command when enabling.
+     * @summary Enable or disable Enhanced Metrics for a virtual machine
+     * @param {number} vmId
+     * @param {UserEnhancedMetricsPayload} payload
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    toggleEnhancedMetricsForAVM(vmId: number, payload: UserEnhancedMetricsPayload, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<UserEnhancedMetricsResponse>>;
 };
 /**
  * VirtualMachineApi - factory interface
@@ -19455,6 +19555,15 @@ export declare const VirtualMachineApiFactory: (configuration?: Configuration, b
      * @throws {RequiredError}
      */
     stopVM(vmId: number, options?: RawAxiosRequestConfig): AxiosPromise<ResponseModel>;
+    /**
+     * Enable or disable the Hyperstack VM Agent (Enhanced Metrics) for an existing virtual machine. The agent itself must be installed/removed manually inside the VM — the response includes the install command when enabling.
+     * @summary Enable or disable Enhanced Metrics for a virtual machine
+     * @param {number} vmId
+     * @param {UserEnhancedMetricsPayload} payload
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    toggleEnhancedMetricsForAVM(vmId: number, payload: UserEnhancedMetricsPayload, options?: RawAxiosRequestConfig): AxiosPromise<UserEnhancedMetricsResponse>;
 };
 /**
  * VirtualMachineApi - object-oriented interface
@@ -19662,6 +19771,16 @@ export declare class VirtualMachineApi extends BaseAPI {
      * @memberof VirtualMachineApi
      */
     stopVM(vmId: number, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<ResponseModel, any, {}, any>>;
+    /**
+     * Enable or disable the Hyperstack VM Agent (Enhanced Metrics) for an existing virtual machine. The agent itself must be installed/removed manually inside the VM — the response includes the install command when enabling.
+     * @summary Enable or disable Enhanced Metrics for a virtual machine
+     * @param {number} vmId
+     * @param {UserEnhancedMetricsPayload} payload
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof VirtualMachineApi
+     */
+    toggleEnhancedMetricsForAVM(vmId: number, payload: UserEnhancedMetricsPayload, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<UserEnhancedMetricsResponse, any, {}, any>>;
 }
 /**
  * @export

package/dist/esm/api.js

@@ -16259,6 +16259,42 @@ export const VirtualMachineApiAxiosParamCreator = function (configuration) {
                 options: localVarRequestOptions,
             };
         }),
+        /**
+         * Enable or disable the Hyperstack VM Agent (Enhanced Metrics) for an existing virtual machine. The agent itself must be installed/removed manually inside the VM — the response includes the install command when enabling.
+         * @summary Enable or disable Enhanced Metrics for a virtual machine
+         * @param {number} vmId
+         * @param {UserEnhancedMetricsPayload} payload
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        toggleEnhancedMetricsForAVM: (vmId_1, payload_1, ...args_1) => __awaiter(this, [vmId_1, payload_1, ...args_1], void 0, function* (vmId, payload, options = {}) {
+            // verify required parameter 'vmId' is not null or undefined
+            assertParamExists('toggleEnhancedMetricsForAVM', 'vmId', vmId);
+            // verify required parameter 'payload' is not null or undefined
+            assertParamExists('toggleEnhancedMetricsForAVM', 'payload', payload);
+            const localVarPath = `/core/virtual-machines/{vm_id}/enhanced-metrics`
+                .replace(`{${"vm_id"}}`, encodeURIComponent(String(vmId)));
+            // 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 = Object.assign(Object.assign({ method: 'PATCH' }, baseOptions), options);
+            const localVarHeaderParameter = {};
+            const localVarQueryParameter = {};
+            // authentication apiKey required
+            yield setApiKeyToObject(localVarHeaderParameter, "api_key", configuration);
+            localVarHeaderParameter['Content-Type'] = 'application/json';
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = Object.assign(Object.assign(Object.assign({}, localVarHeaderParameter), headersFromBaseOptions), options.headers);
+            localVarRequestOptions.data = serializeDataIfNeeded(payload, localVarRequestOptions, configuration);
+            return {
+                url: toPathString(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        }),
     };
 };
 /**
@@ -16607,6 +16643,23 @@ export const VirtualMachineApiFp = function (configuration) {
                 return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
             });
         },
+        /**
+         * Enable or disable the Hyperstack VM Agent (Enhanced Metrics) for an existing virtual machine. The agent itself must be installed/removed manually inside the VM — the response includes the install command when enabling.
+         * @summary Enable or disable Enhanced Metrics for a virtual machine
+         * @param {number} vmId
+         * @param {UserEnhancedMetricsPayload} payload
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        toggleEnhancedMetricsForAVM(vmId, payload, options) {
+            return __awaiter(this, void 0, void 0, function* () {
+                var _a, _b, _c;
+                const localVarAxiosArgs = yield localVarAxiosParamCreator.toggleEnhancedMetricsForAVM(vmId, payload, options);
+                const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
+                const localVarOperationServerBasePath = (_c = (_b = operationServerMap['VirtualMachineApi.toggleEnhancedMetricsForAVM']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
+                return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+            });
+        },
     };
 };
 /**
@@ -16835,6 +16888,17 @@ export const VirtualMachineApiFactory = function (configuration, basePath, axios
         stopVM(vmId, options) {
             return localVarFp.stopVM(vmId, options).then((request) => request(axios, basePath));
         },
+        /**
+         * Enable or disable the Hyperstack VM Agent (Enhanced Metrics) for an existing virtual machine. The agent itself must be installed/removed manually inside the VM — the response includes the install command when enabling.
+         * @summary Enable or disable Enhanced Metrics for a virtual machine
+         * @param {number} vmId
+         * @param {UserEnhancedMetricsPayload} payload
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        toggleEnhancedMetricsForAVM(vmId, payload, options) {
+            return localVarFp.toggleEnhancedMetricsForAVM(vmId, payload, options).then((request) => request(axios, basePath));
+        },
     };
 };
 /**
@@ -17083,6 +17147,18 @@ export class VirtualMachineApi extends BaseAPI {
     stopVM(vmId, options) {
         return VirtualMachineApiFp(this.configuration).stopVM(vmId, options).then((request) => request(this.axios, this.basePath));
     }
+    /**
+     * Enable or disable the Hyperstack VM Agent (Enhanced Metrics) for an existing virtual machine. The agent itself must be installed/removed manually inside the VM — the response includes the install command when enabling.
+     * @summary Enable or disable Enhanced Metrics for a virtual machine
+     * @param {number} vmId
+     * @param {UserEnhancedMetricsPayload} payload
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof VirtualMachineApi
+     */
+    toggleEnhancedMetricsForAVM(vmId, payload, options) {
+        return VirtualMachineApiFp(this.configuration).toggleEnhancedMetricsForAVM(vmId, payload, options).then((request) => request(this.axios, this.basePath));
+    }
 }
 /**
  * @export

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nexgencloud/hyperstack-sdk-typescript",
-  "version": "v1.54.7-alpha",
+  "version": "v1.55.1-alpha",
   "description": "Leverage the Infrahub API and Hyperstack platform to easily create, manage, and scale powerful GPU virtual machines and their associated resources.   Access this SDK to automate the deployment of your workloads and streamline your infrastructure management.  To contribute, please raise an issue with a bug report, feature request, feedback, or general inquiry.",
   "author": "OpenAPI-Generator Contributors",
   "repository": {