pbs_s3_client_update
Update an existing PBS S3 client configuration with new endpoint, credentials, region, rate limits, or other properties. Supports dry-run planning before execution.
Instructions
MUTATION: update a PBS S3 client configuration.
RISK_MEDIUM: rotating credentials/endpoint/region can silently break dependent datastore/ sync configuration — mirrors pbs_remote_update. SECRET CONTRACT: secret-key (if given) is NEVER written to the audit ledger or the dry-run PLAN. Dry-run by default (captures current secret-free config into the PLAN); confirm=True executes (PUT /config/s3/{id}, synchronous — PBS returns null) and returns {"status": "ok", "result": None}. No snapshot primitive; verify with pbs_s3_check after rotating credentials. Needs PROXIMO_PBS_* config.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| port | No | New port (1-65535). | |
| s3_id | Yes | Id of the existing S3 client config to update. | |
| delete | No | Property names to clear: any of port/region/fingerprint/path-style/rate-in/burst-in/rate-out/burst-out/provider-quirks. access-key/secret-key/endpoint/id are NOT deletable — rotate them with a new value instead. | |
| digest | No | Optimistic-lock: 64-char lowercase hex SHA-256 of the config PBS last returned. | |
| region | No | New region. | |
| confirm | No | False (default) returns a dry-run PLAN only; True executes the update. | |
| rate_in | No | New inbound rate limit (byte size with unit). | |
| burst_in | No | New inbound burst limit (byte size with unit). | |
| endpoint | No | New endpoint hostname/IPv4/IPv6. | |
| rate_out | No | New outbound rate limit (byte size with unit). | |
| burst_out | No | New outbound burst limit (byte size with unit). | |
| access_key | No | New access key. NOT treated as secret. | |
| path_style | No | Use path-style bucket addressing. | |
| secret_key | No | New secret key. SECRET — never written to the audit ledger or the dry-run PLAN. | |
| fingerprint | No | New X509 certificate fingerprint. | |
| 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. | |
| provider_quirks | No | New provider-specific implementation quirks. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |