A new platform for documentation and tutorials is launching soon.

We are migrating Nomad documentation into HashiCorp Developer, our new developer experience.

Join Now
Type '/' to Search

»Quota HTTP API

The /quota endpoints are used to query for and interact with quotas.

Enterprise

This API endpoint and functionality only exists in Nomad Enterprise. This is not present in the open source version of Nomad.

»List Quota Specifications

This endpoint lists all quota specifications.

MethodPathProduces
GET/v1/quotasapplication/json

The table below shows this endpoint's support for blocking queries and required ACLs.

Blocking QueriesACL Required
YESquota:read
namespace:* if namespace has quota attached

»Parameters

  • prefix (string: "")- Specifies a string to filter quota specifications on based on an index prefix. This is specified as a query string parameter.

»Sample Request

$ curl \
    https://localhost:4646/v1/quotas

$ curl \
    https://localhost:4646/v1/quotas

$ curl \
    https://localhost:4646/v1/quotas?prefix=sha

$ curl \
    https://localhost:4646/v1/quotas?prefix=sha

»Sample Response

[
  {
    "CreateIndex": 8,
    "Description": "Limit the shared default namespace",
    "Hash": "SgDCH7L5ZDqNSi2NmJlqdvczt/Q6mjyVwVJC0XjWglQ=",
    "Limits": [
      {
        "Hash": "NLOoV2WBU8ieJIrYXXx8NRb5C2xU61pVVWRDLEIMxlU=",
        "Region": "global",
        "RegionLimit": {
          "CPU": 2500,
          "DiskMB": 0,
          "MemoryMB": 2000,
          "Networks": [
            {
              "CIDR": "",
              "Device": "",
              "DynamicPorts": null,
              "IP": "",
              "MBits": 50,
              "Mode": "",
              "ReservedPorts": null
            }
          ]
        },
        "VariablesLimit": 1000
      }
    ],
    "ModifyIndex": 56,
    "Name": "shared-quota"
  }
]

[
  {
    "CreateIndex": 8,
    "Description": "Limit the shared default namespace",
    "Hash": "SgDCH7L5ZDqNSi2NmJlqdvczt/Q6mjyVwVJC0XjWglQ=",
    "Limits": [
      {
        "Hash": "NLOoV2WBU8ieJIrYXXx8NRb5C2xU61pVVWRDLEIMxlU=",
        "Region": "global",
        "RegionLimit": {
          "CPU": 2500,
          "DiskMB": 0,
          "MemoryMB": 2000,
          "Networks": [
            {
              "CIDR": "",
              "Device": "",
              "DynamicPorts": null,
              "IP": "",
              "MBits": 50,
              "Mode": "",
              "ReservedPorts": null
            }
          ]
        },
        "VariablesLimit": 1000
      }
    ],
    "ModifyIndex": 56,
    "Name": "shared-quota"
  }
]

»Read Quota Specification

This endpoint reads information about a specific quota specification.

MethodPathProduces
GET/v1/quota/:quotaapplication/json

The table below shows this endpoint's support for blocking queries and required ACLs.

Blocking QueriesACL Required
YESquota:read
namespace:* if namespace has quota attached

»Parameters

  • :quota (string: <required>)- Specifies the quota specification to query where the identifier is the quota's name.

»Sample Request

$ curl \
    https://localhost:4646/v1/quota/shared-quota

$ curl \
    https://localhost:4646/v1/quota/shared-quota

»Sample Response

{
  "CreateIndex": 8,
  "Description": "Limit the shared default namespace",
  "Hash": "SgDCH7L5ZDqNSi2NmJlqdvczt/Q6mjyVwVJC0XjWglQ=",
  "Limits": [
    {
      "Hash": "NLOoV2WBU8ieJIrYXXx8NRb5C2xU61pVVWRDLEIMxlU=",
      "Region": "global",
      "RegionLimit": {
        "CPU": 2500,
        "DiskMB": 0,
        "MemoryMB": 2000,
        "Networks": [
          {
            "CIDR": "",
            "Device": "",
            "DynamicPorts": null,
            "IP": "",
            "MBits": 50,
            "Mode": "",
            "ReservedPorts": null
          }
        ]
      },
      "VariablesLimit": 1000
    }
  ],
  "ModifyIndex": 56,
  "Name": "shared-quota"
}

{
  "CreateIndex": 8,
  "Description": "Limit the shared default namespace",
  "Hash": "SgDCH7L5ZDqNSi2NmJlqdvczt/Q6mjyVwVJC0XjWglQ=",
  "Limits": [
    {
      "Hash": "NLOoV2WBU8ieJIrYXXx8NRb5C2xU61pVVWRDLEIMxlU=",
      "Region": "global",
      "RegionLimit": {
        "CPU": 2500,
        "DiskMB": 0,
        "MemoryMB": 2000,
        "Networks": [
          {
            "CIDR": "",
            "Device": "",
            "DynamicPorts": null,
            "IP": "",
            "MBits": 50,
            "Mode": "",
            "ReservedPorts": null
          }
        ]
      },
      "VariablesLimit": 1000
    }
  ],
  "ModifyIndex": 56,
  "Name": "shared-quota"
}

»Create or Update Quota Specification

This endpoint is used to create or update a quota specification.

MethodPathProduces
POST/v1/quota/:quota
/v1/quota		application/json

The table below shows this endpoint's support for blocking queries and required ACLs.

Blocking QueriesACL Required
NOquota:write

»Body

The request body contains a valid, JSON quota specification. View the api package to see the definition of a QuotaSpec object.

»Sample Payload

