How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Delphix VDBs API

The VDBs API from Delphix — 54 operation(s) for vdbs.

Delphix VDBs API is one of 60 APIs that Delphix publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include VDBs. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 57 operations across 54 paths, and defines 104 schemas. It is described by OpenAPI 3.0.0, at version 3.28.0.

Requests are made against a single base URL, /dct/v3.

57 operations 54 paths 104 schemas 8 GET1 PATCH48 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.0
API Version
3.28.0
Base URL
https://help-api.delphix.com/dct/v3
Authentication
API Key
Resource Areas
1

Authentication & Security 1

Delphix VDBs API declares 1 security scheme for authenticating requests. An API key is passed in the header as Authorization (ApiKeyAuth). By default, every request must be authenticated.

Paths & Operations 57

Across 54 paths, the API surfaces 57 operations — 8 GET, 1 PATCH, 48 POST. Each is listed below with its method, path, parameters, and response codes.

VDBs 57
GET
/vdbs
List all vdbs.
get_vdbs 4 params → 200
POST
/vdbs/empty-recycle-bin
Empty VDB recycle bin.
empty_recycle_bin → 200
POST
/vdbs/search
Search for VDBs.
search_vdbs 4 params body → 200
GET
/vdbs/{vdbId}
Get a VDB by ID.
get_vdb_by_id 1 param → 200
PATCH
/vdbs/{vdbId}
Update values of a VDB
update_vdb_by_id 1 param body → 200
GET
/vdbs/{vdbId}/snapshots
List Snapshots for a VDB.
get_vdb_snapshots 3 params → 200
POST
/vdbs/{vdbId}/snapshots
Snapshot a VDB.
snapshot_vdb 1 param → 200
GET
/vdbs/{vdbId}/bookmarks
List Bookmarks compatible with this VDB.
get_bookmarks_by_vdb 4 params → 200
POST
/vdbs/{vdbId}/bookmarks/search
Search Bookmarks compatible with this VDB.
search_bookmarks_by_vdb 4 params body → 200
GET
/vdbs/{vdbId}/deletion-dependencies
Get deletion dependencies of a VDB.
get_vdb_deletion_dependencies 1 param → 200
POST
/vdbs/{vdbId}/tags
Create tags for a VDB.
create_vdb_tags 1 param body → 201
GET
/vdbs/{vdbId}/tags
Get tags for a VDB.
get_tags_vdb 1 param → 200
POST
/vdbs/{vdbId}/tags/delete
Delete tags for a VDB.
delete_vdb_tags 1 param body → 204
POST
/vdbs/{vdbId}/start
Start a VDB.
start_vdb 1 param body → 200
POST
/vdbs/{vdbId}/stop
Stop a VDB.
stop_vdb 1 param body → 200
POST
/vdbs/{vdbId}/enable
Enable a VDB.
enable_vdb 1 param body → 200
POST
/vdbs/{vdbId}/disable
Disable a VDB.
disable_vdb 1 param body → 200
POST
/vdbs/{vdbId}/migrate
Migrate a VDB.
migrate_vdb 1 param body → 200
GET
/vdbs/{vdbId}/migrate_compatible_repositories
Returns a list of compatible repositories for vdb migration.
get_migrate_compatible_repo 1 param → 200
POST
/vdbs/{vdbId}/restore-from-recycle-bin
Restore a VDB from recycle bin.
restore_vdb_from_recycle_bin 1 param → 200
POST
/vdbs/{vdbId}/lock
Lock a VDB.
lock_vdb 1 param body → 200
POST
/vdbs/{vdbId}/unlock
Unlock a VDB.
unlock_vdb 1 param → 200
POST
/vdbs/{vdbId}/delete
Delete a VDB.
delete_vdb 1 param body → 200
POST
/vdbs/{vdbId}/rollback_by_timestampdeprecated
Rollback a VDB by timestamp.
rollback_vdb_by_timestamp 1 param body → 200
POST
/vdbs/{vdbId}/rollback_by_snapshotdeprecated
Rollback a VDB by snapshot.
rollback_vdb_by_snapshot 1 param body → 200
POST
/vdbs/{vdbId}/rollback_from_bookmarkdeprecated
Rollback a VDB from a bookmark with only the same VDB.
rollback_vdb_from_bookmark 1 param body → 200
POST
/vdbs/{vdbId}/refresh_by_timestamp
Refresh a VDB by timestamp.
refresh_vdb_by_timestamp 1 param body → 200
POST
/vdbs/{vdbId}/refresh_by_snapshot
Refresh a VDB by snapshot.
refresh_vdb_by_snapshot 1 param body → 200
POST
/vdbs/{vdbId}/refresh_from_bookmark
Refresh a VDB from bookmark with a single VDB.
refresh_vdb_from_bookmark 1 param body → 200
POST
/vdbs/{vdbId}/refresh_by_location
Refresh a VDB by location.
refresh_vdb_by_location 1 param body → 200
POST
/vdbs/{vdbId}/undo_refresh
Undo the last refresh operation.
undo_refresh 1 param → 200
POST
/vdbs/{vdbId}/export_cleanup
Export cleanup for incremental V2P operation
export_cleanup 1 param body → 202
POST
/vdbs/{vdbId}/switch_timeflow
Switches the current timeflow of a VDB.
switch_timeflow 1 param body → 200
POST
/vdbs/oracle/{vdbId}/upgradedeprecated
Upgrade Oracle VDB
upgrade_oracle_vdb 1 param body → 200
POST
/vdbs/{vdbId}/upgrade
Upgrade VDB
upgrade_vdb 1 param body → 200
GET
/vdbs/{vdbId}/upgrade_compatible_repositories
Returns a list of compatible repositories for vdb upgrade.
get_upgrade_compatible_repo_for_vdb 1 param → 200
POST
/vdbs/{vdbId}/jdbc-check
Verify JDBC connection string for VDB.
verify_vdb_jdbc_connection_string 1 param body → 200
POST
/vdbs/provision_by_timestamp
Provision a new VDB by timestamp.
provision_vdb_by_timestamp body → 200
POST
/vdbs/provision_by_timestamp/defaults
Get default provision parameters for provisioning a new VDB by timestamp.
provision_vdb_by_timestamp_defaults body → 200
POST
/vdbs/provision_by_location
Provision a new VDB by location.
provision_vdb_by_location body → 200
POST
/vdbs/provision_by_location/defaults
Get default provision parameters for provisioning a new VDB by location.
provision_vdb_by_location_defaults body → 200
POST
/vdbs/provision_by_snapshot
Provision a new VDB by snapshot.
provision_vdb_by_snapshot body → 200
POST
/vdbs/provision_by_snapshot/defaults
Get default provision parameters for provisioning a new VDB by snapshot.
provision_vdb_by_snapshot_defaults body → 200
POST
/vdbs/provision_from_bookmark
Provision a new VDB from a bookmark with a single VDB.
provision_vdb_from_bookmark body → 200
POST
/vdbs/provision_from_bookmark/defaults
Get default provision parameters for provisioning a new VDB from a bookmark.
provision_vdb_from_bookmark_defaults body → 200
POST
/vdbs/empty_vdb
Provision an empty VDB.
empty_vdb body → 200
POST
/vdbs/{vdbId}/asm-in-place-export
Convert a virtual database to a physical database on Oracle ASM file system.
oracle_asm_in_place_vdb_export 1 param body → 200
POST
/vdbs/{vdbId}/in-place-export
Convert a virtual database to a physical database on physical file system.
export_vdb_in_place 1 param body → 200
POST
/vdbs/{vdbId}/asm-export-by-snapshot
Export a vdb using snapshot to an ASM file system
export_vdb_to_asm_by_snapshot 1 param body → 200
POST
/vdbs/{vdbId}/asm-export-by-location
Export a vdb using SCN to an ASM file system
export_vdb_to_asm_by_location 1 param body → 200
POST
/vdbs/{vdbId}/asm-export-by-timestamp
Export a vdb using timestamp to an ASM file system
export_vdb_to_asm_by_timestamp 1 param body → 200
POST
/vdbs/{vdbId}/export-from-bookmark
Export a vdb using bookmark to physical file system
export_vdb_from_bookmark 1 param body → 200
POST
/vdbs/{vdbId}/asm-export-from-bookmark
Export a vdb using bookmark to an ASM file system
export_vdb_to_asm_by_bookmark 1 param body → 200
POST
/vdbs/{vdbId}/export-by-timestamp
Export a vdb using timestamp to a physical file system
export_vdb_by_timestamp 1 param body → 200
POST
/vdbs/{vdbId}/export-by-snapshot
Export a vdb using snapshot to a physical file system
export_vdb_by_snapshot 1 param body → 200
POST
/vdbs/{vdbId}/export-by-location
Export a vdb using timeflow location to a physical file system
export_vdb_by_location 1 param body → 200
POST
/vdbs/{vdbId}/export_finalize
Finalize operation on incremental V2P export
export_finalize 1 param body → 202

