为单个虚拟设备添加冗余

将辅助设备添加到已激活的虚拟设备中，即可创建冗余对。为现有设备增加冗余功能，无需重新购置两台新设备。

辅助设备的某些属性必须与主设备相同，包括：

设备配置
许可证制度
设备资源
软件套装
许可证吞吐量

如果两台设备属于同一个账户，则辅助设备的合约期限必须与主设备的合约期限相同。

您可以自定义以下辅助设备属性：

版本
主机名
通知列表
SSH 用户列表
访问 IP 地址
额外带宽

先决条件

单个、非冗余的网络边缘虚拟设备。
Network Edge Device Manager 角色。

Portal
API

登录到 Equinix Customer Portal 并导航到 Network Edge。
从“网络边缘”菜单中，选择“虚拟设备清单”。
点击你想编辑的设备。将显示虚拟设备的详细信息。

身份验证 - 请提交您的用户凭据、客户端 ID 和客户端密钥以进行 OAuth2 身份验证。有关如何调用 OAuth API 来验证和确认您的凭据的说明，请参阅API 身份验证。
获取主设备信息。向 /ne/v1/devices 端点发送 GET 请求以列出您的虚拟设备。确定要添加辅助设备的设备，并向 /ne/v1/devices/{uuid} 端点发送 GET 请求以获取主设备的属性。

添加辅助虚拟设备

Portal
API

在“虚拟设备清单”中，单击虚拟设备的名称以查看其“虚拟设备详细信息”。
点击添加辅助设备。
供应商软件包会自动设置为与您的主设备相同。您无需为辅助设备选择或配置供应商软件包。
对于“选择部署类型”，系统会自动配置以下选项：
- 冗余设备
- 向现有设备添加额外的冗余设备
- 位置和主虚拟设备
点击开始创建边缘设备。
选择辅助设备的存储位置。默认情况下，“选择与主设备相同的都会区存储位置”已选中，并且已选择主设备的都会区存储位置。

要选择不同的都会区位置，请取消选中“选择与您的主要设备相同的都会区” ，然后选择不同的都会区。
从下拉列表中选择一个结算帐户，或者单击“选择与现有主设备相同的结算帐户”。

信息
点击查看主设备摘要以查看主设备的帐户详细信息、设备详细信息、许可证信息、通知详细信息和带宽信息。
点击下一步：设备详情。
大多数“设备详细信息”必须与主设备相同，系统会自动选择且无法修改。但是：
- 如果辅助设备支持不同的（更新的）软件版本，则冗余配对的两台设备如果软件版本不同，可能会影响性能。我们建议您更新主设备的软件版本。
- 您可以为您的备用设备取一个不同的名称。
- 如果您选择的计费帐户与主设备使用的计费帐户不同，请在“期限”部分选择期限长度。
点击下一步：其他服务。
为辅助设备选择其他服务。它们的默认设置与主设备相同。
- 要修改_设备访问权限_，请取消选中_与主设备相同_，并配置辅助设备的访问权限配置。
- 要修改_访问控制列表模板_，请取消选中_与主设备相同_，然后从下拉列表中选择一个模板或创建一个新的模板。
- 要为辅助设备增加额外的带宽，请从“辅助设备带宽”下拉列表中选择带宽。
点击“下一步：审核”并审核您的订购。在“共享支持结构”部分，您必须点击“我已阅读并确认此支持政策”。
点击创建虚拟设备。

要创建辅助设备，请向 /ne/v1/devices 端点发送 POST 请求。在请求正文中，指定：

您的主设备的 UUID 为 primaryDeviceUuid。
secondary 对象中的辅助设备配置。请注意，如果辅助设备支持不同的（更新的）软件版本，则冗余配对中的两个设备如果软件版本不同，可能会影响性能。我们建议您更新主设备的软件版本。

示例 cURL 请求：

curl -X POST "https://api.equinix.com/ne/v1/devices" \
-H "content-type: application/json" \
-H "Authorization: Bearer <token>" \
-d '{
  "primaryDeviceUuid": "device_uuid",
  "secondary": {
    "metroCode": "<metro_code>",
    "version": "<version_number>",
    "virtualDeviceName": "<secondary_device_name>",
    "hostNamePrefix": "<secondary_device_hostname_prefix>",
    "notifications": [
      "<contact_email>"
    ],
    "termLength": 1,
    "aclDetails": [
      {
        "uuid": "<acl_uuid>",
        "interfaceType": "<acl_interface_type>"
      }
    ],
    "userPublicKey": {
      "username": "<username>",
      "keyName": "<keyname>"
    },
    "licenseFileId": "<license_file_id>",
    "accountNumber": "<account_number>"
  }
}'

仅当您的供应商和许可模式需要许可文件时才包含 licenseFileId。

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

在辅助设备配置期间，主设备的状态将变为 WAITING_FOR_SECONDARY。如果备用节点配置失败，主节点将回退到备用节点。已配置状态。如果辅助配置完成，则两个设备的状态都将更改为 PROVISIONED。

先决条件​

添加辅助虚拟设备​

先决条件

添加辅助虚拟设备