Create a VLAN interface
Creates an association between an aggregate ethernet interface and a specific VLAN ID.
HTTP request syntax (URI)
POST <base_URI>/v8/storage/file-devices/vlan-interfaces
Parameters
| Name | Type | Required | Values | Description |
| aggregateInterface | BODY | Y | string | Object ID or name of the aggregate interface to associate the VLAN with |
| vlanId | BODY | Y | Integer | This specifies the VLAN tag that will be applies to the VLAN interface. |
Return codes
| Code | Data | Description |
| 201 | vlanInterface | VLAN interface successfully created. |
| 400 | Error Message | Missing or invalid request contents. |
| 403 | Error Message | Operation forbidden by access level. |
| 404 | Error Message | Requested resource not found. |
| 500 | Error message | Error associated with the storage system. |
Any HTTP status code other than 201 indicates that the API did not complete successfully.
Request example: Create a new VLAN associated with interface "ag1" and using the VLAN tag "44"
curl -vk -H "X-Api-Key: zrxvSDAv9x.RIP4gkmKarG3beF.or.4Tc2im7oeqYN88C9XPGHxbXC" https://172.17.11.11:8444/v8/storage/file-devices/vlan-interfaces -X POST -d '{"aggregateInterface":"ag1", "vlanId":44}'
Response example
HTTP/1.1 201 Created
{
"vlanInterface": {
"aggregateInterface": "ag1",
"name": "ag1-vlan0044",
"objectId": "6167312d766c616e303034343a3a3a303a3a3a4f49445f24232140255f56",
"vlanId": 44
},
"uri": "https://172.27.5.11:8444/v8/storage/file-devices/vlan-interfaces/6167312d766c616e303034343a3a3a303a3a3a4f49445f24232140255f56"
}