ecr.lifecycle-policy.put

Set the lifecycle policy

PUT /ecr/api/repositories/{id}/lifecycle-policyIAM ecr:PutLifecyclePolicyChanges stateDestructive

{"policy": {"rules": [...]}} in the AWS ECR format; a policy written for ECR pastes in unchanged. Applied hourly. The response lists what it would expire right now (wouldExpire) — the next run expires exactly that. Expired images stay restorable for softDeleteDays (7 for an AWS ECR policy) before they are purged.

Request syntax

PUT /ecr/api/repositories/{id}/lifecycle-policy
{
  "policy": "object"
}

Path parameters

  • idRequired

    string

    Constraints: uuid

Request body

  • policyRequired

    object

    The policy: AWS ECR lifecycle JSON ({"rules": [{rulePriority, selection, action}]}, at most 50 rules; expired images stay restorable for 7 days) or ews-lifecycle/v1 ({"version": "ews-lifecycle/v1", rules, keep, softDeleteDays 0–30, default 7}). Stored as given, and the repository switches to its own policy

    Constraints: JSON

Response

200 with { policy } as saved, and what it would expire right now: source (own, org-default, platform-default, none), mode (active, preview, off), softDeleteDays, effectivePolicy, summary (expire count and bytes, byRule, kept), pendingPurgeBytes, wouldExpire (manifestId, digest, tags, pushedAt, rulePriority, reason), decisions (every image: action expire or keep, reason, by, sizeBytes, pushedAt, lastPulledAt; the first 5,000) and truncated. 404 for an unknown repository.

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:PutLifecyclePolicy 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 lifecycle-policy put id --policy '{}'

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