콘텐츠로 이동

삭제



POST /api/v1/rum_sourcemap/delete

개요

지정된 애플리케이션, 환경 및 버전의 SourceMap 파일을 수동으로 삭제합니다.

호출 전 및 사용 단계

현재 Key에는 rum.rumCfgManage 권한이 필요합니다. 현재 Key가 속한 워크스페이스에만 적용됩니다. appId는 RUM 애플리케이션 요약 목록 content[].appId에서 가져오며, SDK/오류 레코드의 app_id와 일치해야 하고 데이터베이스 내부 UUID로 대체할 수 없습니다. SourceMap은 애플리케이션, 환경 env 및 버전 version으로 정확하게 식별됩니다. 대소문자/공백은 식별자 자체에 속하므로 수집 레코드와 완전히 일치해야 합니다. env/version을 생략하거나 빈 문자열로 지정하면 빈 환경/빈 버전을 의미하며, 전체를 와일드카드로 매칭하는 것이 아닙니다. 현재 호스팅 수명 주기에서는 각각 최대 256자여야 합니다.

복구할 수 없는 파일 삭제 작업입니다. 먼저 버전이 비활성화되었는지 확인하고 빌드 원본 산출물을 보관하세요. 정확한 env/version만 삭제하며, 전체 애플리케이션/모든 환경을 삭제하는 것이 아니고 RUM 애플리케이션/클라이언트 Token 또는 과거 오류 레코드도 삭제하지 않습니다. 이전 오류 레코드는 소스를 다시 복원하지 못할 수 있습니다.

현재 대상이 존재하지 않고 동일 버전의 미완료 업로드가 없으면 true를 반환할 수 있으며 삭제 감사 기록이 없습니다. 대기 중인 업로드/읽기/정리 충돌이 있으면 409를 반환하며 점유를 우회할 수 없습니다. 정상 흐름에서는 먼저 정리 표시를 하고 소유권을 획득한 후 파일 삭제/인덱스 업데이트/레코드 완료를 수행합니다. 실패 시 파일은 삭제되었지만 인덱스/상태가 수렴되지 않아 보상 처리로 진입할 수 있습니다. 목록에서는 삭제 중인 레코드가 숨겨지며, 목록에서 사라졌다고 해서 물리적 회수가 완료되었음을 단독으로 증명할 수는 없습니다.

HTTP200/content=true는 이 요청이 완료되었음을 나타내며 삭제된 파일 수는 제공하지 않습니다. 네트워크 실패/500 발생 시 먼저 목록, 파일 트리 오류 및 traceId를 함께 확인하여 대조하고, 동일 버전을 무작정 반복 삭제하거나 재생성하지 마세요. 수동 삭제는 최신 파일 보존 개수 정책의 보호를 받지 않으며, 원본 빌드 파일은 고객이 직접 보관해야 합니다.

요청 헤더

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

Body 요청 매개변수

매개변수명 유형 필수 설명
appId string Y 현재 워크스페이스의 활성 애플리케이션 식별자를 필수로 지정합니다. 내부 RumCfg UUID가 아니며 워크스페이스 간 사용할 수 없습니다.
null 허용: False
예: payment_web
획득 또는 입력 방법: RUM 애플리케이션 요약 목록 content[].appId 또는 오류 레코드 app_id에서 획득합니다.
env string 선택적 문자열이며 기본값은 빈 환경이고 최대 256자입니다. 모든 환경을 의미하지 않으며 null은 허용되지 않습니다.
빈 문자열 허용: True
null 허용: False
예: production
획득 또는 입력 방법: 클라이언트 게시 환경/오류 레코드 env에서 가져오며 업로드 시와 문자 단위로 일치해야 합니다.
version string 선택적 문자열이며 기본값은 빈 버전이고 최대 256자입니다. 최신/모든 버전을 의미하지 않으며 null은 허용되지 않습니다.
빈 문자열 허용: True
null 허용: False
예: 1.2.3
획득 또는 입력 방법: 클라이언트의 실제 게시 버전/오류 레코드 version에서 가져오며 빌드 산출물과 대응합니다.

요청 예시

curl --request POST 'https://openapi.guance.com/api/v1/rum_sourcemap/delete' \
  -H 'DF-API-KEY: <DF-API-KEY>' \
  -H 'Content-Type: application/json' \
  --data-raw '{"appId":"payment_web","env":"production","version":"1.2.3"}'

응답

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

