网络
虚拟私有云 VPC
弹性公网IP EIP
弹性负载均衡 ELB
NAT网关 NAT
云专线 DC
虚拟专用网络 VPN
云连接 CC
VPC终端节点 VPCEP
企业路由器 ER
企业交换机 ESW
全球加速 GA
企业连接 EC
云原生应用网络 ANC
安全与合规
安全技术与应用
Web应用防火墙 WAF
企业主机安全 HSS
云防火墙 CFW
安全云脑 SecMaster
DDoS防护 AAD
数据加密服务 DEW
数据库安全服务 DBSS
云堡垒机 CBH
数据安全中心 DSC
云证书管理服务 CCM
认证测试中心 CTC
边缘安全 EdgeSec
应用中间件
微服务引擎 CSE
分布式消息服务Kafka版
分布式消息服务RabbitMQ版
分布式消息服务RocketMQ版
API网关 APIG
分布式缓存服务 DCS
多活高可用服务 MAS
事件网格 EG
管理与监管
统一身份认证服务 IAM
消息通知服务 SMN
云监控服务 CES
应用运维管理 AOM
应用性能管理 APM
云日志服务 LTS
云审计服务 CTS
标签管理服务 TMS
配置审计 Config
应用身份管理服务 OneAccess
资源访问管理 RAM
组织 Organizations
资源编排服务 RFS
优化顾问 OA
IAM 身份中心
云运维中心 COC
资源治理中心 RGC
解决方案
高性能计算 HPC
SAP
混合云灾备
开天工业工作台 MIW
Haydn解决方案工厂
数字化诊断治理专家服务
云生态
云商店
合作伙伴中心
华为云开发者学堂
华为云慧通差旅
开发与运维
软件开发生产线 CodeArts
需求管理 CodeArts Req
流水线 CodeArts Pipeline
代码检查 CodeArts Check
编译构建 CodeArts Build
部署 CodeArts Deploy
测试计划 CodeArts TestPlan
制品仓库 CodeArts Artifact
移动应用测试 MobileAPPTest
CodeArts IDE Online
开源镜像站 Mirrors
性能测试 CodeArts PerfTest
应用管理与运维平台 ServiceStage
云应用引擎 CAE
开源治理服务 CodeArts Governance
华为云Astro轻应用
CodeArts IDE
Astro工作流 AstroFlow
代码托管 CodeArts Repo
漏洞管理服务 CodeArts Inspector
联接 CodeArtsLink
软件建模 CodeArts Modeling
Astro企业应用 AstroPro
CodeArts 盘古助手
华为云Astro大屏应用
计算
弹性云服务器 ECS
Flexus云服务
裸金属服务器 BMS
云手机服务器 CPH
专属主机 DeH
弹性伸缩 AS
镜像服务 IMS
函数工作流 FunctionGraph
云耀云服务器(旧版)
VR云渲游平台 CVR
Huawei Cloud EulerOS
云化数据中心 CloudDC
网络
虚拟私有云 VPC
弹性公网IP EIP
弹性负载均衡 ELB
NAT网关 NAT
云专线 DC
虚拟专用网络 VPN
云连接 CC
VPC终端节点 VPCEP
企业路由器 ER
企业交换机 ESW
全球加速 GA
企业连接 EC
云原生应用网络 ANC
CDN与智能边缘
内容分发网络 CDN
智能边缘云 IEC
智能边缘平台 IEF
CloudPond云服务
安全与合规
安全技术与应用
Web应用防火墙 WAF
企业主机安全 HSS
云防火墙 CFW
安全云脑 SecMaster
DDoS防护 AAD
数据加密服务 DEW
数据库安全服务 DBSS
云堡垒机 CBH
数据安全中心 DSC
云证书管理服务 CCM
认证测试中心 CTC
边缘安全 EdgeSec
大数据
MapReduce服务 MRS
数据湖探索 DLI
表格存储服务 CloudTable
可信智能计算服务 TICS
推荐系统 RES
云搜索服务 CSS
数据可视化 DLV
数据接入服务 DIS
数据仓库服务 GaussDB(DWS)
数据治理中心 DataArts Studio
湖仓构建 LakeFormation
智能数据洞察 DataArts Insight
应用中间件
微服务引擎 CSE
分布式消息服务Kafka版
分布式消息服务RabbitMQ版
分布式消息服务RocketMQ版
API网关 APIG
分布式缓存服务 DCS
多活高可用服务 MAS
事件网格 EG
开天aPaaS
应用平台 AppStage
开天企业工作台 MSSE
开天集成工作台 MSSI
API中心 API Hub
云消息服务 KooMessage
交换数据空间 EDS
云地图服务 KooMap
云手机服务 KooPhone
组织成员账号 OrgID
云空间服务 KooDrive
管理与监管
统一身份认证服务 IAM
消息通知服务 SMN
云监控服务 CES
应用运维管理 AOM
应用性能管理 APM
云日志服务 LTS
云审计服务 CTS
标签管理服务 TMS
配置审计 Config
应用身份管理服务 OneAccess
资源访问管理 RAM
组织 Organizations
资源编排服务 RFS
优化顾问 OA
IAM 身份中心
云运维中心 COC
资源治理中心 RGC
区块链
区块链服务 BCS
数字资产链 DAC
华为云区块链引擎服务 HBS
解决方案
高性能计算 HPC
SAP
混合云灾备
开天工业工作台 MIW
Haydn解决方案工厂
数字化诊断治理专家服务
价格
成本优化最佳实践
专属云商业逻辑
云生态
云商店
合作伙伴中心
华为云开发者学堂
华为云慧通差旅
其他
管理控制台
消息中心
产品价格详情
系统权限
客户关联华为云合作伙伴须知
公共问题
宽限期保留期
奖励推广计划
活动
云服务信任体系能力说明
开发与运维
软件开发生产线 CodeArts
需求管理 CodeArts Req
流水线 CodeArts Pipeline
代码检查 CodeArts Check
编译构建 CodeArts Build
部署 CodeArts Deploy
测试计划 CodeArts TestPlan
制品仓库 CodeArts Artifact
移动应用测试 MobileAPPTest
CodeArts IDE Online
开源镜像站 Mirrors
性能测试 CodeArts PerfTest
应用管理与运维平台 ServiceStage
云应用引擎 CAE
开源治理服务 CodeArts Governance
华为云Astro轻应用
CodeArts IDE
Astro工作流 AstroFlow
代码托管 CodeArts Repo
漏洞管理服务 CodeArts Inspector
联接 CodeArtsLink
软件建模 CodeArts Modeling
Astro企业应用 AstroPro
CodeArts 盘古助手
华为云Astro大屏应用
存储
对象存储服务 OBS
云硬盘 EVS
云备份 CBR
高性能弹性文件服务 SFS Turbo
弹性文件服务 SFS
存储容灾服务 SDRS
云硬盘备份 VBS
云服务器备份 CSBS
数据快递服务 DES
云存储网关 CSG
专属分布式存储服务 DSS
数据工坊 DWR
地图数据 MapDS
键值存储服务 KVS
容器
云容器引擎 CCE
云容器实例 CCI
容器镜像服务 SWR
云原生服务中心 OSC
应用服务网格 ASM
华为云UCS
数据库
云数据库 RDS
数据复制服务 DRS
文档数据库服务 DDS
分布式数据库中间件 DDM
云数据库 GaussDB
云数据库 GeminiDB
数据管理服务 DAS
数据库和应用迁移 UGO
云数据库 TaurusDB
人工智能
AI开发平台ModelArts
华为HiLens
图引擎服务 GES
图像识别 Image
文字识别 OCR
自然语言处理 NLP
内容审核 Moderation
图像搜索 ImageSearch
医疗智能体 EIHealth
企业级AI应用开发专业套件 ModelArts Pro
人脸识别服务 FRS
对话机器人服务 CBS
语音交互服务 SIS
人证核身服务 IVS
视频智能分析服务 VIAS
城市智能体
自动驾驶云服务 Octopus
盘古大模型 PanguLargeModels
IoT物联网
设备接入 IoTDA
全球SIM联接 GSL
IoT数据分析 IoTA
路网数字化服务 DRIS
IoT边缘 IoTEdge
设备发放 IoTDP
企业应用
域名注册服务 Domains
云解析服务 DNS
企业门户 EWP
ICP备案
商标注册
华为云WeLink
华为云会议 Meeting
隐私保护通话 PrivateNumber
语音通话 VoiceCall
消息&短信 MSGSMS
云管理网络
SD-WAN 云服务
边缘数据中心管理 EDCM
云桌面 Workspace
应用与数据集成平台 ROMA Connect
ROMA资产中心 ROMA Exchange
API全生命周期管理 ROMA API
政企自服务管理 ESM
视频
实时音视频 SparkRTC
视频直播 Live
视频点播 VOD
媒体处理 MPC
视频接入服务 VIS
数字内容生产线 MetaStudio
迁移
主机迁移服务 SMS
对象存储迁移服务 OMS
云数据迁移 CDM
迁移中心 MGC
专属云
专属计算集群 DCC
开发者工具
SDK开发指南
API签名指南
DevStar
华为云命令行工具服务 KooCLI
Huawei Cloud Toolkit
CodeArts API
云化转型
云架构中心
云采用框架
用户服务
账号中心
费用中心
成本中心
资源中心
企业管理
工单管理
客户运营能力
国际站常见问题
支持计划
专业服务
合作伙伴支持计划
我的凭证
华为云公共事业服务云平台
工业软件
工业数字模型驱动引擎
硬件开发工具链平台云服务
工业数据转换引擎云服务

