File Storage

00Overview

Provision and run Oracle Cloud NFS file storage straight from a flow — create file systems and mount targets, wire the exports that make them mountable, and move resources between compartments. Automate the day-two work too: take and schedule point-in-time snapshots, replicate file systems to another region or availability domain for disaster recovery, set per-user and per-group storage quotas, and manage the outbound LDAP connectors mount targets use for directory lookups. Every List and Get action is available as well, so you can build inventory checks and let earlier results drive the rest of your automation.

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 File Storage

1. The simplest path is the default Authentication method, Connect Oracle Cloud. Under your environment's credentials in Flomation, add an Oracle Cloud connection, give it a name, and connect your Oracle Cloud account so Flomation holds the signing details for you.
2. In each File Storage node, leave Authentication on Connect Oracle Cloud and pick your connection in the Oracle Cloud connection field — the tenancy, user, region and fingerprint are filled in for you.
3. To use an existing key instead, switch Authentication to API signing key (advanced) and fill Tenancy OCID, User OCID, Region and Key Fingerprint from your user's API Keys page in the OCI Console (your profile → API Keys → Add API Key, which shows the matching fingerprint).
4. For that advanced path, store the PEM contents as a Flomation environment secret (e.g. filestorage_secret) and select it in the node's Private Key (PEM) field; add a Private Key Passphrase secret only if your key is encrypted.

02Export

OCI File Storage: Create Export

oracle/filestorage/export_create · Action

Create an export — the link that makes a file system reachable through a mount target's export set at an NFS path (e.g. /shared). This is what clients actually mount. Optionally restrict access with export options.

Returns: tool_result, export, id, lifecycle_state, success, error

OCI File Storage: Delete Export

oracle/filestorage/export_delete · Action

Delete an Oracle Cloud NFS export by OCID — this unmounts the file system from that mount target (clients using this export path lose access). Poll Get Export (it 404s once gone).

Returns: tool_result, id, success, error

OCI File Storage: Get Export

oracle/filestorage/export_get · Action

Fetch a single Oracle Cloud NFS export by OCID — the file system it links, its export set, the mount path and lifecycle state.

Returns: tool_result, export, id, lifecycle_state, success, error

OCI File Storage: List Exports

oracle/filestorage/export_list · Action

List the Oracle Cloud NFS exports (the links between file systems and export sets), optionally scoped by compartment and filtered by export set or file system. Walks pagination up to a safe cap.

Returns: tool_result, exports, count, truncated, success, error

OCI File Storage: Get Export Set

oracle/filestorage/export_set_get · Action

Fetch a single Oracle Cloud NFS export set by OCID — its display name, availability domain, VCN, lifecycle state and NFS stat limits.

Returns: tool_result, export_set, id, lifecycle_state, success, error

OCI File Storage: List Export Sets

oracle/filestorage/export_set_list · Action

List the Oracle Cloud File Storage export sets in a compartment and availability domain (both required — export sets are AD-scoped), optionally filtered by display name. Walks pagination up to a safe cap.

Returns: tool_result, export_sets, count, truncated, success, error

OCI File Storage: Update Export Set

oracle/filestorage/export_set_update · Action

Rename an Oracle Cloud NFS export set and/or adjust its advanced FSSTAT byte and file reporting limits. Only the fields you supply are changed.

Returns: tool_result, export_set, id, lifecycle_state, success, error

OCI File Storage: Update Export

oracle/filestorage/export_update · Action

Replace an export's NFS export options — the per-client access rules (source CIDR, read-write/read-only, identity squash) that govern who may mount the file system through this export. The supplied list fully replaces the current options.

Returns: tool_result, export, id, lifecycle_state, success, error

03File

OCI File Storage: Change File System Compartment

oracle/filestorage/file_system_change_compartment · Action

Move an Oracle Cloud NFS file system into a different compartment. The file system keeps its OCID and data; only its compartment changes.

Returns: tool_result, id, target_compartment_id, success, error

OCI File Storage: Create File System

oracle/filestorage/file_system_create · Action

Create an Oracle Cloud NFS file system in an availability domain. Mount it by wiring an Export to a mount target. Returns the OCID immediately in a CREATING state; poll Get File System until ACTIVE.

Returns: tool_result, file_system, id, lifecycle_state, success, error

OCI File Storage: Delete File System

oracle/filestorage/file_system_delete · Action

