Skip to main content

AppliedClusterResourceQuota [quota.openshift.io/v1]

Description
AppliedClusterResourceQuota mirrors ClusterResourceQuota at a project scope, for projection into a project. It allows a project-admin to know which ClusterResourceQuotas are applied to his project and their associated usage. Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
Type
`object`
Required
  • metadata
  • spec

Specification​

PropertyTypeDescription
apiVersionstringAPIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
kindstringKind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
metadataObjectMetametadata is the standard object’s metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
specobjectClusterResourceQuotaSpec defines the desired quota restrictions
statusobjectClusterResourceQuotaStatus defines the actual enforced quota and its current usage

.spec​

Description
ClusterResourceQuotaSpec defines the desired quota restrictions
Type
`object`
Required
  • selector
  • quota
PropertyTypeDescription
quotaResourceQuotaSpecquota defines the desired quota
selectorobjectClusterResourceQuotaSelector is used to select projects. At least one of LabelSelector or AnnotationSelector must present. If only one is present, it is the only selection criteria. If both are specified, the project must match both restrictions.

.spec.selector​

Description
ClusterResourceQuotaSelector is used to select projects. At least one of LabelSelector or AnnotationSelector must present. If only one is present, it is the only selection criteria. If both are specified, the project must match both restrictions.
Type
`object`
PropertyTypeDescription
annotationsobject (string)AnnotationSelector is used to select projects by annotation.
labelsLabelSelectorLabelSelector is used to select projects by label.

.status​

Description
ClusterResourceQuotaStatus defines the actual enforced quota and its current usage
Type
`object`
Required
  • total
PropertyTypeDescription
namespacesarraynamespaces slices the usage by project. This division allows for quick resolution of deletion reconciliation inside of a single project without requiring a recalculation across all projects. This can be used to pull the deltas for a given project.
namespaces[]objectResourceQuotaStatusByNamespace gives status for a particular project
totalResourceQuotaStatustotal defines the actual enforced quota and its current usage across all projects

.status.namespaces​

Description
namespaces slices the usage by project. This division allows for quick resolution of deletion reconciliation inside of a single project without requiring a recalculation across all projects. This can be used to pull the deltas for a given project.
Type
`array`

.status.namespaces[]​

Description
ResourceQuotaStatusByNamespace gives status for a particular project
Type
`object`
Required
  • namespace
  • status
PropertyTypeDescription
namespacestringnamespace the project this status applies to
statusResourceQuotaStatusstatus indicates how many resources have been consumed by this project

API endpoints​

The following API endpoints are available:

  • /apis/quota.openshift.io/v1/appliedclusterresourcequotas
    • GET: list objects of kind AppliedClusterResourceQuota
  • /apis/quota.openshift.io/v1/namespaces/{namespace}/appliedclusterresourcequotas
    • GET: list objects of kind AppliedClusterResourceQuota
  • /apis/quota.openshift.io/v1/namespaces/{namespace}/appliedclusterresourcequotas/{name}
    • GET: read the specified AppliedClusterResourceQuota

/apis/quota.openshift.io/v1/appliedclusterresourcequotas​

HTTP method
`GET`
Description
list objects of kind AppliedClusterResourceQuota

HTTP responses

HTTP codeReponse body
200 - OKAppliedClusterResourceQuotaList schema
401 - UnauthorizedEmpty

/apis/quota.openshift.io/v1/namespaces/{namespace}/appliedclusterresourcequotas​

HTTP method
`GET`
Description
list objects of kind AppliedClusterResourceQuota

HTTP responses

HTTP codeReponse body
200 - OKAppliedClusterResourceQuotaList schema
401 - UnauthorizedEmpty

/apis/quota.openshift.io/v1/namespaces/{namespace}/appliedclusterresourcequotas/{name}​

Global path parameters

ParameterTypeDescription
namestringname of the AppliedClusterResourceQuota
HTTP method
`GET`
Description
read the specified AppliedClusterResourceQuota

HTTP responses

HTTP codeReponse body
200 - OKAppliedClusterResourceQuota schema
401 - UnauthorizedEmpty