Container Engine integration | Flomation Support

00Overview

Provision and manage Oracle Cloud OKE Kubernetes clusters straight from a flow — create clusters, add and scale managed node pools or serverless virtual node pools, install add-ons such as cert-manager or the Kubernetes Dashboard, and generate a kubeconfig to hand to a downstream kubectl or Helm step. Track every asynchronous change through its work request, read node pools, virtual nodes, add-ons and pod shapes, rotate cluster credentials, and manage workload mappings without leaving the editor.

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 Container Engine

Every action starts with an Authentication method: Connect Oracle Cloud uses a managed connection you set up once (recommended), while API signing key (advanced) lets you paste raw OCI signing-key credentials directly on the node.
Connect Oracle Cloud (recommended): in your Flomation environment, add an Oracle Cloud (API key) connection — give it a name plus your Tenancy OCID and Region, then click Deploy to Oracle Cloud. That opens a ready-made Resource Manager stack in your tenancy (cloud.oracle.com) which creates a dedicated least-privilege user and uploads Flomation's public key for you.
Apply the stack, copy the new user's User OCID from its outputs back into the wizard, click Connect, then Test — allow up to about 90 seconds for Oracle Cloud to activate the key before the test turns green. On the node, set Authentication to Connect Oracle Cloud and pick this connection in the Oracle Cloud connection field.
API signing key (advanced): in the OCI Console open the profile menu → My profile → API keys → Add API key, download the generated private key, and copy the Configuration file preview values — these give you the Tenancy OCID, User OCID, Key Fingerprint and Region to paste into the matching node fields.
Set Compartment OCID to the compartment your clusters live in (Console → Identity & Security → Compartments) — list and create actions are scoped to it.
Store the private key PEM as a Flomation environment secret (e.g. containerengine_secret) and select it in the node's Private Key (PEM) field, adding the Private Key Passphrase only if your key is encrypted.

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

Good to know

Pick an Environment on your flow (Flow Settings → Environment) so the secret resolves. Secret fields never show the value — they reference ${secrets.your_secret}.

02Addon

OCI Container Engine: Disable Add-on

oracle/containerengine/addon_disable · Action

Disable a managed add-on on an Oracle Cloud OKE cluster, optionally removing its deployed resources. Asynchronous — returns a work-request id; poll Get Work Request until it completes.

Field	Type		Details
Compartment OCID	`string`		ocid1.compartment.oc1..aaaa… (scopes the cluster picker)
Cluster OCID	`string`	Required	ocid1.cluster.oc1..aaaa…
Add-on Name	`string`	Required	The add-on to disable, e.g. KubernetesDashboard
Remove Existing Add-on	`boolean`		Also delete the deployed add-on resources completely (optional)

Returns: tool_result, work_request_id, success, error

OCI Container Engine: Get Add-on

oracle/containerengine/addon_get · Action

Fetch a single add-on installed on an Oracle Cloud OKE cluster by name — its version, installed version, and lifecycle state.

Field	Type		Details
Compartment OCID	`string`		ocid1.compartment.oc1..aaaa… (scopes the picker)
Cluster OCID	`string`	Required	ocid1.cluster.oc1..aaaa…
Add-on Name	`string`	Required	e.g. KubernetesDashboard

Returns: tool_result, addon, name, lifecycle_state, success, error

OCI Container Engine: Install Add-on

oracle/containerengine/addon_install · Action

Install (enable) a managed add-on such as CertManager or KubernetesDashboard on an Oracle Cloud OKE cluster. Asynchronous — returns a work-request id; poll Get Work Request until it completes.

Field	Type		Details
Compartment OCID	`string`		ocid1.compartment.oc1..aaaa… (scopes the picker)
Cluster OCID	`string`	Required	ocid1.cluster.oc1..aaaa…
Add-on Name	`string`	Required	e.g. CertManager or KubernetesDashboard
Add-on Version	`string`		Specific add-on version to install (optional — defaults to latest)
Override Existing	`boolean`		Override an existing installation of this add-on (optional, default false)

Returns: tool_result, work_request_id, success, error

OCI Container Engine: List Add-ons

