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.