{
  "Name": "shared-quota",
  "Description": "Limit the shared default namespace",
  "Limits": [
    {
      "Region": "global",
      "RegionLimit": {
        "CPU": 2500,
        "MemoryMB": 1000,
        "Networks": [
          {
            "Mbits": 50
          }
        ]
      }
    }
  ]
}

{
  "Name": "shared-quota",
  "Description": "Limit the shared default namespace",
  "Limits": [
    {
      "Region": "global",
      "RegionLimit": {
        "CPU": 2500,
        "MemoryMB": 1000,
        "Networks": [
          {
            "Mbits": 50
          }
        ]
      }
    }
  ]
}

»Sample Request

$ curl \
    --request POST \
    --data @spec.json \
    https://localhost:4646/v1/quota/shared-quota

$ curl \
    --request POST \
    --data @spec.json \
    https://localhost:4646/v1/quota/shared-quota

$ curl \
    --request POST \
    --data @spec.json \
    https://localhost:4646/v1/quota

$ curl \
    --request POST \
    --data @spec.json \
    https://localhost:4646/v1/quota

»Delete Quota Specification

This endpoint is used to delete a quota specification.

MethodPathProduces
DELETE/v1/quota/:quotaapplication/json

The table below shows this endpoint's support for blocking queries and required ACLs.

Blocking QueriesACL Required
NOquota:write

»Parameters

  • :quota (string: <required>)- Specifies the quota specification to delete where the identifier is the quota's name.

»Sample Request

$ curl \
    --request DELETE \
    https://localhost:4646/v1/quota/shared-quota

$ curl \
    --request DELETE \
    https://localhost:4646/v1/quota/shared-quota

»List Quota Usages

This endpoint lists all quota usages.

MethodPathProduces
GET/v1/quota-usagesapplication/json

The table below shows this endpoint's support for blocking queries and required ACLs.

Blocking QueriesACL Required
YESquota:read
namespace:* if namespace has quota attached

»Parameters

  • prefix (string: "")- Specifies a string to filter quota specifications on based on an index prefix. This is specified as a query string parameter.

»Sample Request

$ curl \
    https://localhost:4646/v1/quota-usages

$ curl \
    https://localhost:4646/v1/quota-usages

$ curl \
    https://localhost:4646/v1/quota-usages?prefix=sha

$ curl \
    https://localhost:4646/v1/quota-usages?prefix=sha

»Sample Response

[
  {
    "Used": {
      "NLOoV2WBU8ieJIrYXXx8NRb5C2xU61pVVWRDLEIMxlU=": {
        "Region": "global",
        "RegionLimit": {
          "CPU": 500,
          "MemoryMB": 256,
          "DiskMB": 0,
          "Networks": null
        },
        "Hash": "NLOoV2WBU8ieJIrYXXx8NRb5C2xU61pVVWRDLEIMxlU="
      }
    },
    "Name": "default",
    "CreateIndex": 8,
    "ModifyIndex": 56
  }
]

[
  {
    "Used": {
      "NLOoV2WBU8ieJIrYXXx8NRb5C2xU61pVVWRDLEIMxlU=": {
        "Region": "global",
        "RegionLimit": {
          "CPU": 500,
          "MemoryMB": 256,
          "DiskMB": 0,
          "Networks": null
        },
        "Hash": "NLOoV2WBU8ieJIrYXXx8NRb5C2xU61pVVWRDLEIMxlU="
      }
    },
    "Name": "default",
    "CreateIndex": 8,
    "ModifyIndex": 56
  }
]

»Read Quota Usage

This endpoint reads information about a specific quota usage.

MethodPathProduces
GET/v1/quota/usage/:quotaapplication/json

The table below shows this endpoint's support for blocking queries and required ACLs.

Blocking QueriesACL Required
YESquota:read
namespace:* if namespace has quota attached

»Parameters

  • :quota (string: <required>)- Specifies the quota specification to query where the identifier is the quota's name.

»Sample Request

$ curl \
    https://localhost:4646/v1/quota/usage/shared-quota

$ curl \
    https://localhost:4646/v1/quota/usage/shared-quota

»Sample Response

{
  "Used": {
    "NLOoV2WBU8ieJIrYXXx8NRb5C2xU61pVVWRDLEIMxlU=": {
      "Region": "global",
      "RegionLimit": {
        "CPU": 500,
        "MemoryMB": 256,
        "DiskMB": 0,
        "Networks": [
          {
            "CIDR": "",
            "Device": "",
            "DynamicPorts": null,
            "IP": "",
            "MBits": 50,
            "Mode": "",
            "ReservedPorts": null
          }
        ]
      },
      "Hash": "NLOoV2WBU8ieJIrYXXx8NRb5C2xU61pVVWRDLEIMxlU="
    }
  },
  "Name": "default",
  "CreateIndex": 8,
  "ModifyIndex": 56
}

{
  "Used": {
    "NLOoV2WBU8ieJIrYXXx8NRb5C2xU61pVVWRDLEIMxlU=": {
      "Region": "global",
      "RegionLimit": {
        "CPU": 500,
        "MemoryMB": 256,
        "DiskMB": 0,
        "Networks": [
          {
            "CIDR": "",
            "Device": "",
            "DynamicPorts": null,
            "IP": "",
            "MBits": 50,
            "Mode": "",
            "ReservedPorts": null
          }
        ]
      },
      "Hash": "NLOoV2WBU8ieJIrYXXx8NRb5C2xU61pVVWRDLEIMxlU="
    }
  },
  "Name": "default",
  "CreateIndex": 8,
  "ModifyIndex": 56
}