역할 검색
Id로 역할 가져오기 API를 이용하여 Control Room에서 특정 역할을 검색합니다.
요청
GET https://{{ControlRoomURL}}/v1/usermanagement/roles/<role ID>Header: X-Authorization <<authentication token>>요청 매개변수
| 매개변수 | 유형 | 필수 사항 | 설명 |
|---|---|---|---|
| 역할 ID | 정수 | 예 | 역할의 ID를 입력합니다. |
응답
200 OK{
"id": 264,
"createdBy": 10,
"createdOn": "2022-04-12T12:12:39Z",
"updatedBy": 10,
"updatedOn": "2022-04-12T12:12:39Z",
"tenantId": 1,
"version": 0,
"tenantUuid": "06e42523-b44a-49f4-82dc-b8d420896761",
"description": "",
"name": "Device admin",
"permissions": [
{
"id": 1345,
"createdBy": 0,
"createdOn": "2022-04-11T19:46:24Z",
"updatedBy": 1,
"updatedOn": "2022-04-11T19:46:24Z",
"tenantId": 1,
"version": 0,
"tenantUuid": "06e42523-b44a-49f4-82dc-b8d420896761",
"action": "managecredentials",
"resourceId": null,
"resourceType": "credentials"
},
{
"id": 1424,
"createdBy": 0,
"createdOn": "2022-04-11T19:46:24Z",
"updatedBy": 1,
"updatedOn": "2022-04-11T19:46:24Z",
"tenantId": 1,
"version": 0,
"tenantUuid": "06e42523-b44a-49f4-82dc-b8d420896761",
"action": "delete",
"resourceId": null,
"resourceType": "devices"
},
{
"id": 1425,
"createdBy": 0,
"createdOn": "2022-04-11T19:46:24Z",
"updatedBy": 1,
"updatedOn": "2022-04-11T19:46:24Z",
"tenantId": 1,
"version": 0,
"tenantUuid": "06e42523-b44a-49f4-82dc-b8d420896761",
"action": "edit",
"resourceId": null,
"resourceType": "devices"
},
{
"id": 1344,
"createdBy": 0,
"createdOn": "2022-04-11T19:46:24Z",
"updatedBy": 1,
"updatedOn": "2022-04-11T19:46:24Z",
"tenantId": 1,
"version": 0,
"tenantUuid": "06e42523-b44a-49f4-82dc-b8d420896761",
"action": "myschedule",
"resourceId": null,
"resourceType": "taskscheduling"
},
{
"id": 1426,
"createdBy": 0,
"createdOn": "2022-04-11T19:46:24Z",
"updatedBy": 1,
"updatedOn": "2022-04-11T19:46:24Z",
"tenantId": 1,
"version": 0,
"tenantUuid": "06e42523-b44a-49f4-82dc-b8d420896761",
"action": "view",
"resourceId": null,
"resourceType": "dashboard"
},
{
"id": 1414,
"createdBy": 0,
"createdOn": "2022-04-11T19:46:24Z",
"updatedBy": 1,
"updatedOn": "2022-04-11T19:46:24Z",
"tenantId": 1,
"version": 0,
"tenantUuid": "06e42523-b44a-49f4-82dc-b8d420896761",
"action": "attestcredentials",
"resourceId": null,
"resourceType": "devices"
},
{
"id": 1381,
"createdBy": 0,
"createdOn": "2022-04-11T19:46:24Z",
"updatedBy": 1,
"updatedOn": "2022-04-11T19:46:24Z",
"tenantId": 1,
"version": 0,
"tenantUuid": "06e42523-b44a-49f4-82dc-b8d420896761",
"action": "register",
"resourceId": null,
"resourceType": "devices"
},
{
"id": 1321,
"createdBy": 0,
"createdOn": "2022-04-11T19:46:24Z",
"updatedBy": 1,
"updatedOn": "2022-04-11T19:46:24Z",
"tenantId": 1,
"version": 0,
"tenantUuid": "06e42523-b44a-49f4-82dc-b8d420896761",
"action": "view",
"resourceId": null,
"resourceType": "devices"
},
{
"id": 1423,
"createdBy": 0,
"createdOn": "2022-04-11T19:46:24Z",
"updatedBy": 1,
"updatedOn": "2022-04-11T19:46:24Z",
"tenantId": 1,
"version": 0,
"tenantUuid": "06e42523-b44a-49f4-82dc-b8d420896761",
"action": "all",
"resourceId": null,
"resourceType": "devices"
}
],
"countPrincipals": 0,
"systemRole": false,
"principals": [
{
"id": 21,
"createdBy": 10,
"createdOn": "2022-04-12T12:12:19Z",
"updatedBy": 21,
"updatedOn": "2022-04-13T03:37:08Z",
"tenantId": 1,
"version": 19,
"tenantUuid": "06e42523-b44a-49f4-82dc-b8d420896761",
"username": "john_user",
"description": "User",
"deleted": false,
"disabled": false,
"email": "john.doe@aa.com",
"firstName": "John",
"lastName": "Doe",
"autoLoginEnabled": true,
"emailVerified": true,
"clientRegistered": false,
"passwordSet": true,
"questionsSet": true,
"activeDirectory": false,
"passwordChangedOn": "2022-04-12T12:13:35Z",
"deviceCredentialAttested": false,
"multipleLoginAllowed": true
}
]
}응답 매개변수
| 매개변수 | 유형 | 설명 |
|---|---|---|
| id | 정수 | 생성된 새 역할을 나타내는 고유 식별자입니다. |
| 이름 | 문자열 | 생성된 역할의 이름입니다. |
| 설명 | 문자열 | 생성된 역할에 대한 설명입니다. |
| 버전 | 정수 | 역할 인스턴스의 버전입니다. |
| createdBy | 정수 | 역할을 만든 사용자의 ID입니다. |
| createdOn | 문자열 | 역할의 생성 타임스탬프입니다. |
| updatedBy | 정수 | 역할에 대한 최신 업데이트를 수행한 사용자의 ID입니다. |
| updatedOn | 문자열 | 역할의 최신 업데이트 타임스탬프입니다. |
| 권한 | Array | 역할에 할당된 고유한 권한의 배열입니다. |
| principals | Array | 역할에 할당된 고유한 사용자의 배열입니다. |
주: Community Edition에서 Control Room APIs을 볼 수 있지만, API 기능은 제한됩니다. API의 전체 기능에 액세스하려면 라이선스가 인가된 Automation 360 에디션이 필요합니다.
REST API는 HTTP 응답 코드를 이용하여 각 요청에 응답합니다. 응답 코드는 API 응답 코드를 참고하십시오.