콘텐츠로 이동

SLS를 DQL로 변환¶

POST /api/v1/sls/convert

개요¶

Alibaba Cloud SLS 쿼리 문장을 로그 DQL로 변환합니다. 이 API는 구문 변환만 수행하며, 워크스페이스 데이터를 조회하거나 수정하지 않습니다.

매개변수명	유형	필수	설명
`DF-API-KEY`	string	예	API Key 식별자입니다.

Body 요청 매개변수¶

매개변수명	유형	필수	설명
`query`	string	예	변환할 Alibaba Cloud SLS 쿼리 문장입니다. 비워둘 수 없습니다.
`indexes`	array	아니요	로그 인덱스 이름 목록입니다. 생략하거나 빈 배열을 전달하면 생성된 DQL에 인덱스 제한이 추가되지 않습니다.

반환 설명¶

변환 결과는 응답의 content에 포함됩니다:

필드	유형	설명
`status`	string	변환 상태입니다. `exact`, `approximate` 또는 `unsupported`일 수 있습니다.
`dql`	string	변환으로 생성된 로그 DQL입니다. 현재 구문이 지원되지 않으면 비어 있을 수 있습니다.
`diagnostics`	array	변환 진단 정보입니다. 근사 변환 또는 지원되지 않는 구문을 설명하는 데 사용됩니다. `exact`이고 진단 정보가 없으면 빈 배열을 반환합니다.

상태 의미:

exact: 생성된 DQL이 원본 SLS 쿼리 문장과 동등합니다.
approximate: 근사 DQL이 생성되었습니다. 실행 전에 diagnostics를 검토하여 의미 차이를 확인해야 합니다.
unsupported: 현재 SLS 구문이 지원되지 않습니다. dql이 비어 있을 수 있습니다.

변환 결과는 고정적으로 로그 네임스페이스 L을 사용합니다. indexes는 DQL 텍스트 생성에만 사용되며, 인터페이스가 인덱스 존재 여부를 검증하지는 않습니다. 이후 변환 결과를 실행할 때는 해당 데이터 조회 인터페이스에서 권한 및 데이터 액세스 규칙 검증을 수행합니다.

요청 예시¶

curl 'https://openapi.guance.com/api/v1/sls/convert' \
  -H 'Content-Type: application/json' \
  -H 'DF-API-KEY: <DF-API-KEY>' \
  --data-raw '{"query":"status:200","indexes":["default"]}'

응답 예시¶

{
  "code": 200,
  "content": {
    "status": "exact",
    "dql": "L::re(`.*`):(*)",
    "diagnostics": []
  },
  "errorCode": "",
  "message": "",
  "success": true,
  "traceId": "TRACE-XXXX"
}