更新网络编排资源

更新时间:2025-02-17 GMT+08:00
分享

典型场景

更新网络编排资源。

接口功能

更新网络编排资源。

接口约束

1、该接口仅支持租户视图或msp代维视图下,角色为“Open Api Operator”的用户访问,必须在用户会话建立后使用。

2、TNP激活后,communityPool,bgpAsNum无法修改,如需修改,请先清空站点;其中地址池参数(evpnIPpool,innerTunnelIPpool,interConnectIPpool,evpnIpv6Pool,innerTunnelIpv6Pool,interConnectIpv6Pool,linkLocalIPV6pool),可以扩充地址段,但已被站点使用的地址段不能修改或删除。

调用方法

PUT

URI

/controller/campus/v1/sdwan/net/network-orchestration-resources

请求参数

表1 body参数列表

参数名称

必选

类型

参数值域

默认值

参数说明

参数示例

networkOrchestrationResourcesInfo

REFERENCE

详细请参见表2

网络编排资源对象。

-

表2 NetworkOrchestrationResourcesInfo对象的参数列表

参数名称

必选

类型

参数值域

默认值

参数说明

参数示例

bgpAsNum

int64

[1-4294967295]

-

路由协议AS号。配置后不可修改。取值范围:1-4294967295,建议:64512-65534;bgpAsNum参数在首次配置时不填会默认赋值65001。

