Package google.longrunning

Chỉ mục

Hoạt động

Tài nguyên này thể hiện một tác vụ lâu dài là kết quả của một lệnh gọi API mạng.

Các trường
name

string

Tên do máy chủ chỉ định. Tên này chỉ là duy nhất trong cùng một dịch vụ trả về tên này. Nếu bạn sử dụng tính năng ánh xạ HTTP mặc định, thì name phải là tên tài nguyên kết thúc bằng operations/{unique_id}.

metadata

Any

Siêu dữ liệu dành riêng cho dịch vụ liên kết với toán tử. Dữ liệu này thường chứa thông tin về tiến trình và siêu dữ liệu phổ biến, chẳng hạn như thời gian tạo. Một số dịch vụ có thể không cung cấp siêu dữ liệu như vậy. Bất kỳ phương thức nào trả về một thao tác dài hạn đều phải ghi lại loại siêu dữ liệu đó (nếu có).

done

bool

Nếu giá trị là false, thì tức là thao tác vẫn đang diễn ra. Nếu true, thì thao tác đã hoàn tất và bạn có thể sử dụng error hoặc response.

Trường liên kết result. Kết quả hoạt động, có thể là error hoặc response hợp lệ. Nếu done == false, cả errorresponse đều không được đặt. Nếu done == true, đặt chính xác một trong hai error hoặc response. result chỉ có thể là một trong những giá trị sau:
error

Status

Kết quả lỗi nếu thao tác bị lỗi hoặc huỷ.

response

Any

Phản hồi thông thường của thao tác trong trường hợp thành công. Nếu phương thức ban đầu không trả về dữ liệu nào thành công, chẳng hạn như Delete, thì phản hồi là google.protobuf.Empty. Nếu phương thức ban đầu là Get/Create/Update chuẩn, thì phản hồi phải là tài nguyên. Đối với các phương thức khác, phản hồi phải có loại XxxResponse, trong đó Xxx là tên phương thức ban đầu. Ví dụ: nếu tên phương thức ban đầu là TakeSnapshot(), thì loại phản hồi dự đoán là TakeSnapshotResponse.