콘텐츠로 이동

삭제



POST /api/v1/log_backup_cfg/batch_delete

개요

데이터 전송 규칙 및 관련 액세스 구성을 일괄 삭제합니다.

호출 전 및 사용 단계

이 워크스페이스에서 삭제되지 않았고 deleting 상태가 아닌 일치하는 UUID만 처리합니다. 일치하지 않은 항목, 빈 배열 또는 이미 삭제된 항목도 성공(true)을 반환할 수 있으며, 항목별 일치 수는 반환하지 않습니다. Iceberg 제외 항목에 해당하면 쓰기 전에 전체 작업이 Forbidden 처리됩니다. 다른 진입점에서 관리하는 규칙을 함께 포함하지 마세요.

guanceObject 내장 스토리지 규칙은 먼저 status=2 및 deleteStatus=deleting으로 설정하고 백그라운드에서 삭제가 완료되기를 기다립니다. 외부 대상 규칙은 직접 소프트 삭제됩니다. 일치하는 규칙에 연결된 액세스 구성도 삭제 표시됩니다. 이 작업은 이 컨트롤러에서 고객의 외부 버킷, Kafka 클러스터, Doris 테이블 또는 서비스 인덱스를 직접 삭제하지 않으며, 내장 데이터 삭제 결과는 이후에 확인해야 합니다. 성공(true)은 모든 데이터가 즉시 정리되었음을 의미하지 않으며, 삭제 중인 규칙은 상세/조회 작업에서 사용할 수 없습니다.

요청 헤더

매개변수 이름 유형 필수 설명
DF-API-KEY string Y 워크스페이스의 OpenAPI 인증 자격 증명입니다.
예: <DF-API-KEY>
획득 또는 입력 방법: 대상 워크스페이스의 API Key 관리에서 해당 작업 권한이 있는 OpenAPI Key를 가져옵니다.

Body 요청 매개변수

매개변수 이름 유형 필수 설명
cfgUUIDs[*] string 문자열 UUID이며, 서버는 공백을 자동으로 제거하지 않습니다.
예: lgbp_example
획득 또는 입력 방법: 데이터 전송 규칙 목록에서 개별 규칙 uuid를 가져옵니다.
cfgUUIDs array Y 필수 UUID 배열이며, 규칙 이름이나 쉼표로 구분된 문자열이 아닙니다.
null 허용: False
예: ["lgbp_example"]
획득 또는 입력 방법: 데이터 전송 규칙 목록에서 대상 uuid를 가져옵니다.

요청 예시

curl --request POST 'https://openapi.guance.com/api/v1/log_backup_cfg/batch_delete' \
  -H 'DF-API-KEY: <DF-API-KEY>' \
  -H 'Content-Type: application/json' \
  --data-raw '{"cfgUUIDs":["lgbp_example"]}'

응답

HTTP 200, application/json. 아래 예시는 바로 읽을 수 있는 주요 필드를 보여줍니다.

필드 유형 설명
content boolean 요청이 처리되었으면 true이며, 실제 일치 수 또는 물리적 정리 완료 표시가 아닙니다.
{
  "code": 200,
  "content": true,
  "errorCode": "",
  "message": "",
  "success": true,
  "traceId": "TRACE-EXAMPLE"
}

오류 응답

인증, 속도 제한 및 공통 요청 오류는 공통 오류 정의를 참조하세요.

HTTP 상태 errorCode 발생 조건 메시지 또는 응답 설명 처리 방법
406 ft.ParameterValidationFailed 요청 필드가 누락되었거나 필드 값이 선언된 검증 조건을 위반한 경우 매개변수 파싱 실패 매개변수 위치, 필드 이름, 유형 및 값을 확인하세요.
400 ft.RequestJsonFormatError 요청 JSON 구문이 유효하지 않음 요청 JSON 형식 오류 content.reason, line, column에 따라 JSON을 수정하세요.
400 ft.JsonFormatError JSON 최상위가 객체가 아님 일부 JSON 파일 형식 오류 매개변수 표의 JSON 객체를 제출하세요.
403 ft.Forbidden 현재 OpenAPI에서 제외된 Iceberg 구성과 일치했거나 API 권한이 부족한 경우 작업 권한이 없습니다 이 공개 목록에서 지원하는 대상만 작업하세요.
500 ft.InternalServerError 데이터베이스, 캐시, 필드 형태 또는 일반 다운스트림 5xx/타임아웃 처리 실패 내부 오류 쓰기 후에는 먼저 규칙의 현재 상태를 확인하고, 조회 작업은 먼저 task_id를 확인하세요. 계속 실패하면 traceId를 제공하세요.

문서 평가

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