文档

ModifySslVpnServer - 修改SSL-VPN服务端的配置信息

更新时间:

调用ModifySslVpnServer接口修改SSL-VPN服务端的配置信息。

接口说明

  • 如果您需要为 SSL 服务端开启双因子认证功能,请先确保 VPN 网关实例支持该功能,您可能需要升级 VPN 网关实例。更多信息,请参见SSL-VPN 双因子认证支持 IDaaS EIAM 2.0

  • 当只修改 SSL-VPN 服务端 Name 信息时该接口为同步接口,如果还修改了除 Name 之外的配置,该接口为异步接口。

  • ModifySslVpnServer 接口为异步接口时,即系统先返回一个请求 ID,但该 SSL-VPN 服务端的配置信息尚未修改成功,系统后台的修改任务仍在进行。您可以调用 DescribeVpnGateway 接口查询 SSL-VPN 服务端关联的 VPN 网关实例的状态,来确认 SSL-VPN 服务端配置信息的修改状态:

    • 当 VPN 网关实例处于 updating 状态时,表示 SSL-VPN 服务端的配置信息正在修改中。
    • 当 VPN 网关实例处于 active 状态时,表示 SSL-VPN 服务端的配置信息修改成功。
  • ModifySslVpnServer 接口不支持在同一 VPN 网关下并发修改 SSL-VPN 服务端的配置信息。

调试

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

授权信息

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

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

请求参数

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

客户端 Token,用于保证请求的幂等性。

从您的客户端生成一个参数值,确保不同请求间该参数值唯一。ClientToken 只支持 ASCII 字符。

说明 若您未指定,则系统自动使用 API 请求的 RequestId 作为 ClientToken 标识。每次 API 请求的 RequestId 不一样。
02fb3da4-130e-11e9-8e44-0016e04115b
RegionIdstring

VPN 网关所在的地域 ID。

您可以通过调用 DescribeRegions 接口获取地域 ID。

cn-hangzhou
SslVpnServerIdstring

SSL-VPN 服务端实例 ID。

vss-bp18q7hzj6largv4v****
Namestring

SSL-VPN 服务端的名称。

长度为 1~100 个字符,不能以http://https://开头。

test
ClientIpPoolstring

客户端 IP 地址池。

10.30.30.0/24
LocalSubnetstring

本地客户端的网段。

10.20.20.0/24
Protostring

SSL-VPN 服务端所使用的协议,取值:

  • TCP(默认值):TCP 协议。

  • UDP:UDP 协议。

UDP
Cipherstring

SSL-VPN 使用的加密算法,取值:

  • AES-128-CBC(默认值):AES-128-CBC 算法。

  • AES-192-CBC:AES-192-CBC 算法。

  • AES-256-CBC:AES-256-CBC 算法。

  • none:不使用加密算法。

AES-128-CBC
Portinteger

SSL-VPN 服务端所使用的端口。端口取值范围:1~65535。默认值:1194

不支持使用以下端口:222222222229000900190027505804435368123451045605004500

1194
Compressboolean

指定是否对通信进行压缩, 取值:

  • true(默认值):对通信进行压缩。

  • false:对通信不进行压缩。

true
EnableMultiFactorAuthboolean

是否开启双因子认证。如果您选择开启双因子认证功能,您还需要输入 IDaaS EIAM 实例 ID 和 IDaaS 应用 ID。取值:

  • true:开启。

  • false:不开启。

