/auth/v1/roles/<role_ID>: PUT

사용자 또는 사용자 그룹에 역할을 지정합니다.

다음 표에서는 이 REST API 엔드포인트에 액세스할 수 있는 역할을 표시합니다.

표 1. 역할별 액세스
데이터 관리자	데이터 사용자	콜렉션 관리	관리자	정비 사용자
Χ	Χ	✓	✓	Χ

다음 역할을 사용자에게 지정할 수 있습니다.

관리자: 시스템에서 작성한 기본 사용자 역할입니다. 이 역할을 가진 사용자는 다른 사용자, 프로젝트, 도메인을 작성하고 역할을 지정할 수 있습니다. 이 역할을 가진 사용자는 메타데이터 레코드를 볼 수 없습니다.
데이터 관리자: 이 역할을 가진 사용자는 프로젝트에서 모든 메타데이터 레코드를 볼 수 있습니다.
데이터 사용자: 이 역할은 연구자 또는 데이터 과학자에게 이상적입니다. 이 역할을 가진 사용자는 자신이 속한 프로젝트와 연관된 레코드를 볼 수 있습니다.
서비스 사용자: 이 사용자 역할은 서비스 담당자를 위한 것입니다. 이 역할을 가진 사용자는 시스템 로그에 대한 읽기 전용 액세스 권한을 갖습니다.

요청 개요 URL

curl -k  -H ‘Authorization: Bearer <token>’ -X PUT https://<data_cataloging_host>/auth/v1/roles/<role_ID> -d ‘<details of where role is to be assigned>’

roles 엔드포인트에서 다음 세부사항을 지정하여 해당 컴포넌트에 역할을 지정할 수 있습니다. 이 목록 다음에 예제가 있습니다.

user_ID: 역할을 지정해야 하는 사용자 ID입니다.
group_id: 역할을 지정해야 하는 그룹입니다.
프로젝트 ID: 역할을 지정해야 하는 프로젝트입니다.
Domain_ID: 역할을 지정해야 하는 도메인입니다.

다음 예제는 이러한 필드를 지정하여 도메인 또는 콜렉션에 역할을 지정하는 방법을 설명합니다.

{
    "user_id": <string> [optional],
    "group_id": <string> [optional],
    "collection_id": <string> [optional], 
    "domain_id": <string> [optional]
}
example [assign role to user in default domain]
{
    "user_id": "5b3cd6af1c38479aa3a8cb220230c651"
}
example [assign role to user in specific domain]
{
    "user_id": "5b3cd6af1c38479aa3a8cb220230c651",
    "domain_id": "4bfa9a9f71154dbeb554261a1c8d9a53"
}
example [assign role to user in specific collection]
{
    "user_id": "5b3cd6af1c38479aa3a8cb220230c651",
    "collection_id": "3b8c501b173c4ebcb99f322a4f7cf60e"
}

지원되는 요청 유형 및 응답 형식

지원되는 요청 유형:

지원되는 응답 형식:

JSON

예

예 1: 특정 사용자에게 역할을 지정합니다.

요청:

curl -k  -H 'Content-Type: application/json' -H ‘Authorization: Bearer <token>’ -X PUT
https://<data_cataloging_host>/auth/v1/roles/4a5415cb9cc5460aafe12a6f6206448e
-d ‘{"user_id": "5b3cd6af1c38479aa3a8cb220230c651"}’

응답:

200 OK

예제 2: 그룹에 역할을 지정합니다.

요청:

curl -k  -H 'Content-Type: application/json' -H ‘Authorization: Bearer <token>’ -X PUT
https://<data_cataloging_host>/auth/v1/roles/4a5415cb9cc5460aafe12a6f6206448e 
-d ‘{"group_id":  "6c4de7af1c38479aa3a8cb220230d762"}’

응답:

200 OK

예 3: 콜렉션에서 사용자에 대한 역할 지정.

요청:

curl -k  -H 'Content-Type: application/json' -H ‘Authorization: Bearer <token>’ -X PUT
https://<data_cataloging_host>/auth/v1/roles/4a5415cb9cc5460aafe12a6f6206448e 
-d ‘{"user_id": "5b3cd6af1c38479aa3a8cb220230c651", “domain_id”: “af1c38479a5b3cd6c651a3a8cb220230”}’

응답:

200 OK