# 创建 SDWAN 设备 ![](https://docs.equinix.com/zh-Hans/assets/images/LaunchSDWANDevice-4b2ded8e9446a178320c2beefdef8bdd.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) API,以查找可在NE平台上启动的WAN设备。您将了解这些设备可用的都会区(`metroCode`),可用内核数量(`core`),软件包(`packageCode`和`version`)以及所有可能的许可和吞吐量选项。 如果您已经知道想要哪个设备,则可以跳过此步骤。 `accountReferenceId`拨打[Get Accounts {METRO}](https://docs.equinix.com/zh-Hans/api-catalog/network-edgev1/availability-and-metros/getmetros) API,查看您的账号(或)和需要虚拟设备所在都会区的状态。出于计费原因,您必须在需要虚拟设备所在的都会区拥有账户,处于“活动”或“待定”状态。要了解如何创建账户,请转到[开票账户管理](https://docs.equinix.com/en-us/Content/Interconnection/NE/user-guide/NE-billing-account-creation.htm)。 您是试图为客户创建设备的**转销商**,您必须确保客户和您(转销商)的账户均处于“活跃”或“待定”状态。您的账户将收到账单,但您必须将客户的账号发送至POST API,以便为您的客户创建WAN设备。 如果您已知道账号(或`accountReferenceId`)和 状态,可以跳过此步骤。 ## 步骤3:配置许可证[​](#步骤3配置许可证 "直接链接至步骤3:配置许可证") 目前,自带许可证 (BYOL) 是 SD-WAN 设备唯一可用的许可选项。 每个供应商的自带设备许可(BYOL)流程都各不相同。 要为Cisco WAN设备配置许可证,请执行以下操作: * 在Cisco vManage 平台上生成引导文件。 * 要创建C8000V-SDWAN,请调用[上传文件](https://docs.equinix.com/zh-Hans/api-catalog/network-edgev1/availability-and-metros/uploadfile)来上传Cisco引导文件。您将在回应中收到`fileUuid`。您可以在“创建有效负载”字段中输入值`day0TextFileId`,以创建虚拟C8000V-SDWAN设备。 要为Prisma设备配置许可证,请执行以下操作: * 在Prisma Orchestrator上生成许可密钥(ION密钥)和许可机密钥(机密钥)。 * 在调用Equinix时,输入许可密钥(ION密钥)和机密密钥(机密钥) API,以创建Prisma WAN设备。 创建设备时,Fortinet设备并非强制性许可证。如果您有令牌,请 在字段中输入`licenseToken`。要为Fortinet WAN设备配置许可证文件,请执行 以下操作: * 在 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`,可用于创建虚拟WAN设备。 要配置Versa设备,请在Versa director上创建VNF设备模板并记下序列号 。 您不需要许可证文件即可在Network Edge平台上配置 Aruba 设备。 若要上传瞻博WAN的许可证,请执行以下操作: * 在Juniper门户上生成许可证文件。 * 在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`,可用于创建瞻博WAN设备。 ## 步骤4:供应商特定参数[​](#步骤4供应商特定参数 "直接链接至步骤4:供应商特定参数") 每个WAN供应商都需要自己的一组参数,而不是 [步骤5](#step-5-create-sd-wan-devices)中POST API定义中列出的常用参数。 在步骤中创建新设备时,请检查供应商的参数,并在vendorConfig {}对象中传递参数 5. ### 思科 SD-WAN[​](#思科-sd-wan "直接链接至思科 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-prisma-sdwan "直接链接至Palo Alto Networks PRISMA-SDWAN") | **Palo Alto Networks vendorConfig{}参数** | **必填** | **类型** | **示例** | **可能的值** | **描述** | | ----------------------------------------- | -------- | -------- | ------------------------------------ | ------------ | ---------------------------------------------------- | | 许可证密钥(ION密钥) | 是 | 字符串 | `` | | 许可密钥(ION密钥)。Palo Alto Networks设备为必填项。 | | 许可证机密(机密钥) | 是 | 字符串 | ec68e425-f973-452e-a866-76be5844d0ba | | 许可证机密(机密钥)。Palo Alto Networks设备为必填项。 | ### Versa VERSA\_SDWAN[​](#versa-versa_sdwan "直接链接至Versa VERSA_SDWAN") | **Versa vendorConfig{}参数** | **必填** | **类型** | **示例** | **可能的值** | **描述** | | ---------------------------- | -------- | -------- | --------------------------------- | ------------ | ------------------------------------------------------------------------------------------------------------- | | 本地ID | 是 | 字符串 | | | 分支机构的电子邮件地址。 | | 远程ID | 是 | 字符串 | | | 控制端的电子邮件地址。 | | 序列号 | 是 | 字符串 | 12345 | | 在Versa Director上设置设备模板时,客户选择序列号。Versa director上的Versa后期部署设备序列号应与此输入项匹配。 | | 控制器1 | 是 | 字符串 | 54.219.248.29 | | SD-WAN 控制器 1 的 IP 地址。 | | 控制器2 | 是 | 字符串 | 54.177.220.115 | | SD-WAN 控制器 2 的 IP 地址。 | ### FortiGate FG-SDWAN \*[​](#fortigate-fg-sdwan- "直接链接至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-velocloud-sdwan "直接链接至Arista VELOCLOUD-SDWAN") | **Arista vendorConfig{}参数** | **必填** | **类型** | **示例** | **可能的值** | **描述** | | ----------------------------- | -------- | -------- | ------------------- | ------------ | ----------------------------------------------------------------------------- | | 激活密钥 | 是 | 字符串 | GJUK-JM2X-59BJ-样本 | | 激活密钥。可在VeloCloud编排门户网站上获取。 | | controllerFqdn | 是 | 字符串 | demo.velocloud.net | | VeloCloud SD - WAN网关。在设备的ACL列表中,提供与controllerFqdn关联的IP地址。 | | root密码 | 否 | 字符串 | 测试密码! | | 设备的CLI密码。 | ### HPE Aruba EDGECONNECT-SDWAN[​](#hpe-aruba-edgeconnect-sdwan "直接链接至HPE Aruba EDGECONNECT-SDWAN") | **Aruba vendorConfig{}参数** | **必填** | **类型** | **示例** | **可能的值** | **描述** | | ---------------------------- | -------- | -------- | -------- | ------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 账户名称 | 是 | 字符串 | 账户名称 | | 帐户的名称。 | | 主机名 | 是 | 字符串 | 主机名1 | | 用于识别的主机名。这将作为FQDN包括在内,并确保可以从获准的来源访问设备。仅允许使用a-z,A-Z,0-9和连字符(-)。必须以字母开头,以字母或数字结尾。长度应介于2-30个字符之间。FTDv 2-14;阿鲁巴2-24。 | | 账户密钥 | 是 | 字符串 | 账户密钥 | | 帐户密钥。 | | 设备标记 | 否 | 字符串 | 设备标记 | | 电器标签。 | ## 步骤5:创建SD - WAN设备[​](#步骤5创建sd---wan设备 "直接链接至步骤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才能保存 草稿。 > **注意** > > 创建虚拟设备,即表示您接受订单条款。致电[获取订单条款](https://docs.equinix.com/zh-Hans/api-catalog/network-edgev1/availability-and-metros/getorderterms)以查看详细信息。 ## 示例请求[​](#示例请求 "直接链接至示例请求") 创建冗余Cisco SD-WAN 设备的示例 curl 请求。 ``` curl -X POST  https://api.equinix.com/ne/v1/devices?draft=false -H 'Authorization: Bearer '  -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参考手册](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" } ``` 如果出现“拒绝访问”的情况,联系人您当地的Equinix服务台以获取门户访问权限。 ## 设备状态[​](#设备状态 "直接链接至设备状态") WAN设备创建后,该设备将在Equinix基础设施中通过各种状态转换。可以使用[获取虚拟设备{uuid}](https://docs.equinix.com/zh-Hans/api-catalog/network-edgev1/virtual-device/getvirtualdevicebyuuid) API的“状态”响应属性来监控这些状态。设备配置完毕并应用许可证后,您可以创建与云服务提供商的连接。 | **虚拟设备状态** | **描述** | | ----------------------- | ------------------------------------------------------------------------------------ | | `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/LaunchSDWANDeviceStatus-ec85c8073706c572830c9b87116993e6.png) 终端用户使用[删除虚拟设备](https://docs.equinix.com/zh-Hans/api-catalog/network-edgev1/virtual-device/deletevirtualdevicebyuuid)API删除设备时,该设备将通过Equinix 基础设施中的以下状态转换。 | 地位 | 描述 | | ---------------- | ------------------------------------- | | `DEPROVISIONING` | Equinix接受了客户删除虚拟设备的请求。 | | `DEPROVISIONED` | 该设备已取消配置/删除。 |