创建端口

先决条件

身份验证 - 提交您的 OAuth2 用户凭据、客户端 ID 和客户端密钥 身份验证。请参阅API身份验证以获取有关如何调用OAuth API来验证和认证您的凭据的说明。

创建一个端口

要创建端口，请向 /fabric/v4/ports 端点发送 POST 请求。

Method	POST
URL or Endpoint	/fabric/v4/ports
Headers	Authorization, Content-Type
Path Parameters	Not applicable
Query Parameters	dryRun
Body Parameters	type, id, uuid, name, description, physicalPortsSpeed, connectionsCount, physicalPortsType, physicalPortsCount, connectivitySourceType, bmmrType, project, state, order, cvpId, operation, account, change, changeLog, availableBandwidth, usedBandwidth, location, device, interface, demarcationPointIbx, tetherIbx, demarcationPoint, redundancy, encapsulation, lagEnabled, lag, asn, package, settings, physicalPortQuantity, notifications, additionalInfo, endCustomer, physicalPorts, loas

要在生产环境中安全地验证此请求，而无需创建或更改资源，请参阅生产环境测试（API 试运行）。

示例 cURL 请求 - 主机托管、非 LAG 端口：

curl -X POST 'https://api.equinix.com/fabric/v4/ports'  
-H 'Content-Type: application/json'  
-H 'Authorization: Bearer <token>'  
-d '{
  "type": "XF_PORT",
  "physicalPortsSpeed": 1000,
  "physicalPortsType": "1000BASE_LX",
  "connectivitySourceType": "COLO",
  "location": {
    "metroCode": "GV"
  },
  "demarcationPointIbx": "GV1",
  "package": {
    "code": "STANDARD"
  },
  "lagEnabled": false,
  "encapsulation": {
    "type": "DOT1Q",
    "tagProtocolId": 33024
  },
  "project": {
    "projectId": "8f23b36f-db8f-44c8-a6e5-606e1b485931"
  },
  "account": {
    "accountNumber": 270848
  },
  "notifications": [
    {
      "registeredUsers": [
        "jaguarsuser-port-order"
      ],
      "type": "TECHNICAL"
    }
  ],
  "order": {
    "purchaseOrder": {
      "number": 156576,
      "amount": 10,
      "startDate": "2018-06-11T22:25:52.206Z",
      "endDate": "2018-07-11T22:25:52.206Z",
      "type": "NEW"
    },
    "signature": {
      "signatory": "DELEGATE",
      "delegate": {
        "firstName": "John",
        "lastName": "Doe",
        "email": "john.doe@company.com"
      }
    }
  },
  "physicalPorts": [
    {
      "demarcationPoint": {
        "ibx": "GV1",
        "cabinetUniqueSpaceId": "Demarc",
        "cageUniqueSpaceId": "GV1:01:002174",
        "patchPanel": "CP:Demarc:1259684",
        "connectorType": "SC"
      }
    }
  ]
}'

示例响应：

{
  "type": "XF_PORT",
  "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"
      ]
    }
  ]
}

有关响应的详细说明或更多示例，请参阅API 参考。