추가¶
POST /api/v1/wksp_share/add
개요¶
Body 요청 파라미터¶
| 파라미터명 | 유형 | 필수 | 설명 |
|---|---|---|---|
| workspaceUUID | commaArray | Y | 권한이 부여된 워크스페이스 ID 빈 값 허용: False |
| type | array | Y | 데이터 유형, ["*"]는 전체를 의미 예시: ['metric', 'keyevent', 'network', 'rum', 'dialtest', 'billing', 'logging', 'tracing', 'object', 'custom_object', 'profiling', 'llm', 'agent_monitor'] 빈 값 허용: True |
| indexes | array | Y | 인덱스 이름, [""]는 전체를 의미 예시: [''] 빈 값 허용: False |
| regionCode | string | 권한이 부여된 워크스페이스가 속한 사이트 Code, 기본값은 현재 사이트 빈 값 허용: False 빈 문자열 허용: True |
|
| conditions | json | 필터 조건 빈 값 허용: False |
|
| conditions.metric | array | 메트릭 유형의 필터 조건 빈 값 허용: False |
|
| conditions.tracing | array | 애플리케이션 성능 모니터링(APM) 유형의 필터 조건 빈 값 허용: False |
|
| conditions.rum | array | 실제 사용자 모니터링(RUM) 유형의 필터 조건 빈 값 허용: False |
파라미터 추가 설명¶
1. 요청 파라미터 설명
| 파라미터명 | 설명 |
|---|---|
| regionCode | 권한이 부여된 사이트 code (workspace/website/list 인터페이스를 통해 획득 가능), 데이터 액세스 구성의 사이트 정보, 기본적으로 현재 사이트의 데이터에 권한 부여 |
| workspaceUUID | 권한이 부여된 워크스페이스 uuid |
| type | 권한 유형, ["*"]는 전체를 의미, 선택 가능한 유형: ["metric","keyevent","network","rum","dialtest","billing","logging","tracing","object","custom_object","profiling","llm","agent_monitor"] |
| indexes | 권한이 부여된 로그 인덱스 이름 |
| conditions | 권한 범위의 필터 조건 |
2.conditions 필드 설명
| 파라미터명 | type | 필수 | 설명 |
|---|---|---|---|
| metric | array | N | 메트릭 유형 필터 조건 |
| tracing | array | N | APM 유형 필터 조건 |
| rum | array | N | RUM 유형 필터 조건 |
3. conditions.metric / conditions.tracing / conditions.rum 파라미터 설명
| key | 유형 | 필수 여부 | 설명 |
|---|---|---|---|
| metric[#] | dict | conditions.metric / conditions.tracing / conditions.rum 배열 내의 필터 조건 요소 |
|
| metric[#].op | string | 필드명과 필드값의 논리 연산자 in,not in |
|
| metric[#].name | string | 필드명 | |
| metric[#].logic | string | 동일 유형 내 여러 필터 조건 그룹 간의 논리 관계 연산자 or,and, 동일 유형 내 논리 관계 연산자는 동일해야 함 |
|
| metric[#].value | array | 필드값 |
**4. conditions 예시는 다음과 같습니다.
{
"metric": [
{
"name": "host",
"value": [
"host1",
"host2"
],
"op": "in",
"logic": "and"
},
{
"name": "service",
"value": [
"guance"
],
"op": "not in",
"logic": "and"
}
],
"tracing": [
{
"name": "service",
"value": [
"kodo"
],
"op": "in",
"logic": "and"
}
],
"rum": [
{
"name": "app_id",
"value": [
"app_x"
],
"op": "not in",
"logic": "and"
}
]
}
요청 예시¶
curl 'https://openapi.guance.com/api/v1/wksp_share/add' \
-H 'Content-Type: application/json' \
-H 'DF-API-KEY: <DF-API-KEY>' \
--data-raw '{"regionCode":"testing","workspaceUUID":"wksp_a810008c0e4e4e70ad9222c01f083287","type":["*"],"indexes":["*"]}' \
--compressed
응답¶
{
"code": 200,
"content": {
"authorizationCode": null,
"createAt": 1757572382,
"creator": "wsak_7e0689c908774efda1b345c20c5d23d7",
"declaration": {
"asd": "aa,bb,cc,1,True",
"asdasd": "dawdawd",
"business": "aaa",
"dd": "dd",
"fawf": "afawf",
"organization": "64fe7b4062f74d0007b46676"
},
"delayDeleteAt": -1,
"deleteAt": -1,
"id": 468,
"indexes": [
"*"
],
"name": "doris testing",
"regionCode": "testing",
"status": 0,
"toRegionCode": "testing",
"toWorkspaceName": "doris testing",
"toWorkspaceUUID": "wksp_a810008c0e4e4e70ad9222c01f083287",
"type": [
"*"
],
"updateAt": -1,
"updator": "",
"uuid": "grant_2ee1f355abf84a038f4aacb9319fd747",
"workspaceName": "testing workspace",
"workspaceUUID": "wksp_4b57c7bab38e4a2d9630f675dc20015d"
},
"errorCode": "",
"message": "",
"success": true,
"traceId": "TRACE-AF6A234D-7804-4A1C-BC38-7861088BA6B5"
}