Permanently delete an Oracle Cloud NFS file system by OCID. Delete its exports and snapshots first if OCI reports it is still in use. Poll Get File System (it 404s once gone).

Returns: tool_result, id, success, error

OCI File Storage: Get File System

oracle/filestorage/file_system_get · Action

Fetch a single Oracle Cloud NFS file system by OCID — its display name, availability domain, metered size and lifecycle state.

Returns: tool_result, file_system, id, lifecycle_state, success, error

OCI File Storage: List File Systems

oracle/filestorage/file_system_list · Action

List the Oracle Cloud NFS file systems in a compartment and availability domain (both required — file systems are AD-scoped), optionally filtered by display name. Walks pagination up to a safe cap.

Returns: tool_result, file_systems, count, truncated, success, error

OCI File Storage: Update File System

oracle/filestorage/file_system_update · Action

Update an Oracle Cloud NFS file system's display name and/or free-form tags. Only the fields you supply are changed; the rest are left as-is.

Returns: tool_result, file_system, id, lifecycle_state, success, error

04Mount

OCI File Storage: Change Mount Target Compartment

oracle/filestorage/mount_target_change_compartment · Action

Move an Oracle Cloud mount target into a different compartment. Synchronous — the mount target keeps its OCID and stays reachable throughout.

Returns: tool_result, id, success, error

OCI File Storage: Create Mount Target

oracle/filestorage/mount_target_create · Action

Create an Oracle Cloud mount target — the NFS endpoint (a private IP in a subnet) that clients mount file systems through. Also creates its export set. Wire file systems to it with Create Export. Poll Get Mount Target until ACTIVE.

Returns: tool_result, mount_target, id, export_set_id, lifecycle_state, success, error

OCI File Storage: Delete Mount Target

oracle/filestorage/mount_target_delete · Action

Permanently delete an Oracle Cloud File Storage mount target by OCID. This also deletes its export set and every export in that set. Poll Get Mount Target (it 404s once gone).

Returns: tool_result, id, success, error

OCI File Storage: Downgrade Mount Target Shape

oracle/filestorage/mount_target_downgrade_shape · Action

Schedule a throughput downgrade for an Oracle Cloud NFS mount target, setting a new lower requested throughput in Gbps.

Returns: tool_result, mount_target, id, lifecycle_state, success, error

OCI File Storage: Get Mount Target

oracle/filestorage/mount_target_get · Action

Fetch a single Oracle Cloud NFS mount target by OCID — its display name, availability domain, subnet, export set, private IPs and lifecycle state.

Returns: tool_result, mount_target, id, lifecycle_state, success, error

OCI File Storage: List Mount Targets

oracle/filestorage/mount_target_list · Action

List the Oracle Cloud mount targets in a compartment and availability domain (both required — mount targets are AD-scoped), optionally filtered by display name. Walks pagination up to a safe cap.

Returns: tool_result, mount_targets, count, truncated, success, error

OCI File Storage: Update Mount Target

oracle/filestorage/mount_target_update · Action

Update an Oracle Cloud mount target's display name and/or its Network Security Group membership. The NSG list is replace-all: supply NSG OCIDs to replace the whole set, leave it blank to keep the current NSGs unchanged.

Returns: tool_result, mount_target, id, lifecycle_state, success, error

OCI File Storage: Upgrade Mount Target Shape

oracle/filestorage/mount_target_upgrade_shape · Action

Increase the throughput (shape) of an Oracle Cloud NFS mount target by setting a new requested throughput in Gbps.

Returns: tool_result, mount_target, id, lifecycle_state, success, error

05Outbound

OCI File Storage: Create Outbound Connector

oracle/filestorage/outbound_connector_create · Action

Create an Oracle Cloud File Storage outbound connector — the LDAP bind account mount targets use to reach an external LDAP directory. Returns the OCID immediately in a CREATING state; poll Get Outbound Connector until ACTIVE.

Returns: tool_result, outbound_connector, id, lifecycle_state, success, error

OCI File Storage: Delete Outbound Connector

oracle/filestorage/outbound_connector_delete · Action

Permanently delete an Oracle Cloud File Storage outbound connector (Kerberos/LDAP endpoint) by OCID. It moves to DELETING then DELETED; poll Get Outbound Connector (it 404s once gone).

Returns: tool_result, id, success, error

OCI File Storage: Get Outbound Connector

oracle/filestorage/outbound_connector_get · Action

Fetch a single Oracle Cloud File Storage outbound connector by OCID — its display name, availability domain, lifecycle state and (for an LDAP bind account) the server endpoints and bind distinguished name.

