API Reference

Clone a PDB from native backup to an existing Oracle service

post
https://{server}/availability-machines//databases//clones

Creates a new PDB (Pluggable Database) in an existing Oracle multi-tenant service by cloning from a PDB-level native backup.

Key differences from service clone (/availability-machines/{id}/clones):

  • Service clone creates a NEW service with all infrastructure
  • Database clone adds a PDB to an EXISTING Oracle multi-tenant service

Supported scenarios:

  • Clone from specific backup: Provide sourceBackupId
  • Clone from point-in-time: Provide pitr (NOT SUPPORTED YET - planned for future release)

Requirements:

  • Target service must be Oracle with multi-tenant (CDB/PDB) architecture
  • Source backup must be a PDB-level native backup (not snapshot)
  • PDB name must be unique within the target CDB
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
uuid
required

ID of the source availability machine. This identifies where the PDB backup or PITR data exists.

uuid
required

ID of the source database (PDB). This identifies which PDB's native backups to clone from.

Body Params

Payload for cloning a database (PDB) from a native backup to an existing Oracle multi-tenant service. Creates a new PDB in the target CDB by restoring from either a specific backup or point-in-time recovery. The source AM and database are identified by path parameters (availability-machine-id, database-id).

uuid

ID of the PDB-level native backup to clone from. Either sourceBackupId or pitr must be provided (mutually exclusive).

string

Point-in-time for recovery (ISO 8601 format). Either sourceBackupId or pitr must be provided (mutually exclusive). NOTE: PITR is NOT SUPPORTED YET - planned for future release.

uuid
required

ID of the target Oracle multi-tenant service (CDB) where the new PDB will be created.

oraclePdbConfig
object
required

Configuration for the new PDB being created. Includes:

  • name: Name for the new PDB (must be unique in target CDB)
  • username/password: Credentials for the new PDB
  • scriptInfo: Optional post-clone script (.sql)
  • rpoPolicyConfig: Optional RPO policy for automated native backups
Headers
string
required

Authorization Token

Responses

Updated 2 days ago

Language
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 2 days ago