Skip to Content
Private Network(UVPC)DescribeSecGroupResource

Get Security Group Bound Resources - DescribeSecGroupResource

Overview

Get Security Group Bound Resources

💡 Query the resources bound to a single security group (return resource details), support pagination query (paginate the bound resources).

Definition

Public Parameters

Parameter NameTypeDescription InformationRequired
ActionstringCorresponding API command name, the current API is DescribeSecGroupResource.Yes
PublicKeystringThe user’s public key can be obtained from ConsoleYes
SignaturestringUser signature generated based on public key and API command, see Signature AlgorithmYes

Request Parameters

Parameter NameTypeDescription InformationRequired
RegionstringRegion. See Region and Availability Zone ListYes
ProjectIdstringProject ID. Leave blank for the default project, sub-accounts must fill in. Please refer to GetProjectList APINo
SecGroupIdstringSecurity Group Resource ID.No
LimitintPagination query length. Default is 20.No
OffsetintPagination query starting position offset. Default is 0No

Response Field

Field NameTypeDescription InformationRequired
RetCodeintReturn status code. If it is 0, it means successful return. If it is not 0, it means failure.Yes
ActionstringOperation command name.Yes
MessagestringReturns an error message, providing detailed description when RetCode is non-zero.No
DataSetarray[SecGroupResourceInfo]Refer to SecGroupResourceInfo for details.Yes
TotalCountintTotal number of resources bound to the security groupNo

Data Model

SecGroupResourceInfo

Field NameTypeDescription InformationRequired
ZoneintAvailability ZoneNo
SubResourceNamestringThe name of the bound virtual network cardNo
SubResourceIdstringID of the virtual network card bound to the resourceNo
SubResourceTypestringThe type of the bound virtual network card, ‘uni’, virtual network card.No
NamestringNameNo
PrivateIpstringPrivate IPNo
ResourceIdstringResource IDNo
ResourceTypestringResource Type. “unatgw”, NAT Gateway; “uhost”, UHost; “upm”, Physical Cloud Host; “hadoophost”, Hadoop Node; “fortresshost”, Bastion Host; “udhost”, UDSet Host; “udockhost”, Container; “dbaudit”, Database Audit; “uni”, Virtual Network Interface.No
TagstringBusiness GroupNo

Example

Request Example

https://api.genesissai.com/?Action=DescribeSecGroupResource &Region=cn-zj &ProjectId=8 &VPCId=HyexAArD &SecGroupId.n=VTqSSEeQ &Limit=8 &Offset=9

Response Example

{ "Action": "DescribeSecGroupResourceResponse", "DataSet": [ { "CreateTime": "FoMZwgfr", "Name": "UwordIJs", "Remark": "QBoDnpRT", "Rule": [ { "Direction": "jNHxLDwL", "DstPort": "NpGQxxzK", "IPRange": "ucVuYjCx", "IPVersion": "rMVegzTz", "Priority": "jmnsFfZh", "ProtocolType": "jZBVvGxk", "Remark": "XCgCJCZq", "RuleAction": "rpnbLSKM", "RuleId": "UcATLSQb" } ], "SecGroupId": "QqLcgWZc", "Tag": "OjmPShak", "VPCId": "yuAobWcz" } ], "RetCode": 0, "TotalCount": 6 }