65001

communityPool

array<integer>

0-10 个列表项。每个列表项取值[0-65534]

-

BGP community资源池。interlinkProtocolType为ibgp时communityPool必填。community格式为二字节aa:nn,下发时自动转换为四字节。用户输入aa的数组集合,aa的范围是1~65534。nn的范围是0~65535,由控制器分配。范围计算公式:65536*aa~65536*aa+65535。

[1,2]

interlinkProtocolType

string

-

-

双网关互联协议类型,可选OSPF或IBGP协议。

切换双网关互联协议,会对租户下新加入VPN的双网关站点的互联协议进行变更,影响组网配置,请谨慎选择。

选择IBGP时,需要配置团体属性池,关闭团体属性池配置后,IPv4双网关互联协议在站点ZTP后不能修改。

"ospf"

communityPoolStatus

int32

-

-

团体池状态。-1:r19c10及之前的版本创建的旧租户,存在已激活的站点;0:未设置资源池,不存在激活的站点;1:r19c10及之后的版本且设置了资源池。查询时返回。

1

siteScale

string

-

-

废弃字段。

"1000+"

dsvpnIPpool

array<string>

0-64 个列表项。

-

废弃字段。

["10.1.0.0/16","10.2.0.0/16"]

evpnIPpool

array<string>

0-100 个列表项。

-

EVPN IP地址资源池。

["10.1.0.0/16","10.2.0.0/16"]

innerTunnelIPpool

array<string>

0-64 个列表项。

-

内环隧道IP地址资源池。修改时需要填写所有已配置的地址段,未填写的地址段会被删除。

["10.1.0.0/16","10.2.0.0/16"]

interConnectIPpool

string

-

-

用于双网关内链路IP地址段。首次配置时必填。支持配置32段,每段之间用";"隔开。修改时需要填写所有已配置的地址段,未填写的地址段会被删除。

"192.168.1.0/26"

evpnIpv6Pool

array<string>

0-100 个列表项。

-

EVPN隧道IPv6地址资源池。使用IPv6业务配置时填写,地址池满足IPv6单播地址要求。修改时需要填写所有已配置的地址段,未填写的地址段会被删除。

["2100::/96","2200::/96"]

innerTunnelIpv6Pool

array<string>

0-64 个列表项。

-

内环隧道IPv6地址资源池。使用IPv6业务配置时填写,地址池满足唯一本地地址前缀要求,前缀为fd00::/8。修改时需要填写所有已配置的地址段,未填写的地址段会被删除。

["fd00::/96","fd10::/96"]

interConnectIpv6Pool

string

-

-

用于双网关内链路IPv6地址段。使用IPv6业务时填写,地址池满足唯一本地地址前缀要求,前缀为fd00::/8。支持配置32段,每段之间用";"隔开。修改时需要填写所有已配置的地址段,未填写的地址段会被删除。

"fd01::/96"

linkLocalIPV6pool

string

-

-

用于内环隧道口链路本地。使用IPv6业务时填写,地址池满足链路本地地址前缀要求,前缀为fe80::/10。支持配置32段,每段之间用";"隔开。修改时需要填写所有已配置的地址段,未填写的地址段会被删除。

"fe80::/96"

enableDelayTime

boolean

  • true

  • false

-

是否使能路由策略延时。默认值为false。

V300系列设备仅V300R021C10及之后版本路由策略延时生效,V600版本的设备不支持此功能。

false

delayTime

int32

[1-180]

-

路由策略延时。

50

unsecurePktDiscardEnable

boolean

  • true

  • false

false

是否使能非加密报文丢弃。默认值为false。

V300系列设备仅V300R023C10及之后版本非加密报文丢弃生效,V600系列设备仅V600R023C10及之后版本非加密报文丢弃生效。

FW网关设备不支持使能非加密报文丢弃。

false

enableBgpKeepaliveTime

boolean

  • true

  • false

false

BGP路由维持时长使能,默认为false。使能后,V600系列FW设备V600R024C00及之后版本生效,V600系列AR设备V600R023C00及之后版本生效,V300版本设备不支持,AR6700V和AR6700V-L款型设备不支持。

