pbs_metrics_influxdb_http_create
Create a metrics server endpoint for sending PBS metrics to InfluxDB via HTTP. Dry-run by default to preview changes; set confirm=True to execute.
Instructions
MUTATION: create a PBS InfluxDB http metrics server configuration.
RISK_MEDIUM: this sub-plane can hold a stored API token — mirrors pbs_s3_client_create's
credential-bearing-create reasoning, a step up from PVE's LOW-rated pve_metrics_server_set
(whose currently-shipped tool surface doesn't expose a token parameter at all, even though
PVE's own schema has one — pbs_metrics.py module docstring's 2026-07-15 correction).
SECRET CONTRACT: token is NEVER
written to the audit ledger or the dry-run PLAN — forwarded RAW only to the real PBS API on
confirm=True (the create must actually work). Dry-run by default (returns a PLAN); confirm=True
executes (POST /config/metrics/influxdb-http, synchronous — PBS returns null) and returns
{"status": "ok", "result": None}. Needs PROXIMO_PBS_* config.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | HTTP(s) url with optional port, e.g. 'https://influx.example.com:8086'. | |
| name | Yes | New Metrics Server ID (3-32 chars, alnum/underscore start, then alnum/./_/-). | |
| token | No | API token. SECRET — never written to the audit ledger or the dry-run PLAN. | |
| bucket | No | InfluxDB Bucket (1-32 chars). Defaults to 'proxmox' server-side if omitted. | |
| enable | No | Enables or disables the metrics server. Defaults True server-side if omitted. | |
| comment | No | Comment (<=128 chars, no control chars). | |
| confirm | No | False (default) returns a dry-run PLAN only; True executes the creation. | |
| verify_tls | No | If true, the endpoint's certificate is validated. Defaults True server-side if omitted. | |
| organization | No | InfluxDB Organization (1-32 chars). Defaults to 'proxmox' server-side if omitted. | |
| max_body_size | No | Maximum body size in bytes. Defaults to 25000000 server-side if omitted; no upper bound stated by the schema. | |
| proximo_target | No | Which configured Proxmox target to run this call against — a target name from your multi-target config (a specific PVE/PBS/PMG/PDM box). Omit to use the single/default target from the environment; the selection applies only to this call. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |