Skip to content
/
Upgrade VDB

Upgrade VDB

Request

Security
ApiKeyAuth
Path
vdbIdstring, non-emptyrequired

The ID of the VDB.

Bodyapplication/json

The new API to upgrade VDB

repository_idstringrequired

The id of the dSource/VDB repository to upgrade to.

Example:"1-ORACLE_INSTALL-4"
environment_user_idstring

Reference of the environment user to use for dSource/VDB upgrade.

Example:"HOST_USER-4"
ppt_repositorystring

The id of the SQL instance on the PPT environment that we want to use for pre-provisioning (MSSQL only).

Example:"1-MSSQL_INSTANCE-11"
curl -i -X POST \
  'https://help-api.delphix.com/_mock/data-control-tower/continuous-data/2026.5.0.0/continuous-data-apis-dct-2026.5.0.0/vdbs/{vdbId}/upgrade' \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "repository_id": "1-ORACLE_INSTALL-4",
    "environment_user_id": "HOST_USER-4",
    "ppt_repository": "1-MSSQL_INSTANCE-11"
  }'

Responses

OK

Bodyapplication/json
jobobject(Job)

An asynchronous task.

Response
{
  "job": {
    "id": "job-123",
    "status": "RUNNING",
    "is_waiting_for_telemetry": true,
    "type": "DB_REFRESH",
    "localized_type": "DB Refresh",
    "error_details": "Unable to connect to the engine.",
    "warning_message": "Failed to remove local MaskingJob, engineId: 3 localMaskingJobId: 7.",
    "target_id": "vdb-123",
    "target_name": "vdb",
    "work_source_id": "string",
    "work_source_name": "string",
    "work_source_type": "DIRECT",
    "start_time": "2022-01-02T05:11:24.148Z",
    "update_time": "2022-01-02T06:11:24.148Z",
    "trace_id": "string",
    "engine_ids": [ … ],
    "tags": [ … ],
    "engines": [ … ],
    "account_id": 1,
    "account_name": "User 1",
    "compliance_node_id": "string",
    "compliance_node_name": "string",
    "percent_complete": 50,
    "virtualization_tasks": [ … ],
    "tasks": [ … ],
    "execution_id": "string",
    "result_type": "string",
    "result": {},
    "parent_job_id": "string"
  }
}