콘텐츠로 이동

통합 카탈로그 엔터티 일괄 삭제



POST /api/v1/unified_catalog/entity/batch_delete

개요

URN 목록을 기준으로 현재 워크스페이스의 통합 카탈로그 엔터티를 일괄 삭제합니다.

Body 요청 파라미터

파라미터 이름 유형 필수 설명
urns array Y 엔터티 URN 1~500개. 앞뒤 공백 제거 후 비어 있거나 중복될 수 없음
빈 값 허용: False

파라미터 추가 설명

  • urns는 필수이며, 1회에 1~500개 항목을 지원하고 urn:<类型>:<命名空间>:<名称> 및 <类型>:<名称> 형식을 지원합니다.
  • URN은 앞뒤 공백을 제거한 후 비어 있거나 중복되어서는 안 됩니다. 모든 파라미터가 검증된 후에만 삭제가 실행됩니다.
  • 워크스페이스는 DF-API-KEY 인증으로 결정되며, 요청 본문으로 덮어쓸 수 없습니다.
  • 대상 엔터티의 모든 유입 엣지, 유출 엣지, 자기 관계를 정리하되, 연결된 엔터티는 재귀적으로 삭제하지 않습니다.
  • success는 요청 순서대로 정규화된 URN을 반환합니다. successCount에는 원래 존재하지 않던 엔터티도 포함되며, 실제 삭제된 행 수가 아닌 처리 건수입니다.
  • 하드 삭제는 수명 주기 보호 표시의 제한을 받지 않으며, 이후 업로드로 엔터티를 다시 생성할 수 있습니다.
  • 기본 스토리지 실패 시 전체 오류가 반환되며 부분 성공 목록은 제공되지 않습니다. 보조 스토리지 이중 쓰기 실패는 기본 스토리지의 성공 결과를 변경하지 않으며, 엔진 간 트랜잭션은 제공되지 않습니다.
  • 제출 이후에 타임아웃이 발생할 수 있습니다. 호출자가 동일한 대상을 여전히 삭제해야 한다고 확인한 후 재시도할 수 있으며, Studio는 자동으로 재시도하지 않습니다.
  • Kodo가 제공하는 /v1/unified_catalog/entities/batch_delete에 의존합니다.

요청 예시

curl 'https://openapi.guance.com/api/v1/unified_catalog/entity/batch_delete' \
-H 'DF-API-KEY: <DF-API-KEY>' \
-H 'Content-Type: application/json;charset=UTF-8' \
--data-raw '{"urns":["urn:service:default:api"]}'

응답

{
    "code": 200,
    "content": {
        "success": [
            "urn:service:default:api"
        ],
        "successCount": 1
    },
    "errorCode": "",
    "message": "",
    "success": true,
    "traceId": "TRACE-XXXX"
}

문서 평가

이 페이지가 도움이 되었나요?