ecr.lifecycle-policy.putSet the lifecycle policy
{"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
idRequiredstring
Constraints: uuid
Request body
policyRequiredobject
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 '{}'curl -X PUT "https://console.platform-development.deutschecloud.app/ecr/api/repositories/id/lifecycle-policy" \
-H "Authorization: EWS-ACCESS-KEY $ACCESS_KEY" \
-H "Content-Type: application/json" \
-d '{"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.