# registry-api ## Pages - [Container Registry API](https://docs.ezghcloud.com/registry-api/index.md) — Repositories, images and tags in each project. Image bytes are pushed and pulled on each project's registry host with the OCI distribution API, which isn't in this document. Every path is under an organization; lists are paged with limit, cursor and nextCursor. - [Create a pull-through cache rule](https://docs.ezghcloud.com/registry-api/CreatePullThroughCacheRule/index.md) — Images pulled from /// are fetched from the upstream on first pull, with the credentials in credentialSecret, and stored in the project. Checked as registry.cacheRules.create on the rule's prospective resource name. The secret needs a grant to the rule (consumer registry, consumerResource the rule's resourceName, version latest), made by the caller in Secrets. 409 conflict when the prefix is another rule's, still being deleted, or a live repository's scope, and when the project has 25 rules. - [Create a repository](https://docs.ezghcloud.com/registry-api/CreateRepository/index.md) — Checked as registry.repositories.create on the repository's prospective resource name, so a scope grant (rep_*/team-a/*) allows creating only in its scope; creating it public also needs registry.repositories.makePublic. 409 repository_exists when the project already has a live repository with this name. A first push creates a repository too. - [Delete an image and the tags that point at it](https://docs.ezghcloud.com/registry-api/DeleteImage/index.md) - [Delete a pull-through cache rule and every repository it cached](https://docs.ezghcloud.com/registry-api/DeletePullThroughCacheRule/index.md) — Asynchronous: the rule is deleting at once and its repositories stop answering; they're deleted in the background, then the rule and its prefix go. Needs only registry.cacheRules.delete, not registry.repositories.delete on each repository. Deleting a deleting rule is 202 again. - [Delete a repository and every image in it](https://docs.ezghcloud.com/registry-api/DeleteRepository/index.md) — Synchronous: the repository is deleting at once, its name is free, and its storage is reclaimed in the background. - [Delete a tag](https://docs.ezghcloud.com/registry-api/DeleteTag/index.md) — The image it pointed at stays, pullable by digest. - [Get an image's metadata and the manifest's references](https://docs.ezghcloud.com/registry-api/GetImage/index.md) — Never blob content. A malformed digest is 404. - [Get a pull-through cache rule](https://docs.ezghcloud.com/registry-api/GetPullThroughCacheRule/index.md) - [Get the project's registry host, repository count and storage](https://docs.ezghcloud.com/registry-api/GetRegistry/index.md) — The host is derived from the project ID and never changes; images are pushed and pulled at //. - [Get a repository](https://docs.ezghcloud.com/registry-api/GetRepository/index.md) - [List a repository's images, newest first](https://docs.ezghcloud.com/registry-api/ListImages/index.md) - [List a pull-through cache rule's recent fill failures, newest first](https://docs.ezghcloud.com/registry-api/ListPullThroughCacheFailures/index.md) — One row per upstream repository, reference and reason, while the problem is current: a later successful fill or recheck of the reference removes its rows. Rows go 30 days after they last happened, and a rule keeps at most 1,000. - [List the project's pull-through cache rules, oldest first](https://docs.ezghcloud.com/registry-api/ListPullThroughCacheRules/index.md) - [List the project's repositories, newest first](https://docs.ezghcloud.com/registry-api/ListRepositories/index.md) - [List a repository's tags, by name](https://docs.ezghcloud.com/registry-api/ListTags/index.md) - [Make a repository public or private](https://docs.ezghcloud.com/registry-api/SetRepositoryVisibility/index.md) — Making it public takes registry.repositories.makePublic; making it private takes registry.repositories.update. Anyone can pull a public repository without signing in. - [Change a pull-through cache rule's credential secret, description or tags](https://docs.ezghcloud.com/registry-api/UpdatePullThroughCacheRule/index.md) — The prefix and upstream can't be changed, and the credential secret can't be cleared. A new credential secret takes effect on the next fill or tag recheck. With If-Match, 412 precondition_failed when the rule changed since it was read. - [Change a repository's description or tags](https://docs.ezghcloud.com/registry-api/UpdateRepository/index.md) — The name and visibility can't be changed here. With If-Match, 412 precondition_failed when the repository changed since it was read. - [Error](https://docs.ezghcloud.com/registry-api/schemas/Error/index.md) — Every non-2xx answer. Clients branch on code, never on message. - [Image](https://docs.ezghcloud.com/registry-api/schemas/Image/index.md) - [ImageDetail](https://docs.ezghcloud.com/registry-api/schemas/ImageDetail/index.md) - [ImageList](https://docs.ezghcloud.com/registry-api/schemas/ImageList/index.md) - [ImageReference](https://docs.ezghcloud.com/registry-api/schemas/ImageReference/index.md) - [Platform](https://docs.ezghcloud.com/registry-api/schemas/Platform/index.md) - [PullThroughCacheFailure](https://docs.ezghcloud.com/registry-api/schemas/PullThroughCacheFailure/index.md) - [PullThroughCacheFailureList](https://docs.ezghcloud.com/registry-api/schemas/PullThroughCacheFailureList/index.md) - [PullThroughCacheRule](https://docs.ezghcloud.com/registry-api/schemas/PullThroughCacheRule/index.md) - [PullThroughCacheRuleCreate](https://docs.ezghcloud.com/registry-api/schemas/PullThroughCacheRuleCreate/index.md) - [PullThroughCacheRuleList](https://docs.ezghcloud.com/registry-api/schemas/PullThroughCacheRuleList/index.md) - [PullThroughCacheRuleUpdate](https://docs.ezghcloud.com/registry-api/schemas/PullThroughCacheRuleUpdate/index.md) - [QuotaExceeded](https://docs.ezghcloud.com/registry-api/schemas/QuotaExceeded/index.md) — quota_exceeded: the quota that refused the request. Never with Retry-After. - [Registry](https://docs.ezghcloud.com/registry-api/schemas/Registry/index.md) - [Repository](https://docs.ezghcloud.com/registry-api/schemas/Repository/index.md) - [RepositoryCreate](https://docs.ezghcloud.com/registry-api/schemas/RepositoryCreate/index.md) - [RepositoryList](https://docs.ezghcloud.com/registry-api/schemas/RepositoryList/index.md) - [RepositoryPullThroughCache](https://docs.ezghcloud.com/registry-api/schemas/RepositoryPullThroughCache/index.md) — Only on a pull-through cache repository, filled from the upstream on pull; omitted on others. - [RepositoryUpdate](https://docs.ezghcloud.com/registry-api/schemas/RepositoryUpdate/index.md) - [Tag](https://docs.ezghcloud.com/registry-api/schemas/Tag/index.md) - [TagList](https://docs.ezghcloud.com/registry-api/schemas/TagList/index.md) - [Tags](https://docs.ezghcloud.com/registry-api/schemas/Tags/index.md) — At most 50; keys 1-128 characters, values at most 256, keys starting with ezgh: are reserved. - [Upstream](https://docs.ezghcloud.com/registry-api/schemas/Upstream/index.md) — The upstream registry: docker-hub (registry-1.docker.io). Clients treat others as unknown. - [Visibility](https://docs.ezghcloud.com/registry-api/schemas/Visibility/index.md) — private (the default), or public: anyone can pull without signing in. - [VisibilityChange](https://docs.ezghcloud.com/registry-api/schemas/VisibilityChange/index.md)