功能介紹
查詢子網(wǎng)列表。
調(diào)試
您可以在API Explorer中調(diào)試該接口。
URI
GET /v1/{project_id}/subnets
GET https://{Endpoint}/v1/{project_id}/subnets?limit=10&
marker=4779ab1c-7c1a-44b1-a02e-93dfc361b32d&vpc_id=3ec3b33f-ac1c-4630-ad1c-7dba1ed79d85
|
名稱 |
是否必選 |
參數(shù)類型 |
說明 |
|---|---|---|---|
|
project_id |
是 |
String |
項目ID，獲取項目ID請參見獲取項目ID。 |
|
marker |
否 |
String |
分頁查詢的起始資源ID，表示從指定資源的下一條記錄開始查詢。 marker需要和limit配合使用：
|
|
limit |
否 |
Integer |
分頁查詢每頁返回的記錄個數(shù)，取值范圍為0~intmax（2^31-1），默認值2000。 limit需要和marker配合使用，詳細規(guī)則請見marker的參數(shù)說明。 |
|
vpc_id |
否 |
String |
按照vpc_id過濾查詢 企業(yè)項目細粒度授權(quán)場景下，該字段必傳 |
請求參數(shù)
無
請求示例
GET https://{Endpoint}/v1/{project_id}/subnets
響應(yīng)參數(shù)
|
名稱 |
參數(shù)類型 |
說明 |
|---|---|---|
|
id |
String |
uuid形式的一個資源標識。 |
|
name |
String |
|
|
description |
String |
|
|
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ū)標識 |
|
vpc_id |
String |
子網(wǎng)所在VPC標識 |
|
status |
String |
|
|
neutron_network_id |
String |
對應(yīng)網(wǎng)絡(luò)（OpenStack Neutron接口）id |
|
neutron_subnet_id |
String |
對應(yīng)子網(wǎng)（OpenStack Neutron接口）id |
|
neutron_subnet_id_v6 |
String |
對應(yīng)IPv6子網(wǎng)（OpenStack Neutron接口）id，如果子網(wǎng)為IPv4子網(wǎng)，則不返回此參數(shù) |
|
extra_dhcp_opts |
||
|
scope |
String |
子網(wǎng)作用域。 取值范圍：
|
|
tenant_id |
String |
功能說明：項目ID。 |
|
created_at |
String |
|
|
updated_at |
String |
|
響應(yīng)示例
{
"subnets": [
{
"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": true,
"cidr_v6": "2001:db8:a583::/64",
"gateway_ip_v6": "2001:db8:a583::1",
"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",
"neutron_subnet_id_v6": "e0fa7de1-a6e2-44c9-b052-b9d8cebe93c4",
"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"
},
{
"id": "531dec0f-3116-411b-a21b-e612e42349fd",
"name": "Subnet1",
"description": "",
"cidr": "192.168.1.0/24",
"dnsList": [
"114.xx.xx.114",
"114.xx.xx.115"
],
"status": "ACTIVE",
"vpc_id": "3ec3b33f-ac1c-4630-ad1c-7dba1ed79d85",
"gateway_ip": "192.168.1.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": "531dec0f-3116-411b-a21b-e612e42349fd",
"neutron_subnet_id": "1aac193-a2ad-f153-d122-12d64c2c1d78",
"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-15T03:41:22",
"updated_at": "2022-12-15T03:41:22"
}
]
}
狀態(tài)碼
請參見狀態(tài)碼。
錯誤碼
請參考錯誤碼。
