java.lang.Object
- io.opencensus.trace.Status

```
@Immutable
public final class Status
extends java.lang.Object
```
Defines the status of a Span by providing a standard Status.CanonicalCode in conjunction with an optional descriptive message. Instances of Status are created by starting with the template for the appropriate Status.CanonicalCode and supplementing it with additional information: Status.NOT_FOUND.withDescription("Could not find 'important_file.txt'");

Since:

0.5

Nested Class Summary

Nested Classes
Modifier and Type Class Description

static class Status.CanonicalCode
The set of canonical status codes.

Field Summary

Fields
Modifier and Type	Field	Description
`static Status`	`ABORTED`	The operation was aborted, typically due to a concurrency issue like sequencer check failures, transaction aborts, etc.
`static Status`	`ALREADY_EXISTS`	Some entity that we attempted to create (e.g., file or directory) already exists.
`static Status`	`CANCELLED`	The operation was cancelled (typically by the caller).
`private Status.CanonicalCode`	`canonicalCode`
`static Status`	`DATA_LOSS`	Unrecoverable data loss or corruption.
`static Status`	`DEADLINE_EXCEEDED`	Deadline expired before operation could complete.
`private java.lang.String`	`description`
`static Status`	`FAILED_PRECONDITION`	Operation was rejected because the system is not in a state required for the operation's execution.
`static Status`	`INTERNAL`	Internal errors.
`static Status`	`INVALID_ARGUMENT`	Client specified an invalid argument.
`static Status`	`NOT_FOUND`	Some requested entity (e.g., file or directory) was not found.
`static Status`	`OK`	The operation completed successfully.
`static Status`	`OUT_OF_RANGE`	Operation was attempted past the valid range.
`static Status`	`PERMISSION_DENIED`	The caller does not have permission to execute the specified operation.
`static Status`	`RESOURCE_EXHAUSTED`	Some resource has been exhausted, perhaps a per-user quota, or perhaps the entire file system is out of space.
`private static java.util.List<Status>`	`STATUS_LIST`
`static Status`	`UNAUTHENTICATED`	The request does not have valid authentication credentials for the operation.
`static Status`	`UNAVAILABLE`	The service is currently unavailable.
`static Status`	`UNIMPLEMENTED`	Operation is not implemented or not supported/enabled in this service.
`static Status`	`UNKNOWN`	Unknown error.

Constructor Summary

Constructors
Modifier Constructor Description

private Status(Status.CanonicalCode canonicalCode, java.lang.String description)

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method	Description
`private static java.util.List<Status>`	`buildStatusList()`
`boolean`	`equals(java.lang.Object obj)`	Equality on Statuses is not well defined.
`Status.CanonicalCode`	`getCanonicalCode()`	Returns the canonical status code.
`java.lang.String`	`getDescription()`	Returns the description of this `Status` for human consumption.
`int`	`hashCode()`	Hash codes on Statuses are not well defined.
`boolean`	`isOk()`	Returns `true` if this `Status` is OK, i.e., not an error.
`java.lang.String`	`toString()`
`Status`	`withDescription(java.lang.String description)`	Creates a derived instance of `Status` with the given description.

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

- Field Detail
  - STATUS_LIST
```
private static final java.util.List<Status> STATUS_LIST
```
  - OK
```
public static final Status OK
```
    The operation completed successfully.
    
    Since:
    
    0.5
  - CANCELLED
```
public static final Status CANCELLED
```
    The operation was cancelled (typically by the caller).
    
    Since:
    
    0.5
  - UNKNOWN
```
public static final Status UNKNOWN
```
    Unknown error. See Status.CanonicalCode.UNKNOWN.
    
    Since:
    
    0.5
  - INVALID_ARGUMENT
```
public static final Status INVALID_ARGUMENT
```
    Client specified an invalid argument. See Status.CanonicalCode.INVALID_ARGUMENT.
    
    Since:
    
    0.5
  - DEADLINE_EXCEEDED
```
public static final Status DEADLINE_EXCEEDED
```
    Deadline expired before operation could complete. See Status.CanonicalCode.DEADLINE_EXCEEDED.
    
    Since:
    
    0.5
  - NOT_FOUND
```
public static final Status NOT_FOUND
```
    Some requested entity (e.g., file or directory) was not found.
    
    Since:
    
    0.5
  - ALREADY_EXISTS
```
public static final Status ALREADY_EXISTS
```
    Some entity that we attempted to create (e.g., file or directory) already exists.
    
    Since:
    
    0.5
  - PERMISSION_DENIED