1、仅支持连接RR邻居保活;

2、RR断链指定bgpKeepaliveTime时间内BGP路由不撤销,转发面正常转发数据;

3、站点关联多台RR设备(双网关RR站点、多个RR站点)时不建议使能,多台RR设备中一台RR设备异常断链将导致转发设备BGP路由不刷新。

false

bgpKeepaliveTime

int32

[60-21600]

-

BGP路由维持最大保活时长,单位分钟;当enableBgpKeepaliveTime为true时必填。小于等于IPSec的生存周期数值一半。需要在配置IPSec加密参数的生存周期之后配置。

720

transportNetworks

ARRAY_REFERENCE

0-32个列表项,详细请参见表3

传输网络,最多32条。

-

routingDomain

ARRAY_REFERENCE

0-32个列表项,详细请参见表4

路由域。

-

ipsecEncryptionParameter

REFERENCE

详细请参见表5

IPSEC加密信息,首次配置时必填。

-

defaultMngInterfaceConfig

REFERENCE

详细请参见表6

默认管理口配置

-

linkQualityDetectionParameter

REFERENCE

详细请参见表7

链路质量检测参数。

-

trafficSteeringPolicyPeriodConfig

REFERENCE

详细请参见表8

智能选路周期参数。

-

provisionUrlParameter

REFERENCE

详细请参见表13

开局Url全局参,获取开局Url接口里可以重新指定对应站点的加密密码和token有效期。

-

portConfiguration

REFERENCE

详细请参见表15

端口号配置。

-

dataPackageFormat

REFERENCE

详细请参见表17

数据封装格式。

V300系列设备在V300R022C10SPC100及以上版本开始支持。

V600系列设备在V600R023C00及以上版本开始支持。

AR6700V-L设备在V600R023C10及以上版本开始支持。

AR6700V设备不支持此功能。

FW网关设备不支持此功能。

-

linkDetectIntervalConfig

REFERENCE

详细请参见表18

南向接入链路检测的间隔配置。

-

表3 TransportNetworkInfo对象的参数列表

参数名称

必选

类型

参数值域

默认值

参数说明

参数示例

id

string

0~64个字符。

-

主键ID,uuid格式。更新时必填。

"00000000-0000-0000-0000-000000000000"

name

string

0~31个字符。

-

传输网络名称。配置时必填,可以填写数字、字母、中文、空格(不能全为空格)和特殊字符,其中特殊字符包括!"#$%&'()*+,_-./:;<=>@[\]^`{|}~。默认传输网络Internet、Internet1、MPLS、MPLS1名称不可修改。

"mpls1"

routingDomain

string

0~32个字符。

-

传输网络中对应路由域名称,引用NetworkOrchestrationResourcesInfo中routingDomain的名称。配置时必填。默认传输网络路由域不可修改。

"mpls"

description

string

0~128个字符。

-

传输网络的描述,修改时需要填写已配置的信息,若填写为null则会被删除。

"a mpls link"

priority

int32

[1-255]

-

传输网络的优先级,修改时需要填写已配置的优先级,若填写为null则会被删除。

1

表4 RoutingDomainInfo对象的参数列表

参数名称

必选

类型

参数值域

默认值

参数说明

参数示例

name

string

0~31个字符。

-

路由域名称。配置时必填,只能填写数字、字母、下划线和括号。

"mpls1"

ipsecEncryption

boolean

  • true

  • false

false

是否加密。加密时,IpsecEncryptionParameterInfo中必须配置了加密算法。配置时必填。

true

isMspRD

boolean

  • true

  • false

false

是否使用MSP下路由域,多租户场景使用,仅查询使用,创建修改不生效。瑞电场景不使用该字段,非必填项。

true

表5 IpsecEncryptionParameterInfo对象的参数列表

参数名称

必选

类型

参数值域

默认值

参数说明

参数示例

authenticationAlgorithm

string

  • SHA2_256

  • SM3

SHA2_256

认证算法,取值范围:SHA2_256、SM3。配置时必填。

"SHA2_256"

encrptionAlgorithm

string

1~12个字符。

AES128

加密算法,取值范围:AES128、AES256、SM4,当authenticationAlgorithm配置为SHA2_256时,可配置AES128、AES256、AES-256-GCM,其中AES-256-GCM仅支持V300R023C10及以上版本,当authenticationAlgorithm配置为SM3时,可配置SM4。配置时必填。

"AES128"

lifeTime

int32

[60-43200]

1440

IPSec SA生存周期,单位是分钟。当使能BGP路由维持最大保活时长时,取值大于等于bgpKeepaliveTime的两倍。仅V600系列设备在V600R24C00及以上版本开始支持修改。

1440

preSharedKey

string

0~128个字符。

-

该字段可能包含敏感信息和个人数据,请妥善做好保护。

废弃字段。

""

dhGroup

string

0~7个字符。

  

非必填项,IPSec隧道协商时密钥交换算法使用的DH组,取值范围:group19、group20、group21或空串,填空串表示不启用dhGroup。

"group19"

antiReplayEnable

boolean

  • true

  • false

