POST /{id}/replace

Replaces an abstract object with a real object.

Resource Name: /network_objects/{id}/replace

Permissions Required:
  • editNetworkObjects
Request URL Parameters:

Parameter

Type

Description

id
Mandatory

String

The network object ID.

replaceWith
Mandatory

NetworkObject (see NetworkObject )

Existing network object that will be replacing the abstract object.

replaceInApplicationsOptional

Array of String

Application names in which the abstract object should be replaced. If list is empty or null, all affected applications will be replaced by the abstract object.

Return:

Parameter

Type

Description

replaceInApplications

Array of Integer

Applications in which the abstract object was replaced.

changeRequestId

Integer

Change request ID, if opened.

Error Codes:

Errors: A failure status with the reasons.

  • 404 (Not found) – Network object wasn't found
  • 403 (Forbidden) - User doesn't have permission to edit network object
  • 403 (Forbidden) – User doesn't have permission to edit applications.
  • 400 (Bad request) – replaceWith object is not valid.

Request example:

POST <localhost>/BusinessFlow/rest/v1/network_objects/15/replace{   "replaceWith": {    "name": "netobe1",    "device": "x_123fv_spo"  },   "replaceInApplications": [    "app1",    "app2"  ]}

Return Example:

{ "replacedInApplications": [ 44, 69 ], "changeRequestId": 411 }

 

â See also: