삭제¶
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를 보관하고 먼저 목록/파일 트리를 확인합니다. 실패 시 이미 파일이 게시되었거나 처리 표시가 있었을 수 있으므로 무작정 다시 덮어쓰거나 삭제하지 않습니다. |