false

是否使能IPSEC抗重放功能,默认为false。暂不支持该功能。

false

antiReplayWindow

int32

[32-1024]

-

抗重放窗口大小,单位为bit,当antiReplayEnable为true时必填。暂不支持该功能。

1024

表6 DefaultMngInterfaceConfigInfo对象的参数列表

参数名称

必选

类型

参数值域

默认值

参数说明

参数示例

cleanDefaultMngInterfaceConfig

boolean

  • true

  • false

false

是否配置清除。此参数设置为true时会导致该设备二层口无法切换到三层口,请谨慎操作,仅支持V300系列设备,在ZTP开局时触发。

false

表7 LinkQualityDetection对象的参数列表

参数名称

必选

类型

参数值域

默认值

参数说明

参数示例

enable

boolean

  • true

  • false

false

链路质量检测使能开关。默认为false。当enable为false时,interval、retryTimes、priority不生效且恢复默认配置。当enable为true时,interval、retrytimes、priority必填。

true

interval

int32

[10-10000]

1000

检测报文发送间隔,单位:毫秒,取值范围10-10000,且为10的整数倍,建议:1000。

100

retryTimes

int32

[3-10]

6

检测失败重试次数,建议:6。

6

priority

int32

[0-7]

6

检测报文优先级,建议:6。

5

表8 TrafficSteeringPolicyPeriod对象的参数列表

参数名称

必选

类型

参数值域

默认值

参数说明

参数示例

enable

boolean

  • true

  • false

true

智能选路周期参数使能开关,默认为true。false表示关闭。

true

switchingPeriod

int32

[1-7200]

-

切换周期,链路质量不满足时,发生切换的时间间隔,单位:秒。不配置时默认5秒。

100

statisticsPeriod

int32

[1-3600]

-

统计周期,计算链路质量的时间间隔,单位:秒。取值不大于切换周期。

100

flappingSuppression

int64

[2-14400]

-

抑制震荡周期,且至少是切换周期的两倍的正整数。抑制链路频繁切换的时间间隔,单位:秒。不配置时默认30秒。

100

enableFlappingSuppressionEnhanced

boolean

  • true

  • false

false

是否开启增强抑制震荡,V300系列设备从V300R022C00SPC100版本开始支持该功能,V600系列设备不支持使能此功能。默认为false。

false

symmetricForward

boolean

  • true

  • false

-

对称选路开关。默认值为true。

V600版本的设备从V600R023C00版本开始支持。

FW网关设备从V600R024C00开始支持。

true

bandwidthUtilizationEnable

boolean

  • true

  • false

-

带宽利用率使能开关。V300版本设备仅V300R021C10及以上版本支持关闭,V600版本设备仅V600R023C00及以上版本支持关闭,未配置时设备功能默认为打开。

true

maxBandwidthUtilization

int32

[50-100]

-

最大带宽利用率(%),默认值95。V600版本的设备从V600R022C00版本开始支持。

95

sameTnFirst

boolean

  • true

  • false

false

PF选路时,优先选择Transportnewortk相同的EVPN Conneciton。

false

siteIdSmallerFirst

boolean

  • true

  • false

true

连接站点的Transportnewortk不同时,选择Site Id小的Transportnewortk。

false

basedRulesVo

REFERENCE

详细请参见表9

同TN选项配置。

-

表9 BasedRulesVo对象的参数列表

参数名称

必选

类型

参数值域

默认值

参数说明

参数示例

tnpPriorityEnable

boolean

  • true

  • false

-

传输网络优先级开关,当tnpPriorityEnable为false时,传输网络优先级不会生效。创建时,默认值为false。

true

basedTnpPriorityVo

REFERENCE

详细请参见表10

传输网络优先级

-

tnpRoleEnable

boolean

  • true

  • false

-

站点角色开关,当tnpRoleEnable为false时,站点角色优先级不会生效。默认值为false。

true

basedRoleVo

REFERENCE

详细请参见表11

站点角色

-

tnpBandwidthEnable

boolean

  • true

  • false

-

传输网络带宽开关,当tnpBandwidthEnable为false时,传输网络带宽优先级不会生效。默认值为false。

true

basedBandwidthVo

REFERENCE

详细请参见表12

传输网络带宽

-

表10 BasedTnpPriorityVo对象的参数列表

参数名称

必选

类型

参数值域

默认值

参数说明

参数示例

mode

string

0~256个字符。

-

传输网络优先级模式,取值范围只可以是larger。

"larger"

priority

int32

[1-3]

-

TNP优先级。1为高,3为低。其中传输网络优先级,站点角色优先级,传输网络带宽优先级不能配置相同的优先级。

1

表11 BasedRoleVo对象的参数列表

参数名称

必选

类型

参数值域

默认值

参数说明

参数示例

mode

string

0~256个字符。

-

站点角色模式,取值范围为hub或者spoke。

"hub"

priority

int32

[1-3]

-

站点角色优先级。1为高,3为低。其中传输网络优先级,站点角色优先级,传输网络带宽优先级不能配置相同的优先级。

2