oracle/containerengine/addon_list · Action

List the add-ons installed on an Oracle Cloud OKE cluster. Walks pagination up to a safe cap.

Field	Type		Details
Compartment OCID	`string`		ocid1.compartment.oc1..aaaa… (scopes the picker)
Cluster OCID	`string`	Required	ocid1.cluster.oc1..aaaa…

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

OCI Container Engine: List Add-on Options

oracle/containerengine/addon_options_list · Action

List the Oracle Cloud OKE add-ons available for a given Kubernetes version. Walks pagination up to a safe cap.

Field	Type		Details
Compartment OCID	`string`		ocid1.compartment.oc1..aaaa… (scopes the picker; this API takes no compartment)
Kubernetes Version	`string`	Required	e.g. v1.30.1 — the version to fetch add-ons for

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

OCI Container Engine: Update Add-on

oracle/containerengine/addon_update · Action

Change the version of an add-on installed on an Oracle Cloud OKE cluster — returns a work request to poll until the update completes.

Field	Type		Details
Compartment OCID	`string`		ocid1.compartment.oc1..aaaa… (scopes the picker)
Cluster OCID	`string`	Required	ocid1.cluster.oc1..aaaa…
Add-on Name	`string`	Required	e.g. KubernetesDashboard
Version	`string`		The add-on version to install (optional — omit to keep current)

Returns: tool_result, work_request_id, success, error

03Cluster

OCI Container Engine: Create Cluster

oracle/containerengine/cluster_create · Action

Provision a new Oracle Cloud OKE Kubernetes cluster in a VCN. Asynchronous — returns a work-request id; poll Get Work Request until it completes, then Get Cluster for the API endpoints.

Field	Type		Details
Compartment OCID	`string`	Required	ocid1.compartment.oc1..aaaa… (use the tenancy OCID for the root)
Cluster Name	`string`	Required	A name for the cluster
VCN OCID	`string`	Required	ocid1.vcn.oc1..aaaa… the cluster runs in
Kubernetes Version	`string`	Required	e.g. v1.30.1 (see Get Cluster Options for the supported list)
API Endpoint Subnet OCID	`string`		ocid1.subnet.oc1..aaaa… the Kubernetes API endpoint lives in (recommended)
Public API Endpoint	`boolean`		Give the Kubernetes API endpoint a public IP (only with an endpoint subnet)
Cluster Type	`string`		ENHANCED_CLUSTER (default) or BASIC_CLUSTER — choices: Enhanced, Basic
Service LB Subnet OCIDs	`string`		Comma-separated subnet OCIDs for load-balancer services (optional)
KMS Key OCID	`string`		ocid1.key.oc1..aaaa… to encrypt etcd/secrets (optional)
Freeform Tags (JSON)	`string`		{"env":"prod"} (optional)

Returns: tool_result, work_request_id, success, error

OCI Container Engine: Delete Cluster

oracle/containerengine/cluster_delete · Action

Delete an Oracle Cloud OKE Kubernetes cluster by OCID. Asynchronous — returns a work-request id; poll Get Work Request until the deletion completes.

Field	Type		Details
Compartment OCID	`string`		ocid1.compartment.oc1..aaaa… (scopes the cluster picker)
Cluster OCID	`string`	Required	ocid1.cluster.oc1..aaaa…

Returns: tool_result, work_request_id, success, error

OCI Container Engine: Get Cluster

oracle/containerengine/cluster_get · Action

Fetch a single Oracle Cloud OKE cluster by OCID — its Kubernetes version, lifecycle state, and public/private API endpoints.

Field	Type		Details
Compartment OCID	`string`		ocid1.compartment.oc1..aaaa… (scopes the cluster picker)
Cluster OCID	`string`	Required	ocid1.cluster.oc1..aaaa…

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

OCI Container Engine: List Clusters

oracle/containerengine/cluster_list · Action

List the Oracle Cloud OKE clusters in 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)
Name Filter	`string`		Only clusters with this exact name (optional)

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

OCI Container Engine: Get Cluster Options

oracle/containerengine/cluster_options_get · Action

