@xen-orchestra/rest-api 0.17.0 → 0.18.0

package/dist/abstract-classes/xapi-xo-controller.mjs

@@ -1,4 +1,6 @@
 import { BaseController } from './base-controller.mjs';
+import { escapeUnsafeComplexMatcher } from '../helpers/utils.helper.mjs';
+import { RAW_ALARM_FILTER } from '../alarms/alarm.service.mjs';
 export class XapiXoController extends BaseController {
     #type;
     constructor(type, restApi) {
@@ -14,4 +16,12 @@ export class XapiXoController extends BaseController {
     getXapiObject(maybeId) {
         return this.restApi.getXapiObject(maybeId, this.#type);
     }
+    getMessagesForObject(id, { filter, limit } = {}) {
+        const object = this.getObject(id);
+        const messages = this.restApi.getObjectsByType('message', {
+            filter: `${escapeUnsafeComplexMatcher(filter) ?? ''} $object:${object.uuid} !${RAW_ALARM_FILTER}`,
+            limit,
+        });
+        return messages;
+    }
 }

package/dist/hosts/host.controller.mjs

@@ -19,6 +19,7 @@ import { RestApi } from '../rest-api/rest-api.mjs';
 import { XapiXoController } from '../abstract-classes/xapi-xo-controller.mjs';
 import { featureUnauthorized, internalServerErrorResp, notFoundResp, unauthorizedResp, } from '../open-api/common/response.common.mjs';
 import { HostService } from './host.service.mjs';
+import { messageIds, partialMessages } from '../open-api/oa-examples/message.oa-example.mjs';
 let HostController = class HostController extends XapiXoController {
     #alarmService;
     #hostService;
@@ -117,6 +118,16 @@ let HostController = class HostController extends XapiXoController {
         const { missingPatches } = await this.#hostService.getMissingPatchesInfo({ filter: host => host.id === id });
         return missingPatches;
     }
+    /**
+     * @example id "b61a5c92-700e-4966-a13b-00633f03eea8"
+     * @example fields "name,id,$object"
+     * @example filter "name:PBD_PLUG_FAILED_ON_SERVER_START"
+     * @example limit 42
+     */
+    getHostMessages(req, id, fields, ndjson, filter, limit) {
+        const messages = this.getMessagesForObject(id, { filter, limit });
+        return this.sendObjects(Object.values(messages), req, 'messages');
+    }
 };
 __decorate([
     Example(hostIds),
@@ -185,6 +196,19 @@ __decorate([
     Response(featureUnauthorized.status, featureUnauthorized.description),
     __param(0, Path())
 ], HostController.prototype, "getMissingPatches", null);
+__decorate([
+    Example(messageIds),
+    Example(partialMessages),
+    Get('{id}/messages'),
+    Tags('messages'),
+    Response(notFoundResp.status, notFoundResp.description),
+    __param(0, Request()),
+    __param(1, Path()),
+    __param(2, Query()),
+    __param(3, Query()),
+    __param(4, Query()),
+    __param(5, Query())
+], HostController.prototype, "getHostMessages", null);
 HostController = __decorate([
     Route('hosts'),
     Security('*'),

package/dist/messages/message.controller.mjs

@@ -77,7 +77,7 @@ MessageController = __decorate([
     Route('messages'),
     Security('*'),
     Response(unauthorizedResp.status, unauthorizedResp.description),
-    Tags('message'),
+    Tags('messages'),
     provide(MessageController),
     __param(0, inject(RestApi))
 ], MessageController);

package/dist/open-api/routes/routes.js

@@ -3293,6 +3293,38 @@ export function RegisterRoutes(app) {
         }
     });
     // WARNING: This file was auto-generated with tsoa. Please do not modify it. Re-run tsoa to re-generate this file: https://github.com/lukeautry/tsoa
+    const argsSrController_getSrMessages = {
+        req: { "in": "request", "name": "req", "required": true, "dataType": "object" },
+        id: { "in": "path", "name": "id", "required": true, "dataType": "string" },
+        fields: { "in": "query", "name": "fields", "dataType": "string" },
+        ndjson: { "in": "query", "name": "ndjson", "dataType": "boolean" },
+        filter: { "in": "query", "name": "filter", "dataType": "string" },
+        limit: { "in": "query", "name": "limit", "dataType": "double" },
+    };
+    app.get('/rest/v0/srs/:id/messages', authenticateMiddleware([{ "*": [] }]), ...(fetchMiddlewares(SrController)), ...(fetchMiddlewares(SrController.prototype.getSrMessages)), async function SrController_getSrMessages(request, response, next) {
+        // WARNING: This file was auto-generated with tsoa. Please do not modify it. Re-run tsoa to re-generate this file: https://github.com/lukeautry/tsoa
+        let validatedArgs = [];
+        try {
+            validatedArgs = templateService.getValidatedArgs({ args: argsSrController_getSrMessages, request, response });
+            const container = typeof iocContainer === 'function' ? iocContainer(request) : iocContainer;
+            const controller = await container.get(SrController);
+            if (typeof controller['setStatus'] === 'function') {
+                controller.setStatus(undefined);
+            }
+            await templateService.apiHandler({
+                methodName: 'getSrMessages',
+                controller,
+                response,
+                next,
+                validatedArgs,
+                successStatus: undefined,
+            });
+        }
+        catch (err) {
+            return next(err);
+        }
+    });
+    // WARNING: This file was auto-generated with tsoa. Please do not modify it. Re-run tsoa to re-generate this file: https://github.com/lukeautry/tsoa
     const argsSmController_getSrs = {
         req: { "in": "request", "name": "req", "required": true, "dataType": "object" },
         fields: { "in": "query", "name": "fields", "dataType": "string" },
@@ -4124,6 +4156,38 @@ export function RegisterRoutes(app) {
         }
     });
     // WARNING: This file was auto-generated with tsoa. Please do not modify it. Re-run tsoa to re-generate this file: https://github.com/lukeautry/tsoa
+    const argsPoolController_getPoolMessages = {
+        req: { "in": "request", "name": "req", "required": true, "dataType": "object" },
+        id: { "in": "path", "name": "id", "required": true, "dataType": "string" },
+        fields: { "in": "query", "name": "fields", "dataType": "string" },
+        ndjson: { "in": "query", "name": "ndjson", "dataType": "boolean" },
+        filter: { "in": "query", "name": "filter", "dataType": "string" },
+        limit: { "in": "query", "name": "limit", "dataType": "double" },
+    };
+    app.get('/rest/v0/pools/:id/messages', authenticateMiddleware([{ "*": [] }]), ...(fetchMiddlewares(PoolController)), ...(fetchMiddlewares(PoolController.prototype.getPoolMessages)), async function PoolController_getPoolMessages(request, response, next) {
+        // WARNING: This file was auto-generated with tsoa. Please do not modify it. Re-run tsoa to re-generate this file: https://github.com/lukeautry/tsoa
+        let validatedArgs = [];
+        try {
+            validatedArgs = templateService.getValidatedArgs({ args: argsPoolController_getPoolMessages, request, response });
+            const container = typeof iocContainer === 'function' ? iocContainer(request) : iocContainer;
+            const controller = await container.get(PoolController);
+            if (typeof controller['setStatus'] === 'function') {
+                controller.setStatus(undefined);
+            }
+            await templateService.apiHandler({
+                methodName: 'getPoolMessages',
+                controller,
+                response,
+                next,
+                validatedArgs,
+                successStatus: undefined,
+            });
+        }
+        catch (err) {
+            return next(err);
+        }
+    });
+    // WARNING: This file was auto-generated with tsoa. Please do not modify it. Re-run tsoa to re-generate this file: https://github.com/lukeautry/tsoa
     const argsPifController_getPifs = {
         req: { "in": "request", "name": "req", "required": true, "dataType": "object" },
         fields: { "in": "query", "name": "fields", "dataType": "string" },
@@ -4733,6 +4797,38 @@ export function RegisterRoutes(app) {
         }
     });
     // WARNING: This file was auto-generated with tsoa. Please do not modify it. Re-run tsoa to re-generate this file: https://github.com/lukeautry/tsoa
+    const argsHostController_getHostMessages = {
+        req: { "in": "request", "name": "req", "required": true, "dataType": "object" },
+        id: { "in": "path", "name": "id", "required": true, "dataType": "string" },
+        fields: { "in": "query", "name": "fields", "dataType": "string" },
+        ndjson: { "in": "query", "name": "ndjson", "dataType": "boolean" },
+        filter: { "in": "query", "name": "filter", "dataType": "string" },
+        limit: { "in": "query", "name": "limit", "dataType": "double" },
+    };
+    app.get('/rest/v0/hosts/:id/messages', authenticateMiddleware([{ "*": [] }]), ...(fetchMiddlewares(HostController)), ...(fetchMiddlewares(HostController.prototype.getHostMessages)), async function HostController_getHostMessages(request, response, next) {
+        // WARNING: This file was auto-generated with tsoa. Please do not modify it. Re-run tsoa to re-generate this file: https://github.com/lukeautry/tsoa
+        let validatedArgs = [];
+        try {
+            validatedArgs = templateService.getValidatedArgs({ args: argsHostController_getHostMessages, request, response });
+            const container = typeof iocContainer === 'function' ? iocContainer(request) : iocContainer;
+            const controller = await container.get(HostController);
+            if (typeof controller['setStatus'] === 'function') {
+                controller.setStatus(undefined);
+            }
+            await templateService.apiHandler({
+                methodName: 'getHostMessages',
+                controller,
+                response,
+                next,
+                validatedArgs,
+                successStatus: undefined,
+            });
+        }
+        catch (err) {
+            return next(err);
+        }
+    });
+    // WARNING: This file was auto-generated with tsoa. Please do not modify it. Re-run tsoa to re-generate this file: https://github.com/lukeautry/tsoa
     const argsGroupController_getGroups = {
         req: { "in": "request", "name": "req", "required": true, "dataType": "object" },
         fields: { "in": "query", "name": "fields", "dataType": "string" },

package/dist/pools/pool.controller.mjs

@@ -24,6 +24,7 @@ import { BASE_URL } from '../index.mjs';
 import { VmService } from '../vms/vm.service.mjs';
 import { PoolService } from './pool.service.mjs';
 import { escapeUnsafeComplexMatcher, NDJSON_CONTENT_TYPE } from '../helpers/utils.helper.mjs';
+import { messageIds, partialMessages } from '../open-api/oa-examples/message.oa-example.mjs';
 let PoolController = class PoolController extends XapiXoController {
     #vmService;
     #poolService;
@@ -229,6 +230,16 @@ let PoolController = class PoolController extends XapiXoController {
         const { missingPatches } = await this.#poolService.getMissingPatches(pool.id);
         return missingPatches;
     }
+    /**
+     * @example id "355ee47d-ff4c-4924-3db2-fd86ae629676"
+     * @example fields "name,id,$object"
+     * @example filter "name:IP_CONFIGURED_PIF_CAN_UNPLUG"
+     * @example limit 42
+     */
+    getPoolMessages(req, id, fields, ndjson, filter, limit) {
+        const messages = this.getMessagesForObject(id, { filter, limit });
+        return this.sendObjects(Object.values(messages), req, 'messages');
+    }
 };
 __decorate([
     Example(poolIds),
@@ -350,6 +361,19 @@ __decorate([
     Response(featureUnauthorized.status, featureUnauthorized.description),
     __param(0, Path())
 ], PoolController.prototype, "getPoolMissingPatches", null);
+__decorate([
+    Example(messageIds),
+    Example(partialMessages),
+    Get('{id}/messages'),
+    Tags('messages'),
+    Response(notFoundResp.status, notFoundResp.description),
+    __param(0, Request()),
+    __param(1, Path()),
+    __param(2, Query()),
+    __param(3, Query()),
+    __param(4, Query()),
+    __param(5, Query())
+], PoolController.prototype, "getPoolMessages", null);
 PoolController = __decorate([
     Route('pools'),
     Security('*'),

package/dist/srs/sr.controller.mjs

@@ -20,6 +20,7 @@ import { partialSrs, sr, srIds } from '../open-api/oa-examples/sr.oa-example.mjs
 import { vdiId } from '../open-api/oa-examples/vdi.oa-example.mjs';
 import { RestApi } from '../rest-api/rest-api.mjs';
 import { XapiXoController } from '../abstract-classes/xapi-xo-controller.mjs';
+import { messageIds, partialMessages } from '../open-api/oa-examples/message.oa-example.mjs';
 let SrController = class SrController extends XapiXoController {
     #alarmService;
     constructor(restApi, alarmService) {
@@ -76,6 +77,16 @@ let SrController = class SrController extends XapiXoController {
         this.setHeader('Location', `${BASE_URL}/vdis/${vdiId}`);
         return { id: vdiId };
     }
+    /**
+     * @example id "c4284e12-37c9-7967-b9e8-83ef229c3e03"
+     * @example fields "name,id,$object"
+     * @example filter "name:VM_STARTED"
+     * @example limit 42
+     */
+    getSrMessages(req, id, fields, ndjson, filter, limit) {
+        const messages = this.getMessagesForObject(id, { filter, limit });
+        return this.sendObjects(Object.values(messages), req, 'messages');
+    }
 };
 __decorate([
     Example(srIds),
@@ -117,6 +128,19 @@ __decorate([
     __param(3, Query()),
     __param(4, Query())
 ], SrController.prototype, "srImportVdi", null);
+__decorate([
+    Example(messageIds),
+    Example(partialMessages),
+    Get('{id}/messages'),
+    Tags('messages'),
+    Response(notFoundResp.status, notFoundResp.description),
+    __param(0, Request()),
+    __param(1, Path()),
+    __param(2, Query()),
+    __param(3, Query()),
+    __param(4, Query()),
+    __param(5, Query())
+], SrController.prototype, "getSrMessages", null);
 SrController = __decorate([
     Route('srs'),
     Security('*'),

package/dist/vm-snapshots/vm-snapshot.controller.mjs

@@ -9,7 +9,7 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
 };
 import { Delete, Example, Get, Path, Query, Request, Response, Route, Security, SuccessResponse, Tags } from 'tsoa';
 import { inject } from 'inversify';
-import { AlarmService, RAW_ALARM_FILTER } from '../alarms/alarm.service.mjs';
+import { AlarmService } from '../alarms/alarm.service.mjs';
 import { escapeUnsafeComplexMatcher, limitAndFilterArray } from '../helpers/utils.helper.mjs';
 import { genericAlarmsExample } from '../open-api/oa-examples/alarm.oa-example.mjs';
 import { forbiddenOperationResp, incorrectStateResp, noContentResp, notFoundResp, unauthorizedResp, } from '../open-api/common/response.common.mjs';
@@ -96,11 +96,7 @@ let VmSnapshotController = class VmSnapshotController extends XapiXoController {
      * @example limit 42
      */
     getVmSnapshotsMessages(req, id, fields, ndjson, filter, limit) {
-        const vm = this.getObject(id);
-        const messages = this.restApi.getObjectsByType('message', {
-            filter: `${escapeUnsafeComplexMatcher(filter) ?? ''} $object:${vm.uuid} !${RAW_ALARM_FILTER}`,
-            limit,
-        });
+        const messages = this.getMessagesForObject(id, { filter, limit });
         return this.sendObjects(Object.values(messages), req, 'messages');
     }
 };

package/dist/vm-templates/vm-template.controller.mjs

@@ -10,7 +10,7 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
 import { Example, Get, Security, Query, Request, Response, Route, Tags, Path, Delete, SuccessResponse } from 'tsoa';
 import { inject } from 'inversify';
 import { provide } from 'inversify-binding-decorators';
-import { AlarmService, RAW_ALARM_FILTER } from '../alarms/alarm.service.mjs';
+import { AlarmService } from '../alarms/alarm.service.mjs';
 import { escapeUnsafeComplexMatcher, limitAndFilterArray } from '../helpers/utils.helper.mjs';
 import { genericAlarmsExample } from '../open-api/oa-examples/alarm.oa-example.mjs';
 import { forbiddenOperationResp, incorrectStateResp, noContentResp, notFoundResp, unauthorizedResp, } from '../open-api/common/response.common.mjs';
@@ -95,11 +95,7 @@ let VmTemplateController = class VmTemplateController extends XapiXoController {
      * @example limit 42
      */
     getVmTemplateMessages(req, id, fields, ndjson, filter, limit) {
-        const vmTemplate = this.getObject(id);
-        const messages = this.restApi.getObjectsByType('message', {
-            filter: `${escapeUnsafeComplexMatcher(filter) ?? ''} $object:${vmTemplate.uuid} !${RAW_ALARM_FILTER}`,
-            limit,
-        });
+        const messages = this.getMessagesForObject(id, { filter, limit });
         return this.sendObjects(Object.values(messages), req, 'messages');
     }
 };

package/dist/vms/vm.controller.mjs

@@ -11,7 +11,7 @@ import { Example, Get, Path, Post, Query, Request, Response, Route, Security, Ta
 import { inject } from 'inversify';
 import { incorrectState, invalidParameters } from 'xo-common/api-errors.js';
 import { provide } from 'inversify-binding-decorators';
-import { AlarmService, RAW_ALARM_FILTER } from '../alarms/alarm.service.mjs';
+import { AlarmService } from '../alarms/alarm.service.mjs';
 import { asynchronousActionResp, createdResp, forbiddenOperationResp, incorrectStateResp, internalServerErrorResp, noContentResp, notFoundResp, unauthorizedResp, } from '../open-api/common/response.common.mjs';
 import { BASE_URL } from '../index.mjs';
 import { escapeUnsafeComplexMatcher, limitAndFilterArray } from '../helpers/utils.helper.mjs';
@@ -376,11 +376,7 @@ let VmController = class VmController extends XapiXoController {
      * @example limit 42
      */
     getVmMessages(req, id, fields, ndjson, filter, limit) {
-        const vm = this.getObject(id);
-        const messages = this.restApi.getObjectsByType('message', {
-            filter: `${escapeUnsafeComplexMatcher(filter) ?? ''} $object:${vm.uuid} !${RAW_ALARM_FILTER}`,
-            limit,
-        });
+        const messages = this.getMessagesForObject(id, { filter, limit });
         return this.sendObjects(Object.values(messages), req, 'messages');
     }
     /**

package/open-api/spec/swagger.json

@@ -10867,7 +10867,7 @@
 	},
 	"info": {
 		"title": "@xen-orchestra/rest-api",
-		"version": "0.17.0",
+		"version": "0.18.0",
 		"description": "REST API to manage your XOA",
 		"license": {
 			"name": "AGPL-3.0-or-later"
@@ -18071,6 +18071,111 @@
 				]
 			}
 		},
+		"/srs/{id}/messages": {
+			"get": {
+				"operationId": "GetSrMessages",
+				"responses": {
+					"200": {
+						"description": "Ok",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "#/components/schemas/SendObjects_Partial_Unbrand_XoMessage___"
+								},
+								"examples": {
+									"Example 1": {
+										"value": [
+											"/rest/v0/messages/f775eaeb-abe5-94e0-9682-14c37c3a1dfe",
+											"/rest/v0/messages/ed2d1623-3e65-8d39-7a14-4eb69274c5e3"
+										]
+									},
+									"Example 2": {
+										"value": [
+											{
+												"name": "VM_STARTED",
+												"body": "VM 'Alpine MRA' (uuid: cef5f68c-61ae-3831-d2e6-1590d4934acf) started on host: XCP 8.3.0 master (uuid: b61a5c92-700e-4966-a13b-00633f03eea8)",
+												"id": "f775eaeb-abe5-94e0-9682-14c37c3a1dfe",
+												"$object": "cef5f68c-61ae-3831-d2e6-1590d4934acf",
+												"href": "/rest/v0/messages/f775eaeb-abe5-94e0-9682-14c37c3a1dfe"
+											},
+											{
+												"name": "VM_STARTED",
+												"body": "VM 'Alpine MRA' (uuid: cef5f68c-61ae-3831-d2e6-1590d4934acf) started on host: XCP 8.3.0 master (uuid: b61a5c92-700e-4966-a13b-00633f03eea8)",
+												"id": "ed2d1623-3e65-8d39-7a14-4eb69274c5e3",
+												"$object": "cef5f68c-61ae-3831-d2e6-1590d4934acf",
+												"href": "/rest/v0/messages/ed2d1623-3e65-8d39-7a14-4eb69274c5e3"
+											}
+										]
+									}
+								}
+							}
+						}
+					},
+					"401": {
+						"description": "Authentication required"
+					},
+					"404": {
+						"description": "Resource not found"
+					}
+				},
+				"tags": [
+					"messages",
+					"srs"
+				],
+				"security": [
+					{
+						"*": []
+					}
+				],
+				"parameters": [
+					{
+						"in": "path",
+						"name": "id",
+						"required": true,
+						"schema": {
+							"type": "string"
+						},
+						"example": "c4284e12-37c9-7967-b9e8-83ef229c3e03"
+					},
+					{
+						"in": "query",
+						"name": "fields",
+						"required": false,
+						"schema": {
+							"type": "string"
+						},
+						"example": "name,id,$object"
+					},
+					{
+						"in": "query",
+						"name": "ndjson",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
+					{
+						"in": "query",
+						"name": "filter",
+						"required": false,
+						"schema": {
+							"type": "string"
+						},
+						"example": "name:VM_STARTED"
+					},
+					{
+						"in": "query",
+						"name": "limit",
+						"required": false,
+						"schema": {
+							"format": "double",
+							"type": "number"
+						},
+						"example": 42
+					}
+				]
+			}
+		},
 		"/sms": {
 			"get": {
 				"operationId": "GetSrs",
@@ -22383,6 +22488,111 @@
 				]
 			}
 		},
+		"/pools/{id}/messages": {
+			"get": {
+				"operationId": "GetPoolMessages",
+				"responses": {
+					"200": {
+						"description": "Ok",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "#/components/schemas/SendObjects_Partial_Unbrand_XoMessage___"
+								},
+								"examples": {
+									"Example 1": {
+										"value": [
+											"/rest/v0/messages/f775eaeb-abe5-94e0-9682-14c37c3a1dfe",
+											"/rest/v0/messages/ed2d1623-3e65-8d39-7a14-4eb69274c5e3"
+										]
+									},
+									"Example 2": {
+										"value": [
+											{
+												"name": "VM_STARTED",
+												"body": "VM 'Alpine MRA' (uuid: cef5f68c-61ae-3831-d2e6-1590d4934acf) started on host: XCP 8.3.0 master (uuid: b61a5c92-700e-4966-a13b-00633f03eea8)",
+												"id": "f775eaeb-abe5-94e0-9682-14c37c3a1dfe",
+												"$object": "cef5f68c-61ae-3831-d2e6-1590d4934acf",
+												"href": "/rest/v0/messages/f775eaeb-abe5-94e0-9682-14c37c3a1dfe"
+											},
+											{
+												"name": "VM_STARTED",
+												"body": "VM 'Alpine MRA' (uuid: cef5f68c-61ae-3831-d2e6-1590d4934acf) started on host: XCP 8.3.0 master (uuid: b61a5c92-700e-4966-a13b-00633f03eea8)",
+												"id": "ed2d1623-3e65-8d39-7a14-4eb69274c5e3",
+												"$object": "cef5f68c-61ae-3831-d2e6-1590d4934acf",
+												"href": "/rest/v0/messages/ed2d1623-3e65-8d39-7a14-4eb69274c5e3"
+											}
+										]
+									}
+								}
+							}
+						}
+					},
+					"401": {
+						"description": "Authentication required"
+					},
+					"404": {
+						"description": "Resource not found"
+					}
+				},
+				"tags": [
+					"messages",
+					"pools"
+				],
+				"security": [
+					{
+						"*": []
+					}
+				],
+				"parameters": [
+					{
+						"in": "path",
+						"name": "id",
+						"required": true,
+						"schema": {
+							"type": "string"
+						},
+						"example": "355ee47d-ff4c-4924-3db2-fd86ae629676"
+					},
+					{
+						"in": "query",
+						"name": "fields",
+						"required": false,
+						"schema": {
+							"type": "string"
+						},
+						"example": "name,id,$object"
+					},
+					{
+						"in": "query",
+						"name": "ndjson",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
+					{
+						"in": "query",
+						"name": "filter",
+						"required": false,
+						"schema": {
+							"type": "string"
+						},
+						"example": "name:IP_CONFIGURED_PIF_CAN_UNPLUG"
+					},
+					{
+						"in": "query",
+						"name": "limit",
+						"required": false,
+						"schema": {
+							"format": "double",
+							"type": "number"
+						},
+						"example": 42
+					}
+				]
+			}
+		},
 		"/pifs": {
 			"get": {
 				"operationId": "GetPifs",
@@ -23290,7 +23500,7 @@
 					}
 				},
 				"tags": [
-					"message"
+					"messages"
 				],
 				"security": [
 					{
@@ -23375,7 +23585,7 @@
 					}
 				},
 				"tags": [
-					"message"
+					"messages"
 				],
 				"security": [
 					{
@@ -30297,6 +30507,111 @@
 				]
 			}
 		},
+		"/hosts/{id}/messages": {
+			"get": {
+				"operationId": "GetHostMessages",
+				"responses": {
+					"200": {
+						"description": "Ok",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "#/components/schemas/SendObjects_Partial_Unbrand_XoMessage___"
+								},
+								"examples": {
+									"Example 1": {
+										"value": [
+											"/rest/v0/messages/f775eaeb-abe5-94e0-9682-14c37c3a1dfe",
+											"/rest/v0/messages/ed2d1623-3e65-8d39-7a14-4eb69274c5e3"
+										]
+									},
+									"Example 2": {
+										"value": [
+											{
+												"name": "VM_STARTED",
+												"body": "VM 'Alpine MRA' (uuid: cef5f68c-61ae-3831-d2e6-1590d4934acf) started on host: XCP 8.3.0 master (uuid: b61a5c92-700e-4966-a13b-00633f03eea8)",
+												"id": "f775eaeb-abe5-94e0-9682-14c37c3a1dfe",
+												"$object": "cef5f68c-61ae-3831-d2e6-1590d4934acf",
+												"href": "/rest/v0/messages/f775eaeb-abe5-94e0-9682-14c37c3a1dfe"
+											},
+											{
+												"name": "VM_STARTED",
+												"body": "VM 'Alpine MRA' (uuid: cef5f68c-61ae-3831-d2e6-1590d4934acf) started on host: XCP 8.3.0 master (uuid: b61a5c92-700e-4966-a13b-00633f03eea8)",
+												"id": "ed2d1623-3e65-8d39-7a14-4eb69274c5e3",
+												"$object": "cef5f68c-61ae-3831-d2e6-1590d4934acf",
+												"href": "/rest/v0/messages/ed2d1623-3e65-8d39-7a14-4eb69274c5e3"
+											}
+										]
+									}
+								}
+							}
+						}
+					},
+					"401": {
+						"description": "Authentication required"
+					},
+					"404": {
+						"description": "Resource not found"
+					}
+				},
+				"tags": [
+					"messages",
+					"hosts"
+				],
+				"security": [
+					{
+						"*": []
+					}
+				],
+				"parameters": [
+					{
+						"in": "path",
+						"name": "id",
+						"required": true,
+						"schema": {
+							"type": "string"
+						},
+						"example": "b61a5c92-700e-4966-a13b-00633f03eea8"
+					},
+					{
+						"in": "query",
+						"name": "fields",
+						"required": false,
+						"schema": {
+							"type": "string"
+						},
+						"example": "name,id,$object"
+					},
+					{
+						"in": "query",
+						"name": "ndjson",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
+					{
+						"in": "query",
+						"name": "filter",
+						"required": false,
+						"schema": {
+							"type": "string"
+						},
+						"example": "name:PBD_PLUG_FAILED_ON_SERVER_START"
+					},
+					{
+						"in": "query",
+						"name": "limit",
+						"required": false,
+						"schema": {
+							"format": "double",
+							"type": "number"
+						},
+						"example": 42
+					}
+				]
+			}
+		},
 		"/groups": {
 			"get": {
 				"operationId": "GetGroups",

package/package.json

@@ -6,7 +6,7 @@
   "main": "./dist/index.mjs",
   "name": "@xen-orchestra/rest-api",
   "homepage": "https://github.com/vatesfr/xen-orchestra/tree/master/@xen-orchestra/rest-api",
-  "version": "0.17.0",
+  "version": "0.18.0",
   "description": "REST API to manage your XOA",
   "license": "AGPL-3.0-or-later",
   "private": false,
@@ -33,9 +33,9 @@
     "typescript-eslint": "^8.23.0"
   },
   "dependencies": {
-    "@vates/async-each": "^1.0.0",
+    "@vates/async-each": "^1.0.1",
     "@vates/task": "^0.6.1",
-    "@vates/types": "^1.12.0",
+    "@vates/types": "^1.12.1",
     "@xen-orchestra/backups": "^0.64.3",
     "@xen-orchestra/log": "^0.7.1",
     "complex-matcher": "^1.0.0",

package/tsconfig.json

@@ -9,6 +9,7 @@
     "moduleResolution": "bundler",
     "target": "ES2023",
     "skipLibCheck": true,
+    "types": ["node"], // Only use types from Node.js and packages that are explicitly imported
     "noImplicitAny": false, // otherwise it will throw an error when importing packages without type definition
 
     /* Experimental options */