We've Moved! Product Documentation has moved to docs.hitachivantara.com

Create an aggregate interface

Last updated
Save as PDF

Creates the binding of one or more physical interfaces to form an aggregate network interface. All physical interfaces must be of the same speed.

HTTP request syntax (URI)

POST <base_URI>/v8/storage/file-devices/aggregate-interfaces

Parameters

Name	Type	Required	Values	Description
name	BODY	Y	string	Name of the new aggregate – it must be of the form agX, where X can be any number between 1 and 9.
interfaces	BODY	N	array	List of physical interfaces that should be used by the aggregate interface
lacpEnabled	BODY	N	boolean	Specifies whether to use 802.3ad link management protocol (LACP). The default value is False.
loadBalance	BODY	N	string	Load balancing option. Possible values are: ROUND_ROBIN NORMAL The default value is NORMAL.

Return codes

Code	Data	Description
201	aggregateInterface	Aggregate 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 aggregate “ag2”, with a single network interface “ge2”

curl -vk -H "X-Api-Key: zrxvSDAv9x.RIP4gkmKarG3beF.or.4Tc2im7oeqYN88C9XPGHxbXC" https://172.17.11.11:8444/v8/storage/file-devices/aggregate-interfaces -X POST -d '{"name":"ag2", "interfaces":["ge2"]}'

Response example

HTTP/1.1 201 Created
{
  "aggregateInterface": {
    "interfaces": [
      {
        "port": "ge2",
        "status": "Down"
      }
    ],
    "lacpEnabled": false,
    "loadBalance": "NORMAL",
    "name": "ag2",
    "objectId": "6167323a3a3a303a3a3a4f49445f24232140255f56"
  },
  "uri": "https://172.27.5.11:8444/v8/storage/file-devices/aggregate-interfaces/6167323a3a3a303a3a3a4f49445f24232140255f56"
}

Quick Links