Method: customers.v2.Users.list

检索用户列表。

  • 请求必须指定过滤条件。不含 filter 参数的请求会返回 tooMany 错误。
  • filter 参数仅支持 userName 上的等式（例如 userName eq "user@domain.com"）。
  • 不支持子字符串匹配（co、sw、ew）、逻辑运算符（and、or）和复杂值过滤条件。
  • 不支持分页。

HTTP 请求

GET https://cloudidentityscim.googleapis.com/v1beta1/customers/{customerId}/v2/Users

网址采用 gRPC 转码语法。

路径参数

参数
customerId

string

必需。Cloud Identity 中客户的唯一标识符。客户 ID 是以字母 C 开头的字母数字字符串，例如 C01234abc。如需查找客户 ID，请参阅查找客户 ID。

查询参数

参数
filter

string

过滤条件参数。目前仅支持 userName 上的相等性。

请求正文

请求正文必须为空。

响应正文

列出用户的响应消息。

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

JSON 表示法 
{
  "schemas": [
    string
  ],
  "resources": [
    {
      object (User)
    }
  ],
  "totalResults": integer
}
字段
schemas[]

string

返回的资源的架构。
resources[]

object (User)

所请求资源的列表。
totalResults

integer

结果总数。

授权范围

需要以下 OAuth 范围之一：

  • https://www.googleapis.com/auth/admin.directory.user.readonly
  • https://www.googleapis.com/auth/admin.directory.user

如需了解详情，请参阅授权指南。