This page describes how to create an Exascale Storage Vault in
Google Cloud for Exadata Database Service on dedicated
infrastructure.

For Exadata Infrastructures, Oracle Database@Google Cloud lets you create and use
Exascale Storage Vaults for your Exadata VM Clusters.

Exascale Storage Vault with Exadata Database Service on dedicated infrastructure
introduces a next-generation intelligent data architecture for the cloud,
combining the strengths of Exadata with the agility of the cloud. Exascale
reimagines how compute and storage resources are managed on Exadata platforms by
decoupling and simplifying storage management, paving the way for innovative
capabilities.

Exascale Storage Vaults let administrators create pools of storage within a single Exadata Infrastructure that can be shared across multiple Exadata VM Clusters.
Databases that reside within a storage vault can be cloned across clusters or
container databases using a redirect-on-write technique to maximize storage
efficiency and minimize the time required to complete a clone operation.

## Before you begin

- Confirm that you have the required Identity and Access Management (IAM) roles and
  permissions to create an Exascale Storage Vault:

  - `roles/oracledatabase.exascaleDbStorageVaultAdmin`
  - `roles/oracledatabase.cloudExadataInfrastructureUser`

  For information on how to assign roles, see
  [Apply IAM roles](https://docs.cloud.google.com/oracle/database/docs/iam-roles.md.txt).

## Create an Exascale Storage Vault

You must create the Exascale Storage Vault in the same project as that of the
Exadata Infrastructure.

### gcloud

To create an Exascale Storage Vault, use the
`gcloud oracle-database exascale-db-storage-vaults create` command.

```
gcloud oracle-database exascale-db-storage-vaults create VAULT_ID \
--project=PROJECT_ID \
--location=REGION \
--display-name="VAULT_DISPLAY_NAME" \
--exascale-db-storage-details-total-size-gbs=VAULT_SIZE \
--exadata-infrastructure=projects/PROJECT_ID/locations/REGION/cloudExadataInfrastructures/EXADATA_INSTANCE_ID \
--async
```

Replace the following:

- <var translate="no">VAULT_ID</var>: a unique ID for your vault.
- <var translate="no">PROJECT_ID</var>: the ID of your Google Cloud project in which to create the vault.
- <var translate="no">REGION</var>: the region in which to create the vault.
- <var translate="no">VAULT_DISPLAY_NAME</var>: a name for your vault that appears in the Google Cloud console.
- <var translate="no">VAULT_SIZE</var>: the storage capacity of your vault. It can
  range from 300 GiB to 100000 GiB.

  > [!NOTE]
  > **Note:** The storage capacity for the vault must match or exceed the total storage capacity across the Exadata VM Cluster.

- For the `--exadata-infrastructure` property, replace the following:

  - <var translate="no">PROJECT_ID</var>: the ID of the Google Cloud project which contains the Exadata Infrastructure.
  - <var translate="no">REGION</var>: the region where the Exadata Infrastructure is located.
  - <var translate="no">EXADATA_INSTANCE_ID</var>: the ID of the Exadata Infrastructure.

### API

To create an Exascale Storage Vault, run the following `curl` command:

```
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
"https://oracledatabase.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/exascaleDbStorageVaults/VAULT_ID"
-d \
'{
  "display_name": "VAULT_DISPLAY_NAME",
  "gcp_oracle_zone": "GCP_ORACLE_ZONE",
  "name": "projects/PROJECT_ID/locations/REGION/exascaleDbStorageVaults/VAULT_NAME",
  "exadata_infrastructure": "projects/PROJECT_ID/locations/REGION/cloudExadataInfrastructures/EXADATA_INSTANCE_ID"
  "properties": {
    "exascale_db_storage_details": {
      "total_size_gbs": "VAULT_SIZE"
    }
  }
}'
```

Replace the following:

- <var translate="no">PROJECT_ID</var>: the ID of your Google Cloud project in which to create the vault.
- <var translate="no">REGION</var>: the region in which to create the vault.
- <var translate="no">VAULT_ID</var>: a unique ID for your vault.
- <var translate="no">VAULT_DISPLAY_NAME</var>: a name for your vault that appears in the Google Cloud console.
- <var translate="no">GCP_ORACLE_ZONE</var>: the GCP Oracle zone for your vault. For the list of available regions and zones, see [Supported regions and zones](https://docs.cloud.google.com/oracle/database/docs/regions-and-zones.md.txt).
- <var translate="no">VAULT_NAME</var>: a name for your vault.
- For `exadata_infrastructure` property, replace the following:

  - <var translate="no">PROJECT_ID</var>: the ID of the Google Cloud project which contains the Exadata Infrastructure.
  - <var translate="no">REGION</var>: the region where the Exadata Infrastructure is located.
  - <var translate="no">EXADATA_INSTANCE_ID</var>: the ID of the Exadata Infrastructure.
- <var translate="no">VAULT_SIZE</var>: the storage capacity of your vault. It can
  range from 300 GiB to 100000 GiB.

  > [!NOTE]
  > **Note:** The storage capacity for the vault must match or exceed the total storage capacity across the Exadata VM Cluster.

After the Exascale Storage Vault is created, you must configure it for using with
your Exadata Infrastructure. For more information, see
[Configure Exascale Storage Vault for Exadata Infrastructure](https://docs.cloud.google.com/oracle/database/docs/configure-exascale-storage.md.txt).