Deleting a Specified Port

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 delete a port send a DELETE request to the /fabric/v4/ports/{id} endpoint. Specify the port by ID in the path of the request.

Method	DELETE
URL or Endpoint	/fabric/v4/ports/{portUuid}
Headers	Authorization
Path Parameters	uuid
Query Parameters	Not applicable
Body Parameters	Not applicable

Sample cURL request:

curl -X DELETE 'https://api.equinix.com/fabric/v4/ports/13c0f286-1190-480c-8a45-b3df00cad9cf'  
-H 'Authorization: Bearer <token>'

Sample response:

{  
"href": "https://api.equinix.com/fabric/v4/ports/e91484bb-4f65-4ab3-8f77-500dec2f855d",  
"type": "XF_PORT",  
"uuid": "e91484bb-4f65-4ab3-8f77-500dec2f855d",  
"name": "test-AT1-Dot1q-L-Secondary-108608",  
"state": "DEPROVISIONING",  
"bandwidth": 10000,  
"usedBandwidth": 0,  
"availableBandwidth": 20000,  
"redundancy": {  
    "group": "C91484bb-4f65-4ab3-8f77-500dec2f855C",  
    "priority": "PRIMARY"  
},  
"location": {  
    "metroHref": "https://api.equinix.com/fabric/v4/metros/AT",  
    "ibx": "AT1",  
    "metroCode": "AT",  
    "metroName": "Atlanta",  
    "region": "AMER"  
},  
"device": {  
    "name": "dev-m7a2.lab",  
    "redundancy": {  
    "group": "C91484bb-4f65-4ab3-8f77-500dec2f855C",  
    "priority": "PRIMARY"  
    }  
},  
"encapsulation": {  
    "type": "DOT1Q",  
    "tagProtocolId": 33024  
},  
"lagEnabled": true,  
"lag": {  
    "enabled": true  
},  
"settings": {  
    "buyout": false,  
    "placeVcOrderPermission": true,  
    "viewPortPermission": true  
},  
"physicalPorts": [  
    {  
    "state": "DEPROVISIONING",  
    "type": "XF_PHYSICAL_PORT",  
    "bandwidth": 10000,  
    "tether": {  
        "crossConnectId": "100179-A",  
        "patchPanel": "PP:8118:1586",  
        "patchPanelPortA": "92",  
        "patchPanelPortB": "24"  
    },  
    "demarcationPoint": {  
        "ibx": "AT1",  
        "patchPanel": "PP:8118:1586",  
        "patchPanelName": "PP:8118:1586",  
        "patchPanelPortA": "92",  
        "patchPanelPortB": "24"  
    }  
    }  
],  
"account": {  
    "accountNumber": 100179,  
    "accountName": "L2 account",  
    "globalCustId": "007700000090982RG8",  
    "orgId": 100179,  
    "organizationName": "Cust_Org_100179"  
},  
"changeLog": {  
    "createdDateTime": "2018-06-14T17:21:25.587Z"  
}  
}

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