gerr

Documentation

Index

• Constants
• Variables
• func ClearErrorCause(err error) error
• func IsGRPCError(err error) bool
• type ErrorMessage
  • func (em ErrorMessage) Message(locale string, a ...interface{}) string
• type GRPCError
  • func New(code codes.Code, errMsg ErrorMessage, a ...interface{}) GRPCError
  • func NewWithDetail(code codes.Code, err error, errMsg ErrorMessage, a ...interface{}) GRPCError

Constants

const (
	// OK is returned on success.
	OK = codes.OK

	// Canceled indicates the operation was canceled (typically by the caller).
	Canceled = codes.Canceled

	// Unknown error. An example of where this error may be returned is
	// if 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.
	Unknown = codes.Unknown

	// InvalidArgument indicates client specified an invalid argument.
	// Note that this differs from FailedPrecondition. It indicates arguments
	// that are problematic regardless of the state of the system
	// (e.g., a malformed file name).
	InvalidArgument = codes.InvalidArgument

	// DeadlineExceeded means operation expired before completion.
	// 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.
	DeadlineExceeded = codes.DeadlineExceeded

	// NotFound means some requested entity (e.g., file or directory) was
	// not found.
	NotFound = codes.NotFound

	// AlreadyExists means an attempt to create an entity failed because one
	// already exists.
	AlreadyExists = codes.AlreadyExists

	// PermissionDenied indicates the caller does not have permission to
	// execute the specified operation. It must not be used for rejections
	// caused by exhausting some resource (use ResourceExhausted
	// instead for those errors). It must not be
	// used if the caller cannot be identified (use Unauthenticated
	// instead for those errors).
	PermissionDenied = codes.PermissionDenied

	// ResourceExhausted indicates some resource has been exhausted, perhaps
	// a per-user quota, or perhaps the entire file system is out of space.
	ResourceExhausted = codes.ResourceExhausted

	// 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.
	FailedPrecondition = codes.FailedPrecondition

	// Aborted indicates the operation was aborted, typically due to a
	// concurrency issue like sequencer check failures, transaction aborts,
	// etc.
	//
	// See litmus test above for deciding between FailedPrecondition,
	// Aborted, and Unavailable.
	Aborted = codes.Aborted

	// OutOfRange means operation was attempted past the valid range.
	// E.g., seeking or reading past end of file.
	//
	// Unlike InvalidArgument, this error indicates a problem that may
	// be fixed if the system state changes. For example, a 32-bit file
	// system will generate InvalidArgument if asked to read at an
	// offset that is not in the range [0,2^32-1], but it will generate
	// OutOfRange if asked to read from an offset past the current
	// file size.
	//
	// There is a fair bit of overlap between FailedPrecondition and
	// OutOfRange. We recommend using OutOfRange (the more specific
	// error) when it applies so that callers who are iterating through
	// a space can easily look for an OutOfRange error to detect when
	// they are done.
	OutOfRange = codes.OutOfRange

	// Unimplemented indicates operation is not implemented or not
	// supported/enabled in this service.
	Unimplemented = codes.Unimplemented

	// Internal errors. Means some invariants expected by underlying
	// system has been broken. If you see one of these errors,
	// something is very broken.
	Internal = codes.Internal

	// Unavailable indicates the service is currently unavailable.
	// This is a most likely a transient condition and may be corrected
	// by retrying with a backoff.
	//
	// See litmus test above for deciding between FailedPrecondition,
	// Aborted, and Unavailable.
	Unavailable = codes.Unavailable

	// DataLoss indicates unrecoverable data loss or corruption.
	DataLoss = codes.DataLoss

	// Unauthenticated indicates the request does not have valid
	// authentication credentials for the operation.
	Unauthenticated = codes.Unauthenticated
)

const DefaultLocale = EN

const EN = "en"

Variables

