Compute
Oracle Cloud integration · 17 node(s).
00Overview
Manage the full lifecycle of Oracle Cloud Compute instances from a flow — launch new instances from an image into a subnet, then start, stop, reboot, rename, retag and terminate them, and read back their state, shape, region and network addresses. Browse the surrounding account too: compartments, availability domains, shapes, images, VCNs, subnets and boot volumes, so a flow can pick the right values before it acts. Keep instances labelled by setting or replacing their freeform tags as automation runs.
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 Compute
- Sign in to the Oracle Cloud Console, open the Profile menu (the avatar at the top-right) and choose My profile.
- Under Resources, open API keys → Add API key. Let Oracle Cloud generate a key pair and download the private key (a
.pemfile) — this is the signing key the node uses. - When you add the key, Oracle Cloud shows a Configuration file preview. Copy its values into the node:
tenancy→ Tenancy OCID,user→ User OCID,fingerprint→ Key Fingerprint, andregion→ Region (a plain region key such asuk-london-1). - For the Compartment OCID, open Identity & Security → Compartments and copy the OCID of the compartment whose instances you want to work with.
- Store the downloaded private key as a Flomation environment secret (e.g.
compute_secret) and select it in the node's Private Key (PEM) field; if the key is passphrase-protected, add the passphrase as a secret too and pick it in Private Key Passphrase.
| Field | Type | Details | |
|---|---|---|---|
| Region | string | Required | 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 | Required | ocid1.tenancy.oc1..aaaa… |
| User OCID | string | Required | ocid1.user.oc1..aaaa… |
| Key Fingerprint | string | Required | aa:bb:cc:… fingerprint of the uploaded API key |
${secrets.your_secret}.02Availability
OCI Compute: List Availability Domains
oracle/compute/availability_domain_get_all · Action
List the availability domains in the region — the fault-isolation zones an instance is launched into. Needed to pick a domain for List Shapes / Launch Instance.
| Field | Type | Details | |
|---|---|---|---|
| Compartment OCID | string | Required | ocid1.compartment.oc1..aaaa… (use the tenancy OCID for the root) |
Returns: tool_result, availability_domains, count, success, error
03Boot
OCI Compute: List Boot Volumes
oracle/compute/boot_volume_get_all · Action
List the boot volumes (instance root disks) in an Oracle Cloud compartment, optionally scoped to one availability domain. Includes volumes preserved after an instance was terminated.
| 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 (optional) |
Returns: tool_result, boot_volumes, count, success, error
04Compartment
OCI: List Compartments
oracle/compute/compartment_get_all · Action
List the compartments under a parent compartment (or the tenancy root) — OCI's resource-grouping unit. Optionally recurse the whole subtree.
| Field | Type | Details | |
|---|---|---|---|
| Parent Compartment OCID | string | Required | ocid1.compartment.oc1..aaaa… (use the tenancy OCID for the root) |
| Include whole subtree | boolean | List nested compartments recursively, not just direct children |
Returns: tool_result, compartments, count, success, error
05Image
OCI Compute: List Images
oracle/compute/image_get_all · Action
List the Compute images (OS/boot images) available in an Oracle Cloud compartment. Optionally filter by operating system or shape.
| Field | Type | Details | |
|---|---|---|---|
| Compartment OCID | string | Required | ocid1.compartment.oc1..aaaa… (use the tenancy OCID for the root) |
| Operating System filter | string | e.g. Oracle Linux, Canonical Ubuntu (optional) | |
| Shape filter | string | Only images compatible with this shape (optional) |
Returns: tool_result, images, count, success, error
06Instance
OCI Compute: Get Instance
oracle/compute/instance_get · Action
Fetch a single Oracle Cloud Compute instance by its OCID — lifecycle state, shape, availability domain, region and tags.
| Field | Type | Details | |
|---|---|---|---|
| Instance OCID | string | Required | ocid1.instance.oc1..aaaa… |
Returns: tool_result, instance, lifecycle_state, success, error
OCI Compute: List Instances
oracle/compute/instance_get_all · Action
List Compute instances in an Oracle Cloud compartment, with their lifecycle state (running/stopped), shape, availability domain, region and tags. Optionally filter by display name or lifecycle state.
| Field | Type | Details | |
|---|---|---|---|
| Compartment OCID | string | Required | ocid1.compartment.oc1..aaaa… (use the tenancy OCID for the root compartment) |
| Display Name filter | string | Only instances with this exact name (optional) | |
| Lifecycle State filter | string | Filter by state (optional) — choices: Any (all states), Running, Stopped, Starting, Stopping, Provisioning, Terminating, Terminated, Creating Image, Moving |
Returns: tool_result, instances, count, success, error
OCI Compute: Launch Instance
oracle/compute/instance_launch · Action
Create (launch) a new Oracle Cloud Compute instance from an image into a subnet. Supply the availability domain, shape, image and subnet; for flexible shapes set the OCPUs and memory.
| 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 (from List Availability Domains) |
| Shape | string | Required | e.g. VM.Standard.E5.Flex (from List Shapes) |
| Image OCID | string | Required | ocid1.image.oc1..aaaa… (from List Images) |
| Subnet OCID | string | Required | ocid1.subnet.oc1..aaaa… (from List Subnets) |
| Display Name | string | A friendly name for the instance (optional) | |
| OCPUs (flex shapes) | string | e.g. 1 — required for .Flex shapes | |
| Memory GB (flex shapes) | string | e.g. 16 — required for .Flex shapes | |
| Boot Volume Size (GB) | string | Override the image default (optional, min 50) | |
| SSH Public Key | text | ssh-rsa AAAA… — public key for the default OS user (optional) | |
| Assign Public IP | boolean | Give the primary VNIC a public IP (subnet must be public) | |
| Freeform Tags (JSON) | string | {"env":"prod"} (optional) |
Returns: tool_result, instance, instance_ocid, lifecycle_state, success, error
OCI Compute: List Instance VNICs
oracle/compute/instance_list_vnics · Action
List an instance's attached VNICs with their private and public IP addresses — how to reach the instance. Resolves each VNIC attachment to its IPs.
| Field | Type | Details | |
|---|---|---|---|
| Compartment OCID | string | Required | The instance's compartment OCID |
| Instance OCID | string | Required | ocid1.instance.oc1..aaaa… |
Returns: tool_result, vnics, primary_public_ip, primary_private_ip, count, success, error
OCI Compute: Reset Instance
oracle/compute/instance_reset · Action
Reboot an Oracle Cloud Compute instance. Defaults to a graceful reboot; enable Force for an immediate power-cycle.
| Field | Type | Details | |
|---|---|---|---|
| Instance OCID | string | Required | ocid1.instance.oc1..aaaa… |
| Force (immediate power-cycle) | boolean | Skip the graceful OS shutdown — risks data loss |
Returns: tool_result, instance, lifecycle_state, success, error
OCI Compute: Start Instance
oracle/compute/instance_start · Action
Power on a stopped Oracle Cloud Compute instance.
| Field | Type | Details | |
|---|---|---|---|
| Instance OCID | string | Required | ocid1.instance.oc1..aaaa… |
Returns: tool_result, instance, lifecycle_state, success, error
OCI Compute: Stop Instance
oracle/compute/instance_stop · Action
Power off a running Oracle Cloud Compute instance. Defaults to a graceful OS shutdown; enable Force for an immediate power-off.
| Field | Type | Details | |
|---|---|---|---|
| Instance OCID | string | Required | ocid1.instance.oc1..aaaa… |
| Force (immediate power-off) | boolean | Skip the graceful OS shutdown — risks data loss |
Returns: tool_result, instance, lifecycle_state, success, error
OCI Compute: Set Instance Tags
oracle/compute/instance_tag_set · Action
Replace the freeform tags on an Oracle Cloud Compute instance with a JSON object of string key/values. Replaces all freeform tags on the instance.
| Field | Type | Details | |
|---|---|---|---|
| Instance OCID | string | Required | ocid1.instance.oc1..aaaa… |
| Freeform Tags (JSON) | string | Required | {"env":"prod","owner":"ops"} |
Returns: tool_result, instance, lifecycle_state, success, error
OCI Compute: Terminate Instance
oracle/compute/instance_terminate · Action
Permanently delete an Oracle Cloud Compute instance. The boot volume is preserved by default (matching the OCI console); enable Delete Boot Volume to remove it too.
| Field | Type | Details | |
|---|---|---|---|
| Instance OCID | string | Required | ocid1.instance.oc1..aaaa… |
| Delete Boot Volume | boolean | Also permanently delete the boot volume (default: preserved, matching the OCI console) |
Returns: tool_result, instance_ocid, success, error
OCI Compute: Update Instance
oracle/compute/instance_update · Action
Rename an Oracle Cloud Compute instance and/or replace its freeform tags. Supply a new display name, a tags JSON object, or both.
| Field | Type | Details | |
|---|---|---|---|
| Instance OCID | string | Required | ocid1.instance.oc1..aaaa… |
| New Display Name | string | Leave blank to keep the current name | |
| Freeform Tags (JSON) | string | {"env":"prod","owner":"ops"} — replaces all freeform tags |
Returns: tool_result, instance, lifecycle_state, success, error
07Shape
OCI Compute: List Shapes
oracle/compute/shape_get_all · Action
List the Compute shapes (instance sizes — OCPUs and memory) available in an Oracle Cloud compartment. Optionally scope to one availability domain.
| 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 (optional) |
Returns: tool_result, shapes, count, success, error
08Subnet
OCI Compute: List Subnets
oracle/compute/subnet_get_all · Action
List the subnets in an Oracle Cloud compartment, optionally within one VCN — the network an instance's VNIC is placed in at launch.
| Field | Type | Details | |
|---|---|---|---|
| Compartment OCID | string | Required | ocid1.compartment.oc1..aaaa… (use the tenancy OCID for the root) |
| VCN OCID | string | Only subnets in this VCN (optional) |
Returns: tool_result, subnets, count, success, error
09Vcn
OCI Compute: List VCNs
oracle/compute/vcn_get_all · Action
List the Virtual Cloud Networks (VCNs) in an Oracle Cloud compartment — the networks that hold subnets and instances.
| Field | Type | Details | |
|---|---|---|---|
| Compartment OCID | string | Required | ocid1.compartment.oc1..aaaa… (use the tenancy OCID for the root) |
| Display Name filter | string | Only VCNs with this exact name (optional) |
Returns: tool_result, vcns, count, success, error
10Notes & Limitations
Behaviours and constraints worth knowing before you build with these nodes.
- Lifecycle actions can be rejected with an incorrect-state conflict while an instance is still mid-transition, so let a newly launched, stopped or started instance settle before you start, reboot or terminate it.
- Boot Volume Size must be at least 50 GB; Launch Instance rejects a smaller value before the request ever reaches Oracle Cloud.
- Flexible shapes (those ending in
.Flex) require the OCPUs and Memory GB fields to be set together; leave both blank for a fixed shape. - The tag fields accept only freeform string key/value pairs supplied as a JSON object — Oracle Cloud defined tags and tag namespaces are not supported, and Set Instance Tags replaces every existing freeform tag.
- List Instance VNICs reports a failure when it cannot resolve any of an instance's IP addresses, which usually means the credential's policy lacks permission to read the virtual-network family rather than that the instance has no reachable address.
- The Region field expects a plain Oracle Cloud region key such as
uk-london-1, not a console URL or endpoint hostname.