Replace Network Settings

Replace Network Settings

This request updates/replaces the network settings of the failover and test failover for the specified vApp replication.

Request
URI
PUT
https://{api_host}//vapp-replications/{replicationId}/network-settings
COPY
Path Parameters
string
replicationId
Required

Cloud vApp-level replication identifier

replicationId example 
C4VAPP-ec991bd5-af9d-446a-8599-5b693842c4a3
Query Parameters
string
site
Optional

Optional site to run the operation on. When omitted, defaults to the local site.

site example 
site1
Header Parameters
string
operationID
Optional

Operation ID for correlating logs across multiple services

Request Body
VAppReplicationNetworkSettings of type(s) application/json
Required 
{
    "failoverSettings": {
        "vAppNetworkSettings": {
            "bridgeOrgVdcNetworks": [
                {
                    "id": "3d2fe641-28a4-40b4-9b5b-1c0e00ecd92d",
                    "name": "network1"
                }
            ],
            "bulkConnectVmNics": true,
            "copySourceNetworks": true,
            "networkMappings": [
                {
                    "destinationOrgVdcNetwork": {
                        "id": "3d2fe641-28a4-40b4-9b5b-1c0e00ecd92d",
                        "name": "network1"
                    },
                    "sourceNetworkName": "ext_net_vdc_s1Org",
                    "sourceOrgVdcNetwork": {
                        "id": "3d2fe641-28a4-40b4-9b5b-1c0e00ecd92d",
                        "name": "network1"
                    }
                }
            ]
        }
    },
    "failoverTestSettings": {
        "vAppNetworkSettings": {
            "bridgeOrgVdcNetworks": [
                {
                    "id": "3d2fe641-28a4-40b4-9b5b-1c0e00ecd92d",
                    "name": "network1"
                }
            ],
            "bulkConnectVmNics": true,
            "copySourceNetworks": true,
            "networkMappings": [
                {
                    "destinationOrgVdcNetwork": {
                        "id": "3d2fe641-28a4-40b4-9b5b-1c0e00ecd92d",
                        "name": "network1"
                    },
                    "sourceNetworkName": "ext_net_vdc_s1Org",
                    "sourceOrgVdcNetwork": {
                        "id": "3d2fe641-28a4-40b4-9b5b-1c0e00ecd92d",
                        "name": "network1"
                    }
                }
            ]
        }
    }
}
VAppReplicationNetworkSettings_FailoverNetworkSettings
failoverSettings
Optional

failoverSettings

VAppReplicationNetworkSettings_FailoverNetworkSettings
failoverTestSettings
Optional

failoverTestSettings

Authentication
This operation uses the following authentication methods.
Responses
202

Accepted

Returns C4ApiTask_of_VAppReplicationNetworkSettings of type(s) application/vnd.vmware.h4-v4.5+json;charset=UTF-8 
{
    "endTime": 1499929558827,
    "error": {
        "args": [],
        "code": "Forbidden",
        "msg": "Permission denied.",
        "stacktrace": "com.vmware.h4.api.error.exceptions.PermissionDeniedException: Permission denied."
    },
    "id": "f61d60d2-698a-46dc-a266-88df27644956",
    "lastUpdated": 1499929558827,
    "progress": 100,
    "result": {
        "failoverSettings": {
            "vAppNetworkSettings": {
                "bridgeOrgVdcNetworks": [
                    {
                        "id": "3d2fe641-28a4-40b4-9b5b-1c0e00ecd92d",
                        "name": "network1"
                    }
                ],
                "bulkConnectVmNics": true,
                "copySourceNetworks": true,
                "networkMappings": [
                    {
                        "destinationOrgVdcNetwork": {
                            "id": "3d2fe641-28a4-40b4-9b5b-1c0e00ecd92d",
                            "name": "network1"
                        },
                        "sourceNetworkName": "ext_net_vdc_s1Org",
                        "sourceOrgVdcNetwork": {
                            "id": "3d2fe641-28a4-40b4-9b5b-1c0e00ecd92d",
                            "name": "network1"
                        }
                    }
                ]
            }
        },
        "failoverTestSettings": {
            "vAppNetworkSettings": {
                "bridgeOrgVdcNetworks": [
                    {
                        "id": "3d2fe641-28a4-40b4-9b5b-1c0e00ecd92d",
                        "name": "network1"
                    }
                ],
                "bulkConnectVmNics": true,
                "copySourceNetworks": true,
                "networkMappings": [
                    {
                        "destinationOrgVdcNetwork": {
                            "id": "3d2fe641-28a4-40b4-9b5b-1c0e00ecd92d",
                            "name": "network1"
                        },
                        "sourceNetworkName": "ext_net_vdc_s1Org",
                        "sourceOrgVdcNetwork": {
                            "id": "3d2fe641-28a4-40b4-9b5b-1c0e00ecd92d",
                            "name": "network1"
                        }
                    }
                ]
            }
        }
    },
    "resultType": "string",
    "site": "site2",
    "startTime": 1499929548951,
    "state": "string",
    "user": "root",
    "warnings": [],
    "workflowInfo": {}
}
integer As int64 As int64
endTime
Optional

Timestamp in msec of the completion time of the task. -1 means the task hasn't completed.

ApiError
error
Optional

error

string As uuid As uuid
id
Optional

The unique identifier of the long-running task. It is unique and can be used for monitoring.

integer As int64 As int64
lastUpdated
Optional

Timestamp in msec of the last task status update.

integer As int32 As int32
progress
Optional

Percentage-based progress of the task.

VAppReplicationNetworkSettings
result
Optional

result

string
resultType
Optional

Indicates the type of the task result. Populated only if the execution was successful.

string
site
Optional

Site on which the task runs.

integer As int64 As int64
startTime
Optional

Timestamp in msec of the creation time of the task.

Task_State
state
Optional

state

string
user
Optional

The user who started the task.

array of ResultWarning
warnings
Optional

Warnings, which occurred during the task execution.

ApiWorkflowInfo
workflowInfo
Optional

workflowInfo


401

The returned error codes include (but are not limited to): NotAuthenticated

Returns ApiError of type(s) application/vnd.vmware.h4-v4.5+json;charset=UTF-8 
{
    "args": [],
    "code": "Forbidden",
    "msg": "Permission denied.",
    "stacktrace": "com.vmware.h4.api.error.exceptions.PermissionDeniedException: Permission denied."
}
array of string
args
Optional

Positional arguments.

string
code
Optional

Specific error code.

string
msg
Optional

Detailed error message.

string
stacktrace
Optional

Exception stacktrace.


500

The returned error codes include (but are not limited to): GeneralServerFailure

Returns ApiError of type(s) application/vnd.vmware.h4-v4.5+json;charset=UTF-8 
{
    "args": [],
    "code": "Forbidden",
    "msg": "Permission denied.",
    "stacktrace": "com.vmware.h4.api.error.exceptions.PermissionDeniedException: Permission denied."
}
array of string
args
Optional

Positional arguments.

string
code
Optional

Specific error code.

string
msg
Optional

Detailed error message.

string
stacktrace
Optional

Exception stacktrace.


On This Page
Vapp Replications Operations
POST
Apply Storage Profile
PATCH
Chown
DELETE
Cleanup Failover Test
POST
Failover
POST
Failover Test
GET
Get Effective Guest Customization Settings
GET
Get Network Settings
POST
Migrate
POST
Pause
PATCH
Reconfigure
PATCH
Reconfigure Disks
PUT
Replace Guest Customization Settings
PUT
Replace Network Settings
GET
Replication
GET
Replications
POST
Resume
POST
Reverse
POST
Start
DELETE
Stop
POST
Sync