Ceph Create
CertifiedCreate an RBD snapshot
Ceph Create
Create an RBD snapshot
Calls POST /api/block/image/{image_spec}/snap and returns the resulting snapshot. Some Ceph versions process snapshot creation asynchronously via the Dashboard task manager, so the new snapshot may briefly be missing from the parent image's snapshot list right after the POST; this task retries the lookup for up to ~10 seconds (10 attempts, 1s apart).
type: io.kestra.plugin.ceph.rbd.snapshots.CreateExamples
Snapshot an RBD image
id: create_rbd_snapshot
namespace: company.team
tasks:
- id: snapshot
type: io.kestra.plugin.ceph.rbd.snapshots.Create
host: "ceph-mgr.internal"
username: "admin"
password: "{{ secret('CEPH_DASHBOARD_PASSWORD') }}"
poolName: "rbd"
imageName: "data-volume"
snapshotName: "before-migration"
Properties
host *Requiredstring
Ceph Dashboard host
Hostname or IP address of the Ceph Manager Dashboard. Must be reachable from the Kestra worker.
imageName *Requiredstring
Image name
Name of the RBD image to snapshot.
poolName *Requiredstring
Pool name
Pool the image belongs to.
snapshotName *Requiredstring
Snapshot name
Name to give the new snapshot.
password string
Password
Password for the Ceph Dashboard account. Never logged. Required unless token is set; ignored otherwise.
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.
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
id integer
Snapshot ID
Numeric identifier Ceph assigned to the snapshot.
is_protected boolean
Protected
Whether the snapshot is protected from deletion.
name string
Snapshot name
Name of the snapshot.
size integer
Size
Size of the image at the time the snapshot was taken, in bytes.
timestamp string
Timestamp
When the snapshot was created, kept as the raw string the Ceph Dashboard API returns (e.g. Wed Jan 10 12: 00: 00 2026). The exact format is Ceph-version dependent, so it is not parsed into a typed instant here.
