指定したポートを削除する
認証を行うには、ユーザー認証情報、クライアントID、およびクライアントシークレットを送信してOauth2認証を行います。OAuth APIを呼び出して認証情報を検証および認証する方法については、「API認証」を参照してください。
ポートを削除するには、エンドポイントにリクエストを/fabric/v4/ports/{id}送信します。DELETEリクエストのパスのIDでポートを指定します。
| 方法 | 削除 |
| URLまたはエンドポイント | /fabric/v4/ports/{portUuid} |
| ヘッダー | Authorization |
| パスパラメータ | uuid |
| クエリーパラメータ | dryRun |
| ボディパラメータ | 該当なし |
ポートを削除せずに本番環境でこのリクエストを安全に検証するには、「本番環境でのテスト(APIドライラン)」を参照してください。
cURLリクエストのサンプル:
curl -X DELETE 'https://api.equinix.com/fabric/v4/ports/13c0f286-1190-480c-8a45-b3df00cad9cf'
-H 'Authorization: Bearer <token>'
回答例
{
"type": "XF_PORT",
"uuid": "e91484bb-4f65-4ab3-8f77-500dec2f855d",
"name": "test-AT1-Dot1q-L-Secondary-108608",
"physicalPortsType": "10GBASE_L",
"physicalPortsSpeed": 10000,
"physicalPortsCount": 1,
"location": {
"metroCode": "AM"
},
"demarcationPointIbx": "AM1",
"redundancy": {
"group": 1,
"priority": "PRIMARY"
},
"lagEnabled": true,
"encapsulation": {
"type": "DOT1Q",
"tagProtocolId": 33024
},
"package": {
"code": "STANDARD"
},
"settings": {
"sharedPortType": false
},
"project": {
"projectId": 567
},
"account": {
"accountNumber": 1000
},
"order": {
"orderNumber": "1-207799950758",
"signature": {
"signatory": "DELEGATE",
"delegate": {
"email": "testEmail1@equinix.com"
}
}
},
"notifications": [
{
"type": "TECHNICAL",
"registeredUsers": [
"jaguarsuser-port-order"
]
},
{
"type": "NOTIFICATION",
"registeredUsers": [
"jaguarsuser-port-order"
]
},
{
"type": "PEERING",
"registeredUsers": [
"jaguarsuser-port-order"
]
},
{
"type": "ESCALATION",
"registeredUsers": [
"jaguarsuser-port-order"
]
}
],
"physicalPorts": {
"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"
}
}
}
応答の詳細については、APIリファレンスを参照してください。