수정¶
POST /api/v1/wksp_share/{wksp_share_uuid}/modify
개요¶
현재 워크스페이스에서 발신한 하나의 권한 부여 구성에 대한 데이터 도메인, 인덱스 및 조건을 전체 교체합니다.
호출 전 및 사용 단계¶
생성/수정/삭제에는 데이터 권한 부여자 워크스페이스의 API Key를 사용하고, 읽기는 현재 Key 워크스페이스의 권한 부여 방향에 따라 수행합니다. 이 그룹에서 권한을 부여하는 대상은 워크스페이스 간 데이터 쿼리 기능이며, 구성원 초대, 계정 역할 부여 또는 데이터 복사를 의미하지 않습니다. 응답의 workspaceUUID는 권한 부여자이고 toWorkspaceUUID는 권한 부여 대상입니다. 생성 시에만 Body.workspaceUUID가 권한 부여 대상 워크스페이스를 의미하며, 응답의 동일 이름 필드와 방향이 다릅니다. 쿼리 적용 가능 여부는 데이터 도메인, 로그 인덱스, 필터 조건, 실제 권한 부여 상태 및 소스 워크스페이스 상태에 의해서도 제한됩니다.
생성/수정/삭제에는 dataRightsManage.workspaceConfigManage가 필요합니다. 먼저 권한 부여 목록type=grant로 현재 워크스페이스가 자체 발신한 기록을 읽고 content.data[].uuid를 가져옵니다. 권한 부여받은 목록에 있는 다른 소스 워크스페이스의 UUID를 자신이 수정할 수 있는 구성으로 간주하지 마세요. 결과가 불확실하면 먼저 구성을 다시 읽어 중복 권한 부여를 피하고, 실패했다고 해서 작업이 전혀 실행되지 않았다고 오인하지 않도록 하세요.
현재 워크스페이스가 권한 부여자이고 모델 status=0인 기록만 수정할 수 있으며, grantStatus=active를 추가로 요구하지 않습니다. pending/expired 기록도 일치할 수 있습니다. 알 수 없거나 다른 워크스페이스의 구성은 404를 반환합니다. 대상 워크스페이스와 사이트는 이 공개 Body로 수정할 수 없으며, workspaceUUID/regionCode/roleUUIDs는 이 페이지 Body 선언에 없습니다. type/indexes는 전체를 제출해야 하며, conditions를 생략하면 기본값 {}로 처리되어 기존 조건이 지워집니다. PATCH 병합 의미는 없습니다.
기존 동일 사이트/교차 사이트 권한 부여 기록의 로컬 범위 업데이트를 지원합니다. 교차 사이트 업데이트를 제출한 후에는 로컬 관련 사이트의 인증 캐시만 무효화하며, 기존 원격 동기화 체인을 능동적으로 호출하지 않고 권한 부여 대상에 즉시 반영된다고 보장하지 않습니다. 실제 쿼리/권한 부여 상태로 검증하세요. 저장 후 원시 모델 필드를 반환하며, 목록의 grantMode/grantStatus/사이트 이름/신원 요약 등 파생 필드를 보완하지 않습니다. 일부 인증 관련 확장은 읽기 API처럼 정리되지 않을 수 있으므로 전체 쓰기 응답을 외부에 공유해서는 안 됩니다.
conditions를 생략하거나 {}로 두면 추가 조건이 없음을 의미하며, 수정 시 생략하면 기존 조건이 지워지고 유지되지 않습니다. metric/tracing/rum 세 배열만 공개하고 lineage 하위 조건은 개방하지 않습니다(공유 내부 검증기가 이 이름을 인식하더라도). 추가 Body 필드는 거부됩니다. 배열 요소는 객체 사용을 권장합니다. op는 반드시 in/not in이어야 하고 value는 반드시 배열이어야 합니다. 동일 카테고리 내 logic은 반드시 일관되어야 하며 and/or 사용을 권장합니다. 현재 logic 열거형/name 필수 여부/배열 요소 객체 형상을 엄격히 검증하지 않으므로 잘못된 형식의 요소는 500을 유발할 수 있습니다. 저장 성공이 조건의 유효성을 보장한다고 의존해서는 안 됩니다. 서로 다른 데이터 도메인의 조건은 상호 권한을 부여하지 않으며, 조건이 구성되지 않은 데이터 도메인을 금지한다는 의미도 아닙니다.
라우트 파라미터¶
| 파라미터 이름 | 유형 | 필수 | 설명 |
|---|---|---|---|
| wksp_share_uuid | string | Y | 실제 URL 경로 파라미터이며, 일반적으로 grant_ 접두사가 붙고 워크스페이스 UUID가 아닙니다. 예시: grant_example가져오기 또는 입력 방법: 권한 부여 목록content.data[].uuid에서 구성 ID를 가져옵니다. |
요청 헤더¶
| 파라미터 이름 | 유형 | 필수 | 설명 |
|---|---|---|---|
| DF-API-KEY | string | Y | 워크스페이스의 OpenAPI 인증 자격 증명입니다. 예시: <DF-API-KEY>가져오기 또는 입력 방법: 대상 워크스페이스의 API Key 관리에서 해당 작업 권한이 있는 OpenAPI Key를 가져옵니다. |
Body 요청 파라미터¶
| 파라미터 이름 | 유형 | 필수 | 설명 |
|---|---|---|---|
| conditions.metric[*] | json | 하나의 조건 객체입니다. 다음 하위 필드는 의미상 지침이며, 현재 전체 사전 항목별 검증은 없습니다. 예시: {"name": "host", "op": "in", "logic": "and", "value": ["example-value"]}가져오기 또는 입력 방법: 배열의 각 항목에 조건 집합을 하나씩 입력합니다. |
|
| conditions.metric[*].name | string | 실제 필드 이름이며 필드 구성 UUID가 아닙니다. 예시: host가져오기 또는 입력 방법: 해당 도메인의 필드 및 비즈니스 허용 값에 따라 구성합니다. |
|
| conditions.metric[*].op | string | 조건부 필수 | 반드시 in 또는 not in이어야 하며, 누락/다른 값은 406입니다. 예시: in가져오기 또는 입력 방법: 해당 도메인의 필드 및 비즈니스 허용 값에 따라 구성합니다. |
| conditions.metric[*].logic | string | and/or 사용을 권장합니다. 동일 도메인 내에서는 반드시 일관되어야 하며, 현재 열거형을 엄격히 검증하지 않고 누락된 값도 일관성 비교에 포함됩니다. 예시: and가져오기 또는 입력 방법: 해당 도메인의 필드 및 비즈니스 허용 값에 따라 구성합니다. |
|
| conditions.metric[*].value | array | 조건부 필수 | 반드시 배열이어야 하며 실제 필드 유형에 따라 요소를 입력합니다. 빈 배열을 전체로 해석해서는 안 됩니다. 예시: ["example-value"]가져오기 또는 입력 방법: 해당 도메인의 필드 및 비즈니스 허용 값에 따라 구성합니다. |
| conditions.tracing[*] | json | 하나의 조건 객체입니다. 다음 하위 필드는 의미상 지침이며, 현재 전체 사전 항목별 검증은 없습니다. 예시: {"name": "service", "op": "in", "logic": "and", "value": ["example-value"]}가져오기 또는 입력 방법: 배열의 각 항목에 조건 집합을 하나씩 입력합니다. |
|
| conditions.tracing[*].name | string | 실제 필드 이름이며 필드 구성 UUID가 아닙니다. 예시: service가져오기 또는 입력 방법: 해당 도메인의 필드 및 비즈니스 허용 값에 따라 구성합니다. |
|
| conditions.tracing[*].op | string | 조건부 필수 | 반드시 in 또는 not in이어야 하며, 누락/다른 값은 406입니다. 예시: in가져오기 또는 입력 방법: 해당 도메인의 필드 및 비즈니스 허용 값에 따라 구성합니다. |
| conditions.tracing[*].logic | string | and/or 사용을 권장합니다. 동일 도메인 내에서는 반드시 일관되어야 하며, 현재 열거형을 엄격히 검증하지 않고 누락된 값도 일관성 비교에 포함됩니다. 예시: and가져오기 또는 입력 방법: 해당 도메인의 필드 및 비즈니스 허용 값에 따라 구성합니다. |
|
| conditions.tracing[*].value | array | 조건부 필수 | 반드시 배열이어야 하며 실제 필드 유형에 따라 요소를 입력합니다. 빈 배열을 전체로 해석해서는 안 됩니다. 예시: ["example-value"]가져오기 또는 입력 방법: 해당 도메인의 필드 및 비즈니스 허용 값에 따라 구성합니다. |
| conditions.rum[*] | json | 하나의 조건 객체입니다. 다음 하위 필드는 의미상 지침이며, 현재 전체 사전 항목별 검증은 없습니다. 예시: {"name": "app_id", "op": "in", "logic": "and", "value": ["example-value"]}가져오기 또는 입력 방법: 배열의 각 항목에 조건 집합을 하나씩 입력합니다. |
|
| conditions.rum[*].name | string | 실제 필드 이름이며 필드 구성 UUID가 아닙니다. 예시: app_id가져오기 또는 입력 방법: 해당 도메인의 필드 및 비즈니스 허용 값에 따라 구성합니다. |
|
| conditions.rum[*].op | string | 조건부 필수 | 반드시 in 또는 not in이어야 하며, 누락/다른 값은 406입니다. 예시: in가져오기 또는 입력 방법: 해당 도메인의 필드 및 비즈니스 허용 값에 따라 구성합니다. |
| conditions.rum[*].logic | string | and/or 사용을 권장합니다. 동일 도메인 내에서는 반드시 일관되어야 하며, 현재 열거형을 엄격히 검증하지 않고 누락된 값도 일관성 비교에 포함됩니다. 예시: and가져오기 또는 입력 방법: 해당 도메인의 필드 및 비즈니스 허용 값에 따라 구성합니다. |
|
| conditions.rum[*].value | array | 조건부 필수 | 반드시 배열이어야 하며 실제 필드 유형에 따라 요소를 입력합니다. 빈 배열을 전체로 해석해서는 안 됩니다. 예시: ["example-value"]가져오기 또는 입력 방법: 해당 도메인의 필드 및 비즈니스 허용 값에 따라 구성합니다. |
| conditions | json | conditions를 생략하거나 {}로 두면 추가 조건이 없음을 의미하며, 수정 시 생략하면 기존 조건이 지워지고 유지되지 않습니다. metric/tracing/rum 세 배열만 공개하고 lineage 하위 조건은 개방하지 않습니다(공유 내부 검증기가 이 이름을 인식하더라도). 추가 Body 필드는 거부됩니다. 배열 요소는 객체 사용을 권장합니다. op는 반드시 in/not in이어야 하고 value는 반드시 배열이어야 합니다. 동일 카테고리 내 logic은 반드시 일관되어야 하며 and/or 사용을 권장합니다. 현재 logic 열거형/name 필수 여부/배열 요소 객체 형상을 엄격히 검증하지 않으므로 잘못된 형식의 요소는 500을 유발할 수 있습니다. 저장 성공이 조건의 유효성을 보장한다고 의존해서는 안 됩니다. 서로 다른 데이터 도메인의 조건은 상호 권한을 부여하지 않으며, 조건이 구성되지 않은 데이터 도메인을 금지한다는 의미도 아닙니다. null 허용: False 예시: {"metric": [{"name": "host", "op": "in", "logic": "and", "value": ["host-example"]}]}가져오기 또는 입력 방법: 권한 부여자의 실제 필드와 값으로 최소 허용 범위를 구성합니다. |
|
| conditions.metric | array | 선택적 조건 배열입니다. 생략하거나 []이면 해당 카테고리에 필터를 추가하지 않습니다. 수정 시 conditions 전체가 제출값으로 교체됩니다. null 허용: False 예시: [{"name": "host", "op": "in", "logic": "and", "value": ["example-value"]}]가져오기 또는 입력 방법: metric의 실제 필드와 값에서 필터 조건을 선택합니다. |
|
| conditions.rum | array | 선택적 조건 배열입니다. 생략하거나 []이면 해당 카테고리에 필터를 추가하지 않습니다. 수정 시 conditions 전체가 제출값으로 교체됩니다. null 허용: False 예시: [{"name": "app_id", "op": "in", "logic": "and", "value": ["example-value"]}]가져오기 또는 입력 방법: rum의 실제 필드와 값에서 필터 조건을 선택합니다. |
|
| conditions.tracing | array | 선택적 조건 배열입니다. 생략하거나 []이면 해당 카테고리에 필터를 추가하지 않습니다. 수정 시 conditions 전체가 제출값으로 교체됩니다. null 허용: False 예시: [{"name": "service", "op": "in", "logic": "and", "value": ["example-value"]}]가져오기 또는 입력 방법: tracing의 실제 필드와 값에서 필터 조건을 선택합니다. |
|
| indexes | array | Y | 필수 배열입니다. type에 * 또는 logging이 포함되면 저장하고, 그렇지 않으면 강제로 []로 비웁니다. *는 모든 인덱스를 의미하며 []는 전체와 같지 않습니다. 저장 시 각 인덱스가 실제로 존재하는지 확인하지 않습니다.null 허용: False 예시: ["default"]가져오기 또는 입력 방법: 권한 부여자의 로그 인덱스 목록에서 name을 가져오며 구성 UUID가 아닙니다. 명시적 페이지네이션 시 경로는 content.data[].name이고, 페이지네이션이 없으면 원시 content[].name입니다. |
| type | array | Y | 필수 배열이며 *는 전체를 의미하고 []는 전체가 아닙니다. 공개 선언에서는 null을 허용하지만 이후 비즈니스 로직에서 500이 발생할 수 있으므로 반드시 배열을 제출하세요. 항목별 열거형 검증을 하지 않으므로 임의의 알 수 없는 값은 권장하지 않습니다. null 허용: True 예시: ["metric", "logging"]가져오기 또는 입력 방법: 실제 권한을 부여할 도메인에 따라 선택합니다(예: metric/logging/tracing/rum/object/custom_object/lineage 등). 대상 쿼리 기능의 지원이 필요합니다. |
요청 예시¶
curl --request POST 'https://openapi.guance.com/api/v1/wksp_share/grant_example/modify' \
-H 'DF-API-KEY: <DF-API-KEY>' \
-H 'Content-Type: application/json' \
--data-raw '{"type":["metric","logging"],"indexes":["default"],"conditions":{"metric":[{"name":"host","op":"in","logic":"and","value":["host-example"]}]}}'
응답¶
HTTP 200, application/json. 아래 예시는 바로 읽을 수 있는 주요 필드를 보여줍니다.
| 필드 | 유형 | 설명 |
|---|---|---|
| content.id | integer | 내부 행 번호이며 API 리소스 식별자로 사용되지 않습니다. |
| content.uuid | string | 권한 부여 구성 UUID로, 일반적으로 grant_ 접두사가 붙습니다. 상세/수정/삭제 시 이 값을 사용합니다. |
| content.workspaceUUID | string | 데이터 권한 부여자 워크스페이스이며, 반드시 현재 쿼리 Key 워크스페이스는 아닙니다(권한 부여받은 목록에서는 다른 소스 워크스페이스). |
| content.workspaceName | string | 권한 부여자 워크스페이스 이름입니다. |
| content.toWorkspaceUUID | string | 데이터 쿼리 권한을 부여받은 대상 워크스페이스입니다. |
| content.toWorkspaceName | string | 권한 부여 대상 워크스페이스 이름입니다. |
| content.regionCode | string | 권한 부여자 사이트 식별자입니다. |
| content.toRegionCode | string | 대상 사이트 식별자입니다. 읽기 시 과거의 빈 값은 호환 규칙에 따라 보완됩니다. |
| content.siteRelationType | string | same_site/same_org_cross_site/external_org_cross_site 등의 사이트 관계이며, 과거 기록은 비어 있을 수 있습니다. |
| content.sourceBaseUrl | string | 일부 교차 사이트 기록의 소스 주소입니다. 일반 동일 사이트에서는 비어 있을 수 있으며, 이번 API Endpoint가 아닙니다. |
| content.targetBaseUrl | string | 일부 교차 사이트 기록의 대상 주소입니다. 일반 동일 사이트에서는 비어 있을 수 있습니다. |
| content.type | array/string 또는 null | 저장된 권한 부여 데이터 도메인이며 *는 전체를 의미합니다. 과거 데이터는 규격화되지 않았을 수 있으므로 상태 0만으로 유효하다고 판단할 수 없습니다. |
| content.type[] | JSON | 일반적으로 데이터 도메인 문자열입니다. 현재 기존 진입점은 요소 열거형을 완전히 검사하지 않습니다. |
| content.indexes | array 또는 null | 권한이 부여된 로그 인덱스 이름 집합이며 인덱스 UUID가 아닙니다. *는 전체를 의미하고, 로그 도메인이 권한 부여되지 않은 경우 []로 저장됩니다. |
| content.indexes[] | string | 하나의 인덱스 이름입니다(예: default). |
| content.conditions | object 또는 null | metric/tracing/rum별로 저장된 필터 구성이며, 데이터 권한 자체나 쿼리 결과가 아닙니다. |
| content.extra | object 또는 null | 역할, 권한 부여 상태 및 교차 사이트 확장을 기록합니다. 읽기와 쓰기 응답의 정리 규칙이 다르므로 인증 진단이 포함된 원시 쓰기 응답을 외부에 공유해서는 안 됩니다. |
| content.extra.recordRole | string | 예: authority/mirror. 일부 기록에만 있습니다. |
| content.extra.grantStatus | string | 기록에 저장된 상태입니다. 읽기 시 pending을 시간에 따라 expired로 표시할 수 있습니다. |
| content.delayDeleteAt | integer | 예정된 삭제 시간입니다. -1은 일반적으로 예정되지 않았음을 의미하며, 기록이 반드시 유효하다는 뜻은 아닙니다. |
| content.status | integer | 모델 상태입니다. 0은 미삭제, 삭제는 일반적으로 3입니다. 비즈니스 권한 부여는 grantStatus 등을 추가로 확인해야 합니다. |
| content.creator | string | 생성자 식별자이며 API Key UUID 또는 과거 계정/시스템 신원일 수 있습니다. |
| content.updator | string | 최근 작업자이며 비어 있을 수 있습니다. |
| content.createAt | integer | 생성 Unix 초입니다. |
| content.updateAt | integer | 업데이트 Unix 초이며 초기에는 -1일 수 있습니다. |
| content.deleteAt | integer | 소프트 삭제 Unix 초이며 삭제되지 않은 경우 일반적으로 -1입니다. |
| content.conditions.metric | array | metric 카테고리의 조건 배열입니다. |
| content.conditions.metric[] | object | 조건 집합입니다. 현재 요소에는 전체 사전 구조 검증이 없습니다. |
| content.conditions.metric[].name | string | 실제 필드 이름입니다. |
| content.conditions.metric[].op | string | in 또는 not in입니다. |
| content.conditions.metric[].logic | string | and/or 사용을 권장하며 동일 카테고리에서는 반드시 일관되어야 합니다. 현재 열거형을 엄격히 검증하지 않습니다. |
| content.conditions.metric[].value | array | 조건 값 배열이며 요소는 실제 필드 유형을 따릅니다. |
| content.conditions.tracing | array | tracing 카테고리의 조건 배열입니다. |
| content.conditions.tracing[] | object | 조건 집합입니다. 현재 요소에는 전체 사전 구조 검증이 없습니다. |
| content.conditions.tracing[].name | string | 실제 필드 이름입니다. |
| content.conditions.tracing[].op | string | in 또는 not in입니다. |
| content.conditions.tracing[].logic | string | and/or 사용을 권장하며 동일 카테고리에서는 반드시 일관되어야 합니다. 현재 열거형을 엄격히 검증하지 않습니다. |
| content.conditions.tracing[].value | array | 조건 값 배열이며 요소는 실제 필드 유형을 따릅니다. |
| content.conditions.rum | array | rum 카테고리의 조건 배열입니다. |
| content.conditions.rum[] | object | 조건 집합입니다. 현재 요소에는 전체 사전 구조 검증이 없습니다. |
| content.conditions.rum[].name | string | 실제 필드 이름입니다. |
| content.conditions.rum[].op | string | in 또는 not in입니다. |
| content.conditions.rum[].logic | string | and/or 사용을 권장하며 동일 카테고리에서는 반드시 일관되어야 합니다. 현재 열거형을 엄격히 검증하지 않습니다. |
| content.conditions.rum[].value | array | 조건 값 배열이며 요소는 실제 필드 유형을 따릅니다. |
| content.authorizationCode | string 또는 null | 원시 모델 인증 호환 필드로 존재할 수 있으며, 일반 비즈니스 호출 자격 증명이 아닙니다. |
| content.declaration | object 또는 null | 최상위 공통 선언입니다. |
| content.extra.tempAuthCodeExpireAt | integer | 임시 권한 부여 패키지 유효 기간의 Unix 초이며 생략될 수 있습니다. 직접 사용할 수 있는 인증 코드가 아닙니다. |
| content.extra.pendingTargetWorkspaceUUID | string | pending 기록의 예상 대상 워크스페이스이며 생략될 수 있습니다. |
| content.extra.metaUUID | string | 권한 부여 패키지 식별자이며 생략될 수 있고, grant 구성 UUID가 아닙니다. |
| content.extra.grantScopeFingerprint | string | 권한 부여 범위 요약이며 생략될 수 있고, 고객 인증 파라미터로 사용되지 않습니다. |
| content.extra.createdAt | integer | 확장 기록 생성 Unix 초이며 생략될 수 있습니다. |
| content.extra.authorityGrantUUID | string | mirror 기록과 연결된 소스 권한 부여 구성 UUID이며 생략될 수 있습니다. 현재 Key 워크스페이스가 보유한 구성으로 바로 간주할 수 없습니다. |
| content.extra.sourceKid | string | 소스 사이트 공개 키 식별자이며 생략될 수 있습니다. |
| content.extra.sourceJwksUri | string | 소스 사이트 공개 키 집합 주소이며 생략될 수 있습니다. |
| content.extra.syncStatus | string | 교차 사이트 동기화 상태입니다(예: success/failed 또는 비어 있음). 생략될 수 있습니다. |
| content.extra.lastSyncAt | integer | 마지막 동기화 Unix 초이며 생략될 수 있습니다. |
| content.extra.lastSyncError | string | 조정된 최근 동기화 오류 요약이며 생략될 수 있습니다. 이번 API의 외부 오류 코드가 아닙니다. |
| content.extra.lastSyncErrorAt | integer | 최근 동기화 실패 Unix 초이며 생략될 수 있습니다. |
| content.extra.resourceSummary | object | 일부 교차 사이트 기록에 동기화되어 저장된 리소스 요약이며 생략될 수 있습니다. 실시간 전체 리소스 목록이 아닙니다. |
| content.extra.resourceSummary.logging | object | 로그 리소스 요약이며 생략될 수 있습니다. |
| content.extra.resourceSummary.logging.indexes | array | 업스트림에서 동기화된 로그 인덱스 요약 항목입니다. 요소는 문자열 또는 객체일 수 있으며 원본 그대로 저장됩니다. |
| content.extra.resourceSummary.logging.indexes[] | JSON | 하나의 인덱스 요약입니다. 고정된 uuid/name 형태를 가정할 수 없으며, 인덱스를 조작하기 전에 인덱스 목록에서 실제 파라미터를 가져와야 합니다. |
| content.extra.resourceSummary.rum | object | RUM 리소스 요약이며 생략될 수 있습니다. |
| content.extra.resourceSummary.rum.applications | array | 업스트림 RUM 애플리케이션 요약 항목이며, 문자열 또는 객체가 실제 반환값에 따라 제공됩니다. |
| content.extra.resourceSummary.rum.applications[] | JSON | 애플리케이션 요약이며 현재 사이트 애플리케이션 구성 UUID를 대체하지 않습니다. |
| content.extra.resourceSummary.updatedAt | number | 리소스 요약 생성 값이며 단위는 업스트림에서 결정합니다. Studio는 단위 변환이나 통일을 보장하지 않습니다. |
| content.extra.resourceSummary.sourceGrantUUID | string | 리소스 요약과 연결된 소스 권한 부여 구성 식별자입니다. |
| content.extra.sourceSite | object | 권한 부여자/대상 사이트 신원 스냅샷이며 생략될 수 있습니다. 현재 요청 Endpoint를 대체하지 않습니다. |
| content.extra.sourceSite.siteCode | string | 사이트 코드입니다. 생략될 수 있습니다. |
| content.extra.sourceSite.regionCode | string | 지역 코드입니다. 생략될 수 있습니다. |
| content.extra.sourceSite.name | string | 사이트 표시 이름입니다. 생략될 수 있습니다. |
| content.extra.sourceSite.issuer | string | 서명자입니다. 생략될 수 있습니다. |
| content.extra.sourceSite.baseUrl | string | 사이트 API 기본 주소입니다. 생략될 수 있습니다. |
| content.extra.sourceSite.jwksUri | string | 공개 키 집합 주소입니다. 생략될 수 있습니다. |
| content.extra.sourceSite.kid | string | 공개 키 식별자입니다. 생략될 수 있습니다. |
| content.extra.sourceSite.publicKeys | array | 일부 사이트 스냅샷에는 공개 키 자료가 포함되며 생략될 수 있습니다. 개인 키는 없습니다. |
| content.extra.sourceSite.publicKeys[] | object | 선택적 공개 키 항목입니다. |
| content.extra.sourceSite.publicKeys[].kid | string | 공개 키 식별자입니다. |
| content.extra.sourceSite.publicKeys[].publicKey | string | PEM 공개 키 본문입니다. |
| content.extra.targetSite | object | 권한 부여자/대상 사이트 신원 스냅샷이며 생략될 수 있습니다. 현재 요청 Endpoint를 대체하지 않습니다. |
| content.extra.targetSite.siteCode | string | 사이트 코드입니다. 생략될 수 있습니다. |
| content.extra.targetSite.regionCode | string | 지역 코드입니다. 생략될 수 있습니다. |
| content.extra.targetSite.name | string | 사이트 표시 이름입니다. 생략될 수 있습니다. |
| content.extra.targetSite.issuer | string | 서명자입니다. 생략될 수 있습니다. |
| content.extra.targetSite.baseUrl | string | 사이트 API 기본 주소입니다. 생략될 수 있습니다. |
| content.extra.targetSite.jwksUri | string | 공개 키 집합 주소입니다. 생략될 수 있습니다. |
| content.extra.targetSite.kid | string | 공개 키 식별자입니다. 생략될 수 있습니다. |
| content.extra.targetSite.publicKeys | array | 일부 사이트 스냅샷에는 공개 키 자료가 포함되며 생략될 수 있습니다. 개인 키는 없습니다. |
| content.extra.targetSite.publicKeys[] | object | 선택적 공개 키 항목입니다. |
| content.extra.targetSite.publicKeys[].kid | string | 공개 키 식별자입니다. |
| content.extra.targetSite.publicKeys[].publicKey | string | PEM 공개 키 본문입니다. |
| content.extra.resourceSummary.metric | object | 해당 도메인의 리소스 요약이며 생략될 수 있습니다. |
| content.extra.resourceSummary.metric.workspaceUUIDs | array | 동기화되어 저장된 소스 워크스페이스 식별자 집합이며 요소는 일반적으로 문자열입니다. 현재 Key가 임의의 워크스페이스를 조작할 수 있는 권한은 아닙니다. |
| content.extra.resourceSummary.metric.workspaceUUIDs[] | JSON | 개별 워크스페이스 식별자는 업스트림 실제 반환값을 따르며, 규격이 불완전한 과거 항목은 먼저 확인해야 합니다. |
| content.extra.resourceSummary.tracing | object | 해당 도메인의 리소스 요약이며 생략될 수 있습니다. |
| content.extra.resourceSummary.tracing.workspaceUUIDs | array | 동기화되어 저장된 소스 워크스페이스 식별자 집합이며 요소는 일반적으로 문자열입니다. 현재 Key가 임의의 워크스페이스를 조작할 수 있는 권한은 아닙니다. |
| content.extra.resourceSummary.tracing.workspaceUUIDs[] | JSON | 개별 워크스페이스 식별자는 업스트림 실제 반환값을 따르며, 규격이 불완전한 과거 항목은 먼저 확인해야 합니다. |
| content.extra.resourceSummary.lineage | object | 해당 도메인의 리소스 요약이며 생략될 수 있습니다. |
| content.extra.resourceSummary.lineage.workspaceUUIDs | array | 동기화되어 저장된 소스 워크스페이스 식별자 집합이며 요소는 일반적으로 문자열입니다. 현재 Key가 임의의 워크스페이스를 조작할 수 있는 권한은 아닙니다. |
| content.extra.resourceSummary.lineage.workspaceUUIDs[] | JSON | 개별 워크스페이스 식별자는 업스트림 실제 반환값을 따르며, 규격이 불완전한 과거 항목은 먼저 확인해야 합니다. |
{
"code": 200,
"content": {
"id": 10,
"uuid": "grant_example",
"workspaceUUID": "wksp_source",
"toWorkspaceUUID": "wksp_target",
"regionCode": "SITE-CODE",
"toRegionCode": "SITE-CODE",
"workspaceName": "授权方示例空间",
"toWorkspaceName": "被授权方示例空间",
"authorizationCode": null,
"siteRelationType": "same_site",
"sourceBaseUrl": "",
"targetBaseUrl": "",
"extra": {
"recordRole": "authority",
"grantStatus": "active"
},
"type": [
"metric",
"logging"
],
"indexes": [
"default"
],
"conditions": {
"metric": [
{
"name": "host",
"op": "in",
"logic": "and",
"value": [
"host-example"
]
}
]
},
"delayDeleteAt": -1,
"status": 0,
"creator": "wsak_example",
"updator": "wsak_example",
"createAt": 1785427200,
"updateAt": 1785429000,
"deleteAt": -1,
"declaration": {}
},
"errorCode": "",
"message": "",
"success": true,
"traceId": "TRACE-EXAMPLE"
}
오류 응답¶
인증, 속도 제한 및 공통 요청 오류는 공통 오류 정의를 참조하세요.
런타임 선언의 과거 경로 필드 이름이 잘못되어 이 페이지에서는 문서 표시만 수정합니다. 실제 URL 파라미터는 wksp_share_uuid입니다. 비즈니스 소속 및 교체 동작은 현재 구현을 따릅니다.
| HTTP 상태 | errorCode | 트리거 조건 | 메시지 또는 응답 설명 | 처리 방법 |
|---|---|---|---|---|
| 404 | ft.ObjectNotExists | 현재 워크스페이스가 소스이고 모델 status=0인 권한 부여 기록을 찾을 수 없음 | 지정한 객체가 존재하지 않습니다 | type=grant 목록의 content.data[].uuid에서 다시 값을 가져오고, 워크스페이스 UUID로 대체하지 마세요. |
| 406 | ft.ParameterValidationFailed | 요청 필드가 누락되었거나 필드 값이 선언된 검증 조건을 위반함 | 파라미터 파싱 실패 | 파라미터 위치, 필드 이름, 유형 및 값을 확인하세요. |
| 400 | ft.RequestJsonFormatError | 요청 JSON 구문이 유효하지 않음 | 요청 JSON 형식 오류 | content.reason, line, column에 따라 JSON을 수정하세요. |
| 400 | ft.JsonFormatError | 본문이 객체가 아님 | 일부 json 파일 형식 오류 | 이 페이지의 JSON 객체를 제출하세요. |
| 406 | ft.WorkspaceGrantConditionOperatorInvalid | 조건 요소 op가 누락되었거나 in/not in이 아님 | 권한 부여 범위 {} 조건의 연산자는 in 또는 not in만 지원합니다 | 각 항목에 in 또는 not in을 입력하고 필드가 비즈니스 범위와 일치하도록 유지하세요. |
| 406 | ft.WorkspaceGrantConditionValueMustBeList | 조건 요소 value가 배열이 아님 | 권한 부여 범위 {} 조건의 value 필드는 목록이어야 합니다 | JSON 배열을 사용하고 쉼표로 구분된 문자열을 제출하지 마세요. |
| 406 | ft.WorkspaceGrantConditionLogicMixed | 동일 카테고리 logic에 여러 다른 값이 나타남(누락과 and 혼용 포함) | 권한 부여 범위 {} 조건은 서로 다른 논리 연산자 혼용을 지원하지 않습니다 | 동일 카테고리의 모든 조건에서 logic을 and 또는 or로 통일하세요. |
| 406 | ft.WKSPShareInvalid | 과거 기록의 대상 UUID가 잘못되었거나 동일 사이트의 대상 워크스페이스가 더 이상 존재하지 않거나 비활성 상태임. 이번에는 기존 교차 사이트 기록을 거부하지 않으며, 대상 versionType=freeEdition만을 이유로 수정을 거부하지도 않음 | 잘못된 워크스페이스 uuid | 현재 소스 기록과 실제 대상 워크스페이스 상태를 확인하고, 공개 Body가 지원하는 범위 필드를 사용하며 대상 워크스페이스/사이트를 교체하지 마세요. |
| 406 | ft.WKSPIllegalAuthorization | 현재 권한 부여자 워크스페이스를 자신에게 권한 부여하려 함 | 데이터 권한 부여에는 현재 워크스페이스 ID가 아닌 값을 입력해야 합니다. 다시 입력하세요 | 다른 권한 부여 대상 워크스페이스 UUID를 입력하세요. |
| 406 | ft.WKSPRepeatAuthorization | 동일 소스/대상/사이트에 이미 status=0 기록이 있음(grantStatus 추가 검사 안 함) | 워크스페이스가 이미 권한 부여되었습니다. 중복 권한 부여하지 마세요! | 먼저 기존 구성을 읽고 필요에 따라 수정하며 중복 생성하지 마세요. |
| 500 | ft.InternalServerError | type=null이 후속 코드에서 처리됨, 조건 요소 구조 이상, 저장 오류 또는 제출 후 캐시/사이트 자료 준비 실패 | 내부 오류 | 먼저 목록/상세를 다시 읽어 저장 여부를 확인하고 traceId를 보관한 후 재시도 여부를 결정하세요. 전체 작업이 롤백되었다고 간주하지 마세요. |
| ``` |