虚拟私有云 VPC-查询网络列表:URI

时间:2024-10-28 14:52:50

URI

GET /v2.0/networks

样例:

GET https://{Endpoint}/v2.0/networks?id={network_id}&status={network_status}&name={network_name}&admin_state_up=${admin_state_up}&tenant_id={tenant_id}&shared={is_shared}&provider:network_type={geneve}

分页查询样例:

GET https://{Endpoint}/v2.0/networks?limit=2&marker=0133cd73-34d4-4d4c-bf1f-e65b24603206&page_reverse=False

参数说明请参见表1

表1 参数说明

名称

是否必选

参数类型

说明

id

String

按照网络对应的ID过滤查询

name

String

按照网络的名称过滤查询

admin_state_up

Boolean

按照网络的管理状态过滤查询

取值范围:true or false

provider:network_type

String

按照网络的类型过滤查询

shared

Boolean

按照网络是否支持跨租户共享过滤查询

取值范围:true or false

status

String

按照网络的状态过滤查询

取值范围:ACTIVE、BUILD、DOWN

router:external

Boolean

按照网络是否外部网络过滤查询

取值范围:true or false

tenant_id

String

按照网络所属的项目ID过滤查询

marker

String

分页查询的起始资源ID,表示从指定资源的下一条记录开始查询。

marker需要和limit配合使用:

  • 若不传入marker和limit参数,查询结果返回第一页全部资源记录。
  • 若不传入marker参数,limit为10,查询结果返回第1~10条资源记录。
  • 若marker为第10条记录的资源ID,limit为10,查询结果返回第11~20条资源记录。
  • 若marker为第10条记录的资源ID,不传入limit参数,查询结果返回第11~2000条(limit默认值2000)资源记录。

limit

Integer

分页查询每页返回的记录个数,取值范围为0~intmax(2^31-1),默认值2000。

limit需要和marker配合使用,详细规则请见marker的参数说明。

support.huaweicloud.com/api-vpc/vpc_network_0001.html