Package google.longrunning

Chỉ mục

Hoạt động

Tài nguyên này đại diện cho một hoạt động diễn ra trong thời gian 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, chỉ là duy nhất trong cùng một dịch vụ trả về tên đó ban đầu. Nếu bạn sử dụng mục ánh xạ HTTP mặc định, 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ụ được liên kết với hoạt động. Tệp 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. Mọi phương thức trả về một hoạt động diễn ra trong thời gian dài đề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 này vẫn đang diễn ra. Nếu là true, thì thao tác này đã hoàn tất và error hoặc response có sẵn.

Trường nhóm result. Kết quả toán tử, có thể là error hoặc response hợp lệ. Nếu done == false, thì cả errorresponse đều không được đặt. Nếu done == true, bạn có thể đặt chính xác một trong số error hoặc response. Một số dịch vụ có thể không cung cấp kết quả. result chỉ có thể là một trong những trạng thái sau đây:
error

Status

Kết quả lỗi của hoạt động trong trường hợp không thành công hoặc bị huỷ.

response

Any

Phản hồi bình thường, thành công của tác vụ. Nếu phương thức ban đầu không trả về dữ liệu nào khi thành công, chẳng hạn như Delete, thì phản hồi sẽ 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ó kiểu 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 được dự đoán sẽ là TakeSnapshotResponse.