长时间运行的操作(高级版)

Cloud Translation API 的某些方法会返回长时间运行的操作。 这些方法是异步执行的;当方法返回响应时,操作可能尚未完成。您可以检查操作的状态,或取消操作。

操作状态

下面介绍了如何轮询操作的状态。

REST

operation 资源调用 get 方法。

在使用任何请求数据之前,请先进行以下替换:

  • PROJECT_NUMBER_OR_ID:您的 Google Cloud 项目的数字或字母数字 ID
  • location-id:您为 Cloud Storage 存储分区选择的位置
  • operation-id:您在上面收到的操作 ID

HTTP 方法和网址:

GET https://translation.googleapis.com/v3/projects/PROJECT_NUMBER_OR_ID/locations/location-id/operations/operation-id

如需发送您的请求,请展开以下选项之一:

您应该收到类似以下内容的 JSON 响应:

{
  "name": "projects/project-number/locations/location-id/operations/operation-id",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.translation.v3.SomeOperationMetadata",
    "state": "SUCCEEDED",
    "submitTime": "2019-11-27T22:59:40Z"
  }
}

操作完成后,系统会返回 stateSUCCEEDED

操作取消

下面介绍了如何取消操作。

REST

operation 资源调用 cancel 方法。

在使用任何请求数据之前,请先进行以下替换:

  • PROJECT_NUMBER_OR_ID:您的 Google Cloud 项目的数字或字母数字 ID。
  • LOCATION:您在开始操作时选择的位置。
  • OPERATION_ID:要取消操作的 ID。

HTTP 方法和网址:

POST https://translation.googleapis.com/v3/projects/PROJECT_NUMBER_OR_ID/locations/LOCATION_ID/operations/OPERATION_ID:cancel

如需发送您的请求,请展开以下选项之一:

您应该会收到一个成功的状态代码 (2xx) 和一个空响应。

其他资源

  • 如需有关解决常见问题或错误的帮助,请参阅问题排查页面。