资源:操作
此资源表示长时间运行的操作,该操作是网络 API 调用的结果。
该操作的response
字段将是UploadReleaseResponse 。
JSON 表示 |
---|
{ "name": string, "metadata": { "@type": string, field1: ..., ... }, "done": boolean, // Union field |
领域 | |
---|---|
name | 服务器分配的名称,仅在最初返回它的同一服务中是唯一的。如果您使用默认的 HTTP 映射,则该 |
metadata | 与操作关联的特定于服务的元数据。它通常包含进度信息和通用元数据,例如创建时间。某些服务可能不提供此类元数据。任何返回长时间运行操作的方法都应记录元数据类型(如果有)。 包含任意类型字段的对象。附加字段 |
done | 如果值为 |
联盟场result 。操作结果,可以是error ,也可以是有效response 。如果done == false ,则不会设置error 或response 。如果done == true ,则可以设置error 或response 之一。某些服务可能无法提供结果。 result 只能是以下之一: | |
error | 失败或取消时操作的错误结果。 |
response | 操作成功时的正常响应。在本例中,它将是UploadReleaseResponse 。 |
地位
Status
类型定义了适合不同编程环境的逻辑错误模型,包括REST API和RPC API。它由gRPC使用。每条Status
消息包含三部分数据:错误代码、错误消息和错误详细信息。
您可以在API 设计指南中找到有关此错误模型以及如何使用它的更多信息。
JSON 表示 |
---|
{ "code": integer, "message": string, "details": [ { "@type": string, field1: ..., ... } ] } |
领域 | |
---|---|
code | 状态代码,应该是 |
message | 面向开发人员的错误消息,应为英文。任何面向用户的错误消息都应本地化并在 |
details[] | 包含错误详细信息的消息列表。有一组通用的消息类型可供 API 使用。 包含任意类型字段的对象。附加字段 |
方法 | |
---|---|
| 获取长时间运行的操作的最新状态。 |