跳转到主要内容

创建设备

先决条件​

身份验证-提交您的用户凭据，客户端ID和客户端机密以进行OAuth2身份验证。有关如何调用OAuth API以验证和验证凭据的说明，请参阅API身份验证。

第 2 步：获取设备详细信息​

  • 呼叫"获取设备类型"以了解您要在NE平台上启动的自配置设备(例如路由器或防火墙)。您将了解虚拟设备可用的城域地区，设备供应商，可用内核数量以及软件包及其版本。选择deviceTypeCode，metroCode，core，packageCode和version。

  • 调用"获取允许的接口"以找出所选Core允许的接口数量。您可以选择任何可用的设备接口作为sshInterfaceId。否则，Equinix 将选择第一个可用的接口。

  • 拨打"获取帐户{metro}"，查看您的帐号(或accountReferenceId)以及您需要使用虚拟设备的metro中的状态。出于计费原因，您必须在Metro中拥有一个帐户，您需要虚拟设备处于活动或待定状态。如果您没有帐户，请创建帐户。

如果您是尝试为客户创建设备的经销商，则必须确保客户和您(经销商)的帐户均处于"活动"或"待定"状态。您的帐户将收到账单，但是，您必须将客户的账号发送至API，以便为客户创建设备。

步骤 3：许可选项​

我们为大多数设备提供BYOL (自带许可)作为许可选项。上传许可证文件或代码/令牌/ID，具体取决于供应商提供的产品。对于Cisco 8000V，您可以使用订购许可选项。

  • Arista：我们不支持为 Arista 设备上传许可证。不过，您可以在设备创建后登录设备并上传许可证，以提高吞吐量。

  • Cisco 和 Palo Alto 提供许可证令牌。请在 licenseToken 字段中输入许可证令牌。

  • Juniper 提供许可证文件。要为 Juniper 设备自带许可证 (BYOL)，请使用 上传许可证文件 上传许可证文件。您将获得一个文件 ID，可用于创建虚拟设备。如果您有冗余的 Juniper 设备，则可以为主设备和备用设备使用相同的文件 ID。

  • Fortinet：创建 Fortinet 设备时，许可证并非强制性要求。如果您有令牌，请将其输入到 licenseToken 字段中。要为 Fortinet 设备配置许可证文件，您必须执行以下操作：

    • 在 Fortinet 门户上生成许可证文件。
    • 通过调用 Post License File 函数，在 Equinix 门户上传许可证文件。您将获得一个 fileId，可用于创建虚拟设备。
    • 登录设备检查您的许可证状态。

步骤 4：创建自配置设备​

POST /ne/v1/devices
方法POST
URL 或端点/ne/v1/devices
标头Authorization令牌，Content-Type
查询参数draft,draftUuid

要创建具有主设备和辅助设备的冗余设备：

  • 设置次要对象的参数
  • 如果您是尝试为客户创建冗余设备的经销商，请确保主要和辅助城域网位于同一个国家/地区。主要帐号和辅助帐号必须相同。尽管经销商的帐户将会收到账单，但此API接受客户的帐号，以便为客户创建设备。上述限制是必要的，因为每个客户都与经销商的计费帐户相关联。
  • 对于 Cisco FTD 设备，主设备和辅助设备的管理类型必须相同。
注意

创建虚拟设备即表示您接受订单条款。致电获取订单条款以查看详细信息。选中创建自配置边缘设备以了解业务详细信息。

要保存设备草稿，您必须提供 deviceTypeCode、accountNumber 或 accountReferenceId 和 metroCode。

示例请求​

创建单个设备的示例 curl 请求。

curl -X  
POST "https://api.equinix.com/ne/v1/devices?draft=false"  
-H "content-type: application/json"  
-H "Authorization: Bearer <token>"  
-d '  
{  
    "metroCode": "SV",  
    "deviceTypeCode": "VSRX",  
    "agreeOrderTerms": true,  
    "termLength": "1",  
    "licenseMode": "BYOL",  
    "packageCode": "STD",  
    "virtualDeviceName": "Test-device-001-SROY",  
    "notifications": [  
        "test@equinix.com"  
    ],  
    "hostNamePrefix": "TC12",  
    "aclDetails": [  
        {  
            "uuid": "fb2e69bb-cbd7-40c4-bc01-8bcc5fa741c2",  
            "interfaceType": "WAN"  
        }  
    ],  
    "accountNumber": "200541",  
    "version": "23.2R1.13",  
    "interfaceCount": 8,  
    "deviceManagementType": "SELF-CONFIGURED",  
    "core": 2,  
    "userPublicKey": {  
        "username": "userName",  
        "keyName": "keyName"  
    },  
    "additionalBandwidth": "100"  
}  
'

创建冗余设备的 curl 请求示例。

