보안 표지 구성원(MarkingMember) API (V2)

MarkingMember는 해당 보안 표지가 보호하는 리소스의 표지 접근 조건을 충족하는 사용자 또는 그룹입니다. 리소스에 적용된 다른 표지와 작업 권한은 별도로 충족해야 합니다.

조회 결과의 각 항목에는 필수 principalType과 principalId가 있습니다. 유형은 USER 또는 GROUP이며, ID는 해당 사용자나 그룹을 식별합니다.

구성원 조회

List Marking Members는 표지 구성원을 반환합니다. 구성원 목록은 표지 관리자만 볼 수 있으므로 GET 요청에도 api:admin-write OAuth 권한 범위가 필요합니다.

transitive의 기본값은 false입니다. 표지에 그룹 A가 속하고 A에 사용자 B가 속한다면 기본 조회에는 A만, transitive=true 조회에는 A와 B가 포함됩니다. 중첩된 그룹을 모든 단계에 걸쳐 해석합니다.

이 목록 API는 pageSize를 무시합니다. 응답에 nextPageToken이 있으면 다음 요청의 pageToken으로 전달합니다.

두 요청은 사용자 또는 그룹 ID의 목록을 받으며 주체 리소스 자체를 생성하거나 삭제하는 요청과 구분합니다. 두 작업의 OAuth 권한 범위는 api:admin-write입니다.

표지를 관리하거나 리소스에 적용하고 제거하는 권한은 보안 표지 역할로 관리합니다. 표지의 이름과 범주 등은 Marking API에서 조회합니다.