查询虚拟子网列表 - ListVirsubnets

project_id

是

String

参数解释：

子网所属的项目ID。获取方式请参见获取项目ID。

取值范围：

不涉及。

limit

否

Integer

参数解释：

每页返回的资源个数。

取值范围：

0~2000。

marker

否

String

参数解释：

分页查询起始的资源ID，为空时查询第一页。

取值范围：

子网的资源ID。

id

否

Array of strings

参数解释：

子网的资源ID，填写后按照ID进行过滤，支持传入多个ID过滤。

取值范围：

不涉及。

name

否

Array of strings

参数解释：

子网的名称，填写后按照名称进行过滤，支持传入多个名称过滤。

取值范围：

不涉及。

vpc_id

否

Array of strings

参数解释：

子网所在VPC的资源ID，填写后按照VPC资源ID进行过滤，支持传入多个ID过滤。

取值范围：

不涉及。

status

否

String

参数解释：

子网的状态，填写后按照状态进行过滤，只支持传入单个状态过滤。

取值范围：

• ACTIVE：表示子网已挂载到VPC上。

• UNKNOWN：表示子网还未挂载到VPC上。

• ERROR：表示子网状态故障。

scope

否

Array of strings

参数解释：

子网的作用域，填写后按照作用域进行过滤，支持传入多个作用域过滤。

取值范围：

• center：表示作用域为中心。

• {publicBorderGroup}：表示作用域为具体的公网边界组。公网边界组限制子网的可用区范围，可关联多个边缘可用区。

zone_id

否

Array of strings

参数解释：

子网的可用区ID，填写后按照可用区ID进行过滤，支持传入多个可用区ID过滤。

取值范围：

不涉及

description

否

Array of strings

参数解释：

子网的描述信息，填写后按照描述信息进行过滤，支持传入多个描述信息过滤。

取值范围：

不涉及。

request_id

String

参数解释：

请求ID。

取值范围：

不涉及。

virsubnets

Array of Virsubnet objects

参数解释：

查询子网列表的响应体。

取值范围：

不涉及。

page_info

PageInfo object

参数解释：

分页信息。

取值范围：

不涉及。

id

String

参数解释：

子网的资源ID。子网创建成功后，会生成一个子网 ID，是子网对应的唯一标识。

取值范围：

带“-”的标准UUID格式。

name

String

参数解释：

子网的名称。

取值范围：

1-64个字符，支持数字、字母、中文字符、_(下划线)、-（中划线）、.（点）。

description

String

参数解释：

子网的描述信息。

取值范围：

0-255个字符，不能包含“<”和“>”。

dns_nameservers

Array of strings

参数解释：

子网的DNS服务器地址列表。

取值范围：

不涉及。

zone_id

String

参数解释：

子网的可用区ID。

取值范围：

不涉及。

vpc_id

String

参数解释：

子网所属VPC的资源ID。

取值范围：

不涉及。

status

String

参数解释：

子网的状态。

取值范围：

• ACTIVE：表示子网已挂载到VPC上。

• UNKNOWN：表示子网还未挂载到VPC上。

• ERROR：表示子网状态故障。

project_id

String

参数解释：

子网所属的项目ID。

取值范围：

不涉及。

scope

String

参数解释：

子网的作用域（边缘云场景）。

取值范围：

• center：表示作用域为中心。

• {publicBorderGroup}：表示作用域为具体的公网边界组。公网边界组限制子网的可用区范围，可关联多个边缘可用区。

subnet_cidrs

Array of SubnetCidr objects

参数解释：

OpenStack Neutron子网信息。

取值范围：

不涉及。

tags

Array of ResponseTag objects

参数解释：

子网的标签信息，包括标签键和标签值，可用来分类和标识资源。详情请参见Tag对象。

取值范围：

不涉及。

extra_dhcp_opts

Array of SubnetExtraDhcpOpt objects

参数解释：

子网的DHCP属性，支持配置NTP地址、DNS域名或租约到期时间。

取值范围：

不涉及。

created_at

String

参数解释：

子网的创建时间。

取值范围：

UTC时间格式，yyyy-MM-ddTHH:mm:ss。

updated_at

String

参数解释：

子网的更新时间。

取值范围：

UTC时间格式，yyyy-MM-ddTHH:mm:ss。

id

String

参数解释：

OpenStack Neutron子网的资源ID。

取值范围：

带“-”的标准UUID格式。

ip_version

String

参数解释：

OpenStack Neutron子网的IP版本。

取值范围：

• 4：IPv4子网。

• 6：IPv6子网。

cidr

String

参数解释：

OpenStack Neutron子网的IP网段。

取值范围：

CIDR格式，如IPv4网段：192.168.23.0/24，IPv6网段：2420:2023:410:d5d::/64。

gateway_ip

String

参数解释：

OpenStack Neutron子网的网关IP地址。

取值范围：

不涉及。

enable_dhcp

Boolean

参数解释：

OpenStack Neutron子网是否开启DHCP功能。

取值范围：

• true：开启DHCP功能。

• false：未开启DHCP功能。

key

String

参数解释：

标签键。

取值范围：

• 最大长度128个unicode字符， key不能为空。

• 同一资源的key不能重复。

• 可以包含的字符范围：

  • 英文字母

  • 数字

  • 特殊字符：下划线（_）、点（.）、冒号（:）、加号（+）、中划线（-）、等号（=）

  • 中文字符

value

String

参数解释：

标签值。

取值范围：

• 每个值最大长度255个unicode字符，value可以为空。

• 可以包含的字符范围：

  • 英文字母

  • 数字

  • 特殊字符：下划线（_）、点（.）、冒号（:）、加号（+）、中划线（-）、等号（=）

  • 中文字符

opt_name

String

参数解释：

子网配置的NTP地址、DNS域名或租约到期时间的名称。

取值范围：

• 42：表示子网ntp地址。

• 15：表示DNS配置的域名，用于向DNS服务器获取IP地址。

• 51：表示IPv4子网租约到期时间。

• 651：表示IPv6子网租约到期时间。

opt_value

String

参数解释：

子网配置的NTP地址、DNS域名或租约到期时间。

取值范围：

• opt_name配置为“42”，则表示是子网ntp地址，目前只支持IPv4地址，每个IP地址以逗号隔开，IP地址个数不能超过4个，不能存在相同地址。

• opt_name配置为“15”，则该值表示是DNS配置的域名，用于向DNS服务器获取IP地址。域名只能由字母，数字，中划线组成，中划线不能在开头或末尾。域名可以包含多个字符串，单个字符串不超过63个字符，字符串间以点分隔。域名长度不超过254个字符。

• opt_name配置为“51”，则该值表示是IPv4子网租约到期时间，取值格式有两种，取-1，表示无限租约；数字+h，数字范围是1~175200，比如5h，默认值为87600h。

• opt_name配置为“651”，则该值表示是IPv6子网租约到期时间，取值格式有两种，取-1，表示无限租约；数字+h，数字范围是1~175200，比如5h，默认值为2h。

ip_version

Integer

参数解释：

子网的IP版本。

取值范围：

• 4：默认值，IPv4。

• 6：IPv6，只有opt_name是“651”时，ip_version为6。

previous_marker

String

参数解释：

当前页的第一条记录。

取值范围：

不涉及。

current_count

Integer

参数解释：

当前页的资源总数。

取值范围：

不涉及。

next_marker

String

参数解释：

当前页的最后一条记录，最后一页时无next_marker字段。

取值范围：

不涉及。

200

GET操作正常返回，更多状态码请参见状态码。