curl -X  
POST "https://api.equinix.com/ne/v1/devices?draft=false"  
-H "content-type: application/json"  
-H "Authorization: Bearer <token>"  
-d '  
{  
    "metroCode": "DC",  
    "deviceTypeCode": "C8000V",  
    "agreeOrderTerms": true,  
    "termLength": "1",  
    "licenseMode": "BYOL",  
    "packageCode": "network-advantage",  
    "virtualDeviceName": "Test-device-001-SROY - primary",  
    "notifications": [  
        "test@equinix.com"  
    ],  
    "hostNamePrefix": "TC01",  
        "aclDetails": [  
        {  
            "uuid": "fb2e69bb-cbd7-40c4-bc01-8bcc5fa741c2",  
            "interfaceType": "WAN"  
        }  
    ],  
    "accountNumber": "201148",  
    "version": "17.06.06a",  
    "interfaceCount": 10,  
    "deviceManagementType": "SELF-CONFIGURED",  
    "core": 2,  
    "userPublicKey": {  
        "username": "sroy",  
        "keyName": "keyWIQzB"  
    },  
    "sshInterfaceId": "3",  
    "channelPartner": "SDCI",  
    "secondary": {  
        "metroCode": "DC",  
        "hostNamePrefix": "TC02",  
        "notifications": [  
            "test@equinix.com"  
        ],  
        "virtualDeviceName": "Test-device-002-SROY - secondary",  
        "additionalBandwidth": "100",  
            "aclDetails": [  
        {  
            "uuid": "fb2e69bb-cbd7-40c4-bc01-8bcc5fa741c2",  
            "interfaceType": "WAN"  
        }  
    ],  
        "accountNumber": "201148",  
        "sshInterfaceId": "4"  
    }  
}  
'

创建无互联网访问的 Cisco FTD 辅助设备的示例 curl 请求。

curl -X  
POST "https://api.equinix.com/ne/v1/devices?draft=false"  
-H "content-type: application/json"  
-H "Authorization: Bearer <token>"  
-d '  
{  
    "deviceTypeCode": "Cisco_NGFW",  
    "licenseMode": "BYOL",  
    "packageCode": "FTDv5",  
    "virtualDeviceName": "NEAut-",  
    "metroCode": "DC",  
    "notifications": [  
        "t@t.com"  
    ],  
    "hostNamePrefix": "test",  
    "interfaceCount": 10,  
    "deviceManagementType": "SELF-CONFIGURED",  
    "core": 4,  
    "version": "7.0.4-55",  
    "vendorConfig": {  
        "managementType": "FDM"  
    },  
    "connectivity": "PRIVATE",  
    "secondary": {  
        "hostNamePrefix": "test-123",  
        "metroCode": "DC",  
        "notifications": [  
            "t@t.com"  
        ],  
        "virtualDeviceName": "test-secondary",  
        "vendorConfig": {  
            "managementType": "FDM"  
        }  
    }  
}  
'

有关参数和选项的完整列表，请参阅API 参考。

示例回复​

单个设备的示例响应。202：请求已接受。

{  
    "uuid": "74d8c6b6-3153-4271-9f0e-45bdc7094dec"  
}

冗余设备的示例响应。202：请求已接受。

{  
    "uuid": "74d8c6b6-3153-4271-9f0e-45bdc7094dec",  
    "secondaryUuid": "de5cf79b-3d16-4ccd-841b-3b68ecda2142"  
}

设备状态​

您可以通过调用 Get Virtual Device {uuid} 来监控设备状态。您的设备必须已完成配置，并且您的许可证必须已注册，然后才能连接到云服务提供商。

虚拟设备"状态"描述
INITIALIZINGEquinix目前正在预留资源和创建设备。
PROVISIONING设备正在启动。
PENDING_ORDER订单已从Siebel到达NE，客户需要登录NE门户网站并提交订单。
PENDING_SIGNATURE客户已签署线下接受NE条款的协议，但尚未接受条款。
CANCEL_ORDERSiebel 发给 NE 的订单被取消。
WAITING_FOR_PRIMARY辅助设备已准备就绪，但主设备尚未准备就绪。仅当您创建了用于冗余的辅助设备时，才会出现此状态。
WAITING_FOR_SECONDARY主设备已准备就绪，但辅助设备尚未准备就绪。仅当您已创建用于冗余的辅助设备时，才会出现此状态。
FAILED设备创建失败。
PROVISIONED设备已准备就绪。

当最终用户使用 Delete Virtual Devices API 删除设备时，设备在 Equinix 系统中会经历以下状态转换。 基础设施。

/ne/v1/devices/{uuid} 下的虚拟设备“status”描述
取消置备Equinix 接受了客户删除虚拟设备的请求。
已取消置备该设备已取消配置/删除。
此页面是否有帮助？