---
title: "ezgh registry cache-rules failures"
description: "List a pull-through cache rule's recent failures."
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.ezghcloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ezgh registry cache-rules failures

{/* Generated by ezgh-cli's internal/tools/clidocs from the ezgh command tree. Don't edit: change the command's help in ezgh-cli and regenerate. */}

```sh
ezgh registry cache-rules failures <rule> [--upstream-repository library/nginx] [flags]
```

List why pulls through a rule failed, newest first: one row per upstream repository, reference (tag or digest) and reason (its explanation is in `--output` json's message), with how often and when it last happened, and whether the stored copy was served anyway (a tag that couldn't be rechecked). A row goes once a pull of it succeeds, and after 30 days.

Part of [`ezgh registry cache-rules`](/cli/reference/registry-cache-rules).

## Flags

| Flag | Type | Default | Description |
| --- | --- | --- | --- |
| `--all` | boolean |  | follow nextCursor through every page |
| `--cursor` | string |  | start from this page (a previous page's nextCursor) |
| `--limit` | int | `20` | items per page, 1 to 100 |
| `--upstream-repository` | string |  | only this upstream repository's failures, such as library/nginx |

This command also takes the [global flags](/cli/reference#global-flags).

Source: https://docs.ezghcloud.com/cli/reference/registry-cache-rules-failures/index.mdx
