NGINX · JSON Structure
Plus Http Api Nginx Http Cache Structure
Type: object
Properties: 0
API GatewayCachingCloud NativeLoad BalancerOpen SourceReverse ProxyWeb Server
HTTP Cache is a JSON Structure definition published by NGINX. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.
Meta-schema: https://json-structure.org/meta/core/v0/#
JSON Structure
{
"$schema": "https://json-structure.org/meta/core/v0/#",
"name": "HTTP Cache",
"type": "object",
"members": {
"size": {
"description": "The current size of the cache.",
"type": "int32",
"example": 0
},
"max_size": {
"description": "The limit on the maximum size of the cache specified in the configuration.",
"type": "int32",
"example": 0
},
"cold": {
"description": "A boolean value indicating whether the \u201ccache loader\u201d process is still loading data from disk into the cache.",
"type": "boolean",
"example": false
},
"hit": {
"type": "object",
"members": {
"responses": {
"description": "The total number of <a href=\"https://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_cache_valid\">valid</a> responses read from the cache.",
"type": "int32",
"example": 1234567
},
"bytes": {
"description": "The total number of bytes read from the cache.",
"type": "int32",
"example": 0
}
},
"example": {}
},
"stale": {
"type": "object",
"members": {
"responses": {
"description": "The total number of expired responses read from the cache (see <a href=\"https://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_cache_use_stale\">proxy_cache_use_stale</a> and other \u201c<code>*_cache_use_stale</code>\u201d directives).",
"type": "int32",
"example": 1234567
},
"bytes": {
"description": "The total number of bytes read from the cache.",
"type": "int32",
"example": 0
}
},
"example": {}
},
"updating": {
"type": "object",
"members": {
"responses": {
"description": "The total number of expired responses read from the cache while responses were being updated (see <a href=\"https://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_cache_use_stale_updating\">proxy_cache_use_stale</a> and other \u201c<code>*_cache_use_stale</code>\u201d directives).",
"type": "int32",
"example": 1234567
},
"bytes": {
"description": "The total number of bytes read from the cache.",
"type": "int32",
"example": 0
}
},
"example": {}
},
"revalidated": {
"type": "object",
"members": {
"responses": {
"description": "The total number of expired and revalidated responses read from the cache (see <a href=\"https://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_cache_revalidate\">proxy_cache_revalidate</a> and other \u201c<code>*_cache_revalidate</code>\u201d directives.",
"type": "int32",
"example": 1234567
},
"bytes": {
"description": "The total number of bytes read from the cache.",
"type": "int32",
"example": 0
}
},
"example": {}
},
"miss": {
"type": "object",
"members": {
"responses": {
"description": "The total number of responses not found in the cache.",
"type": "int32",
"example": 1234567
},
"bytes": {
"description": "The total number of bytes read from the proxied server.",
"type": "int32",
"example": 0
},
"responses_written": {
"description": "The total number of responses written to the cache.",
"type": "int32",
"example": 0
},
"bytes_written": {
"description": "The total number of bytes written to the cache.",
"type": "int32",
"example": 0
}
},
"example": {}
},
"expired": {
"type": "object",
"members": {
"responses": {
"description": "The total number of expired responses not taken from the cache.",
"type": "int32",
"example": 1234567
},
"bytes": {
"description": "The total number of bytes read from the proxied server.",
"type": "int32",
"example": 0
},
"responses_written": {
"description": "The total number of responses written to the cache.",
"type": "int32",
"example": 0
},
"bytes_written": {
"description": "The total number of bytes written to the cache.",
"type": "int32",
"example": 0
}
},
"example": {}
},
"bypass": {
"type": "object",
"members": {
"responses": {
"description": "The total number of responses not looked up in the cache due to the <a href=\"https://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_cache_bypass\">proxy_cache_bypass</a> and other \u201c<code>*_cache_bypass</code>\u201d directives.",
"type": "int32",
"example": 1234567
},
"bytes": {
"description": "The total number of bytes read from the proxied server.",
"type": "int32",
"example": 0
},
"responses_written": {
"description": "The total number of responses written to the cache.",
"type": "int32",
"example": 0
},
"bytes_written": {
"description": "The total number of bytes written to the cache.",
"type": "int32",
"example": 0
}
},
"example": {}
}
},
"example": {
"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
}
}
}