`kv delete` — 키/값 데이터 삭제하기

kv delete — 키/값 데이터 삭제하기

vault kv delete는 키/값 시크릿 엔진에서 지정한 경로의 데이터를 삭제하는 명령어예요. KV 버전 2를 사용한다면 버전 데이터가 완전히 제거되는 게 아니라 "삭제됨( deleted)"으로 표시되고, 이후 일반적인 get 요청에서는 반환되지 않아요.

출처: 문서

본문

예시 (Examples)

"creds" 키의 최신 버전을 삭제해요:

$ vault kv delete -mount=secret creds
Success! Data deleted (if it existed) at: secret/creds

[KV 버전 2] "creds" 키의 버전 11을 삭제해요:

$ vault kv delete -mount=secret -versions=11 creds
Success! Data deleted (if it existed) at: secret/data/creds

사용법 (Usage)

모든 명령어에 기본으로 포함된 표준 플래그 외에 다음 플래그들을 추가로 사용할 수 있어요.

커맨드 옵션 (Command options)

  • -mount (string: "") — KV 백엔드가 마운트된 경로를 지정해요. 이 값이 있으면 그 다음 인자는 시크릿 경로로 해석돼요. 이 플래그가 없으면 그 다음 인자는 마운트 경로와 시크릿 경로가 합쳐진 것으로 해석되며, KV v2 시크릿에는 /data/가 자동으로 삽입돼요.
  • -versions ([]int: <필수>) — 삭제할 버전 목록을 지정해요. 버전 데이터 자체는 삭제되지 않지만, 이후 일반 get 요청에서는 더 이상 반환되지 않아요.

참고: -versions 커맨드 옵션은 KV v2 전용이에요.

더 알아보기 (Learn more)

  • vault kv destroy — 버전 데이터 완전 삭제
  • vault kv undelete — 삭제된 버전 복구
  • vault kv get — 데이터 조회