Enum grafana_plugin_sdk::backend::DataQueryStatus

pub enum DataQueryStatus {
    Unknown,
    OK,
    Unauthorized,
    Forbidden,
    NotFound,
    TooManyRequests,
    BadRequest,
    ValidationFailed,
    Internal,
    NotImplemented,
    Timeout,
    BadGateway,
    Custom(StatusCode),
}

Status codes for DataQueryError.

These generally correspond to HTTP status codes, but are not a 1:1 mapping: several variants may map to a single HTTP status code, and not all HTTP status codes are given.

To return a custom HTTP status code in more advanced scenarios, use DataQueryStatus::Custom and nest the required http::StatusCode inside.

Variants

Unknown

An error that should be updated to contain an accurate status code, as none has been provided.

HTTP status code 500.

OK

The query was successful.

HTTP status code 200.

Unauthorized

The datasource does not recognize the client’s authentication, either because it has not been provided or is invalid for the operation.

HTTP status code 401.

Forbidden

The datasource refuses to perform the requested action for the authenticated user. HTTP status code 403.

NotFound

The datasource does not have any corresponding document to return to the request.

HTTP status code 404.

TooManyRequests

The client is rate limited by the datasource and should back-off before trying again.

HTTP status code 429.

BadRequest

The datasource was unable to parse the parameters or payload for the request.

HTTP status code 400.

ValidationFailed

The datasource was able to parse the payload for the request, but it failed one or more validation checks.

HTTP status code 400.

Internal

The datasource acknowledges that there’s an error, but that there is nothing the client can do to fix it.

HTTP status code 500.

NotImplemented

The datasource does not support the requested action. Typically used during development of new features.

HTTP status code 501.

Timeout

The datasource did not complete the request within the required time and aborted the action.

HTTP status code 504.

BadGateway

The datasource, while acting as a gateway or proxy, received an invalid response from the upstream server.

HTTP status code 502.

Custom(StatusCode)

The datasource encountered another error, best represented by the inner status code.