
Cisco Evolved Programmable Network Manager API
Evolved Programmable Network Manager API Documentation

# PUT groups/removeInterfaces

Remove a list of interfaces from a given port group. Only User Defined and 'WAN Interfaces' port groups are supported.

Since Product Version: 3.1

- Jump To

- v1
- v2
- v3
- v4

### Resource Information

Rate Limiting? | No
Sorting? | No
Paging? | No
Filtering? | No
Group Filtering? | No
Aggregation? | No
Response Formats | xml json
User Group | NBI Write
HTTP Methods | PUT

API version v1 is deprecated

This API version has been deprecated. It will be removed in a future release of the product. Please develop new clients using the latest API version. Please modify your existing clients to use a later API version.

## Resource URL

/webacs/api/v1/op/groups/removeInterfaces

## Request Parameters

Attribute | Source | Description
--- | --- | ---
groupPath String | query | Required Full Path to the group

## Request Payload Parameters

Attribute | Description
--- | ---
groupInterface GroupInterfacesDTO[] | Required List of devices and associated interfaces
Attribute | Description
--- | ---
deviceIp String | Required IP address of the device
interfaceName String[] | Required List of Interface names associated with the device

## Sample Payloads

Sample payloads are for information only. They are automatically generated and the values included may not be representative of actual valid data values.

### Sample XML Request Payload

https://172.20.127.108/webacs/api/v1/op/groups/removeInterfaces?groupPath=System Defined/WAN Interfaces

    <?xml version="1.0" ?>
    <groupInterfacesListDTO>
      <groupInterface>
        <groupInterface>
          <deviceIp>String value</deviceIp>
          <interfaceName>
            <interfaceName>String value</interfaceName>
            <interfaceName>Another string value</interfaceName>
          </interfaceName>
        </groupInterface>
        <groupInterface>
          <deviceIp>Another string value</deviceIp>
          <interfaceName>
            <interfaceName>String value</interfaceName>
            <interfaceName>Another string value</interfaceName>
          </interfaceName>
        </groupInterface>
      </groupInterface>
    </groupInterfacesListDTO>

### Sample JSON Request Payload

https://172.20.127.108/webacs/api/v1/op/groups/removeInterfaces.json?groupPath=System Defined/WAN Interfaces

    {
      "groupInterfacesListDTO" : {
        "groupInterface" : {
          "groupInterface" : [{
            "deviceIp" : "String value",
            "interfaceName" : {
              "interfaceName" : ["String value",
              "Another string value"]
            }
          },
          {
            "deviceIp" : "Another string value",
            "interfaceName" : {
              "interfaceName" : ["String value",
              "Another string value"]
            }
          }]
        }
      }
    }

### Resource Information

Rate Limiting? | No
Sorting? | No
Paging? | No
Filtering? | No
Group Filtering? | No
Aggregation? | No
Response Formats | xml json
User Group | NBI Write
HTTP Methods | PUT

## Resource URL

/webacs/api/v2/op/groups/removeInterfaces

Unmodified

This resource has not been modified since the previous API version.

## Request Parameters

Attribute | Source | Description
--- | --- | ---
groupPath String | query | Required Full Path to the group

## Request Payload Parameters

Attribute | Description
--- | ---
groupInterface GroupInterfacesDTO[] | Required List of devices and associated interfaces
Attribute | Description
--- | ---
deviceIp String | Required IP address of the device
interfaceName String[] | Required List of Interface names associated with the device

## Sample Payloads

Sample payloads are for information only. They are automatically generated and the values included may not be representative of actual valid data values.

### Sample XML Request Payload

https://172.20.127.108/webacs/api/v2/op/groups/removeInterfaces?groupPath=System Defined/WAN Interfaces

    <?xml version="1.0" ?>
    <groupInterfacesListDTO>
      <groupInterface>
        <groupInterface>
          <deviceIp>String value</deviceIp>
          <interfaceName>
            <interfaceName>String value</interfaceName>
            <interfaceName>Another string value</interfaceName>
          </interfaceName>
        </groupInterface>
        <groupInterface>
          <deviceIp>Another string value</deviceIp>
          <interfaceName>
            <interfaceName>String value</interfaceName>
            <interfaceName>Another string value</interfaceName>
          </interfaceName>
        </groupInterface>
      </groupInterface>
    </groupInterfacesListDTO>

### Sample JSON Request Payload

https://172.20.127.108/webacs/api/v2/op/groups/removeInterfaces.json?groupPath=System Defined/WAN Interfaces

    {
      "groupInterfacesListDTO" : {
        "groupInterface" : {
          "groupInterface" : [ {
            "deviceIp" : "String value",
            "interfaceName" : {
              "interfaceName" : [ "String value", "Another string value" ]
            }
          }, {
            "deviceIp" : "Another string value",
            "interfaceName" : {
              "interfaceName" : [ "String value", "Another string value" ]
            }
          } ]
        }
      }
    }