var (
	ErrorCreateResourcesFailed = ErrorMessage{
		Name: "create_resources_failed",
		En:   "create resources failed",
	}
	ErrorCreateResourceFailed = ErrorMessage{
		Name: "create_resource_failed",
		En:   "create resource [%s] failed",
	}
	ErrorDeleteResourcesFailed = ErrorMessage{
		Name: "delete_resources_failed",
		En:   "delete resources failed",
	}
	ErrorDeleteResourceFailed = ErrorMessage{
		Name: "delete_resource_failed",
		En:   "delete resource [%s] failed",
	}
	ErrorUpgradeResourceFailed = ErrorMessage{
		Name: "upgrade_resource_failed",
		En:   "upgrade resource [%s] failed",
	}
	ErrorRollbackResourceFailed = ErrorMessage{
		Name: "rollback_resource_failed",
		En:   "rollback resource [%s] failed",
	}
	ErrorResizeResourceFailed = ErrorMessage{
		Name: "resize_resource_failed",
		En:   "resize resource [%s] failed",
	}
	ErrorAddResourceNodeFailed = ErrorMessage{
		Name: "add_resource_node_failed",
		En:   "add resource [%s] node failed",
	}
	ErrorDeleteResourceNodeFailed = ErrorMessage{
		Name: "delete_resource_node_failed",
		En:   "delete resource [%s] node failed",
	}
	ErrorUpdateResourceEnvFailed = ErrorMessage{
		Name: "update_resource_env_failed",
		En:   "update resource [%s] env failed",
	}
	ErrorStopResourceFailed = ErrorMessage{
		Name: "stop_resource_failed",
		En:   "stop resource [%s] failed",
	}
	ErrorStartResourceFailed = ErrorMessage{
		Name: "start_resource_failed",
		En:   "start resource [%s] failed",
	}
	ErrorRecoverResourceFailed = ErrorMessage{
		Name: "recover_resource_failed",
		En:   "recover resource [%s] failed",
	}
	ErrorCeaseResourceFailed = ErrorMessage{
		Name: "cease_resource_failed",
		En:   "cease resource [%s] failed",
	}
	ErrorRetryTaskFailed = ErrorMessage{
		Name: "retry_task_failed",
		En:   "retry task [%s] failed",
	}
	ErrorDescribeResourcesFailed = ErrorMessage{
		Name: "describe_resources_failed",
		En:   "describe resources failed",
	}
	ErrorDescribeResourceFailed = ErrorMessage{
		Name: "describe_resource_failed",
		En:   "describe resource [%s] failed",
	}
	ErrorModifyResourcesFailed = ErrorMessage{
		Name: "modify_resources_failed",
		En:   "modify resources failed",
	}
	ErrorModifyResourceFailed = ErrorMessage{
		Name: "modify_resource_failed",
		En:   "modify resource [%s] failed",
	}
	ErrorResourceNotFound = ErrorMessage{
		Name: "resource_not_found",
		En:   "resource [%s] not found",
	}
	ErrorSubnetNotFound = ErrorMessage{
		Name: "subnet_not_found",
		En:   "subnet [%s] not found or vpc not bind eip",
	}
	ErrorProviderNotFound = ErrorMessage{
		Name: "provider_not_found",
		En:   "provider [%s] not found",
	}
	ErrorInternalError = ErrorMessage{
		Name: "internal_error",
		En:   "internal error",
	}
	ErrorMissingParameter = ErrorMessage{
		Name: "missing_parameter",
		En:   "missing parameter [%s]",
	}
	ErrorValidateFailed = ErrorMessage{
		Name: "validate_failed",
		En:   "validate failed",
	}
	ErrorParameterParseFailed = ErrorMessage{
		Name: "parameter_parse_failed",
		En:   "parameter [%s] parse failed",
	}
	ErrorResourceAlreadyDeleted = ErrorMessage{
		Name: "resource_already_deleted",
		En:   "resource [%s] has already been deleted",
	}
	ErrorResourceNotInStatus = ErrorMessage{
		Name: "resource_not_in_status",
		En:   "resource [%s] is not in status [%s]",
	}
	ErrorResourceTransitionStatus = ErrorMessage{
		Name: "resource_transition_status",
		En:   "resource [%s] is [%s]",
	}
	ErrorIllegalParameterLength = ErrorMessage{
		Name: "illegal_parameter_length",
		En:   "illegal parameter [%s] length",
	}
	ErrorParameterShouldNotBeEmpty = ErrorMessage{
		Name: "parameter_should_not_be_empty",
		En:   "parameter [%s] should not be empty",
	}
	ErrorUnsupportedParameterValue = ErrorMessage{
		Name: "unsupported_parameter_value",
		En:   "unsupported parameter [%s] value [%s]",
	}
	ErrorIllegalUrlFormat = ErrorMessage{
		Name: "illegal_url_format",
		En:   "illegal URL format [%s]",
	}
	ErrorIllegalLabelFormat = ErrorMessage{
		Name: "illegal_label_format",
		En:   "illegal label format",
	}
	ErrorConflictRepoName = ErrorMessage{
		Name: "conflict_repo_name",
		En:   "conflict repo name [%s]",
	}
	ErrorResourceQuotaNotEnough = ErrorMessage{
		Name: "resource_quota_not_enough",
		En:   "resource quota not enough: %s",
	}
	ErrorHelmReleaseExists = ErrorMessage{
		Name: "helm_release_exists",
		En:   "helm release [%s] already exists",
	}
	ErrorUnsupportedApiVersion = ErrorMessage{
		Name: "unsupported_api_version",
		En:   "unsupported api version [%s]",
	}
	ErrorCannotDeleteDefaultCategory = ErrorMessage{
		Name: "cannot_delete_default_category",
		En:   "cannot delete default category",
	}
	ErrorAttachKeyPairsFailed = ErrorMessage{
		Name: "attach_key_pairs_failed",
		En:   "attach key pairs failed",
	}
	ErrorDetachKeyPairsFailed = ErrorMessage{
		Name: "detach_key_pairs_failed",
		En:   "detach key pairs failed",
	}
)

Functions

func ClearErrorCause

func ClearErrorCause(err error) error

func IsGRPCError

func IsGRPCError(err error) bool

Types

type ErrorMessage

type ErrorMessage struct {
	Name string
	En   string
}

func (ErrorMessage) Message

func (em ErrorMessage) Message(locale string, a ...interface{}) string

type GRPCError

type GRPCError interface {
	error
	GRPCStatus() *status.Status
}

func New

func New(code codes.Code, errMsg ErrorMessage, a ...interface{}) GRPCError

func NewWithDetail

func NewWithDetail(code codes.Code, err error, errMsg ErrorMessage, a ...interface{}) GRPCError