表12 BasedBandwidthVo对象的参数列表

参数名称

必选

类型

参数值域

默认值

参数说明

参数示例

mode

string

0~256个字符。

-

传输网络带宽模式,取值范围为smaller或者larger。

"smaller"

priority

int32

[1-3]

-

传输网络带宽优先级。1为高,3为低。其中传输网络优先级,站点角色优先级,传输网络带宽优先级不能配置相同的优先级。

3

表13 ProvisionUrlInfo对象的参数列表

参数名称

必选

类型

参数值域

默认值

参数说明

参数示例

encryptUrlEnable

boolean

  • true

  • false

-

是否使能开局url加密。创建时,默认值为false。

false

encryptSensitiveParameters

boolean

  • true

  • false

-

对部分敏感数据加密,V300系列设备不支持配置,V600版本的设备从V600R23C00版本开始支持。修改时需要填写已配置的信息,未填写或null则为false。

false

oldDevceiVersionEnable

boolean

  • true

  • false

-

是否使能兼容旧版本设备。R19C10开始设备加密密码强度增强为8-12位数字和字母组合,之前旧版本设备支持6-12位数字。默认值为false。不推荐配置为true。

false

encryptionKey

string

6~12个字符。

-

该字段可能包含敏感信息和个人数据,请妥善做好保护。

非必填项,加密URL的密码,开启开局url加密时(encryptUrlEnable=true)必填。若开启兼容旧版本设备(oldDevceiVersionEnable=true),密码为6到12位数字组合,不开启(oldDevceiVersionEnable=false)时密码为8到12位数字和字母的组合。全局参数,每个站点也可以在获取开局url请求里重新指定该站点的加密密码。

"12345abc"

validityPeriod

int32

[1-30]

30

开局url token有效期。单位:天,默认值30。全局参数,每个站点也可以在获取开局url请求里重新指定该站点的token有效期。

7

urlWebInfoEnable

boolean

  • true

  • false

false

是否启用web用户信息,V600系列设备仅V600R022C00及之后版本URL需要携带。V300系列设备不支持使能此功能。

false

urlWebInfo

REFERENCE

详细请参见表14

V600系列设备URL需要携带的web用户信息。

-

表14 UrlWebInfo对象的参数列表

参数名称

必选

类型

参数值域

默认值

参数说明

参数示例

webUser

string

6~64个字符。

-

web登录用户名,可配置英文、数字、特殊字符,其中特殊字符包括!#$%&'()+,_./:;<=>@[\]^`{|}~。用户名不能以@开头,且不可以是"huawei",无论大小写。

"abcd1234"

webPassword

string

8~128个字符。

-

该字段可能包含敏感信息和个人数据,请妥善做好保护。

