apimachinery: k8s.io/apimachinery/pkg/api/errors Index | Files

package errors

import "k8s.io/apimachinery/pkg/api/errors"

Package errors provides detailed error types for api field validation.

Index

Package Files

doc.go errors.go

Constants

const (
    // StatusTooManyRequests means the server experienced too many requests within a
    // given window and that the client must wait to perform the action again.
    StatusTooManyRequests = 429
)

func FromObject Uses

func FromObject(obj runtime.Object) error

FromObject generates an StatusError from an metav1.Status, if that is the type of obj; otherwise, returns an UnexpecteObjectError.

func IsAlreadyExists Uses

func IsAlreadyExists(err error) bool

IsAlreadyExists determines if the err is an error which indicates that a specified resource already exists.

func IsBadRequest Uses

func IsBadRequest(err error) bool

IsBadRequest determines if err is an error which indicates that the request is invalid.

func IsConflict Uses

func IsConflict(err error) bool

IsConflict determines if the err is an error which indicates the provided update conflicts.

func IsForbidden Uses

func IsForbidden(err error) bool

IsForbidden determines if err is an error which indicates that the request is forbidden and cannot be completed as requested.

func IsGone Uses

func IsGone(err error) bool

IsGone is true if the error indicates the requested resource is no longer available.

func IsInternalError Uses

func IsInternalError(err error) bool

IsInternalError determines if err is an error which indicates an internal server error.

func IsInvalid Uses

func IsInvalid(err error) bool

IsInvalid determines if the err is an error which indicates the provided resource is not valid.

func IsMethodNotSupported Uses

func IsMethodNotSupported(err error) bool

IsMethodNotSupported determines if the err is an error which indicates the provided action could not be performed because it is not supported by the server.

func IsNotAcceptable Uses

func IsNotAcceptable(err error) bool

IsNotAcceptable determines if err is an error which indicates that the request failed due to an invalid Accept header

func IsNotFound Uses

func IsNotFound(err error) bool

IsNotFound returns true if the specified error was created by NewNotFound.

func IsRequestEntityTooLargeError Uses

func IsRequestEntityTooLargeError(err error) bool

IsRequestEntityTooLargeError determines if err is an error which indicates the request entity is too large.

func IsResourceExpired Uses

func IsResourceExpired(err error) bool

IsResourceExpired is true if the error indicates the resource has expired and the current action is no longer possible.

func IsServerTimeout Uses

func IsServerTimeout(err error) bool

IsServerTimeout determines if err is an error which indicates that the request needs to be retried by the client.

func IsServiceUnavailable Uses

func IsServiceUnavailable(err error) bool

IsServiceUnavailable is true if the error indicates the underlying service is no longer available.

func IsTimeout Uses

func IsTimeout(err error) bool

IsTimeout determines if err is an error which indicates that request times out due to long processing.

func IsTooManyRequests Uses

func IsTooManyRequests(err error) bool

IsTooManyRequests determines if err is an error which indicates that there are too many requests that the server cannot handle.

func IsUnauthorized Uses

func IsUnauthorized(err error) bool

IsUnauthorized determines if err is an error which indicates that the request is unauthorized and requires authentication by the user.

func IsUnexpectedObjectError Uses

func IsUnexpectedObjectError(err error) bool

IsUnexpectedObjectError determines if err is due to an unexpected object from the master.

func IsUnexpectedServerError Uses

func IsUnexpectedServerError(err error) bool

IsUnexpectedServerError returns true if the server response was not in the expected API format, and may be the result of another HTTP actor.

func IsUnsupportedMediaType Uses

func IsUnsupportedMediaType(err error) bool

IsUnsupportedMediaType determines if err is an error which indicates that the request failed due to an invalid Content-Type header

func ReasonForError Uses

func ReasonForError(err error) metav1.StatusReason

ReasonForError returns the HTTP status for a particular error.

func SuggestsClientDelay Uses

func SuggestsClientDelay(err error) (int, bool)

SuggestsClientDelay returns true if this error suggests a client delay as well as the suggested seconds to wait, or false if the error does not imply a wait. It does not address whether the error *should* be retried, since some errors (like a 3xx) may request delay without retry.

type APIStatus Uses

type APIStatus interface {
    Status() metav1.Status
}

APIStatus is exposed by errors that can be converted to an api.Status object for finer grained details.

type ErrorReporter Uses

type ErrorReporter struct {
    // contains filtered or unexported fields
}

ErrorReporter converts generic errors into runtime.Object errors without requiring the caller to take a dependency on meta/v1 (where Status lives). This prevents circular dependencies in core watch code.

func NewClientErrorReporter Uses

func NewClientErrorReporter(code int, verb string, reason string) *ErrorReporter

NewClientErrorReporter will respond with valid v1.Status objects that report unexpected server responses. Primarily used by watch to report errors when we attempt to decode a response from the server and it is not in the form we expect. Because watch is a dependency of the core api, we can't return meta/v1.Status in that package and so much inject this interface to convert a generic error as appropriate. The reason is passed as a unique status cause on the returned status, otherwise the generic "ClientError" is returned.

func (*ErrorReporter) AsObject Uses

func (r *ErrorReporter) AsObject(err error) runtime.Object

