POST/groups/{groupId}/folder/files/{fileId}/permissions

조직/그룹 폴더의 폴더 접근 권한을 생성한다.

Authorization

oauth2

OAuth 2.0 인증.
자세한 인증 방식은 인가·인증을 참고한다.

Scope

file
group.folder

HTTP Request

POSThttps://www.worksapis.com/v1.0/groups/{groupId}/folder/files/{fileId}/permissions

Path Parameters

ParameterTypeDescription
groupId string 

조직/그룹 ID


required
example : group127-8545-4463-603b-04d550d23bf 
fileId string 

파일 ID


required
example : NzExNTMwMDF8MTQ2NzA1NjAxMDAwMHxGfDA 

Header Parameters

HeadertypeDescription
Authorization string 

Bearer {token}


required 
Content-Type string 

application/json


required
example : application/json 

Request Body

PropertyTypeDescription
userId string 

사용자 ID

  • 메일
  • 리소스 ID
  • 외부 키 "externalKey:{externalKey}" 형태

required
minLength : 1 
type string 

편집 권한

  • READ: 읽기 권한
  • WRITE: 쓰기 권한

required
Allowed values : READ, WRITE 

Request Example

example

1{2  "userId": "user1@example.com",3  "type": "WRITE"4}

Response

HTTP 201

OK

PropertyTypeDescription
permissions array (FolderPermission) 

권한 정보

 

FolderPermission

PropertyTypeDescription
permissionId string 

권한 ID


required
minLength : 1
readOnly : true 
type string 

편집 권한

  • READ: 읽기 권한
  • WRITE: 쓰기 권한

required
Allowed values : READ, WRITE 
userId string 

사용자 ID


required
minLength : 1
readOnly : true 
userType string 

사용자 유형

  • USER: 사용자
  • ORGUNIT: 조직
  • GROUP: 그룹

required
Allowed values : USER, ORGUNIT, GROUP 
userName string 

사용자 이름


required
minLength : 1
readOnly : true 

Response Example

example

1{2  "permissions": [3    {4      "permissionId": "QDIxMDAwMDAwMDAwMTcwfEdST1VQfDEwMTAwMDAwMDExNDY1MA",5      "type": "WRITE",6      "userId": "group127-8545-4463-603b-04d550d23bf",7      "userType": "GROUP",8      "userName": "test name"9    }10  ]11}