Method: projects.locations.features.list

列出给定项目和位置中的特征。

HTTP 请求

GET https://gkehub.googleapis.com/v1beta/{parent=projects/*/locations/*}/features

网址采用 gRPC 转码语法。

路径参数

参数
parent

string

必需。要列出其中特征的父级对象(项目和位置),采用 projects/*/locations/* 格式。

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

  • gkehub.features.list

查询参数

参数
pageSize

integer

在请求返回一“页”资源时,pageSize 指定要返回的资源数量。如果未指定或设为 0,则返回所有资源。

pageToken

string

上一次 features.list 调用返回的令牌,用于指定列表中要继续列出资源的位置。

filter

string

列出与过滤表达式(需遵循 https://google.aip.dev/160 中列出的语法)匹配的特征。

示例:

  • 项目“foo-proj”中名为“servicemesh”的特征:
  name = "projects/foo-proj/locations/global/features/servicemesh"
  • 具有名为 foo 的标签的特征:
  labels.foo:*
  • 具有名为 foo 且其值为 bar 的标签的特征:
  labels.foo = bar
orderBy

string

用于对比和用于对输出进行排序的一个或多个字段。请参阅 https://google.aip.dev/132#ordering

请求正文

请求正文必须为空。

响应正文

GkeHub.ListFeatures 方法的响应消息。

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

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

object (Feature)

匹配特征的列表

nextPageToken

string

用于从 features.list 方法请求下一页资源的令牌。如果是空字符串值,则表示没有更多资源要返回。

授权范围

需要以下 OAuth 范围:

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

如需了解详情,请参阅身份验证概览