Method: projects.locations.memberships.list

列出给定项目和位置中的成员资格。

HTTP 请求

GET https://gkehub.googleapis.com/v1/{parent=projects/*/locations/*}/memberships

网址采用 gRPC 转码语法。

路径参数

参数
parent

string

必需。要列出其中成员资格的父级对象（项目和位置），采用 projects/*/locations/* 格式。projects/*/locations/- 会列出所有区域中的成员资格。

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

  • gkehub.memberships.list

查询参数

参数
pageSize

integer

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

string

可选。上一次 memberships.list 调用返回的令牌，用于指定列表中要继续列出资源的位置。
filter

string

可选。列出与过滤表达式（需遵循 https://google.aip.dev/160 中列出的语法）匹配的成员资格。

示例：

  • 位于项目 foo-proj 和位置 global 且名为 bar：
  name = "projects/foo-proj/locations/global/membership/bar"
  • 具有名为 foo 的标签的成员资格：
  labels.foo:*
  • 具有名为 foo 且其值为 bar 的标签的成员资格：
  labels.foo = bar
  • 处于“正在创建”状态的成员资格：
  state = CREATING
orderBy

string

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

请求正文

请求正文必须为空。

响应正文

GkeHub.ListMemberships 方法的响应消息。

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

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

object (Membership)

匹配成员资格的列表。
nextPageToken

string

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

string

提取此列表时无法访问的位置的列表。

授权范围

需要以下 OAuth 范围：

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

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