HTTP Caches
Method GET

Return status of all caches

Returns status of each cache configured by proxy_cache_path and other “<literal>*_cache_path</literal>” directives.

get/http/caches/

Query parameters

fieldsstring

Limits which fields of cache zones will be output. If the “<literal>fields</literal>” value is empty, then only names of cache zones will be output.

Response

Success

NginxHTTPCachesMap required

Status information of all HTTP caches configured by <a href="https://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_cache_path">proxy_cache_path</a> and other “<code>*_cache_path</code>” directives.

Example response

{
  "http-cache": {
    "size": 530915328,
    "max_size": 536870912,
    "cold": false,
    "hit": {
      "responses": 254032,
      "bytes": 6685627875
    },
    "stale": {
      "responses": 0,
      "bytes": 0
    },
    "updating": {
      "responses": 0,
      "bytes": 0
    },
    "revalidated": {
      "responses": 0,
      "bytes": 0
    },
    "miss": {
      "responses": 1619201,
      "bytes": 53841943822
    },
    "expired": {
      "responses": 45859,
      "bytes": 1656847080,
      "responses_written": 44992,
      "bytes_written": 1641825173
    },
    "bypass": {
      "responses": 200187,
      "bytes": 5510647548,
      "responses_written": 200173,
      "bytes_written": 44992
    }
  },
  "frontend-cache": {
    "size": 530915328,
    "max_size": 536870912,
    "cold": false,
    "hit": {
      "responses": 254032,
      "bytes": 6685627875
    },
    "stale": {
      "responses": 0,
      "bytes": 0
    },
    "updating": {
      "responses": 0,
      "bytes": 0
    },
    "revalidated": {
      "responses": 0,
      "bytes": 0
    },
    "miss": {
      "responses": 1619201,
      "bytes": 53841943822
    },
    "expired": {
      "responses": 45859,
      "bytes": 1656847080,
      "responses_written": 44992,
      "bytes_written": 1641825173
    },
    "bypass": {
      "responses": 200187,
      "bytes": 5510647548,
      "responses_written": 200173,
      "bytes_written": 44992
    }
  }
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.