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/v1/customers/{customerId}/v2/Users

网址采用 gRPC 转码语法。

路径参数

参数
customerId

string

必需。客户 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

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