목록 조회¶
GET /api/v1/wksp_share/list
개요¶
현재 워크스페이스에서 발급하거나 받은 데이터 액세스 권한 부여 구성을 페이지 단위로 나열합니다.
호출 전 및 사용 단계¶
생성/수정/삭제는 데이터 권한 부여자 워크스페이스의 API Key를 사용합니다. 읽기는 현재 Key 워크스페이스의 권한 부여 방향에 따라 작업합니다. 이 그룹에서 부여하는 것은 워크스페이스 간 데이터 쿼리 기능이며, 멤버 초대, 계정 역할 부여 또는 데이터 복사가 아닙니다. 응답의 workspaceUUID는 권한 부여자, toWorkspaceUUID는 권한 부여 대상자입니다. 새로 추가할 때의 Body.workspaceUUID만 권한 부여 대상인 대상 워크스페이스를 나타내며, 응답의 동명 필드와 방향이 다릅니다. 쿼리 적용 가능 여부는 데이터 도메인, 로그 인덱스, 필터 조건, 실제 권한 부여 상태 및 소스 워크스페이스 상태의 제한도 받습니다.
이 읽기에는 routine.defaultAccess가 필요합니다. 기본적으로 id 내림차순으로 페이지를 나누며, type은 권한 부여 방향을 제어합니다. 구성이 status=0에 해당한다고 해서 권한 부여가 유효한 것은 아니며, pending/expired/동기화 상태 및 소스 워크스페이스 잠금도 확인해야 합니다. 이 API는 저장된 구성만 표시하며 사이트 간 동기화를 트리거하거나 권한 부여를 활성화하지 않으므로, 반환된 건수만으로 조회 가능 범위를 판단해서는 안 됩니다.
읽을 때 authorizationCode를 삭제하고 extra 내 tempAuthCode/tempAuthCodeHash를 재귀적으로 제거하며, 구성 인증 코드를 비즈니스 파라미터로 제공하지 않습니다. sourceWorkspaceAccess는 로컬 소스 워크스페이스를 조회할 수 있을 때만 잠금 정보를 제공합니다. sourceWorkspaceAccess는 항상 객체입니다. 사이트 간 또는 식별할 수 없는 소스인 경우 isLocked/lockMode가 null일 수 있으며, 이를 잠금 해제 상태로 이해해서는 안 됩니다.
신원 요약 및 extra의 사이트 간 필드는 신원 유형/레코드 유형에 따라 생략될 수 있으므로, 필드 표를 모든 레코드에 모든 확장 필드가 있다고 이해해서는 안 됩니다. 읽기는 정리된 임시 인증 코드나 요약을 다시 추가하지 않습니다.
요청 헤더¶
| 파라미터 이름 | 유형 | 필수 | 설명 |
|---|---|---|---|
| DF-API-KEY | string | Y | 워크스페이스의 OpenAPI 인증 자격 증명입니다. 예시: <DF-API-KEY>획득 또는 입력 방법: 대상 워크스페이스의 API Key 관리에서 해당 작업 권한이 있는 OpenAPI Key를 가져옵니다. |
Query 요청 파라미터¶
| 파라미터 이름 | 유형 | 필수 | 설명 |
|---|---|---|---|
| filterWsUUIDs | commaArray | 선택적 쉼표 문자열이며 방향에 따라 상대 워크스페이스를 필터링합니다. 분할 후 각 항목의 공백을 제거하지 않습니다. null 허용: False 예시: wksp_target획득 또는 입력 방법: grant 방향에는 대상 워크스페이스 ID를, granted 방향에는 소스 워크스페이스 ID를 입력합니다. |
|
| namespace | commaArray | 선택적 쉼표 문자열입니다. 여러 도메인은 AND로 조합하여 필터링하며, 각 도메인은 type과 일치하거나 *를 포함해야 합니다. 현재는 레거시 LIKE 매칭이며 완전한 기능 검증은 아닙니다. null 허용: False 예시: logging,metric획득 또는 입력 방법: 확인할 데이터 도메인 이름을 선택하고, 여러 개는 영문 쉼표로 연결합니다. |
|
| pageIndex | integer | 선택적 양의 정수, 기본값 1. null 허용: False $minValue: 1 예시: 1획득 또는 입력 방법: 1페이지부터 시작하고 pageInfo를 참고하여 이후 페이지를 읽습니다. |
|
| pageSize | integer | 선택 사항이며 1~100, 기본값 20. null 허용: False $maxValue: 100 $minValue: 1 예시: 20획득 또는 입력 방법: 일괄 조회 요구에 따라 1~100을 선택합니다. |
|
| regionCode | string | 선택적 소스 사이트 필터이며 레거시 Code 형식과 호환됩니다. toRegionCode와 의미가 다릅니다. null 허용: False 예시: SITE-CODE획득 또는 입력 방법: 기존 레코드의 regionCode에서 소스 사이트 값을 가져옵니다. 로컬 레코드는 입력하지 않아도 됩니다. |
|
| search | string | 선택 사항입니다. grant는 대상을, granted는 소스를 검색합니다. 공백을 제거하지 않으며 LIKE 와일드카드가 적용될 수 있습니다. null 허용: False 예시: 示例획득 또는 입력 방법: 상대 워크스페이스 이름 또는 UUID로 검색합니다. |
|
| toRegionCode | string | 선택적 권한 부여 대상 사이트 필터. null 허용: False 예시: SITE-CODE획득 또는 입력 방법: 기존 레코드의 toRegionCode에서 대상 사이트 값을 가져옵니다. |
|
| type | string | 선택 사항, 기본값 grant. 열거형이 설정되어 있지 않으며 grant가 아닌 모든 값은 권한 부여 대상 분기로 들어가므로 grant/granted만 사용할 것을 권장합니다. null 허용: False 예시: grant획득 또는 입력 방법: 현재 워크스페이스가 발급한 권한 부여를 조회하려면 grant를, 현재 워크스페이스가 받은 권한 부여를 조회하려면 granted를 사용합니다. |
파라미터 추가 설명¶
권한 부여 방향, 페이지 컨테이너 및 권한 부여 상태는 이 페이지를 기준으로 합니다.
요청 예시¶
curl --get 'https://openapi.guance.com/api/v1/wksp_share/list' \
-H 'DF-API-KEY: <DF-API-KEY>' \
--data-urlencode type=grant \
--data-urlencode pageIndex=1 \
--data-urlencode pageSize=20
응답¶
HTTP 200, application/json. 아래 예시는 직접 읽을 수 있는 주요 필드를 보여줍니다.
| 필드 | 유형 | 설명 |
|---|---|---|
| content | object | 페이지 컨테이너이며 데이터는 content.data에 있습니다. |
| content.data | array | 현재 페이지의 권한 부여 구성 목록입니다. |
| content.data[].id | integer | 내부 행 번호이며 API 리소스 식별자로 사용되지 않습니다. |
| content.data[].uuid | string | 권한 부여 구성 UUID입니다. 일반적으로 grant_ 접두사가 붙으며 상세/수정/삭제 시 이 값을 사용합니다. |
| content.data[].workspaceUUID | string | 데이터 권한 부여자 워크스페이스이며 반드시 현재 쿼리 Key의 워크스페이스는 아닙니다(권한 부여 대상 목록일 때는 다른 소스 워크스페이스). |
| content.data[].workspaceName | string | 권한 부여자 워크스페이스 이름. |
| content.data[].toWorkspaceUUID | string | 데이터 쿼리 권한을 부여받은 대상 워크스페이스. |
| content.data[].toWorkspaceName | string | 권한 부여 대상 워크스페이스 이름. |
| content.data[].regionCode | string | 권한 부여자 사이트 식별자. |
| content.data[].toRegionCode | string | 대상 사이트 식별자입니다. 읽을 때 이전 빈 값은 호환 규칙에 따라 보완됩니다. |
| content.data[].siteRelationType | string | same_site/same_org_cross_site/external_org_cross_site 등의 사이트 관계이며 레거시 레코드에서는 비어 있을 수 있습니다. |
| content.data[].sourceBaseUrl | string | 일부 사이트 간 레코드의 소스 주소입니다. 일반적인 동일 사이트에서는 비어 있을 수 있으며 이번 API Endpoint가 아닙니다. |
| content.data[].targetBaseUrl | string | 일부 사이트 간 레코드의 대상 주소입니다. 일반적인 동일 사이트에서는 비어 있을 수 있습니다. |
| content.data[].type | array/string 또는 null | 저장된 권한 부여 데이터 도메인입니다. *는 전체를 의미합니다. 레거시 데이터는 규격화되지 않았을 수 있으므로 상태 0만으로 유효하다고 판단해서는 안 됩니다. |
| content.data[].type[] | JSON | 일반적으로 데이터 도메인 문자열입니다. 현재 레거시 진입점은 요소 열거형을 완전히 검사하지 않습니다. |
| content.data[].indexes | array 또는 null | 권한이 부여된 로그 인덱스 이름 집합이며 인덱스 UUID가 아닙니다. *는 전체를 의미하며, 로그 도메인이 부여되지 않은 경우 []로 저장됩니다. |
| content.data[].indexes[] | string | 인덱스 이름 한 항목(예: default). |
| content.data[].conditions | object 또는 null | metric/tracing/rum별로 저장된 필터 구성입니다. 데이터 권한 자체나 쿼리 결과가 아닙니다. |
| content.data[].extra | object 또는 null | 레코드 역할, 권한 부여 상태 및 사이트 간 확장 정보를 기록합니다. 읽기와 쓰기 응답의 정리 규칙이 다르므로 인증 진단이 포함된 원본 쓰기 응답을 외부에 공유해서는 안 됩니다. |
| content.data[].extra.recordRole | string | authority/mirror 등이며 일부 레코드에만 있습니다. |
| content.data[].extra.grantStatus | string | 레코드에 저장된 상태입니다. 읽을 때 pending을 시간에 따라 expired로 표시할 수 있습니다. |
| content.data[].delayDeleteAt | integer | 예정된 삭제 시간입니다. -1은 일반적으로 예정되지 않음을 의미하며 레코드가 반드시 유효함을 나타내지는 않습니다. |
| content.data[].status | integer | 모델 상태입니다. 0은 미삭제, 삭제는 일반적으로 3입니다. 비즈니스 권한 부여는 grantStatus 등을 추가로 확인해야 합니다. |
| content.data[].creator | string | 생성자 식별자이며 API Key UUID 또는 레거시 계정/시스템 신원일 수 있습니다. |
| content.data[].updator | string | 최근 작업자이며 비어 있을 수 있습니다. |
| content.data[].createAt | integer | 생성 Unix 초. |
| content.data[].updateAt | integer | 업데이트 Unix 초이며 초기에는 -1일 수 있습니다. |
| content.data[].deleteAt | integer | 소프트 삭제 Unix 초이며 삭제되지 않은 경우 일반적으로 -1입니다. |
| content.data[].conditions.metric | array | metric 범주의 조건 배열입니다. |
| content.data[].conditions.metric[] | object | 조건 한 세트입니다. 현재 요소에는 완전한 사전 구조 검증이 없습니다. |
| content.data[].conditions.metric[].name | string | 실제 필드 이름. |
| content.data[].conditions.metric[].op | string | in 또는 not in. |
| content.data[].conditions.metric[].logic | string | and/or을 권장하며 동일 범주에서는 일관되어야 합니다. 현재 열거형을 엄격하게 검증하지 않습니다. |
| content.data[].conditions.metric[].value | array | 조건 값 배열이며 요소는 실제 필드 유형을 따릅니다. |
| content.data[].conditions.tracing | array | tracing 범주의 조건 배열입니다. |
| content.data[].conditions.tracing[] | object | 조건 한 세트입니다. 현재 요소에는 완전한 사전 구조 검증이 없습니다. |
| content.data[].conditions.tracing[].name | string | 실제 필드 이름. |
| content.data[].conditions.tracing[].op | string | in 또는 not in. |
| content.data[].conditions.tracing[].logic | string | and/or을 권장하며 동일 범주에서는 일관되어야 합니다. 현재 열거형을 엄격하게 검증하지 않습니다. |
| content.data[].conditions.tracing[].value | array | 조건 값 배열이며 요소는 실제 필드 유형을 따릅니다. |
| content.data[].conditions.rum | array | rum 범주의 조건 배열입니다. |
| content.data[].conditions.rum[] | object | 조건 한 세트입니다. 현재 요소에는 완전한 사전 구조 검증이 없습니다. |
| content.data[].conditions.rum[].name | string | 실제 필드 이름. |
| content.data[].conditions.rum[].op | string | in 또는 not in. |
| content.data[].conditions.rum[].logic | string | and/or을 권장하며 동일 범주에서는 일관되어야 합니다. 현재 열거형을 엄격하게 검증하지 않습니다. |
| content.data[].conditions.rum[].value | array | 조건 값 배열이며 요소는 실제 필드 유형을 따릅니다. |
| content.data[].grantMode | string | same_site 또는 cross_site이며 읽을 때 사이트 관계에 따라 파생됩니다. |
| content.data[].grantStatus | string | active/pending/revoked/expired 등의 관측 가능한 권한 부여 상태입니다. pending 만료는 여기에서만 표시가 정규화될 뿐 백엔드에서 이미 삭제되었음을 의미하지 않습니다. |
| content.data[].syncStatus | string | 사이트 간 동기화 추가 상태이며 비어 있을 수 있습니다. |
| content.data[].lastSyncAt | integer 또는 null | 사이트 간 마지막 동기화 Unix 초이며 기본값은 null입니다. 규격에 맞지 않는 레거시 값은 실제 응답으로 확인해야 합니다. |
| content.data[].regionName | string | 요청 언어와 사이트 메타데이터에 따라 생성된 소스 사이트 이름입니다. |
| content.data[].toRegionName | string | 요청 언어와 사이트 메타데이터에 따라 생성된 대상 사이트 이름입니다. |
| content.data[].creatorInfo | object | 생성자 신원 요약이며 Key/레거시 계정/시스템 신원일 수 있습니다. |
| content.data[].creatorInfo.uuid | string | 신원 식별자이며 개인 계정 UUID임을 보장하지 않습니다. |
| content.data[].creatorInfo.name | string | 표시 이름. |
| content.data[].creatorInfo.email | string | 신원 다형 필드입니다. Key인 경우 Key UUID일 수 있으므로 일률적으로 이메일로 처리해서는 안 됩니다. |
| content.data[].updatorInfo | object | 최근 작업자 신원 요약이며 {}일 수 있습니다. |
| content.data[].updatorInfo.uuid | string | 존재하는 경우 작업자 식별자. |
| content.data[].updatorInfo.name | string | 존재하는 경우 작업자 표시 이름. |
| content.data[].updatorInfo.email | string | 신원 다형 필드이며 실제 이메일이 아닐 수 있습니다. |
| content.data[].sourceWorkspaceAccess | object | 목록에서만 추가되는 소스 워크스페이스 잠금 요약입니다. |
| content.data[].sourceWorkspaceAccess.isLocked | integer 또는 null | 로컬 소스를 식별할 수 있으면 0/1이고, 원격이거나 식별할 수 없으면 null일 수 있습니다. |
| content.data[].sourceWorkspaceAccess.lockMode | string 또는 null | 소스 잠금 모드이며 식별되지 않으면 null일 수 있습니다. |
| content.declaration | object 또는 null | 외부 공통 선언이며 data[]에 재귀적으로 보완하지 않습니다. |
| pageInfo | object | 최상위 페이지 정보. |
| pageInfo.count | integer | 현재 페이지 건수. |
| pageInfo.pageIndex | integer | 현재 페이지 번호. |
| pageInfo.pageSize | integer | 페이지당 건수. |
| pageInfo.totalCount | integer | 일치하는 레코드 총수이며 유효한 권한 부여 데이터량이 아닙니다. |
| content.data[].extra.tempAuthCodeExpireAt | integer | 임시 권한 부여 패키지 유효 기간의 Unix 초이며 생략될 수 있습니다. 바로 사용할 수 있는 인증 코드가 아닙니다. |
| content.data[].extra.pendingTargetWorkspaceUUID | string | pending 레코드의 예상 대상 워크스페이스이며 생략될 수 있습니다. |
| content.data[].extra.metaUUID | string | 권한 부여 패키지 식별자이며 생략될 수 있고 grant 구성 UUID가 아닙니다. |
| content.data[].extra.grantScopeFingerprint | string | 권한 부여 범위 요약이며 생략될 수 있고 고객 인증 파라미터로 사용되지 않습니다. |
| content.data[].extra.createdAt | integer | 확장 레코드 생성 Unix 초이며 생략될 수 있습니다. |
| content.data[].extra.authorityGrantUUID | string | mirror 레코드와 연결된 소스 권한 부여 구성 UUID이며 생략될 수 있고 현재 Key 워크스페이스가 소유한 구성으로 바로 간주할 수 없습니다. |
| content.data[].extra.sourceKid | string | 소스 사이트 공개 키 식별자이며 생략될 수 있습니다. |
| content.data[].extra.sourceJwksUri | string | 소스 사이트 공개 키 집합 주소이며 생략될 수 있습니다. |
| content.data[].extra.syncStatus | string | 사이트 간 동기화 상태(예: success/failed 또는 빈 값)이며 생략될 수 있습니다. |
| content.data[].extra.lastSyncAt | integer | 마지막 동기화 Unix 초이며 생략될 수 있습니다. |
| content.data[].extra.lastSyncError | string | 어댑팅된 최근 동기화 오류 요약이며 생략될 수 있고 이번 API의 외부 오류 코드가 아닙니다. |
| content.data[].extra.lastSyncErrorAt | integer | 최근 동기화 실패 Unix 초이며 생략될 수 있습니다. |
| content.data[].extra.resourceSummary | object | 일부 사이트 간 레코드에 동기화 저장된 리소스 요약이며 생략될 수 있습니다. 실시간 전체 리소스 목록이 아닙니다. |
| content.data[].extra.resourceSummary.logging | object | 로그 리소스 요약이며 생략될 수 있습니다. |
| content.data[].extra.resourceSummary.logging.indexes | array | 업스트림에서 동기화된 로그 인덱스 요약 항목입니다. 요소는 문자열 또는 객체일 수 있으며 원본 그대로 저장됩니다. |
| content.data[].extra.resourceSummary.logging.indexes[] | JSON | 인덱스 요약 한 항목입니다. 고정된 uuid/name 형태를 가정해서는 안 되며 인덱스 작업 전에 인덱스 목록에서 실제 파라미터를 가져와야 합니다. |
| content.data[].extra.resourceSummary.rum | object | RUM 리소스 요약이며 생략될 수 있습니다. |
| content.data[].extra.resourceSummary.rum.applications | array | 업스트림 RUM 애플리케이션 요약 항목이며 문자열 또는 객체가 실제 반환값에 따라 제공됩니다. |
| content.data[].extra.resourceSummary.rum.applications[] | JSON | 애플리케이션 요약이며 현재 사이트 애플리케이션 구성 UUID를 대체하지 않습니다. |
| content.data[].extra.resourceSummary.updatedAt | number | 리소스 요약 생성 값이며 단위는 업스트림이 결정하고 Studio는 단위 변환이나 통일을 보장하지 않습니다. |
| content.data[].extra.resourceSummary.sourceGrantUUID | string | 리소스 요약과 연결된 소스 권한 부여 구성 식별자. |
| content.data[].extra.sourceSite | object | 권한 부여자/대상 사이트 신원 스냅샷이며 생략될 수 있고 현재 요청 Endpoint를 대체하지 않습니다. |
| content.data[].extra.sourceSite.siteCode | string | 사이트 코드. 생략될 수 있습니다. |
| content.data[].extra.sourceSite.regionCode | string | 리전 코드. 생략될 수 있습니다. |
| content.data[].extra.sourceSite.name | string | 사이트 표시 이름. 생략될 수 있습니다. |
| content.data[].extra.sourceSite.issuer | string | 서명 신원. 생략될 수 있습니다. |
| content.data[].extra.sourceSite.baseUrl | string | 사이트 API 기본 주소. 생략될 수 있습니다. |
| content.data[].extra.sourceSite.jwksUri | string | 공개 키 집합 주소. 생략될 수 있습니다. |
| content.data[].extra.sourceSite.kid | string | 공개 키 식별자. 생략될 수 있습니다. |
| content.data[].extra.sourceSite.publicKeys | array | 일부 사이트 스냅샷에는 공개 키 자료가 포함되며 생략될 수 있습니다. 개인 키는 없습니다. |
| content.data[].extra.sourceSite.publicKeys[] | object | 선택적 공개 키 항목. |
| content.data[].extra.sourceSite.publicKeys[].kid | string | 공개 키 식별자. |
| content.data[].extra.sourceSite.publicKeys[].publicKey | string | PEM 공개 키 본문. |
| content.data[].extra.targetSite | object | 권한 부여자/대상 사이트 신원 스냅샷이며 생략될 수 있고 현재 요청 Endpoint를 대체하지 않습니다. |
| content.data[].extra.targetSite.siteCode | string | 사이트 코드. 생략될 수 있습니다. |
| content.data[].extra.targetSite.regionCode | string | 리전 코드. 생략될 수 있습니다. |
| content.data[].extra.targetSite.name | string | 사이트 표시 이름. 생략될 수 있습니다. |
| content.data[].extra.targetSite.issuer | string | 서명 신원. 생략될 수 있습니다. |
| content.data[].extra.targetSite.baseUrl | string | 사이트 API 기본 주소. 생략될 수 있습니다. |
| content.data[].extra.targetSite.jwksUri | string | 공개 키 집합 주소. 생략될 수 있습니다. |
| content.data[].extra.targetSite.kid | string | 공개 키 식별자. 생략될 수 있습니다. |
| content.data[].extra.targetSite.publicKeys | array | 일부 사이트 스냅샷에는 공개 키 자료가 포함되며 생략될 수 있습니다. 개인 키는 없습니다. |
| content.data[].extra.targetSite.publicKeys[] | object | 선택적 공개 키 항목. |
| content.data[].extra.targetSite.publicKeys[].kid | string | 공개 키 식별자. |
| content.data[].extra.targetSite.publicKeys[].publicKey | string | PEM 공개 키 본문. |
| content.data[].extra.resourceSummary.metric | object | 해당 도메인의 리소스 요약이며 생략될 수 있습니다. |
| content.data[].extra.resourceSummary.metric.workspaceUUIDs | array | 동기화 저장된 소스 워크스페이스 식별자 집합이며 요소는 일반적으로 문자열입니다. 현재 Key가 임의로 작업할 수 있는 워크스페이스 권한이 아닙니다. |
| content.data[].extra.resourceSummary.metric.workspaceUUIDs[] | JSON | 단일 워크스페이스 식별자는 업스트림 실제 반환값을 따르며, 규격이 불완전한 레거시 항목은 먼저 확인해야 합니다. |
| content.data[].extra.resourceSummary.tracing | object | 해당 도메인의 리소스 요약이며 생략될 수 있습니다. |
| content.data[].extra.resourceSummary.tracing.workspaceUUIDs | array | 동기화 저장된 소스 워크스페이스 식별자 집합이며 요소는 일반적으로 문자열입니다. 현재 Key가 임의로 작업할 수 있는 워크스페이스 권한이 아닙니다. |
| content.data[].extra.resourceSummary.tracing.workspaceUUIDs[] | JSON | 단일 워크스페이스 식별자는 업스트림 실제 반환값을 따르며, 규격이 불완전한 레거시 항목은 먼저 확인해야 합니다. |
| content.data[].extra.resourceSummary.lineage | object | 해당 도메인의 리소스 요약이며 생략될 수 있습니다. |
| content.data[].extra.resourceSummary.lineage.workspaceUUIDs | array | 동기화 저장된 소스 워크스페이스 식별자 집합이며 요소는 일반적으로 문자열입니다. 현재 Key가 임의로 작업할 수 있는 워크스페이스 권한이 아닙니다. |
| content.data[].extra.resourceSummary.lineage.workspaceUUIDs[] | JSON | 단일 워크스페이스 식별자는 업스트림 실제 반환값을 따르며, 규격이 불완전한 레거시 항목은 먼저 확인해야 합니다. |
| content.data[].creatorInfo.status | integer | 신원 자체의 상태이며 계정/Key 실제 유형에 따라 해석합니다. |
| content.data[].creatorInfo.wsAccountStatus | integer 또는 null | 워크스페이스 멤버/신원 연결 상태이며 생략될 수 있습니다. |
| content.data[].creatorInfo.username | string | 신원 로그인 이름 또는 Key 이름이며 시스템 신원에서는 생략될 수 있습니다. |
| content.data[].creatorInfo.iconUrl | string | 신원 아이콘 URL이며 비어 있을 수 있습니다. |
| content.data[].creatorInfo.mobile | string | 신원 휴대전화 번호이며 비어 있을 수 있고 Key에는 일반적으로 이 값이 없습니다. |
| content.data[].creatorInfo.countryCode | string | 휴대전화 번호 국가/지역 코드이며 비어 있을 수 있습니다. |
| content.data[].creatorInfo.acntWsNickname | string | 현재 워크스페이스에서의 신원 닉네임이며 생략될 수 있습니다. |
| content.data[].updatorInfo.status | integer | 신원 자체의 상태이며 계정/Key 실제 유형에 따라 해석합니다. |
| content.data[].updatorInfo.wsAccountStatus | integer 또는 null | 워크스페이스 멤버/신원 연결 상태이며 생략될 수 있습니다. |
| content.data[].updatorInfo.username | string | 신원 로그인 이름 또는 Key 이름이며 시스템 신원에서는 생략될 수 있습니다. |
| content.data[].updatorInfo.iconUrl | string | 신원 아이콘 URL이며 비어 있을 수 있습니다. |
| content.data[].updatorInfo.mobile | string | 신원 휴대전화 번호이며 비어 있을 수 있고 Key에는 일반적으로 이 값이 없습니다. |
| content.data[].updatorInfo.countryCode | string | 휴대전화 번호 국가/지역 코드이며 비어 있을 수 있습니다. |
| content.data[].updatorInfo.acntWsNickname | string | 현재 워크스페이스에서의 신원 닉네임이며 생략될 수 있습니다. |
{
"code": 200,
"content": {
"data": [
{
"id": 10,
"uuid": "grant_example",
"workspaceUUID": "wksp_source",
"toWorkspaceUUID": "wksp_target",
"regionCode": "SITE-CODE",
"toRegionCode": "SITE-CODE",
"workspaceName": "授权方示例空间",
"toWorkspaceName": "被授权方示例空间",
"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,
"grantMode": "same_site",
"grantStatus": "active",
"syncStatus": "",
"lastSyncAt": null,
"regionName": "示例站点",
"toRegionName": "示例站点",
"creatorInfo": {
"uuid": "wsak_example",
"name": "示例API Key",
"email": "wsak_example"
},
"updatorInfo": {},
"sourceWorkspaceAccess": {
"isLocked": 0,
"lockMode": "none"
}
}
],
"declaration": {}
},
"errorCode": "",
"message": "",
"success": true,
"traceId": "TRACE-EXAMPLE",
"pageInfo": {
"count": 1,
"pageIndex": 1,
"pageSize": 20,
"totalCount": 1
}
}
오류 응답¶
인증, 속도 제한 및 공통 요청 오류는 공통 오류 정의를 참고하십시오.
목록은 현재 조회 방향의 구성만 나타냅니다. 비즈니스 조회 가능 여부는 대상 데이터 API를 통해 검증해야 하며, 레코드가 나열된다고 해서 완전한 권한이 있음을 보장하지 않습니다.
| HTTP 상태 | errorCode | 트리거 조건 | 메시지 또는 응답 설명 | 처리 방식 |
|---|---|---|---|---|
| 406 | ft.ParameterValidationFailed | 선언되지 않은 Query 파라미터를 사용했거나 파라미터가 규칙을 위반함 | 파라미터 파싱 실패 | Query 파라미터 표 및 예시를 확인하십시오. |
| 500 | ft.InternalServerError | 저장소/레거시 권한 부여 필드/사이트 포맷팅 또는 신원 정보 이상 | 내부 오류 | 필터를 좁히고 traceId를 보관한 뒤 관리자에게 연락하여 레거시 구성 및 사이트 데이터를 확인하십시오. |