권한 세트
URL 엔드포인트
https://api.adaptiveplanning.com/api/rest/security/<version>/<tenant>/users/permissionSets
버전: v1
카테고리
| 데이터 업데이트 |
설명
| Adaptive Planning 사용자에게 권한 세트를 지정합니다. |
호출에 필요한 권한
|
, 권한 세트
|
권한 세트 지정 API를 사용하면 사용자 권한 세트를 검색하고 지정할 수 있습니다.
지원되는 HTTPS 동사:
HTTP Verb | 단일 리소스 | 수금 리소스 | 설명 |
|---|---|---|---|
GET | 미지원 | 지원됨 | 모든 사용자 및 지정된 권한 세트를 검색합니다. |
POST | 지원됨 | 지원됨 | 사용자의 권한 세트를 추가하거나 기존 권한 세트를 업데이트합니다. |
GET
- 요청
- /users/permissionSets사용자에게 지정된 권한 세트의 모음을 검색합니다.모든 사용자 및 지정된 권한 세트를 검색합니다. instanceCode를 기준으로 필터링할 수 있습니다. instanceCode 쿼리 매개변수가 없으면 API가 기본 인스턴스에서 모든 사용자와 해당 권한 세트를 검색합니다. 이러한 쿼리 매개변수를 지정하지 않으면 페이지 번호 매기기에서 한도 또는 오프셋에 대한 기본값을 사용합니다.샘플 요청 URI:HTTPS://api.adaptiveinsights.com/api/rest/security/v1/default/users/쿼리 매개변수:이름설명필수instanceCode인스턴스 컨텍스트를 정의하는 인스턴스의 고유 ID입니다.아니요limit단일 응답의 최대 오브젝트 수입니다. 기본값은 500입니다. 최대값은 500입니다.아니요offset응답 컬렉션에 있는 첫 번째 사용자의 인덱스(0부터 시작)입니다. 기본값은 0입니다.오프셋을 한도 매개변수와 함께 사용하여 응답 컬렉션의 페이징을 제어합니다.아니요
- 샘플 응답
- Workday와 사용자 동기화된 인스턴스의 샘플 응답"links": { "next": "https://api.adaptiveinsights.com/api/rest/security/v1/default/users/permissionSets?offset=10&limit=5", "previous": "https://api.adaptiveinsights.com/api/rest/security/v1/default/users/permissionSets?offset=0&limit=5" },{ "total": 34, "users": [ { "userGuid": "111SampleUserGuid", "wid": "14400000000000000000000000000samplewid", "userName": "sampleuser1@company.com", "permissionSet": [ { "id": 1, "name": "samplePermissionSet1" } ] }, { "userGuid": "112SampleUserGuid", "wid": "24400000000000000000000000000samplewid", "userName": "sampleuser3@company.com", "permissionSet": [ { "id": 1, "name": "samplePermissionSet1" } ] }, { "userGuid": "113SampleUserGuid", "wid": "34400000000000000000000000000samplewid", "userName": "sampleuser3@company.com", "permissionSet": [ { "id": 2, "name": "samplePermissionSet2" } ] }, { "userGuid": "114SampleUserGuid", "wid": "44400000000000000000000000000samplewid", "userName": "sampleuser4@company.com", "permissionSet": [ { "id": 3, "name": "samplePermissionSet3" } ] }, { "userGuid": "115SampleUserGuid", "wid": "54400000000000000000000000000samplewid", "userName": "sampleuser5@company.com", "permissionSet": [ { "id": 4, "name": "samplePermissionSet4" } ] } ] }
POST:
- 요청:
- /users/permissionSets:사용자의 권한 세트를 지정하거나 업데이트합니다.사용자의 권한 세트를 추가하거나 기존 권한 세트를 업데이트합니다. instanceCode를 기준으로 필터링할 수 있습니다. instanceCode 쿼리 매개변수가 없으면 API가 기본 인스턴스의 모든 사용자에게 해당 권한 세트를 지정합니다. 요청 본문에서 필수 쿼리 필드인 <userIdentifier> 및PermissionSet를 지정합니다. 해당 권한 세트를 여러 사용자에게 지정하기 위한 일괄 요청을 제출하려면 각 권한 지정내역을 포함하는 배열을 지정합니다.쿼리 매개변수:이름설명필수instanceCode인스턴스 컨텍스트를 정의하는 인스턴스의 고유 ID입니다.아니요userIdentifier고유한 Adaptive Planning 사용자 ID를 결정하는 사용자 ID입니다. 가능한 값은 userName, wid, userGuid입니다.예샘플 요청:HTTPS://api.adaptiveinsights.com/api/rest/security/v1/default/users/permissionSets?userIdentifier=userName샘플 요청 본문샘플 POST 요청 본문[ { "userName": "sampleuser1@company.com", "permissionSet": [ { "name": "samplePermissionSet1" } ] }, { "userName": "sampleuser2@company.com", "permissionSet": [ { "name": "samplePermissionSet2" } ] }, { "userName": "sampleuser3@company.com", "permissionSet": [ { "name": "samplePermissionSet3" } ] } ]페이로드 매개변수이름설명필수wid사용자의 Workday ID입니다.아니요userName사용자의 사용자명(로그인명)입니다.아니요userGuid글로벌 고유 사용자 ID(생성 시 시스템 지정)아니요이름ID권한 세트의 이름입니다.권한 세트의 ID입니다.권한 세트의 이름 또는 ID는 필수입니다.예