Method: projects.locations.global.connectivityTests.list

列出项目拥有的所有 Connectivity Tests。

HTTP 请求

GET https://networkmanagement.googleapis.com/v1beta1/{parent=projects/*/locations/global}/connectivityTests

网址采用 gRPC 转码语法。

路径参数

参数
parent

string

必需。Connectivity Tests 的父级资源：projects/{projectId}/locations/global

必须对指定的资源 parent 具有以下 IAM 权限才能进行授权：

  • networkmanagement.connectivitytests.list

查询参数

参数
pageSize

integer

要返回的 ConnectivityTests 的数量。
pageToken

string

来自先前的查询的页面令牌，如 nextPageToken 中返回的页面令牌。
filter

string

列出与过滤条件表达式匹配的 ConnectivityTests。过滤条件表达式会过滤响应中列出的资源。该表达式的格式必须为 <field> <operator> <value>，其中支持以下运算符：<、>、<=、>=、!=、=、:（英文冒号 : 表示 HAS 运算符，大致等同于等式）。 可以指 proto 或 JSON 字段，也可以指合成字段。字段名称可以是 camelCase 或 snake_case。

示例：- 按名称过滤：name = "projects/proj-1/locations/global/connectivityTests/test-1

  • 按标签过滤：
  • 具有名为 foo labels.foo:* 的键的资源。
  • 具有名为 foo 且其值为 bar labels.foo = bar 的键的资源。
orderBy

string

用于对列表进行排序的字段。

请求正文

请求正文必须为空。

响应正文

对 connectivityTests.list 方法的响应。

如果成功，响应正文将包含结构如下的数据：

JSON 表示法 
{
  "resources": [
    {
      object (ConnectivityTest)
    }
  ],
  "nextPageToken": string,
  "unreachable": [
    string
  ]
}
字段
resources[]

object (ConnectivityTest)

Connectivity Tests 列表。
nextPageToken

string

用于提取下一组 Connectivity Tests 的页面令牌。
unreachable[]

string

无法到达的位置（使用 - 查询所有位置时）。

授权范围

需要以下 OAuth 范围：

  • https://www.googleapis.com/auth/cloud-platform

如需了解详情，请参阅 Authentication Overview。