Naming of Reason constants is inconsistent
Changed ReasonType to StatusReason (to match the field) and changed CauseReason to CauseType and renamed StatusCause.Reason to Type.
This commit is contained in:
@@ -372,7 +372,7 @@ type Status struct {
|
||||
// "failure" or "working" status. If this value is empty there
|
||||
// is no information available. A Reason clarifies an HTTP status
|
||||
// code but does not override it.
|
||||
Reason ReasonType `json:"reason,omitempty" yaml:"reason,omitempty"`
|
||||
Reason StatusReason `json:"reason,omitempty" yaml:"reason,omitempty"`
|
||||
// Extended data associated with the reason. Each reason may define its
|
||||
// own extended details. This field is optional and the data returned
|
||||
// is not guaranteed to conform to any schema except that defined by
|
||||
@@ -389,14 +389,14 @@ type Status struct {
|
||||
// and should assume that any attribute may be empty, invalid, or under
|
||||
// defined.
|
||||
type StatusDetails struct {
|
||||
// The ID attribute of the resource associated with the status ReasonType
|
||||
// The ID attribute of the resource associated with the status StatusReason
|
||||
// (when there is a single ID which can be described).
|
||||
ID string `json:"id,omitempty" yaml:"id,omitempty"`
|
||||
// The kind attribute of the resource associated with the status ReasonType.
|
||||
// The kind attribute of the resource associated with the status StatusReason.
|
||||
// On some operations may differ from the requested resource Kind.
|
||||
Kind string `json:"kind,omitempty" yaml:"kind,omitempty"`
|
||||
// The Causes array includes more details associated with the ReasonType
|
||||
// failure. Not all ReasonTypes may provide detailed causes.
|
||||
// The Causes array includes more details associated with the StatusReason
|
||||
// failure. Not all StatusReasons may provide detailed causes.
|
||||
Causes []StatusCause `json:"causes,omitempty" yaml:"causes,omitempty"`
|
||||
}
|
||||
|
||||
@@ -407,19 +407,19 @@ const (
|
||||
StatusWorking = "working"
|
||||
)
|
||||
|
||||
// ReasonType is an enumeration of possible failure causes. Each ReasonType
|
||||
// StatusReason is an enumeration of possible failure causes. Each StatusReason
|
||||
// must map to a single HTTP status code, but multiple reasons may map
|
||||
// to the same HTTP status code.
|
||||
// TODO: move to apiserver
|
||||
type ReasonType string
|
||||
type StatusReason string
|
||||
|
||||
const (
|
||||
// ReasonTypeUnknown means the server has declined to indicate a specific reason.
|
||||
// StatusReasonUnknown means the server has declined to indicate a specific reason.
|
||||
// The details field may contain other information about this error.
|
||||
// Status code 500.
|
||||
ReasonTypeUnknown ReasonType = ""
|
||||
StatusReasonUnknown StatusReason = ""
|
||||
|
||||
// ReasonTypeWorking means the server is processing this request and will complete
|
||||
// StatusReasonWorking means the server is processing this request and will complete
|
||||
// at a future time.
|
||||
// Details (optional):
|
||||
// "kind" string - the name of the resource being referenced ("operation" today)
|
||||
@@ -429,7 +429,7 @@ const (
|
||||
// "Location" - HTTP header populated with a URL that can retrieved the final
|
||||
// status of this operation.
|
||||
// Status code 202
|
||||
ReasonTypeWorking ReasonType = "working"
|
||||
StatusReasonWorking StatusReason = "working"
|
||||
|
||||
// ResourceTypeNotFound means one or more resources required for this operation
|
||||
// could not be found.
|
||||
@@ -439,21 +439,21 @@ const (
|
||||
// resource.
|
||||
// "id" string - the identifier of the missing resource
|
||||
// Status code 404
|
||||
ReasonTypeNotFound ReasonType = "notFound"
|
||||
StatusReasonNotFound StatusReason = "notFound"
|
||||
|
||||
// ReasonTypeAlreadyExists means the resource you are creating already exists.
|
||||
// StatusReasonAlreadyExists means the resource you are creating already exists.
|
||||
// Details (optional):
|
||||
// "kind" string - the kind attribute of the conflicting resource
|
||||
// "id" string - the identifier of the conflicting resource
|
||||
// Status code 409
|
||||
ReasonTypeAlreadyExists ReasonType = "alreadyExists"
|
||||
StatusReasonAlreadyExists StatusReason = "alreadyExists"
|
||||
|
||||
// ResourceTypeConflict means the requested update operation cannot be completed
|
||||
// due to a conflict in the operation. The client may need to alter the request.
|
||||
// Each resource may define custom details that indicate the nature of the
|
||||
// conflict.
|
||||
// Status code 409
|
||||
ReasonTypeConflict ReasonType = "conflict"
|
||||
StatusReasonConflict StatusReason = "conflict"
|
||||
)
|
||||
|
||||
// StatusCause provides more information about an api.Status failure, including
|
||||
@@ -461,7 +461,7 @@ const (
|
||||
type StatusCause struct {
|
||||
// A machine-readable description of the cause of the error. If this value is
|
||||
// empty there is no information available.
|
||||
Reason CauseReasonType `json:"reason,omitempty" yaml:"reason,omitempty"`
|
||||
Type CauseType `json:"reason,omitempty" yaml:"reason,omitempty"`
|
||||
// A human-readable description of the cause of the error. This field may be
|
||||
// presented as-is to a reader.
|
||||
Message string `json:"message,omitempty" yaml:"message,omitempty"`
|
||||
@@ -477,26 +477,27 @@ type StatusCause struct {
|
||||
Field string `json:"field,omitempty" yaml:"field,omitempty"`
|
||||
}
|
||||
|
||||
// CauseReasonType is a machine readable value providing more detail about why
|
||||
// an operation failed. An operation may have multiple causes for a failure.
|
||||
type CauseReasonType string
|
||||
// CauseType is a machine readable value providing more detail about what
|
||||
// occured in a status response. An operation may have multiple causes for a
|
||||
// status (whether failure, success, or working).
|
||||
type CauseType string
|
||||
|
||||
const (
|
||||
// CauseReasonTypeFieldValueNotFound is used to report failure to find a requested value
|
||||
// CauseTypeFieldValueNotFound is used to report failure to find a requested value
|
||||
// (e.g. looking up an ID).
|
||||
CauseReasonTypeFieldValueNotFound CauseReasonType = "fieldValueNotFound"
|
||||
// CauseReasonTypeFieldValueInvalid is used to report required values that are not
|
||||
CauseTypeFieldValueNotFound CauseType = "fieldValueNotFound"
|
||||
// CauseTypeFieldValueInvalid is used to report required values that are not
|
||||
// provided (e.g. empty strings, null values, or empty arrays).
|
||||
CauseReasonTypeFieldValueRequired CauseReasonType = "fieldValueRequired"
|
||||
// CauseReasonTypeFieldValueDuplicate is used to report collisions of values that must be
|
||||
CauseTypeFieldValueRequired CauseType = "fieldValueRequired"
|
||||
// CauseTypeFieldValueDuplicate is used to report collisions of values that must be
|
||||
// unique (e.g. unique IDs).
|
||||
CauseReasonTypeFieldValueDuplicate CauseReasonType = "fieldValueDuplicate"
|
||||
// CauseReasonTypeFieldValueInvalid is used to report malformed values (e.g. failed regex
|
||||
CauseTypeFieldValueDuplicate CauseType = "fieldValueDuplicate"
|
||||
// CauseTypeFieldValueInvalid is used to report malformed values (e.g. failed regex
|
||||
// match).
|
||||
CauseReasonTypeFieldValueInvalid CauseReasonType = "fieldValueInvalid"
|
||||
// CauseReasonTypeFieldValueNotSupported is used to report valid (as per formatting rules)
|
||||
CauseTypeFieldValueInvalid CauseType = "fieldValueInvalid"
|
||||
// CauseTypeFieldValueNotSupported is used to report valid (as per formatting rules)
|
||||
// values that can not be handled (e.g. an enumerated string).
|
||||
CauseReasonTypeFieldValueNotSupported CauseReasonType = "fieldValueNotSupported"
|
||||
CauseTypeFieldValueNotSupported CauseType = "fieldValueNotSupported"
|
||||
)
|
||||
|
||||
// ServerOp is an operation delivered to API clients.
|
||||
|
Reference in New Issue
Block a user