kubernetes reference apiVersion v1 contenttype apireference kind ResourceQuota title ResourceQuota apimetadata ResourceQuota sets aggregate quota restrictions enforced per namespace weight 3 autogenerated true import k8s io api core v1

Answer:
---
api_metadata:
  apiVersion: "v1"
  import: "k8s.io/api/core/v1"
  kind: "ResourceQuota"
content_type: "api_reference"
description: "ResourceQuota sets aggregate quota restrictions enforced per namespace."
title: "ResourceQuota"
weight: 3
auto_generated: true
---

`apiVersion: v1`

`import "k8s.io/api/core/v1"`

## ResourceQuota {#ResourceQuota}

ResourceQuota sets aggregate quota restrictions enforced per namespace

- **apiVersion**: v1

- **kind**: ResourceQuota

- **metadata** (ObjectMeta)

  Standard object's metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

- **spec** (ResourceQuotaSpec)

  Spec defines the desired quota. https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status

- **status** (ResourceQuotaStatus)

  Status defines the actual enforced quota and its current usage. https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status

## ResourceQuotaSpec {#ResourceQuotaSpec}

ResourceQuotaSpec defines the desired hard limits to enforce for Quota.

- **hard** (map[string]Quantity)

  hard is the set of desired hard limits for each named resource. More info: https://kubernetes.io/docs/concepts/policy/resource-quotas/

- **scopeSelector** (ScopeSelector)

  scopeSelector is also a collection of filters like scopes that must match each object tracked by a quota but expressed using ScopeSelectorOperator in combination with possible values. For a resource to match, both scopes AND scopeSelector (if specified in spec), must be matched.

  *A scope selector represents the AND of the selectors represented by the scoped-resource selector requirements.*

  - **scopeSelector.matchExpressions** ([]ScopedResourceSelectorRequirement)

    *Atomic: will be replaced during a merge*

    A list of scope selector requirements by scope of the resources.

    *A scoped-resource selector requirement is a selector that contains values, a scope name, and an operator that relates the scope name and values.*

    - **scopeSelector.matchExpressions.operator** (string), required

      Represents a scope's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist.

    - **scopeSelector.matchExpressions.scopeName** (string), required

      The name of the scope that the selector applies to.

    - **scopeSelector.matchExpressions.values** ([]string)

      *Atomic: will be replaced during a merge*

      An array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. This array is replaced during a strategic merge patch.

- **scopes** ([]string)

  *Atomic: will be replaced during a merge*

  A collection of filters that must match each object tracked by a quota. If not specified, the quota matches all objects.

## ResourceQuotaStatus {#ResourceQuotaStatus}

ResourceQuotaStatus defines the enforced hard limits and observed use.

- **hard** (map[string]Quantity)

  Hard is the set of enforced hard limits for each named resource. More info: https://kubernetes.io/docs/concepts/policy/resource-quotas/

- **used** (map[string]Quantity)

  Used is the current observed total usage of the resource in the namespace.

## ResourceQuotaList {#ResourceQuotaList}

ResourceQuotaList is a list of ResourceQuota items.

- **apiVersion**: v1

- **kind**: ResourceQuotaList

- **metadata** (ListMeta)

  Standard list metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

- **items** ([]ResourceQuota), required

  Items is a list of ResourceQuota objects. More info: https://kubernetes.io/docs/concepts/policy/resource-quotas/

## Operations {#Operations}

### `get` read the specified ResourceQuota

#### HTTP Request

GET /api/v1/namespaces/{namespace}/resourcequotas/{name}

#### Parameters

- **name** (*in path*): string, required

  name of the ResourceQuota

- **namespace** (*in path*): string, required

  namespace

- **pretty** (*in query*): string

  pretty

#### Response

200 (ResourceQuota): OK

401: Unauthorized

### `get` read status of the specified ResourceQuota

#### HTTP Request

GET /api/v1/namespaces/{namespace}/resourcequotas/{name}/status

#### Parameters

- **name** (*in path*): string, required

  name of the ResourceQuota

- **namespace** (*in path*): string, required

  namespace

- **pretty** (*in query*): string

  pretty

#### Response

200 (ResourceQuota): OK

401: Unauthorized

### `list` list or watch objects of kind ResourceQuota

#### HTTP Request

GET /api/v1/namespaces/{namespace}/resourcequotas

#### Parameters

- **namespace** (*in path*): string, required

  namespace

