跳到主要内容

创建Cross Connect 订单

Cross Connect是同一或不同Equinix IBX数据中心内的两个客户之间的点对点电缆链路。只有拥有Cross Connect和设施内电缆订购权限的客户门户网站用户才能订购Cross Connects。

此方法将在同一或不同IBX网点的两位Equinix客户(A侧和Z侧)之间创建Cross Connects订单请求。A侧客户发起此请求,以连接到Z侧提供商。

单个请求中可以订购单个或多个数量的Cross Connects。多数量Cross Connects仅能在满足以下条件的订单请求中提交:

  • 所有Cross Connect都从相同的 A 侧IBX、机笼和帐户开始
  • 所有Cross Connect都终止于同一个 Z 侧提供商、 IBX和机笼
  • 一次请求中的Cross Connect总数不超过 10

如果您想要订购的Cross Connect不符合此标准,则需要提交单独的订购请求。

先决条件​

  1. 身份验证 - 提交您的 OAuth2 用户凭据、客户端 ID 和客户端密钥 验证。有关如何致电OAuth API以验证和验证您的凭据的说明,请参阅API验证。

A侧信息​

  1. 使用获取位置端点作为Cross Connect起点的位置信息(A侧)。确定确切的IBX,机笼ID和机柜ID。确保您所需的所有Cross Connects都属于同一个IBX和机笼。

    如果您想为此Cross Connect接线设备,您的请求中将传递机柜ID,以获取以下A侧参数:cabinetId。

    如果您已经知道 A 面的位置信息,则可以跳过此步骤。

  2. 使用获取连接服务检索首选网点的所有连接服务信息。确定所选IBX中可用的连接服务,媒体类型,连接器类型和协议类型。

    请求主体中也将传递以下A侧参数的这些值:connectionService,mediaType connectorType,protocolType。

    如果您已经知道 A 边的连接服务信息,则可以跳过此步骤。

  3. 使用获取配线架来确定A侧的首选配线架ID。请求主体中将传递以下A侧参数(patchPan 对象):id。

    您想获取有关配线架的更多信息,例如可用端口及其所有连接服务,请参阅API参考部分下的获取配线架{patchPanelId}。

    如果您已经知道配线架信息,则可以跳过此步骤。

Z侧信息​

  1. 使用获取提供商端点检索可用z端服务提供商列表并确定其账号。

  2. 使用获取位置端点Cross Connect目标的位置信息(z侧)。确定确切的IBX,机笼ID和机柜ID。确保您所需的所有Cross Connects都属于同一个IBX和机笼。

  3. 使用获取连接服务检索首选网点的所有连接服务信息。确定所选IBX中可用的连接服务,媒体类型,连接器类型和协议类型。

    请求主体中将传递以下z端参数的这些值:connectorType。

  4. 使用获取配线架来确定A侧的首选配线架ID。请求主体中将传递以下A侧参数(patchPan 对象):id。

  5. 请向您的服务提供商咨询其电路ID电缆参考编号。该值将在z侧参数的请求主体中传递circuitId。

    如果您已经知道电路 ID,则可以跳过此步骤。

订购不带授权书(LOA)的标准Cross Connects​

要订购标准Cross Connect,请向端点发送POST请求/colocations/v2/orders/crossConnects。

请在请求正文中指定 A 侧配线架 ID、完整的连接服务详细信息,以及 Z 侧连接器类型、电路 ID 和配线架 ID。

Details数组中的一个对象代表一个Cross Connect。订购多个Cross Connects时,请 在详情数组中传递多个对象。

curl -X
POST "https://api.equinix.com/colocations/v2/orders/crossConnects"
-H "content-type: application/json"
-H "authorization: Bearer <token>"
-d '{
    "details": [
    {
      "aSide": {
        "connectionService": "SINGLE_MODE_FIBER",
        "mediaType": "SINGLE_MODE_FIBER",
        "protocolType": "10_GIG_ETHERNET",
        "connectorType": "FC",
        "patchPanel": {
          "id": "CP:0104:1199890"
        }
      },
      "zSide": {
        "connectorType": "LC",
        "circuitId": "1-12312312",
        "patchPanel": {
          "id": "PP:0104:1190123"
        }
      }
    }
  ]
}'

请求正文中包含的参数特定于此示例。参数及其说明的完整列表,请参见API参考手册。

订购标准Cross Connect器,附带 LOA​

