AssociateSecurityGroups
Last updated: 2019-11-29 19:10:10
Contents:
1. API Description
Domain name for API request: cdb.tencentcloudapi.com.
This API (AssociateSecurityGroups) is used to bind a security group to 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: AssociateSecurityGroups |
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 Bind a security group to cloud resources in batch
Input example
https://cdb.tencentcloudapi.com/?Action=AssociateSecurityGroups
&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.