- **allowWatchBookmarks** (*in query*): boolean

  allowWatchBookmarks

- **continue** (*in query*): string

  continue

- **fieldSelector** (*in query*): string

  fieldSelector

- **labelSelector** (*in query*): string

  labelSelector

- **limit** (*in query*): integer

  limit

- **pretty** (*in query*): string

  pretty

- **resourceVersion** (*in query*): string

  resourceVersion

- **resourceVersionMatch** (*in query*): string

  resourceVersionMatch

- **sendInitialEvents** (*in query*): boolean

  sendInitialEvents

- **timeoutSeconds** (*in query*): integer

  timeoutSeconds

- **watch** (*in query*): boolean

  watch

#### Response

200 (ResourceQuotaList): OK

401: Unauthorized

### `list` list or watch objects of kind ResourceQuota

#### HTTP Request

GET /api/v1/resourcequotas

#### Parameters

- **allowWatchBookmarks** (*in query*): boolean

  allowWatchBookmarks

- **continue** (*in query*): string

  continue

- **fieldSelector** (*in query*): string

  fieldSelector

- **labelSelector** (*in query*): string

  labelSelector

- **limit** (*in query*): integer

  limit

- **pretty** (*in query*): string

  pretty

- **resourceVersion** (*in query*): string

  resourceVersion

- **resourceVersionMatch** (*in query*): string

  resourceVersionMatch

- **sendInitialEvents** (*in query*): boolean

  sendInitialEvents

- **timeoutSeconds** (*in query*): integer

  timeoutSeconds

- **watch** (*in query*): boolean

  watch

#### Response

200 (ResourceQuotaList): OK

401: Unauthorized

### `create` create a ResourceQuota

#### HTTP Request

POST /api/v1/namespaces/{namespace}/resourcequotas

#### Parameters

- **namespace** (*in path*): string, required

  namespace

- **body**: ResourceQuota, required

- **dryRun** (*in query*): string

  dryRun

- **fieldManager** (*in query*): string

  fieldManager

- **fieldValidation** (*in query*): string

  fieldValidation

- **pretty** (*in query*): string

  pretty

#### Response

200 (ResourceQuota): OK

201 (ResourceQuota): Created

202 (ResourceQuota): Accepted

401: Unauthorized

### `update` replace the specified ResourceQuota

#### HTTP Request

PUT /api/v1/namespaces/{namespace}/resourcequotas/{name}

#### Parameters

- **name** (*in path*): string, required

  name of the ResourceQuota

- **namespace** (*in path*): string, required

  namespace

- **body**: ResourceQuota, required

- **dryRun** (*in query*): string

  dryRun

- **fieldManager** (*in query*): string

  fieldManager

- **fieldValidation** (*in query*): string

  fieldValidation

- **pretty** (*in query*): string

  pretty

#### Response

200 (ResourceQuota): OK

201 (ResourceQuota): Created

401: Unauthorized

### `update` replace status of the specified ResourceQuota

#### HTTP Request

PUT /api/v1/namespaces/{namespace}/resourcequotas/{name}/status

#### Parameters

- **name** (*in path*): string, required

  name of the ResourceQuota

- **namespace** (*in path*): string, required

  namespace

- **body**: ResourceQuota, required

- **dryRun** (*in query*): string

  dryRun

- **fieldManager** (*in query*): string

  fieldManager

- **fieldValidation** (*in query*): string

  fieldValidation

- **pretty** (*in query*): string

  pretty

#### Response

200 (ResourceQuota): OK

201 (ResourceQuota): Created

401: Unauthorized

### `patch` partially update the specified ResourceQuota

#### HTTP Request

PATCH /api/v1/namespaces/{namespace}/resourcequotas/{name}

#### Parameters

- **name** (*in path*): string, required

  name of the ResourceQuota

- **namespace** (*in path*): string, required

  namespace

- **body**: Patch, required

- **dryRun** (*in query*): string

  dryRun

- **fieldManager** (*in query*): string

  fieldManager

- **fieldValidation** (*in query*): string

  fieldValidation

- **force** (*in query*): boolean

  force

- **pretty** (*in query*): string

  pretty

#### Response

200 (ResourceQuota): OK

201 (ResourceQuota): Created

401: Unauthorized

### `patch` partially update status of the specified ResourceQuota

#### HTTP Request

PATCH /api/v1/namespaces/{namespace}/resourcequotas/{name}/status

#### Parameters

