Lỗi

*Nội dung này được dịch bằng AI (Beta) và có thể có lỗi. Để xem trang này bằng tiếng Anh, hãy nhấp vào đây.

Các phần sau đây mô tả mô hình lỗi cho phương pháp tài nguyên v2 và v1, lần lượt.

mô hình lỗi tài nguyên v2

Mặc định, các phương pháp tài nguyên đáp ứng với tình trạng thái200 OK.Khi yêu cầu không thành công, Open Cloud trả lại mã lỗi tiêu chuẩn.Tất cả các phản hồi lỗi có cùng một định dạng, bao gồm:

  • code - Đại diện cho mã trạng thái HTTP.
  • message - Một tin nhắn giải thích lỗi.
  • details - Một đối tượng chứa thêm thông tin cụ thể về lỗi.
Ví dụ lỗi

{
"code": "INVALID_ARGUMENT",
"message": "The provided filter is invalid.",
"details": [
{
...
}
]
}

Bảng sau đây mô tả các giá trị có thể cho code .

Tình trạng HTTPMô tả
INVALID_ARGUMENT400Bạn đã truyền một tham số không hợp lệ, chẳng hạn như một tham số không hợp lệ universeId . Bạn cũng có thể thiếu hoặc không hợp lệ các tiêu đề, chẳng hạn như Content-LengthContent-Type .
PERMISSION_DENIED403Yêu cầu của bạn không có đủ quyền hoặc phạm vi để thực hiện hoạt động.
NOT_FOUND404Hệ thống không thể tìm thấy tài nguyên được định cấu hình của bạn, chẳng hạn như một lượt truy cập vào kho dữ liệu.
ABORTED409Hoạt động đã bị hủy.
RESOURCE_EXHAUSTED429Bạn không có đủ quota để thực hiện hoạt động, thường là do gửi quá nhiều yêu cầu.
CANCELLED499Hệ thống kết thúc yêu cầu, thường do thời gian chờ của phía khách hàng hết hạn.
INTERNAL500Lỗi máy chủ nội bộ, thường do lỗi máy chủ.
NOT_IMPLEMENTED501Máy chủ không thực hiện phương pháp API.
UNAVAILABLE503Dịch vụ không khả dụng, thường được trả lại khi máy chủ bị xuống.

mô hình lỗi tài nguyên v1

Tất cả các phản hồi lỗi có cùng một định dạng tiêu chuẩn, bao gồm:

  • Một trường error cấp cao, là nguyên nhân áp dụng cho tất cả các điểm cuối Open Cloud.
  • Một lỗi giải thích message, giải thích thêm lỗi.
  • Một đối tượng errorDetails, bao gồm thêm thông tin về lỗi cụ thể cho mỗi API.

Để phân tích nguyên nhân gốc của một lỗi, hãy tham khảo giá trị của trường error và trường errorDetails.Sử dụng trường message như một phần bổ sung cho xử lý lỗi, vì đôi khi nó có thể không bao gồm cùng mức chi tiết như trường errorDetails .

Ví dụ phản hồi lỗi của Cơ sở dữ liệu tiêu chuẩn

{
"error": "INVALID_ARGUMENT",
"message": "Invalid cursor.",
"errorDetails": [
{
"errorDetailType": "DatastoreErrorInfo",
"datastoreErrorCode": "InvalidCursor"
}
]
}

Phản hồi lỗi ví dụ hiển thị Open Cloud cấp cao error như INVALID_ARGUMENT , lỗi message như InvalidCursor , và errorDetails cụ thể cho lưu trữ dữ liệu với datastoreErrorCode như InvalidCursor .Từ các trường errordatastoreErrorCode của phản hồi, bạn có thể hiểu rằng bạn đã truyền một tham số con trỏ không hợp lệ gây ra lỗi.Bạn có thể chỉnh sửa tham số con trỏ của bạn để giải quyết vấn đề.

Tất cả các đáp ứng lỗi dữ liệu được yêu cầu đều có cùng một định dạng, bao gồm:

Ví dụ phản hồi lỗi của Cửa hàng dữ liệu được xếp hạng

{
"code": "INVALID_ARGUMENT",
"message": "Invalid cursor."
}

The code sẽ chứa một chuỗi lỗi cấp cao trong khi message sẽ chứa chi tiết cụ thể liên quan đến lỗi

Tham khảo bảng sau đây để có tổng quát tất cả các lỗi cấp cao của Đám mây Mở.

Mã trạng thái HTTPLỗiMô tả
400KHÔNG HỢP LỆ_ARGUMENTBạn đã truyền một tham số không hợp lệ, chẳng hạn như một tham số không hợp lệ universeId . Bạn cũng có thể thiếu hoặc không hợp lệ các tiêu đề, chẳng hạn như Content-LengthContent-Type .
403KHÔNG ĐỦ_SCOPEYêu cầu yêu cầu quyền cao hơn so với quyền được cung cấp bởi token truy cập.
403QUYỀN_TỪ CHỐIYêu cầu của bạn không có đủ phạm vi để thực hiện hoạt động.
404KHÔNG_TÌM_THẤYHệ thống không thể tìm thấy tài nguyên được định cấu hình của bạn, chẳng hạn như một kho lưu trữ dữ cửa hàng.
409BỊ HỦYHoạt động đã bị hủy do xung đột, chẳng hạn như xuất bản một nơi không thuộc vũ trụ.
429TÀI NGUYÊN_MỆT MỎIBạn không có đủ quota để thực hiện hoạt động, thường là do gửi quá nhiều yêu cầu.
499BỊ HUỶHệ thống kết thúc yêu cầu, thường do thời gian chờ của phía khách hàng hết hạn.
500NỘI BỘLỗi máy chủ nội bộ. Thông thường là lỗi máy chủ.
501KHÔNG_ÁP DỤNGMáy chủ không thực hiện phương pháp API.
503KHÔNG CÓ SẴNDịch vụ không có sẵn. Thông thường, máy chủ đang bị xuống.