Replace a vCD Network Extension Appliance

In this article

    You can change parameters of a specific network extension appliance by replacing it in Veeam Service Provider Console configuration.


    To replace a company replication resource in Veeam Service Provider Console, send the PUT HTTPS request to the URL of the /tenants/{ID}/replicaResources/{ID} resource.

    HTTP Request

    PUT https://<hostname>:1281/v2/tenants/{ID}/replicaResources/{ID}

    Request Headers

    The request header must contain the authorization token.

    Request Body

    In the request body, the client must send the following properties for the replication resource that must be added to Veeam Service Provider Console:

    • id
    • name
    • ipAddress
    • defaultGateway
    • dhcpEnabled
    • subnetMask


    The server returns the following response to the client.

    Response Code

    A successfully completed operation returns response code 201 Created.

    Response Headers

    The response to this request contains the following headers. The response may also include additional standard HTTP headers.




    The length of the response body.


    The media type and syntax of the request body message: application/json; charset=utf-8

    Response Body

    In the response body, Veeam Service Provider Console returns a status and a message for an action.

    Example Replace a vCD Network Extension Appliance

    The following example replaces a vCloud Director network extension appliance with ID BackupTenantNetworkAppliance:694e3dad-087b-48e9-8186-21a0d5b152bd9ae079a2-73d8-433f-a5b2-9d7c91b91b1a.


    PUT https://localhost:1281/v2/tenants/2/replicaResources/BackupTenantNetworkAppliance:694e3dad-087b-48e9-8186-21a0d5b152bd9ae079a2-73d8-433f-a5b2-9d7c91b91b1a


    Request Header:

    Content-Type: application/json

    Authorization: Bearer <Access-Token>


    Request Body:


     "id": "BackupTenantNetworkAppliance:bd96471c-70c6-4228-99a4-e55060ed07181332c8cc-c669-41a7-8d4d-a89a11c79083",

     "name": "Gamma_NEA",

     "ipAddress": "",

     "defaultGateway": "",

     "dhcpEnabled": false,

     "subnetMask": ""



    Response Code:



    Response Body:

    "Network extension appliance has been replaced."