AsObject returns a valid error runtime.Object (a v1.Status) for the given error, using the code and verb of the reporter type. The error is set to indicate that this was an unexpected server response.

type StatusError Uses

type StatusError struct {
    ErrStatus metav1.Status
}

StatusError is an error intended for consumption by a REST API server; it can also be reconstructed by clients from a REST response. Public to allow easy type switches.

func NewAlreadyExists Uses

func NewAlreadyExists(qualifiedResource schema.GroupResource, name string) *StatusError

NewAlreadyExists returns an error indicating the item requested exists by that identifier.

func NewApplyConflict Uses

func NewApplyConflict(causes []metav1.StatusCause, message string) *StatusError

NewApplyConflict returns an error including details on the requests apply conflicts

func NewBadRequest Uses

func NewBadRequest(reason string) *StatusError

NewBadRequest creates an error that indicates that the request is invalid and can not be processed.

func NewConflict Uses

func NewConflict(qualifiedResource schema.GroupResource, name string, err error) *StatusError

NewConflict returns an error indicating the item can't be updated as provided.

func NewForbidden Uses

func NewForbidden(qualifiedResource schema.GroupResource, name string, err error) *StatusError

NewForbidden returns an error indicating the requested action was forbidden

func NewGenericServerResponse Uses

func NewGenericServerResponse(code int, verb string, qualifiedResource schema.GroupResource, name, serverMessage string, retryAfterSeconds int, isUnexpectedResponse bool) *StatusError

NewGenericServerResponse returns a new error for server responses that are not in a recognizable form.

func NewGone Uses

func NewGone(message string) *StatusError

NewGone returns an error indicating the item no longer available at the server and no forwarding address is known.

func NewInternalError Uses

func NewInternalError(err error) *StatusError

NewInternalError returns an error indicating the item is invalid and cannot be processed.

func NewInvalid Uses

func NewInvalid(qualifiedKind schema.GroupKind, name string, errs field.ErrorList) *StatusError

NewInvalid returns an error indicating the item is invalid and cannot be processed.

func NewMethodNotSupported Uses

func NewMethodNotSupported(qualifiedResource schema.GroupResource, action string) *StatusError

NewMethodNotSupported returns an error indicating the requested action is not supported on this kind.

func NewNotFound Uses

func NewNotFound(qualifiedResource schema.GroupResource, name string) *StatusError

NewNotFound returns a new error which indicates that the resource of the kind and the name was not found.

func NewRequestEntityTooLargeError Uses

func NewRequestEntityTooLargeError(message string) *StatusError

NewRequestEntityTooLargeError returns an error indicating that the request entity was too large.

func NewResourceExpired Uses

func NewResourceExpired(message string) *StatusError

NewResourceExpired creates an error that indicates that the requested resource content has expired from the server (usually due to a resourceVersion that is too old).

func NewServerTimeout Uses

func NewServerTimeout(qualifiedResource schema.GroupResource, operation string, retryAfterSeconds int) *StatusError

NewServerTimeout returns an error indicating the requested action could not be completed due to a transient error, and the client should try again.

func NewServerTimeoutForKind Uses

func NewServerTimeoutForKind(qualifiedKind schema.GroupKind, operation string, retryAfterSeconds int) *StatusError

NewServerTimeoutForKind should not exist. Server timeouts happen when accessing resources, the Kind is just what we happened to be looking at when the request failed. This delegates to keep code sane, but we should work towards removing this.

func NewServiceUnavailable Uses

func NewServiceUnavailable(reason string) *StatusError

NewServiceUnavailable creates an error that indicates that the requested service is unavailable.

func NewTimeoutError Uses

func NewTimeoutError(message string, retryAfterSeconds int) *StatusError

NewTimeoutError returns an error indicating that a timeout occurred before the request could be completed. Clients may retry, but the operation may still complete.

func NewTooManyRequests Uses

func NewTooManyRequests(message string, retryAfterSeconds int) *StatusError

NewTooManyRequests creates an error that indicates that the client must try again later because the specified endpoint is not accepting requests. More specific details should be provided if client should know why the failure was limited4.

func NewTooManyRequestsError Uses

func NewTooManyRequestsError(message string) *StatusError

NewTooManyRequestsError returns an error indicating that the request was rejected because the server has received too many requests. Client should wait and retry. But if the request is perishable, then the client should not retry the request.

func NewUnauthorized Uses

func NewUnauthorized(reason string) *StatusError

NewUnauthorized returns an error indicating the client is not authorized to perform the requested action.

func (*StatusError) DebugError Uses

func (e *StatusError) DebugError() (string, []interface{})

DebugError reports extended info about the error to debug output.

func (*StatusError) Error Uses

func (e *StatusError) Error() string

Error implements the Error interface.

func (*StatusError) Status Uses

func (e *StatusError) Status() metav1.Status

Status allows access to e's status without having to know the detailed workings of StatusError.

type UnexpectedObjectError Uses

type UnexpectedObjectError struct {
    Object runtime.Object
}

UnexpectedObjectError can be returned by FromObject if it's passed a non-status object.

func (*UnexpectedObjectError) Error Uses

func (u *UnexpectedObjectError) Error() string

Error returns an error message describing 'u'.

Package errors imports 9 packages (graph) and is imported by 5357 packages. Updated 2019-06-03. Refresh now. Tools for package owners.