Method: projects.locations.agentGateways.list

列出给定项目和位置中的 AgentGateway。

HTTP 请求

GET https://networkservices.googleapis.com/v1alpha1/{parent=projects/*/locations/*}/agentGateways

网址采用 gRPC 转码语法。

路径参数

参数
parent

string

必需。应列出的 AgentGateway 所在的项目和位置,按 projects/*/locations/* 格式指定。

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

  • iam.permissions.none

查询参数

参数
pageSize

integer

可选。每次调用返回的 AgentGateway 的数量上限。

pageToken

string

可选。最后一个 ListAgentGatewaysResponse 返回的值,表示这是之前的 agentGateways.list 调用的延续,并且系统应返回下一页的数据。

returnPartialSuccess

boolean

可选。如果为 true,则允许针对多区域汇总列表请求返回部分响应。否则,如果其中一个位置处于关闭状态或无法访问,则汇总列表请求将失败。

请求正文

请求正文必须为空。

响应正文

agentGateways.list 方法返回的响应。

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

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

object (AgentGateway)

AgentGateway 资源列表。

nextPageToken

string

如果结果数量可能多于此响应中显示的数量,则包含 nextPageToken。如需获取下一组结果,请再次使用 nextPageToken 的值作为 pageToken 来调用此方法。

unreachable[]

string

无法访问的资源。当请求尝试列出所有受支持位置的所有资源,而某些位置暂时不可用时,系统会填充此字段。

授权范围

需要以下 OAuth 范围:

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

如需了解详情,请参阅 Authentication Overview