说明
  • 如果您是首次使用双因子认证功能,请先完成授权后再创建 SSL 服务端。
  • IDaaS EIAM 1.0 实例不再支持新购。如果您的阿里云账号下存在 IDaaS EIAM 1.0 实例,开启双因子认证功能后,依旧支持绑定 IDaaS EIAM 1.0 实例。如果您的阿里云账号下不存在 IDaaS EIAM 1.0 实例,开启双因子认证功能后,仅支持绑定 IDaaS EIAM 2.0 实例。
  • false
    IDaaSInstanceIdstring

    IDaaS EIAM 实例 ID。

    idaas-cn-hangzhou-****
    IDaaSRegionIdstring

    IDaaS EIAM 实例所属地域 ID。

    cn-hangzhou
    IDaaSApplicationIdstring

    IDaaS 应用 ID。

    • 如果您绑定的是 IDaaS EIAM 2.0 实例,需输入 IDaaS 应用 ID。
    • 如果您绑定的是 IDaaS EIAM 1.0 实例,无需输入 IDaaS 应用 ID。
    app_my6g4qmvnwxzj2f****

    返回参数

    名称类型描述示例值
    object

    返回结果。

    InternetIpstring

    公网 IP。

    47.98.XX.XX
    IDaaSInstanceIdstring

    IDaaS EIAM 实例 ID。

    idaas-cn-hangzhou-****
    CreateTimelong

    SSL-VPN 服务端的创建时间。

    1492753580000
    VpnGatewayIdstring

    VPN 网关实例 ID。

    vpn-bp1q8bgx4xnkm2ogj****
    Compressboolean

    是否压缩通信。

    false
    Portinteger

    SSL-VPN 服务端的端口。

    1194
    LocalSubnetstring

    本地客户端地址段。

    10.20.20.0/24
    RegionIdstring

    SSL-VPN 服务端的地域 ID。

    cn-hangzhou
    Cipherstring

    使用的加密算法。

    AES-128-CBC
    RequestIdstring

    请求 ID。

    DF11D6F6-E35A-41C3-9B20-6FC8A901FE65
    Connectionsinteger

    当前连接数。

    0
    SslVpnServerIdstring

    SSL-VPN 服务端的 ID。

    vss-bp18q7hzj6largv4v****
    MaxConnectionsinteger

    最大连接数。

    5
    Namestring

    SSL-VPN 服务端的名称。

    test
    EnableMultiFactorAuthboolean

    是否开启了双因子认证。

    • true:已开启。

    • false(默认值):未开启。

    false
    ClientIpPoolstring

    客户端 IP 地址池。

    10.30.30.0/24
    Protostring

    SSL-VPN 服务端使用的协议。

    UDP
    ResourceGroupIdstring

    SSL-VPN 服务端所属的资源组 ID。

    SSL-VPN 服务端与其关联的 VPN 网关实例的资源组相同。您可以调用 ListResourceGroups 接口查询资源组信息。

    rg-acfmzs372yg****
    IDaaSApplicationIdstring

    IDaaS 应用 ID。

    app_my6g4qmvnwxzj2f****
    IDaaSInstanceVersionstring

    IDaaS EIAM 实例的版本。

    • 仅当 SSL 服务端绑定的是 IDaaS EIAM 2.0 实例,系统才会返回该参数。仅取值:EIAM 2.0
    • 如果 SSL 服务端绑定的是 IDaaS EIAM 1.0 实例,系统不会返回该参数。
    EIAM 2.0

    示例

    正常返回示例

    JSON格式

    {
      "InternetIp": "47.98.XX.XX",
      "IDaaSInstanceId": "idaas-cn-hangzhou-****",
      "CreateTime": 1492753580000,
      "VpnGatewayId": "vpn-bp1q8bgx4xnkm2ogj****",
      "Compress": false,
      "Port": 1194,
      "LocalSubnet": "10.20.20.0/24",
      "RegionId": "cn-hangzhou",
      "Cipher": "AES-128-CBC",
      "RequestId": "DF11D6F6-E35A-41C3-9B20-6FC8A901FE65",
      "Connections": 0,
      "SslVpnServerId": "vss-bp18q7hzj6largv4v****",
      "MaxConnections": 5,
      "Name": "test",
      "EnableMultiFactorAuth": false,
      "ClientIpPool": "10.30.30.0/24",
      "Proto": "UDP",
      "ResourceGroupId": "rg-acfmzs372yg****",
      "IDaaSApplicationId": "app_my6g4qmvnwxzj2f****",
      "IDaaSInstanceVersion": "EIAM 2.0"
    }

    错误码

    HTTP status code错误码错误信息描述
    400InvalidNameThe name is not valid该名称格式不合法。
    400VpnGateway.ConfiguringThe specified service is configuring.服务正在配置中,请您稍后再试。
    400VpnGateway.FinancialLockedThe specified service is financial locked.该服务已欠费,请您先充值再操作。
    400IpConflictClient IP pool conflict with local IP range.客户端IP池与本地IP范围冲突。
    400IpConflictClient IP pool conflict with other SSL VPN server in the same VPC.客户端IP池与同一VPC中的其他SSL VPN服务器冲突。
    400SslVpnServer.AddRouteErrorAdd route error whose destination is client IP pool, please check vpc route entry and relevant quota.添加指向客户端网段的路由失败,请查看VPC路由条目及相关配额。
    400ClientIpPool.NetmaskInvalidThe netmask length of client IP pool must be greater than or equal to 16 and less than or equal to 29.客户端 IP 池的网络掩码长度必须大于等于 16 且小于等于 29。
    400ClientIpPool.SubnetInvalidThe specified client IP pool cannot be used.当前客户端网段不可用。
    400MissingParameter.IDaaSInstanceIdThe input parameter IDaaSInstanceId is mandatory when enable multi-factor authentication.启动双因子认证时请输入IDaaSInstanceId参数。
    400OperationFailed.GetIDaaSInfoFailed to get secret key from your IDaaS instance.-
    400OperationFailed.NoRamPermissionVpn Service has no permission to operate your IDaaS instances.Vpn服务没有权限操作您的IDaaS实例
    400OperationUnsupported.NotSupportMultiFactorAuthCurrent version of the VPN does not support multi-factor authentication.-
    400SystemBusyThe system is busy. Please try again later.当前系统繁忙,请稍后重试。
    400SslVpnServerPort.IllegalThe server port is not in the range of [1-65535].SSL VPN 服务端端口号需要在[1-65535]之间。
    400EnableHaCheck.SslVpnServerClientCidrContainsVpcRouteDestSsl vpn client cidr contains vpc route prefix. The vpc route prefix is %s.vpc路由表中存在路由的前缀%s被包含在ssl vpn 客户端 cidr 中。
    400InvalidInstanceId.NotFoundInstanceId is not found.物理专线实例ID不存在。
    400VpnRouteEntry.ConflictThe specified route entry has conflict.路由条目存在冲突。
    400IllegalParam.IDaaSApplicationIdThe specified IDaaS application Id is not illegal, the application instance needs to be created based on the dedicated SSL VPN template.指定的IDaaS应用实例ID不合法,应用实例需要基于专属SSL VPN的模板创建。
    400MissingParam.IDaaSApplicationIdThe input parameter IDaaSApplicationId is mandatory when enable multi-factor authentication.启动双因子认证时请输入IDaaSApplicationId参数。
    400SslVpnIDaaS2.NotSupportCurrent version of the VPN does not support IDaaS2.0.当前VPN实例版本不支持使用IDaaS2.0。
    400MissingParam.IDaaSRegionIdThe input parameter IDaaSRegionId is mandatory when enable multi-factor authentication.启动双因子认证时请输入IDaaSRegionId参数。
    403Forbbiden.SubUserUser not authorized to operate on the specified resource as your account is created by another user.您没有权限操作该资源,请您申请操作权限后再试。
    403ForbiddenUser not authorized to operate on the specified resource.您没有权限操作指定资源,请申请权限后再操作。
    404InvalidRegionId.NotFoundThe specified region is not found during access authentication.接入认证时未找到指定区域。
    404InvalidIDaaSInstanceId.NotFoundThe specified IDaaS instance ID does not exist.指定的IDaaS实例ID不存在
    404InvalidIDaaSApplicationId.NotFoundThe specified IDaaS application Id does not exist.指定的IDaaS应用实例ID不存在。

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

    变更历史

    变更时间变更内容概要操作
    2024-05-10OpenAPI 错误码发生变更、OpenAPI 入参发生变更、OpenAPI 返回结构发生变更查看变更详情
    2024-01-04OpenAPI 错误码发生变更查看变更详情
    2023-10-19OpenAPI 描述信息更新、OpenAPI 去除了 deprecated 标记、OpenAPI 错误码发生变更、OpenAPI 返回结构发生变更查看变更详情
    2023-05-30OpenAPI 错误码发生变更查看变更详情