콘텐츠로 이동

RUM 설정 삭제



POST /api/v1/rum_cfg/delete

개요

지정된 RUM 애플리케이션 설정을 삭제하고 매핑 삭제를 비동기로 동기화합니다.

호출 전 및 사용 단계

현재 Key에는 rum.rumCfgManage 권한이 필요하며 현재 워크스페이스에만 적용됩니다. appIds 배열을 권장합니다. 기존 rumcfgUUIDs가 비어 있지 않으면 우선 사용되고 appIds는 완전히 무시됩니다. 필드 이름에 UUID가 포함되어 있지만 값은 여전히 공개 appId입니다. 둘 다 생략하거나 []이면 애플리케이션이 선택되지 않으며 {}를 반환합니다.

현재 워크스페이스에서 삭제되지 않은 일치 애플리케이션만 소프트 삭제하고 실제로 일치한 appId→이름 객체를 반환합니다. 알 수 없거나 다른 워크스페이스에 속하거나 이미 삭제된 항목은 무시됩니다. custom 바인딩 관계는 소프트 삭제되지만 원본 대시보드와 기본 제공 뷰는 삭제되지 않습니다. SourceMap 관리 대상 애플리케이션은 동시에 해당 보존 정책이 중지되고 실행되지 않은 retention 정리가 취소되지만, 이는 소스 파일을 즉시 삭제하거나 이미 실행된 정리를 롤백하거나 데이터를 복구하는 것과 같지 않습니다.

연결된 Client Token을 삭제/취소하지 않으며, 이 컨트롤러에 따라 과거 RUM 텔레메트리 데이터를 삭제하지도 않습니다. 애플리케이션 삭제를 수집 자격 증명 폐기로 간주해서는 안 됩니다. 제출 후 요청된 appId에 따라 매핑 삭제 조정을 전달하며(일치하지 않은 중복 삭제 항목 포함), 큐 실패는 허용되고 성공이 조회/수집 노드의 즉시 수렴을 보장하지는 않습니다. 재시도하면 조정이 다시 트리거될 수 있으므로, 먼저 간략 목록과 비즈니스 상태를 다시 읽은 후 처리 여부를 결정하십시오.

요청 헤더

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

Body 요청 매개변수

매개변수 이름 유형 필수 설명
appIds[*] string 공개 appId 문자열 하나입니다.
예시: payment_web
획득 또는 입력 방법: RUM 애플리케이션 간략 목록에서 content[].appId를 가져오거나(uuid가 동일한 값), 현재 워크스페이스의 RUM 애플리케이션 설정에서 가져옵니다.
rumcfgUUIDs[*] string 레거시 호환 appId 문자열 하나입니다.
예시: payment_web
획득 또는 입력 방법: RUM 애플리케이션 간략 목록에서 content[].appId를 가져오거나(uuid가 동일한 값), 현재 워크스페이스의 RUM 애플리케이션 설정에서 가져옵니다.
appIds array 권장되는 애플리케이션 식별자 배열이며 생략하거나 []이면 대상이 없습니다. 여러 항목이라도 항목별 오류를 반환하지 않고 실제로 삭제된 이름 매핑만 반환합니다.
null 허용: False
예시: ["payment_web"]
획득 또는 입력 방법: RUM 애플리케이션 간략 목록에서 content[].appId를 가져오거나(uuid가 동일한 값), 현재 워크스페이스의 RUM 애플리케이션 설정에서 가져옵니다.
rumcfgUUIDs array 레거시 호환 배열이며 새 호출에는 사용하지 않는 것이 좋습니다. 비어 있지 않으면 appIds보다 우선하며, 항목은 내부 UUID가 아닌 appId입니다. 비어 있을 때만 appIds로 대체합니다.
null 허용: False
예시: []
획득 또는 입력 방법: RUM 애플리케이션 간략 목록에서 content[].appId를 가져오거나(uuid가 동일한 값), 현재 워크스페이스의 RUM 애플리케이션 설정에서 가져옵니다.

요청 예시

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

응답

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

필드 유형 설명
content object 실제로 삭제된 appId에서 이름으로의 매핑이며 일치 항목이 없으면 {}입니다(빈 객체에는 declaration이 삽입되지 않습니다).
content.애플리케이션 식별자 string 실제로 삭제된 특정 애플리케이션의 이름이며, 불리언이나 삭제 횟수가 아닙니다.
content.declaration object 비어 있지 않은 삭제 매핑은 현재 워크스페이스 선언을 삽입합니다. 동적 appId 이름 지정 시 declaration 예약 키를 사용하지 않아야 합니다.
{
  "code": 200,
  "content": {
    "payment_web": "支付Web",
    "declaration": {}
  },
  "errorCode": "",
  "message": "",
  "success": true,
  "traceId": "TRACE-EXAMPLE"
}
{
  "code": 200,
  "content": {},
  "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 파일 형식 오류 appIds 배열 객체를 제출하십시오.
429 ft.OperationTooFrequently 현재 워크스페이스의 다른 RUM 생성/수정/삭제/Token 작업이 쓰기 잠금을 보유하고 있어 5초 내에 획득하지 못함 작업이 너무 빈번합니다. 잠시 후 다시 시도하십시오 다른 작업이 끝날 때까지 대기하고 백오프하십시오. 현재 상태를 다시 읽은 후 재시도하며 동시에 수정하지 마십시오.
500 ft.InternalServerError 데이터베이스 삭제, SourceMap 보존 정책 중지 또는 잠금 서비스 이상 내부 오류 먼저 애플리케이션이 삭제되었는지 확인한 후 관리자에게 SourceMap 보존 정책/정리 및 비동기 매핑 현재 상태를 확인하도록 요청하십시오. 실패를 근거로 삭제가 발생하지 않았다고 판단하지 마십시오.

문서 평가

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