Skip to main content

Adding Ports to a LAG

To authenticate submit your user credentials, Client ID, and Client Secret for OAuth2 authentication. Refer to API Authentication for instructions on how to call OAuth API to validate and authenticate your credentials.

To add physical ports to a virtual port, send a POST request to the /fabric/v4/ports/{uuid}/physicalPorts/bulk endpoint.

MethodPOST
URL or Endpoint/fabric/v4/ports/{uuid}/physicalPorts/bulk
HeadersAuthorization, Content-Type
Path Parametersuuid
Query ParametersNot applicable
Body Parameterstype, demarcationPoint, account, order

Sample cURL Request:

curl -X POST 'https://api.equinix.com/fabric/v4/ports/c64de7e5-7fe7-41e6-b984-80d5aa159a0d/physicalPorts/bulk'  
-H 'Content-Type: application/json'
-H 'Authorization: Bearer <token>'
-d '{
    "data": [
    {
        "type": "XF_PHYSICAL_PORT",
        "demarcationPoint": {
        "ibx": "AM1",
        "cabinetUniqueSpaceId": "AM1:02:032575:0105",
        "cageUniqueSpaceId": "AM1:02:032575",
        "patchPanel": "PP:0105:1260379",
        "patchPanelPortA": 14,
        "patchPanelPortB": 15,
        "connectorType": "LC"
        },
        "account": {
        "accountNumber": 17829
        },
        "order": {
        "purchaseOrder": {
            "number": 156576,
            "amount": 10,
            "startDate": "2018-06-11",
            "endDate": "2018-07-11",
            "selectionType": "NEW"
        },
        "signature": {
            "signatory": "DELEGATE",
            "delegate": {
            "firstName": "John",
            "lastName": "Doe",
            "email": "john.doe@company.com"
            }
        }
    },
    {
        "type": "XF_PHYSICAL_PORT",
        "account": {
        "accountNumber": 17829
        },
        "demarcationPoint": {
        "ibx": "AM1",
        "cabinetUniqueSpaceId": "AM1:02:032575:0105",
        "cageUniqueSpaceId": "AM1:02:032575",
        "patchPanel": "PP:0105:1260379",
        "patchPanelPortA": 16,
        "patchPanelPortB": 17,
        "connectorType": "LC"
        },
        "order": {
        "purchaseOrder": {
            "number": 156576,
            "amount": 10,
            "startDate": "2018-06-11",
            "endDate": "2018-07-11",
            "selectionType": "NEW"
        },
        "signature": {
            "signatory": "DELEGATE",
            "delegate": {
            "firstName": "John",
            "lastName": "Doe",
            "email": "john.doe@company.com"
            }
        }
        }
    }
    ]
}'

Sample Response:

{  
    "data": [
    {
        "type": "XF_PHYSICAL_PORT",
        "demarcationPoint": {
        "cabinetUniqueSpaceId": "Demarc",
        "cageUniqueSpaceId": "GV1:01:002174",
        "patchPanel": "CP:Demarc:1259684",
        "patchPanelPortA": "39",
        "patchPanelPortB": "40",
        "connectorType": "SC",
        "ibx": "GV1"
        },
        "order": {
        "orderNumber": "1-210210611904"
        }
    },
    {
        "type": "XF_PHYSICAL_PORT",
        "demarcationPoint": {
        "cabinetUniqueSpaceId": "Demarc",
        "cageUniqueSpaceId": "GV1:01:002174",
        "patchPanel": "CP:Demarc:1259684",
        "patchPanelPortA": "41",
        "patchPanelPortB": "42",
        "connectorType": "SC",
        "ibx": "GV1"
        },
        "order": {
        "orderNumber": "1-210210611904"
        }
    }
    ]
}

For a detailed description of the response, see the API Reference.