Oci Instance
@sntxrr/oci-instancev2026.07.18.1
01README
Power-control an Oracle Cloud Infrastructure (OCI) compute instance — reboot (SOFTRESET/RESET), start, stop, and sync lifecycle state via the OCI Core API with RSA-SHA256 request signing.
02Release Notes
Fix: use non-reserved data name 'current' (swamp reserves 'latest'), which previously broke every method. Validated end-to-end against live OCI.
03Models
@sntxrr/oci-instancev2026.07.18.1oci_instance.ts
Global Arguments
| Argument | Type | Description |
|---|---|---|
| tenancyId | string | Tenancy OCID, e.g. ocid1.tenancy.oc1..aaaa... |
| userId | string | User OCID, e.g. ocid1.user.oc1..aaaa... |
| fingerprint | string | API signing-key fingerprint, e.g. 12:34:56:...:ab |
| privateKey | string | PEM-encoded RSA API signing private key (PKCS#8 or PKCS#1, unencrypted). Wire with a vault.get(...) expression. |
| region | string | OCI region identifier, e.g. us-ashburn-1, uk-london-1 |
| instanceId | string | OCID of the compute instance this model manages, e.g. ocid1.instance.oc1..aaaa... |
| endpoint? | string | Override the IaaS API host. Defaults to iaas.<region>.oraclecloud.com (the OC1 commercial realm). Set for GovCloud or other realms. |
fn reboot(action: enum)
Reboot the instance. SOFTRESET (default) gracefully shuts down then powers on; RESET hard power-cycles.
| Argument | Type | Description |
|---|---|---|
| action | enum | SOFTRESET sends an ACPI shutdown then powers the VM back on (graceful). RESET immediately power-cycles the VM (hard). |
fn start()
Power on the instance (InstanceAction START).
fn stop(action: enum)
Power off the instance. SOFTSTOP (default) gracefully shuts down; STOP hard powers off.
| Argument | Type | Description |
|---|---|---|
| action | enum | SOFTSTOP sends an ACPI shutdown (graceful). STOP immediately powers the VM off (hard). |
fn sync()
Fetch the instance's current lifecycle state and details (GetInstance).
Resources
instance(infinite)— Snapshot of the OCI compute instance's state
action(infinite)— Record of a power-control action issued to the instance
04Previous Versions
2026.07.17.1
Initial release: reboot (SOFTRESET/RESET), start, stop (SOFTSTOP/STOP), and sync for OCI compute instances with RSA-SHA256 request signing.
05Stats
A
100 / 100
Downloads
6
Archive size
9.4 KB
- Has README or module doc2/2earned
- README has a code example1/1earned
- README is substantive1/1earned
- Most symbols documented1/1earned
- No slow types (deprecated)1/1earned
- Dependencies pass trust audit2/2earned
- Has description1/1earned
- Platform support declared (or universal)2/2earned
- License declared1/1earned
- Verified public repository2/2earned
Repository
https://github.com/sntxrr/swamp-oci06Platforms
07Labels