Oracle Cloud Infrastructure Documentation

Create a Cross Tenancy or Cross-Region Refreshable Clone

You can create a refreshable clone in a different tenancy (destination tenancy). When you create a cross tenancy refreshable clone, the refreshable clone in the destination tenancy can be in the same region or in a different region (cross-region).

The cross tenancy cloning option is only available using the CLI or the Autonomous Database REST APIs. This option is not available using the Oracle Cloud Infrastructure Console.

These steps cover creating a Refreshable clone. See Create a Cross Tenancy or Cross-Region Clone for details on creating a cross tenancy Full clone or Metadata clone.

To create a cross tenancy refreshable clone:

  1. Perform the prerequisite steps to define the OCI Identity and Access Management policies to authorize cross tenancy cloning.

    See Prerequisites for Cross Tenancy Cloning for details.

    Note

    If the polices you specify to allow cross tenancy cloning are subsequently revoked, cross-tenancy cloning is no longer allowed. In addition, for a refreshable clone, when the policies are revoked actions on the remote tenancy that require contact with the source tenancy, such as disconnect and refresh will fail.
  2. On the tenancy where you want to create the refreshable clone, use the CLI or call the REST API.

    You run the CLI or call the REST API on the destination tenancy in the destination region where you want to create the refreshable clone. The source database resides in a different tenancy, and if specified in a different region. This creates either a cross-tenancy refreshable clone in the same region, or a cross-tenancy refreshable clone in a different region (cross-region).

    For example, with the CLI:

    oci db autonomous-database create-refreshable-clone
    --compartment-id ocid1.tenancy.oc1..aaaaaaaafcue47pqmrf4vigne_example 
    --source-id ocid1.autonomousdatabase.oc1.iad.anuwcljs4bv3yyiae2_example
    --db-name adatabasedb1
    --data-storage-size-in-tbs 1
    --compute-model ECPU
    --compute-count 2 
    --refreshable-mode MANUAL

    See create-refreshable-clone for more information.

    Use the CreateAutonomousDatabase API to create a cross tenancy refreshable clone. When you call this API, to create a refreshable clone you set the source value to CLONE_TO_REFRESHABLE and the sourceID to the OCID of the source database.

    See the following for information on the REST API: