Method: projects.locations.aclPolicies.list

列出指定位置(区域)或所有位置中属于某个项目的所有 ACL 政策。

位置信息应采用以下格式:

  • projects/{projectId}/locations/{locationId}

如果将 locationId 指定为 -(通配符),则会查询项目可用的所有区域,并汇总结果。

HTTP 请求

:


GET https://memorystore.googleapis.com/v1/{parent=projects/*/locations/*}/aclPolicies

网址使用 gRPC 转码语法。

路径参数

参数
parent

string

必需。ACL 政策位置的资源名称,采用以下格式:projects/{project}/locations/{location},其中 location 是指 Google Cloud 区域。

查询参数

参数
pageSize

integer

可选。需要返回的最大项数。

如果未指定,则服务将使用默认值 1000。无论 pageSize 值如何,响应都可能包含部分列表,并且调用方应该只依赖于响应的 nextPageToken 来确定是否还有更多 ACL 政策需要查询。

最大值为 1,000;大于 1,000 的值将被强制转换为 1,000。

pageToken

string

可选。从上一个 aclPolicies.list 请求返回的 nextPageToken 值(如果有)。

请求正文

请求正文必须为空。

响应正文

对 aclPolicies.list 的响应。

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

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

object (AclPolicy)

相应项目在指定位置或所有位置中的 ACL 政策列表。

如果请求的父字段中的 location 为“-”,则查询项目可用的所有区域,并汇总结果。

nextPageToken

string

用于检索下一页结果的令牌。如果列表中没有更多结果,则为空。

unreachable[]

string

无序列表。无法到达的位置。

授权范围

需要以下 OAuth 范围之一:

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

IAM 权限

需要拥有 parent 资源的以下 IAM 权限:

  • memorystore.aclPolicies.list

如需了解详情,请参阅 IAM 文档。