Ceph Update
CertifiedUpdate a Ceph pool
Ceph Update
Update a Ceph pool
Calls PUT /api/pool/{pool_name} with only the fields explicitly set, then returns the updated pool. Some Ceph versions process pool updates asynchronously via the Dashboard task manager, so the follow-up fetch may briefly 404 right after the PUT; this task retries it for up to ~10 seconds (10 attempts, 1s apart) before failing.
type: io.kestra.plugin.ceph.pools.UpdateExamples
Grow a Ceph pool's placement group count
id: update_ceph_pool
namespace: company.team
tasks:
- id: update_pool
type: io.kestra.plugin.ceph.pools.Update
host: "ceph-mgr.internal"
username: "admin"
password: "{{ secret('CEPH_DASHBOARD_PASSWORD') }}"
poolName: "archive"
pgNum: 64
Properties
host *Requiredstring
Ceph Dashboard host
Hostname or IP address of the Ceph Manager Dashboard. Must be reachable from the Kestra worker.
poolName *Requiredstring
Pool name
Name of the pool to update.
applicationMetadata array
Application metadata
Application tags to set on the pool. Only sent if set.
password string
Password
Password for the Ceph Dashboard account. Never logged. Required unless token is set; ignored otherwise.
pgNum integerstring
Placement group count
New number of placement groups. Only sent if set.
pluginDefaultsRef Non-dynamicstring
Reference (ref) of the pluginDefaults to apply to this task.
port integerstring
8443Ceph Dashboard port
TCP port of the Ceph Manager Dashboard REST API. Defaults to 8443.
size integerstring
Replica size
New number of data replicas. Only sent if set.
skipSsl booleanstring
falseSkip TLS certificate verification
When true, disables TLS certificate verification. Useful when the Ceph Manager Dashboard uses a self-signed certificate, which is the default on most Ceph deployments. Defaults to false (secure): enable it explicitly and only for trusted networks.
token string
Pre-obtained JWT
A JWT obtained from POST /api/auth, used directly instead of username/password. Reused as-is for every request in the execution. It expires (Ceph default 8h TTL) and is NOT auto-renewed, so do not use it in triggers or scheduled flows; use username/password there instead. Mutually exclusive with password: when set, username/password are ignored.
username string
Username
Ceph Dashboard account used to obtain a session token from POST /api/auth. Required unless token is set.
Outputs
application_metadata array
Application metadata
Application tags enabled on the pool, e.g. rbd or rgw.
pg_num integer
Placement group count
Number of placement groups.
pg_placement_num integer
Placement group placement count
Number of placement groups used for placement.
pool integer
Pool ID
Numeric identifier Ceph assigned to the pool.
pool_name string
Pool name
Name of the pool.
size integer
Replica size
Number of data replicas for a replicated pool.
