Deployments: list

需要授权

列出给定项目的所有部署。立即试用

请求

HTTP 请求

GET https://www.googleapis.com/deploymentmanager/v2/projects/project/global/deployments

参数

参数名称 说明
路径参数
project string 此请求的项目 ID。
可选查询参数
filter string 用于过滤响应中列出的资源的过滤条件表达式。表达式必须指定字段名称、比较运算符以及要用于过滤的值。值必须是字符串、数字或布尔值。比较运算符必须为 =!=><

例如,如果您要过滤 Compute Engine 实例,可以通过指定 name != example-instance 来排除名为 example-instance 的实例。

您还可以过滤嵌套字段。例如,您可以指定 scheduling.automaticRestart = false,以仅在实例未安排自动重启时将其包含在内。您可以对嵌套字段使用过滤功能,以便根据资源标签进行过滤。

如需按多个表达式进行过滤,请在括号中分别提供每个表达式。例如 (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake")。默认情况下,每个表达式都是一个 AND 表达式。不过,您可以明确包含 ANDOR 表达式。例如 (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true)
maxResults unsigned integer 应返回的每页结果数上限。 如果可用结果数量大于 maxResults,Compute Engine 会返回一个 nextPageToken,可用于在后续列表请求中获取下一页结果。可接受的值为 0500(含)。(默认值:500
orderBy string 按特定顺序对列表结果进行排序。默认情况下,系统会按资源名称的字母顺序返回结果。

您还可以使用 orderBy="creationTimestamp desc" 按创建时间戳对结果进行降序排序。这会按 creationTimestamp 字段对结果进行按时间倒序排序(最新结果排在前面)。您可以使用此参数对操作等资源进行排序,以便系统优先返回最新的操作。

目前,仅支持按 namecreationTimestamp desc 对数据进行排序。
pageToken string 指定要使用的页面令牌。将 pageToken 设置为上一个列表请求返回的 nextPageToken,以获取下一页结果。

授权

此请求需要获得以下至少一个范围的授权(详细了解身份验证和授权)。

范围
https://www.googleapis.com/auth/ndev.cloudman.readonly
https://www.googleapis.com/auth/cloud-platform
https://www.googleapis.com/auth/ndev.cloudman
https://www.googleapis.com/auth/cloud-platform.read-only

请求正文

使用此方法时请勿提供请求正文。

响应

如果成功,此方法将返回以下结构的响应正文:

{
  "deployments": [
    deployments Resource
  ],
  "nextPageToken": string
}
属性名称 说明 备注
deployments[] list 仅限输出。此响应中包含的部署。
nextPageToken string 仅限输出。用于继续被截断的 list 请求的令牌。

试试看!

使用下面的 API Explorer 对实际数据调用此方法,然后查看响应。 或者,您也可以尝试使用独立的 Explorer