Returns: tool_result, outbound_connector, id, lifecycle_state, success, error

OCI File Storage: List Outbound Connectors

oracle/filestorage/outbound_connector_list · Action

List the Oracle Cloud File Storage outbound connectors in a compartment and availability domain (both required), optionally filtered by display name. Walks pagination up to a safe cap.

Returns: tool_result, outbound_connectors, count, truncated, success, error

OCI File Storage: Update Outbound Connector

oracle/filestorage/outbound_connector_update · Action

Rename an Oracle Cloud File Storage outbound connector and/or set its free-form tags. Only the fields you supply are changed.

Returns: tool_result, outbound_connector, id, lifecycle_state, success, error

06Quota

OCI File Storage: Create Quota Rule

oracle/filestorage/quota_rule_create · Action

Add a quota rule to an Oracle Cloud NFS file system, limiting the logical space a user, a group, or the whole file system may consume.

Returns: tool_result, quota_rule, id, success, error

OCI File Storage: Delete Quota Rule

oracle/filestorage/quota_rule_delete · Action

Delete a single usage quota rule from an Oracle Cloud NFS file system by its file-system and quota-rule OCIDs.

Returns: tool_result, id, success, error

OCI File Storage: Get Quota Rule

oracle/filestorage/quota_rule_get · Action

Fetch a single Oracle Cloud File Storage quota rule by its identifier within a file system — its display name, principal, hard/soft flag and gigabyte limit.

Returns: tool_result, quota_rule, id, success, error

OCI File Storage: List Quota Rules

oracle/filestorage/quota_rule_list · Action

List the quota rules and current usage on one Oracle Cloud NFS file system, for a given principal type (FILE_SYSTEM_LEVEL, DEFAULT_USER/GROUP or INDIVIDUAL_USER/GROUP), optionally limited to principals that violate their quota. Walks pagination up to a safe cap.

Returns: tool_result, quota_rules, count, truncated, success, error

OCI File Storage: Update Quota Rule

oracle/filestorage/quota_rule_update · Action

Update an Oracle Cloud file-system quota rule's display name and/or gigabyte limit. Only the fields you supply are changed; the rest are left as-is. (Whether a rule is a hard quota is fixed at creation and cannot be edited.)

Returns: tool_result, quota_rule, id, success, error

07Replication

OCI File Storage: Create Replication

oracle/filestorage/replication_create · Action

Create an Oracle Cloud File Storage replication between a source file system and a target file system in another region or availability domain — the replication periodically copies snapshot deltas to keep the target current.

Returns: tool_result, replication, id, lifecycle_state, success, error

OCI File Storage: Delete Replication

oracle/filestorage/replication_delete · Action

Delete an Oracle Cloud File Storage replication by OCID. Optionally choose a delete mode to control how the in-flight delta cycle is handled before removal. Poll Get Replication (it 404s once gone).

Returns: tool_result, id, success, error

OCI File Storage: Get Replication

oracle/filestorage/replication_get · Action

Fetch a single Oracle Cloud File Storage replication by OCID — its source and target file systems, replication interval, delta status and lifecycle state.

Returns: tool_result, replication, id, lifecycle_state, success, error

OCI File Storage: List Replications

oracle/filestorage/replication_list · Action

List the Oracle Cloud File Storage replications in a compartment and availability domain (both required — the ListReplications API mandates the availability domain), optionally filtered by display name. Walks pagination up to a safe cap.

Returns: tool_result, replications, count, truncated, success, error

OCI File Storage: Get Replication Target

oracle/filestorage/replication_target_get · Action

Fetch a single Oracle Cloud File Storage replication target by OCID — the destination side of a replication, showing its source/target file systems, delta status and recovery point.

Returns: tool_result, replication_target, id, lifecycle_state, success, error

OCI File Storage: List Replication Targets

oracle/filestorage/replication_target_list · Action

List the Oracle Cloud File Storage replication targets in a compartment and availability domain (both required — a replication target sits in the same AD as its target file system), optionally filtered by display name. Walks pagination up to a safe cap.

Returns: tool_result, replication_targets, count, truncated, success, error

OCI File Storage: Update Replication

oracle/filestorage/replication_update · Action

Update an Oracle Cloud File Storage cross-region replication — change its display name and/or the minutes between replication snapshots. Only the fields you supply are changed.

Returns: tool_result, replication, id, lifecycle_state, success, error

