콘텐츠로 이동

추가



POST /api/v1/wksp_share/add

개요

현재 사이트에서 다른 워크스페이스에 데이터 쿼리 권한을 추가합니다.

호출 전 및 사용 단계

생성/수정/삭제는 데이터 권한 부여자 워크스페이스의 API Key를 사용하고, 읽기는 현재 Key 워크스페이스의 권한 방향에 따라 동작합니다. 이 그룹의 권한은 워크스페이스 간 데이터 쿼리 기능이며, 멤버 초대, 계정 역할 부여 또는 데이터 복사가 아닙니다. 응답의 workspaceUUID는 권한 부여자, toWorkspaceUUID는 권한 부여 대상입니다. 추가 요청의 Body.workspaceUUID만이 권한을 부여받는 대상 워크스페이스를 의미하며, 응답의 동일 이름 필드와 방향이 다릅니다. 쿼리 적용 여부는 데이터 도메인, 로그 인덱스, 필터 조건, 실제 권한 상태 및 소스 워크스페이스 상태에 의해서도 제한됩니다.

생성/수정/삭제에는 dataRightsManage.workspaceConfigManage 권한이 필요합니다. 먼저 권한 목록 type=grant로 현재 워크스페이스가 발신한 기록을 읽고 content.data[].uuid를 가져옵니다. 권한 부여 대상 목록에 있는 다른 소스 워크스페이스의 UUID를 자신이 수정할 수 있는 구성으로 간주하지 마세요. 결과를 알 수 없으면 먼저 구성을 다시 읽어 중복 권한 부여를 피하거나, 실패했다고 해서 전혀 실행되지 않았다고 오해하지 않도록 합니다.

이 추가는 동일 사이트의 서로 다른 유효한 대상 워크스페이스만 지원합니다(대상 versionType=freeEdition이면 거부됨). regionCode로 새로운 크로스 사이트 관계를 생성할 수 없습니다. 크로스 사이트는 meta 생성 및 meta 가져오기 절차를 사용하세요. workspaceUUID는 한 번에 하나입니다. type/indexes는 전체 권한 범위이며, 저장 성공이 인덱스의 실제 존재를 검증하지도 않고 다운스트림 쿼리가 이미 성공했음을 의미하지도 않습니다.

추가는 먼저 기록을 제출한 다음 사이트 이름/선택적 알림 및 감사를 준비합니다. 알림 내부 오류는 로그만 기록될 수 있으며, API 성공이 이메일 전송을 보장하지 않습니다. 제출 후 다른 준비 실패도 500을 반환할 수 있지만 구성은 이미 존재합니다. 동일한 소스/대상 사이트 조합을 다시 생성하면 406 이미 권한 부여됨이 발생하므로, 결과를 알 수 없으면 먼저 기존 기록을 읽으세요.

conditions를 생략하거나 {}로 두면 추가 조건이 없음을 의미하며, 수정 시 생략하면 기존 조건이 유지되는 것이 아니라 비워집니다. metric/tracing/rum 세 배열만 공개되며, lineage 하위 조건은 개방되지 않습니다(공유 내부 검증기가 이 이름을 인식하더라도). 추가 Body 필드는 거부됩니다. 배열 요소는 객체를 권장합니다. op는 반드시 in/not in이어야 하고, value는 반드시 배열이어야 하며, 동일 카테고리 내 logic은 일관되어야 하고 and/or를 권장합니다. 현재 logic 열거값/name 필수 여부/배열 요소 객체 형태를 엄격히 검증하지 않으므로, 기형 요소는 500이 발생할 수 있고 저장 성공으로 조건이 반드시 유효하다고 의존할 수 없습니다. 서로 다른 데이터 도메인의 조건은 서로 권한을 부여하지 않으며, 조건이 구성되지 않은 데이터 도메인을 금지한다는 의미도 아닙니다.

요청 헤더

