콘텐츠로 이동

수정



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를 보관한 후 재시도 여부를 결정하세요. 전체 작업이 롤백되었다고 간주하지 마세요.
```

문서 평가

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