全部产品
Search
文档中心

智能接入网关:ModifySagPortRole - 修改端口角色

更新时间:Mar 29, 2024

调用ModifySagPortRole修改端口角色。

接口说明

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

调试

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

授权信息

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

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
smartag:ModifySagPortRoleWrite
  • SmartAccessGateway
    acs:smartag:{#regionId}:{#accountId}:smartag/{#SmartAGId}

请求参数

名称类型必填描述示例值
RegionIdstring

智能接入网关实例地域 ID。 您可以调用 DescribeRegions 接口查询智能接入网关支持的地域以及对应的地域 ID。

cn-shanghai
SmartAGIdstring

智能接入网关实例 ID。

sag-whfn****
SmartAGSnstring

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

sag32a30****
PortNamestring

端口名称。

0
Rolestring

端口角色。取值:

  • 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
    RequestIdstring

    请求 ID。

    3200E8A3-563F-4FFC-8BDB-0F1263FA69E8

    示例

    正常返回示例

    JSON格式

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

    错误码

    HTTP status code错误码错误信息描述
    400Sag.PortNotExistThe specified port does not exist.当前端口不存在。
    400Sag.HaPortExistThe specified port is used by the HA configuration.当前端口被HA占用。
    400Sag.PortRoleLimitThe maximum number of ports with the specified role is exceeded.当前端口角色超过限制。
    400Sag.PortMgtErrorThe role of a management port cannot be changed.管理口角色不能修改。
    400Sag.PortRoleInvalidThe port role is invalid.设备端口角色不正确。
    400ConfigUnsynchronizedThe network configuration is not synchronized.网络配置未同步。
    400IrRuleOutboundPortInUse.%sThe specified port %s is in use as a outbound port of intelligent routing rule, please free it first.-

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