Queries the security groups that are referencing specific security groups. When you call this operation, you can specify SecurityGroupId.
Operation description
When you call this operation, take note of the following items:
- A security group can be referenced by the inbound or outbound rules of other security groups.
- Up to 100 entries can be returned each time.
- If a security group cannot be deleted by calling the DeleteSecurityGroup operation, you can call the DescribeSecurityGroupReferences operation to check whether the security group is referenced by the rules of other security groups. If the security group is referenced by the rules of other security groups, you must remove the reference before you can delete the security group.
Debugging
Authorization information
There is currently no authorization information disclosed in the API.
Request parameters
Parameter | Type | Required | Description | Example |
---|---|---|---|---|
RegionId | string | Yes | The region ID of the security group. | cn-hangzhou |
SecurityGroupId | array | Yes | The IDs of N security groups that you want to query. Valid values of N: 1 to 10. | |
string | Yes | The ID of security group N that you want to query. Valid values of N: 1 to 10. | sg-bp14vtedjtobkvi**** |
Response parameters
Examples
Sample success responses
JSON
format
{
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
"SecurityGroupReferences": {
"SecurityGroupReference": [
{
"SecurityGroupId": "sg-bp67acfmxazb4p****",
"ReferencingSecurityGroups": {
"ReferencingSecurityGroup": [
{
"SecurityGroupId": "sg-bp67acfmxazb4j****",
"AliUid": "123456****"
}
]
}
}
]
}
}
Error codes
HTTP status code | Error code | Error message | Description |
---|---|---|---|
400 | InvalidSecurityGroupId.Malformed | The specified parameter SecurityGroupId is essential and size should less than 10 | The SecurityGroupId.N parameter is required and the value of N cannot exceed 10. |
404 | InvalidRegionId.NotFound | The RegionId provided does not exist in our records. | The RegionId provided does not exist |
404 | InvalidSecurityGroupId.NotFound | The SecurityGroupId provided does not exist in our records. | The specified security group does not exist in this account. Check whether the security group ID is correct. |
For a list of error codes, visit the Service error codes.
Change history
Change time | Summary of changes | Operation |
---|
No change history