필드 유형 설명
content boolean 고정 true이며 대상이 없어도 true일 수 있고 파일 수는 없습니다.
content.reasonCode string 오류 응답에서만: 기계 판독 가능한 원인입니다. 예: active_operation/invalid_scope/registry_missing.
content.action string 오류 응답에서만: 권장 작업입니다. 예: retry_after_operation/verify_ownership/check_scope_and_upload.
content.retryable boolean 오류 응답에서만: 서버가 권장하는 재시도 가능 표시이며, 이를 단독으로 근거로 이미 게시된 쓰기를 재생할 수 없습니다.
content.uploadCommitted boolean 일부 단일 파일 오류 진단에서만: true는 해당 쓰기가 게시 확인되었음을 의미합니다. 생략은 false를 의미하지 않으며 쓰기가 되지 않았음이 확인되었다는 의미도 아닙니다.
content.actualBytes integer 일부 용량 오류에서만: 집계된 바이트 수입니다.
content.maxBytes integer 용량/읽기 제한 바이트 수입니다.
content.workspaceUUID string 일부 오류의 제한된 진단: 현재 워크스페이스 UUID입니다.
content.appId string 일부 오류의 제한된 진단: 공개 애플리케이션 식별자입니다.
content.rumCfgUUID string 일부 오류의 제한된 진단: 내부 애플리케이션 식별자이며 지원 문제 해결에만 사용되고 요청 appId를 대체하지 않습니다.
content.env string 일부 오류 진단: 환경입니다.
content.version string 일부 오류 진단: 버전입니다.
content.bundleUUID string 일부 오류 진단: 이번 세대 레코드 ID이며 uploadId가 아닙니다.
content.state string 일부 오류 진단: 세대 상태입니다.
content.resource string 일부 점유 상태 진단: 리소스 유형입니다(예: application/bundle).
content.shared boolean 일부 점유 상태 진단: 공유 액세스 여부입니다.
content.waitedSeconds number 일부 점유 상태 진단: 대기한 초 수입니다.
content.waitSeconds number 일부 점유 상태 진단: 허용된 대기 초 수입니다.
content.waitExhausted boolean 일부 점유 상태 진단: 이번 대기 시간이 소진되었는지 여부입니다.
content.elapsedSeconds number 일부 단일 파일 오류 진단: 작업 소요 시간(초)입니다.
content.phase string 일부 오류 진단: 실패 단계입니다.
content.phaseElapsedSeconds number 일부 오류 진단: 단계 소요 시간(초)입니다.
{
  "code": 200,
  "content": true,
  "errorCode": "",
  "message": "",
  "success": true,
  "traceId": "TRACE-EXAMPLE"
}

오류 응답

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

스토리지 수명 주기에서 호환성을 위해 유지되는 오류 코드: 409는 일반적으로 여전히 ft.InvalidAction이며, 현지화된 message와 content.reasonCode가 원인을 추가로 구분합니다. message 이름인 SourceMapOperationBusy 등을 반드시 errorCode로 간주하지 않습니다. 읽기 시 패키지 누락/처리 중/사용 불가한 경우 일반적으로 404 ft.SourceMapPackageNotFound이며, 구체적인 원인은 reasonCode를 확인합니다. 명시적으로 retryable=true가 반환되고 현재 상태가 허용하는 경우에만 백오프 후 재시도합니다. uploadCommitted=true인 경우 이미 게시가 확인된 쓰기를 재생할 수 없습니다.

HTTP 상태 errorCode 트리거 조건 메시지 또는 응답 설명 처리 방식
406 ft.ParameterValidationFailed 요청 필드 누락 또는 필드 값이 선언된 검증 조건을 위반함 매개변수 파싱 실패 매개변수 위치, 필드명, 유형, 값을 확인합니다.
400 ft.RequestJsonFormatError 요청 JSON 구문 무효 요청 JSON 형식 오류 content.reason, line, column에 따라 JSON을 수정합니다.
400 ft.JsonFormatError JSON 최상위가 객체가 아님 일부 json 파일 형식 오류 객체를 제출합니다.
404 ft.NotFoundRumSet 애플리케이션이 현재 워크스페이스에 없거나 삭제되었거나 존재하지 않음 지정된 RUM 설정을 찾을 수 없음 RUM 애플리케이션 요약 목록을 새로 고치고 현재 워크스페이스의 실제 appId를 사용합니다.
409 ft.InvalidAction 업로드/읽기/정리 충돌, 이전 디렉터리 인수 미완료, 소유권/복구 확인 대기 또는 환경 버전이 수명 주기 허용 범위를 초과함 reasonCode에 따라 구체적인 현지화 메시지를 반환합니다. 예: SourceMap이 다른 업로드, 읽기 또는 정리 작업에서 사용 중입니다. content.reasonCode/action/retryable을 확인합니다. active_operation/active_upload 등은 안내에 따라 백오프하고, owner_recovery_required/ownership_verification_required/legacy_invalid 등은 먼저 관리자에게 확인을 요청하며 점유 레코드를 임의로 삭제하거나 강제로 덮어쓰지 않습니다. invalid_scope인 경우 env/version이 최대 256자 이내인지 확인합니다.
406 ft.InvalidFileName 파일 상대 경로, 심볼릭 링크 또는 이전 게시 경로가 안전하지 않음 SourceMap 파일 경로가 요구 사항을 충족하지 않거나 지원되지 않는 링크를 포함합니다. 업로드 파일의 상대 경로와 디렉터리 구조를 확인하세요. 패키지 내 합법적인 상대 경로를 사용하고 .., 역슬래시, 절대 경로/심볼릭 링크를 포함하지 않도록 합니다. reasonCode=invalid_path인지 확인합니다.
500 ft.InternalServerError 데이터베이스, Redis, 스토리지 읽기/쓰기, 큐 또는 처리되지 않은 시스템 예외 내부 오류 traceId, 애플리케이션/env/version/uploadId를 보관하고 먼저 목록/파일 트리를 확인합니다. 실패 시 이미 파일이 게시되었거나 처리 표시가 있었을 수 있으므로 무작정 다시 덮어쓰거나 삭제하지 않습니다.

문서 평가

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