### Resource Information

Rate Limiting? | No
Sorting? | No
Paging? | No
Filtering? | No
Group Filtering? | No
Aggregation? | No
Response Formats | xml json
User Group | NBI Write
HTTP Methods | PUT

## Resource URL

/webacs/api/v3/op/groups/removeInterfaces

Unmodified

This resource has not been modified since the previous API version.

## Request Parameters

Attribute | Source | Description
--- | --- | ---
groupPath String | query | Required Full Path to the group

## Request Payload Parameters

Attribute | Description
--- | ---
groupInterface GroupInterfacesDTO[] | Required List of devices and associated interfaces
Attribute | Description
--- | ---
deviceIp String | Required IP address of the device
interfaceName String[] | Required List of Interface names associated with the device

## Sample Payloads

Sample payloads are for information only. They are automatically generated and the values included may not be representative of actual valid data values.

### Sample XML Request Payload

https://172.20.127.108/webacs/api/v3/op/groups/removeInterfaces?groupPath=System Defined/WAN Interfaces

    <?xml version="1.0" ?>
    <groupInterfacesListDTO>
      <groupInterface>
        <groupInterface>
          <deviceIp>String value</deviceIp>
          <interfaceName>
            <interfaceName>String value</interfaceName>
            <interfaceName>Another string value</interfaceName>
          </interfaceName>
        </groupInterface>
        <groupInterface>
          <deviceIp>Another string value</deviceIp>
          <interfaceName>
            <interfaceName>String value</interfaceName>
            <interfaceName>Another string value</interfaceName>
          </interfaceName>
        </groupInterface>
      </groupInterface>
    </groupInterfacesListDTO>

### Sample JSON Request Payload

https://172.20.127.108/webacs/api/v3/op/groups/removeInterfaces.json?groupPath=System Defined/WAN Interfaces

    {
      "groupInterfacesListDTO" : {
        "groupInterface" : {
          "groupInterface" : [ {
            "deviceIp" : "String value",
            "interfaceName" : {
              "interfaceName" : [ "String value", "Another string value" ]
            }
          }, {
            "deviceIp" : "Another string value",
            "interfaceName" : {
              "interfaceName" : [ "String value", "Another string value" ]
            }
          } ]
        }
      }
    }

### Resource Information

Rate Limiting? | No
Sorting? | No
Paging? | No
Filtering? | No
Group Filtering? | No
Aggregation? | No
Response Formats | xml json
User Group | NBI Write
HTTP Methods | PUT

## Resource URL

/webacs/api/v4/op/groups/removeInterfaces

Unmodified

This resource has not been modified since the previous API version.

## Request Parameters

Attribute | Source | Description
--- | --- | ---
groupPath String | query | Required Full Path to the group

## Request Payload Parameters

Attribute | Description
--- | ---
groupInterface GroupInterfacesDTO[] | Required List of devices and associated interfaces
Attribute | Description
--- | ---
deviceIp String | Required IP address of the device
interfaceName String[] | Required List of Interface names associated with the device

## Sample Payloads

Sample payloads are for information only. They are automatically generated and the values included may not be representative of actual valid data values.

### Sample XML Request Payload

https://172.20.127.108/webacs/api/v4/op/groups/removeInterfaces?groupPath=System Defined/WAN Interfaces

    <?xml version="1.0" ?>
    <groupInterfacesListDTO>
      <groupInterface>
        <groupInterface>
          <deviceIp>String value</deviceIp>
          <interfaceName>
            <interfaceName>String value</interfaceName>
            <interfaceName>Another string value</interfaceName>
          </interfaceName>
        </groupInterface>
        <groupInterface>
          <deviceIp>Another string value</deviceIp>
          <interfaceName>
            <interfaceName>String value</interfaceName>
            <interfaceName>Another string value</interfaceName>
          </interfaceName>
        </groupInterface>
      </groupInterface>
    </groupInterfacesListDTO>

### Sample JSON Request Payload

https://172.20.127.108/webacs/api/v4/op/groups/removeInterfaces.json?groupPath=System Defined/WAN Interfaces

    {
      "groupInterfacesListDTO" : {
        "groupInterface" : {
          "groupInterface" : [ {
            "deviceIp" : "String value",
            "interfaceName" : {
              "interfaceName" : [ "String value", "Another string value" ]
            }
          }, {
            "deviceIp" : "Another string value",
            "interfaceName" : {
              "interfaceName" : [ "String value", "Another string value" ]
            }
          } ]
        }
      }
    }