- **name** (*in path*): string, required

  name of the ResourceQuota

- **namespace** (*in path*): string, required

  namespace

- **body**: Patch, required

- **dryRun** (*in query*): string

  dryRun

- **fieldManager** (*in query*): string

  fieldManager

- **fieldValidation** (*in query*): string

  fieldValidation

- **force** (*in query*): boolean

  force

- **pretty** (*in query*): string

  pretty

#### Response

200 (ResourceQuota): OK

201 (ResourceQuota): Created

401: Unauthorized

### `delete` delete a ResourceQuota

#### HTTP Request

DELETE /api/v1/namespaces/{namespace}/resourcequotas/{name}

#### Parameters

- **name** (*in path*): string, required

  name of the ResourceQuota

- **namespace** (*in path*): string, required

  namespace

- **body**: DeleteOptions

- **dryRun** (*in query*): string

  dryRun

- **gracePeriodSeconds** (*in query*): integer

  gracePeriodSeconds

- **pretty** (*in query*): string

  pretty

- **propagationPolicy** (*in query*): string

  propagationPolicy

#### Response

200 (ResourceQuota): OK

202 (ResourceQuota): Accepted

401: Unauthorized

### `deletecollection` delete collection of ResourceQuota

#### HTTP Request

DELETE /api/v1/namespaces/{namespace}/resourcequotas

#### Parameters

- **namespace** (*in path*): string, required

  namespace

- **body**: DeleteOptions

- **continue** (*in query*): string

  continue

- **dryRun** (*in query*): string

  dryRun

- **fieldSelector** (*in query*): string

  fieldSelector

- **gracePeriodSeconds** (*in query*): integer

  gracePeriodSeconds

- **labelSelector** (*in query*): string

  labelSelector

- **limit** (*in query*): integer

  limit

- **pretty** (*in query*): string

  pretty

- **propagationPolicy** (*in query*): string

  propagationPolicy

- **resourceVersion** (*in query*): string

  resourceVersion

- **resourceVersionMatch** (*in query*): string

  resourceVersionMatch

- **sendInitialEvents** (*in query*): boolean

  sendInitialEvents

- **timeoutSeconds** (*in query*): integer

  timeoutSeconds

#### Response

200 (Status): OK

401: Unauthorized

