Package google.longrunning

Chỉ mục

Vận hành

Quản lý các thao tác diễn ra trong thời gian dài bằng một dịch vụ API.

Khi một phương thức API thường mất nhiều thời gian để hoàn tất, phương thức đó có thể được thiết kế để trả về Operation cho ứng dụng và ứng dụng có thể sử dụng giao diện này để nhận phản hồi thực một cách không đồng bộ bằng cách thăm dò tài nguyên thao tác hoặc truyền tài nguyên thao tác đến một API khác (chẳng hạn như Pub/Sub API) để nhận phản hồi. Mọi dịch vụ API trả về các thao tác diễn ra trong thời gian dài đều phải triển khai giao diện Operations để nhà phát triển có thể có trải nghiệm nhất quán với ứng dụng.

CancelOperation

rpc CancelOperation(CancelOperationRequest) returns (Empty)

(Hiện không được hỗ trợ) Bắt đầu huỷ không đồng bộ trên một thao tác chạy trong thời gian dài.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/cloud-platform
DeleteOperation

rpc DeleteOperation(DeleteOperationRequest) returns (Empty)

(Hiện không được hỗ trợ) Xoá một thao tác diễn ra trong thời gian dài.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/cloud-platform
GetOperation

rpc GetOperation(GetOperationRequest) returns (Operation)

Nhận trạng thái mới nhất của một thao tác diễn ra trong thời gian dài. Ứng dụng có thể dùng phương thức này để thăm dò kết quả của một thao tác theo khoảng thời gian do dịch vụ API đề xuất.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/cloud-platform
Quyền IAM

Yêu cầu quyền IAM sau đây đối với tài nguyên name:

  • routeoptimization.operations.get

Để biết thêm thông tin, hãy xem tài liệu về IAM.
ListOperations

rpc ListOperations(ListOperationsRequest) returns (ListOperationsResponse)

(Hiện không được hỗ trợ) Liệt kê các thao tác khớp với bộ lọc được chỉ định trong yêu cầu.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/cloud-platform
WaitOperation

rpc WaitOperation(WaitOperationRequest) returns (Operation)

(Hiện không được hỗ trợ) Chờ cho đến khi thao tác diễn ra trong thời gian dài được chỉ định hoàn tất hoặc đạt đến thời gian chờ tối đa được chỉ định, trả về trạng thái mới nhất.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/cloud-platform

CancelOperationRequest

Thông báo yêu cầu cho Operations.CancelOperation.

Trường
name

string

Tên của tài nguyên liên quan đến thao tác cần huỷ.

DeleteOperationRequest

Thông báo yêu cầu cho Operations.DeleteOperation.

Trường
name

string

Tên của tài nguyên liên quan đến thao tác cần xoá.

GetOperationRequest

Thông báo yêu cầu cho Operations.GetOperation.

Trường
name

string

Tên của tài nguyên liên quan đến thao tác.

ListOperationsRequest

Thông báo yêu cầu cho Operations.ListOperations.

Trường
name

string

Tên của tài nguyên mẹ của thao tác.
filter

string

Bộ lọc danh sách tiêu chuẩn.
page_size

int32

Kích thước trang danh sách tiêu chuẩn.
page_token

string

Mã thông báo trang danh sách chuẩn.
return_partial_success

bool

Khi được đặt thành true, các thao tác có thể truy cập sẽ được trả về như bình thường và những thao tác không thể truy cập sẽ được trả về trong trường ListOperationsResponse.unreachable.

Giá trị này chỉ có thể là true khi đọc trên các tập hợp. Ví dụ: khi parent được đặt thành "projects/example/locations/-".

Theo mặc định, trường này không được hỗ trợ và sẽ dẫn đến lỗi UNIMPLEMENTED nếu được đặt, trừ phi được ghi lại rõ ràng trong tài liệu cụ thể về dịch vụ hoặc sản phẩm.

ListOperationsResponse

Thông báo phản hồi cho Operations.ListOperations.

Trường
operations[]

Operation

Danh sách các thao tác khớp với bộ lọc được chỉ định trong yêu cầu.
next_page_token

string

Mã thông báo trang tiếp theo của Danh sách tiêu chuẩn.
unreachable[]

string

Danh sách không theo thứ tự. Tài nguyên không truy cập được. Được điền sẵn khi yêu cầu đặt ListOperationsRequest.return_partial_success và đọc trên các bộ sưu tập. Ví dụ: khi cố gắng liệt kê tất cả tài nguyên ở tất cả các vị trí được hỗ trợ.

Hoạt động

Tài nguyên này đại diện cho một thao tác diễn ra trong thời gian dài, là kết quả của một lệnh gọi API mạng.

Trường
name

string

Tên do máy chủ chỉ định, chỉ mang tính duy nhất trong cùng một dịch vụ ban đầu trả về tên đó. Nếu bạn sử dụng á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ụ liên kết với thao tác. Thường thì siêu dữ liệu này chứa thông tin về tiến trình và siêu dữ liệu chung, chẳng hạn như thời gian tạo. Có thể một số dịch vụ sẽ không cung cấp siêu dữ liệu như vậy. Mọi phương thức có trả về một thao tác 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, tức là thao tác vẫn đang diễn ra. Nếu true, thao tác đã hoàn tất và có thể dùng error hoặc response.
Trường nhóm result. Kết quả của thao tác, có thể là error hoặc response hợp lệ. Nếu done == false, thì error và response đều không được thiết lập. Nếu done == true, bạn chỉ có thể thiết lập một trong hai tham số error hoặc response. Có thể một số dịch vụ sẽ không cung cấp kết quả. result chỉ có thể là một trong những trạng thái sau:
error

Status

Kết quả chỉ thao tác bị lỗi trong trường hợp không thành công hoặc huỷ.
response

Any

Phản hồi bình thường, thao tác thành công. 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ư Delete, thì phản hồi sẽ là google.protobuf.Empty. Nếu phương thức ban đầu là Get/Create/Update tiêu 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 là 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ì suy ra loại phản hồi là TakeSnapshotResponse.

WaitOperationRequest

Thông báo yêu cầu cho Operations.WaitOperation.

Trường
name

string

Tên của tài nguyên liên quan đến thao tác cần chờ.
timeout

Duration

Thời lượng tối đa để chờ trước khi hết thời gian chờ. Nếu bạn để trống, thời gian chờ sẽ tối đa bằng thời gian mà giao thức HTTP/RPC cơ bản cho phép. Nếu bạn cũng chỉ định thời hạn của ngữ cảnh RPC, thì thời hạn ngắn hơn sẽ được sử dụng.