List the Kubernetes versions available for new Oracle Cloud OKE clusters in a compartment.

Field	Type		Details
Compartment OCID	`string`	Required	ocid1.compartment.oc1..aaaa… (use the tenancy OCID for the root)

Returns: tool_result, kubernetes_versions, success, error

OCI Container Engine: Update Cluster

oracle/containerengine/cluster_update · Action

Rename an Oracle Cloud OKE cluster and/or upgrade its Kubernetes control-plane version. Asynchronous — returns a work-request id; poll Get Work Request until it completes.

Field	Type		Details
Compartment OCID	`string`		ocid1.compartment.oc1..aaaa… (scopes the cluster picker)
Cluster OCID	`string`	Required	ocid1.cluster.oc1..aaaa…
New Cluster Name	`string`		Rename the cluster (optional)
Kubernetes Version	`string`		e.g. v1.30.1 — upgrade the control plane (optional; see Get Cluster Options)

Returns: tool_result, work_request_id, success, error

OCI Container Engine: Update Cluster Endpoint Config

oracle/containerengine/cluster_update_endpoint_config · Action

Update the Kubernetes API endpoint network config of an Oracle Cloud OKE cluster — public-IP assignment, network security groups, and subnet. Asynchronous — returns a work-request id; poll Get Work Request until it completes.

Field	Type		Details
Compartment OCID	`string`		ocid1.compartment.oc1..aaaa… (scopes the cluster picker)
Cluster OCID	`string`	Required	ocid1.cluster.oc1..aaaa…
Assign Public IP	`boolean`		Whether the endpoint gets a public IP (leave unset to keep current)
Network Security Group OCIDs	`string`		Comma-separated NSG OCIDs to apply to the endpoint (optional)

Returns: tool_result, work_request_id, success, error

04Credential

OCI Container Engine: Complete Credential Rotation

oracle/containerengine/credential_rotation_complete · Action

Finalise a credential rotation on an Oracle Cloud OKE cluster, retiring the superseded key and certificate material.

Field	Type		Details
Compartment OCID	`string`		ocid1.compartment.oc1..aaaa… (scopes the cluster picker)
Cluster OCID	`string`	Required	ocid1.cluster.oc1..aaaa…

Returns: tool_result, work_request_id, success, error

OCI Container Engine: Start Credential Rotation

oracle/containerengine/credential_rotation_start · Action

Begin rotating an Oracle Cloud OKE cluster's credentials. Asynchronous — returns a work-request id; poll Get Work Request until it completes.

Field	Type		Details
Compartment OCID	`string`		ocid1.compartment.oc1..aaaa… (scopes the cluster picker)
Cluster OCID	`string`	Required	ocid1.cluster.oc1..aaaa…
Auto-Completion Delay	`string`		ISO-8601 days after which old credentials retire, e.g. P3D (max P90D, optional)

Returns: tool_result, work_request_id, success, error

OCI Container Engine: Get Credential Rotation Status

oracle/containerengine/credential_rotation_status_get · Action

Check the credential rotation status of an Oracle Cloud OKE cluster — whether a rotation is in progress, waiting, or completed, and when auto-completion is scheduled.

Field	Type		Details
Compartment OCID	`string`		ocid1.compartment.oc1..aaaa… (scopes the cluster picker)
Cluster OCID	`string`	Required	ocid1.cluster.oc1..aaaa…

Returns: tool_result, status, status_details, time_auto_completion_scheduled, success, error

05Kubeconfig

OCI Container Engine: Create Kubeconfig

oracle/containerengine/kubeconfig_create · Action

Generate a kubeconfig for an Oracle Cloud OKE cluster and return its YAML content — hand it to kubectl or a downstream step to talk to the cluster. Defaults to the public API endpoint and a token that lasts the maximum allowed.

Field	Type		Details
Compartment OCID	`string`		ocid1.compartment.oc1..aaaa… (scopes the cluster picker)
Cluster OCID	`string`	Required	ocid1.cluster.oc1..aaaa… to generate the kubeconfig for
Endpoint	`string`		Which API endpoint the kubeconfig targets — PUBLIC_ENDPOINT (default), PRIVATE_ENDPOINT or VCN_HOSTNAME — choices: Public endpoint, Private endpoint, VCN hostname