api metadata    apiVersion   v1    import   k8s io api core v1    kind   ResourceQuota  content type   api reference  description   ResourceQuota sets aggregate quota restrictions enforced per namespace   title   ResourceQuota  weight  3 auto generated  true           The file is auto generated from the Go source code of the component using a generic  generator  https   github com kubernetes sigs reference docs    To learn how to generate the reference documentation  please read  Contributing to the reference documentation   docs contribute generate ref docs    To update the reference content  please follow the   Contributing upstream   docs contribute generate ref docs contribute upstream   guide  You can file document formatting bugs against the  reference docs  https   github com kubernetes sigs reference docs   project        apiVersion  v1    import  k8s io api core v1        ResourceQuota   ResourceQuota   ResourceQuota sets aggregate quota restrictions enforced per namespace   hr       apiVersion    v1       kind    ResourceQuota       metadata     a href    ObjectMeta  a      Standard object s metadata  More info  https   git k8s io community contributors devel sig architecture api conventions md metadata      spec     a href    ResourceQuotaSpec  a      Spec defines the desired quota  https   git k8s io community contributors devel sig architecture api conventions md spec and status      status     a href    ResourceQuotaStatus  a      Status defines the actual enforced quota and its current usage  https   git k8s io community contributors devel sig architecture api conventions md spec and status         ResourceQuotaSpec   ResourceQuotaSpec   ResourceQuotaSpec defines the desired hard limits to enforce for Quota    hr       hard    map string  a href    Quantity  a      hard is the set of desired hard limits for each named resource  More info  https   kubernetes io docs concepts policy resource quotas       scopeSelector    ScopeSelector     scopeSelector is also a collection of filters like scopes that must match each object tracked by a quota but expressed using ScopeSelectorOperator in combination with possible values  For a resource to match  both scopes AND scopeSelector  if specified in spec   must be matched      a name  ScopeSelector    a     A scope selector represents the AND of the selectors represented by the scoped resource selector requirements          scopeSelector matchExpressions      ScopedResourceSelectorRequirement        Atomic  will be replaced during a merge           A list of scope selector requirements by scope of the resources        a name  ScopedResourceSelectorRequirement    a       A scoped resource selector requirement is a selector that contains values  a scope name  and an operator that relates the scope name and values            scopeSelector matchExpressions operator    string   required        Represents a scope s relationship to a set of values  Valid operators are In  NotIn  Exists  DoesNotExist           scopeSelector matchExpressions scopeName    string   required        The name of the scope that the selector applies to           scopeSelector matchExpressions values      string          Atomic  will be replaced during a merge               An array of string values  If the operator is In or NotIn  the values array must be non empty  If the operator is Exists or DoesNotExist  the values array must be empty  This array is replaced during a strategic merge patch       scopes      string      Atomic  will be replaced during a merge       A collection of filters that must match each object tracked by a quota  If not specified  the quota matches all objects          ResourceQuotaStatus   ResourceQuotaStatus   ResourceQuotaStatus defines the enforced hard limits and observed use    hr       hard    map string  a href    Quantity  a      Hard is the set of enforced hard limits for each named resource  More info  https   kubernetes io docs concepts policy resource quotas       used    map string  a href    Quantity  a      Used is the current observed total usage of the resource in the namespace          ResourceQuotaList   ResourceQuotaList   ResourceQuotaList is a list of ResourceQuota items    hr       apiVersion    v1       kind    ResourceQuotaList       metadata     a href    ListMeta  a      Standard list metadata  More info  https   git k8s io community contributors devel sig architecture api conventions md types kinds      items       a href    ResourceQuota  a    required    Items is a list of ResourceQuota objects  More info  https   kubernetes io docs concepts policy resource quotas          Operations   Operations      hr             get  read the specified ResourceQuota       HTTP Request  GET  api v1 namespaces  namespace  resourcequotas  name        Parameters       name     in path    string  required    name of the ResourceQuota       namespace     in path    string  required     a href    namespace  a        pretty     in query    string     a href    pretty  a          Response   200   a href    ResourceQuota  a    OK  401  Unauthorized        get  read status of the specified ResourceQuota       HTTP Request  GET  api v1 namespaces  namespace  resourcequotas  name  status       Parameters       name     in path    string  required    name of the ResourceQuota       namespace     in path    string  required     a href    namespace  a        pretty     in query    string     a href    pretty  a          Response   200   a href    ResourceQuota  a    OK  401  Unauthorized        list  list or watch objects of kind ResourceQuota       HTTP Request  GET  api v1 namespaces  namespace  resourcequotas       Parameters       namespace     in path    string  required     a href    namespace  a        allowWatchBookmarks     in query    boolean     a href    allowWatchBookmarks  a        continue     in query    string     a href    continue  a        fieldSelector     in query    string     a href    fieldSelector  a        labelSelector     in query    string     a href    labelSelector  a        limit     in query    integer     a href    limit  a        pretty     in query    string     a href    pretty  a        resourceVersion     in query    string     a href    resourceVersion  a        resourceVersionMatch     in query    string     a href    resourceVersionMatch  a        sendInitialEvents     in query    boolean     a href    sendInitialEvents  a        timeoutSeconds     in query    integer     a href    timeoutSeconds  a        watch     in query    boolean     a href    watch  a          Response   200   a href    ResourceQuotaList  a    OK  401  Unauthorized        list  list or watch objects of kind ResourceQuota       HTTP Request  GET  api v1 resourcequotas       Parameters       allowWatchBookmarks     in query    boolean     a href    allowWatchBookmarks  a        continue     in query    string     a href    continue  a        fieldSelector     in query    string     a href    fieldSelector  a        labelSelector     in query    string     a href    labelSelector  a        limit     in query    integer     a href    limit  a        pretty     in query    string     a href    pretty  a        resourceVersion     in query    string     a href    resourceVersion  a        resourceVersionMatch     in query    string     a href    resourceVersionMatch  a        sendInitialEvents     in query    boolean     a href    sendInitialEvents  a        timeoutSeconds     in query    integer     a href    timeoutSeconds  a        watch     in query    boolean     a href    watch  a          Response   200   a href    ResourceQuotaList  a    OK  401  Unauthorized        create  create a ResourceQuota       HTTP Request  POST  api v1 namespaces  namespace  resourcequotas       Parameters       namespace     in path    string  required     a href    namespace  a        body     a href    ResourceQuota  a   required           dryRun     in query    string     a href    dryRun  a        fieldManager     in query    string     a href    fieldManager  a        fieldValidation     in query    string     a href    fieldValidation  a        pretty     in query    string     a href    pretty  a          Response   200   a href    ResourceQuota  a    OK  201   a href    ResourceQuota  a    Created  202   a href    ResourceQuota  a    Accepted  401  Unauthorized        update  replace the specified ResourceQuota       HTTP Request  PUT  api v1 namespaces  namespace  resourcequotas  name        Parameters       name     in path    string  required    name of the ResourceQuota       namespace     in path    string  required     a href    namespace  a        body     a href    ResourceQuota  a   required           dryRun     in query    string     a href    dryRun  a        fieldManager     in query    string     a href    fieldManager  a        fieldValidation     in query    string     a href    fieldValidation  a        pretty     in query    string     a href    pretty  a          Response   200   a href    ResourceQuota  a    OK  201   a href    ResourceQuota  a    Created  401  Unauthorized        update  replace status of the specified ResourceQuota       HTTP Request  PUT  api v1 namespaces  namespace  resourcequotas  name  status       Parameters       name     in path    string  required    name of the ResourceQuota       namespace     in path    string  required     a href    namespace  a        body     a href    ResourceQuota  a   required           dryRun     in query    string     a href    dryRun  a        fieldManager     in query    string     a href    fieldManager  a        fieldValidation     in query    string     a href    fieldValidation  a        pretty     in query    string     a href    pretty  a          Response   200   a href    ResourceQuota  a    OK  201   a href    ResourceQuota  a    Created  401  Unauthorized        patch  partially update the specified ResourceQuota       HTTP Request  PATCH  api v1 namespaces  namespace  resourcequotas  name        Parameters       name     in path    string  required    name of the ResourceQuota       namespace     in path    string  required     a href    namespace  a        body     a href    Patch  a   required           dryRun     in query    string     a href    dryRun  a        fieldManager     in query    string     a href    fieldManager  a        fieldValidation     in query    string     a href    fieldValidation  a        force     in query    boolean     a href    force  a        pretty     in query    string     a href    pretty  a          Response   200   a href    ResourceQuota  a    OK  201   a href    ResourceQuota  a    Created  401  Unauthorized        patch  partially update status of the specified ResourceQuota       HTTP Request  PATCH  api v1 namespaces  namespace  resourcequotas  name  status       Parameters       name     in path    string  required    name of the ResourceQuota       namespace     in path    string  required     a href    namespace  a        body     a href    Patch  a   required           dryRun     in query    string     a href    dryRun  a        fieldManager     in query    string     a href    fieldManager  a        fieldValidation     in query    string     a href    fieldValidation  a        force     in query    boolean     a href    force  a        pretty     in query    string     a href    pretty  a          Response   200   a href    ResourceQuota  a    OK  201   a href    ResourceQuota  a    Created  401  Unauthorized        delete  delete a ResourceQuota       HTTP Request  DELETE  api v1 namespaces  namespace  resourcequotas  name        Parameters       name     in path    string  required    name of the ResourceQuota       namespace     in path    string  required     a href    namespace  a        body     a href    DeleteOptions  a            dryRun     in query    string     a href    dryRun  a        gracePeriodSeconds     in query    integer     a href    gracePeriodSeconds  a        pretty     in query    string     a href    pretty  a        propagationPolicy     in query    string     a href    propagationPolicy  a          Response   200   a href    ResourceQuota  a    OK  202   a href    ResourceQuota  a    Accepted  401  Unauthorized        deletecollection  delete collection of ResourceQuota       HTTP Request  DELETE  api v1 namespaces  namespace  resourcequotas       Parameters       namespace     in path    string  required     a href    namespace  a        body     a href    DeleteOptions  a            continue     in query    string     a href    continue  a        dryRun     in query    string     a href    dryRun  a        fieldSelector     in query    string     a href    fieldSelector  a        gracePeriodSeconds     in query    integer     a href    gracePeriodSeconds  a        labelSelector     in query    string     a href    labelSelector  a        limit     in query    integer     a href    limit  a        pretty     in query    string     a href    pretty  a        propagationPolicy     in query    string     a href    propagationPolicy  a        resourceVersion     in query    string     a href    resourceVersion  a        resourceVersionMatch     in query    string     a href    resourceVersionMatch  a        sendInitialEvents     in query    boolean     a href    sendInitialEvents  a        timeoutSeconds     in query    integer     a href    timeoutSeconds  a          Response   200   a href    Status  a    OK  401  Unauthorized