```
public static final Status PERMISSION_DENIED
```
    The caller does not have permission to execute the specified operation. See Status.CanonicalCode.PERMISSION_DENIED.
    
    Since:
    
    0.5
  - UNAUTHENTICATED
```
public static final Status UNAUTHENTICATED
```
    The request does not have valid authentication credentials for the operation.
    
    Since:
    
    0.5
  - RESOURCE_EXHAUSTED
```
public static final Status RESOURCE_EXHAUSTED
```
    Some resource has been exhausted, perhaps a per-user quota, or perhaps the entire file system is out of space.
    
    Since:
    
    0.5
  - FAILED_PRECONDITION
```
public static final Status FAILED_PRECONDITION
```
    Operation was rejected because the system is not in a state required for the operation's execution. See Status.CanonicalCode.FAILED_PRECONDITION.
    
    Since:
    
    0.5
  - ABORTED
```
public static final Status ABORTED
```
    The operation was aborted, typically due to a concurrency issue like sequencer check failures, transaction aborts, etc. See Status.CanonicalCode.ABORTED.
    
    Since:
    
    0.5
  - OUT_OF_RANGE
```
public static final Status OUT_OF_RANGE
```
    Operation was attempted past the valid range. See Status.CanonicalCode.OUT_OF_RANGE.
    
    Since:
    
    0.5
  - UNIMPLEMENTED
```
public static final Status UNIMPLEMENTED
```
    Operation is not implemented or not supported/enabled in this service.
    
    Since:
    
    0.5
  - INTERNAL
```
public static final Status INTERNAL
```
    Internal errors. See Status.CanonicalCode.INTERNAL.
    
    Since:
    
    0.5
  - UNAVAILABLE
```
public static final Status UNAVAILABLE
```
    The service is currently unavailable. See Status.CanonicalCode.UNAVAILABLE.
    
    Since:
    
    0.5
  - DATA_LOSS
```
public static final Status DATA_LOSS
```
    Unrecoverable data loss or corruption.
    
    Since:
    
    0.5
  - canonicalCode
```
private final Status.CanonicalCode canonicalCode
```
  - description
```
@Nullable
private final java.lang.String description
```
- Constructor Detail
  - Status
```
private Status(Status.CanonicalCode canonicalCode,
               @Nullable
               java.lang.String description)
```
- Method Detail
  - buildStatusList
```
private static java.util.List<Status> buildStatusList()
```
  - withDescription
```
public Status withDescription(@Nullable
                              java.lang.String description)
```
    Creates a derived instance of Status with the given description.
    
    Parameters:
    
    description - the new description of the Status.
    
    Returns:
    
    The newly created Status with the given description.
    
    Since:
    
    0.5
  - getCanonicalCode
```
public Status.CanonicalCode getCanonicalCode()
```
    Returns the canonical status code.
    
    Returns:
    
    the canonical status code.
    
    Since:
    
    0.5
  - getDescription
```
@Nullable
public java.lang.String getDescription()
```
    Returns the description of this Status for human consumption.
    
    Returns:
    
    the description of this Status.
    
    Since:
    
    0.5
  - isOk
```
public boolean isOk()
```
    Returns true if this Status is OK, i.e., not an error.
    
    Returns:
    
    true if this Status is OK.
    
    Since:
    
    0.5
  - equals
```
public boolean equals(@Nullable
                      java.lang.Object obj)
```
    Equality on Statuses is not well defined. Instead, do comparison based on their CanonicalCode with getCanonicalCode(). The description of the Status is unlikely to be stable, and additional fields may be added to Status in the future.
    
    Overrides:
    
    equals in class java.lang.Object
  - hashCode
```
public int hashCode()
```
    Hash codes on Statuses are not well defined.
    
    Overrides:
    
    hashCode in class java.lang.Object
    
    See Also:
    
    equals(java.lang.Object)
  - toString
```
public java.lang.String toString()
```
    Overrides:
    
    toString in class java.lang.Object

Class Status

Nested Class Summary

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

STATUS_LIST

OK

CANCELLED

UNKNOWN

INVALID_ARGUMENT

DEADLINE_EXCEEDED

NOT_FOUND

ALREADY_EXISTS

PERMISSION_DENIED

UNAUTHENTICATED

RESOURCE_EXHAUSTED

FAILED_PRECONDITION

ABORTED

OUT_OF_RANGE

UNIMPLEMENTED

INTERNAL

UNAVAILABLE

DATA_LOSS

canonicalCode

description

Constructor Detail

Status

Method Detail

buildStatusList

withDescription

getCanonicalCode

getDescription

isOk

equals

hashCode

toString