# 启动集群设备 ![](https://docs.equinix.com/zh-Hans/assets/images/LaunchClusterDevice-8cbbed9f9cbc2854ae5a7b777f1f7935.png) ## 先决条件[​](#先决条件 "直接链接至先决条件") 1. 验证-提交您的用户凭据,客户端ID和客户端机密以进行OAuth2验证。有关如何致电OAuth API以验证和验证您的凭据的说明,请参阅[API验证](https://docs.equinix.com/zh-Hans/equinix-api/api-authentication.md)。 2. 打电话[获取设备类型](https://docs.equinix.com/zh-Hans/api-catalog/network-edgev1/availability-and-metros/getvirtualdevicetypes),以了解要在NE平台上启动的集群设备(例如路由器或防火墙)。您将了解虚拟设备可用的都会区地区,设备供应商,可用内核数量以及软件包及其版本。选择`deviceTypeCode`,`metroCode`,`core`,`packageCode`和`version`。 3. 拨打[获取允许接口](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 将选择第一个可用的接口。 4. 拨打[获取账户{METRO}](https://docs.equinix.com/zh-Hans/api-catalog/network-edgev1/availability-and-metros/getaccountswithstatus),以检查您的`account number`(或`acountReferenceId`)和在需要虚拟设备所在都会区的状态。出于计费原因,您必须在需要虚拟设备所在的都会区拥有账户,处于“活动”或“待定”状态。如果您没有[账户](https://docs.equinix.com/zh-Hans/network-edge/billing/ne-billing-account-creation.md),请创建一个[账户](https://docs.equinix.com/zh-Hans/network-edge/billing/ne-billing-account-creation.md)。 您是试图为客户创建设备的**转销商**,您必须确保客户和您(转销商)的账户均处于“活跃”或“待定”状态。您的账户将收到账单,但您必须将客户的账号发送至POST API,以便为客户创建设备。 ## 许可选项[​](#许可选项 "直接链接至许可选项") 截至目前,我们仅为集群提供 BYOL(自带许可)选项。 * **瞻博网络集群**-无需上传瞻博网络集群的许可证文件。但是,您可以上传两个许可证文件。如需上传两个许可证文件,请致电“[许可证发布文件](https://docs.equinix.com/zh-Hans/api-catalog/network-edgev1/availability-and-metros/uploadlicense)”两次。您将在响应中获取许可证文件IDS,可用于创建集群。 * **Palo Alto集群**-您必须从供应商上传两个许可证令牌。许可证令牌可以相同或不同。 * **Fortinet集群**-您无需输入令牌或许可证。如需上传许可证文件,必须上传两个不同的许可证文件。如需上传两个许可证文件,请致电“[许可证发布文件](https://docs.equinix.com/zh-Hans/api-catalog/network-edgev1/availability-and-metros/uploadlicense)”两次。您将在响应中获取许可证文件IDS,可用于创建集群。 * **WAN边缘集群**您无需上传许可证文件或令牌。但是,您必须提供激活密钥。创建设备后,如果许可证注册失败,您必须登录设备并上传许可证。然后调用状态值[更新虚拟设备](https://docs.equinix.com/zh-Hans/api-catalog/network-edgev1/virtual-device/updatevirtualdevicebyuuid)`PROVISIONED`。 ## 创建集群设备[​](#创建集群设备 "直接链接至创建集群设备") | | 发布/ne/v1/devices | | ---------- | ----------------------------------- | | 方法 | `POST` | | URL 或端点 | `/ne/v1/devices` | | 标题 | `Authorization`令牌,`Content-Type` | | 查询参数 | `draft`,`draftUuid` | 注意:创建虚拟设备,即表示您接受订单条款。致电[获取订单条款](https://docs.equinix.com/zh-Hans/api-catalog/network-edgev1/availability-and-metros/getorderterms)以查看详细信息。 要保存设备草稿,您必须提供`deviceTypeCode`,`accountNumber`或`accountReferenceId` 和`metroCode`。 创建 vSRX 集群的示例 curl 请求: ``` curl -X POST "https://api.equinix.com/ne/v1/devices?draft=false" -H "content-type: application/json" -H "Authorization: Bearer " -d ' {     "deviceTypeCode": "VSRX",     "clusterDetails": {         "clusterName": "sroy-juniper",         "clusterNodeDetails": {             "node0": {                 "vendorConfig": {                     "hostname": "sr012"                 },                 "licenseFileId": "1274fe9f-511c-436f-bc0c-14c876ec55da"             },             "node1": {                 "vendorConfig": {                     "hostname": "sr123"                 },                 "licenseFileId": "65a9be3f-57fb-4c4d-a15b-40950951bc13"             }         }     },     "metroCode": "SV",     "termLength": "1",     "licenseMode": "BYOL",     "packageCode": "STD",     "virtualDeviceName": "Test-device-001-SROY",     "notifications": [         "test@equinix.com"     ],     "hostname": "sr012",     "aclDetails": [        {          "uuid": "fb2e69bb-cbd7-40c4-bc01-8bcc5fa741c2",          "interfaceType": "WAN"        }     ],     "accountNumber": "201148",     "version": "18.4R3-S2",     "interfaceCount": 8,     "agreeOrderTerms": true,     "deviceManagementType": "SELF-CONFIGURED",     "core": 5,     "userPublicKey": {         "username": "sroy",         "keyName": "keyLlhzL"     },     "additionalBandwidth": "100" } ' ``` 以下是一个用于创建 Arista Velocloud SDWAN 集群的 curl 请求示例: ``` curl -X POST "https://api.equinix.com/ne/v1/devices?draft=false" -H "content-type: application/json" -H "Authorization: Bearer " -d ' {     "metroCode": "SY",     "deviceTypeCode": "VELOCLOUD-SDWAN",     "termLength": "1",     "clusterDetails": {         "clusterName": "sroy-velo-cluster",         "vendorConfig": {             "node0": {                 "activationKey": "GJUK-JM2X-59BJ-SAMPLE",                 "controllerFqdn": "demo.velocloud.net",                 "rootPassword": "TestPassword!"             },             "node1": {                 "rootPassword": "TestPassword#"             }         }     },     "licenseMode": "BYOL",     "packageCode": "VeloCloud-4",     "virtualDeviceName": "velo-cluster",     "notifications": [         "test@equinix.com"     ],     "aclDetails": [        {          "uuid": "fb2e69bb-cbd7-40c4-bc01-8bcc5fa741c2",          "interfaceType": "WAN"        }     ],     "accountNumber": "2393479",     "version": "3.4.2",     "interfaceCount": 8,     "deviceManagementType": "SELF-CONFIGURED",     "agreeOrderTerms": true,     "core": 4,     "userPublicKey": {         "username": "sroy",         "keyName": "key7YFfL"     },     "additionalBandwidth": "200" } ' ``` 创建无互联网访问的 PANW 集群的示例 curl 请求: ``` curl -X POST "https://api.equinix.com/ne/v1/devices?draft=false" -H "content-type: application/json" -H "Authorization: Bearer " -d ' {     "deviceTypeCode": "PA-VM",     "clusterDetails": {         "clusterName": "NEAut-",         "clusterNodeDetails": {             "node0": {             "vendorConfig": {                 "hostname": "PANCluster"             }             },             "node1": {             "vendorConfig": {                 "hostname": "PANCluster"             }             }         }     },     "metroCode": "#(supportedMetro)",     "zoneCode": "Zone1",     "termLength": "1",     "licenseMode": "BYOL",     "packageCode": "VM100",     "virtualDeviceName": "NEAut-",     "notifications": [         "t@t.com"     ],     "version": "10.1.3",     "interfaceCount": 10,     "deviceManagementType": "SELF-CONFIGURED",     "core": 2,     "connectivity": "PRIVATE" } ' ``` 参数和选项的完整列表,请参见[API参考手册](https://docs.equinix.com/zh-Hans/api-catalog/network-edgev1/virtual-device/createvirtualdevice)。 ## 示例响应[​](#示例响应 "直接链接至示例响应") 响应202示例:请求已接受。 ``` {     "uuid": "34b7838c-ec82-4166-ac19-efa03b4e34fe",     "deviceIds": {         "node0": "34b7838c-ec82-4166-ac19-efa03b4e34fe",         "node1": "f27f1475-3c7f-447f-b0db-e3bb3af3de16"     },     "clusterId": "27eea9aa-327b-431b-bf62-3cee4d880f2e" } ``` ## 设备状态[​](#设备状态 "直接链接至设备状态") 集群创建后,自我配置的集群将在 Equinix基础设施中的不同状态转换。可以使用[获取虚拟设备{uuid}](https://docs.equinix.com/zh-Hans/api-catalog/network-edgev1/virtual-device/getvirtualdevicebyuuid)方法的Response属性来监控这些状态`status`。您必须配置集群并注册许可证,然后才能使用此集群连接到云服务提供商。 | **虚拟设备状态** | **描述** | | ----------------------- | ------------------------------------------------------------------------------------ | | `INITIALIZING` | Equinix目前正在预留资源和创建设备。 | | `PENDING_ACCOUNT` | 客户的账户未获批准。账户获得批准后,设备创建将继续。 | | `PROVISIONING` | 设备正在启动。 | | `PENDING_ORDER` | 此状态仅适用于从Siebel到达NE的订单。客户需要登录Network Edge门户网站并提交待定订单。 | | `PENDING_SIGNATURE` | 客户尚未接受Network Edge条款。 | | `CANCEL_ORDER` | Siebel 发给 NE 的订购已取消。此状态仅适用于从Siebel转入Network Edge的订单。 | | `WAITING_FOR_PRIMARY` | 备用设备已就绪,但主要设备未就绪。如果您请求了冗余设备,则可能会出现此状态。 | | `WAITING_FOR_SECONDARY` | 主设备已就绪,但辅助设备未就绪。如果您请求了冗余设备,则可能会出现此状态。 | | `FAILED` | 设备创建失败。 | | `PROVISIONED` | 设备已准备就绪。 | | `DEPROVISIONING` | Equinix接受了客户删除虚拟设备的请求。 | | `DEPROVISIONED` | 该设备已取消配置/删除。 | ![](https://docs.equinix.com/zh-Hans/assets/images/LaunchClusterDeviceStatus-c01747a2fac38f81e3e43d32810dbc59.png) 终端用户使用[删除虚拟设备](https://docs.equinix.com/zh-Hans/api-catalog/network-edgev1/virtual-device/deletevirtualdevicebyuuid)API删除设备时,该设备将通过Equinix 基础设施中的以下状态转换。 | 地位 | 描述 | | ---------------- | ------------------------------------- | | `DEPROVISIONING` | Equinix接受了客户删除虚拟设备的请求。 | | `DEPROVISIONED` | 该设备已取消配置/删除。 |