Schemas 104

The contract defines 104 schemas that model the data the API accepts and returns. The most detailed are VDB (95 properties), UpdateVDBParameters (39 properties), Host (37 properties), Snapshot (36 properties). Each schema is shown below with its type and property counts.

DeletionDependenciesResponse
object
The deletion dependencies of a dataset.
1 property
ProvisionVDBBySnapshotDefaultsRequest
object
3 properties
RollbackVDBBySnapshotParameters
BookmarkVDBs
object
VDB id and name associated with bookmark.
7 properties
SwitchTimeflowParameters
object
Parameters to switch the timeflow of a VDB.
1 property
PaginatedResponseMetadata
object
3 properties
VirtualDatasetHooks
object
VDB operation hooks.
13 properties
OracleRACDatabaseInstance
object
4 properties 3 required
OracleCustomEnvVar
object
4 properties
StopVDBParameters
object
Parameters to stop a VDB.
2 properties
OracleService
object
2 properties
OracleRacCustomEnvFile
object
2 properties
OracleAsmExportByTimestampParameters
AdditionalMountPoint
object
Specifies an additional location on which to mount a subdirectory of an AppData container.
3 properties
VirtualizationTask
object
8 properties
OracleRacCustomEnvVar
object
3 properties
UpgradeDatabaseParameters
object
Parameters to upgrade a dSource/VDB.
3 properties 1 required
OracleAsmInPlaceExportParameters
ProvisionVDBByLocationParameters
DataPointByLocationParameters
object
2 properties
CredentialsEnvVariable
object
15 properties 1 required
RollbackVDBFromBookmarkParameters
Tag
object
2 properties 2 required
StartVDBParameters
object
Parameters to start a VDB.
1 property
VirtualizationTaskEvent
object
1 property
DataPointByTimestampParameters
object
3 properties
Environment
object
A grouping of a single host or a cluster of hosts.
30 properties
Engine
object
2 properties
MigrateVDBParameters
object
Parameters to migrate a VDB.
6 properties
TagsRequest
object
1 property 1 required
ConnectivityCheckResponse
object
The result of the connectivity check.
2 properties 1 required
BookmarkPaaSInstances
object
PaaS Instance id and name associated with bookmark.
5 properties
ProvisionVDBFromBookmarkDefaultsRequest
object
1 property 1 required
ProvisionVDBByTimestampDefaultsRequest
object
5 properties 1 required
Replica
object
4 properties
ListSnapshotsResponse
object
2 properties
BaseExportTransferStrategyParameters
object
2 properties
OracleAsmExportBySnapshotParameters
UpgradeOracleDatabaseParameters
object
Parameters to upgrade an Oracle dataset.
2 properties 2 required
Hook
object
7 properties
ProvisionVDBResponse
object
2 properties
ProvisionVDBByTimestampParameters
EngineStorageCapacityDependencyData
Engine storage capacity dependency data.
OracleAsmExportFromBookmarkParameters
Host
object
A physical/virtual server.
37 properties
BookmarkPaaSDatabases
object
PaaS Database id and name associated with bookmark.
5 properties
EnvironmentUser
object
14 properties
RefreshVDBByTimestampParameters
EngineStorageDatasetType
string
Type of the dataset.
ExportByLocationParameters
ExportBySnapshotParameters
MSSQLClusterListener
object
4 properties
DeleteVDBParameters
object
Parameters to delete a VDB.
3 properties
ProvisionVDBBySnapshotParameters
FilesystemLayoutParameters
object
8 properties
DeleteTag
object
3 properties
OracleActiveInstance
object
3 properties
EnableVDBParameters
object
Parameters to enable a VDB.
3 properties
JobTask
object
8 properties
OracleListener
object
7 properties
Error
object
2 properties
OracleAsmExportByLocationParameters
ExportByTimestampParameters
RefreshVDBFromBookmarkParameters
ExportDBTimeflowPointParameters
object
31 properties
RefreshVDBBySnapshotParameters
DisableVDBParameters
object
Parameters to disable a VDB.
2 properties
EngineStorageCapacityData
object
19 properties
OracleTdeKeystoreConfigTypeEnum
string
Oracle TDE keystore configuration type.
ClusterNodeInstance
object
4 properties 3 required
BookmarkDSources
object
dSource id and name associated with bookmark.
5 properties
BaseProvisionVDBParameters
TagsResponse
object
1 property
OracleClusterNodeInstance
object
An oracle cluster node instance.
3 properties
ExportCleanupParameters
object
Parameters to cleanup VDB created as part of the Incremental V2P
2 properties
ProvisionVDBFromBookmarkParameters
NfsVersionReasonEnum
string
The reason why the source is being mounted with nfsVersion.
UpdateVDBParameters
object
Parameters to update a VDB.
39 properties
ProvisionEmptyVDBParameters
2 required
RollbackVDBByTimestampParameters
MSSQLListenerTypeEnum
string
DataPointBySnapshotParameters
object
1 property
OracleListenerTypeEnum
string
OracleAsmLayoutParameters
object
2 properties 1 required
RefreshVDBByLocationParameters
object
Parameters to refresh by a database-specific identifier (SCN, LSN, etc).
3 properties
OracleVirtualIP
object
A virtual IP address.
3 properties
JobTaskEvent
object
1 property
ProvisionVDBByLocationDefaultsRequest
object
4 properties
DataPointFromBookmarkParameters
object
1 property 1 required
Errors
array
Sadly, sometimes requests to the API are not successful. Failures can occur for a wide range of reasons. The Errors object contains information about full or p…
SearchBody
object
Search body.
1 property
ContainerizationStateEnum
string
Indicates the virtual database's containerization state, created for or running inside a containerized environment like Linux containers.
VDB
object
A Delphix virtual database or dataset.
95 properties
Repository
object
35 properties
ConfigSettingsStg
object
Custom Database-Level config settings.
3 properties
Bookmark
object
A Data Control Tower object that references points in time for one or more datasets.
33 properties
ExportFinalizeParameters
object
Parameters to finalize export (V2P) from the VDB created as part of the Incremental V2P
2 properties
OracleVerifyJdbcConnectionStringParams
object
3 properties 3 required
Snapshot
object
Virtualization Engine Snapshot of a dSource or VDB.
36 properties
MssqlAgReplica
object
A replica MSSQL source that constitutes an MSSQL AG virtual source.
11 properties
InPlaceExportParameters
ExportFromBookmarkParameters
Job
object
An asynchronous task.
25 properties
PermissionEnum
string
Type of the permission on DCT object.

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

delphix-vdbs-api-openapi.yml Raw ↑

Other APIs Delphix publishes across the network.

Delphix Algorithms API
Delphix Bookmarks API
Delphix CDB DSources API
Delphix CDBs API
Delphix Classifiers API
Delphix CloudAccounts API
Delphix ComplianceJobCollections API
Delphix ComplianceJobs API
Delphix ComplianceNodes API
Delphix Connectivity API
Delphix Connectors API
Delphix DatabaseTemplates API
Where this information came from

This is an independent, third-party profile of Delphix VDBs API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.