要订购标准Cross Connect,请向端点发送POST请求/colocations/v2/orders/crossConnects。

请在请求正文中指定 A 侧配线架 ID、完整的连接服务详细信息,以及 Z 侧连接器类型、电路 ID、配线架 ID 和 LOA 附件 ID。

Details数组中的一个对象代表一个Cross Connect。订购多个Cross Connects时,请 在详情数组中传递多个对象。

创建带有附件的订单之前,请使用POST附件文件端点。

cURL 请求示例:

curl -X
POST "https://api.equinix.com/colocations/v2/orders/crossConnects"
-H "content-type: application/json"
-H "authorization: Bearer <token>"
-d '{
    "details": [
    {
      "aSide": {
        "connectionService": "SINGLE_MODE_FIBER",
        "mediaType": "SINGLE_MODE_FIBER",
        "protocolType": "10_GIG_ETHERNET",
        "connectorType": "FC",
        "patchPanel": {
          "id": "CP:0104:1199890"
        }
      },
      "zSide": {
        "providerName": "Acme Corporation",
        "ibx": "AM1",
        "loaAttachmentId": "fcb2k8763-2947-456e-8d68-f280753d60ba"
      }
    }
  ]
}'

请求正文中包含的参数特定于此示例。参数及其说明的完整列表,请参见API参考手册。

标准Cross Connect的完整示例​

要订购标准Cross Connect,请向端点发送POST请求/colocations/v2/orders/crossConnects。

此示例为加急订单,涉​​及从包含多个账户的账户到新服务提供商的交叉连接,并附有授权书及其他附件。 信息和请求。

创建带有附件的订单之前,请使用POST附件文件端点。

cURL 请求示例:

curl -X
POST "https://api.equinix.com/colocations/v2/orders/crossConnects"
-H "content-type: application/json"
-H "authorization: Bearer <token>"
-d '{
    "details": [
    {
      "aSide": {
        "connectionService": "SINGLE_MODE_FIBER",
        "mediaType": "SINGLE_MODE_FIBER",
        "protocolType": "10_GIG_ETHERNET",
        "connectorType": "FC",
        "mediaConverterRequired": false,
        "ifcCircuitCount": 2,
        "patchPanel": {
          "id": "CP:0104:1199890",
          "portA": 12,
          "portB": 13
        },
        "patchEquipment": {
          "cabinetId": "SG1:01:00EQ00:0001",
          "connectorType": "FC",
          "details": "Refer to attachment for patching details.",
          "port": 10
        }
      },
      "zSide": {
        "providerName": "Acme Corporation",
        "ibx": "PE2",
        "connectorType": "LC",
        "circuitId": "1-12312312",
        "patchPanel": {
          "id": "PP:0104:1190123",
          "portA": 1,
          "portB": 2
        },
        "loaAttachmentId": "fcb2k8763-2947-456e-8d68-f280753d60ba",
        "notificationEmail": "johndoe@acme.com"
      },
      "verifyLink": true,
      "circuitDeliveryDate": "2020-10-09T10:00:22.395Z",
      "submarineEngineerRequired": true
    }
  ],
  "expediteDateTime": "2020-10-10T06:30:22.395Z",
  "customerReferenceId": "EQX_CC_20201010",
  "description": "Please refer to attachment for full details for this cross connects order.",
  "attachments": [
    {
      "id": "85d9660a-f877-405a-b38e-8e61a4f77f44",
      "name": "OrderInstructions.docx"
    }
  ],
  "purchaseOrder": {
    "type": "NEW",
    "number": "EQXPO_Ref9654284",
    "amount": 10000,
    "startDate": "2020-10-01",
    "endDate": "2021-09-30",
    "attachmentId": "56d10de6-f2c0-4edd-ba29-b70736aa2093"
  },
  "contacts": [
    {
      "type": "NOTIFICATION",
      "registeredUsers": [
        "john_doe",
        "john_doe1"
      ]
    },
    {
      "type": "TECHNICAL",
      "firstName": "Jane",
      "lastName": "Doe",
      "availability": "WORK_HOURS",
      "timezone": "America/New_York",
      "details": [
        {
          "type": "EMAIL",
          "value": "janedoe@acme.com"
        },
        {
          "type": "PHONE",
          "value": "+1-987654321"
        },
        {
          "type": "MOBILE",
          "value": "+1-912345678"
        }
      ]
    }
  ]
}'

参数及其说明的完整列表,请参见API参考手册。

这个页面对您有帮助吗?