- Support
- Integrations
- Block Volumes
Block Volumes
Oracle Cloud integration · 69 node(s).
00Overview
Provision and manage Oracle Cloud block and boot volumes straight from a flow — create, clone, resize, attach and detach storage, move it between compartments, and tidy it up when it is no longer needed. Protect the data with manual or scheduled backups, group volumes so they back up together, copy backups to another region for disaster recovery, and manage the encryption keys that guard them. You can also read back any volume, backup, group, policy, attachment or replica to drive later steps or keep an inventory.
Every field below is exactly what you see in the Flomation editor. Fields marked ● live picker let you choose from a list pulled live from your account — no IDs to look up.
01Connecting Block Volumes
- Every Block Volumes node opens with an Authentication choice: pick Connect Oracle Cloud to use a managed connection (recommended), or API signing key (advanced) to enter a signing key by hand.
- For Connect Oracle Cloud, open your Flomation Environment settings and add an Oracle Cloud connection, giving it your Tenancy OCID and home Region. Follow the guided setup to provision a dedicated least-privilege user in your own tenancy and register Flomation's signing key, then supply the resulting User OCID and run Test connection — allow a minute or two for the new key to become active before it succeeds.
- Back in the node, select that connection in the Oracle Cloud connection field — there are no keys to copy or store.
- For API signing key (advanced), open the OCI Console Profile menu → My profile, and under API keys choose Add API key to generate a key pair and download the private key. The Configuration file preview then shows the Tenancy OCID, User OCID, Key Fingerprint and Region — copy each into the matching node field.
- Store the downloaded private key (the full PEM, including the
BEGIN/ENDlines) as a Flomation environment secret — for exampleblockvolume_secret— and pick it in the node's Private Key (PEM) field, filling Private Key Passphrase only if the key itself is encrypted. - Set the Compartment OCID on each node to the compartment whose volumes it should work in; you can copy it from the OCI Console under Identity → Compartments.
| Field | Type | Details | |
|---|---|---|---|
| Authentication | string | Connect Oracle Cloud, API signing key (advanced) | |
| Oracle Cloud connection | credential | Pick a connected Oracle Cloud account | |
| Region | string | e.g. uk-london-1 | |
| Private Key (PEM) | secret | The API signing private key — full PEM, incl. BEGIN/END lines | |
| Private Key Passphrase | secret | Only if the key is encrypted (optional) | |
| Tenancy OCID | string | ocid1.tenancy.oc1..aaaa… | |
| User OCID | string | ocid1.user.oc1..aaaa… | |
| Key Fingerprint | string | aa:bb:cc:… fingerprint of the uploaded API key |
Pick an Environment on your flow (Flow Settings → Environment) so the secret resolves. Secret fields never show the value — they reference ${secrets.your_secret}.
02Backup
OCI Block Volumes: Assign Backup Policy
oracle/blockvolume/backup_policy_assign · Action
Attach a backup policy to a block volume or boot volume so backups are taken automatically on the policy's schedule.
| Field | Type | Details | |
|---|---|---|---|
| Compartment OCID | string | ocid1.compartment.oc1..aaaa… (scopes the policy picker) | |
| Asset OCID | string | Required | The volume or boot-volume OCID to schedule backups for |
| Backup Policy OCID | string | Required | ocid1.volumebackuppolicy.oc1..aaaa… (predefined Bronze/Silver/Gold or your own) |
Returns: tool_result, assignment, id, success, error
OCI Block Volumes: Create Backup Policy
oracle/blockvolume/backup_policy_create · Action
Create a custom, user-defined volume backup policy in a compartment — a set of backup schedules (backup type, frequency period, and retention), optionally copying scheduled backups to a paired destination region.
| Field | Type | Details | |
|---|---|---|---|
| Compartment OCID | string | Required | ocid1.compartment.oc1..aaaa… (use the tenancy OCID for the root) |
| Schedules (JSON array) | string | [{"backupType":"INCREMENTAL","period":"ONE_DAY","retentionSeconds":604800,"offsetType":"STRUCTURED","hourOfDay":2,"timeZone":"REGIONAL_DATA_CENTER_TIME"}] — offsetType (STRUCTURED or NUMERIC_SECONDS) is required (optional) | |
| Display Name | string | Friendly name shown in the console (optional) | |
| Destination Region | string | Paired region to copy scheduled backups to, e.g. us-ashburn-1 (optional) | |
| Freeform Tags (JSON) | string | {"env":"prod"} (optional) |
Returns: tool_result, policy, id, success, error
OCI Block Volumes: Delete Backup Policy
oracle/blockvolume/backup_policy_delete · Action
Delete a custom Oracle Cloud volume backup policy by OCID. Only user-defined policies can be deleted — Oracle's predefined (Bronze/Silver/Gold) policies are not deletable.
| Field | Type | Details | |
|---|---|---|---|
| Compartment OCID | string | ocid1.compartment.oc1..aaaa… (scopes the policy picker) | |
| Backup Policy OCID | string | Required | ocid1.volumebackuppolicy.oc1..aaaa… |
Returns: tool_result, id, success, error
OCI Block Volumes: Get Backup Policy
oracle/blockvolume/backup_policy_get · Action
Fetch a single Oracle Cloud volume backup policy by OCID — its display name, backup schedules, cross-region destination and creation time.
| Field | Type | Details | |
|---|---|---|---|
| Compartment OCID | string | ocid1.compartment.oc1..aaaa… (scopes the policy picker) | |
| Backup Policy OCID | string | Required | ocid1.volumebackuppolicy.oc1..aaaa… |
Returns: tool_result, backup_policy, id, success, error
OCI Block Volumes: List Backup Policies
oracle/blockvolume/backup_policy_get_all · Action
List the backup policies available to schedule volume backups. With no compartment, returns Oracle's predefined Bronze/Silver/Gold/Platinum policies; with a compartment, your own policies in it.
| Field | Type | Details | |
|---|---|---|---|
| Compartment OCID | string | Leave blank for Oracle's predefined policies, or scope to your own (optional) |
Returns: tool_result, policies, count, truncated, success, error
OCI Block Volumes: Get Asset's Backup Policy
oracle/blockvolume/backup_policy_get_asset_assignment · Action
List the backup-policy assignments for a block volume or boot volume — which policy, if any, is scheduling its backups.
| Field | Type | Details | |
|---|---|---|---|
| Asset OCID | string | Required | The volume or boot-volume OCID to look up |
Returns: tool_result, assignments, count, truncated, success, error
OCI Block Volumes: Get Backup Policy Assignment
oracle/blockvolume/backup_policy_get_assignment · Action
Fetch a single Oracle Cloud volume backup policy assignment by OCID — the asset it protects and the policy scheduling its backups.
| Field | Type | Details | |
|---|---|---|---|
| Compartment OCID | string | ocid1.compartment.oc1..aaaa… (scopes the assignment picker) | |
| Assignment OCID | string | Required | ocid1.volumebackuppolicyassignment.oc1..aaaa… |
Returns: tool_result, assignment, id, success, error
OCI Block Volumes: Remove Backup Policy Assignment
oracle/blockvolume/backup_policy_unassign · Action
Detach a backup policy from an asset (a volume or boot volume) by assignment OCID, stopping its scheduled backups. Existing backups are not deleted.
| Field | Type | Details | |
|---|---|---|---|
| Compartment OCID | string | ocid1.compartment.oc1..aaaa… (scopes the assignment picker) | |
| Assignment OCID | string | Required | ocid1.volumebackuppolicyassignment.oc1..aaaa… |
Returns: tool_result, id, success, error
OCI Block Volumes: Update Backup Policy
oracle/blockvolume/backup_policy_update · Action
Update a user-defined Oracle Cloud block-volume backup policy — rename it, replace its backup schedules, or change its paired cross-region copy destination.
| Field | Type | Details | |
|---|---|---|---|
| Compartment OCID | string | ocid1.compartment.oc1..aaaa… (scopes the policy picker) | |
| Backup Policy OCID | string | Required | ocid1.volumebackuppolicy.oc1..aaaa… |
| Display Name | string | New friendly name for the policy (optional) | |
| Schedules (JSON array) | string | [{"backupType":"INCREMENTAL","period":"ONE_DAY","retentionSeconds":604800,"offsetType":"STRUCTURED","hourOfDay":2,"timeZone":"REGIONAL_DATA_CENTER_TIME"}] — REPLACES all schedules; offsetType required (optional) | |
| Destination Region | string | Paired region for scheduled copies, e.g. us-ashburn-1; 'none' to clear (optional) |
Returns: tool_result, policy, id, success, error
03Boot
OCI Block Volumes: Attach Boot Volume
oracle/blockvolume/boot_volume_attachment_attach · Action
Attach an Oracle Cloud boot volume to a compute instance. Optionally set a display name and the in-transit encryption type.
| Field | Type | Details | |
|---|---|---|---|
| Compartment OCID | string | ocid1.compartment.oc1..aaaa… (scopes the instance & boot volume pickers) | |
| Instance OCID | string | Required | ocid1.instance.oc1..aaaa… (the compute instance to attach to) |
| Boot Volume OCID | string | Required | ocid1.bootvolume.oc1..aaaa… (the boot volume to attach) |
| Display Name | string | Friendly name for the attachment (optional) | |
| Encryption In Transit | string | NONE or BM_ENCRYPTION_IN_TRANSIT (optional, defaults to NONE) |
Returns: tool_result, attachment, id, lifecycle_state, success, error
OCI Block Volumes: Detach Boot Volume
oracle/blockvolume/boot_volume_attachment_detach · Action
Detach an Oracle Cloud boot volume from a compute instance, keyed by the boot-volume-attachment OCID.
| Field | Type | Details | |
|---|---|---|---|
| Boot Volume Attachment OCID | string | Required | ocid1.bootvolumeattachment.oc1..aaaa… (from List Boot Volume Attachments) |
Returns: tool_result, id, success, error
OCI Block Volumes: Get Boot Volume Attachment
oracle/blockvolume/boot_volume_attachment_get · Action
Fetch a single Oracle Cloud boot-volume attachment by OCID — the instance and boot volume it links, its availability domain and lifecycle state.
| Field | Type | Details | |
|---|---|---|---|
| Boot Volume Attachment OCID | string | Required | ocid1.bootvolumeattachment.oc1..aaaa… |
Returns: tool_result, boot_volume_attachment, id, lifecycle_state, success, error
OCI Block Volumes: List Boot Volume Attachments
oracle/blockvolume/boot_volume_attachment_get_all · Action
List Oracle Cloud boot-volume attachments in a compartment and availability domain, optionally narrowed to one instance or one boot volume. Walks pagination up to a safe cap.
| Field | Type | Details | |
|---|---|---|---|
| Compartment OCID | string | Required | ocid1.compartment.oc1..aaaa… (use the tenancy OCID for the root) |
| Availability Domain | string | Required | e.g. Uocm:UK-LONDON-1-AD-1 |
| Instance OCID | string | Only attachments for this instance, ocid1.instance.oc1..aaaa… (optional) | |
| Boot Volume OCID | string | Only attachments for this boot volume, ocid1.bootvolume.oc1..aaaa… (optional) |
Returns: tool_result, attachments, count, truncated, success, error
OCI Block Volumes: Move Boot Volume Backup to Compartment
oracle/blockvolume/boot_volume_backup_change_compartment · Action
Move an Oracle Cloud boot-volume backup to another compartment by OCID. The move is synchronous.
| Field | Type | Details | |
|---|---|---|---|
| Compartment OCID | string | ocid1.compartment.oc1..aaaa… (scopes the backup picker) | |
| Boot Volume Backup OCID | string | Required | ocid1.bootvolumebackup.oc1..aaaa… |
| Destination Compartment OCID | string | Required | ocid1.compartment.oc1..aaaa… (move the backup here) |
Returns: tool_result, id, destination_compartment_ocid, success, error
OCI Block Volumes: Copy Boot Volume Backup
oracle/blockvolume/boot_volume_backup_copy · Action
Copy an Oracle Cloud boot-volume backup to another region for cross-region DR. The copy runs asynchronously and returns a work-request id.
| Field | Type | Details | |
|---|---|---|---|
| Boot Volume Backup OCID | string | Required | ocid1.bootvolumebackup.oc1..aaaa… (the backup to copy) |
| Destination Region | string | Required | The target region, e.g. uk-cardiff-1 |
| Display Name | string | Friendly name for the copied backup (optional) |
Returns: tool_result, backup, id, work_request_id, success, error
OCI Block Volumes: Create Boot Volume Backup
oracle/blockvolume/boot_volume_backup_create · Action
Take a manual point-in-time backup of an Oracle Cloud boot volume — full (default) or incremental.
| Field | Type | Details | |
|---|---|---|---|
| Compartment OCID | string | ocid1.compartment.oc1..aaaa… (scopes the boot volume picker) | |
| Boot Volume OCID | string | Required | ocid1.bootvolume.oc1..aaaa… (the boot volume to back up) |
| Display Name | string | Friendly name for the backup (optional) | |
| Backup Type | string | FULL (default) or INCREMENTAL — choices: Full, Incremental | |
| Freeform Tags (JSON) | string | {"env":"prod"} (optional) |
Returns: tool_result, backup, id, lifecycle_state, success, error
OCI Block Volumes: Delete Boot Volume Backup
oracle/blockvolume/boot_volume_backup_delete · Action
Permanently delete an Oracle Cloud boot-volume backup by OCID. Its data cannot be recovered.
| Field | Type | Details | |
|---|---|---|---|
| Compartment OCID | string | ocid1.compartment.oc1..aaaa… (scopes the backup picker) | |
| Boot Volume Backup OCID | string | Required | ocid1.bootvolumebackup.oc1..aaaa… |
Returns: tool_result, id, success, error
OCI Block Volumes: Get Boot Volume Backup
oracle/blockvolume/boot_volume_backup_get · Action
Fetch a single Oracle Cloud boot-volume backup by OCID — its source boot volume, size, type, lifecycle state and creation time.
| Field | Type | Details | |
|---|---|---|---|
| Compartment OCID | string | ocid1.compartment.oc1..aaaa… (scopes the backup picker) | |
| Boot Volume Backup OCID | string | Required | ocid1.bootvolumebackup.oc1..aaaa… |
Returns: tool_result, boot_volume_backup, id, lifecycle_state, success, error
OCI Block Volumes: List Boot Volume Backups
oracle/blockvolume/boot_volume_backup_get_all · Action
List Oracle Cloud boot-volume backups in a compartment, optionally narrowed to one boot volume. Walks pagination up to a safe cap.
| Field | Type | Details | |
|---|---|---|---|
| Compartment OCID | string | Required | ocid1.compartment.oc1..aaaa… (use the tenancy OCID for the root) |
| Boot Volume OCID | string | Only list backups of this boot volume, e.g. ocid1.bootvolume.oc1..aaaa… (optional) |
Returns: tool_result, boot_volume_backups, count, truncated, success, error
OCI Block Volumes: Update Boot Volume Backup
oracle/blockvolume/boot_volume_backup_update · Action
Update an Oracle Cloud boot-volume backup — change its display name and/or freeform tags.
| Field | Type | Details | |
|---|---|---|---|
| Compartment OCID | string | ocid1.compartment.oc1..aaaa… (scopes the backup picker) | |
| Boot Volume Backup OCID | string | Required | ocid1.bootvolumebackup.oc1..aaaa… |
| Display Name | string | New friendly name for the backup (optional) | |
| Freeform Tags (JSON) | string | {"env":"prod"} — replaces existing freeform tags (optional) |
Returns: tool_result, boot_volume_backup, id, lifecycle_state, success, error
OCI Block Volumes: Move Boot Volume to Compartment
oracle/blockvolume/boot_volume_change_compartment · Action
Move an Oracle Cloud boot volume into a different compartment. Synchronous — the boot volume keeps its OCID and stays available throughout the move.
| Field | Type | Details | |
|---|---|---|---|
| Compartment OCID | string | ocid1.compartment.oc1..aaaa… (scopes the boot volume picker) | |
| Boot Volume OCID | string | Required | ocid1.bootvolume.oc1..aaaa… |
| Destination Compartment OCID | string | Required | ocid1.compartment.oc1..aaaa… (where to move the boot volume) |
Returns: tool_result, id, success, error
OCI Block Volumes: Create Boot Volume
oracle/blockvolume/boot_volume_create · Action
Provision an Oracle Cloud boot volume from a source — a clone of an existing boot volume, a restore from a boot-volume backup, or from a boot-volume replica. Boot volumes are never created blank.
| Field | Type | Details | |
|---|---|---|---|
| Compartment OCID | string | Required | ocid1.compartment.oc1..aaaa… (use the tenancy OCID for the root) |
| Clone From Boot Volume OCID | string | Clone from this boot volume (optional — one source is required) | |
| Restore From Backup OCID | string | Restore from this boot-volume backup (optional — one source is required) | |
| Create From Replica OCID | string | Create from this boot-volume replica (optional — one source is required) | |
| Availability Domain | string | e.g. Uocm:UK-LONDON-1-AD-1 (optional — omissible when cloning) | |
| Size (GB) | string | Boot-volume size in GB (optional) | |
| Display Name | string | Friendly name shown in the console (optional) | |
| Performance (VPUs/GB) | string | 10 (Balanced, default), 20 or 30+ (Higher Perf) (optional) | |
| KMS Key OCID | string | Vault master encryption key OCID (optional) | |
| Freeform Tags (JSON) | string | {"env":"prod"} (optional) |
Returns: tool_result, boot_volume, id, lifecycle_state, success, error
OCI Block Volumes: Delete Boot Volume
oracle/blockvolume/boot_volume_delete · Action
Permanently delete an Oracle Cloud boot volume by OCID. The boot volume must be detached first; its data cannot be recovered.
| Field | Type | Details | |
|---|---|---|---|
| Compartment OCID | string | ocid1.compartment.oc1..aaaa… (scopes the boot volume picker) | |
| Boot Volume OCID | string | Required | ocid1.bootvolume.oc1..aaaa… |
Returns: tool_result, id, success, error
OCI Block Volumes: Get Boot Volume
oracle/blockvolume/boot_volume_get · Action
Fetch a single Oracle Cloud boot volume by OCID — its size, performance tier, availability domain, lifecycle state and tags.
| Field | Type | Details | |
|---|---|---|---|
| Compartment OCID | string | ocid1.compartment.oc1..aaaa… (scopes the boot volume picker) | |
| Boot Volume OCID | string | Required | ocid1.bootvolume.oc1..aaaa… |
Returns: tool_result, boot_volume, id, lifecycle_state, success, error
OCI Block Volumes: List Boot Volumes
oracle/blockvolume/boot_volume_get_all · Action
List Oracle Cloud boot volumes in a compartment, optionally narrowed to one availability domain. Walks pagination up to a safe cap.
| Field | Type | Details | |
|---|---|---|---|
| Compartment OCID | string | Required | ocid1.compartment.oc1..aaaa… (use the tenancy OCID for the root) |
| Availability Domain | string | Only list boot volumes in this AD, e.g. Uocm:UK-LONDON-1-AD-1 (optional) |
Returns: tool_result, boot_volumes, count, truncated, success, error
OCI Block Volumes: Remove Boot Volume Encryption Key
oracle/blockvolume/boot_volume_kms_key_delete · Action
Remove the customer-managed KMS encryption key from an Oracle Cloud boot volume, reverting it to Oracle-managed encryption.
| Field | Type | Details | |
|---|---|---|---|
| Compartment OCID | string | ocid1.compartment.oc1..aaaa… (scopes the boot volume picker) | |
| Boot Volume OCID | string | Required | ocid1.bootvolume.oc1..aaaa… |
Returns: tool_result, id, success, error
OCI Block Volumes: Get Boot Volume Encryption Key
oracle/blockvolume/boot_volume_kms_key_get · Action
Read the Vault (KMS) master encryption key assigned to an Oracle Cloud boot volume — blank if the volume uses Oracle-managed encryption.
| Field | Type | Details | |
|---|---|---|---|
| Compartment OCID | string | ocid1.compartment.oc1..aaaa… (scopes the boot volume picker) | |
| Boot Volume OCID | string | Required | ocid1.bootvolume.oc1..aaaa… |
Returns: tool_result, kms_key_id, id, success, error
OCI Block Volumes: Set Boot Volume Encryption Key
oracle/blockvolume/boot_volume_kms_key_update · Action
Assign or rotate the Vault (KMS) master encryption key protecting an Oracle Cloud boot volume. Provide the OCID of the Vault key; supplying the same key OCID regenerates the volume encryption key. Policies must allow the user and the Block Volume service to use the key.
| Field | Type | Details | |
|---|---|---|---|
| Compartment OCID | string | ocid1.compartment.oc1..aaaa… (scopes the boot-volume picker) | |
| Boot Volume OCID | string | Required | ocid1.bootvolume.oc1..aaaa… |
| Vault Key OCID | string | Required | ocid1.key.oc1..aaaa… — the Vault master encryption key to assign |
Returns: tool_result, kms_key_id, id, success, error
OCI Block Volumes: Get Boot Volume Replica
oracle/blockvolume/boot_volume_replica_get · Action
Fetch a single Oracle Cloud cross-region boot-volume replica by OCID — its source boot volume, availability domain, lifecycle state and last sync time.
| Field | Type | Details | |
|---|---|---|---|
| Compartment OCID | string | ocid1.compartment.oc1..aaaa… (scopes the replica picker) | |
| Boot Volume Replica OCID | string | Required | ocid1.bootvolumereplica.oc1..aaaa… |
Returns: tool_result, boot_volume_replica, id, lifecycle_state, success, error
OCI Block Volumes: List Boot Volume Replicas
oracle/blockvolume/boot_volume_replica_get_all · Action
List Oracle Cloud boot-volume replicas in a compartment, optionally narrowed to one availability domain. Walks pagination up to a safe cap.
| Field | Type | Details | |
|---|---|---|---|
| Compartment OCID | string | Required | ocid1.compartment.oc1..aaaa… (use the tenancy OCID for the root) |
| Availability Domain | string | Only list replicas in this AD, e.g. Uocm:UK-LONDON-1-AD-1 (optional) |
Returns: tool_result, replicas, count, truncated, success, error
OCI Block Volumes: Update Boot Volume
oracle/blockvolume/boot_volume_update · Action
Update an Oracle Cloud boot volume — rename it, resize it up, change its performance tier (VPUs/GB) or replace its freeform tags. Only the fields you supply are changed.
| Field | Type | Details | |
|---|---|---|---|
| Compartment OCID | string | ocid1.compartment.oc1..aaaa… (scopes the boot-volume picker) | |
| Boot Volume OCID | string | Required | ocid1.bootvolume.oc1..aaaa… |
| Display Name | string | New friendly name (optional) | |
| Size (GB) | string | New size — must be larger than the current size (optional) | |
| Performance (VPUs/GB) | string | 10 (Balanced), 20 (Higher Perf), 30–120 (Ultra High) (optional) | |
| Freeform Tags (JSON) | string | {"env":"prod"} — replaces existing freeform tags (optional) |
Returns: tool_result, boot_volume, id, lifecycle_state, success, error
04Volume
OCI Block Volumes: Attach Volume
oracle/blockvolume/volume_attach · Action
Attach an Oracle Cloud block volume to a compute instance. Defaults to a paravirtualized attachment (VM shapes); choose iSCSI for bare-metal instances or emulated for legacy images. Optionally set the device path, read-only and shareable flags.
| Field | Type | Details | |
|---|---|---|---|
| Compartment OCID | string | ocid1.compartment.oc1..aaaa… (scopes the instance & volume pickers) | |
| Instance OCID | string | Required | ocid1.instance.oc1..aaaa… (the compute instance to attach to) |
| Volume OCID | string | Required | ocid1.volume.oc1..aaaa… (the block volume to attach) |
| Attachment Type | string | Paravirtualized (default, VM shapes), iSCSI (required for bare-metal), or Emulated — choices: Paravirtualized, iSCSI, Emulated | |
| Display Name | string | Friendly name for the attachment (optional) | |
| Device Path | string | e.g. /dev/oracleoci/oraclevdb — pin the in-guest device name (optional) | |
| Read Only | boolean | Attach the volume read-only (optional) | |
| Shareable | boolean | Allow the volume to be attached to multiple instances (optional) |
Returns: tool_result, attachment, id, lifecycle_state, success, error
OCI Block Volumes: Get Volume Attachment
oracle/blockvolume/volume_attachment_get · Action
Fetch a single Oracle Cloud volume attachment by OCID — the volume, instance, availability domain, attachment type and lifecycle state.
| Field | Type | Details | |
|---|---|---|---|
| Volume Attachment OCID | string | Required | ocid1.volumeattachment.oc1..aaaa… (from Attach Volume / List Attachments) |
Returns: tool_result, attachment, id, lifecycle_state, success, error
OCI Block Volumes: List Volume Attachments
oracle/blockvolume/volume_attachment_get_all · Action
List Oracle Cloud block-volume attachments in a compartment, optionally narrowed to one instance and/or one volume. Walks pagination up to a safe cap.
| Field | Type | Details | |
|---|---|---|---|
| Compartment OCID | string | Required | ocid1.compartment.oc1..aaaa… (use the tenancy OCID for the root) |
| Instance OCID | string | Only list attachments for this instance (optional) | |
| Volume OCID | string | Only list attachments for this volume (optional) |
Returns: tool_result, attachments, count, truncated, success, error
OCI Block Volumes: Update Volume Attachment
oracle/blockvolume/volume_attachment_update · Action
Update the mutable fields of an Oracle Cloud volume attachment — set the iSCSI login state to drive multipath iSCSI sessions in or out of the logged-in state.
| Field | Type | Details | |
|---|---|---|---|
| Compartment OCID | string | ocid1.compartment.oc1..aaaa… (scopes the attachment picker) | |
| Volume Attachment OCID | string | Required | ocid1.volumeattachment.oc1..aaaa… |
| iSCSI Login State | string | LOGIN_SUCCEEDED or LOGOUT_SUCCEEDED — drive multipath iSCSI sessions in/out (optional) |
Returns: tool_result, attachment, id, lifecycle_state, success, error
OCI Block Volumes: Move Volume Backup to Compartment
oracle/blockvolume/volume_backup_change_compartment · Action
Move an Oracle Cloud block-volume backup to another compartment by OCID. The move is synchronous.
| Field | Type | Details | |
|---|---|---|---|
| Compartment OCID | string | ocid1.compartment.oc1..aaaa… (scopes the backup picker) | |
| Volume Backup OCID | string | Required | ocid1.volumebackup.oc1..aaaa… |
| Destination Compartment OCID | string | Required | ocid1.compartment.oc1..aaaa… (move the backup here) |
Returns: tool_result, id, destination_compartment_ocid, success, error
OCI Block Volumes: Copy Volume Backup
oracle/blockvolume/volume_backup_copy · Action
Copy an Oracle Cloud volume backup to another region for cross-region DR. The copy runs asynchronously and returns a work-request id.
| Field | Type | Details | |
|---|---|---|---|
| Volume Backup OCID | string | Required | ocid1.volumebackup.oc1..aaaa… (the backup to copy) |
| Destination Region | string | Required | The target region, e.g. uk-cardiff-1 |
| Display Name | string | Friendly name for the copied backup (optional) |
Returns: tool_result, backup, id, work_request_id, success, error
OCI Block Volumes: Create Volume Backup
oracle/blockvolume/volume_backup_create · Action
Take a manual point-in-time backup of an Oracle Cloud block volume — full (default) or incremental.
| Field | Type | Details | |
|---|---|---|---|
| Compartment OCID | string | ocid1.compartment.oc1..aaaa… (scopes the volume picker) | |
| Volume OCID | string | Required | ocid1.volume.oc1..aaaa… (the volume to back up) |
| Display Name | string | Friendly name for the backup (optional) | |
| Backup Type | string | FULL (default) or INCREMENTAL — choices: Full, Incremental | |
| Freeform Tags (JSON) | string | {"env":"prod"} (optional) |
Returns: tool_result, backup, id, lifecycle_state, success, error
OCI Block Volumes: Delete Volume Backup
oracle/blockvolume/volume_backup_delete · Action
Permanently delete an Oracle Cloud block volume backup by OCID. Its data cannot be recovered.
| Field | Type | Details | |
|---|---|---|---|
| Compartment OCID | string | ocid1.compartment.oc1..aaaa… (scopes the backup picker) | |
| Volume Backup OCID | string | Required | ocid1.volumebackup.oc1..aaaa… |
Returns: tool_result, id, success, error
OCI Block Volumes: Get Volume Backup
oracle/blockvolume/volume_backup_get · Action
Fetch a single Oracle Cloud block-volume backup by OCID — its size, type, source volume, lifecycle state and creation time.
| Field | Type | Details | |
|---|---|---|---|
| Compartment OCID | string | ocid1.compartment.oc1..aaaa… (scopes the backup picker) | |
| Volume Backup OCID | string | Required | ocid1.volumebackup.oc1..aaaa… |
Returns: tool_result, volume_backup, id, lifecycle_state, success, error
OCI Block Volumes: List Volume Backups
oracle/blockvolume/volume_backup_get_all · Action
List Oracle Cloud block volume backups in a compartment, optionally filtered to one source volume. Walks pagination up to a safe cap.
| Field | Type | Details | |
|---|---|---|---|
| Compartment OCID | string | Required | ocid1.compartment.oc1..aaaa… (use the tenancy OCID for the root) |
| Volume OCID | string | Only list backups of this source volume, e.g. ocid1.volume.oc1..aaaa… (optional) |
Returns: tool_result, volume_backups, count, truncated, success, error
OCI Block Volumes: Update Volume Backup
oracle/blockvolume/volume_backup_update · Action
Update an Oracle Cloud block-volume backup — change its display name and/or freeform tags.
| Field | Type | Details | |
|---|---|---|---|
| Compartment OCID | string | ocid1.compartment.oc1..aaaa… (scopes the backup picker) | |
| Volume Backup OCID | string | Required | ocid1.volumebackup.oc1..aaaa… |
| Display Name | string | New friendly name for the backup (optional) | |
| Freeform Tags (JSON) | string | {"env":"prod"} — replaces existing freeform tags (optional) |
Returns: tool_result, backup, id, lifecycle_state, success, error
OCI Block Volumes: Move Volume to Compartment
oracle/blockvolume/volume_change_compartment · Action
Move an Oracle Cloud block volume into a different compartment. Runs synchronously; the volume keeps its OCID and data.
| Field | Type | Details | |
|---|---|---|---|
| Compartment OCID | string | ocid1.compartment.oc1..aaaa… (scopes the volume picker) | |
| Volume OCID | string | Required | ocid1.volume.oc1..aaaa… |
| Destination Compartment OCID | string | Required | ocid1.compartment.oc1..aaaa… — the compartment to move the volume to |
Returns: tool_result, id, success, error
OCI Block Volumes: Create Volume
oracle/blockvolume/volume_create · Action
Provision an Oracle Cloud block volume — a new empty volume (availability domain + size in GB), a clone of an existing volume, or a restore from a backup. Optionally attach a backup policy at create time.
| Field | Type | Details | |
|---|---|---|---|
| Compartment OCID | string | Required | ocid1.compartment.oc1..aaaa… (use the tenancy OCID for the root) |
| Availability Domain | string | e.g. Uocm:UK-LONDON-1-AD-1 (required unless cloning an existing volume) | |
| Size (GB) | string | 50–32768 for a new volume (default 50) | |
| Display Name | string | Friendly name shown in the console (optional) | |
| Performance (VPUs/GB) | string | 0 (Lower Cost), 10 (Balanced, default), 20 or 30 (Higher Perf) (optional) | |
| Backup Policy OCID | string | Assign a backup policy at create time (optional) | |
| Clone From Volume OCID | string | Clone from this volume instead of a new one (optional) | |
| Restore From Backup OCID | string | Restore from this backup instead of a new one (optional) | |
| Freeform Tags (JSON) | string | {"env":"prod"} (optional) |
Returns: tool_result, volume, id, lifecycle_state, success, error
OCI Block Volumes: Delete Volume
oracle/blockvolume/volume_delete · Action
Permanently delete an Oracle Cloud block volume by OCID. The volume must be detached first; its data cannot be recovered.
| Field | Type | Details | |
|---|---|---|---|
| Compartment OCID | string | ocid1.compartment.oc1..aaaa… (scopes the volume picker) | |
| Volume OCID | string | Required | ocid1.volume.oc1..aaaa… |
Returns: tool_result, id, success, error
OCI Block Volumes: Detach Volume
oracle/blockvolume/volume_detach · Action
Detach an Oracle Cloud block volume from a compute instance, keyed by the volume-attachment OCID. Detach is asynchronous and returns a work-request id.
| Field | Type | Details | |
|---|---|---|---|
| Volume Attachment OCID | string | Required | ocid1.volumeattachment.oc1..aaaa… (from Attach Volume / List Attachments) |
Returns: tool_result, id, work_request_id, success, error
OCI Block Volumes: Get Volume
oracle/blockvolume/volume_get · Action
Fetch a single Oracle Cloud block volume by OCID — its size, performance tier, availability domain, lifecycle state and tags.
| Field | Type | Details | |
|---|---|---|---|
| Compartment OCID | string | ocid1.compartment.oc1..aaaa… (scopes the volume picker) | |
| Volume OCID | string | Required | ocid1.volume.oc1..aaaa… |
Returns: tool_result, volume, id, lifecycle_state, success, error
OCI Block Volumes: List Volumes
oracle/blockvolume/volume_get_all · Action
List Oracle Cloud block volumes in a compartment, optionally narrowed to one availability domain. Walks pagination up to a safe cap.
| Field | Type | Details | |
|---|---|---|---|
| Compartment OCID | string | Required | ocid1.compartment.oc1..aaaa… (use the tenancy OCID for the root) |
| Availability Domain | string | Only list volumes in this AD, e.g. Uocm:UK-LONDON-1-AD-1 (optional) |
Returns: tool_result, volumes, count, truncated, success, error
OCI Block Volumes: Move Volume Group Backup to Compartment
oracle/blockvolume/volume_group_backup_change_compartment · Action
Move an Oracle Cloud volume-group backup to another compartment by OCID. The move is synchronous.
| Field | Type | Details | |
|---|---|---|---|
| Compartment OCID | string | ocid1.compartment.oc1..aaaa… (scopes the backup picker) | |
| Volume Group Backup OCID | string | Required | ocid1.volumegroupbackup.oc1..aaaa… |
| Destination Compartment OCID | string | Required | ocid1.compartment.oc1..aaaa… (move the backup here) |
Returns: tool_result, id, destination_compartment_ocid, success, error
OCI Block Volumes: Copy Volume Group Backup
oracle/blockvolume/volume_group_backup_copy · Action
Copy an Oracle Cloud volume-group backup to another region for cross-region DR. The copy runs asynchronously and returns the copied volume-group backup.
| Field | Type | Details | |
|---|---|---|---|
| Volume Group Backup OCID | string | Required | ocid1.volumegroupbackup.oc1..aaaa… (the backup to copy) |
| Destination Region | string | Required | The target region, e.g. uk-cardiff-1 |
| Display Name | string | Friendly name for the copied volume-group backup (optional) |
Returns: tool_result, backup, id, lifecycle_state, success, error
OCI Block Volumes: Create Volume Group Backup
oracle/blockvolume/volume_group_backup_create · Action
Back up a whole Oracle Cloud volume group in one crash-consistent operation — full (default) or incremental.
| Field | Type | Details | |
|---|---|---|---|
| Compartment OCID | string | ocid1.compartment.oc1..aaaa… (scopes the volume group picker) | |
| Volume Group OCID | string | Required | ocid1.volumegroup.oc1..aaaa… (the volume group to back up) |
| Display Name | string | Friendly name for the backup (optional) | |
| Backup Type | string | FULL (default) or INCREMENTAL — choices: Full, Incremental | |
| Freeform Tags (JSON) | string | {"env":"prod"} (optional) |
Returns: tool_result, backup, id, lifecycle_state, success, error
OCI Block Volumes: Delete Volume Group Backup
oracle/blockvolume/volume_group_backup_delete · Action
Permanently delete an Oracle Cloud volume-group backup by OCID. Its data cannot be recovered.
| Field | Type | Details | |
|---|---|---|---|
| Compartment OCID | string | ocid1.compartment.oc1..aaaa… (scopes the backup picker) | |
| Volume Group Backup OCID | string | Required | ocid1.volumegroupbackup.oc1..aaaa… |
Returns: tool_result, id, success, error
OCI Block Volumes: Get Volume Group Backup
oracle/blockvolume/volume_group_backup_get · Action
Fetch a single Oracle Cloud volume-group backup by OCID — its type, source, size, member volume backups and lifecycle state.
| Field | Type | Details | |
|---|---|---|---|
| Compartment OCID | string | ocid1.compartment.oc1..aaaa… (scopes the backup picker) | |
| Volume Group Backup OCID | string | Required | ocid1.volumegroupbackup.oc1..aaaa… |
Returns: tool_result, volume_group_backup, id, lifecycle_state, success, error
OCI Block Volumes: List Volume Group Backups
oracle/blockvolume/volume_group_backup_get_all · Action
List Oracle Cloud volume-group backups in a compartment, optionally narrowed to one source volume group. Walks pagination up to a safe cap.
| Field | Type | Details | |
|---|---|---|---|
| Compartment OCID | string | Required | ocid1.compartment.oc1..aaaa… (use the tenancy OCID for the root) |
| Volume Group OCID | string | Only list backups of this volume group, e.g. ocid1.volumegroup.oc1..aaaa… (optional) |
Returns: tool_result, volume_group_backups, count, truncated, success, error
OCI Block Volumes: Update Volume Group Backup
oracle/blockvolume/volume_group_backup_update · Action
Update an Oracle Cloud volume-group backup — change its display name and/or freeform tags.
| Field | Type | Details | |
|---|---|---|---|
| Compartment OCID | string | ocid1.compartment.oc1..aaaa… (scopes the backup picker) | |
| Volume Group Backup OCID | string | Required | ocid1.volumegroupbackup.oc1..aaaa… |
| Display Name | string | New friendly name for the backup (optional) | |
| Freeform Tags (JSON) | string | {"env":"prod"} — replaces existing freeform tags (optional) |
Returns: tool_result, backup, id, lifecycle_state, success, error
OCI Block Volumes: Move Volume Group to Compartment
oracle/blockvolume/volume_group_change_compartment · Action
Move an Oracle Cloud volume group into a different compartment. Runs synchronously; the volume group keeps its OCID and member volumes.
| Field | Type | Details | |
|---|---|---|---|
| Compartment OCID | string | ocid1.compartment.oc1..aaaa… (scopes the volume group picker) | |
| Volume Group OCID | string | Required | ocid1.volumegroup.oc1..aaaa… |
| Destination Compartment OCID | string | Required | ocid1.compartment.oc1..aaaa… — the compartment to move the volume group to |
Returns: tool_result, id, success, error
OCI Block Volumes: Create Volume Group
oracle/blockvolume/volume_group_create · Action
Create an Oracle Cloud volume group — a set of block volumes managed as one — built from a list of existing volumes, cloned from another volume group, or restored from a volume group backup.
| Field | Type | Details | |
|---|---|---|---|
| Compartment OCID | string | Required | ocid1.compartment.oc1..aaaa… (use the tenancy OCID for the root) |
| Availability Domain | string | Required | e.g. Uocm:UK-LONDON-1-AD-1 |
| Volume OCIDs | string | Comma-separated volume OCIDs to group together | |
| Clone From Volume Group OCID | string | Clone from this volume group instead (optional) | |
| Restore From Volume Group Backup OCID | string | Restore from this volume group backup instead (optional) | |
| Display Name | string | Friendly name shown in the console (optional) | |
| Freeform Tags (JSON) | string | {"env":"prod"} (optional) |
Returns: tool_result, volume_group, id, lifecycle_state, success, error
OCI Block Volumes: Delete Volume Group
oracle/blockvolume/volume_group_delete · Action
Delete an Oracle Cloud volume group by OCID. This removes the group itself only — the member block volumes are NOT deleted and remain available.
| Field | Type | Details | |
|---|---|---|---|
| Compartment OCID | string | ocid1.compartment.oc1..aaaa… (scopes the volume group picker) | |
| Volume Group OCID | string | Required | ocid1.volumegroup.oc1..aaaa… |
Returns: tool_result, id, success, error
OCI Block Volumes: Get Volume Group
oracle/blockvolume/volume_group_get · Action
Fetch a single Oracle Cloud volume group by OCID — its member volumes, size, availability domain and lifecycle state.
| Field | Type | Details | |
|---|---|---|---|
| Compartment OCID | string | ocid1.compartment.oc1..aaaa… (scopes the volume group picker) | |
| Volume Group OCID | string | Required | ocid1.volumegroup.oc1..aaaa… |
Returns: tool_result, volume_group, id, lifecycle_state, success, error
OCI Block Volumes: List Volume Groups
oracle/blockvolume/volume_group_get_all · Action
List Oracle Cloud volume groups in a compartment, optionally narrowed to one availability domain. Walks pagination up to a safe cap.
| Field | Type | Details | |
|---|---|---|---|
| Compartment OCID | string | Required | ocid1.compartment.oc1..aaaa… (use the tenancy OCID for the root) |
| Availability Domain | string | Only list volume groups in this AD, e.g. Uocm:UK-LONDON-1-AD-1 (optional) |
Returns: tool_result, volume_groups, count, truncated, success, error
OCI Block Volumes: Get Volume Group Replica
oracle/blockvolume/volume_group_replica_get · Action
Fetch a single Oracle Cloud volume-group replica by OCID — its source volume group, availability domain, lifecycle state and last-synced time.
| Field | Type | Details | |
|---|---|---|---|
| Compartment OCID | string | ocid1.compartment.oc1..aaaa… (scopes the replica picker) | |
| Volume Group Replica OCID | string | Required | ocid1.volumegroupreplica.oc1..aaaa… |
Returns: tool_result, replica, id, lifecycle_state, success, error
OCI Block Volumes: List Volume Group Replicas
oracle/blockvolume/volume_group_replica_get_all · Action
List Oracle Cloud volume-group replicas in one availability domain of a compartment. Walks pagination up to a safe cap.
| Field | Type | Details | |
|---|---|---|---|
| Compartment OCID | string | Required | ocid1.compartment.oc1..aaaa… (use the tenancy OCID for the root) |
| Availability Domain | string | Required | The destination AD to list replicas in, e.g. Uocm:UK-LONDON-1-AD-1 |
Returns: tool_result, replicas, count, truncated, success, error
OCI Block Volumes: Update Volume Group
oracle/blockvolume/volume_group_update · Action
Update an Oracle Cloud volume group — its display name, freeform tags, and its set of member volumes. Note: supplying member volumes REPLACES the group's entire membership (it is not additive).
| Field | Type | Details | |
|---|---|---|---|
| Compartment OCID | string | ocid1.compartment.oc1..aaaa… (scopes the volume group picker) | |
| Volume Group OCID | string | Required | ocid1.volumegroup.oc1..aaaa… |
| Display Name | string | New friendly name shown in the console (optional) | |
| Member Volume OCIDs (comma-separated) | string | ocid1.volume.oc1..aaa,ocid1.volume.oc1..bbb — REPLACES the whole member set (optional) | |
| Freeform Tags (JSON) | string | {"env":"prod"} (optional) |
Returns: tool_result, volume_group, id, lifecycle_state, success, error
OCI Block Volumes: Remove Volume Encryption Key
oracle/blockvolume/volume_kms_key_delete · Action
Remove the customer-managed KMS (Vault) encryption key from an Oracle Cloud block volume, reverting it to Oracle-managed encryption.
| Field | Type | Details | |
|---|---|---|---|
| Compartment OCID | string | ocid1.compartment.oc1..aaaa… (scopes the volume picker) | |
| Volume OCID | string | Required | ocid1.volume.oc1..aaaa… |
Returns: tool_result, id, success, error
OCI Block Volumes: Get Volume Encryption Key
oracle/blockvolume/volume_kms_key_get · Action
Read the customer-managed (Vault/KMS) encryption key assigned to an Oracle Cloud block volume. An empty key means the volume uses Oracle-managed encryption.
| Field | Type | Details | |
|---|---|---|---|
| Compartment OCID | string | ocid1.compartment.oc1..aaaa… (scopes the volume picker) | |
| Volume OCID | string | Required | ocid1.volume.oc1..aaaa… |
Returns: tool_result, kms_key_id, id, success, error
OCI Block Volumes: Set Volume Encryption Key
oracle/blockvolume/volume_kms_key_update · Action
Assign or rotate the customer-managed Vault (KMS) master encryption key protecting an Oracle Cloud block volume.
| Field | Type | Details | |
|---|---|---|---|
| Compartment OCID | string | ocid1.compartment.oc1..aaaa… (scopes the volume picker) | |
| Volume OCID | string | Required | ocid1.volume.oc1..aaaa… |
| KMS Key OCID | string | Required | ocid1.key.oc1..aaaa… (same OCID as before regenerates the volume encryption key) |
Returns: tool_result, kms_key_id, id, success, error
OCI Block Volumes: Get Block Volume Replica
oracle/blockvolume/volume_replica_get · Action
Fetch a single Oracle Cloud cross-region block-volume replica by OCID — its source volume, availability domain, lifecycle state and last-synced time.
| Field | Type | Details | |
|---|---|---|---|
| Compartment OCID | string | ocid1.compartment.oc1..aaaa… (scopes the replica picker) | |
| Block Volume Replica OCID | string | Required | ocid1.blockvolumereplica.oc1..aaaa… |
Returns: tool_result, replica, id, lifecycle_state, success, error
OCI Block Volumes: List Block Volume Replicas
oracle/blockvolume/volume_replica_get_all · Action
List Oracle Cloud block-volume replicas in a compartment, optionally narrowed to one availability domain. Walks pagination up to a safe cap.
| Field | Type | Details | |
|---|---|---|---|
| Compartment OCID | string | Required | ocid1.compartment.oc1..aaaa… (use the tenancy OCID for the root) |
| Availability Domain | string | Only list replicas in this AD, e.g. Uocm:UK-LONDON-1-AD-1 (optional) |
Returns: tool_result, replicas, count, truncated, success, error
OCI Block Volumes: Update Volume
oracle/blockvolume/volume_update · Action
Update an Oracle Cloud block volume in place — rename it, change its performance tier (VPUs/GB), expand its size in GB, or replace its freeform tags.
| Field | Type | Details | |
|---|---|---|---|
| Compartment OCID | string | ocid1.compartment.oc1..aaaa… (scopes the volume picker) | |
| Volume OCID | string | Required | ocid1.volume.oc1..aaaa… |
| Display Name | string | New friendly name shown in the console (optional) | |
| Performance (VPUs/GB) | string | 0 (Lower Cost), 10 (Balanced), 20 or 30+ (Higher Perf) (optional) | |
| Size (GB) | string | New size — must be LARGER than the current size (expand only, optional) | |
| Freeform Tags (JSON) | string | {"env":"prod"} — replaces existing freeform tags (optional) |
Returns: tool_result, volume, id, lifecycle_state, success, error
05Notes & Limitations
Behaviours and constraints worth knowing before you build with these nodes.
- Updating a volume group's member volumes replaces the group's entire membership rather than adding to it, so always supply the complete list of volumes the group should contain.
- Deleting a volume group removes only the grouping itself; its member block volumes are left intact and must be deleted separately if you no longer need them.
- Cross-region backup copies and volume detaches run asynchronously and return a work-request id, so the operation is still completing in the background even though the action has already reported success.
- Oracle's predefined Bronze, Silver, Gold and Platinum backup policies cannot be edited or deleted; only policies you create within a compartment can be changed or removed.
- Unlike a plain data volume, a boot volume and a volume group can never be created empty: a boot volume must be seeded from a clone, a backup restore, or a replica, and a volume group must be given existing volumes to group, another group to clone, or a group backup to restore.
- A newly added Oracle Cloud connection can take a minute or two before its signing key becomes active, so a connection test or first run attempted immediately after setup may fail once and then succeed on retry.