Tài nguyên: 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.
Biểu diễn dưới dạng JSON |
---|
{ "name": string, "metadata": { "@type": string, field1: ..., ... }, "done": boolean, // Union field |
Trường | |
---|---|
name |
Tên do máy chủ chỉ định, chỉ là duy nhất trong cùng một dịch vụ ban đầu trả về tên đó. Nếu bạn sử dụng mục ánh xạ HTTP mặc định, |
metadata |
Siêu dữ liệu dành riêng cho dịch vụ được liên kết với thao tác. 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 những siêu dữ liệu như vậy. Bất kỳ phương thức nào 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ó. Đối tượng chứa các trường thuộc kiểu tuỳ ý. Trường |
done |
Nếu giá trị là |
Trường hợp result . Kết quả của thao tác có thể là error hoặc response hợp lệ. Nếu done == false , thì cả error và response đều không được đặt. Nếu done == true , bạn có thể đặt chính xác một trong hai thuộc tính 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: |
|
error |
Kết quả lỗi của thao tác trong trường hợp không thành công hoặc bị huỷ. |
response |
Phản hồi bình thường, thành công của thao tác. Nếu phương thức ban đầu không trả về dữ liệu khi thành công, chẳng hạn như Đối tượng chứa các trường thuộc kiểu tuỳ ý. Trường |
Phương thức |
|
---|---|
|
Bắt đầu quá trình huỷ không đồng bộ đối với một hoạt động diễn ra trong thời gian dài. |
|
Xoá một thao tác diễn ra trong thời gian dài. |
|
Nhận trạng thái mới nhất của một hoạt động diễn ra trong thời gian dài. |
|
Liệt kê những thao tác khớp với bộ lọc đã chỉ định trong yêu cầu. |