列出所有已关联实例资源--边缘计算节点-火山引擎

文档中心

立即注册

导航

列出所有已关联实例资源

最近更新时间：2025.12.09 11:44:58首次发布时间：2022.02.25 18:58:31

本接口用于列出外网防火墙已关联的所有实例资源。

请求说明

请求方式：GET
请求地址：https://veenedge.volcengineapi.com/?Action=DescribeSecurityGroupAssociationInstances&Version=2021-04-30

请求参数

下表列出了接口特定的请求参数以及公共请求参数 Action 和 Version。其他公共参数，请参见公共参数。

Query

参数	类型	是否必选	示例值	描述
Action	String	是	`DescribeSecurityGroupAssociationInstances`	接口名称。当前 API 的名称为 `DescribeSecurityGroupAssociationInstances`。
Version	String	是	`2021-04-30`	接口版本。当前 API 的版本为 `2021-04-30`。
group_identity	String	是	`veew-sg-2551200256591525****`	外网防火墙的 ID。您可以通过 DescribeSecurityGroups 接口查询外网防火墙的 ID。

返回参数

下表仅列出本接口特有的返回参数。更多信息请参见返回结果。

参数	类型	示例值	描述
total	Integer	`1`	外网防火墙绑定的实例的数量。
bind_instances	Object[]	`-`	外网防火墙绑定的实例的列表。

请求示例

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 请求失败。关于错误码的更多信息，参见错误码。