Method: projects.locations.memberships.list

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

HTTP 请求

GET https://gkehub.googleapis.com/v1beta1/{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

请求正文

请求正文必须为空。

响应正文

GkeHubMembershipService.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

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