From 526e8a63f9b93eeb36e9a83900a3ee8128bbc189 Mon Sep 17 00:00:00 2001 From: GitHub Action Date: Sun, 19 Jul 2026 05:24:09 +0000 Subject: [PATCH] chore: update Proxmox API specifications MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit ## 📊 API Specification Changes This PR contains automated updates to the Proxmox API specifications. ### PBS API Changes - Endpoints: 246 → 246 (+0) - File sizes: - JSON: 1.8M - YAML: 1.4M ### Validation Status ✅ All specifications pass OpenAPI 3.0.3 validation ### Performance Metrics ### Next Steps 1. Review the changes in the Files tab 2. Check for any breaking changes 3. Merge to update the API specifications --- *Generated automatically by GitHub Actions on 2026-07-19 05:24:09 UTC* --- pr_body.md | 4 +- proxmox-backup-server/apidoc.js | 48 ++++++++++++++--- proxmox-backup-server/pbs-api.json | 85 +++++++++++++++++++++++++++--- proxmox-backup-server/pbs-api.yaml | 72 ++++++++++++++++++++++--- 4 files changed, 187 insertions(+), 22 deletions(-) diff --git a/pr_body.md b/pr_body.md index 9ed07c6..c365b6e 100644 --- a/pr_body.md +++ b/pr_body.md @@ -4,7 +4,7 @@ This PR contains automated updates to the Proxmox API specifications. ### PBS API Changes -- Endpoints: 240 → 246 (+6) +- Endpoints: 246 → 246 (+0) - File sizes: - JSON: 1.8M - YAML: 1.4M @@ -23,4 +23,4 @@ This PR contains automated updates to the Proxmox API specifications. 3. Merge to update the API specifications --- -*Generated automatically by GitHub Actions on 2026-07-05 03:11:30 UTC* +*Generated automatically by GitHub Actions on 2026-07-19 05:24:09 UTC* diff --git a/proxmox-backup-server/apidoc.js b/proxmox-backup-server/apidoc.js index f9fd9ba..440cfc0 100644 --- a/proxmox-backup-server/apidoc.js +++ b/proxmox-backup-server/apidoc.js @@ -23569,7 +23569,7 @@ var apiSchema = [ "info": { "GET": { "description": "Read syslog entries.", - "method": "GET", + "method": "DOWNLOAD", "parameters": { "additionalProperties": false, "description": "Read syslog entries.", @@ -23579,6 +23579,18 @@ var apiSchema = [ "optional": 1, "type": "string" }, + "identifiers": { + "default": false, + "description": "Also list the distinct syslog identifiers present. Requires 'structured'.", + "optional": 1, + "type": "boolean" + }, + "kernel": { + "default": false, + "description": "Only print kernel messages.", + "optional": 1, + "type": "boolean" + }, "lastentries": { "description": "Limit to the last X lines. Conflicts with a range.", "minimum": 0, @@ -23590,6 +23602,16 @@ var apiSchema = [ "pattern": "/^(?:[a-zA-Z0-9](?:[a-zA-Z0-9\\-]*[a-zA-Z0-9])?)$/", "type": "string" }, + "priority": { + "description": "Only print messages of this syslog priority: a single level from 0 (emerg) to 7 (debug), selecting that level and everything more severe, or a 'LOW..HIGH' range. Empty means no filter.", + "optional": 1, + "type": "string" + }, + "service": { + "description": "Only print messages whose syslog identifier matches this glob.", + "optional": 1, + "type": "string" + }, "since": { "description": "Display all log since this UNIX epoch. Conflicts with 'startcursor'.", "minimum": 0, @@ -23601,6 +23623,23 @@ var apiSchema = [ "optional": 1, "type": "string" }, + "structured": { + "default": false, + "description": "Emit structured JSON with separate entry fields instead of plain text.", + "optional": 1, + "type": "boolean" + }, + "unit": { + "description": "Only print messages of this systemd unit (the .service suffix is implied).", + "optional": 1, + "type": "string" + }, + "units": { + "default": false, + "description": "Also list the distinct systemd units present. Requires 'structured'.", + "optional": 1, + "type": "boolean" + }, "until": { "description": "Display all log until this UNIX epoch. Conflicts with 'endcursor'.", "minimum": 0, @@ -23622,12 +23661,7 @@ var apiSchema = [ } }, "returns": { - "description": "Returns a list of journal entries.", - "items": { - "description": "Line text.", - "type": "string" - }, - "type": "array" + "type": "null" }, "unstable": false } diff --git a/proxmox-backup-server/pbs-api.json b/proxmox-backup-server/pbs-api.json index d4dd207..f23426a 100644 --- a/proxmox-backup-server/pbs-api.json +++ b/proxmox-backup-server/pbs-api.json @@ -40195,6 +40195,28 @@ }, "description": "End before the given Cursor. Conflicts with 'until'" }, + { + "name": "identifiers", + "in": "query", + "required": false, + "schema": { + "type": "boolean", + "description": "Also list the distinct syslog identifiers present. Requires 'structured'.", + "default": false + }, + "description": "Also list the distinct syslog identifiers present. Requires 'structured'." + }, + { + "name": "kernel", + "in": "query", + "required": false, + "schema": { + "type": "boolean", + "description": "Only print kernel messages.", + "default": false + }, + "description": "Only print kernel messages." + }, { "name": "lastentries", "in": "query", @@ -40206,6 +40228,26 @@ }, "description": "Limit to the last X lines. Conflicts with a range." }, + { + "name": "priority", + "in": "query", + "required": false, + "schema": { + "type": "string", + "description": "Only print messages of this syslog priority: a single level from 0 (emerg) to 7 (debug), selecting that level and everything more severe, or a 'LOW..HIGH' range. Empty means no filter." + }, + "description": "Only print messages of this syslog priority: a single level from 0 (emerg) to 7 (debug), selecting that level and everything more severe, or a 'LOW..HIGH' range. Empty means no filter." + }, + { + "name": "service", + "in": "query", + "required": false, + "schema": { + "type": "string", + "description": "Only print messages whose syslog identifier matches this glob." + }, + "description": "Only print messages whose syslog identifier matches this glob." + }, { "name": "since", "in": "query", @@ -40227,6 +40269,38 @@ }, "description": "Start after the given Cursor. Conflicts with 'since'." }, + { + "name": "structured", + "in": "query", + "required": false, + "schema": { + "type": "boolean", + "description": "Emit structured JSON with separate entry fields instead of plain text.", + "default": false + }, + "description": "Emit structured JSON with separate entry fields instead of plain text." + }, + { + "name": "unit", + "in": "query", + "required": false, + "schema": { + "type": "string", + "description": "Only print messages of this systemd unit (the .service suffix is implied)." + }, + "description": "Only print messages of this systemd unit (the .service suffix is implied)." + }, + { + "name": "units", + "in": "query", + "required": false, + "schema": { + "type": "boolean", + "description": "Also list the distinct systemd units present. Requires 'structured'.", + "default": false + }, + "description": "Also list the distinct systemd units present. Requires 'structured'." + }, { "name": "until", "in": "query", @@ -40241,16 +40315,13 @@ ], "responses": { "200": { - "description": "Returns a list of journal entries.", + "description": "Successful operation", "content": { "application/json": { "schema": { - "type": "array", - "items": { - "type": "string", - "description": "Line text." - }, - "description": "Returns a list of journal entries." + "type": "object", + "properties": {}, + "additionalProperties": false } } } diff --git a/proxmox-backup-server/pbs-api.yaml b/proxmox-backup-server/pbs-api.yaml index 060e0e9..d15cd34 100644 --- a/proxmox-backup-server/pbs-api.yaml +++ b/proxmox-backup-server/pbs-api.yaml @@ -27664,6 +27664,23 @@ paths: type: string description: End before the given Cursor. Conflicts with 'until' description: End before the given Cursor. Conflicts with 'until' + - name: identifiers + in: query + required: false + schema: + type: boolean + description: Also list the distinct syslog identifiers present. Requires + 'structured'. + default: false + description: Also list the distinct syslog identifiers present. Requires 'structured'. + - name: kernel + in: query + required: false + schema: + type: boolean + description: Only print kernel messages. + default: false + description: Only print kernel messages. - name: lastentries in: query required: false @@ -27672,6 +27689,24 @@ paths: description: Limit to the last X lines. Conflicts with a range. minimum: 0 description: Limit to the last X lines. Conflicts with a range. + - name: priority + in: query + required: false + schema: + type: string + description: 'Only print messages of this syslog priority: a single level + from 0 (emerg) to 7 (debug), selecting that level and everything more + severe, or a ''LOW..HIGH'' range. Empty means no filter.' + description: 'Only print messages of this syslog priority: a single level + from 0 (emerg) to 7 (debug), selecting that level and everything more severe, + or a ''LOW..HIGH'' range. Empty means no filter.' + - name: service + in: query + required: false + schema: + type: string + description: Only print messages whose syslog identifier matches this glob. + description: Only print messages whose syslog identifier matches this glob. - name: since in: query required: false @@ -27687,6 +27722,33 @@ paths: type: string description: Start after the given Cursor. Conflicts with 'since'. description: Start after the given Cursor. Conflicts with 'since'. + - name: structured + in: query + required: false + schema: + type: boolean + description: Emit structured JSON with separate entry fields instead of + plain text. + default: false + description: Emit structured JSON with separate entry fields instead of plain + text. + - name: unit + in: query + required: false + schema: + type: string + description: Only print messages of this systemd unit (the .service suffix + is implied). + description: Only print messages of this systemd unit (the .service suffix + is implied). + - name: units + in: query + required: false + schema: + type: boolean + description: Also list the distinct systemd units present. Requires 'structured'. + default: false + description: Also list the distinct systemd units present. Requires 'structured'. - name: until in: query required: false @@ -27697,15 +27759,13 @@ paths: description: Display all log until this UNIX epoch. Conflicts with 'endcursor'. responses: '200': - description: Returns a list of journal entries. + description: Successful operation content: application/json: schema: - type: array - items: - type: string - description: Line text. - description: Returns a list of journal entries. + type: object + properties: {} + additionalProperties: false '400': description: Bad Request - Invalid input parameters or malformed request content: