跳到主要内容

创建 SDWAN 设备

先决条件​

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

步骤2：获取设备类型和账户​

致电获取设备类型 API，以查找可在NE平台上启动的WAN设备。您将了解这些设备可用的都会区(metroCode)，可用内核数量(core)，软件包(packageCode和version)以及所有可能的许可和吞吐量选项。

如果您已经知道想要哪个设备，则可以跳过此步骤。

accountReferenceId拨打Get Accounts {METRO} API，查看您的账号(或)和需要虚拟设备所在都会区的状态。出于计费原因，您必须在需要虚拟设备所在的都会区拥有账户，处于“活动”或“待定”状态。要了解如何创建账户，请转到开票账户管理。

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

如果您已知道账号(或accountReferenceId)和 状态，可以跳过此步骤。

步骤3：配置许可证​

目前，自带许可证 (BYOL) 是 SD-WAN 设备唯一可用的许可选项。 每个供应商的自带设备许可（BYOL）流程都各不相同。

要为Cisco WAN设备配置许可证，请执行以下操作：

  • 在Cisco vManage 平台上生成引导文件。
  • 要创建C8000V-SDWAN，请调用上传文件来上传Cisco引导文件。您将在回应中收到fileUuid。您可以在“创建有效负载”字段中输入值day0TextFileId，以创建虚拟C8000V-SDWAN设备。

要为Prisma设备配置许可证，请执行以下操作：

  • 在Prisma Orchestrator上生成许可密钥(ION密钥)和许可机密钥(机密钥)。
  • 在调用Equinix时，输入许可密钥(ION密钥)和机密密钥(机密钥) API，以创建Prisma WAN设备。

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

  • 在 Fortinet 门户上生成许可证文件。
  • 在Equinix门户网站上传许可证文件，方法是致电“许可后文件”。您将获得fileId，可用于创建虚拟WAN设备。

要配置Versa设备，请在Versa director上创建VNF设备模板并记下序列号 。

您不需要许可证文件即可在Network Edge平台上配置 Aruba 设备。

若要上传瞻博WAN的许可证，请执行以下操作：

  • 在Juniper门户上生成许可证文件。
  • 在Equinix门户网站上传许可证文件，方法是致电“许可后文件”。您将获得fileId，可用于创建瞻博WAN设备。

步骤4：供应商特定参数​

每个WAN供应商都需要自己的一组参数，而不是 步骤5中POST API定义中列出的常用参数。 在步骤中创建新设备时，请检查供应商的参数，并在vendorConfig {}对象中传递参数 5.

思科 SD-WAN​

Cisco vendorConfig{}参数必填类型示例可能的值描述
站点ID是字符串12345站点ID。思科WAN设备为必填项。维普特拉是LAN覆盖网络中的特定物理位置，如分支机构或园区。
systemIp地址是字符串192.168.1.5系统IP地址。思科WAN设备为必填项。为每台Vedge路由器和vSmart控制器分配了系统IP地址。它应采用十进制四分点分表示法，就像IPv4地址一样。
主机名有条件的字符串SR-01主机名。C8000V-SDWAN为必填项。

Palo Alto Networks PRISMA-SDWAN​

Palo Alto Networks vendorConfig{}参数必填类型示例可能的值描述
许可证密钥(ION密钥)是字符串<license_key>许可密钥(ION密钥)。Palo Alto Networks设备为必填项。
许可证机密(机密钥)是字符串ec68e425-f973-452e-a866-76be5844d0ba许可证机密(机密钥)。Palo Alto Networks设备为必填项。

Versa VERSA_SDWAN​

Versa vendorConfig{}参数必填类型示例可能的值描述
本地ID是字符串SDWAN-Branch@Versa.com分支机构的电子邮件地址。
远程ID是字符串Controller-01-staging@Versa.com控制端的电子邮件地址。
序列号是字符串12345在Versa Director上设置设备模板时，客户选择序列号。Versa director上的Versa后期部署设备序列号应与此输入项匹配。
控制器1是字符串54.219.248.29SD-WAN 控制器 1 的 IP 地址。
控制器2是字符串54.177.220.115SD-WAN 控制器 2 的 IP 地址。

FortiGate FG-SDWAN *​

FortiGate vendorConfig{}参数必填类型示例可能的值描述
管理员密码是字符串密码9密码。密码长度至少应为6个字符，且必须包含大写字母和数字。
控制器1是字符串1.1.1.1系统IP地址。FortiGate WAN设备为必填项。

*FortiGate SD-WAN 设备也需要主机名，但它不属于 vendorConfig 对象，而是直接传递的。 一个参数，以及其他参数，例如 deviceTypeCode、accountNumber 等。

Arista VELOCLOUD-SDWAN​

Arista vendorConfig{}参数必填类型示例可能的值描述
激活密钥是字符串GJUK-JM2X-59BJ-样本激活密钥。可在VeloCloud编排门户网站上获取。
controllerFqdn是字符串demo.velocloud.netVeloCloud SD - WAN网关。在设备的ACL列表中，请提供与controllerFqdn关联的IP地址。
root密码否字符串测试密码！设备的CLI密码。

HPE Aruba EDGECONNECT-SDWAN​

Aruba vendorConfig{}参数必填类型示例可能的值描述
账户名称是字符串账户名称帐户的名称。
主机名是字符串主机名1用于识别的主机名。这将作为FQDN包括在内，并确保可以从获准的来源访问设备。仅允许使用a-z，A-Z，0-9和连字符(-)。必须以字母开头，以字母或数字结尾。长度应介于2-30个字符之间。FTDv 2-14；阿鲁巴2-24。
账户密钥是字符串账户密钥帐户密钥。
设备标记否字符串设备标记电器标签。

步骤5：创建SD - WAN设备​

发布/ne/v1/devices
方法POST
URL 或端点/ne/v1/devices
标题Authorization，Content-Type
查询参数draft，draftUuid

如果您想创建一个包含两个设备（主设备和备用设备）的冗余 SD-WAN 设备，请执行以下操作： 下列的：

  1. 设置vendorConfig可选辅助对象的参数。

    • 在请求正文负载中为Cisco SD-WAN 提供两个 licenseFileId
    • 为 CloudGenix 冗余提供两个许可证密钥（ION 密钥）和许可证密钥（密钥）。 请求正文有效负载中的设备
    • 为冗余的 Arista VeloCloud SD-WAN Edge 设备提供两个激活密钥。

  2. 您的辅助设备可能具有不同的 ACL 模板、帐号、additionalBandwidth、metroCode 和通知。

  3. 如果您是试图为客户创建冗余设备的转销商，请确保主要都会区和次要都会区位于同一国家/地区。此外，主要和备用账号必须相同。转销商的账户将被收取费用，但此API接受客户的账号，以便为客户创建设备。上述限制是必需的，因为每位客户都与转销商的开票账户相关联。

如果您没有所有必要的信息，您仍然可以将信息保存为草稿。 您必须提供deviceTypeCode，AccountNumber/accountReferenceId和metroCode才能保存 草稿。

注意

创建虚拟设备，即表示您接受订单条款。致电获取订单条款以查看详细信息。

示例请求​

创建冗余Cisco SD-WAN 设备的示例 curl 请求。

curl -X POST 
https://api.equinix.com/ne/v1/devices?draft=false
-H 'Authorization: Bearer <token>' 
-H 'Content-Type: application/json' 
-d '
{
    "deviceTypeCode": "C8000V-SDWAN",
    "projectId": "XXXXX",
    "metroCode": "DC",
    "termLength": "1",
    "licenseMode": "BYOL",
    "packageCode": "DNA",
    "virtualDeviceName": "sroy-cisco-8v-controller",
    "notifications": [
        "test@equinix.com"
    ],
    "version": "17.09.01a",
    "interfaceCount": 10,
    "deviceManagementType": "SELF-CONFIGURED",
    "core": 4,
    "vendorConfig": {
        "systemIpAddress": "1.1.1.1",
        "siteId": "4567",
        "hostname": "SR-01"
    },
    "aclTemplateUuid": "3319e378-be2f-40e4-8e79-13ea2aed7a5f",
    "day0TextFileId": "917f2621-11d4-468f-9a09-af8fd66c0e57",
    "accountNumber": "201091",
    "secondary": {
        "metroCode": "DC",
        "notifications": [
            "test@equinix.com"
        ],
        "virtualDeviceName": "sroy-cisco-8v-controller-secondary",
        "additionalBandwidth": "100",
        "vendorConfig": {
            "systemIpAddress": "1.1.1.1",
            "siteId": "9886",
            "hostname": "SR-02"
        },
        "aclTemplateUuid": "3319e378-be2f-40e4-8e79-13ea2aed7a5f",
        "day0TextFileId": "dec1dee5-eba9-4187-a029-ae76341e8874",
        "accountNumber": "201091"
    },
    "additionalBandwidth": "100"
}
'

参数和选项的完整列表，请参见API参考手册。

示例响应​

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

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

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

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

如果出现“拒绝访问”的情况，联系人您当地的Equinix服务台以获取门户访问权限。

设备状态​

WAN设备创建后，该设备将在Equinix基础设施中通过各种状态转换。可以使用获取虚拟设备{uuid} API的“状态”响应属性来监控这些状态。设备配置完毕并应用许可证后，您可以创建与云服务提供商的连接。

虚拟设备状态描述
INITIALIZINGEquinix目前正在预留资源和创建设备。
PENDING_ACCOUNT客户的账户未获批准。账户获得批准后，设备创建将继续。
PROVISIONING设备正在启动。
PENDING_ORDER此状态仅适用于从Siebel到达NE的订单。客户需要登录Network Edge门户网站并提交待定订单。
PENDING_SIGNATURE客户尚未接受Network Edge条款。
CANCEL_ORDERSiebel 发给 NE 的订购已取消。此状态仅适用于从Siebel转入Network Edge的订单。
WAITING_FOR_PRIMARY备用设备已就绪，但主要设备未就绪。如果您请求了冗余设备，则可能会出现此状态。
WAITING_FOR_SECONDARY主设备已就绪，但辅助设备未就绪。如果您请求了冗余设备，则可能会出现此状态。
FAILED设备创建失败。
PROVISIONED设备已准备就绪。
DEPROVISIONINGEquinix接受了客户删除虚拟设备的请求。
DEPROVISIONED该设备已取消配置/删除。

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

地位描述
DEPROVISIONINGEquinix接受了客户删除虚拟设备的请求。
DEPROVISIONED该设备已取消配置/删除。
这个页面对您有帮助吗？