A device link group can include any virtual device that is provisioned and registered unless the device interfaces are already full. To learn more about device links, refer to this. To create a device link group using APIs, you must provide the following:
1) At least two provisioned virtual devices with registered licenses. You must have the deviceUuids andthe metroCodes where the devices are located.
2) You need to provide ASNs for the devices if the ASNs have not been set. If a device already has an ASN, you can check the ASN by calling Get Virtual Device.
3) Equinix billing account number. Your account must be in the Active or Pending status. You must provide an account number for every link you will create. The account number may belong to either the source or the destination metro.
4) Choose a subnet for the group. You must choose a subnet keeping in mind the number of devices you wish to add to the group. This is not a mandatory field at the time you try to create a linking group; however, you must provide this to have a functional linking group.
5) Provide throughput information for all links that are not within a metro.
If you have all the necessary information, then skip ahead to Step 3 and create a device link group. Otherwise, follow the steps:
The description of the body parameters is as follows:
Body Parameter Name
The subnet of the link group.
An array of devices you wish to link.
The unique Id of a device you wish to link.
ASN number. The request will fail if you provide a new ASN for a device that already has an ASN.
Any available device interface. Equinix will select an interface if you do not provide one.
An array of links to be created.
Account number. You may provide the account number of either the source or the destination metro.
The source metro code of the link.
The source zone code. Default: Zone1.
The destination metro code of the link.
The destination zone code. Default: Zone1.
The description of the response payload is as follows:
The unique ID of the device link group.
When a device link group is created, it transitions through various states that can be monitored using the "status" response attribute of the Get Device Link method. Your link group must be provisioned before you can begin to perform other operations like add/remove devices.