com.google.rpc.Code Maven / Gradle / Ivy
The newest version!
// Generated by the protocol buffer compiler. DO NOT EDIT!
// source: google/rpc/code.proto
// Protobuf Java Version: 3.25.1
package com.google.rpc;
/**
*
* The canonical error codes for Google APIs.
* Warnings:
*
* - Do not change any numeric assignments.
* - Changes to this list should be made only if there is a compelling
* need that can't be satisfied in another way.
*
* Sometimes multiple error codes may apply. Services should return
* the most specific error code that applies. For example, prefer
* `OUT_OF_RANGE` over `FAILED_PRECONDITION` if both codes apply.
* Similarly prefer `NOT_FOUND` or `ALREADY_EXISTS` over `FAILED_PRECONDITION`.
*
*
* Protobuf enum {@code google.rpc.Code}
*/
public enum Code
implements com.google.protobuf.ProtocolMessageEnum {
/**
*
* Not an error; returned on success
*
* HTTP Mapping: 200 OK
*
*
* OK = 0;
*/
OK(0),
/**
*
* The operation was cancelled, typically by the caller.
*
* HTTP Mapping: 499 Client Closed Request
*
*
* CANCELLED = 1;
*/
CANCELLED(1),
/**
*
* Unknown error. For example, this error may be returned when
* a `Status` value received from another address space belongs to
* an error space that is not known in this address space. Also
* errors raised by APIs that do not return enough error information
* may be converted to this error.
*
* HTTP Mapping: 500 Internal Server Error
*
*
* UNKNOWN = 2;
*/
UNKNOWN(2),
/**
*
* The client specified an invalid argument. Note that this differs
* from `FAILED_PRECONDITION`. `INVALID_ARGUMENT` indicates arguments
* that are problematic regardless of the state of the system
* (e.g., a malformed file name).
*
* HTTP Mapping: 400 Bad Request
*
*
* INVALID_ARGUMENT = 3;
*/
INVALID_ARGUMENT(3),
/**
*
* The deadline expired before the operation could complete. For operations
* that change the state of the system, this error may be returned
* even if the operation has completed successfully. For example, a
* successful response from a server could have been delayed long
* enough for the deadline to expire.
*
* HTTP Mapping: 504 Gateway Timeout
*
*
* DEADLINE_EXCEEDED = 4;
*/
DEADLINE_EXCEEDED(4),
/**
*
* Some requested entity (e.g., file or directory) was not found.
* For privacy reasons, this code *might* be returned when the client
* does not have the access rights to the entity.
*
* HTTP Mapping: 404 Not Found
*
*
* NOT_FOUND = 5;
*/
NOT_FOUND(5),
/**
*
* The entity that a client attempted to create (e.g., file or directory)
* already exists.
*
* HTTP Mapping: 409 Conflict
*
*
* ALREADY_EXISTS = 6;
*/
ALREADY_EXISTS(6),
/**
*
* The caller does not have permission to execute the specified
* operation. `PERMISSION_DENIED` must not be used for rejections
* caused by exhausting some resource (use `RESOURCE_EXHAUSTED`
* instead for those errors). `PERMISSION_DENIED` must not be
* used if the caller can not be identified (use `UNAUTHENTICATED`
* instead for those errors).
*
* HTTP Mapping: 403 Forbidden
*
*
* PERMISSION_DENIED = 7;
*/
PERMISSION_DENIED(7),
/**
*
* The request does not have valid authentication credentials for the
* operation.
*
* HTTP Mapping: 401 Unauthorized
*
*
* UNAUTHENTICATED = 16;
*/
UNAUTHENTICATED(16),
/**
*
* Some resource has been exhausted, perhaps a per-user quota, or
* perhaps the entire file system is out of space.
*
* HTTP Mapping: 429 Too Many Requests
*
*
* RESOURCE_EXHAUSTED = 8;
*/
RESOURCE_EXHAUSTED(8),
/**
*
* 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
* (e.g., restarting a read-modify-write sequence).
* (c) Use `FAILED_PRECONDITION` 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, `FAILED_PRECONDITION`
* should be returned since the client should not retry unless
* the files are deleted from the directory.
* (d) Use `FAILED_PRECONDITION` 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.
*
* HTTP Mapping: 400 Bad Request
*
* NOTE: HTTP spec says `412 Precondition Failed` should be used only if
* the request contains Etag-related headers. So if the server does see
* Etag-related headers in the request, it may choose to return 412
* instead of 400 for this error code.
*
*
* FAILED_PRECONDITION = 9;
*/
FAILED_PRECONDITION(9),
/**
*
* The operation was aborted, typically due to a concurrency issue such as
* a sequencer check failure or transaction abort.
*
* See the guidelines above for deciding between `FAILED_PRECONDITION`,
* `ABORTED`, and `UNAVAILABLE`.
*
* HTTP Mapping: 409 Conflict
*
*
* ABORTED = 10;
*/
ABORTED(10),
/**
*
* The operation was attempted past the valid range. E.g., seeking or
* reading past end-of-file.
*
* Unlike `INVALID_ARGUMENT`, this error indicates a problem that may
* be fixed if the system state changes. For example, a 32-bit file
* system will generate `INVALID_ARGUMENT` if asked to read at an
* offset that is not in the range [0,2^32-1], but it will generate
* `OUT_OF_RANGE` if asked to read from an offset past the current
* file size.
*
* There is a fair bit of overlap between `FAILED_PRECONDITION` and
* `OUT_OF_RANGE`. We recommend using `OUT_OF_RANGE` (the more specific
* error) when it applies so that callers who are iterating through
* a space can easily look for an `OUT_OF_RANGE` error to detect when
* they are done.
*
* HTTP Mapping: 400 Bad Request
*
*
* OUT_OF_RANGE = 11;
*/
OUT_OF_RANGE(11),
/**
*
* The operation is not implemented or is not supported/enabled in this
* service.
*
* HTTP Mapping: 501 Not Implemented
*
*
* UNIMPLEMENTED = 12;
*/
UNIMPLEMENTED(12),
/**
*
* Internal errors. This means that some invariants expected by the
* underlying system have been broken. This error code is reserved
* for serious errors.
*
* HTTP Mapping: 500 Internal Server Error
*
*
* INTERNAL = 13;
*/
INTERNAL(13),
/**
*
* The service is currently unavailable. This is most likely a
* transient condition, which can be corrected by retrying with
* a backoff.
*
* See the guidelines above for deciding between `FAILED_PRECONDITION`,
* `ABORTED`, and `UNAVAILABLE`.
*
* HTTP Mapping: 503 Service Unavailable
*
*
* UNAVAILABLE = 14;
*/
UNAVAILABLE(14),
/**
*
* Unrecoverable data loss or corruption.
*
* HTTP Mapping: 500 Internal Server Error
*
*
* DATA_LOSS = 15;
*/
DATA_LOSS(15),
UNRECOGNIZED(-1),
;
/**
*
* Not an error; returned on success
*
* HTTP Mapping: 200 OK
*
*
* OK = 0;
*/
public static final int OK_VALUE = 0;
/**
*
* The operation was cancelled, typically by the caller.
*
* HTTP Mapping: 499 Client Closed Request
*
*
* CANCELLED = 1;
*/
public static final int CANCELLED_VALUE = 1;
/**
*
* Unknown error. For example, this error may be returned when
* a `Status` value received from another address space belongs to
* an error space that is not known in this address space. Also
* errors raised by APIs that do not return enough error information
* may be converted to this error.
*
* HTTP Mapping: 500 Internal Server Error
*
*
* UNKNOWN = 2;
*/
public static final int UNKNOWN_VALUE = 2;
/**
*
* The client specified an invalid argument. Note that this differs
* from `FAILED_PRECONDITION`. `INVALID_ARGUMENT` indicates arguments
* that are problematic regardless of the state of the system
* (e.g., a malformed file name).
*
* HTTP Mapping: 400 Bad Request
*
*
* INVALID_ARGUMENT = 3;
*/
public static final int INVALID_ARGUMENT_VALUE = 3;
/**
*
* The deadline expired before the operation could complete. For operations
* that change the state of the system, this error may be returned
* even if the operation has completed successfully. For example, a
* successful response from a server could have been delayed long
* enough for the deadline to expire.
*
* HTTP Mapping: 504 Gateway Timeout
*
*
* DEADLINE_EXCEEDED = 4;
*/
public static final int DEADLINE_EXCEEDED_VALUE = 4;
/**
*
* Some requested entity (e.g., file or directory) was not found.
* For privacy reasons, this code *might* be returned when the client
* does not have the access rights to the entity.
*
* HTTP Mapping: 404 Not Found
*
*
* NOT_FOUND = 5;
*/
public static final int NOT_FOUND_VALUE = 5;
/**
*
* The entity that a client attempted to create (e.g., file or directory)
* already exists.
*
* HTTP Mapping: 409 Conflict
*
*
* ALREADY_EXISTS = 6;
*/
public static final int ALREADY_EXISTS_VALUE = 6;
/**
*
* The caller does not have permission to execute the specified
* operation. `PERMISSION_DENIED` must not be used for rejections
* caused by exhausting some resource (use `RESOURCE_EXHAUSTED`
* instead for those errors). `PERMISSION_DENIED` must not be
* used if the caller can not be identified (use `UNAUTHENTICATED`
* instead for those errors).
*
* HTTP Mapping: 403 Forbidden
*
*
* PERMISSION_DENIED = 7;
*/
public static final int PERMISSION_DENIED_VALUE = 7;
/**
*
* The request does not have valid authentication credentials for the
* operation.
*
* HTTP Mapping: 401 Unauthorized
*
*
* UNAUTHENTICATED = 16;
*/
public static final int UNAUTHENTICATED_VALUE = 16;
/**
*
* Some resource has been exhausted, perhaps a per-user quota, or
* perhaps the entire file system is out of space.
*
* HTTP Mapping: 429 Too Many Requests
*
*
* RESOURCE_EXHAUSTED = 8;
*/
public static final int RESOURCE_EXHAUSTED_VALUE = 8;
/**
*
* 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
* (e.g., restarting a read-modify-write sequence).
* (c) Use `FAILED_PRECONDITION` 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, `FAILED_PRECONDITION`
* should be returned since the client should not retry unless
* the files are deleted from the directory.
* (d) Use `FAILED_PRECONDITION` 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.
*
* HTTP Mapping: 400 Bad Request
*
* NOTE: HTTP spec says `412 Precondition Failed` should be used only if
* the request contains Etag-related headers. So if the server does see
* Etag-related headers in the request, it may choose to return 412
* instead of 400 for this error code.
*
*
* FAILED_PRECONDITION = 9;
*/
public static final int FAILED_PRECONDITION_VALUE = 9;
/**
*
* The operation was aborted, typically due to a concurrency issue such as
* a sequencer check failure or transaction abort.
*
* See the guidelines above for deciding between `FAILED_PRECONDITION`,
* `ABORTED`, and `UNAVAILABLE`.
*
* HTTP Mapping: 409 Conflict
*
*
* ABORTED = 10;
*/
public static final int ABORTED_VALUE = 10;
/**
*
* The operation was attempted past the valid range. E.g., seeking or
* reading past end-of-file.
*
* Unlike `INVALID_ARGUMENT`, this error indicates a problem that may
* be fixed if the system state changes. For example, a 32-bit file
* system will generate `INVALID_ARGUMENT` if asked to read at an
* offset that is not in the range [0,2^32-1], but it will generate
* `OUT_OF_RANGE` if asked to read from an offset past the current
* file size.
*
* There is a fair bit of overlap between `FAILED_PRECONDITION` and
* `OUT_OF_RANGE`. We recommend using `OUT_OF_RANGE` (the more specific
* error) when it applies so that callers who are iterating through
* a space can easily look for an `OUT_OF_RANGE` error to detect when
* they are done.
*
* HTTP Mapping: 400 Bad Request
*
*
* OUT_OF_RANGE = 11;
*/
public static final int OUT_OF_RANGE_VALUE = 11;
/**
*
* The operation is not implemented or is not supported/enabled in this
* service.
*
* HTTP Mapping: 501 Not Implemented
*
*
* UNIMPLEMENTED = 12;
*/
public static final int UNIMPLEMENTED_VALUE = 12;
/**
*
* Internal errors. This means that some invariants expected by the
* underlying system have been broken. This error code is reserved
* for serious errors.
*
* HTTP Mapping: 500 Internal Server Error
*
*
* INTERNAL = 13;
*/
public static final int INTERNAL_VALUE = 13;
/**
*
* The service is currently unavailable. This is most likely a
* transient condition, which can be corrected by retrying with
* a backoff.
*
* See the guidelines above for deciding between `FAILED_PRECONDITION`,
* `ABORTED`, and `UNAVAILABLE`.
*
* HTTP Mapping: 503 Service Unavailable
*
*
* UNAVAILABLE = 14;
*/
public static final int UNAVAILABLE_VALUE = 14;
/**
*
* Unrecoverable data loss or corruption.
*
* HTTP Mapping: 500 Internal Server Error
*
*
* DATA_LOSS = 15;
*/
public static final int DATA_LOSS_VALUE = 15;
public final int getNumber() {
if (this == UNRECOGNIZED) {
throw new java.lang.IllegalArgumentException(
"Can't get the number of an unknown enum value.");
}
return value;
}
/**
* @param value The numeric wire value of the corresponding enum entry.
* @return The enum associated with the given numeric wire value.
* @deprecated Use {@link #forNumber(int)} instead.
*/
@java.lang.Deprecated
public static Code valueOf(int value) {
return forNumber(value);
}
/**
* @param value The numeric wire value of the corresponding enum entry.
* @return The enum associated with the given numeric wire value.
*/
public static Code forNumber(int value) {
switch (value) {
case 0: return OK;
case 1: return CANCELLED;
case 2: return UNKNOWN;
case 3: return INVALID_ARGUMENT;
case 4: return DEADLINE_EXCEEDED;
case 5: return NOT_FOUND;
case 6: return ALREADY_EXISTS;
case 7: return PERMISSION_DENIED;
case 16: return UNAUTHENTICATED;
case 8: return RESOURCE_EXHAUSTED;
case 9: return FAILED_PRECONDITION;
case 10: return ABORTED;
case 11: return OUT_OF_RANGE;
case 12: return UNIMPLEMENTED;
case 13: return INTERNAL;
case 14: return UNAVAILABLE;
case 15: return DATA_LOSS;
default: return null;
}
}
public static com.google.protobuf.Internal.EnumLiteMap
internalGetValueMap() {
return internalValueMap;
}
private static final com.google.protobuf.Internal.EnumLiteMap<
Code> internalValueMap =
new com.google.protobuf.Internal.EnumLiteMap() {
public Code findValueByNumber(int number) {
return Code.forNumber(number);
}
};
public final com.google.protobuf.Descriptors.EnumValueDescriptor
getValueDescriptor() {
if (this == UNRECOGNIZED) {
throw new java.lang.IllegalStateException(
"Can't get the descriptor of an unrecognized enum value.");
}
return getDescriptor().getValues().get(ordinal());
}
public final com.google.protobuf.Descriptors.EnumDescriptor
getDescriptorForType() {
return getDescriptor();
}
public static final com.google.protobuf.Descriptors.EnumDescriptor
getDescriptor() {
return com.google.rpc.CodeProto.getDescriptor().getEnumTypes().get(0);
}
private static final Code[] VALUES = values();
public static Code valueOf(
com.google.protobuf.Descriptors.EnumValueDescriptor desc) {
if (desc.getType() != getDescriptor()) {
throw new java.lang.IllegalArgumentException(
"EnumValueDescriptor is not for this type.");
}
if (desc.getIndex() == -1) {
return UNRECOGNIZED;
}
return VALUES[desc.getIndex()];
}
private final int value;
private Code(int value) {
this.value = value;
}
// @@protoc_insertion_point(enum_scope:google.rpc.Code)
}