创建设备

先决条件

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

步骤2：获取设备详情

打电话获取设备类型，以了解要在NE平台上启动的自我配置设备(例如路由器或防火墙)。您将了解虚拟设备可用的都会区区域，设备供应商，可用内核数量以及软件包及其版本。选择deviceTypeCode，metroCode，core，packageCode和version。
拨打获取允许接口，以了解所选核心允许的接口数量。您可以选择任何可用的设备接口sshInterfaceId。否则，Equinix 将选择第一个可用的接口。
拨打获取账户{METRO}，以查看您的账号(或accountReferenceId)和需要虚拟设备所在都会区的状态。出于计费原因，您必须在需要虚拟设备所在的都会区拥有账户，处于“活动”或“待定”状态。如果您没有账户，请创建一个账户。

您是试图为客户创建设备的转销商，您必须确保客户和您(转销商)的账户均处于“活跃”或“待定”状态。您的账户将收到账单，但您必须将客户的账号发送至API，以便为客户创建设备。

步骤3：许可选项

BYOL (自带许可)作为大多数设备的许可选项。上传许可证文件或代码/令牌/ID，具体取决于供应商提供的服务。Cisco 8000V提供订阅许可选项。

Arista：我们不支持上传Arista设备的许可证。但是，您可以在设备创建完毕后登录设备上传许可证，以提高吞吐量。
Palo Alto和Alto提供许可证令牌。在字段中输入许可证令牌licenseToken。
瞻博网络提供许可证文件。要为瞻博网络设备自带许可证(BYOL)，请使用许可证发布文件上传许可证文件。您将获得一个文件ID，可用于创建虚拟设备。如果您拥有冗余瞻博网络设备，则可以对主要和次要设备使用相同的文件ID。
飞塔：创建设备时，Fortinet设备并非强制性许可证。如果您有令牌，请在字段中输入licenseToken。要为Fortinet设备配置许可证文件，您必须执行以下操作：
- 在 Fortinet 门户上生成许可证文件。
- 在Equinix门户网站上传许可证文件，方法是致电“许可后文件”。您将获得，fileId可用于创建虚拟设备。
- 登录设备检查您的许可证状态。

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

	发布/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"  
}

设备状态

拨打获取虚拟设备{uuid}，监控设备状态。您必须先配置设备并注册许可证，然后才能连接到云服务提供商。

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

终端用户使用 “删除虚拟设备”API删除设备时，设备将通过Equinix基础设施中的以下状态转换。

/ne/v1/devices/{uuid} 下的虚拟设备“status”	描述
取消配置	Equinix 接受了客户删除虚拟设备的请求。
已取消配置	该设备已取消配置/删除。

先决条件​

步骤2：获取设备详情​

步骤3：许可选项​

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

示例请求​

示例回复​

设备状态​