开发者社区 问答 正文

API参考 - API参考 -  安全管理 -ModifySecurityIps



描述


该接口用于修改允许访问实例的IP名单。接口调用必须满足以下条件,否则将失败:

  • 实例状态为运行中。
  • 实例没有被锁定。


请求参数

[tr=rgb(51, 205, 229)][td]名称 类型是否必须描述ActionString是系统规定参数,取值为ModifySecurityIps。DBInstanceIdString是实例名。SecurityIpsString否IP白名单分组下的IP列表,最多1000个以逗号隔开,格式如下:
  • 0.0.0.0/0,10.23.12.24(IP);
  • 10.23.12.24/24(CIDR模式,无类域间路由,/24表示了地址中前缀的长度,范围[1,32])。
DBInstanceIPArrayNameString否IP白名单分组的名字,如果不传默认操作“Default”分组。备注:1个实例最多支持50个白名单分组。DBInstanceIPArrayAttributeString否默认为空。用于区分不同的属性值,控制台不显示带有“hidden”标签的分组。ModifyModeString否修改方式,取值如下:
  • Cover:默认值,覆盖原白名单。
  • Append:追加白名单
  • Delete:删除该白名单


返回参数

[tr=rgb(51, 205, 229)][td]名称 类型描述RequestIdString详见公共参数。TaskIdString任务ID。

请求示例



https: //rds.aliyuncs.com/?Action=ModifySecurityIps &DBInstanceId=rdsaiiabnaiiabn &SecurityIps=192.168.1.2 &<公共请求参数>

返回示例


XML格式

<ModifySecurityIpsResponse> <RequestId>65BDA532-28AF-4122-AA39-B382721EEE64 </RequestId> </ModifySecurityIpsResponse>
JSON格式

{"RequestId": " 65BDA532-28AF-4122-AA39-B382721EEE64"}

展开
收起
梨好橙 2018-09-14 00:46:50 1598 分享 版权
阿里云 AI 助理回答

要修改允许访问实例的IP白名单,您需要通过调用ModifySecurityIps接口来完成此操作。在进行接口调用时,请确保您的实例状态为运行中且未被锁定。以下是调用该接口所需关注的请求参数及说明:

  1. Action:

    • 类型: String
    • 是否必须: 是
    • 描述: 系统规定参数,固定取值为 ModifySecurityIps
  2. DBInstanceId:

    • 类型: String
    • 是否必须: 是
    • 描述: 实例ID,标识要修改白名单的具体数据库实例。
  3. SecurityIps:

    • 类型: String
    • 是否必须: 否
    • 描述: IP白名单分组下的IP列表,最多支持1000个条目,以逗号分隔。支持IP地址(如:10.23.12.24)和CIDR格式(如:10.23.12.24/24),其中CIDR模式中的前缀长度范围为1到32。
  4. DBInstanceIPArrayName:

    • 类型: String
    • 是否必须: 否
    • 描述: 需要修改的IP白名单分组名称,默认操作“Default”分组。一个实例最多可支持50个白名单分组。
  5. DBInstanceIPArrayAttribute:

    • 类型: String
    • 是否必须: 否
    • 描述: 默认为空字符串。用于区分不同的属性值,带有"hidden"标签的分组不会在控制台显示。
  6. ModifyMode:

    • 类型: String
    • 是否必须: 否
    • 描述: 修改方式,可选值包括:
      • Cover(默认值):覆盖原白名单。
      • Append:追加白名单,若有重复则报错。
      • Delete:删除指定的白名单。

返回参数 包括: - RequestId: 用于标识请求的唯一ID。 - TaskId: 任务ID,可用于查询任务执行状态。

请求示例:

https://rds.aliyuncs.com/?Action=ModifySecurityIps

请根据实际需求设置相应的参数值,并确保您已具备调用此接口所需的权限。在执行操作前,建议先在OpenAPI Explorer中调试,以验证配置并获取SDK代码示例,这将帮助您更安全、便捷地完成IP白名单的修改。

有帮助
无帮助
AI 助理回答生成答案可能存在不准确,仅供参考
0 条回答
写回答
取消 提交回答