이미지 매니페스트 삭제

이미지 매니페스트 삭제 (Delete image manifest)

DELETE /v2/{name}/manifests/{reference} — 다이제스트로 저장소에서 이미지 매니페스트를 삭제해요.

출처: 문서

본문

API 버전 2 — Delete image manifest · DELETE /v2/{name}/manifests/{reference}

다이제스트로 저장소에서 이미지 매니페스트를 삭제해요.

태그되지 않았거나 참조되지 않는 매니페스트만 삭제할 수 있어요. 매니페스트가 여전히 태그나 다른 이미지가 참조하면 레지스트리는 403 Forbidden을 반환해요.

이 작업은 저장소에 대한 delete 접근 권한이 필요해요.

Note 매니페스트 삭제 작업은 시간이 걸릴 수 있고 500 Internal Server Error를 반환할 수 있어요. 시스템이 백그라운드에서 삭제를 자동으로 재시도해요. 수동 개입은 필요하지 않아요.

연결 및 접근 (Connection and access)

https://registry-1.docker.io — Docker Hub 레지스트리 API

다음 대안 중 하나를 사용해요. 한 대안 안의 요구 사항은 함께 적용돼요.

registryToken

파라미터

name

path · 필수 — 저장소 이름. 유형: string

{
  "type": "string"
}

reference

path · 필수 — 삭제할 매니페스트의 다이제스트 (예: sha256:...). 유형: string

{
  "type": "string"
}

요청 및 응답

Media type: 모든 media types

응답 202

매니페스트 삭제 성공. 콘텐츠가 반환되지 않음. 응답 콘텐츠는 선언되지 않음.

응답 401

인증 필요. 응답 콘텐츠는 선언되지 않음.

응답 403

접근 거부. 매니페스트가 여전히 참조되고 있을 수 있음. 응답 콘텐츠는 선언되지 않음.

응답 404

매니페스트 또는 저장소를 찾을 수 없음. 응답 콘텐츠는 선언되지 않음.

응답 405

다이제스트 기반 삭제만 허용. 응답 콘텐츠는 선언되지 않음.

응답 429

요청이 너무 많음. 응답 콘텐츠는 선언되지 않음.

요청 예시

curl \
  --request DELETE \
  --header "Authorization: Bearer ***" \
  'https://registry-1.docker.io/v2/yourusername%2Fhelloworld/manifests/sha256:abc123def456...'

이미지 매니페스트 삭제