Exception: Google::Cloud::FailedPreconditionError

Inherits:
Error
  • Object
show all
Defined in:
lib/google/cloud/errors.rb

Overview

FailedPrecondition indicates operation was rejected because the system is not in a state required for the operation's execution. For example, directory to be deleted may be non-empty, an rmdir operation is applied to a non-directory, etc.

A litmus test that may help a service implementor in deciding between FailedPrecondition, 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 (e.g., restarting a read-modify-write sequence). (c) Use FailedPrecondition if the client should not retry until the system state has been explicitly fixed. E.g., if an "rmdir" fails because the directory is non-empty, FailedPrecondition should be returned since the client should not retry unless they have first fixed up the directory by deleting files from it. (d) Use FailedPrecondition if the client performs conditional REST Get/Update/Delete on a resource and the resource on the server does not match the condition. E.g., conflicting read-modify-write on the same resource.

Instance Method Summary collapse

Methods inherited from Error

#body, #details, #domain, #error_info, #error_metadata, #header, #initialize, #metadata, #reason, #status_code, #status_details

Constructor Details

This class inherits a constructor from Google::Cloud::Error

Instance Method Details

#code ⇒ Integer

gRPC error code for FAILED_PRECONDITION

Returns:

  • (Integer) 


371
372
373
 
# File 'lib/google/cloud/errors.rb', line 371

def code
  9
end