All Products
Search
Document Center

Database Autonomy Service:ModifySecurityIPGroupRelation

Last Updated:Nov 21, 2025

Attaches or detaches a cross-product whitelist template.

Operation description

  • Use the latest version of the Alibaba Cloud or DAS software development kit (SDK).

  • When you use the SDK to call the DAS service, set the region to cn-shanghai.

  • For more information about the supported database instances, see Overview of features for SQL Insight and Audit.

  • The SQL Insight and Audit (Legacy) feature is enabled for the destination database instance. For more information about how to enable this feature, see Enable SQL Insight and Audit.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request syntax

POST  HTTP/1.1

Request parameters

Parameter

Type

Required

Description

Example

RegionName

string

Yes

The region ID.

cn-shanghai

InstanceId

string

Yes

The database instance ID.

pc-bp1u5mas9exx7****

GlobalSecurityGroupId

string

Yes

The ID of the IP address whitelist template.

g-ggh7qvrrwikyxe****

Response elements

Element

Type

Description

Example

object

Code

string

The status code.

200

Data

object

The returned data.

GlobalSecurityIPGroupRel

array<object>

The information about the cross-product IP address whitelist template that is attached to the instance.

object

RegionId

string

The region ID.

cn-shanghai

GlobalIgName

string

The name of the IP address whitelist template. The name must meet the following requirements:

  • It must consist of lowercase letters, digits, and underscores (_).

  • It must start with a letter and end with a letter or a digit.

  • It must be 2 to 120 characters in length.

saas_jump

GlobalSecurityGroupId

string

The ID of the IP address whitelist template.

g-v8kwereyd6u7kx****

GIpList

string

The IP addresses in the whitelist template.

Note

Separate multiple IP addresses with commas (,). A maximum of 1,000 IP addresses or CIDR blocks can be added to all IP address whitelists.

192.168.0.1,192.168.100.0/24

InstanceId

string

The instance ID.

rm-2ze1jdv45i7l6****

Message

string

The returned message.

Note

If the request is successful, Successful is returned. If the request fails, an error message, such as an error code, is returned.

Successful

RequestId

string

The request ID.

840F51F7-9C01-538D-94F6-AE712905****

Success

string

Indicates whether the request was successful. Valid values:

  • true: The request was successful.

  • false: The request failed.

true

Examples

Success response

JSON format

{
  "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"
}

Error codes

HTTP status code

Error code

Error message

Description

400

InvalidParams

The request parameters are invalid.

403

NoPermission

You are not authorized to do this action.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.