Skip to content

Update a ReplicationProfile.

Request

Security
ApiKeyAuth
Path
replicationProfileIdstring, non-emptyrequired

The ID of the ReplicationProfile.

Bodyapplication/jsonrequired
namestring

The ReplicationProfile name.

descriptionstring, <= 4096 characters

The ReplicationProfile description.

target_engine_idstring

The ID of the replication target engine.

target_hoststring

Hostname of the replication target engine. If none is provided and the target_engine_id is set, the hostname for the engine referenced by target_engine_id will be used.

target_portinteger, [ 0 .. 65535 ]

Target TCP port number for the Delphix Session Protocol.

replication_modestring

The ReplicationProfile mode.

Enum:"ENGINE_DATA_REPLICATION""MASKED_DATA_DISTRIBUTION""CONTINUOUS_VAULT"
schedulestring, [ 1 .. 256 ] characters

Replication schedule in the form of a quartz-formatted string.

vdb_idsArray of strings

The VDBs that are replicated by this ReplicationProfile.

dsource_idsArray of strings

The dSources that are replicated by this ReplicationProfile.

cdb_idsArray of strings

The CDBs that are replicated by this ReplicationProfile.

vcdb_idsArray of strings

The vCDBs that are replicated by this ReplicationProfile.

group_idsArray of strings

The groups that are replicated by this ReplicationProfile.

enable_tag_replicationboolean

Indicates whether tag replication from primary object to replica object is enabled or disabled for this ReplicationProfile.

replicate_entire_engineboolean

Whether to replicate the entire engine. This is mutually exclusive with the vdb_ids, dsource_ids, cdb_ids, vcdb_ids, and group_ids properties.

bandwidth_limitinteger, >= 0

Bandwidth limit (MB/s) for replication network traffic. A value of 0 means no limit.

number_of_connectionsinteger, [ 1 .. 16 ]

Total number of transport connections to use.

encryptedboolean

Encrypt replication network traffic.

automatic_replicationboolean

Indication whether the replication spec schedule is enabled or not.

use_system_socks_settingboolean

Connect to the replication target host via the system-wide SOCKS proxy.

curl -i -X PATCH \
  'https://help-api.delphix.com/_mock/data-control-tower/continuous-data/23.0.0/continuous-data-apis-dct-23.0.0/replication-profiles/{replicationProfileId}' \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "string",
    "description": "string",
    "target_engine_id": "string",
    "target_host": "string",
    "target_port": 0,
    "replication_mode": "ENGINE_DATA_REPLICATION",
    "schedule": "string",
    "vdb_ids": [
      "string"
    ],
    "dsource_ids": [
      "string"
    ],
    "cdb_ids": [
      "string"
    ],
    "vcdb_ids": [
      "string"
    ],
    "group_ids": [
      "string"
    ],
    "enable_tag_replication": true,
    "replicate_entire_engine": true,
    "bandwidth_limit": 0,
    "number_of_connections": 1,
    "encrypted": true,
    "automatic_replication": true,
    "use_system_socks_setting": true
  }'

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", "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", "percent_complete": 50, "virtualization_tasks": [ … ], "tasks": [ … ], "execution_id": "string" } }