# DescribeInstanceAvailableSecurityGroupResources

## 1. 接口描述

本接口用于获取实例可绑定的安全组。

## 2. 请求参数

以下请求参数列表仅列出了接口中需要的请求参数

| 参数名称       | 必选 | 类型     | 描述    |
| ---------- | -- | ------ | ----- |
| instanceId | 是  | String | 实例ID。 |

## 3. 响应结果

| 参数名称                            | 类型                                                                                                                                                 | 描述                                         |
| ------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------ |
| requestId                       | String                                                                                                                                             | 唯一请求 ID。每次请求都会返回。定位问题时需要提供该次请求的 requestId。 |
| instanceAvailableSecurityGroups | Array of [InstanceAvailableSecurityGroup](https://docs.console.zenlayer.com/api-reference/cn/compute/datastructure#instanceavailablesecuritygroup) | 实例可绑定的安全组集合。                               |

## 4. 代码示例

{% tabs %}
{% tab title="示例" %}

1. **获取实例可绑定的安全组集合。**

```json
POST /api/v2/vm HTTP/1.1
Host: console.zenlayer.com
Content-Type: application/json
X-ZC-Action: DescribeInstanceAvailableSecurityGroupResources
<Common Request Params>

Request:
{
  "instanceId": "your-instance-id"
}

Response:
{
  "requestId": "T728669AE-9EC6-463E-8728-F49DE5C2BC67",
  "response": {
    "requestId": "T728669AE-9EC6-463E-8728-F49DE5C2BC67",
    "instanceAvailableSecurityGroups": [
      {
        "securityGroupId": "your-seucurity-id-1",
        "securityGroupName": "redis-security",
        "isDefault": true
      },
      {
        "securityGroupId": "your-seucurity-id-2",
        "securityGroupName": "default-web-80-security",
        "isDefault": false
      },
      {
        "securityGroupId": "your-seucurity-id-3",
        "securityGroupName": "cluster-nginx-security",
        "isDefault": false
      }
    ]
  }
}
```

{% endtab %}
{% endtabs %}

## 5. 开发者工具

Zenlayer Cloud API 2.0 提供了配套的[开发工具集（SDK）](https://docs.console.zenlayer.com/api-reference/cn/api-introduction/toolkit)，未来会陆续支持更多开发语言，方便快速接入和使用Zenlayer的产品和服务。

## 6. 错误码

下面包含业务逻辑中遇到的错误码，其他错误码见[公共错误码](https://docs.console.zenlayer.com/api-reference/cn/api-introduction/instruction/commonerrorcode)

| HTTP状态码 | 错误码 | 说明 |
| ------- | --- | -- |
|         |     |    |
