# 查询安全组详情 - ShowSecurityGroup
#### 功能介绍
根据安全组的ID，获取特定安全组的详细信息。
#### 调试
您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/IEC/doc?api=ShowSecurityGroup)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-iec/iec_05_0600.html)。
#### URI
GET /v1/security-groups/{security_group_id}
表1路径参数 
| 参数                | 是否必选 | 参数类型   | 描述      |
|:---|:---|:---|:---|
| security_group_id | 是    | String | 安全组的ID。 |
   
#### 请求参数
表2请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                             |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 |
   
#### 响应参数
**状态码：200**
表3响应Body参数 
| 参数             | 参数类型                                                               | 描述     |
|:---|:---|:---|
| security_group | [SecurityGroup] object | 安全组对象。 |
   
 表4SecurityGroup 
| 参数                   | 参数类型                                                                                 | 描述          |
|:---|:---|:---|
| id                   | String                                                                               | 安全组的ID。UUID |
| name                 | String                                                                               | 安全组的名称。     |
| description          | String                                                                               | 安全组的描述。     |
| security_group_rules | Array of [SecurityGroupRule] objects | 安全组规则列表。    |
   
 表5SecurityGroupRule 
| 参数                | 参数类型    | 描述                                                                                                                                                                                                                                                                                                                                                                                                                             |
|:---|:---|:---|
| id                | String  | 安全组规则的ID。                                                                                                                                                                                                                                                                                                                                                                                                                      |
| description       | String  | 安全组规则描述信息。                                                                                                                                                                                                                                                                                                                                                                                                                     |
| security_group_id | String  | 安全组ID。                                                                                                                                                                                                                                                                                                                                                                                                                         |
| direction         | String  | 出入控制方向。 取值范围： - egress：出方向   - ingress：入方向    |
| ethertype         | String  | IP协议类型。 取值范围：IPv4，IPv6 约束：不填默认值为IPv4                                                                                                                                                                                                                                                                                                                 |
| protocol          | String  | 协议类型。 取值范围：icmp、tcp、udp、icmpv6等 约束：为空表示支持所有协议                                                                                                                                                                                                                                                                                                        |
| port_range_min    | String  | 起始端口值。 取值范围：1\~65535 约束：取值不能大于port_range_max的值，为空表示所有端口                                                                                                                                                                                                                                                                                              |
| port_range_max    | String  | 结束端口值。 取值范围：1\~65535 约束：取值不能小于port_range_min的值，为空表示所有端口。                                                                                                                                                                                                                                                                                             |
| remote_group_id   | String  | 对端安全组ID。 约束：和remote_ip_prefix互斥 ，remote_group_id与remote_ip_prefix必须存在一个                                                                                                                                                                                                                                                                                                                   |
| remote_ip_prefix  | String  | 远端IP地址，当direction是egress时为虚拟机访问端的地址，当direction是ingress时为访问虚拟机的地址。 取值范围：IP地址，或者cidr格式 约束：和remote_group_id互斥                                                                                                                                                                                                                                           |
| action            | String  | 安全组规则生效策略 取值范围：allow 允许，deny 拒绝 约束：默认值为allow                                                                                                                                                                                                                                                                                                         |
| priority          | Integer | 规则在安全组中的优先级 取值范围：1\~100，1代表最高优先级 约束：默认值为1                                                                                                                                                                                                                                                                                                            |
   
#### 请求示例
```
GET https://{endpoint}/v1/security-groups/99d9d709-8478-4b46-9f3f-2206b1023fd3
```
#### 响应示例
**状态码：200**
OK
```
{
  "security_group" : {
    "id" : "99d9d709-8478-4b46-9f3f-2206b1023fd3",
    "name" : "sg002",
    "description" : "用于test",
    "security_group_rules" : [ {
      "description" : "for test",
      "direction" : "egress",
      "ethertype" : "IPv4",
      "id" : "99d9d709-8478-4b46-9f3f-2206b1023fd3",
      "protocol" : "TCP",
      "port_range_max" : 300,
      "port_range_min" : 30,
      "remote_group_id" : null,
      "remote_ip_prefix" : null,
      "security_group_id" : null
    } ]
  }
}
```
#### 状态码
| 状态码 | 描述 |
|:---|:---|
| 200 | OK |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-iec/ErrorCode.html)。