ResourceUnits

Update a resource unit

Changed on Aug 31, 2026

patch/api/v1/resourcepools/{pool}/units/{unit}

Request

Base URL: / (relative, and the document was published on a file host, not at the API’s origin)
URL: /api/v1/resourcepools/{pool}/units/{unit}
Auth: none declared

Path parameters

poolstring required

unitstring required

Request body

annotationsStringMap

descriptionstring

Updated free-text unit description.

limitsResourceMap

Kubernetes-style resource quantity map (e.g., {"cpu": "100", "memory": "1Ti", "nvidia.com/gpu": "8"}).

nodeSelectorStringMap

requestsResourceMap

Kubernetes-style resource quantity map (e.g., {"cpu": "100", "memory": "1Ti", "nvidia.com/gpu": "8"}).

Example request

{
  "description": "Updated 2x A100 GPU compute unit.",
  "limits": {
    "cpu": "24",
    "memory": "192Gi",
    "nvidia.com/gpu": "2"
  }
}

Response

Updated resource unit.

annotationsStringMap

descriptionstring

Free-text unit description.

limitsResourceMap required

Kubernetes-style resource quantity map (e.g., {"cpu": "100", "memory": "1Ti", "nvidia.com/gpu": "8"}).

namestring required

Resource unit (shape) name, unique within the pool.

nodeSelectorStringMap

requestsResourceMap required

Kubernetes-style resource quantity map (e.g., {"cpu": "100", "memory": "1Ti", "nvidia.com/gpu": "8"}).

Example response

{
  "annotations": {
    "axisml.io/cost-center": "ml-platform",
    "axisml.io/created-by": "admin"
  },
  "description": "2x A100 GPU compute unit.",
  "limits": {
    "cpu": "16",
    "memory": "128Gi",
    "nvidia.com/gpu": "2"
  },
  "name": "a100-2x",
  "nodeSelector": {
    "arch": "amd64",
    "gpu.product": "A100"
  },
  "requests": {
    "cpu": "16",
    "memory": "128Gi",
    "nvidia.com/gpu": "2"
  }
}

Changes

Aug 31, 20261a4808c79a19 Revision changes
- warning
  removed the request property
- warning
  removed the optional property from the response with the status
Jun 27, 2026d51e2e0e6970 Revision changes
- breaking
  added to the request property allOf list
- breaking
  added to the request property allOf list
- breaking
  added to the request property allOf list
- breaking
  added to the request property allOf list
- breaking
  the request property type changed from object to no type
- breaking
  the request property type changed from object to no type
- breaking
  the request property type changed from object to no type
- breaking
  the request property type changed from object to no type
- breaking
  the response's property type changed from object to no type for status
- breaking
  the response's property type changed from object to no type for status
- breaking
  the response's property type changed from object to no type for status
- breaking
  the response's property type changed from object to no type for status
- info
  added to the response property allOf list for the response status
- info
  added to the response property allOf list for the response status
- info
  added to the response property allOf list for the response status
- info
  added to the response property allOf list for the response status

Operation history