08Snapshot

OCI File Storage: Create Snapshot

oracle/filestorage/snapshot_create · Action

Take a point-in-time snapshot of an Oracle Cloud file system — read-only and space-efficient. Clone a new file system from it with Create File System's source snapshot. Poll Get Snapshot until ACTIVE.

Returns: tool_result, snapshot, id, lifecycle_state, success, error

OCI File Storage: Delete Snapshot

oracle/filestorage/snapshot_delete · Action

Permanently delete an Oracle Cloud NFS file-system snapshot by OCID. The snapshot moves to DELETING then DELETED; poll Get Snapshot (it 404s once gone).

Returns: tool_result, id, success, error

OCI File Storage: Get Snapshot

oracle/filestorage/snapshot_get · Action

Fetch a single Oracle Cloud file-system snapshot by OCID — its name, parent file system, snapshot type and lifecycle state.

Returns: tool_result, snapshot, id, lifecycle_state, success, error

OCI File Storage: List Snapshots

oracle/filestorage/snapshot_list · Action

List the snapshots of an Oracle Cloud NFS file system, filtered by file system OCID and/or compartment. Snapshots are not availability-domain-scoped. Walks pagination up to a safe cap.

Returns: tool_result, snapshots, count, truncated, success, error

OCI File Storage: Create Snapshot Policy

oracle/filestorage/snapshot_policy_create · Action

Create an Oracle Cloud file system snapshot policy — the schedule that automates snapshot creation and retention. Attach file systems to it to have snapshots taken on schedule. Returns the OCID immediately in a CREATING state; poll Get Snapshot Policy until ACTIVE.

Returns: tool_result, snapshot_policy, id, lifecycle_state, success, error

OCI File Storage: Delete Snapshot Policy

oracle/filestorage/snapshot_policy_delete · Action

Permanently delete an Oracle Cloud file system snapshot policy by OCID. Detach it from any file systems first if OCI reports it is still in use. Poll Get Snapshot Policy (it 404s once gone).

Returns: tool_result, id, success, error

OCI File Storage: Get Snapshot Policy

oracle/filestorage/snapshot_policy_get · Action

Fetch a single Oracle Cloud file system snapshot policy by OCID — its display name, policy prefix, lifecycle state and the snapshot schedules it runs.

Returns: tool_result, snapshot_policy, id, lifecycle_state, success, error

OCI File Storage: List Snapshot Policies

oracle/filestorage/snapshot_policy_list · Action

List the Oracle Cloud file system snapshot policies in a compartment and availability domain (both required — snapshot policies are AD-scoped), optionally filtered by display name. Walks pagination up to a safe cap.

Returns: tool_result, snapshot_policies, count, truncated, success, error

OCI File Storage: Update Snapshot Policy

oracle/filestorage/snapshot_policy_update · Action

Update an Oracle Cloud file system snapshot policy — its display name, snapshot prefix and/or the list of snapshot schedules. Leave schedules blank to keep the current ones untouched.

Returns: tool_result, snapshot_policy, id, lifecycle_state, success, error

OCI File Storage: Update Snapshot

oracle/filestorage/snapshot_update · Action

Update an Oracle Cloud file system snapshot's free-form tags and/or expiration time (the snapshot name is immutable). Only the fields you supply are changed; the rest are left as-is.

Returns: tool_result, snapshot, id, lifecycle_state, success, error

09Notes & Limitations

Behaviours and constraints worth knowing before you build with these nodes.

• Listing file systems, mount targets, export sets, snapshot policies, replications and outbound connectors requires both a Compartment OCID and an Availability Domain because these resources are availability-domain scoped, whereas exports, snapshots and quota rules are reached through their parent resource instead.
• A file system is not reachable by any client until you add an export linking it to a mount target's export set at an NFS path; creating the file system on its own does not expose it.
• Newly created file systems, mount targets, snapshot policies, snapshots and outbound connectors come back immediately in a CREATING state, so poll the matching Get action until it reports ACTIVE before mounting, wiring or otherwise depending on the resource.
• Deleting a mount target also deletes its export set and every export in that set, cutting off every client that mounts through it.
• List Exports and List Snapshots both reject a completely unscoped call: List Exports needs at least a compartment, export set or file system, and List Snapshots needs at least a file system or compartment.
• Whether a quota rule enforces a hard or soft limit is fixed when the rule is created and cannot be changed afterwards; only its display name and gigabyte limit can be updated later.