Returns: tool_result, kubeconfig, success, error

06Node

OCI Container Engine: Delete Node

oracle/containerengine/node_delete · Action

Delete a single Oracle Cloud OKE worker node from its node pool by OCID, optionally shrinking the pool. Asynchronous — returns a work-request id; poll Get Work Request until it completes.

Field	Type		Details
Compartment OCID	`string`		ocid1.compartment.oc1..aaaa… (scopes the picker)
Node Pool OCID	`string`	Required	ocid1.nodepool.oc1..aaaa… the node belongs to
Node OCID	`string`	Required	ocid1.instance.oc1..aaaa… (the compute instance backing the node)
Decrement Pool Size	`boolean`		Also shrink the node pool's desired size by one (optional)

Returns: tool_result, work_request_id, success, error

OCI Container Engine: Create Node Pool

oracle/containerengine/node_pool_create · Action

Add a managed worker node pool to an Oracle Cloud OKE cluster — pick the compute shape, node image, count and where the nodes land (availability domain + subnet). Asynchronous — returns a work-request id; poll Get Work Request, then Get Node Pool.

Field	Type		Details
Compartment OCID	`string`	Required	ocid1.compartment.oc1..aaaa… (use the tenancy OCID for the root)
Cluster OCID	`string`	Required	ocid1.cluster.oc1..aaaa… the pool belongs to
Node Pool Name	`string`	Required	A name for the node pool
Kubernetes Version	`string`	Required	e.g. v1.30.1 (must match / trail the cluster)
Node Shape	`string`	Required	e.g. VM.Standard.E4.Flex (see Get Node Pool Options)
Node Image OCID	`string`	Required	ocid1.image.oc1..aaaa… — an OKE worker image
Node Count	`string`	Required	How many worker nodes to launch
Availability Domain	`string`	Required	e.g. Vgqo:UK-LONDON-1-AD-1 — where the nodes land
Subnet OCID	`string`	Required	ocid1.subnet.oc1..aaaa… for the worker nodes
SSH Public Key	`text`		Public key to allow SSH to the nodes (optional)
Freeform Tags (JSON)	`string`		{"env":"prod"} (optional)

Returns: tool_result, work_request_id, success, error

OCI Container Engine: Delete Node Pool

oracle/containerengine/node_pool_delete · Action

Delete an Oracle Cloud OKE node pool by OCID, draining and terminating its worker nodes. Asynchronous — returns a work-request id; poll Get Work Request until it completes.

Field	Type		Details
Compartment OCID	`string`		ocid1.compartment.oc1..aaaa… (scopes the picker)
Node Pool OCID	`string`	Required	ocid1.nodepool.oc1..aaaa…

Returns: tool_result, work_request_id, success, error

OCI Container Engine: Get Node Pool

oracle/containerengine/node_pool_get · Action

Fetch a single Oracle Cloud OKE node pool by OCID — its node shape, Kubernetes version, size, lifecycle state, and member nodes.

Field	Type		Details
Compartment OCID	`string`		ocid1.compartment.oc1..aaaa… (scopes the node pool picker)
Node Pool OCID	`string`	Required	ocid1.nodepool.oc1..aaaa…

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

OCI Container Engine: List Node Pools

oracle/containerengine/node_pool_list · Action

List the Oracle Cloud OKE node pools in a compartment, optionally scoped to one cluster. 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)
Cluster OCID	`string`		Only node pools in this cluster (optional)

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

OCI Container Engine: Get Node Pool Options

oracle/containerengine/node_pool_options_get · Action

List the node-pool shapes and Kubernetes versions available in a compartment for creating or updating OKE node pools.

Field	Type		Details
Compartment OCID	`string`	Required	ocid1.compartment.oc1..aaaa… (use the tenancy OCID for the root)

Returns: tool_result, shapes, kubernetes_versions, success, error

OCI Container Engine: Update Node Pool

oracle/containerengine/node_pool_update · Action

