调用ModifySecurityIPGroupRelation为数据库实例绑定或解绑IP白名单模板-数据库自治服务-阿里云

绑定/解绑用户跨产品白名单模板

接口说明

使用阿里云或 DAS 的 SDK 时，建议使用最新版本。
在使用 SDK 调用 DAS 服务时，需要将地域指定为 cn-shanghai。
目前支持的数据库实例请参见 SQL 洞察和审计的功能概览。
目标数据库实例已开启 SQL 洞察和审计（旧版）功能，开启方法请参见开启 SQL 洞察和审计。

调试

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

调试

授权信息

当前API暂无授权信息透出。

请求语法

POST  HTTP/1.1

请求参数

名称	类型	必填	描述	示例值
RegionName	string	是	地域 ID。	cn-shanghai
InstanceId	string	是	数据库实例 ID。	pc-bp1u5mas9exx7****
GlobalSecurityGroupId	string	是	IP 白名单模板 ID。	g-ggh7qvrrwikyxe****

返回参数

名称	类型	描述	示例值
	object	Schema of Response
Code	string	状态码。	200
Data	object	ListResult
GlobalSecurityIPGroupRel	array<object>	跨产品 IP 白名单模板绑定信息。
	object
RegionId	string	地域 ID。	cn-shanghai
GlobalIgName	string	IP 白名单模板名称。IP 白名单模板名称需满足如下要求：由小写字母、数字、下划线（_）组成。由字母开头、字母或数字结尾。长度为 2~120 个字符。	saas_jump
GlobalSecurityGroupId	string	IP 白名单模板 ID。	g-v8kwereyd6u7kx****
GIpList	string	白名单模板内的 IP 地址。说明多个 IP 地址需要用英文逗号隔开，所有 IP 白名单累积支持添加 1000 个 IP 地址或地址段。	192.168.0.1,192.168.100.0/24
InstanceId	string	实例 ID。	rm-2ze1jdv45i7l6****
Message	string	请求返回消息。说明请求成功时该参数返回 Successful，请求失败时会返回请求异常信息（如错误码等）。	Successful
RequestId	string	请求 ID。	840F51F7-9C01-538D-94F6-AE712905****
Success	string	请求是否执行成功： true：执行成功 false：执行失败	true

示例

正常返回示例

JSON格式

{
  "Code": "200",
  "Data": {
    "GlobalSecurityIPGroupRel": [
      {
        "RegionId": "cn-shanghai",
        "GlobalIgName": "saas_jump",
        "GlobalSecurityGroupId": "g-v8kwereyd6u7kx****",
        "GIpList": "192.168.0.1,192.168.100.0/24"
      }
    ],
    "InstanceId": "rm-2ze1jdv45i7l6****"
  },
  "Message": "Successful",
  "RequestId": "840F51F7-9C01-538D-94F6-AE712905****",
  "Success": "true"
}

错误码

HTTP status code	错误码	错误信息	描述
400	InvalidParams	The request parameters are invalid.	请求参数错误
403	NoPermission	You are not authorized to do this action.	没有权限执行该操作

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

变更历史

更多信息，参考变更详情。