파라미터명 유형 필수 설명
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입니다.
regionCode string 선택 사항이며, 생략/빈 문자열이면 현재 사이트를 사용합니다. 다른 사이트 Code는 406이며, 기존 설명에서 주장한 임의 크로스 사이트 생성이 아닙니다.
빈 문자열 허용: True
null 허용: False
예시: SITE-CODE
획득 또는 입력 방식: 현재 사이트를 사용하려면 생략을 권장하며, 명시적 값은 사이트 관리자가 현재 사이트와 완전히 동일한 Code를 제공해야 합니다.
type array Y 필수 배열이며, *는 전체를 의미하고 []는 전체가 아닙니다. 공개 선언은 null을 허용하지만 이후 비즈니스에서 500이 발생할 수 있으므로 반드시 배열을 제출하세요. 열거값을 항목별로 검증하지 않으므로 임의의 알 수 없는 값은 권장하지 않습니다.
null 허용: True
예시: ["metric", "logging"]
획득 또는 입력 방식: 실제로 권한을 부여할 도메인을 선택합니다. 예: metric/logging/tracing/rum/object/custom_object/lineage 등이며, 대상 쿼리 기능이 지원해야 합니다.
workspaceUUID commaArray Y 필수 단일 워크스페이스 UUID 문자열입니다. 레거시 유형명 commaArray는 문자열 검증만 수행하며, 이 진입점은 쉼표로 분할하여 일괄 생성하지 않습니다. 배열 또는 여러 ID를 제출하지 마세요.
null 허용: False
예시: wksp_target
획득 또는 입력 방식: 권한을 부여받는 측이 자신의 워크스페이스 정보/콘솔에서 실제 UUID를 제공해야 하며, 현재 권한 부여자 자신을 입력할 수 없습니다.

파라미터 추가 설명

동일 사이트 추가 및 조건 범위는 이 페이지를 참조하세요. 기존 크로스 사이트 입력 파라미터 설명은 더 이상 적용되지 않습니다.

요청 예시

curl --request POST 'https://openapi.guance.com/api/v1/wksp_share/add' \
  -H 'DF-API-KEY: <DF-API-KEY>' \
  -H 'Content-Type: application/json' \
  --data-raw '{"workspaceUUID":"wksp_target","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.name string 생성 시 부가된 대상 워크스페이스 이름입니다.
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": "",
    "createAt": 1785427200,
    "updateAt": -1,
    "deleteAt": -1,
    "name": "권한 부여 대상 예시 워크스페이스",
    "declaration": {}
  },
  "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 객체를 제출합니다.
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 소스 또는 대상 워크스페이스가 유효하지 않음/존재하지 않음/비활성, 대상 versionType=freeEdition, 대상이 비합법/소스와 동일한 등 검증 실패, 또는 regionCode가 현재 사이트가 아님 유효하지 않은 워크스페이스 uuid 현재 소스 기록과 실제 대상 워크스페이스 상태를 확인하고, 공개 Body가 지원하는 범위 필드를 사용하며 대상 워크스페이스/사이트를 대체하려 시도하지 않습니다.
406 ft.WKSPIllegalAuthorization 현재 권한 부여자 워크스페이스를 자기 자신에게 권한 부여하려 함 데이터 권한은 현재 워크스페이스 ID가 아닌 값을 입력해야 합니다. 다시 입력하세요 다른 권한 부여 대상 워크스페이스 UUID를 입력합니다.
406 ft.WKSPRepeatAuthorization 동일 소스/대상/사이트에 status=0 기록이 이미 존재(grantStatus를 추가로 검사하지 않음) 워크스페이스에 이미 권한이 부여되었습니다. 중복 권한 부여하지 마세요! 먼저 기존 구성을 읽고, 필요 시 수정하며 중복 생성하지 않습니다.
500 ft.InternalServerError type=null이 이후 코드에서 처리됨, 조건 요소 구조 이상, 저장 오류 또는 제출 후 캐시/사이트 자료 준비 실패 내부 오류 먼저 목록/상세를 다시 읽어 저장 여부를 확인하고, traceId를 보관한 후 재시도 여부를 결정합니다. 전체 작업이 롤백되었다고 간주하지 마세요.

문서 평가

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