# caches-api ## Pages - [Caches API](https://docs.ezghcloud.com/caches-api/index.md) — Managed Valkey and Memcached in your VPC: caches reached by one DNS name, with TLS, users whose passwords live in Secrets, an optional standby that takes over on failure, and upgrades in place or by blue/green deployment. Every path is under an organization; lists are paged with limit, cursor and nextCursor. - [Cancel an operation](https://docs.ezghcloud.com/caches-api/CancelOperation/index.md) — 409 operation_finished or operation_not_cancellable when it can't be cancelled. - [Create a blue/green deployment](https://docs.ezghcloud.com/caches-api/CreateBlueGreenDeployment/index.md) — Asynchronous. Valkey only (409 not_supported), one open per cache (409 blue_green_in_progress). - [Create a cache](https://docs.ezghcloud.com/caches-api/CreateCache/index.md) — Asynchronous: answers 202 with the operation that creates it, and its default user's Secret. 409 subnet_has_no_room. - [Create a cache user](https://docs.ezghcloud.com/caches-api/CreateCacheUser/index.md) — Asynchronous. Its password is generated and written to a Secret in the cache's project. - [Delete a blue/green deployment](https://docs.ezghcloud.com/caches-api/DeleteBlueGreenDeployment/index.md) — Asynchronous. Before switchover it discards green; after it, it removes the finished record. - [Delete a cache](https://docs.ezghcloud.com/caches-api/DeleteCache/index.md) — Asynchronous. Deletes its users' Secrets too. 409 deletion_protected. - [Delete a cache user](https://docs.ezghcloud.com/caches-api/DeleteCacheUser/index.md) — Asynchronous. Deletes its Secret first. 409 default_user for default. - [Switch a cache over to its standby](https://docs.ezghcloud.com/caches-api/FailoverCache/index.md) — Asynchronous: a planned switchover. 409 no_standby without one. - [Empty a cache](https://docs.ezghcloud.com/caches-api/FlushCache/index.md) — Asynchronous. - [Get a blue/green deployment](https://docs.ezghcloud.com/caches-api/GetBlueGreenDeployment/index.md) - [Get a cache](https://docs.ezghcloud.com/caches-api/GetCache/index.md) - [Get a cache user](https://docs.ezghcloud.com/caches-api/GetCacheUser/index.md) - [Get an operation (poll it until it finishes)](https://docs.ezghcloud.com/caches-api/GetOperation/index.md) — While it's queued or running, Retry-After suggests when to poll again. Not recorded in Trails. - [List blue/green deployments, newest first](https://docs.ezghcloud.com/caches-api/ListBlueGreenDeployments/index.md) - [List a cache's events, newest first](https://docs.ezghcloud.com/caches-api/ListCacheEvents/index.md) - [List a cache's users](https://docs.ezghcloud.com/caches-api/ListCacheUsers/index.md) - [List a project's caches, newest first](https://docs.ezghcloud.com/caches-api/ListCaches/index.md) - [List engines, versions, modes, parameters and upgrade targets](https://docs.ezghcloud.com/caches-api/ListEngineVersions/index.md) - [List the organization's operations, newest first](https://docs.ezghcloud.com/caches-api/ListOperations/index.md) - [Rotate a cache user's password](https://docs.ezghcloud.com/caches-api/RotateCacheUserPassword/index.md) — Asynchronous: a new Secret version, applied without a restart. - [Switch a cache over to its green](https://docs.ezghcloud.com/caches-api/SwitchoverBlueGreenDeployment/index.md) — Asynchronous and one-way. 409 not_ready until the deployment is available. If green doesn't catch up within switchoverTimeoutSeconds, blue resumes and the deployment stays available. - [Change a cache](https://docs.ezghcloud.com/caches-api/UpdateCache/index.md) — Asynchronous. Growing storage works while the cache is storage_full. While a blue/green deployment is open only name, description, tags and allowedSourceCidrs change: 409 blue_green_in_progress otherwise. - [Change a cache user's preset](https://docs.ezghcloud.com/caches-api/UpdateCacheUser/index.md) — Asynchronous. Valkey only. - [BlueGreenDeployment](https://docs.ezghcloud.com/caches-api/schemas/BlueGreenDeployment/index.md) - [BlueGreenDeploymentCreate](https://docs.ezghcloud.com/caches-api/schemas/BlueGreenDeploymentCreate/index.md) - [BlueGreenDeploymentList](https://docs.ezghcloud.com/caches-api/schemas/BlueGreenDeploymentList/index.md) - [Cache](https://docs.ezghcloud.com/caches-api/schemas/Cache/index.md) - [CacheCreate](https://docs.ezghcloud.com/caches-api/schemas/CacheCreate/index.md) - [CacheEvent](https://docs.ezghcloud.com/caches-api/schemas/CacheEvent/index.md) - [CacheEventList](https://docs.ezghcloud.com/caches-api/schemas/CacheEventList/index.md) - [CacheList](https://docs.ezghcloud.com/caches-api/schemas/CacheList/index.md) - [CacheUpdate](https://docs.ezghcloud.com/caches-api/schemas/CacheUpdate/index.md) - [CacheUser](https://docs.ezghcloud.com/caches-api/schemas/CacheUser/index.md) - [CacheUserCreate](https://docs.ezghcloud.com/caches-api/schemas/CacheUserCreate/index.md) - [CacheUserList](https://docs.ezghcloud.com/caches-api/schemas/CacheUserList/index.md) - [CacheUserUpdate](https://docs.ezghcloud.com/caches-api/schemas/CacheUserUpdate/index.md) - [Endpoint](https://docs.ezghcloud.com/caches-api/schemas/Endpoint/index.md) — How clients reach the cache. Null until its name resolves. - [EngineVersions](https://docs.ezghcloud.com/caches-api/schemas/EngineVersions/index.md) - [Error](https://docs.ezghcloud.com/caches-api/schemas/Error/index.md) — Every non-2xx answer. Clients branch on code, never on message. - [Failure](https://docs.ezghcloud.com/caches-api/schemas/Failure/index.md) — Why it failed; null otherwise. - [Operation](https://docs.ezghcloud.com/caches-api/schemas/Operation/index.md) - [OperationList](https://docs.ezghcloud.com/caches-api/schemas/OperationList/index.md) - [OperationStatus](https://docs.ezghcloud.com/caches-api/schemas/OperationStatus/index.md) - [QuotaExceeded](https://docs.ezghcloud.com/caches-api/schemas/QuotaExceeded/index.md) — quota_exceeded: the quota that refused the request. Never with Retry-After. - [Storage](https://docs.ezghcloud.com/caches-api/schemas/Storage/index.md) - [Tags](https://docs.ezghcloud.com/caches-api/schemas/Tags/index.md) — At most 50; keys 1-128 characters, values at most 256, keys starting with ezgh: are reserved.