# Oracle Cloud

## Connection Requirements

{% stepper %}
{% step %}

### Domain

Domain of the Oracle Cloud. Pattern: `iaas.<REGION>.oraclecloud.com` (example region: `us-ashburn-1`).
{% endstep %}

{% step %}

### Tenancy OCID

The OCID of your Oracle Cloud tenancy.

How to get: Console -> Profile menu -> **Tenancy information** -> copy the OCID value.

Format: `ocid1.tenancy.oc1..[unique-identifier]`
{% endstep %}

{% step %}

### User OCID

The OCID of the IAM user that owns the API key (not the console username).

How to get: Console -> Profile menu -> **User settings** -> copy the OCID value.

Format: `ocid1.user.oc1..[unique-identifier]`
{% endstep %}

{% step %}

### Fingerprint

The fingerprint of your API signing key. This is generated when you upload your public key.

How to get: Console -> Profile menu -> **User settings** -> **API Keys** -> view the fingerprint of your uploaded key.

Format: `aa:bb:...:aa:bb`
{% endstep %}

{% step %}

### Private Key

The private key (PEM format) used to sign API requests.

How to get: Generate an RSA key pair using OpenSSL or OCI CLI. Upload the public key to Console -> Profile menu -> **User settings** -> **API Keys**, then use the private key here.

Command:

{% code title="Generate RSA private key" %}

```bash
openssl genrsa -out ~/.oci/oci_api_key.pem 2048
```

{% endcode %}
{% endstep %}

{% step %}

### Compartment OCID

OCID of the compartment to scope API calls (e.g., listing instances).

How to get: Console -> **Identity & Security** -> **Compartments** -> select your compartment -> copy OCID.

Format: `ocid1.compartment.oc1..[unique-identifier]`
{% endstep %}

{% step %}

### Version

OCI core services API version. Default is `20160918` for compute and networking services.

How to get: Use the default value `20160918` unless you need a specific API version.
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
Please perform a connection test to ensure there is a valid connection to the Oracle Cloud host. When the discovery operation finalizes you will be able to see the details on the Assets page.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.octoxlabs.com/adapters/adapters/oracle-cloud.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.