Error Code Portal
GoogleGoogle APIs / gRPCError code

FAILED_PRECONDITION

FAILED PRECONDITION

Alternative forms: 9 · google.rpc.Code.FAILED_PRECONDITION

Code FAILED_PRECONDITION · An issue reported by Google APIs / gRPC.

The operation was rejected because the system is not in a state required for the operation's execution. For example, the directory to be deleted is non-empty, an rmdir operation is applied to a non-directory, etc. Service implementors can use the following guidelines to decide between `FAILED_PRECONDITION`, `ABORTED`, and `UNAVAILABLE`: (a) Use `UNAVAILABLE` if the client can retry just the failing call. (b) Use `ABORTED` if the client should retry at a higher level. For example, when a client-specified test-and-set fails, indicating the client should restart a read-modify-write sequence. (c) Use `FAILED_PRECONDITION` if the client should not retry until the system state has been explicitly fixed. For example, if an "rmdir" fails because the directory is non-empty, `FAILED_PRECONDITION` should be returned since the client should not retry unless the files are deleted from the directory. HTTP Mapping: 400 Bad Request

Troubleshooting and diagnostic links

First check that the document's product, version, and environment match your situation.