# 查询子网详情 - ShowSubnet #### 功能介绍 根据子网的ID，获取子网的详细信息。 #### 调试 您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/IEC/doc?api=ShowSubnet)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-iec/iec_05_0600.html)。 #### URI GET /v1/subnets/{subnet_id} 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | subnet_id | 是 | String | 子网ID。 | #### 请求参数 表2请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | X-Auth-Token | 是 | String | 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 | #### 响应参数 **状态码：200** 表3响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | subnet | [Subnet] object | 子网字典对象。 | 表4Subnet | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | 子网的ID。 | | name | String | 子网名称 取值范围：1-64个字符，支持数字、字母、中文、_(下划线)、-（中划线）、.（点） | | cidr | String | 子网的网段 取值范围：必须在vpc对应cidr范围内 约束：必须是cidr格式。掩码长度不能大于28 | | dnsList | Array of strings | 子网dns服务器地址列表 | | gateway_ip | String | 子网的网关 取值范围：子网网段中的IP地址 约束：必须是ip格式 | | dhcp_enable | Boolean | 子网是否开启dhcp功能 | | primary_dns | String | 子网dns服务器地址1 | | secondary_dns | String | 子网dns服务器地址2 | | status | String | 子网的状态 取值范围： - ACTIVE：表示子网已挂载到ROUTER上 - UNKNOWN：表示子网还未挂载到ROUTER上 - ERROR：表示子网状态故障 | | vpc_id | String | 虚拟私有云ID。 | | site_id | String | 子网所属的站点ID。 | | site_info | String | 子网所属的站点信息。 | | neutron_network_id | String | 对应网络（OpenStack Neutron接口） id。 | | neutron_subnet_id | String | 对应子网（OpenStack Neutron接口） id。 | | cidr_v6 | String | IPv6子网的网段，如果子网为IPv4子网，则不返回此参数 | | ipv6_enable | Boolean | 是否是IPv6子网 取值范围：true，false | | pool_id | String | IPv6线路ID，如果子网为IPv4子网，则不返回此参数。 | | neutron_subnet_id_v6 | String | 对应IPv6子网（OpenStack Neutron接口）id，如果子网为IPv4子网，则不返回此参数。 | | gateway_ip_v6 | String | IPv6子网的网关，如果子网为IPv4子网，则不返回此参数。 | #### 请求示例 ``` GET https://{{endpoint}}/v1/subnets/a5ac27e5-d69e-44be-809f-1393438046ce ``` #### 响应示例 **状态码：200** OK ``` { "subnet" : { "id" : "a5ac27e5-d69e-44be-809f-1393438046ce", "name" : "subnet-kcps", "vpc_id" : "1016972d-357e-4a2a-912b-cf2ab9673790", "cidr" : "10.0.0.0/24", "gateway_ip" : "10.0.0.1", "dhcp_enable" : true, "primary_dns" : "114.114.114.114", "secondary_dns" : "8.8.8.8", "dnsList" : [ "114.114.114.114", "8.8.8.8" ], "status" : "ACTIVE", "site_id" : "705da43d-fa20-11ea-9fb2-fa1640495574", "site_info" : "China/华中地区/湖南/长沙市", "neutron_network_id" : "a5ac27e5-d69e-44be-809f-1393438046ce", "neutron_subnet_id" : "d2bc9af1-bbee-4fb0-8d0e-fe07339fab7a" } } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | OK | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-iec/ErrorCode.html)。