DisassociateSecurityGroups

Last updated: 2019-11-29 19:17:27

1. API Description

Domain name for API request: cdb.tencentcloudapi.com.

This API (DisassociateSecurityGroups) is used to unbind a security group from instances in batch.

A maximum of 100 requests can be initiated per second for this API.

Note: This API supports Finance regions. Since Finance regions and non-Finance regions are isolated and not interconnected. If the common parameter Region is a Finance region (such as ap-shanghai-fsi), you need to specify a domain name containing the Finance region that should be identical to the value of Region field, for example: cdb.ap-shanghai-fsi.tencentcloudapi.com.

2. Input Parameters

The following request parameter list only provides API request parameters and some common parameters.
| Parameter Name | Required | Type | Description |
|---------|---------|---------|---------|
| Action | Yes | String | Common parameter. The value used for this API: DisassociateSecurityGroups |
| Version | Yes | String | Common parameter. The value used for this API: 2017-03-20 |
| Region | Yes | String | Common parameter. For more information, please see the [list of regions]supported by the product. |
| SecurityGroupId | Yes | String | Security group ID. |
| InstanceIds.N | Yes | Array of String | Instance ID list, which is an array of one or more instance IDs. |

3. Output Parameters

Parameter Name Type Description
RequestId String The unique request ID, which is returned for each request. RequestId is required for locating a problem.

4. Error Codes

The following only lists the error codes related to the API business logic. For other error codes, see [Common Error Codes]

Error Code Description
InternalError.DatabaseAccessError Database's internal error.
InternalError.DfwError Security group operation error.
InternalError.ResourceNotMatch The resources do not match.
InvalidParameter Parameter error.

5. Example

Example 1 Unbind a security group from cloud resources in batch

Input example

https://cdb.tencentcloudapi.com/?Action=DisassociateSecurityGroups
&SecurityGroupId=sg-ajr1jzgj
&InstanceIds.0=cdb-eb2w7dto
&<Common request parameters>

Output example

{
  "Response": {
    "RequestId": "1a42feb9-82087f71-6a0031ac-699a92a8"
  }
}

6. Other Resources

Cloud API 3.0 comes with the following development tools to make it easier to call the API.