새 역할 API 생성
역할 생성 API를 이용하여 Control Room에서 권한을 가진 새 역할을 만듭니다.
전제 조건
새 역할을 만들려면 역할 보기 및 관리 권한이 있는 관리자 역할 또는 맞춤형 역할이 있어야 합니다.
각 권한에는 다음과 같은 필수 매개변수가 필요합니다.
- id: 권한을 고유하게 식별하는 숫자 값.
- action: 권한에 의해 활성화하는 작업.
- resourceType: 작업이 속한 리소스 그룹.
일반적으로 사용자에게는 사용자 관리 권한과 함께 역할 권한이 부여됩니다. 역할 및 권한
프로시저
- 인증 API를 이용하여 JSON 웹 토큰을 생성합니다. 인증 API를 참고하십시오.
-
POST 메소드 및 엔드포인트 URL 이용:
<your_control_room_url>/v1/usermanagement/roles
다음 요청은 사용자가 Control Room에서 역할 및 사용자를 생성하고 관리할 수 있는 새 역할을 만듭니다.
요청 본문:{ "name": "Role to manage users and roles", "description": "These are limited administrator permission.", "permissions": [ { "id": 1, "action": "usermanagement", "resourceType": "usermanagement" }, { "id": 3, "action": "createuser", "resourceType": "usermanagement" }, { "id": 4, "action": "updateuser", "resourceType": "usermanagement" }, { "id": 2, "action": "deleteuser", "resourceType": "usermanagement" }, { "id": 62, "action": "rolesview", "resourceType": "rolesmanagement" }, { "id": 12, "action": "rolesmanagement", "resourceType": "rolesmanagement" } ] }
-
요청 전송.
응답 본문:
{ "id": 767, "createdBy": 3215, "createdOn": "2020-03-19T22:44:21Z", "updatedBy": 3215, "updatedOn": "2020-03-19T22:44:21Z", "tenantId": 1, "version": 0, "tenantUuid": "e100fbce-008c-04ec-4063-7af0af91fb2f", "description": "These are limited administrator permission.", "name": "Role to manage users and roles", "accessRestriction": null, "permissions": [ { "id": 1, "createdBy": 0, "createdOn": "2019-05-21T03:09:31Z", "updatedBy": 0, "updatedOn": "2019-05-21T03:09:31Z", "tenantId": 1, "version": 0, "tenantUuid": "e100fbce-008c-04ec-4063-7af0af91fb2f", "action": "usermanagement", "resourceId": null, "resourceType": "usermanagement" }, { "id": 2, "createdBy": 0, "createdOn": "2019-05-21T03:09:31Z", "updatedBy": 0, "updatedOn": "2019-05-21T03:09:31Z", "tenantId": 1, "version": 0, "tenantUuid": "e100fbce-008c-04ec-4063-7af0af91fb2f", "action": "deleteuser", "resourceId": null, "resourceType": "usermanagement" }, { "id": 4, "createdBy": 0, "createdOn": "2019-05-21T03:09:31Z", "updatedBy": 0, "updatedOn": "2019-05-21T03:09:31Z", "tenantId": 1, "version": 0, "tenantUuid": "e100fbce-008c-04ec-4063-7af0af91fb2f", "action": "updateuser", "resourceId": null, "resourceType": "usermanagement" }, { "id": 12, "createdBy": 0, "createdOn": "2019-05-21T03:09:31Z", "updatedBy": 0, "updatedOn": "2019-05-21T03:09:31Z", "tenantId": 1, "version": 0, "tenantUuid": "e100fbce-008c-04ec-4063-7af0af91fb2f", "action": "rolesmanagement", "resourceId": null, "resourceType": "rolesmanagement" }, { "id": 62, "createdBy": 0, "createdOn": "2019-05-21T03:09:31Z", "updatedBy": 0, "updatedOn": "2019-05-21T03:09:31Z", "tenantId": 1, "version": 0, "tenantUuid": "e100fbce-008c-04ec-4063-7af0af91fb2f", "action": "rolesview", "resourceId": null, "resourceType": "rolesmanagement" }, { "id": 3, "createdBy": 0, "createdOn": "2019-05-21T03:09:31Z", "updatedBy": 0, "updatedOn": "2019-05-21T03:09:31Z", "tenantId": 1, "version": 0, "tenantUuid": "e100fbce-008c-04ec-4063-7af0af91fb2f", "action": "createuser", "resourceId": null, "resourceType": "usermanagement" } ], "countPrincipals": 0, "principals": [] }
REST API는 HTTP 응답 코드를 이용하여 각 요청에 응답합니다. 응답 코드에 대한 자세한 내용은 API 응답 코드를 참고하십시오.