code | 数 | 描述 |
---|---|---|
OK | 0 | 不是错误;成功返回。 |
CANCELLED | 1 | 操作通常由调用方取消。 |
UNKNOWN | 2 | 未知错误。例如,当从另一个地址空间接收的值属于此地址空间中未知的错误空间时,可能会返回此错误。此外,未返回足够错误信息的 API 引发的错误可能会转换为此错误。Status |
INVALID_ARGUMENT | 3 | 客户端指定了无效的参数。请注意,这与 不同。 表示无论系统状态如何(例如,文件格式不正确)都存在问题的参数。FAILED_PRECONDITION INVALID_ARGUMENT |
DEADLINE_EXCEEDED | 4 | 截止时间在操作完成之前已过期。对于更改系统状态的操作,即使操作已成功完成,也可能会返回此错误。例如,来自服务器的成功响应可能会延迟很长时间 |
NOT_FOUND | 5 | 未找到某些请求的实体(例如,文件或目录)。服务器开发人员注意:如果整个类别的用户的请求被拒绝,则可以使用逐步推出功能或未记录的允许列表。如果拒绝一类用户中某些用户的请求,则必须使用基于用户的访问控制。NOT_FOUND PERMISSION_DENIED |
ALREADY_EXISTS | 6 | 客户端尝试创建的实体(例如,文件或目录)已存在。 |
PERMISSION_DENIED | 7 | 调用方没有执行指定操作的权限。 不得用于因耗尽某些资源而导致的拒绝(改用这些错误)。 如果无法识别调用方,则不得使用(对于这些错误,则改用)。此错误代码并不意味着请求有效,也不表示请求的实体存在或满足其他前提条件。PERMISSION_DENIEDRESOURCE_EXHAUSTEDPERMISSION_DENIEDUNAUTHENTICATED |
RESOURCE_EXHAUSTED | 8 | 某些资源已用尽,可能是每个用户的配额,或者可能是整个文件系统空间不足。 |
FAILED_PRECONDITION | 9 | 该操作被拒绝,因为系统未处于执行该操作所需的状态。例如,要删除的目录为非空目录,将 rmdir 操作应用于非目录等。服务实现者可以使用以下准则来决定 、 和 : (a) 如果客户端可以只重试失败的调用,则使用。(b) 如果客户端应该在更高级别重试(例如,当客户端指定的测试和设置失败时,指示客户端应重新启动读-修改-写入序列),则使用该命令。(c) 如果客户端在系统状态被显式修复之前不应重试,则使用。例如,如果“rmdir”因为目录不为空而失败,则应返回,因为除非从目录中删除文件,否则客户端不应重试。FAILED_PRECONDITIONABORTEDUNAVAILABLEUNAVAILABLEABORTEDFAILED_PRECONDITIONFAILED_PRECONDITION |
ABORTED | 10 | 操作已中止,通常是由于并发问题(如排序器检查失败或事务中止)造成的。请参阅上面的准则,在 、 和 之间做出决定。FAILED_PRECONDITION ABORTED UNAVAILABLE |
OUT_OF_RANGE | 11 | 尝试的操作超出了有效范围。例如,查找或读取过去的文件末尾。与 不同,此错误表示如果系统状态发生更改,该问题可能会得到解决。例如,如果要求以不在 [32,0^2-32] 范围内的偏移量读取,则将生成 1 位文件系统,但如果要求从超过当前文件大小的偏移量读取,则将生成 <> 位文件系统。和 之间存在相当多的重叠。我们建议在应用时使用(更具体的错误),以便循环访问空间的调用方可以轻松查找错误以检测错误何时完成。INVALID_ARGUMENTINVALID_ARGUMENTOUT_OF_RANGEFAILED_PRECONDITIONOUT_OF_RANGEOUT_OF_RANGEOUT_OF_RANGE |
UNIMPLEMENTED | 12 | 此服务中未实现或不支持/启用该操作。 |
INTERNAL | 13 | 内部错误。这意味着底层系统预期的一些不变量已被打破。此错误代码保留用于严重错误。 |
UNAVAILABLE | 14 | 该服务目前不可用。这很可能是暂时性情况,可以通过回退重试来纠正。请注意,重试非幂等操作并不总是安全的。 |
DATA_LOSS | 15 | 不可恢复的数据丢失或损坏。 |
UNAUTHENTICATED | 16 | 该请求没有用于该操作的有效身份验证凭据。 |
GRPC 错误码表
最新推荐文章于 2024-05-28 15:09:10 发布
![](https://img-home.csdnimg.cn/images/20240711042549.png)