调用ModifySagPortRole修改端口角色_智能接入网关(SAG)-阿里云帮助中心

调用ModifySagPortRole修改端口角色。

接口说明

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

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作	访问级别	资源类型	条件关键字	关联操作
smartag:ModifySagPortRole	Write	SmartAccessGateway acs:smartag:{#regionId}:{#accountId}:smartag/{#SmartAGId}	无	无

名称	类型	必填	描述	示例值
RegionId	string	是	智能接入网关实例地域 ID。您可以调用 DescribeRegions 接口查询智能接入网关支持的地域以及对应的地域 ID。	cn-shanghai
SmartAGId	string	是	智能接入网关实例 ID。	sag-whfn****
SmartAGSn	string	是	绑定的智能接入网关设备序列号。	sag32a30****
PortName	string	是	端口名称。	0
Role	string	是	端口角色。取值： 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 口分配。	NONE

名称	类型	描述	示例值
	object
RequestId	string	请求 ID。	3200E8A3-563F-4FFC-8BDB-0F1263FA69E8

正常返回示例

JSON格式

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

HTTP status code	错误码	错误信息	描述
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.	管理口角色不能修改。
400	Sag.PortRoleInvalid	The port role is invalid.	设备端口角色不正确。
400	ConfigUnsynchronized	The network configuration is not synchronized.	网络配置未同步。
400	IrRuleOutboundPortInUse.%s	The specified port %s is in use as a outbound port of intelligent routing rule, please free it first.	-

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