調(diào)試
您可以在API Explorer中調(diào)試該接口。
URI
GET /v1/{project_id}/subnets/{subnet_id}
參數(shù)說明請(qǐng)參見
表1。
表1 參數(shù)說明
|
名稱
|
是否必選
|
說明
|
|
project_id
|
是
|
項(xiàng)目ID，獲取項(xiàng)目ID請(qǐng)參見獲取項(xiàng)目ID。
|
|
subnet_id
|
是
|
子網(wǎng)唯一標(biāo)識(shí)。
如果您使用管理控制臺(tái)，此值即為子網(wǎng)詳情中的“網(wǎng)絡(luò)ID”參數(shù)值。
|
請(qǐng)求示例
GET https://{Endpoint}/v1/{project_id}/subnets/4779ab1c-7c1a-44b1-a02e-93dfc361b32d
響應(yīng)參數(shù)
表2 響應(yīng)參數(shù)
|
名稱
|
參數(shù)類型
|
說明
|
|
subnet
|
subnet object
|
subnet對(duì)象
|
表3 subnet對(duì)象
|
名稱
|
參數(shù)類型
|
說明
|
|
id
|
String
|
uuid形式的一個(gè)資源標(biāo)識(shí)。
|
|
name
|
String
|
- 功能說明：子網(wǎng)名稱
- 取值范圍：1-64個(gè)字符，支持?jǐn)?shù)字、字母、中文、_(下劃線)、-（中劃線）、.（點(diǎn)）
|
|
description
|
String
|
- 功能說明：子網(wǎng)描述
- 取值范圍：0-255個(gè)字符，不能包含“<”和“>”。
|
|
cidr
|
String
|
子網(wǎng)的網(wǎng)段
|
|
gateway_ip
|
String
|
子網(wǎng)的網(wǎng)關(guān)
|
|
ipv6_enable
|
Boolean
|
是否創(chuàng)建IPv6子網(wǎng)
|
|
cidr_v6
|
String
|
IPv6子網(wǎng)的網(wǎng)段，如果子網(wǎng)為IPv4子網(wǎng)，則不返回此參數(shù)
|
|
gateway_ip_v6
|
String
|
IPv6子網(wǎng)的網(wǎng)關(guān)，如果子網(wǎng)為IPv4子網(wǎng)，則不返回此參數(shù)
|
|
dhcp_enable
|
Boolean
|
子網(wǎng)是否開啟dhcp功能
|
|
primary_dns
|
String
|
子網(wǎng)dns服務(wù)器地址1
|
|
secondary_dns
|
String
|
子網(wǎng)dns服務(wù)器地址2
|
|
dnsList
|
Array of strings
|
子網(wǎng)dns服務(wù)器地址列表集
|
|
availability_zone
|
String
|
子網(wǎng)所在的可用區(qū)標(biāo)識(shí)
|
|
vpc_id
|
String
|
子網(wǎng)所在VPC標(biāo)識(shí)
|
|
status
|
String
|
- 功能說明：子網(wǎng)的狀態(tài)。
- 取值范圍：ACTIVE,UNKNOWN,ERROR
- ACTIVE表示子網(wǎng)已掛載到VPC上
- UNKNOWN表示子網(wǎng)還未掛載到VPC上
- ERROR表示子網(wǎng)狀態(tài)故障
|
|
neutron_network_id
|
String
|
對(duì)應(yīng)網(wǎng)絡(luò)（OpenStack Neutron接口）id
|
|
neutron_subnet_id
|
String
|
對(duì)應(yīng)子網(wǎng)（OpenStack Neutron接口）id
|
|
neutron_subnet_id_v6
|
String
|
對(duì)應(yīng)IPv6子網(wǎng)（OpenStack Neutron接口）id，如果子網(wǎng)為IPv4子網(wǎng)，則不返回此參數(shù)
|
|
extra_dhcp_opts
|
Array of extra_dhcp_opt objects
|
子網(wǎng)配置的NTP地址或租約時(shí)間，詳情請(qǐng)參見extra_dhcp_opt對(duì)象。
|
|
scope
|
String
|
子網(wǎng)作用域。
取值范圍：
- center：表示作用域?yàn)橹行?/li>
- {azId}：表示作用域?yàn)榫唧w的可用區(qū)
|
|
tenant_id
|
String
|
功能說明：項(xiàng)目ID。
|
|
created_at
|
String
|
- 功能說明：資源創(chuàng)建時(shí)間，UTC時(shí)間
- 格式：yyyy-MM-ddTHH:mm:ss
|
|
updated_at
|
String
|
- 功能說明：資源更新時(shí)間，UTC時(shí)間
- 格式：yyyy-MM-ddTHH:mm:ss
|
表4 extra_dhcp_opt對(duì)象
|
名稱
|
是否必選
|
參數(shù)類型
|
說明
|
|
opt_value
|
否
|
String
|
- 功能說明：子網(wǎng)配置的NTP地址或子網(wǎng)配置的租約到期時(shí)間。
- 約束：
opt_name配置為“ntp”，則表示是子網(wǎng)ntp地址，目前只支持IPv4地址，每個(gè)IP地址以逗號(hào)隔開，IP地址個(gè)數(shù)不能超過4個(gè)，不能存在相同地址。該字段為null表示取消該子網(wǎng)NTP的設(shè)置，不能為“ ”(空字符串)。
opt_name配置為“addresstime”，則該值表示是子網(wǎng)租約到期時(shí)間，取值格式有兩種，取-1，表示無限租約；數(shù)字+h，數(shù)字范圍是1~30000，比如5h，默認(rèn)值為24h。
|
|
opt_name
|
是
|
String
|
- 功能說明：子網(wǎng)配置的NTP地址名稱或子網(wǎng)配置的租約到期名稱。
- 約束：目前只支持填寫字符串“ntp”或“addresstime”。
|
響應(yīng)示例
{
"subnet": {
"id": "4779ab1c-7c1a-44b1-a02e-93dfc361b32d",
"name": "subnet",
"description": "",
"cidr": "192.168.20.0/24",
"dnsList": [
"114.xx.xx.114",
"114.xx.xx.115"
],
"status": "ACTIVE",
"vpc_id": "3ec3b33f-ac1c-4630-ad1c-7dba1ed79d85",
"gateway_ip": "192.168.20.1",
"ipv6_enable": false,
"dhcp_enable": true,
"primary_dns": "114.xx.xx.114",
"secondary_dns": "114.xx.xx.115",
"availability_zone": "aa-bb-cc",
"neutron_network_id": "4779ab1c-7c1a-44b1-a02e-93dfc361b32d",
"neutron_subnet_id": "213cb9d-3122-2ac1-1a29-91ffc1231a12",
"extra_dhcp_opts": [
{
"opt_value": "10.100.0.33,10.100.0.34",
"opt_name": "ntp"
},
{
"opt_value": "24h",
"opt_name": "addresstime"
}
],
"tenant_id": "087679f0aa80d32a2f4ec0172f5e902b",
"created_at": "2022-12-15T02:42:07",
"updated_at": "2022-12-15T02:42:07"
}
}