web登录密码。长度必须在8-128位,密码必须有数字、大写字母、小写字母、特殊字符("`!@#$%^&()_+=-[]{},.;)组成,密码不能和帐号或帐号的反向字符串相同,密码中不能包含两个以上相同的字符。

"Example@123"

表15 PortConfigurationInfo对象的参数列表

参数名称

必选

类型

参数值域

默认值

参数说明

参数示例

cusPortConfigEnable

boolean

  • true

  • false

-

端口号配置开关。默认值为false。

true

dtlsServerPort

int32

[10000-65535]

-

dlts服务端端口号,修改联动编排租户下所有设备。

55100

stunServerPort

int32

[1024-65535]

-

stun服务端端口号,修改联动编排租户下所有设备。

3478

connectionDefaultPort

REFERENCE

详细请参见表16

连接源端口。修改端口信息不会修改已激活站点的配置。

-

表16 ConnectionPortAttributes对象的参数列表

参数名称

必选

类型

参数值域

默认值

参数说明

参数示例

connectPortEnable

boolean

  • true

  • false

-

连接源端口开关。当开关打开时,参数srcPort,portNum,portStep都需要配置。

true

srcPort

int32

[4501-65535]

-

连接端口号动态扫描起始端口。

4501

portNum

int32

[0-3]

-

连接端口号动态扫描次数。

0

portStep

int32

[0-10]

-

连接端口号动态扫描步长。

10

表17 DataPackageFormat对象的参数列表

参数名称

必选

类型

参数值域

默认值

参数说明

参数示例

extFormatSign

boolean

  • true

  • false

false

设置扩展GRE头R bit为0。需要租户下的全网设备都已升级到R22C10及以上版本,否则会导致业务中断。当已有设备上线后,更新此开关,会导致短暂的业务中断。

false

extUdpHeaderSign

boolean

  • true

  • false

false

设置报文是否封装额外的UDP报文头。需要租户下的全网设备都已升级到R22C10及以上版本,否则会导致业务中断。当已有设备上线后,更新此开关,会导致短暂的业务中断。

false

srcPort

int32

[1024-65535]

4755

设置封装UDP报文头的源端口,extUdpHeaderSign为true时必须配置。

4755

destPort

int32

[1024-65535]

4755

设置封装UDP报文头的目的端口,extUdpHeaderSign为true时必须配置。

4755

表18 LinkDetectIntervalConfig对象的参数列表

参数名称

必选

类型

参数值域

默认值

参数说明

参数示例

enable

boolean

  • true

  • false

false

自定义检测间隔的使能开关。默认为false。当enable为false时,interval配置不生效。

false

interval

int32

[0-30]

-

南向接入链路检测的间隔,单位:分钟,取值范围0-30。

-

请求示例

HTTP的示例
PUT /controller/campus/v1/sdwan/net/network-orchestration-resources HTTP/1.1
Host: 192.168.1.125:18002
Content-Type: application/json
Accept: application/json
Accept-Language: en-US
X-ACCESS-TOKEN: x-yyyyyy
{
	"bgpAsNum" : 65001,
	"communityPool" : [1,2],
	"interlinkProtocolType" : "ospf",
	"communityPoolStatus" : 1,
	"siteScale" : "1000+",
	"dsvpnIPpool" : ["10.1.0.0/16","10.2.0.0/16"],
	"evpnIPpool" : ["10.1.0.0/16","10.2.0.0/16"],
	"innerTunnelIPpool" : ["10.1.0.0/16","10.2.0.0/16"],
	"interConnectIPpool" : "192.168.1.0/26",
	"evpnIpv6Pool" : ["2100::/96","2200::/96"],
	"innerTunnelIpv6Pool" : ["fd00::/96","fd10::/96"],
	"interConnectIpv6Pool" : "fd01::/96",
	"linkLocalIPV6pool" : "fe80::/96",
	"enableDelayTime" : false,
	"delayTime" : 50,
	"unsecurePktDiscardEnable" : false,
	"enableBgpKeepaliveTime" : false,
	"bgpKeepaliveTime" : 720,
	"transportNetworks" : [
		{
			"id" : "00000000-0000-0000-0000-000000000000",
			"name" : "mpls1",
			"routingDomain" : "mpls",
			"description" : "a mpls link",
			"priority" : 1
		}
	],
	"routingDomain" : [
		{
			"name" : "mpls1",
			"ipsecEncryption" : true,
			"isMspRD" : true
		}
	],
	"ipsecEncryptionParameter" : {
		"authenticationAlgorithm" : "SHA2_256",
		"encrptionAlgorithm" : "AES128",
		"lifeTime" : 1440,
		"preSharedKey" : "",
		"dhGroup" : "group19",
		"antiReplayEnable" : false,
		"antiReplayWindow" : 1024
	},
	"defaultMngInterfaceConfig" : {
		"cleanDefaultMngInterfaceConfig" : false
	},
	"linkQualityDetectionParameter" : {
		"enable" : true,
		"interval" : 100,
		"retryTimes" : 6,
		"priority" : 5
	},
	"trafficSteeringPolicyPeriodConfig" : {
		"enable" : true,
		"switchingPeriod" : 100,
		"statisticsPeriod" : 100,
		"flappingSuppression" : 100,
		"enableFlappingSuppressionEnhanced" : false,
		"symmetricForward" : true,
		"bandwidthUtilizationEnable" : true,
		"maxBandwidthUtilization" : 95,
		"sameTnFirst" : false,
		"siteIdSmallerFirst" : false,
		"basedRulesVo" : {
			"tnpPriorityEnable" : true,
			"basedTnpPriorityVo" : {
				"mode" : "larger",
				"priority" : 1
			},
			"tnpRoleEnable" : true,
			"basedRoleVo" : {
				"mode" : "hub",
				"priority" : 2
			},
			"tnpBandwidthEnable" : true,
			"basedBandwidthVo" : {
				"mode" : "smaller",
				"priority" : 3
			}
		}
	},
	"provisionUrlParameter" : {
		"encryptUrlEnable" : false,
		"encryptSensitiveParameters" : false,
		"oldDevceiVersionEnable" : false,
		"encryptionKey" : "12345abc",
		"validityPeriod" : 7,
		"urlWebInfoEnable" : false,
		"urlWebInfo" : {
			"webUser" : "abcd1234",
			"webPassword" : "Example@123"
		}
	},
	"portConfiguration" : {
		"cusPortConfigEnable" : true,
		"dtlsServerPort" : 55100,
		"stunServerPort" : 3478,
		"connectionDefaultPort" : {
			"connectPortEnable" : true,
			"srcPort" : 4501,
			"portNum" : 0,
			"portStep" : 10
		}
	},
	"dataPackageFormat" : {
		"extFormatSign" : false,
		"extUdpHeaderSign" : false,
		"srcPort" : 4755,
		"destPort" : 4755
	},
	"linkDetectIntervalConfig" : {
		"enable" : false,
		"interval" : ""
	}
}

响应参数

返回状态码为200:接口调用成功,响应体参考NetworkOrchestrationResourcesResponse。

NetworkOrchestrationResourcesResponse对象的参数列表,详细请参见表1

返回状态码为400:校验异常。

详细信息请参见实际响应消息体。

返回状态码为500:内部错误。

详细信息请参见实际响应消息体。

响应示例

返回状态码为200:接口调用成功,响应体参考NetworkOrchestrationResourcesResponse。

HTTP/1.1 200 OK
Date: Sun,16 Feb 2025 10:00:00 GMT
Server: example-server
Content-Type: application/json;charset=UTF-8
Content-Length: 250
Connection: keep-alive
{
	"errcode" : "0",
	"errmsg" : "",
	"data" : {
		"vpnType" : "bgp-evpn",
		"networkOrchestrationResources" : {
			"bgpAsNum" : 65001,
			"communityPool" : [1,2],
			"interlinkProtocolType" : "ospf",
			"communityPoolStatus" : 1,
			"siteScale" : "1000+",
			"dsvpnIPpool" : ["10.1.0.0/16","10.2.0.0/16"],
			"evpnIPpool" : ["10.1.0.0/16","10.2.0.0/16"],
			"innerTunnelIPpool" : ["10.1.0.0/16","10.2.0.0/16"],
			"interConnectIPpool" : "192.168.1.0/26",
			"evpnIpv6Pool" : ["2100::/96","2200::/96"],
			"innerTunnelIpv6Pool" : ["fd00::/96","fd10::/96"],
			"interConnectIpv6Pool" : "fd01::/96",
			"linkLocalIPV6pool" : "fe80::/96",
			"enableDelayTime" : false,
			"delayTime" : 50,
			"unsecurePktDiscardEnable" : false,
			"enableBgpKeepaliveTime" : false,
			"bgpKeepaliveTime" : 720,
			"transportNetworks" : [
				{
					"id" : "00000000-0000-0000-0000-000000000000",
					"name" : "mpls1",
					"routingDomain" : "mpls",
					"description" : "a mpls link",
					"priority" : 1
				}
			],
			"routingDomain" : [
				{
					"name" : "mpls1",
					"ipsecEncryption" : true,
					"isMspRD" : true
				}
			],
			"ipsecEncryptionParameter" : {
				"authenticationAlgorithm" : "SHA2_256",
				"encrptionAlgorithm" : "AES128",
				"lifeTime" : 1440,
				"preSharedKey" : "",
				"dhGroup" : "group19",
				"antiReplayEnable" : false,
				"antiReplayWindow" : 1024
			},
			"defaultMngInterfaceConfig" : {
				"cleanDefaultMngInterfaceConfig" : false
			},
			"linkQualityDetectionParameter" : {
				"enable" : true,
				"interval" : 100,
				"retryTimes" : 6,
				"priority" : 5
			},
			"trafficSteeringPolicyPeriodConfig" : {
				"enable" : true,
				"switchingPeriod" : 100,
				"statisticsPeriod" : 100,
				"flappingSuppression" : 100,
				"enableFlappingSuppressionEnhanced" : false,
				"symmetricForward" : true,
				"bandwidthUtilizationEnable" : true,
				"maxBandwidthUtilization" : 95,
				"sameTnFirst" : false,
				"siteIdSmallerFirst" : false,
				"basedRulesVo" : {
					"tnpPriorityEnable" : true,
					"basedTnpPriorityVo" : {
						"mode" : "larger",
						"priority" : 1
					},
					"tnpRoleEnable" : true,
					"basedRoleVo" : {
						"mode" : "hub",
						"priority" : 2
					},
					"tnpBandwidthEnable" : true,
					"basedBandwidthVo" : {
						"mode" : "smaller",
						"priority" : 3
					}
				}
			},
			"provisionUrlParameter" : {
				"encryptUrlEnable" : false,
				"encryptSensitiveParameters" : false,
				"oldDevceiVersionEnable" : false,
				"encryptionKey" : "12345abc",
				"validityPeriod" : 7,
				"urlWebInfoEnable" : false,
				"urlWebInfo" : {
					"webUser" : "abcd1234",
					"webPassword" : "Example@123"
				}
			},
			"portConfiguration" : {
				"cusPortConfigEnable" : true,
				"dtlsServerPort" : 55100,
				"stunServerPort" : 3478,
				"connectionDefaultPort" : {
					"connectPortEnable" : true,
					"srcPort" : 4501,
					"portNum" : 0,
					"portStep" : 10
				}
			},
			"dataPackageFormat" : {
				"extFormatSign" : false,
				"extUdpHeaderSign" : false,
				"srcPort" : 4755,
				"destPort" : 4755
			},
			"linkDetectIntervalConfig" : {
				"enable" : false,
				"interval" : ""
			}
		}
	}
}

返回状态码为400:校验异常。

HTTP/1.1 400 Bad Request
Date: Sun,16 Feb 2025 10:00:00 GMT
Server: example-server
Content-Type: application/json;charset=UTF-8
Content-Length: 250
Connection: keep-alive

返回状态码为500:内部错误。

HTTP/1.1 500 Internal Server Error
Date: Sun,16 Feb 2025 10:00:00 GMT
Server: example-server
Content-Type: application/json;charset=UTF-8
Content-Length: 250
Connection: keep-alive
提示

您即将访问非华为云网站,请注意账号财产安全

文档反馈

文档反馈

意见反馈

0/500

标记内容

同时提交标记内容