本接口用于列出外网防火墙已关联的所有实例资源。
下表列出了接口特定的请求参数以及公共请求参数 Action 和 Version。 其他公共参数，请参见公共参数。
参数 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
Action | String | 是 | DescribeSecurityGroupAssociationInstances | 公共参数。该参数表示接口名称。取值：DescribeSecurityGroupAssociationInstances。 |
Version | String | 是 | 2021-04-30 | 公共参数。该参数表示接口版本。取值：2021-04-30。 |
group_identity | String | 是 | veew-sg-2551200256591525**** | 外网防火墙的 ID。您可以通过 DescribeSecurityGroups 接口查询外网防火墙的 ID。 |
参数 | 类型 | 示例值 | 描述 |
|---|---|---|---|
total | Integer | 1 | 外网防火墙绑定的实例的数量。 |
bind_instances | 请参见返回示例 | 外网防火墙绑定的实例的列表。 |
GET https://veenedge.volcengineapi.com/?Action=DescribeSecurityGroupAssociationInstances&Version=2021-04-30 &group_identity=veew-sg-2551200256591525**** &<其他公共参数>
{ "ResponseMetadata": { "RequestId": "20230522145454AC76C4F2D7D6FFBD****", "Action": "DescribeSecurityGroupAssociationInstances", "Version": "2021-04-30", "Service": "veenedge", "Region": "cn-north-1" }, "Result": { "bind_instances": [ { "instance_identity": "veen8580100583220550****", "instance_name": "", "vpc_identity": "vpc-8zbcbc****", "vpc_name": "**电信01-默认VPC", "cidr": "172.**.**.64/26", "network": { "internal_interface": { "ip_addr": "172.**.**.73", "mask": "26", "ip6_addr": "", "mask6": "", "ips": [ { "addr": "172.**.**.73", "mask": "26", "isp": "", "ip_version": "ipv4" } ], "mac_addr": "0a:58:ac:**:**:49", "bandwidth_peak": "500" }, "external_interface": { "ip_addr": "115.**.**.5", "mask": "24", "ip6_addr": "", "mask6": "", "ips": [ { "addr": "115.**.**.5", "mask": "24", "isp": "CTCC", "ip_version": "ipv4" } ], "mac_addr": "0a:58:73:**:**:05", "bandwidth_peak": "5" }, "external_interfaces": [ { "ip_addr": "115.**.**.5", "mask": "24", "ip6_addr": "", "mask6": "", "ips": [ { "addr": "115.**.**.5", "mask": "24", "isp": "CTCC", "ip_version": "ipv4" } ], "mac_addr": "0a:58:73:**:*:05", "bandwidth_peak": "5" } ] }, "instance_status": "running", "bind_time": 1684738398, "bind_num": 2, "bind_status": 2, "bindable": false, "sriov": false } ], "total": 1 } }
如果响应正文中包含 Error 字段，则表示 API 请求失败。关于错误码的更多信息，参见错误码。