Mã lỗi chính tắc cho API gRPC.
Đôi khi, có thể áp dụng nhiều mã lỗi. Dịch vụ sẽ trả về mã lỗi cụ thể nhất có thể áp dụng. Ví dụ: ưu tiên OUT_OF_RANGE hơn FAILED_PRECONDITION nếu áp dụng cả hai mã. Tương tự như vậy, hãy ưu tiên NOT_FOUND hoặc ALREADY_EXISTS hơn FAILED_PRECONDITION.
| Enum | |
|---|---|
OK |
Không phải là lỗi; đã trả về thành công. Liên kết HTTP: 200 OK |
CANCELLED |
Thao tác đã bị huỷ, thường là do người gọi thực hiện. Liên kết HTTP: Yêu cầu đã đóng ứng dụng khách 499 |
UNKNOWN |
Lỗi không xác định. Ví dụ: lỗi này có thể được trả về khi một giá trị Liên kết HTTP: Lỗi máy chủ nội bộ 500 |
INVALID_ARGUMENT |
Máy khách đã chỉ định một đối số không hợp lệ. Vui lòng lưu ý điều này khác với Liên kết HTTP: 400 yêu cầu không hợp lệ |
DEADLINE_EXCEEDED |
Thời hạn đã hết hạn trước khi hoạt động có thể hoàn tất. Đối với các hoạt động thay đổi trạng thái của hệ thống, lỗi này có thể được trả về ngay cả khi hoạt động đã hoàn tất thành công. Ví dụ: phản hồi thành công từ máy chủ có thể đã bị trì hoãn đủ lâu để hết hạn. Liên kết HTTP: Thời gian chờ cổng 504 |
NOT_FOUND |
Không tìm thấy một số thực thể được yêu cầu (ví dụ: tệp hoặc thư mục). Lưu ý dành cho nhà phát triển máy chủ: nếu một yêu cầu bị từ chối đối với toàn bộ một nhóm người dùng, chẳng hạn như phát hành tính năng dần dần hoặc danh sách cho phép không được ghi lại, thì hệ thống có thể sử dụng Liên kết HTTP: Không tìm thấy lỗi 404 |
ALREADY_EXISTS |
Mục mà ứng dụng đã cố gắng tạo (ví dụ: tệp hoặc thư mục) đã tồn tại. Liên kết HTTP: Xung đột 409 |
PERMISSION_DENIED |
Phương thức gọi không có quyền thực thi thao tác đã chỉ định. Không được dùng Liên kết HTTP: 403 bị cấm |
UNAUTHENTICATED |
Yêu cầu không có thông tin xác thực hợp lệ cho thao tác. Liên kết HTTP: 401 trái phép |
RESOURCE_EXHAUSTED |
Một số tài nguyên đã hết, có thể là hạn mức cho mỗi người dùng hoặc có thể là toàn bộ hệ thống tệp đã hết dung lượng. Liên kết HTTP: 429 Quá nhiều yêu cầu |
FAILED_PRECONDITION |
Thao tác này đã bị từ chối vì hệ thống không ở trạng thái cần thiết để thực thi thao tác. Ví dụ: thư mục cần xoá không để trống, thao tác rmdir được áp dụng cho một thư mục không phải thư mục, v.v. Người triển khai dịch vụ có thể sử dụng các nguyên tắc sau để quyết định giữa Liên kết HTTP: 400 yêu cầu không hợp lệ |
ABORTED |
Hoạt động bị huỷ, thường là do vấn đề đồng thời, chẳng hạn như lỗi kiểm tra trình tự hoặc huỷ giao dịch. Xem các nguyên tắc ở trên để quyết định giữa Liên kết HTTP: Xung đột 409 |
OUT_OF_RANGE |
Thao tác đã được thực hiện ngoài phạm vi hợp lệ. Ví dụ: tìm kiếm hoặc đọc cuối tệp. Không giống như Có một chút trùng lặp giữa Liên kết HTTP: 400 yêu cầu không hợp lệ |
UNIMPLEMENTED |
Thao tác này không được triển khai hoặc không được hỗ trợ/bật trong dịch vụ này. Liên kết HTTP: 501 chưa được triển khai |
INTERNAL |
Lỗi nội bộ. Điều này có nghĩa là một số biến thể dự kiến do hệ thống cơ bản dự kiến đã bị hỏng. Mã lỗi này được dành riêng cho các lỗi nghiêm trọng. Liên kết HTTP: Lỗi máy chủ nội bộ 500 |
UNAVAILABLE |
Dịch vụ này hiện không dùng được. Đây rất có thể là một tình trạng tạm thời. Điều kiện này có thể khắc phục bằng cách thử lại với thời gian đợi. Lưu ý rằng không phải lúc nào bạn cũng có thể thử lại các thao tác không đúng cách. Xem các nguyên tắc ở trên để quyết định giữa Liên kết HTTP: Dịch vụ 503 không hoạt động |
DATA_LOSS |
Lỗi dữ liệu không thể khôi phục hoặc bị hỏng. Liên kết HTTP: Lỗi máy chủ nội bộ 500 |