ecr.storage.get

Show storage used per repository against the quotas

GET /ecr/api/storageIAM ecr:GetRegistryStorageRead

usedBytes counts each stored layer once (deduplicated across repositories) and is exactly breakdown.inRepositoriesBytes + pendingPurgeBytes (held only by expired, restorable images; the first is purged at nextPurgeAt) + unreferencedBytes (no image holds them; cleanup deletes them 24 h later when cleanup.mode is delete, and keeps them when it is report). quotaUsedBytes = inRepositoriesBytes is what the quota counts. A repository's usedBytes counts every layer it holds; sharedBytes is the part other repositories hold too. effectiveQuotaBytes is the lower of the organization's quota and the platform's.

Request syntax

GET /ecr/api/storage

Response

200 with { usedBytes, quotaUsedBytes, breakdown { inRepositoriesBytes, pendingPurgeBytes, unreferencedBytes, nextPurgeAt }, cleanup { mode (delete or report), lastRunAt, nextRunAt }, quotaBytes (the organization’s own, null when none), platformQuotaBytes, effectiveQuotaBytes, repositories [{ id, name, usedBytes, sharedBytes, quotaBytes }] }.

A JSON response is wrapped as { "success": true, "data": … }; the CLI prints the whole body with --json.

Errors

  • 400The request does not pass the schema above. The body is { "error": …, "issues": […] }, one issue per field.
  • 401No credentials, or an access key that is unknown, revoked or expired.
  • 403The caller's policies do not allow ecr:GetRegistryStorage on this resource. The body names the action and the resource, and the refusal is recorded in the audit log.
  • 404The resource does not exist in your organization.

Examples

The required parameters only, with example values. Replace id and the other placeholders with your own.

dcloud ecr storage get

Generated from the API description, the same one the API checks requests against and the CLI is built from. MCP tool: dcloud_ecr_storage_get.