Operations

操作会跟踪所有修改数据的请求的状态。系统会针对更改任何资源的每个请求返回一个操作。

如需了解此资源的方法列表，请参阅本页结尾部分。

资源表示法

操作资源，用于管理异步 API 请求。

{
  "kind": "deploymentmanager#operation",
  "id": unsigned long,
  "creationTimestamp": string,
  "name": string,
  "zone": string,
  "clientOperationId": string,
  "operationType": string,
  "targetLink": string,
  "targetId": unsigned long,
  "status": string,
  "statusMessage": string,
  "user": string,
  "progress": integer,
  "insertTime": string,
  "startTime": string,
  "endTime": string,
  "error": {
    "errors": [
      {
        "code": string,
        "location": string,
        "message": string
      }
    ]
  },
  "warnings": [
    {
      "code": string,
      "message": string,
      "data": [
        {
          "key": string,
          "value": string
        }
      ]
    }
  ],
  "httpErrorStatusCode": integer,
  "httpErrorMessage": string,
  "selfLink": string,
  "region": string,
  "description": string
}
属性名称 值 说明 备注
clientOperationId string [仅输出] 如果您在请求中提供了 `requestId`，则为其值。否则不存在。
creationTimestamp string [已废弃] 此字段已废弃。
description string [仅限输出] 操作的文本说明，在创建操作时设置。
endTime string [仅限输出] 此操作的完成时间。此值采用 RFC3339 文本格式。
error object [仅限输出] 如果在处理操作期间生成了错误，系统将填充此字段。
error.errors[] list [仅限输出] 处理此操作时遇到的错误数组。
error.errors[].code string [仅限输出] 此错误的错误类型标识符。
error.errors[].location string [仅限输出] 指示请求中导致错误的字段。该属性是可选的。
error.errors[].message string [仅限输出] 可选属性，人类可读的错误消息。
httpErrorMessage string [仅输出] 如果操作失败，此字段会包含返回的 HTTP 错误消息，例如 NOT FOUND。
httpErrorStatusCode integer [仅输出] 如果操作失败，此字段会包含返回的 HTTP 错误状态代码。例如，404 表示未找到资源。
id unsigned long [仅输出] 资源的唯一标识符。此标识符由服务器定义。
insertTime string [仅限输出] 请求此操作的时间。此值采用 RFC3339 文本格式。
kind string [仅限输出] 资源的类型。对于 Operation 资源，始终为 compute#operation。
name string [仅限输出] 资源的名称。
operationType string [仅限输出] 操作类型，例如 insert、update 或 delete 等。
progress integer [仅限输出] 可选的进度指示器，范围从 0 到 100。不要求其为线性或支持任何操作粒度。请勿根据此值来推测操作何时完成。此数字应随着操作的进行而单调递增。
region string [仅限输出] 操作所在区域的网址。仅在执行地区性操作时可用。您必须在 HTTP 请求网址中指定此字段。无法在请求正文中将其设置为字段。
startTime string [仅限输出] 服务器启动此操作的时间。此值采用 RFC3339 文本格式。
status string [仅输出] 操作的状态，可以是以下状态之一：PENDING、RUNNING 或 DONE。
statusMessage string [仅限输出] 操作当前状态的可选文本描述。
targetId unsigned long [仅限输出] 唯一的目标 ID，用于标识目标资源的特定实例。
user string [仅限输出] 请求执行操作的用户，例如：user@example.com。
warnings[] list [仅限输出] 如果在处理操作期间生成警告消息，系统将填充此字段。
warnings[].code string [仅限输出] 警告代码（如果适用）。例如，如果响应中没有结果，Compute Engine 会返回 NO_RESULTS_ON_PAGE。
warnings[].data[] list [仅输出] 此警告的元数据，采用 key: value 格式。例如：
"data": [ { "key": "scope", "value": "zones/us-east1-d" }
warnings[].data[].key string [仅输出] 用于提供有关返回的警告的更多详细信息的键。例如，对于特定区域的列表请求中没有结果的警告，此键可能为 scope，键值可能为区域名称。其他示例可能包括指示已废弃资源和建议替换项的键，或关于网络设置无效的警告（例如，如果实例尝试执行 IP 转发，但未启用 IP 转发）。
warnings[].data[].value string [仅输出] 与键对应的警告数据值。
warnings[].message string [仅限输出] 警告代码的直观易懂的说明。
zone string [仅限输出] 操作所在区域的网址。仅在执行地区级操作时可用。您必须在 HTTP 请求网址中指定此字段。无法在请求正文中将其设置为字段。

方法

get
获取有关特定操作的信息。
list
列出项目的所有操作。