# 创建设备 ![](https://docs.equinix.com/zh-Hans/assets/images/LaunchVirtualDevice-48c8825b5fcf89576c1c90b5a92ad0cc.png) ## 先决条件[​](#先决条件 "直接链接至先决条件") 验证-提交您的用户凭据,客户端ID和客户端机密以进行OAuth2验证。有关如何致电OAuth API以验证和验证您的凭据的说明,请参阅[API验证](https://docs.equinix.com/zh-Hans/equinix-api/api-authentication.md)。 ## 步骤2:获取设备详情[​](#步骤2获取设备详情 "直接链接至步骤2:获取设备详情") * 打电话[获取设备类型](https://docs.equinix.com/zh-Hans/api-catalog/network-edgev1/availability-and-metros/getvirtualdevicetypes),以了解要在NE平台上启动的自我配置设备(例如路由器或防火墙)。您将了解虚拟设备可用的都会区区域,设备供应商,可用内核数量以及软件包及其版本。选择`deviceTypeCode`,`metroCode`,`core`,`packageCode`和`version`。 * 拨打[获取允许接口](https://docs.equinix.com/zh-Hans/api-catalog/network-edgev1/availability-and-metros/getallowedinterfaces),以了解所选核心允许[的](https://docs.equinix.com/zh-Hans/api-catalog/network-edgev1/availability-and-metros/getallowedinterfaces)接口数量。您可以选择任何可用的设备接口`sshInterfaceId`。否则,Equinix 将选择第一个可用的接口。 * 拨打[获取账户{METRO}](https://docs.equinix.com/zh-Hans/api-catalog/network-edgev1/availability-and-metros/getaccountswithstatus),以查看您的账号(或`accountReferenceId`)和需要虚拟设备所在都会区的状态。出于计费原因,您必须在需要虚拟设备所在的都会区拥有账户,处于“活动”或“待定”状态。如果您没有[账户](https://docs.equinix.com/en-us/Content/Interconnection/NE/user-guide/NE-billing-account-creation.htm),请创建一个[账户](https://docs.equinix.com/en-us/Content/Interconnection/NE/user-guide/NE-billing-account-creation.htm)。 您是试图为客户创建设备的**转销商**,您必须确保客户和您(转销商)的账户均处于“活跃”或“待定”状态。您的账户将收到账单,但您必须将客户的账号发送至API,以便为客户创建设备。 ## 步骤3:许可选项[​](#步骤3许可选项 "直接链接至步骤3:许可选项") BYOL (自带许可)作为大多数设备的许可选项。上传许可证文件或代码/令牌/ID,具体取决于供应商提供的服务。Cisco 8000V提供订阅许可选项。 * Arista:我们不支持上传Arista设备的许可证。但是,您可以在设备创建完毕后登录设备上传许可证,以提高吞吐量。 * Palo Alto和Alto提供许可证令牌。在字段中输入许可证令牌`licenseToken`。 * 瞻博网络提供许可证文件。要为瞻博网络设备自带许可证(BYOL),请使用[许可证发布文件](https://docs.equinix.com/zh-Hans/api-catalog/network-edgev1/availability-and-metros/uploadlicense)上传许可证文件。您将获得一个文件ID,可用于创建虚拟设备。如果您拥有冗余瞻博网络设备,则可以对主要和次要设备使用相同的文件ID。 * 飞塔:创建设备时,Fortinet设备并非强制性许可证。如果您有令牌,请在字段中输入`licenseToken`。要为Fortinet设备配置许可证文件,您必须执行以下操作: * 在 Fortinet 门户上生成许可证文件。 * 在Equinix门户网站上传许可证[文件](https://docs.equinix.com/zh-Hans/api-catalog/network-edgev1/availability-and-metros/uploadlicense),方法是致电“[许可后文件](https://docs.equinix.com/zh-Hans/api-catalog/network-edgev1/availability-and-metros/uploadlicense)”。您将获得,`fileId`可用于创建虚拟设备。 - 登录设备检查您的许可证状态。 ## 步骤4:创建自主配置设备[​](#步骤4创建自主配置设备 "直接链接至步骤4:创建自主配置设备") | | 发布/ne/v1/devices | | ---------- | ----------------------------------- | | 方法 | `POST` | | URL 或端点 | `/ne/v1/devices` | | 标题 | `Authorization`令牌,`Content-Type` | | 查询参数 | `draft`,`draftUuid` | 要创建具有主设备和辅助设备的冗余设备: * 设置次要对象的参数 * 如果您是试图为客户创建冗余设备的**转销商**,请确保主要都会区和次要都会区位于同一国家/地区。主账号和备用账号必须相同。转销商的账户将被收取费用,但此API接受客户的账号,以便为客户创建设备。上述限制是必需的,因为每位客户都与转销商的开票账户相关联。 * 对于 Cisco FTD 设备,主设备和辅助设备的管理类型必须相同。 > **注意** > > 创建虚拟设备,即表示您接受订单条款。致电[获取订单条款](https://docs.equinix.com/zh-Hans/api-catalog/network-edgev1/availability-and-metros/getorderterms)以查看详细信息。 要保存设备草稿,您必须提供`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 " -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 " -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 " -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参考手册](https://docs.equinix.com/zh-Hans/api-catalog/network-edgev1/virtual-device/createvirtualdevice)。 ## 示例回复[​](#示例回复 "直接链接至示例回复") 单个设备的响应示例。第202章:请求已接受。 ``` {     "uuid": "74d8c6b6-3153-4271-9f0e-45bdc7094dec" } ``` 冗余设备的响应示例。第202章:请求已接受。 ``` {     "uuid": "74d8c6b6-3153-4271-9f0e-45bdc7094dec",     "secondaryUuid": "de5cf79b-3d16-4ccd-841b-3b68ecda2142" } ``` ## 设备状态[​](#设备状态 "直接链接至设备状态") 拨打[获取虚拟设备{uuid}](https://docs.equinix.com/zh-Hans/api-catalog/network-edgev1/virtual-device/getvirtualdevicebyuuid),监控设备状态。您必须先配置设备并注册许可证,然后才能连接到云服务提供商。 | **虚拟设备“状态”** | **描述** | | ----------------------- | ------------------------------------------------------------------------------------ | | `INITIALIZING` | Equinix目前正在预留资源和创建设备。 | | `PROVISIONING` | 设备正在启动。 | | `PENDING_ORDER` | 订单已从Siebel发送到NE。客户需要登录NE门户网站并提交订单。 | | `PENDING_SIGNATURE` | 客户已签署线下接受NE条款的协议,但尚未接受条款。 | | `CANCEL_ORDER` | Siebel 发给 NE 的订购已取消。 | | `WAITING_FOR_PRIMARY` | 备用设备已就绪,但主要设备未就绪。仅当您创建了用于冗余的辅助设备时,此状态才会显示。 | | `WAITING_FOR_SECONDARY` | 主设备已就绪,但辅助设备未就绪。仅当您创建了用于冗余的辅助设备时,此状态才会显示。 | | `FAILED` | 设备创建失败。 | | `PROVISIONED` | 设备已准备就绪。 | ![](https://docs.equinix.com/zh-Hans/assets/images/LaunchSelfConfiguredDeviceStatus-d63f23898d5988482946da4824869a64.png) 终端用户使用 “[删除虚拟设备](https://docs.equinix.com/zh-Hans/api-catalog/network-edgev1/virtual-device/deletevirtualdevicebyuuid)”API删除设备时,设备将通过Equinix基础设施中的以下状态转换。 | /ne/v1/devices/{uuid} 下的虚拟设备“status” | 描述 | | ------------------------------------------ | -------------------------------------- | | 取消配置 | Equinix 接受了客户删除虚拟设备的请求。 | | 已取消配置 | 该设备已取消配置/删除。 |