调用ModifySagPortRole修改端口角色。

说明 修改端口角色会删除当前端口关联的原角色配置数据。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String ModifySagPortRole

要执行的操作。

取值:ModifySagPortRole

PortName String 0

端口名称。

RegionId String cn-shanghai

智能接入网关实例地域ID。

Role String NONE

端口角色。取值:

  • NONE:端口未分配角色。
  • WAN:用于接入Internet的端口。智能接入网关设备5号端口默认为WAN口,支持DHCP client、PPPoE或静态IP接入方式。
  • LAN:用于接入本地PC或交换机的端口,支持DHCP server或静态IP接入方式。
  • ECC:用于接入专线的端口。
  • MGT:用于管理的端口。智能接入网关设备2号端口默认为独占管理口。
说明
  • 管理口独占模式下管理流量和业务流量分离,独占的管理口只能用于访问智能接入网关设备Web管理控制台,不能用于传输业务流量;且只可通过管理口访问智能接入网关设备Web管理控制台。
  • WAN口支持即插即用模式,第一个通过DHCP获取到IP地址且能够访问Internet的端口会被设置为WAN口;可在Web管理控制台修改WAN口分配。
SmartAGId String sag-whfn****

智能接入网关实例ID。

SmartAGSn String sag32a30****

绑定的智能接入网关设备序列号。

返回数据

名称 类型 示例值 描述
RequestId String 3200E8A3-563F-4FFC-8BDB-0F1263FA69E8

请求ID。

示例

请求示例

http(s)://smartag.cn-shanghai.aliyuncs.com/?Action=ModifySagPortRole
&PortName=0
&RegionId=cn-shanghai
&Role=NONE
&SmartAGId=sag-whfn****
&SmartAGSn=sag32a30****
&<公共请求参数>

正常返回示例

XML 格式

<ModifySagPortRoleResponse>
     <RequestId>3200E8A3-563F-4FFC-8BDB-0F1263FA69E8</RequestId>
</ModifySagPortRoleResponse>

JSON 格式

{
"RequestId":"3200E8A3-563F-4FFC-8BDB-0F1263FA69E8"
}

错误码

HttpCode 错误码 错误信息 描述
400 Sag.PortNotExist The specified port does not exist. 当前端口不存在
400 Sag.HaPortExist The specified port is used by the HA configuration. 当前端口被HA占用
400 Sag.PortRoleLimit The maximum number of ports with the specified role is exceeded. 当前端口角色超过限制。
400 Sag.PortMgtError The role of a management port cannot be changed. 管理口角色不能修改。

访问错误中心查看更多错误码。