Mã lỗi chính tắc cho các 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 áp dụng. Ví dụ: ưu tiên OUT_OF_RANGE
hơn FAILED_PRECONDITION
nếu có cả hai mã. Tương tự, bạn thích NOT_FOUND
hoặc ALREADY_EXISTS
hơn FAILED_PRECONDITION
.
Enum | |
---|---|
OK |
Không phải lỗi; trả về khi thành công. Liên kết HTTP: 200 OK |
CANCELLED |
Thao tác này đã bị huỷ, thường là do người gọi thực hiện. Liên kết HTTP: 499 Yêu cầu đã đóng của ứng dụng |
UNKNOWN |
Lỗi không xác định. Ví dụ: có thể trả về lỗi này khi giá trị Liên kết HTTP: Lỗi 500 máy chủ nội bộ |
INVALID_ARGUMENT |
Máy khách đã chỉ định một đối số không hợp lệ. Xin lưu ý rằng giá trị này khác với Liên kết HTTP: 400 yêu cầu không hợp lệ |
DEADLINE_EXCEEDED |
Hạn chót đã hết hạn trước khi thao tác có thể hoàn tất. Đối với các thao tác thay đổi trạng thái của hệ thống, lỗi này có thể được trả về ngay cả khi thao tác đã 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 để thời hạn hết hạn. Liên kết HTTP: Hết thời gian chờ 504 cổng |
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 yêu cầu bị từ chối đối với toàn bộ lớp 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ó tài liệu, thì Liên kết HTTP: Không tìm thấy 404 |
ALREADY_EXISTS |
Mục mà khách hà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 |
Người 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 hoạt động này. Liên kết HTTP: 401 trái phép |
RESOURCE_EXHAUSTED |
Một số tài nguyên đã hết, có thể là định 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 được để 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. Trình 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 |
Thao tác này đã 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. Hãy 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 |
Hoạt động đã được cố gắng vượt quá phạm vi hợp lệ. Ví dụ: tìm hoặc đọc tệp cuối tệp trước đó. 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ợ/được 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 lỗi nghiêm trọng. Liên kết HTTP: Lỗi 500 máy chủ nội bộ |
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, có thể khắc phục bằng cách thử lại bằng một khoảng thời gian đợi. Xin 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 cụ thể. Hãy 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 khả dụng |
DATA_LOSS |
Lỗi hoặc sự cố mất dữ liệu không thể khôi phục. Liên kết HTTP: Lỗi 500 máy chủ nội bộ |