Change a managed Oracle Cloud OKE node pool — rename it, upgrade its Kubernetes version, or scale the node count. Asynchronous — returns a work-request id; poll Get Work Request until it completes, then Get Node Pool.

Field	Type		Details
Compartment OCID	`string`		ocid1.compartment.oc1..aaaa… (scopes the node-pool picker)
Node Pool OCID	`string`	Required	ocid1.nodepool.oc1..aaaa…
Node Pool Name	`string`		A new name for the node pool (optional)
Kubernetes Version	`string`		e.g. v1.30.1 to upgrade the nodes to (optional)
Node Count	`string`		New number of worker nodes — scales the pool (optional)

Returns: tool_result, work_request_id, success, error

OCI Container Engine: Reboot Node

oracle/containerengine/node_reboot · Action

Reboot a single worker node of an Oracle Cloud OKE cluster by OCID — returns a work-request OCID to poll until the reboot completes.

Field	Type		Details
Compartment OCID	`string`		ocid1.compartment.oc1..aaaa… (scopes the picker)
Cluster OCID	`string`	Required	ocid1.cluster.oc1..aaaa…
Node OCID	`string`	Required	ocid1.instance.oc1..aaaa… (the worker node compute instance)

Returns: tool_result, work_request_id, success, error

OCI Container Engine: Replace Node Boot Volume

oracle/containerengine/node_replace_boot_volume · Action

Replace the boot volume of a single Oracle Cloud OKE worker node by OCID — returns a work request to poll until it completes.

Field	Type		Details
Compartment OCID	`string`		ocid1.compartment.oc1..aaaa… (scopes the picker)
Cluster OCID	`string`	Required	ocid1.cluster.oc1..aaaa…
Node OCID	`string`	Required	ocid1.instance.oc1..aaaa… (the compute instance backing the node)

Returns: tool_result, work_request_id, success, error

07Pod

OCI Container Engine: List Pod Shapes

oracle/containerengine/pod_shape_list · Action

