워크스페이스 리소스 공유

POST

/v1/workspace/resources/:resource_id/share

워크스페이스 리소스에 대한 역할(‘admin’, ‘editor’, ‘commenter’, ‘viewer’ 중 하나)을 사용자, 그룹 또는 워크스페이스(서비스 계정) API 키에 부여합니다. 이 작업은 대상이 해당 리소스에 이미 보유한 역할을 덮어씁니다. 사용자 또는 서비스 계정을 대상으로 하려면 사용자 이메일만 전달하세요. 사용자는 워크스페이스에 속해 있어야 합니다. 그룹을 대상으로 하려면 그룹 id만 전달하세요. 워크스페이스(서비스 계정) API 키를 대상으로 하려면 api key id를 전달하세요. 리소스는 해당 키와 연결된 서비스 계정과 공유됩니다. 리소스를 공유하려면 리소스에 대한 admin 액세스 권한이 있어야 합니다.

워크스페이스 리소스에 대한 역할('admin', 'editor', 'commenter', 'viewer' 중 하나)을 사용자, 그룹 또는 워크스페이스(서비스 계정) API 키에 부여합니다. 이 작업은 대상이 해당 리소스에 이미 보유한 역할을 덮어씁니다. 사용자 또는 서비스 계정을 대상으로 하려면 사용자 이메일만 전달하세요. 사용자는 워크스페이스에 속해 있어야 합니다. 그룹을 대상으로 하려면 그룹 id만 전달하세요. 워크스페이스(서비스 계정) API 키를 대상으로 하려면 api key id를 전달하세요. 리소스는 해당 키와 연결된 서비스 계정과 공유됩니다. 리소스를 공유하려면 리소스에 대한 admin 액세스 권한이 있어야 합니다.

경로 매개변수

resource_idstring필수

대상 리소스의 ID입니다.

요청

This endpoint expects an object.

roleenum필수

대상에 부여할 역할입니다. ‘admin’, ‘editor’, ‘commenter’, ‘viewer’ 중 하나입니다.

허용된 값:

resource_typeenum필수

대상 리소스의 리소스 유형입니다.

user_emailstring or null선택 사항

사용자 또는 서비스 계정의 이메일입니다.

group_idstring or null선택 사항

대상 그룹의 ID입니다. 리소스의 기본 역할을 설정하려면 ‘default’를 사용하세요. 직접 사용자 권한 부여, 그룹 멤버십 또는 워크스페이스(서비스 계정) API 키를 통해 더 높은 역할을 보유하지 않는 한 모든 워크스페이스 멤버에게 이 역할이 부여됩니다.

workspace_api_key_idstring or null선택 사항

대상 워크스페이스(서비스 계정) API 키의 ID입니다. 이는 인증을 위해 헤더에 전달하는 API 키 문자열 자체가 아니라 키의 ID이며, 워크스페이스 관리자는 개발자 → 서비스 계정에서 확인할 수 있습니다.

응답

성공 응답

오류

422

Unprocessable Entity Error