플랫폼 인스턴스 역할(EnrollmentRoleAssignment) API (V2)
EnrollmentRoleAssignment는 사용자 또는 그룹, 역할과 플랫폼 인스턴스의 관계입니다. 해당 주체가 그 인스턴스에서 가진 권한을 나타냅니다.
조회 항목의 필수 필드는 principalType, principalId, roleId입니다. principalType은 USER 또는 GROUP입니다. 추가 및 제거 요청의 RoleAssignmentUpdate는 필수 roleId와 principalId를 받습니다.
API 선택
| API | 기능과 한도 | OAuth 권한 범위 |
|---|---|---|
| List Enrollment Role Assignments | 현재 할당받은 주체와 역할 ID 조회 | api:admin-read |
| Add Enrollment Role Assignments | 한 요청에 최대 100개 역할 할당 추가 | api:admin-write |
| Remove Enrollment Role Assignments | 한 요청에 최대 100개 역할 할당 제거 | api:admin-write |
세 API 모두 미리보기 기능입니다. preview=true가 필요하며 언제든 변경되거나 제거될 수 있습니다.
대상과 역할 ID
enrollmentRid는 플랫폼 인스턴스를 식별합니다. 조직에 역할을 부여하는 OrganizationRoleAssignment와 관리 대상이 다릅니다.
roleId에는 대상 인스턴스에 유효한 실제 역할 ID를 전달합니다. 현재 할당 조회는 사용 가능한 모든 역할의 정의 카탈로그가 아닙니다. 일반 리소스의 역할 이름이나 조직 역할 조회 결과를 인스턴스 역할 ID 대신 사용하지 않습니다.
지정한 역할 ID를 찾을 수 없으면 EnrollmentRoleNotFound가 발생합니다. 역할 제거는 할당 관계의 변경이며 사용자나 그룹 자체를 삭제하는 작업과 구분합니다.