List the pod shapes available for virtual nodes in an Oracle Cloud OKE 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`		Only shapes offered in this AD, e.g. Uocm:UK-LONDON-1-AD-1 (optional)

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

08Virtual

OCI Container Engine: Get Virtual Node

oracle/containerengine/virtual_node_get · Action

Fetch a single Oracle Cloud OKE virtual node by OCID — its availability domain, subnet, private IP, and lifecycle state.

Field	Type		Details
Compartment OCID	`string`		ocid1.compartment.oc1..aaaa… (scopes the picker)
Virtual Node Pool OCID	`string`	Required	ocid1.virtualnodepool.oc1..aaaa…
Virtual Node OCID	`string`	Required	ocid1.virtualnode.oc1..aaaa…

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

OCI Container Engine: List Virtual Nodes

oracle/containerengine/virtual_node_list · Action

List the virtual nodes in an Oracle Cloud OKE virtual node pool. Walks pagination up to a safe cap.

Field	Type		Details
Compartment OCID	`string`		ocid1.compartment.oc1..aaaa… (scopes the picker)
Virtual Node Pool OCID	`string`	Required	ocid1.virtualnodepool.oc1..aaaa…

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

OCI Container Engine: Create Virtual Node Pool

oracle/containerengine/virtual_node_pool_create · Action

Add a virtual node pool to an Oracle Cloud OKE cluster — serverless pods OCI schedules for you, placed in an availability domain + subnet with a pod subnet and pod shape. Asynchronous — returns a work-request id; poll Get Work Request, then Get Virtual Node Pool.

Field	Type		Details
Compartment OCID	`string`	Required	ocid1.compartment.oc1..aaaa… (use the tenancy OCID for the root)
Cluster OCID	`string`	Required	ocid1.cluster.oc1..aaaa… the pool belongs to
Virtual Node Pool Name	`string`	Required	A name for the virtual node pool
Availability Domain	`string`	Required	e.g. Vgqo:UK-LONDON-1-AD-1 — where the virtual nodes land
Subnet OCID	`string`	Required	ocid1.subnet.oc1..aaaa… for the virtual nodes
Pod Subnet OCID	`string`	Required	ocid1.subnet.oc1..aaaa… (regional) where pods' VNICs land
Pod Shape	`string`	Required	e.g. Pod.Standard.E4.Flex — the shape of the pods
Virtual Node Count	`string`		How many virtual nodes to launch (default 1)

Returns: tool_result, work_request_id, success, error

OCI Container Engine: Delete Virtual Node Pool

oracle/containerengine/virtual_node_pool_delete · Action

Delete an Oracle Cloud OKE virtual node pool by OCID. Asynchronous — returns a work-request id; poll Get Work Request until the deletion completes.

Field	Type		Details
Compartment OCID	`string`		ocid1.compartment.oc1..aaaa… (scopes the picker)
Virtual Node Pool OCID	`string`	Required	ocid1.virtualnodepool.oc1..aaaa…

Returns: tool_result, work_request_id, success, error

OCI Container Engine: Get Virtual Node Pool

oracle/containerengine/virtual_node_pool_get · Action

Fetch a single Oracle Cloud OKE virtual node pool by OCID — its cluster, Kubernetes version, size, and lifecycle state.

Field	Type		Details
Compartment OCID	`string`		ocid1.compartment.oc1..aaaa… (scopes the picker)
Virtual Node Pool OCID	`string`	Required	ocid1.virtualnodepool.oc1..aaaa…

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

OCI Container Engine: List Virtual Node Pools

oracle/containerengine/virtual_node_pool_list · Action

List the Oracle Cloud OKE virtual node pools in a compartment, optionally scoped to one cluster. 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)
Cluster OCID	`string`		Only virtual node pools in this cluster (optional)

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

OCI Container Engine: Update Virtual Node Pool

oracle/containerengine/virtual_node_pool_update · Action

Update an Oracle Cloud OKE virtual node pool by OCID — change its display name and/or virtual node count. Asynchronous; poll Get Work Request until it completes.

Field	Type		Details
Compartment OCID	`string`		ocid1.compartment.oc1..aaaa… (scopes the picker)
Virtual Node Pool OCID	`string`	Required	ocid1.virtualnodepool.oc1..aaaa…
Display Name	`string`		New display name (optional)
Size	`string`		Number of virtual nodes (optional)

Returns: tool_result, work_request_id, success, error

09Work

OCI Container Engine: Cancel Work Request

oracle/containerengine/work_request_cancel · Action

Cancel an in-progress Oracle Cloud OKE work request by OCID, asking OCI to stop the underlying operation.

Field	Type		Details
Compartment OCID	`string`		ocid1.compartment.oc1..aaaa… (scopes the picker)
Work Request OCID	`string`	Required	ocid1.clustersworkrequest.oc1..aaaa…

Returns: tool_result, id, success, error

OCI Container Engine: List Work Request Errors

oracle/containerengine/work_request_errors_list · Action

List the errors recorded against an Oracle Cloud OKE work request.

Field	Type		Details
Compartment OCID	`string`	Required	ocid1.compartment.oc1..aaaa… (use the tenancy OCID for the root)
Work Request OCID	`string`	Required	ocid1.clustersworkrequest.oc1..aaaa…

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

OCI Container Engine: Get Work Request

oracle/containerengine/work_request_get · Action

Fetch an Oracle Cloud OKE work request by OCID — its operation type, status (ACCEPTED/IN_PROGRESS/SUCCEEDED/FAILED), affected resources and timings. Poll this after any create/update/delete to track the async operation.

Field	Type		Details
Compartment OCID	`string`		ocid1.compartment.oc1..aaaa… (scopes the work-request picker)
Work Request OCID	`string`	Required	ocid1.clustersworkrequest.oc1..aaaa…

Returns: tool_result, work_request, id, status, success, error

OCI Container Engine: List Work Requests

oracle/containerengine/work_request_list · Action

List the Oracle Cloud OKE work requests in a compartment, optionally scoped to a cluster or resource. 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)
Cluster OCID	`string`		Only work requests for this cluster (optional)
Resource OCID	`string`		Only work requests affecting this resource (optional)

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

OCI Container Engine: List Work Request Logs

oracle/containerengine/work_request_logs_list · Action

List the log entries for an Oracle Cloud OKE work request, so a flow can trace what an asynchronous operation did.

Field	Type		Details
Compartment OCID	`string`	Required	ocid1.compartment.oc1..aaaa… (use the tenancy OCID for the root)
Work Request OCID	`string`	Required	ocid1.clustersworkrequest.oc1..aaaa…

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

10Workload

OCI Container Engine: Create Workload Mapping

oracle/containerengine/workload_mapping_create · Action

Create a workload mapping on an Oracle Cloud OKE cluster — bind a Kubernetes namespace to a mapped customer compartment.

Field	Type		Details
Compartment OCID	`string`		ocid1.compartment.oc1..aaaa… (scopes the cluster picker)
Cluster OCID	`string`	Required	ocid1.cluster.oc1..aaaa…
Namespace	`string`	Required	The Kubernetes namespace to map, e.g. default
Mapped Compartment OCID	`string`	Required	ocid1.compartment.oc1..aaaa… — the customer compartment to map to

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

OCI Container Engine: Delete Workload Mapping

oracle/containerengine/workload_mapping_delete · Action

Delete a single workload mapping from an Oracle Cloud OKE cluster by OCID.

Field	Type		Details
Compartment OCID	`string`		ocid1.compartment.oc1..aaaa… (scopes the picker)
Cluster OCID	`string`	Required	ocid1.cluster.oc1..aaaa…
Workload Mapping OCID	`string`	Required	ocid1.clusterworkloadmapping.oc1..aaaa…

Returns: tool_result, id, success, error

OCI Container Engine: Get Workload Mapping

oracle/containerengine/workload_mapping_get · Action

Fetch a single Oracle Cloud OKE workload mapping by OCID — its namespace, mapped tenancy/compartment, and lifecycle state.

Field	Type		Details
Compartment OCID	`string`		ocid1.compartment.oc1..aaaa… (scopes the picker)
Cluster OCID	`string`	Required	ocid1.cluster.oc1..aaaa…
Workload Mapping OCID	`string`	Required	ocid1.clusterworkloadmapping.oc1..aaaa…

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

OCI Container Engine: List Workload Mappings

oracle/containerengine/workload_mapping_list · Action

List the workload mappings on an Oracle Cloud OKE cluster. Walks pagination up to a safe cap.

Field	Type		Details
Compartment OCID	`string`		ocid1.compartment.oc1..aaaa… (scopes the picker)
Cluster OCID	`string`	Required	ocid1.cluster.oc1..aaaa… — the OKE cluster to list mappings for

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

OCI Container Engine: Update Workload Mapping

oracle/containerengine/workload_mapping_update · Action

Update an Oracle Cloud OKE workload mapping — re-point it at a different mapped compartment for the cluster.

Field	Type		Details
Compartment OCID	`string`		ocid1.compartment.oc1..aaaa… (scopes the picker)
Cluster OCID	`string`	Required	ocid1.cluster.oc1..aaaa…
Workload Mapping OCID	`string`	Required	ocid1.clusterworkloadmapping.oc1..aaaa…
Mapped Compartment OCID	`string`		ocid1.compartment.oc1..aaaa… (new mapped compartment, optional)

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

11Notes & Limitations

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

Every create, update, delete, reboot, scale and credential-rotation action runs asynchronously: it returns a work_request_id rather than the finished resource, so a flow should poll Get Work Request until the status reads SUCCEEDED before the cluster, node pool or new endpoint is ready to use.
Requesting a public API endpoint on Cluster Create without also supplying an API Endpoint Subnet OCID is rejected up front rather than silently ignored, so pair the two whenever you want a public endpoint.
Create Kubeconfig points at the cluster's public API endpoint by default, so a private-only cluster needs the Endpoint field switched to the private endpoint or VCN hostname and a flow that has network reach to it.
Once a credential rotation starts, both the new and the superseded credentials stay valid until Complete Credential Rotation is run or the auto-completion delay elapses, at which point the old material is retired automatically.
List actions walk at most 25 pages, so in unusually large compartments the returned set may not include every cluster, node pool or work request.