Files.com(미리 보기)

Files.com 커넥터는 Microsoft의 자동화 플랫폼에서 자동화된 워크플로 및 통합을 위해 Files.com 직접 고성능 통합을 제공합니다.

이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.

서비스	클래스	Regions
Copilot Studio	Premium	다음을 제외한 모든 Power Automate 지역 :      - 미국 정부(GCC)      - 미국 정부(GCC High)      - 21Vianet에서 운영하는 중국 클라우드      - 미국 국방부(DoD)
논리 앱	스탠다드	다음을 제외한 모든 Logic Apps 지역 :      - Azure Government 지역      - Azure 중국 지역      - 미국 국방부(DoD)
Power Apps	Premium	다음을 제외한 모든 Power Apps 지역 :      - 미국 정부(GCC)      - 미국 정부(GCC High)      - 21Vianet에서 운영하는 중국 클라우드      - 미국 국방부(DoD)
Power Automate (파워 오토메이트)	Premium	다음을 제외한 모든 Power Automate 지역 :      - 미국 정부(GCC)      - 미국 정부(GCC High)      - 21Vianet에서 운영하는 중국 클라우드      - 미국 국방부(DoD)

연락처
이름	Files.com 지원
URL	https://www.files.com/contact
전자 메일	support@files.com

커넥터 메타데이터
게시자	Files.com
웹 사이트	https://www.files.com/
개인 정보 보호 정책	https://www.files.com/legal/privacy
카테고리	콘텐츠 및 파일;IT 작업

Files.com Power Automate 커넥터

개요

Files.com 커넥터는 Microsoft Power Automate 및 Azure Logic Apps의 Files.com 직접 고성능 통합을 제공합니다. Files.com 클라우드 네이티브 차세대 MFT, SFTP 및 보안 파일 공유 플랫폼으로, 부서지기 쉬운 레거시 서버를 항상 사용하는 보안 패브릭으로 대체합니다. 사용자 공동 작업을 지원하고 수동 작업을 제거하면서 모든 클라우드, 프로토콜 또는 파트너 간에 중요 업무용 파일 흐름을 자동화합니다.

참고: 이 커넥터는 작업만 제공하며 아직 트리거를 포함하지 않습니다.

⸻

필수 조건

이 커넥터를 사용하기 전에 1. API 키가 있는 유효한 Files.com 계정이 있는지 확인합니다. 2. Microsoft Power Automate에 대한 액세스.

⸻

Authentication

이 커넥터는 API 키 인증을 사용합니다. API 키는 아래의 Files.com 계정에서 생성할 수 있습니다.

API 키를 → 설정 → API 키를 만듭니다.

커넥터를 구성할 때 인증 필드에 Files.com 호스트 및 API 키를 입력합니다.

예제:

호스트: yourcompany API 키: abc123456789...

모든 요청은 다음으로 전송됩니다.

https://yourcompany.files.com/api/rest/v1/

⸻

예제 사용 사례 1. 사용자 및 그룹을 관리하여 Power Automate 작업을 통해 직접 사용자 만들기, 업데이트 또는 비활성화, 역할 할당 및 그룹 멤버 자격을 관리합니다. 2. 공유 링크(번들) 워크플로 자동화 파일 배달을 위한 공유 링크를 생성하거나, 받는 사람을 추가하거나, 알림을 구성하거나, 액세스를 자동으로 해지합니다. 3. 파일 메타데이터 목록 폴더를 동기화하고, 파일 메타데이터를 검색하고, 권한 변경 또는 태그 지정과 같은 자동화 논리를 적용합니다. 4. 사용자 프로비저닝 워크플로를 빌드하여 HR 또는 ID 관리 시스템을 Files.com 통합하여 변경이 발생할 때 자동으로 사용자를 만들거나 액세스를 업데이트합니다. 5. 문서 배포 트리거 Files.com 작업을 OneDrive 또는 SharePoint와 결합하여 문서를 안전하게 배포하거나 보관합니다.

⸻

Support

커넥터 설정에 대한 기술 지원 또는 질문은 에서 Files.com 지원에 문의하세요. https://www.files.com/contact

Power Automate 관련 문제는 Microsoft의 사용자 지정 커넥터 설명서를 참조하세요.

⸻

법적 고지 사항

이 커넥터는 Files.com 제공됩니다. 이 커넥터를 사용하면 Files.com 서비스 약관 및 개인 정보 취급 방침에 동의합니다.

연결을 만드는 중

커넥터는 다음 인증 유형을 지원합니다.

기본값	연결을 만들기 위한 매개 변수입니다.	모든 지역	공유할 수 없음

기본값

적용 가능: 모든 지역

연결을 만들기 위한 매개 변수입니다.

공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.

이름	유형	Description	필수
API 키	시큐어스트링 (보안 문자열)	이 api에 대한 api_key	진실

제한 한도

Name	호출	갱신 기간
연결당 API 호출	100	60초

동작

경로별 파일 또는 폴더 찾기	경로별 파일 또는 폴더 찾기
경로별 폴더 나열	경로별 폴더 나열
공유 링크 나열	공유 링크 나열
공유 링크 다운로드 나열	공유 링크 다운로드 나열
공유 링크 등록 나열	공유 링크 등록 나열
공유 링크 만들기	공유 링크 만들기
공유 링크 받는 사람 만들기	공유 링크 받는 사람 만들기
공유 링크 삭제	공유 링크 삭제
공유 링크 알림 나열	공유 링크 알림 나열
공유 링크 알림 만들기	공유 링크 알림 만들기
공유 링크 알림 삭제	공유 링크 알림 삭제
공유 링크 알림 업데이트	공유 링크 알림 업데이트
공유 링크 알림 표시	공유 링크 알림 표시
공유 링크 업데이트	공유 링크 업데이트
공유 링크 표시	공유 링크 표시
그룹 만들기	그룹 만들기
그룹 삭제	그룹 삭제
그룹 업데이트하기	그룹 업데이트하기
그룹 표시	그룹 표시
그룹에 대한 새 사용자 계정 만들기	그룹에 대한 새 사용자 계정 만들기
목록 공유 링크 받는 사람	목록 공유 링크 받는 사람
목록 그룹	목록 그룹
사용자 나열	사용자 나열
사용자 삭제	사용자 삭제
사용자 생성	사용자 생성
사용자 업데이트	사용자 업데이트
사용자 업데이트	사용자 업데이트
사용자 표시	사용자 표시
파일 다운로드	파일 다운로드
파일 또는 폴더 복사	파일 또는 폴더 복사
파일 또는 폴더 삭제	파일 또는 폴더 삭제
파일 또는 폴더 이동	파일 또는 폴더 이동
파일 업로드	파일 업로드
폴더 만들기	폴더 만들기

경로별 파일 또는 폴더 찾기

작업 ID:

FileActionFind

경로별 파일 또는 폴더 찾기

매개 변수

Name	키	필수	형식	Description
경로	path	True	string	작동할 경로입니다.

반환

Name	경로	형식	Description
경로	path	string	파일 또는 폴더 경로입니다. 슬래시로 구분해야 하지만 슬래시로 시작하거나 끝내서는 안 됩니다. 최대 5,000자입니다.
created_by_id	created_by_id	integer	파일 또는 폴더를 만든 사용자의 사용자 ID
created_by_api_key_id	created_by_api_key_id	integer	파일 또는 폴더를 만든 API 키의 ID
created_by_as2_incoming_message_id	created_by_as2_incoming_message_id	integer	파일 또는 폴더를 만든 AS2 수신 메시지의 ID
created_by_automation_id	created_by_automation_id	integer	파일 또는 폴더를 만든 Automation의 ID
created_by_bundle_registration_id	created_by_bundle_registration_id	integer	파일 또는 폴더를 만든 번들 등록의 ID
created_by_inbox_id	created_by_inbox_id	integer	파일 또는 폴더를 만든 받은 편지함의 ID
created_by_remote_server_id	created_by_remote_server_id	integer	파일 또는 폴더를 만든 원격 서버의 ID
created_by_sync_id	created_by_sync_id	integer	파일 또는 폴더를 만든 동기화의 ID
custom_metadata	custom_metadata	object	키 및 값의 사용자 지정 메타데이터 맵입니다. 키 32개, 키당 256자, 값당 1024자로 제한됩니다.
display_name	display_name	string	파일 또는 폴더 표시 이름
type	type	string	형식: directory 또는 file.
size	size	integer	파일 또는 폴더 크기
생성_시간	created_at	string	파일 생성 날짜 또는 시간
last_modified_by_id	last_modified_by_id	integer	파일 또는 폴더를 마지막으로 수정한 사용자의 사용자 ID
last_modified_by_api_key_id	last_modified_by_api_key_id	integer	파일 또는 폴더를 마지막으로 수정한 API 키의 ID
last_modified_by_automation_id	last_modified_by_automation_id	integer	파일 또는 폴더를 마지막으로 수정한 Automation의 ID
last_modified_by_bundle_registration_id	last_modified_by_bundle_registration_id	integer	파일 또는 폴더를 마지막으로 수정한 번들 등록의 ID
last_modified_by_remote_server_id	last_modified_by_remote_server_id	integer	파일 또는 폴더를 마지막으로 수정한 원격 서버의 ID
last_modified_by_sync_id	last_modified_by_sync_id	integer	파일 또는 폴더를 마지막으로 수정한 동기화의 ID
mtime	mtime	string	서버에 따라 마지막으로 수정한 날짜 또는 시간 파일입니다. 수정된 타임스탬프가 전송되었는지에 관계없이 파일의 마지막 Files.com 작업의 타임스탬프입니다.
provided_mtime	provided_mtime	string	마지막으로 수정한 날짜 또는 시간을 설정한 클라이언트에 따라 파일을 작성합니다. Files.com 데스크톱, FTP, SFTP 및 WebDAV 클라이언트가 수정된 시간을 설정할 수 있습니다. 이를 통해 데스크톱<->클라우드 동기화는 때때로 수정된 상태를 유지할 수 있습니다.
Crc32	crc32	string	파일 CRC32 체크섬입니다. 때로는 지연되므로 빈 응답을 받으면 기다렸다가 다시 시도하십시오.
md5	md5	string	파일 MD5 체크섬입니다. 때로는 지연되므로 빈 응답을 받으면 기다렸다가 다시 시도하십시오.
sha1	sha1	string	파일 SHA1 체크섬입니다. 때로는 지연되므로 빈 응답을 받으면 기다렸다가 다시 시도하십시오.
sha256	sha256	string	SHA256 체크섬 파일 때로는 지연되므로 빈 응답을 받으면 기다렸다가 다시 시도하십시오.
MIME 유형 (mime_type)	mime_type	string	MIME 형식입니다. 파일 이름 확장명에서 결정되며 내부적으로 별도로 저장되지 않습니다.
region	region	string	지역 위치
permissions	permissions	string	현재 사용자의 권한을 나타내는 짧은 문자열입니다. (읽기), (쓰기),w (삭제), ld (목록) 또는 모든 조합일 r 수 있습니다.
subfolders_locked?	subfolders_locked?	boolean	하위 폴더가 잠겨 있고 수정할 수 없나요?
is_locked	is_locked	boolean	이 폴더가 잠겨 있고 수정할 수 없나요?
download_uri	download_uri	string	파일을 다운로드하는 링크입니다. 다운로드 요청에 대한 응답으로만 제공됩니다.
priority_color	priority_color	string	파일 또는 폴더의 책갈피 또는 우선 순위 색
preview_id	preview_id	integer	파일 미리 보기 ID
아이디	preview.id	integer	미리 보기 ID
status	preview.status	string	미리 보기 상태입니다. 유효하지 않거나, not_generated, 생성, 완료 또는 file_too_large 수 있습니다.
download_uri	preview.download_uri	string	미리 보기 다운로드 링크
type	preview.type	string	미리 보기 유형입니다. 이미지, pdf, pdf_native, 비디오 또는 오디오일 수 있습니다.
size	preview.size	string	미리 보기 크기

경로별 폴더 나열

작업 ID:

FolderListForPath

경로별 폴더 나열

매개 변수

Name	키	필수	형식	Description
경로	path	True	string	작동할 경로입니다.

반환

Name	경로	형식	Description
		array of object
경로	path	string	파일 또는 폴더 경로입니다. 슬래시로 구분해야 하지만 슬래시로 시작하거나 끝내서는 안 됩니다. 최대 5,000자입니다.
created_by_id	created_by_id	integer	파일 또는 폴더를 만든 사용자의 사용자 ID
created_by_api_key_id	created_by_api_key_id	integer	파일 또는 폴더를 만든 API 키의 ID
created_by_as2_incoming_message_id	created_by_as2_incoming_message_id	integer	파일 또는 폴더를 만든 AS2 수신 메시지의 ID
created_by_automation_id	created_by_automation_id	integer	파일 또는 폴더를 만든 Automation의 ID
created_by_bundle_registration_id	created_by_bundle_registration_id	integer	파일 또는 폴더를 만든 번들 등록의 ID
created_by_inbox_id	created_by_inbox_id	integer	파일 또는 폴더를 만든 받은 편지함의 ID
created_by_remote_server_id	created_by_remote_server_id	integer	파일 또는 폴더를 만든 원격 서버의 ID
created_by_sync_id	created_by_sync_id	integer	파일 또는 폴더를 만든 동기화의 ID
custom_metadata	custom_metadata	object	키 및 값의 사용자 지정 메타데이터 맵입니다. 키 32개, 키당 256자, 값당 1024자로 제한됩니다.
display_name	display_name	string	파일 또는 폴더 표시 이름
type	type	string	형식: directory 또는 file.
size	size	integer	파일 또는 폴더 크기
생성_시간	created_at	string	파일 생성 날짜 또는 시간
last_modified_by_id	last_modified_by_id	integer	파일 또는 폴더를 마지막으로 수정한 사용자의 사용자 ID
last_modified_by_api_key_id	last_modified_by_api_key_id	integer	파일 또는 폴더를 마지막으로 수정한 API 키의 ID
last_modified_by_automation_id	last_modified_by_automation_id	integer	파일 또는 폴더를 마지막으로 수정한 Automation의 ID
last_modified_by_bundle_registration_id	last_modified_by_bundle_registration_id	integer	파일 또는 폴더를 마지막으로 수정한 번들 등록의 ID
last_modified_by_remote_server_id	last_modified_by_remote_server_id	integer	파일 또는 폴더를 마지막으로 수정한 원격 서버의 ID
last_modified_by_sync_id	last_modified_by_sync_id	integer	파일 또는 폴더를 마지막으로 수정한 동기화의 ID
mtime	mtime	string	서버에 따라 마지막으로 수정한 날짜 또는 시간 파일입니다. 수정된 타임스탬프가 전송되었는지에 관계없이 파일의 마지막 Files.com 작업의 타임스탬프입니다.
provided_mtime	provided_mtime	string	마지막으로 수정한 날짜 또는 시간을 설정한 클라이언트에 따라 파일을 작성합니다. Files.com 데스크톱, FTP, SFTP 및 WebDAV 클라이언트가 수정된 시간을 설정할 수 있습니다. 이를 통해 데스크톱<->클라우드 동기화는 때때로 수정된 상태를 유지할 수 있습니다.
Crc32	crc32	string	파일 CRC32 체크섬입니다. 때로는 지연되므로 빈 응답을 받으면 기다렸다가 다시 시도하십시오.
md5	md5	string	파일 MD5 체크섬입니다. 때로는 지연되므로 빈 응답을 받으면 기다렸다가 다시 시도하십시오.
sha1	sha1	string	파일 SHA1 체크섬입니다. 때로는 지연되므로 빈 응답을 받으면 기다렸다가 다시 시도하십시오.
sha256	sha256	string	SHA256 체크섬 파일 때로는 지연되므로 빈 응답을 받으면 기다렸다가 다시 시도하십시오.
MIME 유형 (mime_type)	mime_type	string	MIME 형식입니다. 파일 이름 확장명에서 결정되며 내부적으로 별도로 저장되지 않습니다.
region	region	string	지역 위치
permissions	permissions	string	현재 사용자의 권한을 나타내는 짧은 문자열입니다. (읽기), (쓰기),w (삭제), ld (목록) 또는 모든 조합일 r 수 있습니다.
subfolders_locked?	subfolders_locked?	boolean	하위 폴더가 잠겨 있고 수정할 수 없나요?
is_locked	is_locked	boolean	이 폴더가 잠겨 있고 수정할 수 없나요?
download_uri	download_uri	string	파일을 다운로드하는 링크입니다. 다운로드 요청에 대한 응답으로만 제공됩니다.
priority_color	priority_color	string	파일 또는 폴더의 책갈피 또는 우선 순위 색
preview_id	preview_id	integer	파일 미리 보기 ID
아이디	preview.id	integer	미리 보기 ID
status	preview.status	string	미리 보기 상태입니다. 유효하지 않거나, not_generated, 생성, 완료 또는 file_too_large 수 있습니다.
download_uri	preview.download_uri	string	미리 보기 다운로드 링크
type	preview.type	string	미리 보기 유형입니다. 이미지, pdf, pdf_native, 비디오 또는 오디오일 수 있습니다.
size	preview.size	string	미리 보기 크기

공유 링크 나열

작업 ID:

GetBundles

공유 링크 나열

반환

Name	경로	형식	Description
		array of object
코드	code	string	번들 코드입니다. 이 코드는 공용 URL의 끝 부분을 형성합니다.
color_left	color_left	string	페이지 링크 및 단추 색
color_link	color_link	string	위쪽 막대 링크 색
color_text	color_text	string	페이지 링크 및 단추 색
color_top	color_top	string	위쪽 막대 배경색
color_top_text	color_top_text	string	위쪽 막대 텍스트 색
url	url	string	공유 링크의 공용 URL
description	description	string	공용 설명
만료_일자	expires_at	string	번들 만료 날짜 또는 시간
password_protected	password_protected	boolean	이 번들 암호가 보호되었나요?
permissions	permissions	string	이 공유 링크의 폴더에 적용되는 권한입니다.
preview_only	preview_only	boolean
require_registration	require_registration	boolean	다운로더의 이름과 전자 메일 주소를 캡처하는 등록 페이지를 표시하시겠습니까?
require_share_recipient	require_share_recipient	boolean	Files.com UI를 통해 전송된 전자 메일을 통해 명시적으로 공유를 받은 받는 사람에게만 액세스를 허용하시겠습니까?
require_logout	require_logout	boolean	true이면 번들 등록 페이지에서 '내 기억' 상자를 숨기므로 사용자가 페이지를 방문할 때마다 로그아웃하고 다시 로그인해야 합니다.
clickwrap_body	clickwrap_body	string	번들에 액세스하기 전에 동의해야 하는 법적 텍스트입니다.
아이디	form_field_set.id	integer	양식 필드 집합 ID
title	form_field_set.title	string	표시할 제목
form_layout	form_field_set.form_layout	array of integer	양식의 레이아웃
form_fields	form_field_set.form_fields	array of object	연결된 양식 필드
items	form_field_set.form_fields	object
skip_name	form_field_set.skip_name	boolean	연결된 모든 InboxRegistrations 또는 BundleRegistrations는 이름을 제공하지 않고 저장할 수 있습니다.
skip_email	form_field_set.skip_email	boolean	전자 메일을 제공하지 않고 연결된 모든 InboxRegistrations 또는 BundleRegistrations를 저장할 수 있습니다.
skip_company	form_field_set.skip_company	boolean	연결된 모든 InboxRegistrations 또는 BundleRegistrations는 회사를 제공하지 않고도 저장할 수 있습니다.
in_use	form_field_set.in_use	boolean	양식 필드 집합은 활성 받은 편지함 또는 번들 또는 받은 편지함 등록 또는 번들 등록에서 사용 중입니다.
skip_name	skip_name	boolean	이름을 제공하지 않고 BundleRegistrations를 저장할 수 있나요?
skip_email	skip_email	boolean	이메일을 제공하지 않고 BundleRegistrations를 저장할 수 있나요?
start_access_on_date	start_access_on_date	string	공유에 액세스할 수 있는 날짜입니다. 만든 직후에 액세스 권한이 부여된 경우 nil
skip_company	skip_company	boolean	BundleRegistrations는 회사를 제공하지 않고 저장할 수 있나요?
아이디	id	integer	번들 ID
생성_시간	created_at	string	날짜 또는 시간에 만든 번들
dont_separate_submissions_by_folder	dont_separate_submissions_by_folder	boolean	이 공유에 업로드된 파일에 대한 하위 폴더를 만들지 마세요. 참고: 여러 사용자의 익명 업로드가 동일한 폴더에 살 수 있도록 허용하는 미묘한 보안 문제가 있습니다. 반드시 필요한 경우가 아니면 이 옵션을 사용하지 않는 것이 좋습니다.
max_uses	max_uses	integer	번들에 액세스할 수 있는 최대 횟수
메모	note	string	번들 내부 메모
path_template	path_template	string	제출 하위 폴더를 만들기 위한 템플릿입니다. 업로더의 이름, 이메일 주소, ip, 회사, strftime 지시문 및 사용자 지정 양식 데이터를 사용할 수 있습니다.
path_template_time_zone	path_template_time_zone	string	경로 템플릿에서 타임스탬프를 렌더링할 때 사용할 표준 시간대입니다.
send_email_receipt_to_uploader	send_email_receipt_to_uploader	boolean	업로더에 배달 영수증을 보냅니다. 참고: 쓰기 가능한 공유에만 해당
snapshot_id	snapshot_id	integer	이 번들의 콘텐츠를 포함하는 스냅샷의 ID입니다.
사용자_아이디	user_id	integer	번들 작성자 사용자 ID
사용자 이름	username	string	번들 작성자 사용자 이름
clickwrap_id	clickwrap_id	integer	이 번들과 함께 사용할 clickwrap의 ID입니다.
inbox_id	inbox_id	integer	사용 가능한 경우 연결된 받은 편지함의 ID입니다.
이름	watermark_attachment.name	string	이미지 이름
URI	watermark_attachment.uri	string	이미지 URI
watermark_value	watermark_value	object	모든 번들 항목에 적용되는 워터마크 설정을 미리 봅니다. Behavior.value와 동일한 키를 사용합니다.
has_inbox	has_inbox	boolean	이 번들에 연결된 받은 편지함이 있나요?
dont_allow_folders_in_uploads	dont_allow_folders_in_uploads	boolean	폴더 업로드를 방지해야 하나요?
경로	paths	array of string	이 번들의 경로 목록입니다. 성능상의 이유로 번들을 나열할 때는 제공되지 않습니다.
bundlepaths	bundlepaths	array of object	이 번들의 번들 경로 목록입니다. 성능상의 이유로 번들을 나열할 때는 제공되지 않습니다.
items	bundlepaths	object

공유 링크 다운로드 나열

작업 ID:

GetBundleDownloads

공유 링크 다운로드 나열

매개 변수

Name	키	필수	형식	Description
번들 ID	bundle_id		integer	번들 ID

반환

Name	경로	형식	Description
		array of object
코드	bundle_registration.code	string	등록 쿠키 코드
이름	bundle_registration.name	string	등록자 이름
회사	bundle_registration.company	string	등록자 회사 이름
메일 주소	bundle_registration.email	string	등록자 전자 메일 주소
ip	bundle_registration.ip	string	등록자 IP 주소
inbox_code	bundle_registration.inbox_code	string	InboxRegistration 쿠키 코드(연결된 InboxRegistration이 있는 경우)
clickwrap_body	bundle_registration.clickwrap_body	string	등록자에게 표시된 Clickwrap 텍스트
form_field_set_id	bundle_registration.form_field_set_id	integer	연결된 양식 필드 집합의 ID
form_field_data	bundle_registration.form_field_data	object	양식 필드 ID가 키로, 사용자 데이터가 값으로 설정된 양식 필드의 데이터
bundle_code	bundle_registration.bundle_code	string	번들 URL 코드
bundle_id	bundle_registration.bundle_id	integer	연결된 번들의 ID
bundle_recipient_id	bundle_registration.bundle_recipient_id	integer	연결된 번들 받는 사람의 ID
생성_시간	bundle_registration.created_at	string	등록 생성 날짜 또는 시간
download_method	download_method	string	다운로드 방법(파일 또는 full_zip)
경로	path	string	다운로드 경로입니다. 슬래시로 구분해야 하지만 슬래시로 시작하거나 끝내서는 안 됩니다. 최대 5,000자입니다.
생성_시간	created_at	string	다운로드 날짜 또는 시간

공유 링크 등록 나열

작업 ID:

GetBundleRegistrations

공유 링크 등록 나열

매개 변수

Name	키	필수	형식	Description
번들 ID	bundle_id		integer	연결된 번들의 ID

반환

Name	경로	형식	Description
		array of object
코드	code	string	등록 쿠키 코드
이름	name	string	등록자 이름
회사	company	string	등록자 회사 이름
메일 주소	email	string	등록자 전자 메일 주소
ip	ip	string	등록자 IP 주소
inbox_code	inbox_code	string	InboxRegistration 쿠키 코드(연결된 InboxRegistration이 있는 경우)
clickwrap_body	clickwrap_body	string	등록자에게 표시된 Clickwrap 텍스트
form_field_set_id	form_field_set_id	integer	연결된 양식 필드 집합의 ID
form_field_data	form_field_data	object	양식 필드 ID가 키로, 사용자 데이터가 값으로 설정된 양식 필드의 데이터
bundle_code	bundle_code	string	번들 URL 코드
bundle_id	bundle_id	integer	연결된 번들의 ID
bundle_recipient_id	bundle_recipient_id	integer	연결된 번들 받는 사람의 ID
생성_시간	created_at	string	등록 생성 날짜 또는 시간

공유 링크 만들기

작업 ID:

PostBundles

공유 링크 만들기

매개 변수

Name	키	필수	형식	Description
Description	description		string	공용 설명
만료 시간	expires_at		date-time	번들 만료 날짜/시간
최대 사용	max_uses		integer	번들에 액세스할 수 있는 최대 횟수
비고	note		string	번들 내부 메모
암호	password		string	이 번들에 대한 암호입니다.
Paths	paths	True	array of string	이 번들에 포함할 경로 목록입니다.
등록 필요	require_registration		boolean	다운로더의 이름과 전자 메일 주소를 캡처하는 등록 페이지를 표시하시겠습니까?

반환

Name	경로	형식	Description
코드	code	string	번들 코드입니다. 이 코드는 공용 URL의 끝 부분을 형성합니다.
color_left	color_left	string	페이지 링크 및 단추 색
color_link	color_link	string	위쪽 막대 링크 색
color_text	color_text	string	페이지 링크 및 단추 색
color_top	color_top	string	위쪽 막대 배경색
color_top_text	color_top_text	string	위쪽 막대 텍스트 색
url	url	string	공유 링크의 공용 URL
description	description	string	공용 설명
만료_일자	expires_at	string	번들 만료 날짜 또는 시간
password_protected	password_protected	boolean	이 번들 암호가 보호되었나요?
permissions	permissions	string	이 공유 링크의 폴더에 적용되는 권한입니다.
preview_only	preview_only	boolean
require_registration	require_registration	boolean	다운로더의 이름과 전자 메일 주소를 캡처하는 등록 페이지를 표시하시겠습니까?
require_share_recipient	require_share_recipient	boolean	Files.com UI를 통해 전송된 전자 메일을 통해 명시적으로 공유를 받은 받는 사람에게만 액세스를 허용하시겠습니까?
require_logout	require_logout	boolean	true이면 번들 등록 페이지에서 '내 기억' 상자를 숨기므로 사용자가 페이지를 방문할 때마다 로그아웃하고 다시 로그인해야 합니다.
clickwrap_body	clickwrap_body	string	번들에 액세스하기 전에 동의해야 하는 법적 텍스트입니다.
아이디	form_field_set.id	integer	양식 필드 집합 ID
title	form_field_set.title	string	표시할 제목
form_layout	form_field_set.form_layout	array of integer	양식의 레이아웃
form_fields	form_field_set.form_fields	array of object	연결된 양식 필드
items	form_field_set.form_fields	object
skip_name	form_field_set.skip_name	boolean	연결된 모든 InboxRegistrations 또는 BundleRegistrations는 이름을 제공하지 않고 저장할 수 있습니다.
skip_email	form_field_set.skip_email	boolean	전자 메일을 제공하지 않고 연결된 모든 InboxRegistrations 또는 BundleRegistrations를 저장할 수 있습니다.
skip_company	form_field_set.skip_company	boolean	연결된 모든 InboxRegistrations 또는 BundleRegistrations는 회사를 제공하지 않고도 저장할 수 있습니다.
in_use	form_field_set.in_use	boolean	양식 필드 집합은 활성 받은 편지함 또는 번들 또는 받은 편지함 등록 또는 번들 등록에서 사용 중입니다.
skip_name	skip_name	boolean	이름을 제공하지 않고 BundleRegistrations를 저장할 수 있나요?
skip_email	skip_email	boolean	이메일을 제공하지 않고 BundleRegistrations를 저장할 수 있나요?
start_access_on_date	start_access_on_date	string	공유에 액세스할 수 있는 날짜입니다. 만든 직후에 액세스 권한이 부여된 경우 nil
skip_company	skip_company	boolean	BundleRegistrations는 회사를 제공하지 않고 저장할 수 있나요?
아이디	id	integer	번들 ID
생성_시간	created_at	string	날짜 또는 시간에 만든 번들
dont_separate_submissions_by_folder	dont_separate_submissions_by_folder	boolean	이 공유에 업로드된 파일에 대한 하위 폴더를 만들지 마세요. 참고: 여러 사용자의 익명 업로드가 동일한 폴더에 살 수 있도록 허용하는 미묘한 보안 문제가 있습니다. 반드시 필요한 경우가 아니면 이 옵션을 사용하지 않는 것이 좋습니다.
max_uses	max_uses	integer	번들에 액세스할 수 있는 최대 횟수
메모	note	string	번들 내부 메모
path_template	path_template	string	제출 하위 폴더를 만들기 위한 템플릿입니다. 업로더의 이름, 이메일 주소, ip, 회사, strftime 지시문 및 사용자 지정 양식 데이터를 사용할 수 있습니다.
path_template_time_zone	path_template_time_zone	string	경로 템플릿에서 타임스탬프를 렌더링할 때 사용할 표준 시간대입니다.
send_email_receipt_to_uploader	send_email_receipt_to_uploader	boolean	업로더에 배달 영수증을 보냅니다. 참고: 쓰기 가능한 공유에만 해당
snapshot_id	snapshot_id	integer	이 번들의 콘텐츠를 포함하는 스냅샷의 ID입니다.
사용자_아이디	user_id	integer	번들 작성자 사용자 ID
사용자 이름	username	string	번들 작성자 사용자 이름
clickwrap_id	clickwrap_id	integer	이 번들과 함께 사용할 clickwrap의 ID입니다.
inbox_id	inbox_id	integer	사용 가능한 경우 연결된 받은 편지함의 ID입니다.
이름	watermark_attachment.name	string	이미지 이름
URI	watermark_attachment.uri	string	이미지 URI
watermark_value	watermark_value	object	모든 번들 항목에 적용되는 워터마크 설정을 미리 봅니다. Behavior.value와 동일한 키를 사용합니다.
has_inbox	has_inbox	boolean	이 번들에 연결된 받은 편지함이 있나요?
dont_allow_folders_in_uploads	dont_allow_folders_in_uploads	boolean	폴더 업로드를 방지해야 하나요?
경로	paths	array of string	이 번들의 경로 목록입니다. 성능상의 이유로 번들을 나열할 때는 제공되지 않습니다.
bundlepaths	bundlepaths	array of object	이 번들의 번들 경로 목록입니다. 성능상의 이유로 번들을 나열할 때는 제공되지 않습니다.
items	bundlepaths	object

공유 링크 받는 사람 만들기

작업 ID:

PostBundleRecipients

공유 링크 받는 사람 만들기

매개 변수

Name	키	필수	형식	Description
번들 ID	bundle_id	True	integer	공유할 번들입니다.
회사	company		string	받는 사람의 회사입니다.
이름	name		string	받는 사람의 이름입니다.
비고	note		string	전자 메일에 포함할 참고 사항입니다.
Recipient	recipient	True	string	이 번들을 공유할 전자 메일 주소입니다.

반환

Name	경로	형식	Description
회사	company	string	받는 사람의 회사입니다.
이름	name	string	받는 사람의 이름입니다.
메모	note	string	번들로 받는 사람에게 보낸 메모입니다.
수령인	recipient	string	받는 사람의 이메일 주소입니다.
sent_at	sent_at	string	번들을 이 받는 사람과 공유한 경우

공유 링크 삭제

작업 ID:

DeleteBundlesId

공유 링크 삭제

매개 변수

Name	키	필수	형식	Description
아이디	id	True	integer	번들 ID입니다.

공유 링크 알림 나열

작업 ID:

GetBundleNotifications

공유 링크 알림 나열

반환

Name	경로	형식	Description
		array of object
bundle_id	bundle_id	integer	알림할 번들 ID
아이디	id	integer	번들 알림 ID
notify_on_registration	notify_on_registration	boolean	등록 작업이 발생하면 번들 알림을 트리거합니다.
notify_on_upload	notify_on_upload	boolean	업로드 작업이 수행되면 번들 알림을 트리거합니다.
notify_user_id	notify_user_id	integer	알릴 사용자의 ID입니다.

공유 링크 알림 만들기

작업 ID:

PostBundleNotifications

공유 링크 알림 만들기

매개 변수

Name	키	필수	형식	Description
번들 ID	bundle_id	True	integer	알림할 번들 ID
사용자 ID에 알림	notify_user_id		integer	알릴 사용자의 ID입니다.

반환

Name	경로	형식	Description
bundle_id	bundle_id	integer	알림할 번들 ID
아이디	id	integer	번들 알림 ID
notify_on_registration	notify_on_registration	boolean	등록 작업이 발생하면 번들 알림을 트리거합니다.
notify_on_upload	notify_on_upload	boolean	업로드 작업이 수행되면 번들 알림을 트리거합니다.
notify_user_id	notify_user_id	integer	알릴 사용자의 ID입니다.

공유 링크 알림 삭제

작업 ID:

DeleteBundleNotificationsId

공유 링크 알림 삭제

매개 변수

Name	키	필수	형식	Description
아이디	id	True	integer	번들 알림 ID입니다.

공유 링크 알림 업데이트

작업 ID:

PatchBundleNotificationsId

공유 링크 알림 업데이트

매개 변수

Name	키	필수	형식	Description
아이디	id	True	integer	번들 알림 ID입니다.
등록 시 알림	notify_on_registration		boolean	등록 작업이 발생하면 번들 알림을 트리거합니다.
업로드 시 알림	notify_on_upload		boolean	업로드 작업이 수행되면 번들 알림을 트리거합니다.

반환

Name	경로	형식	Description
bundle_id	bundle_id	integer	알림할 번들 ID
아이디	id	integer	번들 알림 ID
notify_on_registration	notify_on_registration	boolean	등록 작업이 발생하면 번들 알림을 트리거합니다.
notify_on_upload	notify_on_upload	boolean	업로드 작업이 수행되면 번들 알림을 트리거합니다.
notify_user_id	notify_user_id	integer	알릴 사용자의 ID입니다.

공유 링크 알림 표시

작업 ID:

GetBundleNotificationsId

공유 링크 알림 표시

매개 변수

Name	키	필수	형식	Description
아이디	id	True	integer	번들 알림 ID입니다.

반환

Name	경로	형식	Description
bundle_id	bundle_id	integer	알림할 번들 ID
아이디	id	integer	번들 알림 ID
notify_on_registration	notify_on_registration	boolean	등록 작업이 발생하면 번들 알림을 트리거합니다.
notify_on_upload	notify_on_upload	boolean	업로드 작업이 수행되면 번들 알림을 트리거합니다.
notify_user_id	notify_user_id	integer	알릴 사용자의 ID입니다.

공유 링크 업데이트

작업 ID:

PatchBundlesId

공유 링크 업데이트

매개 변수

Name	키	필수	형식	Description
아이디	id	True	integer	번들 ID입니다.
만료 시간	expires_at		date-time	번들 만료 날짜/시간

반환

Name	경로	형식	Description
코드	code	string	번들 코드입니다. 이 코드는 공용 URL의 끝 부분을 형성합니다.
color_left	color_left	string	페이지 링크 및 단추 색
color_link	color_link	string	위쪽 막대 링크 색
color_text	color_text	string	페이지 링크 및 단추 색
color_top	color_top	string	위쪽 막대 배경색
color_top_text	color_top_text	string	위쪽 막대 텍스트 색
url	url	string	공유 링크의 공용 URL
description	description	string	공용 설명
만료_일자	expires_at	string	번들 만료 날짜 또는 시간
password_protected	password_protected	boolean	이 번들 암호가 보호되었나요?
permissions	permissions	string	이 공유 링크의 폴더에 적용되는 권한입니다.
preview_only	preview_only	boolean
require_registration	require_registration	boolean	다운로더의 이름과 전자 메일 주소를 캡처하는 등록 페이지를 표시하시겠습니까?
require_share_recipient	require_share_recipient	boolean	Files.com UI를 통해 전송된 전자 메일을 통해 명시적으로 공유를 받은 받는 사람에게만 액세스를 허용하시겠습니까?
require_logout	require_logout	boolean	true이면 번들 등록 페이지에서 '내 기억' 상자를 숨기므로 사용자가 페이지를 방문할 때마다 로그아웃하고 다시 로그인해야 합니다.
clickwrap_body	clickwrap_body	string	번들에 액세스하기 전에 동의해야 하는 법적 텍스트입니다.
아이디	form_field_set.id	integer	양식 필드 집합 ID
title	form_field_set.title	string	표시할 제목
form_layout	form_field_set.form_layout	array of integer	양식의 레이아웃
form_fields	form_field_set.form_fields	array of object	연결된 양식 필드
items	form_field_set.form_fields	object
skip_name	form_field_set.skip_name	boolean	연결된 모든 InboxRegistrations 또는 BundleRegistrations는 이름을 제공하지 않고 저장할 수 있습니다.
skip_email	form_field_set.skip_email	boolean	전자 메일을 제공하지 않고 연결된 모든 InboxRegistrations 또는 BundleRegistrations를 저장할 수 있습니다.
skip_company	form_field_set.skip_company	boolean	연결된 모든 InboxRegistrations 또는 BundleRegistrations는 회사를 제공하지 않고도 저장할 수 있습니다.
in_use	form_field_set.in_use	boolean	양식 필드 집합은 활성 받은 편지함 또는 번들 또는 받은 편지함 등록 또는 번들 등록에서 사용 중입니다.
skip_name	skip_name	boolean	이름을 제공하지 않고 BundleRegistrations를 저장할 수 있나요?
skip_email	skip_email	boolean	이메일을 제공하지 않고 BundleRegistrations를 저장할 수 있나요?
start_access_on_date	start_access_on_date	string	공유에 액세스할 수 있는 날짜입니다. 만든 직후에 액세스 권한이 부여된 경우 nil
skip_company	skip_company	boolean	BundleRegistrations는 회사를 제공하지 않고 저장할 수 있나요?
아이디	id	integer	번들 ID
생성_시간	created_at	string	날짜 또는 시간에 만든 번들
dont_separate_submissions_by_folder	dont_separate_submissions_by_folder	boolean	이 공유에 업로드된 파일에 대한 하위 폴더를 만들지 마세요. 참고: 여러 사용자의 익명 업로드가 동일한 폴더에 살 수 있도록 허용하는 미묘한 보안 문제가 있습니다. 반드시 필요한 경우가 아니면 이 옵션을 사용하지 않는 것이 좋습니다.
max_uses	max_uses	integer	번들에 액세스할 수 있는 최대 횟수
메모	note	string	번들 내부 메모
path_template	path_template	string	제출 하위 폴더를 만들기 위한 템플릿입니다. 업로더의 이름, 이메일 주소, ip, 회사, strftime 지시문 및 사용자 지정 양식 데이터를 사용할 수 있습니다.
path_template_time_zone	path_template_time_zone	string	경로 템플릿에서 타임스탬프를 렌더링할 때 사용할 표준 시간대입니다.
send_email_receipt_to_uploader	send_email_receipt_to_uploader	boolean	업로더에 배달 영수증을 보냅니다. 참고: 쓰기 가능한 공유에만 해당
snapshot_id	snapshot_id	integer	이 번들의 콘텐츠를 포함하는 스냅샷의 ID입니다.
사용자_아이디	user_id	integer	번들 작성자 사용자 ID
사용자 이름	username	string	번들 작성자 사용자 이름
clickwrap_id	clickwrap_id	integer	이 번들과 함께 사용할 clickwrap의 ID입니다.
inbox_id	inbox_id	integer	사용 가능한 경우 연결된 받은 편지함의 ID입니다.
이름	watermark_attachment.name	string	이미지 이름
URI	watermark_attachment.uri	string	이미지 URI
watermark_value	watermark_value	object	모든 번들 항목에 적용되는 워터마크 설정을 미리 봅니다. Behavior.value와 동일한 키를 사용합니다.
has_inbox	has_inbox	boolean	이 번들에 연결된 받은 편지함이 있나요?
dont_allow_folders_in_uploads	dont_allow_folders_in_uploads	boolean	폴더 업로드를 방지해야 하나요?
경로	paths	array of string	이 번들의 경로 목록입니다. 성능상의 이유로 번들을 나열할 때는 제공되지 않습니다.
bundlepaths	bundlepaths	array of object	이 번들의 번들 경로 목록입니다. 성능상의 이유로 번들을 나열할 때는 제공되지 않습니다.
items	bundlepaths	object

공유 링크 표시

작업 ID:

GetBundlesId

공유 링크 표시

매개 변수

Name	키	필수	형식	Description
아이디	id	True	integer	번들 ID입니다.

반환

Name	경로	형식	Description
코드	code	string	번들 코드입니다. 이 코드는 공용 URL의 끝 부분을 형성합니다.
color_left	color_left	string	페이지 링크 및 단추 색
color_link	color_link	string	위쪽 막대 링크 색
color_text	color_text	string	페이지 링크 및 단추 색
color_top	color_top	string	위쪽 막대 배경색
color_top_text	color_top_text	string	위쪽 막대 텍스트 색
url	url	string	공유 링크의 공용 URL
description	description	string	공용 설명
만료_일자	expires_at	string	번들 만료 날짜 또는 시간
password_protected	password_protected	boolean	이 번들 암호가 보호되었나요?
permissions	permissions	string	이 공유 링크의 폴더에 적용되는 권한입니다.
preview_only	preview_only	boolean
require_registration	require_registration	boolean	다운로더의 이름과 전자 메일 주소를 캡처하는 등록 페이지를 표시하시겠습니까?
require_share_recipient	require_share_recipient	boolean	Files.com UI를 통해 전송된 전자 메일을 통해 명시적으로 공유를 받은 받는 사람에게만 액세스를 허용하시겠습니까?
require_logout	require_logout	boolean	true이면 번들 등록 페이지에서 '내 기억' 상자를 숨기므로 사용자가 페이지를 방문할 때마다 로그아웃하고 다시 로그인해야 합니다.
clickwrap_body	clickwrap_body	string	번들에 액세스하기 전에 동의해야 하는 법적 텍스트입니다.
아이디	form_field_set.id	integer	양식 필드 집합 ID
title	form_field_set.title	string	표시할 제목
form_layout	form_field_set.form_layout	array of integer	양식의 레이아웃
form_fields	form_field_set.form_fields	array of object	연결된 양식 필드
items	form_field_set.form_fields	object
skip_name	form_field_set.skip_name	boolean	연결된 모든 InboxRegistrations 또는 BundleRegistrations는 이름을 제공하지 않고 저장할 수 있습니다.
skip_email	form_field_set.skip_email	boolean	전자 메일을 제공하지 않고 연결된 모든 InboxRegistrations 또는 BundleRegistrations를 저장할 수 있습니다.
skip_company	form_field_set.skip_company	boolean	연결된 모든 InboxRegistrations 또는 BundleRegistrations는 회사를 제공하지 않고도 저장할 수 있습니다.
in_use	form_field_set.in_use	boolean	양식 필드 집합은 활성 받은 편지함 또는 번들 또는 받은 편지함 등록 또는 번들 등록에서 사용 중입니다.
skip_name	skip_name	boolean	이름을 제공하지 않고 BundleRegistrations를 저장할 수 있나요?
skip_email	skip_email	boolean	이메일을 제공하지 않고 BundleRegistrations를 저장할 수 있나요?
start_access_on_date	start_access_on_date	string	공유에 액세스할 수 있는 날짜입니다. 만든 직후에 액세스 권한이 부여된 경우 nil
skip_company	skip_company	boolean	BundleRegistrations는 회사를 제공하지 않고 저장할 수 있나요?
아이디	id	integer	번들 ID
생성_시간	created_at	string	날짜 또는 시간에 만든 번들
dont_separate_submissions_by_folder	dont_separate_submissions_by_folder	boolean	이 공유에 업로드된 파일에 대한 하위 폴더를 만들지 마세요. 참고: 여러 사용자의 익명 업로드가 동일한 폴더에 살 수 있도록 허용하는 미묘한 보안 문제가 있습니다. 반드시 필요한 경우가 아니면 이 옵션을 사용하지 않는 것이 좋습니다.
max_uses	max_uses	integer	번들에 액세스할 수 있는 최대 횟수
메모	note	string	번들 내부 메모
path_template	path_template	string	제출 하위 폴더를 만들기 위한 템플릿입니다. 업로더의 이름, 이메일 주소, ip, 회사, strftime 지시문 및 사용자 지정 양식 데이터를 사용할 수 있습니다.
path_template_time_zone	path_template_time_zone	string	경로 템플릿에서 타임스탬프를 렌더링할 때 사용할 표준 시간대입니다.
send_email_receipt_to_uploader	send_email_receipt_to_uploader	boolean	업로더에 배달 영수증을 보냅니다. 참고: 쓰기 가능한 공유에만 해당
snapshot_id	snapshot_id	integer	이 번들의 콘텐츠를 포함하는 스냅샷의 ID입니다.
사용자_아이디	user_id	integer	번들 작성자 사용자 ID
사용자 이름	username	string	번들 작성자 사용자 이름
clickwrap_id	clickwrap_id	integer	이 번들과 함께 사용할 clickwrap의 ID입니다.
inbox_id	inbox_id	integer	사용 가능한 경우 연결된 받은 편지함의 ID입니다.
이름	watermark_attachment.name	string	이미지 이름
URI	watermark_attachment.uri	string	이미지 URI
watermark_value	watermark_value	object	모든 번들 항목에 적용되는 워터마크 설정을 미리 봅니다. Behavior.value와 동일한 키를 사용합니다.
has_inbox	has_inbox	boolean	이 번들에 연결된 받은 편지함이 있나요?
dont_allow_folders_in_uploads	dont_allow_folders_in_uploads	boolean	폴더 업로드를 방지해야 하나요?
경로	paths	array of string	이 번들의 경로 목록입니다. 성능상의 이유로 번들을 나열할 때는 제공되지 않습니다.
bundlepaths	bundlepaths	array of object	이 번들의 번들 경로 목록입니다. 성능상의 이유로 번들을 나열할 때는 제공되지 않습니다.
items	bundlepaths	object

그룹 만들기

작업 ID:

PostGroups

그룹 만들기

매개 변수

Name	키	필수	형식	Description
관리자 ID	admin_ids		string	그룹 관리자 사용자 ID 목록입니다. 문자열로 전송되는 경우 쉼표로 구분되어야 합니다.
이름	name	True	string	그룹 이름입니다.
비고	notes		string	그룹 노트.
사용자 ID	user_ids		string	사용자 ID 목록입니다. 문자열로 전송되는 경우 쉼표로 구분되어야 합니다.

반환

Name	경로	형식	Description
아이디	id	integer	그룹 아이디
이름	name	string	그룹 이름
allowed_ips	allowed_ips	string	허용되는 IP 목록(해당하는 경우)입니다. 줄 새로 고리 구분
admin_ids	admin_ids	string	그룹 관리자인 사용자 ID의 쉼표로 구분된 목록(쉼표로 구분)
메모	notes	string	이 그룹에 대한 참고 사항
user_ids	user_ids	string	이 그룹에 속한 사용자 ID의 쉼표로 구분된 목록(쉼표로 구분)
usernames	usernames	string	이 그룹에 속한 쉼표로 구분된 사용자 이름 목록(쉼표로 구분)
ftp_permission	ftp_permission	boolean	true이면 이 그룹의 사용자가 FTP를 사용하여 로그인할 수 있습니다. 그러면 사용자 수준의 false 값이 재정의 ftp_permission 됩니다.
sftp_permission	sftp_permission	boolean	true이면 이 그룹의 사용자가 SFTP를 사용하여 로그인할 수 있습니다. 그러면 사용자 수준의 false 값이 재정의 sftp_permission 됩니다.
dav_permission	dav_permission	boolean	true이면 이 그룹의 사용자가 WebDAV를 사용하여 로그인할 수 있습니다. 그러면 사용자 수준의 false 값이 재정의 dav_permission 됩니다.
restapi_permission	restapi_permission	boolean	true이면 이 그룹의 사용자가 REST API를 사용하여 로그인할 수 있습니다. 그러면 사용자 수준의 false 값이 재정의 restapi_permission 됩니다.
site_id	site_id	integer	사이트 아이디

그룹 삭제

작업 ID:

DeleteGroupsId

그룹 삭제

매개 변수

Name	키	필수	형식	Description
아이디	id	True	integer	그룹 ID입니다.

그룹 업데이트하기

작업 ID:

PatchGroupsId

그룹 업데이트하기

매개 변수

Name	키	필수	형식	Description
아이디	id	True	integer	그룹 ID입니다.
관리자 ID	admin_ids		string	그룹 관리자 사용자 ID 목록입니다. 문자열로 전송되는 경우 쉼표로 구분되어야 합니다.
이름	name		string	그룹 이름입니다.
비고	notes		string	그룹 노트.
사용자 ID	user_ids		string	사용자 ID 목록입니다. 문자열로 전송되는 경우 쉼표로 구분되어야 합니다.

반환

Name	경로	형식	Description
아이디	id	integer	그룹 아이디
이름	name	string	그룹 이름
allowed_ips	allowed_ips	string	허용되는 IP 목록(해당하는 경우)입니다. 줄 새로 고리 구분
admin_ids	admin_ids	string	그룹 관리자인 사용자 ID의 쉼표로 구분된 목록(쉼표로 구분)
메모	notes	string	이 그룹에 대한 참고 사항
user_ids	user_ids	string	이 그룹에 속한 사용자 ID의 쉼표로 구분된 목록(쉼표로 구분)
usernames	usernames	string	이 그룹에 속한 쉼표로 구분된 사용자 이름 목록(쉼표로 구분)
ftp_permission	ftp_permission	boolean	true이면 이 그룹의 사용자가 FTP를 사용하여 로그인할 수 있습니다. 그러면 사용자 수준의 false 값이 재정의 ftp_permission 됩니다.
sftp_permission	sftp_permission	boolean	true이면 이 그룹의 사용자가 SFTP를 사용하여 로그인할 수 있습니다. 그러면 사용자 수준의 false 값이 재정의 sftp_permission 됩니다.
dav_permission	dav_permission	boolean	true이면 이 그룹의 사용자가 WebDAV를 사용하여 로그인할 수 있습니다. 그러면 사용자 수준의 false 값이 재정의 dav_permission 됩니다.
restapi_permission	restapi_permission	boolean	true이면 이 그룹의 사용자가 REST API를 사용하여 로그인할 수 있습니다. 그러면 사용자 수준의 false 값이 재정의 restapi_permission 됩니다.
site_id	site_id	integer	사이트 아이디

그룹 표시

작업 ID:

GetGroupsId

그룹 표시

매개 변수

Name	키	필수	형식	Description
아이디	id	True	integer	그룹 ID입니다.

반환

Name	경로	형식	Description
아이디	id	integer	그룹 아이디
이름	name	string	그룹 이름
allowed_ips	allowed_ips	string	허용되는 IP 목록(해당하는 경우)입니다. 줄 새로 고리 구분
admin_ids	admin_ids	string	그룹 관리자인 사용자 ID의 쉼표로 구분된 목록(쉼표로 구분)
메모	notes	string	이 그룹에 대한 참고 사항
user_ids	user_ids	string	이 그룹에 속한 사용자 ID의 쉼표로 구분된 목록(쉼표로 구분)
usernames	usernames	string	이 그룹에 속한 쉼표로 구분된 사용자 이름 목록(쉼표로 구분)
ftp_permission	ftp_permission	boolean	true이면 이 그룹의 사용자가 FTP를 사용하여 로그인할 수 있습니다. 그러면 사용자 수준의 false 값이 재정의 ftp_permission 됩니다.
sftp_permission	sftp_permission	boolean	true이면 이 그룹의 사용자가 SFTP를 사용하여 로그인할 수 있습니다. 그러면 사용자 수준의 false 값이 재정의 sftp_permission 됩니다.
dav_permission	dav_permission	boolean	true이면 이 그룹의 사용자가 WebDAV를 사용하여 로그인할 수 있습니다. 그러면 사용자 수준의 false 값이 재정의 dav_permission 됩니다.
restapi_permission	restapi_permission	boolean	true이면 이 그룹의 사용자가 REST API를 사용하여 로그인할 수 있습니다. 그러면 사용자 수준의 false 값이 재정의 restapi_permission 됩니다.
site_id	site_id	integer	사이트 아이디

그룹에 대한 새 사용자 계정 만들기

작업 ID:

PostGroupsGroupIdUsers

그룹에 대한 새 사용자 계정 만들기

매개 변수

Name	키	필수	형식	Description
그룹 ID	group_id	True	integer	이 사용자를 연결할 그룹 ID입니다.
인증 방법	authentication_method		string	이 사용자는 어떻게 인증됩니까?
회사	company		string	사용자의 회사
전자 메일	email		string	사용자의 전자 메일입니다.
그룹 ID	group_ids		string	이 사용자를 연결할 그룹 ID 목록입니다. 쉼표로 구분됩니다.
이름	name		string	사용자의 전체 이름
비고	notes		string	사용자에 대한 모든 내부 메모
암호	password		string	사용자 암호입니다.
암호 변경 필요	require_password_change		boolean	다음 사용자 로그인 시 암호 변경이 필요합니까?
사용자 홈	user_home		string	FTP/SFTP의 홈 폴더입니다. API, 데스크톱 또는 웹 인터페이스에는 사용되지 않습니다.
사용자 루트	user_root		string	FTP의 루트 폴더입니다(적절한 사이트 전체 설정이 설정된 경우 선택적으로 SFTP). API, 데스크톱 또는 웹 인터페이스에는 사용되지 않습니다.
사용자 이름	username	True	string	사용자의 사용자 이름

반환

Name	경로	형식	Description
아이디	id	integer	사용자 ID
사용자 이름	username	string	사용자의 사용자 이름
admin_group_ids	admin_group_ids	array of integer	이 사용자가 관리자인 그룹 ID 목록
allowed_ips	allowed_ips	string	허용되는 IP 목록(해당하는 경우)입니다. 줄 새로 고리 구분
attachments_permission	attachments_permission	boolean	이 경우 true사용자가 번들을 만들 수 있습니다(링크 공유). 대신 번들 권한을 사용합니다.
api_keys_count	api_keys_count	integer	이 사용자와 연결된 API 키 수
authenticate_until	authenticate_until	string	사용자를 비활성화할 예약된 날짜 또는 시간
authentication_method	authentication_method	string	이 사용자는 어떻게 인증됩니까?
avatar_url	avatar_url	string	사용자의 아바타를 보유하는 URL
청구	billable	boolean	청구 가능한 사용자 레코드인가요?
billing_permission	billing_permission	boolean	이 사용자가 계정, 결제 및 청구서에 대한 작업을 수행하도록 허용하시겠습니까?
bypass_site_allowed_ips	bypass_site_allowed_ips	boolean	이 사용자가 사이트 전체 IP 블랙리스트를 건너뛰도록 허용하시겠습니까?
bypass_user_lifecycle_rules	bypass_user_lifecycle_rules	boolean	사용자 수명 주기 규칙에서 이 사용자를 제외하시겠습니까?
생성_시간	created_at	string	이 사용자를 만든 경우
dav_permission	dav_permission	boolean	사용자가 WebDAV에 연결할 수 있나요?
사용 안 함	disabled	boolean	사용자가 사용하지 않도록 설정되어 있나요? 비활성화된 사용자는 로그인할 수 없으며 청구 용도로 계산되지 않습니다. 사용자는 사이트 설정을 통해 비활성 기간 후에 자동으로 비활성화되거나 특정 날짜 이후에 비활성화되도록 예약할 수 있습니다.
disabled_expired_or_inactive	disabled_expired_or_inactive	boolean	사용자가 비활성화되었거나 만료되었거나 비활성 상태인 경우 true를 반환하는 계산된 속성입니다.
메일 주소	email	string	사용자 전자 메일 주소
filesystem_layout	filesystem_layout	string	파일 시스템 레이아웃
first_login_at	first_login_at	string	사용자의 첫 번째 로그인 시간
ftp_permission	ftp_permission	boolean	사용자가 FTP 또는 FTPS를 사용하여 액세스할 수 있나요?
group_ids	group_ids	string	이 사용자가 멤버인 그룹 ID의 쉼표로 구분된 목록
header_text	header_text	string	UI 헤더에서 사용자에게 표시할 텍스트
language	language	string	기본 설정 언어
last_login_at	last_login_at	string	프로토콜을 통해 사용자의 가장 최근 로그인 시간
last_web_login_at	last_web_login_at	string	웹을 통한 사용자의 가장 최근 로그인 시간
last_ftp_login_at	last_ftp_login_at	string	FTP를 통한 사용자의 가장 최근 로그인 시간
last_sftp_login_at	last_sftp_login_at	string	SFTP를 통한 사용자의 가장 최근 로그인 시간
last_dav_login_at	last_dav_login_at	string	WebDAV를 통한 사용자의 가장 최근 로그인 시간
last_desktop_login_at	last_desktop_login_at	string	데스크톱 앱을 통한 사용자의 가장 최근 로그인 시간
last_restapi_login_at	last_restapi_login_at	string	Rest API를 통한 사용자의 가장 최근 로그인 시간
last_api_use_at	last_api_use_at	string	사용자의 최신 API 사용 시간
최근 활동 시간	last_active_at	string	가장 최근 로그인, 가장 최근 API 사용, 사용 또는 생성의 최신인 사용자의 가장 최근 활동 시간
last_protocol_cipher	last_protocol_cipher	string	사용된 최신 프로토콜 및 암호
lockout_expires	lockout_expires	string	해당하는 경우 사용자가 더 이상 잠기지 않을 시간입니다.
이름	name	string	사용자의 전체 이름
회사	company	string	사용자의 회사
메모	notes	string	사용자에 대한 모든 내부 메모
notification_daily_send_time	notification_daily_send_time	integer	매일 알림을 보내야 하는 시간. 0~23 범위일 수 있습니다.
office_integration_enabled	office_integration_enabled	boolean	웹용 Office와 통합을 사용하도록 설정하시겠습니까?
partner_admin	partner_admin	boolean	이 사용자가 파트너 관리자인가요?
partner_id	partner_id	integer	이 사용자가 파트너에 속한 경우 파트너 ID
partner_name	partner_name	string	이 사용자가 파트너에 속한 경우 파트너의 이름
password_set_at	password_set_at	string	사용자의 암호가 마지막으로 설정된 시간
password_validity_days	password_validity_days	integer	사용자가 동일한 암호를 사용할 수 있도록 허용하는 일 수입니다.
public_keys_count	public_keys_count	integer	이 사용자와 연결된 공개 키 수
receive_admin_alerts	receive_admin_alerts	boolean	사용자가 인증서 만료 알림 및 초과분과 같은 관리자 경고를 받아야 하나요?
require_2fa	require_2fa	string	2FA 필수 설정
require_login_by	require_login_by	string	사용자가 지정된 날짜까지 로그인하도록 요구합니다. 그렇지 않으면 사용하지 않도록 설정됩니다.
active_2fa	active_2fa	boolean	2fa가 사용자에 대해 활성화되어 있나요?
require_password_change	require_password_change	boolean	다음 사용자 로그인 시 암호 변경이 필요합니까?
password_expired	password_expired	boolean	사용자의 암호가 만료되었나요?
readonly_site_admin	readonly_site_admin	boolean	사용자가 이 사이트에 대한 모든(비대금 청구) 사이트 구성을 볼 수 있나요?
restapi_permission	restapi_permission	boolean	이 사용자가 웹앱, 데스크톱 앱, SDK 또는 REST API에 액세스할 수 있나요? (이러한 모든 도구는 내부적으로 API를 사용하므로 하나의 통합 권한 집합입니다.)
self_managed	self_managed	boolean	이 사용자가 자체 자격 증명을 관리하나요 아니면 공유 또는 봇 사용자인가요?
sftp_permission	sftp_permission	boolean	사용자가 SFTP를 사용하여 액세스할 수 있나요?
site_admin	site_admin	boolean	사용자가 이 사이트의 관리자인가요?
site_id	site_id	integer	사이트 아이디
skip_welcome_screen	skip_welcome_screen	boolean	UI에서 시작 페이지를 건너뛰시겠습니까?
ssl_required	ssl_required	string	SSL 필수 설정
sso_strategy_id	sso_strategy_id	integer	해당하는 경우 사용자의 SSO(Single Sign-On) 전략 ID입니다.
subscribe_to_newsletter	subscribe_to_newsletter	boolean	사용자가 뉴스레터를 구독하나요?
externally_managed	externally_managed	boolean	이 사용자는 SsoStrategy에서 관리되고 있나요?
tags	tags	string	이 사용자에 대한 태그의 쉼표로 구분된 목록입니다. 태그는 특정 태그를 대상으로 할 수 있는 UserLifecycleRules와 같은 다른 기능에 사용됩니다. 태그는 소문자, 숫자 및 하이픈만 포함해야 합니다.
시간대	time_zone	string	사용자 표준 시간대
type_of_2fa	type_of_2fa	string	프로그래밍 방식으로 사용하기 위해 사용 중인 2FA 메서드의 형식입니다. 사전emailyubiwebauthntotp순으로 정렬되고 밑줄로 조인된 여러 값 중 하나sms, 또는 여러 값이 됩니다. 사용자에게 지정된 메서드 중 하나 이상이 있는지 여부를 지정하지 않습니다.
type_of_2fa_for_display	type_of_2fa_for_display	string	사용 중인 2FA 메서드의 형식으로, UI에 표시하기 위해 형식이 지정됩니다. 이와 달리 type_of_2fa이 값은 사용자가 동일한 형식의 메서드를 1개 이상 사용하는 경우 명확하게 표시됩니다.
user_root	user_root	string	FTP의 루트 폴더입니다(적절한 사이트 전체 설정이 설정된 경우 선택적으로 SFTP). API, 데스크톱 또는 웹 인터페이스에는 사용되지 않습니다.
user_home	user_home	string	FTP 또는 SFTP의 홈 폴더입니다. API, 데스크톱 또는 웹 인터페이스에는 사용되지 않습니다.
days_remaining_until_password_expire	days_remaining_until_password_expire	integer	암호가 만료될 때까지 남은 일 수
password_expire_at	password_expire_at	string	암호 만료 날짜/시간

목록 공유 링크 받는 사람

작업 ID:

GetBundleRecipients

목록 공유 링크 받는 사람

매개 변수

Name	키	필수	형식	Description
번들 ID	bundle_id	True	integer	이 ID를 사용하여 번들에 대한 받는 사람을 나열합니다.

반환

Name	경로	형식	Description
		array of object
회사	company	string	받는 사람의 회사입니다.
이름	name	string	받는 사람의 이름입니다.
메모	note	string	번들로 받는 사람에게 보낸 메모입니다.
수령인	recipient	string	받는 사람의 이메일 주소입니다.
sent_at	sent_at	string	번들을 이 받는 사람과 공유한 경우

목록 그룹

작업 ID:

GetGroups

목록 그룹

반환

Name	경로	형식	Description
		array of object
아이디	id	integer	그룹 아이디
이름	name	string	그룹 이름
allowed_ips	allowed_ips	string	허용되는 IP 목록(해당하는 경우)입니다. 줄 새로 고리 구분
admin_ids	admin_ids	string	그룹 관리자인 사용자 ID의 쉼표로 구분된 목록(쉼표로 구분)
메모	notes	string	이 그룹에 대한 참고 사항
user_ids	user_ids	string	이 그룹에 속한 사용자 ID의 쉼표로 구분된 목록(쉼표로 구분)
usernames	usernames	string	이 그룹에 속한 쉼표로 구분된 사용자 이름 목록(쉼표로 구분)
ftp_permission	ftp_permission	boolean	true이면 이 그룹의 사용자가 FTP를 사용하여 로그인할 수 있습니다. 그러면 사용자 수준의 false 값이 재정의 ftp_permission 됩니다.
sftp_permission	sftp_permission	boolean	true이면 이 그룹의 사용자가 SFTP를 사용하여 로그인할 수 있습니다. 그러면 사용자 수준의 false 값이 재정의 sftp_permission 됩니다.
dav_permission	dav_permission	boolean	true이면 이 그룹의 사용자가 WebDAV를 사용하여 로그인할 수 있습니다. 그러면 사용자 수준의 false 값이 재정의 dav_permission 됩니다.
restapi_permission	restapi_permission	boolean	true이면 이 그룹의 사용자가 REST API를 사용하여 로그인할 수 있습니다. 그러면 사용자 수준의 false 값이 재정의 restapi_permission 됩니다.
site_id	site_id	integer	사이트 아이디

사용자 나열

작업 ID:

GetUsers

사용자 나열

반환

Name	경로	형식	Description
		array of object
아이디	id	integer	사용자 ID
사용자 이름	username	string	사용자의 사용자 이름
admin_group_ids	admin_group_ids	array of integer	이 사용자가 관리자인 그룹 ID 목록
allowed_ips	allowed_ips	string	허용되는 IP 목록(해당하는 경우)입니다. 줄 새로 고리 구분
attachments_permission	attachments_permission	boolean	이 경우 true사용자가 번들을 만들 수 있습니다(링크 공유). 대신 번들 권한을 사용합니다.
api_keys_count	api_keys_count	integer	이 사용자와 연결된 API 키 수
authenticate_until	authenticate_until	string	사용자를 비활성화할 예약된 날짜 또는 시간
authentication_method	authentication_method	string	이 사용자는 어떻게 인증됩니까?
avatar_url	avatar_url	string	사용자의 아바타를 보유하는 URL
청구	billable	boolean	청구 가능한 사용자 레코드인가요?
billing_permission	billing_permission	boolean	이 사용자가 계정, 결제 및 청구서에 대한 작업을 수행하도록 허용하시겠습니까?
bypass_site_allowed_ips	bypass_site_allowed_ips	boolean	이 사용자가 사이트 전체 IP 블랙리스트를 건너뛰도록 허용하시겠습니까?
bypass_user_lifecycle_rules	bypass_user_lifecycle_rules	boolean	사용자 수명 주기 규칙에서 이 사용자를 제외하시겠습니까?
생성_시간	created_at	string	이 사용자를 만든 경우
dav_permission	dav_permission	boolean	사용자가 WebDAV에 연결할 수 있나요?
사용 안 함	disabled	boolean	사용자가 사용하지 않도록 설정되어 있나요? 비활성화된 사용자는 로그인할 수 없으며 청구 용도로 계산되지 않습니다. 사용자는 사이트 설정을 통해 비활성 기간 후에 자동으로 비활성화되거나 특정 날짜 이후에 비활성화되도록 예약할 수 있습니다.
disabled_expired_or_inactive	disabled_expired_or_inactive	boolean	사용자가 비활성화되었거나 만료되었거나 비활성 상태인 경우 true를 반환하는 계산된 속성입니다.
메일 주소	email	string	사용자 전자 메일 주소
filesystem_layout	filesystem_layout	string	파일 시스템 레이아웃
first_login_at	first_login_at	string	사용자의 첫 번째 로그인 시간
ftp_permission	ftp_permission	boolean	사용자가 FTP 또는 FTPS를 사용하여 액세스할 수 있나요?
group_ids	group_ids	string	이 사용자가 멤버인 그룹 ID의 쉼표로 구분된 목록
header_text	header_text	string	UI 헤더에서 사용자에게 표시할 텍스트
language	language	string	기본 설정 언어
last_login_at	last_login_at	string	프로토콜을 통해 사용자의 가장 최근 로그인 시간
last_web_login_at	last_web_login_at	string	웹을 통한 사용자의 가장 최근 로그인 시간
last_ftp_login_at	last_ftp_login_at	string	FTP를 통한 사용자의 가장 최근 로그인 시간
last_sftp_login_at	last_sftp_login_at	string	SFTP를 통한 사용자의 가장 최근 로그인 시간
last_dav_login_at	last_dav_login_at	string	WebDAV를 통한 사용자의 가장 최근 로그인 시간
last_desktop_login_at	last_desktop_login_at	string	데스크톱 앱을 통한 사용자의 가장 최근 로그인 시간
last_restapi_login_at	last_restapi_login_at	string	Rest API를 통한 사용자의 가장 최근 로그인 시간
last_api_use_at	last_api_use_at	string	사용자의 최신 API 사용 시간
최근 활동 시간	last_active_at	string	가장 최근 로그인, 가장 최근 API 사용, 사용 또는 생성의 최신인 사용자의 가장 최근 활동 시간
last_protocol_cipher	last_protocol_cipher	string	사용된 최신 프로토콜 및 암호
lockout_expires	lockout_expires	string	해당하는 경우 사용자가 더 이상 잠기지 않을 시간입니다.
이름	name	string	사용자의 전체 이름
회사	company	string	사용자의 회사
메모	notes	string	사용자에 대한 모든 내부 메모
notification_daily_send_time	notification_daily_send_time	integer	매일 알림을 보내야 하는 시간. 0~23 범위일 수 있습니다.
office_integration_enabled	office_integration_enabled	boolean	웹용 Office와 통합을 사용하도록 설정하시겠습니까?
partner_admin	partner_admin	boolean	이 사용자가 파트너 관리자인가요?
partner_id	partner_id	integer	이 사용자가 파트너에 속한 경우 파트너 ID
partner_name	partner_name	string	이 사용자가 파트너에 속한 경우 파트너의 이름
password_set_at	password_set_at	string	사용자의 암호가 마지막으로 설정된 시간
password_validity_days	password_validity_days	integer	사용자가 동일한 암호를 사용할 수 있도록 허용하는 일 수입니다.
public_keys_count	public_keys_count	integer	이 사용자와 연결된 공개 키 수
receive_admin_alerts	receive_admin_alerts	boolean	사용자가 인증서 만료 알림 및 초과분과 같은 관리자 경고를 받아야 하나요?
require_2fa	require_2fa	string	2FA 필수 설정
require_login_by	require_login_by	string	사용자가 지정된 날짜까지 로그인하도록 요구합니다. 그렇지 않으면 사용하지 않도록 설정됩니다.
active_2fa	active_2fa	boolean	2fa가 사용자에 대해 활성화되어 있나요?
require_password_change	require_password_change	boolean	다음 사용자 로그인 시 암호 변경이 필요합니까?
password_expired	password_expired	boolean	사용자의 암호가 만료되었나요?
readonly_site_admin	readonly_site_admin	boolean	사용자가 이 사이트에 대한 모든(비대금 청구) 사이트 구성을 볼 수 있나요?
restapi_permission	restapi_permission	boolean	이 사용자가 웹앱, 데스크톱 앱, SDK 또는 REST API에 액세스할 수 있나요? (이러한 모든 도구는 내부적으로 API를 사용하므로 하나의 통합 권한 집합입니다.)
self_managed	self_managed	boolean	이 사용자가 자체 자격 증명을 관리하나요 아니면 공유 또는 봇 사용자인가요?
sftp_permission	sftp_permission	boolean	사용자가 SFTP를 사용하여 액세스할 수 있나요?
site_admin	site_admin	boolean	사용자가 이 사이트의 관리자인가요?
site_id	site_id	integer	사이트 아이디
skip_welcome_screen	skip_welcome_screen	boolean	UI에서 시작 페이지를 건너뛰시겠습니까?
ssl_required	ssl_required	string	SSL 필수 설정
sso_strategy_id	sso_strategy_id	integer	해당하는 경우 사용자의 SSO(Single Sign-On) 전략 ID입니다.
subscribe_to_newsletter	subscribe_to_newsletter	boolean	사용자가 뉴스레터를 구독하나요?
externally_managed	externally_managed	boolean	이 사용자는 SsoStrategy에서 관리되고 있나요?
tags	tags	string	이 사용자에 대한 태그의 쉼표로 구분된 목록입니다. 태그는 특정 태그를 대상으로 할 수 있는 UserLifecycleRules와 같은 다른 기능에 사용됩니다. 태그는 소문자, 숫자 및 하이픈만 포함해야 합니다.
시간대	time_zone	string	사용자 표준 시간대
type_of_2fa	type_of_2fa	string	프로그래밍 방식으로 사용하기 위해 사용 중인 2FA 메서드의 형식입니다. 사전emailyubiwebauthntotp순으로 정렬되고 밑줄로 조인된 여러 값 중 하나sms, 또는 여러 값이 됩니다. 사용자에게 지정된 메서드 중 하나 이상이 있는지 여부를 지정하지 않습니다.
type_of_2fa_for_display	type_of_2fa_for_display	string	사용 중인 2FA 메서드의 형식으로, UI에 표시하기 위해 형식이 지정됩니다. 이와 달리 type_of_2fa이 값은 사용자가 동일한 형식의 메서드를 1개 이상 사용하는 경우 명확하게 표시됩니다.
user_root	user_root	string	FTP의 루트 폴더입니다(적절한 사이트 전체 설정이 설정된 경우 선택적으로 SFTP). API, 데스크톱 또는 웹 인터페이스에는 사용되지 않습니다.
user_home	user_home	string	FTP 또는 SFTP의 홈 폴더입니다. API, 데스크톱 또는 웹 인터페이스에는 사용되지 않습니다.
days_remaining_until_password_expire	days_remaining_until_password_expire	integer	암호가 만료될 때까지 남은 일 수
password_expire_at	password_expire_at	string	암호 만료 날짜/시간

사용자 삭제

작업 ID:

DeleteUsersId

사용자 삭제

매개 변수

Name	키	필수	형식	Description
아이디	id	True	integer	사용자 ID.

사용자 생성

작업 ID:

PostUsers

사용자 생성

매개 변수

Name	키	필수	형식	Description
인증 방법	authentication_method		string	이 사용자는 어떻게 인증됩니까?
회사	company		string	사용자의 회사
전자 메일	email		string	사용자의 전자 메일입니다.
그룹 ID	group_ids		string	이 사용자를 연결할 그룹 ID 목록입니다. 쉼표로 구분됩니다.
이름	name		string	사용자의 전체 이름
비고	notes		string	사용자에 대한 모든 내부 메모
암호	password		string	사용자 암호입니다.
암호 변경 필요	require_password_change		boolean	다음 사용자 로그인 시 암호 변경이 필요합니까?
사용자 홈	user_home		string	FTP/SFTP의 홈 폴더입니다. API, 데스크톱 또는 웹 인터페이스에는 사용되지 않습니다.
사용자 루트	user_root		string	FTP의 루트 폴더입니다(적절한 사이트 전체 설정이 설정된 경우 선택적으로 SFTP). API, 데스크톱 또는 웹 인터페이스에는 사용되지 않습니다.
사용자 이름	username	True	string	사용자의 사용자 이름

반환

Name	경로	형식	Description
아이디	id	integer	사용자 ID
사용자 이름	username	string	사용자의 사용자 이름
admin_group_ids	admin_group_ids	array of integer	이 사용자가 관리자인 그룹 ID 목록
allowed_ips	allowed_ips	string	허용되는 IP 목록(해당하는 경우)입니다. 줄 새로 고리 구분
attachments_permission	attachments_permission	boolean	이 경우 true사용자가 번들을 만들 수 있습니다(링크 공유). 대신 번들 권한을 사용합니다.
api_keys_count	api_keys_count	integer	이 사용자와 연결된 API 키 수
authenticate_until	authenticate_until	string	사용자를 비활성화할 예약된 날짜 또는 시간
authentication_method	authentication_method	string	이 사용자는 어떻게 인증됩니까?
avatar_url	avatar_url	string	사용자의 아바타를 보유하는 URL
청구	billable	boolean	청구 가능한 사용자 레코드인가요?
billing_permission	billing_permission	boolean	이 사용자가 계정, 결제 및 청구서에 대한 작업을 수행하도록 허용하시겠습니까?
bypass_site_allowed_ips	bypass_site_allowed_ips	boolean	이 사용자가 사이트 전체 IP 블랙리스트를 건너뛰도록 허용하시겠습니까?
bypass_user_lifecycle_rules	bypass_user_lifecycle_rules	boolean	사용자 수명 주기 규칙에서 이 사용자를 제외하시겠습니까?
생성_시간	created_at	string	이 사용자를 만든 경우
dav_permission	dav_permission	boolean	사용자가 WebDAV에 연결할 수 있나요?
사용 안 함	disabled	boolean	사용자가 사용하지 않도록 설정되어 있나요? 비활성화된 사용자는 로그인할 수 없으며 청구 용도로 계산되지 않습니다. 사용자는 사이트 설정을 통해 비활성 기간 후에 자동으로 비활성화되거나 특정 날짜 이후에 비활성화되도록 예약할 수 있습니다.
disabled_expired_or_inactive	disabled_expired_or_inactive	boolean	사용자가 비활성화되었거나 만료되었거나 비활성 상태인 경우 true를 반환하는 계산된 속성입니다.
메일 주소	email	string	사용자 전자 메일 주소
filesystem_layout	filesystem_layout	string	파일 시스템 레이아웃
first_login_at	first_login_at	string	사용자의 첫 번째 로그인 시간
ftp_permission	ftp_permission	boolean	사용자가 FTP 또는 FTPS를 사용하여 액세스할 수 있나요?
group_ids	group_ids	string	이 사용자가 멤버인 그룹 ID의 쉼표로 구분된 목록
header_text	header_text	string	UI 헤더에서 사용자에게 표시할 텍스트
language	language	string	기본 설정 언어
last_login_at	last_login_at	string	프로토콜을 통해 사용자의 가장 최근 로그인 시간
last_web_login_at	last_web_login_at	string	웹을 통한 사용자의 가장 최근 로그인 시간
last_ftp_login_at	last_ftp_login_at	string	FTP를 통한 사용자의 가장 최근 로그인 시간
last_sftp_login_at	last_sftp_login_at	string	SFTP를 통한 사용자의 가장 최근 로그인 시간
last_dav_login_at	last_dav_login_at	string	WebDAV를 통한 사용자의 가장 최근 로그인 시간
last_desktop_login_at	last_desktop_login_at	string	데스크톱 앱을 통한 사용자의 가장 최근 로그인 시간
last_restapi_login_at	last_restapi_login_at	string	Rest API를 통한 사용자의 가장 최근 로그인 시간
last_api_use_at	last_api_use_at	string	사용자의 최신 API 사용 시간
최근 활동 시간	last_active_at	string	가장 최근 로그인, 가장 최근 API 사용, 사용 또는 생성의 최신인 사용자의 가장 최근 활동 시간
last_protocol_cipher	last_protocol_cipher	string	사용된 최신 프로토콜 및 암호
lockout_expires	lockout_expires	string	해당하는 경우 사용자가 더 이상 잠기지 않을 시간입니다.
이름	name	string	사용자의 전체 이름
회사	company	string	사용자의 회사
메모	notes	string	사용자에 대한 모든 내부 메모
notification_daily_send_time	notification_daily_send_time	integer	매일 알림을 보내야 하는 시간. 0~23 범위일 수 있습니다.
office_integration_enabled	office_integration_enabled	boolean	웹용 Office와 통합을 사용하도록 설정하시겠습니까?
partner_admin	partner_admin	boolean	이 사용자가 파트너 관리자인가요?
partner_id	partner_id	integer	이 사용자가 파트너에 속한 경우 파트너 ID
partner_name	partner_name	string	이 사용자가 파트너에 속한 경우 파트너의 이름
password_set_at	password_set_at	string	사용자의 암호가 마지막으로 설정된 시간
password_validity_days	password_validity_days	integer	사용자가 동일한 암호를 사용할 수 있도록 허용하는 일 수입니다.
public_keys_count	public_keys_count	integer	이 사용자와 연결된 공개 키 수
receive_admin_alerts	receive_admin_alerts	boolean	사용자가 인증서 만료 알림 및 초과분과 같은 관리자 경고를 받아야 하나요?
require_2fa	require_2fa	string	2FA 필수 설정
require_login_by	require_login_by	string	사용자가 지정된 날짜까지 로그인하도록 요구합니다. 그렇지 않으면 사용하지 않도록 설정됩니다.
active_2fa	active_2fa	boolean	2fa가 사용자에 대해 활성화되어 있나요?
require_password_change	require_password_change	boolean	다음 사용자 로그인 시 암호 변경이 필요합니까?
password_expired	password_expired	boolean	사용자의 암호가 만료되었나요?
readonly_site_admin	readonly_site_admin	boolean	사용자가 이 사이트에 대한 모든(비대금 청구) 사이트 구성을 볼 수 있나요?
restapi_permission	restapi_permission	boolean	이 사용자가 웹앱, 데스크톱 앱, SDK 또는 REST API에 액세스할 수 있나요? (이러한 모든 도구는 내부적으로 API를 사용하므로 하나의 통합 권한 집합입니다.)
self_managed	self_managed	boolean	이 사용자가 자체 자격 증명을 관리하나요 아니면 공유 또는 봇 사용자인가요?
sftp_permission	sftp_permission	boolean	사용자가 SFTP를 사용하여 액세스할 수 있나요?
site_admin	site_admin	boolean	사용자가 이 사이트의 관리자인가요?
site_id	site_id	integer	사이트 아이디
skip_welcome_screen	skip_welcome_screen	boolean	UI에서 시작 페이지를 건너뛰시겠습니까?
ssl_required	ssl_required	string	SSL 필수 설정
sso_strategy_id	sso_strategy_id	integer	해당하는 경우 사용자의 SSO(Single Sign-On) 전략 ID입니다.
subscribe_to_newsletter	subscribe_to_newsletter	boolean	사용자가 뉴스레터를 구독하나요?
externally_managed	externally_managed	boolean	이 사용자는 SsoStrategy에서 관리되고 있나요?
tags	tags	string	이 사용자에 대한 태그의 쉼표로 구분된 목록입니다. 태그는 특정 태그를 대상으로 할 수 있는 UserLifecycleRules와 같은 다른 기능에 사용됩니다. 태그는 소문자, 숫자 및 하이픈만 포함해야 합니다.
시간대	time_zone	string	사용자 표준 시간대
type_of_2fa	type_of_2fa	string	프로그래밍 방식으로 사용하기 위해 사용 중인 2FA 메서드의 형식입니다. 사전emailyubiwebauthntotp순으로 정렬되고 밑줄로 조인된 여러 값 중 하나sms, 또는 여러 값이 됩니다. 사용자에게 지정된 메서드 중 하나 이상이 있는지 여부를 지정하지 않습니다.
type_of_2fa_for_display	type_of_2fa_for_display	string	사용 중인 2FA 메서드의 형식으로, UI에 표시하기 위해 형식이 지정됩니다. 이와 달리 type_of_2fa이 값은 사용자가 동일한 형식의 메서드를 1개 이상 사용하는 경우 명확하게 표시됩니다.
user_root	user_root	string	FTP의 루트 폴더입니다(적절한 사이트 전체 설정이 설정된 경우 선택적으로 SFTP). API, 데스크톱 또는 웹 인터페이스에는 사용되지 않습니다.
user_home	user_home	string	FTP 또는 SFTP의 홈 폴더입니다. API, 데스크톱 또는 웹 인터페이스에는 사용되지 않습니다.
days_remaining_until_password_expire	days_remaining_until_password_expire	integer	암호가 만료될 때까지 남은 일 수
password_expire_at	password_expire_at	string	암호 만료 날짜/시간

사용자 업데이트

작업 ID:

PatchUser

사용자 업데이트

매개 변수

Name	키	필수	형식	Description
인증 방법	authentication_method		string	이 사용자는 어떻게 인증됩니까?
회사	company		string	사용자의 회사
전자 메일	email		string	사용자의 전자 메일입니다.
그룹 ID	group_ids		string	이 사용자를 연결할 그룹 ID 목록입니다. 쉼표로 구분됩니다.
이름	name		string	사용자의 전체 이름
비고	notes		string	사용자에 대한 모든 내부 메모
암호	password		string	사용자 암호입니다.
암호 변경 필요	require_password_change		boolean	다음 사용자 로그인 시 암호 변경이 필요합니까?
사용자 홈	user_home		string	FTP/SFTP의 홈 폴더입니다. API, 데스크톱 또는 웹 인터페이스에는 사용되지 않습니다.
사용자 루트	user_root		string	FTP의 루트 폴더입니다(적절한 사이트 전체 설정이 설정된 경우 선택적으로 SFTP). API, 데스크톱 또는 웹 인터페이스에는 사용되지 않습니다.
사용자 이름	username		string	사용자의 사용자 이름

반환

Name	경로	형식	Description
아이디	id	integer	사용자 ID
사용자 이름	username	string	사용자의 사용자 이름
admin_group_ids	admin_group_ids	array of integer	이 사용자가 관리자인 그룹 ID 목록
allowed_ips	allowed_ips	string	허용되는 IP 목록(해당하는 경우)입니다. 줄 새로 고리 구분
attachments_permission	attachments_permission	boolean	이 경우 true사용자가 번들을 만들 수 있습니다(링크 공유). 대신 번들 권한을 사용합니다.
api_keys_count	api_keys_count	integer	이 사용자와 연결된 API 키 수
authenticate_until	authenticate_until	string	사용자를 비활성화할 예약된 날짜 또는 시간
authentication_method	authentication_method	string	이 사용자는 어떻게 인증됩니까?
avatar_url	avatar_url	string	사용자의 아바타를 보유하는 URL
청구	billable	boolean	청구 가능한 사용자 레코드인가요?
billing_permission	billing_permission	boolean	이 사용자가 계정, 결제 및 청구서에 대한 작업을 수행하도록 허용하시겠습니까?
bypass_site_allowed_ips	bypass_site_allowed_ips	boolean	이 사용자가 사이트 전체 IP 블랙리스트를 건너뛰도록 허용하시겠습니까?
bypass_user_lifecycle_rules	bypass_user_lifecycle_rules	boolean	사용자 수명 주기 규칙에서 이 사용자를 제외하시겠습니까?
생성_시간	created_at	string	이 사용자를 만든 경우
dav_permission	dav_permission	boolean	사용자가 WebDAV에 연결할 수 있나요?
사용 안 함	disabled	boolean	사용자가 사용하지 않도록 설정되어 있나요? 비활성화된 사용자는 로그인할 수 없으며 청구 용도로 계산되지 않습니다. 사용자는 사이트 설정을 통해 비활성 기간 후에 자동으로 비활성화되거나 특정 날짜 이후에 비활성화되도록 예약할 수 있습니다.
disabled_expired_or_inactive	disabled_expired_or_inactive	boolean	사용자가 비활성화되었거나 만료되었거나 비활성 상태인 경우 true를 반환하는 계산된 속성입니다.
메일 주소	email	string	사용자 전자 메일 주소
filesystem_layout	filesystem_layout	string	파일 시스템 레이아웃
first_login_at	first_login_at	string	사용자의 첫 번째 로그인 시간
ftp_permission	ftp_permission	boolean	사용자가 FTP 또는 FTPS를 사용하여 액세스할 수 있나요?
group_ids	group_ids	string	이 사용자가 멤버인 그룹 ID의 쉼표로 구분된 목록
header_text	header_text	string	UI 헤더에서 사용자에게 표시할 텍스트
language	language	string	기본 설정 언어
last_login_at	last_login_at	string	프로토콜을 통해 사용자의 가장 최근 로그인 시간
last_web_login_at	last_web_login_at	string	웹을 통한 사용자의 가장 최근 로그인 시간
last_ftp_login_at	last_ftp_login_at	string	FTP를 통한 사용자의 가장 최근 로그인 시간
last_sftp_login_at	last_sftp_login_at	string	SFTP를 통한 사용자의 가장 최근 로그인 시간
last_dav_login_at	last_dav_login_at	string	WebDAV를 통한 사용자의 가장 최근 로그인 시간
last_desktop_login_at	last_desktop_login_at	string	데스크톱 앱을 통한 사용자의 가장 최근 로그인 시간
last_restapi_login_at	last_restapi_login_at	string	Rest API를 통한 사용자의 가장 최근 로그인 시간
last_api_use_at	last_api_use_at	string	사용자의 최신 API 사용 시간
최근 활동 시간	last_active_at	string	가장 최근 로그인, 가장 최근 API 사용, 사용 또는 생성의 최신인 사용자의 가장 최근 활동 시간
last_protocol_cipher	last_protocol_cipher	string	사용된 최신 프로토콜 및 암호
lockout_expires	lockout_expires	string	해당하는 경우 사용자가 더 이상 잠기지 않을 시간입니다.
이름	name	string	사용자의 전체 이름
회사	company	string	사용자의 회사
메모	notes	string	사용자에 대한 모든 내부 메모
notification_daily_send_time	notification_daily_send_time	integer	매일 알림을 보내야 하는 시간. 0~23 범위일 수 있습니다.
office_integration_enabled	office_integration_enabled	boolean	웹용 Office와 통합을 사용하도록 설정하시겠습니까?
partner_admin	partner_admin	boolean	이 사용자가 파트너 관리자인가요?
partner_id	partner_id	integer	이 사용자가 파트너에 속한 경우 파트너 ID
partner_name	partner_name	string	이 사용자가 파트너에 속한 경우 파트너의 이름
password_set_at	password_set_at	string	사용자의 암호가 마지막으로 설정된 시간
password_validity_days	password_validity_days	integer	사용자가 동일한 암호를 사용할 수 있도록 허용하는 일 수입니다.
public_keys_count	public_keys_count	integer	이 사용자와 연결된 공개 키 수
receive_admin_alerts	receive_admin_alerts	boolean	사용자가 인증서 만료 알림 및 초과분과 같은 관리자 경고를 받아야 하나요?
require_2fa	require_2fa	string	2FA 필수 설정
require_login_by	require_login_by	string	사용자가 지정된 날짜까지 로그인하도록 요구합니다. 그렇지 않으면 사용하지 않도록 설정됩니다.
active_2fa	active_2fa	boolean	2fa가 사용자에 대해 활성화되어 있나요?
require_password_change	require_password_change	boolean	다음 사용자 로그인 시 암호 변경이 필요합니까?
password_expired	password_expired	boolean	사용자의 암호가 만료되었나요?
readonly_site_admin	readonly_site_admin	boolean	사용자가 이 사이트에 대한 모든(비대금 청구) 사이트 구성을 볼 수 있나요?
restapi_permission	restapi_permission	boolean	이 사용자가 웹앱, 데스크톱 앱, SDK 또는 REST API에 액세스할 수 있나요? (이러한 모든 도구는 내부적으로 API를 사용하므로 하나의 통합 권한 집합입니다.)
self_managed	self_managed	boolean	이 사용자가 자체 자격 증명을 관리하나요 아니면 공유 또는 봇 사용자인가요?
sftp_permission	sftp_permission	boolean	사용자가 SFTP를 사용하여 액세스할 수 있나요?
site_admin	site_admin	boolean	사용자가 이 사이트의 관리자인가요?
site_id	site_id	integer	사이트 아이디
skip_welcome_screen	skip_welcome_screen	boolean	UI에서 시작 페이지를 건너뛰시겠습니까?
ssl_required	ssl_required	string	SSL 필수 설정
sso_strategy_id	sso_strategy_id	integer	해당하는 경우 사용자의 SSO(Single Sign-On) 전략 ID입니다.
subscribe_to_newsletter	subscribe_to_newsletter	boolean	사용자가 뉴스레터를 구독하나요?
externally_managed	externally_managed	boolean	이 사용자는 SsoStrategy에서 관리되고 있나요?
tags	tags	string	이 사용자에 대한 태그의 쉼표로 구분된 목록입니다. 태그는 특정 태그를 대상으로 할 수 있는 UserLifecycleRules와 같은 다른 기능에 사용됩니다. 태그는 소문자, 숫자 및 하이픈만 포함해야 합니다.
시간대	time_zone	string	사용자 표준 시간대
type_of_2fa	type_of_2fa	string	프로그래밍 방식으로 사용하기 위해 사용 중인 2FA 메서드의 형식입니다. 사전emailyubiwebauthntotp순으로 정렬되고 밑줄로 조인된 여러 값 중 하나sms, 또는 여러 값이 됩니다. 사용자에게 지정된 메서드 중 하나 이상이 있는지 여부를 지정하지 않습니다.
type_of_2fa_for_display	type_of_2fa_for_display	string	사용 중인 2FA 메서드의 형식으로, UI에 표시하기 위해 형식이 지정됩니다. 이와 달리 type_of_2fa이 값은 사용자가 동일한 형식의 메서드를 1개 이상 사용하는 경우 명확하게 표시됩니다.
user_root	user_root	string	FTP의 루트 폴더입니다(적절한 사이트 전체 설정이 설정된 경우 선택적으로 SFTP). API, 데스크톱 또는 웹 인터페이스에는 사용되지 않습니다.
user_home	user_home	string	FTP 또는 SFTP의 홈 폴더입니다. API, 데스크톱 또는 웹 인터페이스에는 사용되지 않습니다.
days_remaining_until_password_expire	days_remaining_until_password_expire	integer	암호가 만료될 때까지 남은 일 수
password_expire_at	password_expire_at	string	암호 만료 날짜/시간

사용자 업데이트

작업 ID:

PatchUsersId

사용자 업데이트

매개 변수

Name	키	필수	형식	Description
아이디	id	True	integer	사용자 ID.
인증 방법	authentication_method		string	이 사용자는 어떻게 인증됩니까?
회사	company		string	사용자의 회사
전자 메일	email		string	사용자의 전자 메일입니다.
그룹 ID	group_ids		string	이 사용자를 연결할 그룹 ID 목록입니다. 쉼표로 구분됩니다.
이름	name		string	사용자의 전체 이름
비고	notes		string	사용자에 대한 모든 내부 메모
암호	password		string	사용자 암호입니다.
암호 변경 필요	require_password_change		boolean	다음 사용자 로그인 시 암호 변경이 필요합니까?
사용자 홈	user_home		string	FTP/SFTP의 홈 폴더입니다. API, 데스크톱 또는 웹 인터페이스에는 사용되지 않습니다.
사용자 루트	user_root		string	FTP의 루트 폴더입니다(적절한 사이트 전체 설정이 설정된 경우 선택적으로 SFTP). API, 데스크톱 또는 웹 인터페이스에는 사용되지 않습니다.
사용자 이름	username		string	사용자의 사용자 이름

반환

Name	경로	형식	Description
아이디	id	integer	사용자 ID
사용자 이름	username	string	사용자의 사용자 이름
admin_group_ids	admin_group_ids	array of integer	이 사용자가 관리자인 그룹 ID 목록
allowed_ips	allowed_ips	string	허용되는 IP 목록(해당하는 경우)입니다. 줄 새로 고리 구분
attachments_permission	attachments_permission	boolean	이 경우 true사용자가 번들을 만들 수 있습니다(링크 공유). 대신 번들 권한을 사용합니다.
api_keys_count	api_keys_count	integer	이 사용자와 연결된 API 키 수
authenticate_until	authenticate_until	string	사용자를 비활성화할 예약된 날짜 또는 시간
authentication_method	authentication_method	string	이 사용자는 어떻게 인증됩니까?
avatar_url	avatar_url	string	사용자의 아바타를 보유하는 URL
청구	billable	boolean	청구 가능한 사용자 레코드인가요?
billing_permission	billing_permission	boolean	이 사용자가 계정, 결제 및 청구서에 대한 작업을 수행하도록 허용하시겠습니까?
bypass_site_allowed_ips	bypass_site_allowed_ips	boolean	이 사용자가 사이트 전체 IP 블랙리스트를 건너뛰도록 허용하시겠습니까?
bypass_user_lifecycle_rules	bypass_user_lifecycle_rules	boolean	사용자 수명 주기 규칙에서 이 사용자를 제외하시겠습니까?
생성_시간	created_at	string	이 사용자를 만든 경우
dav_permission	dav_permission	boolean	사용자가 WebDAV에 연결할 수 있나요?
사용 안 함	disabled	boolean	사용자가 사용하지 않도록 설정되어 있나요? 비활성화된 사용자는 로그인할 수 없으며 청구 용도로 계산되지 않습니다. 사용자는 사이트 설정을 통해 비활성 기간 후에 자동으로 비활성화되거나 특정 날짜 이후에 비활성화되도록 예약할 수 있습니다.
disabled_expired_or_inactive	disabled_expired_or_inactive	boolean	사용자가 비활성화되었거나 만료되었거나 비활성 상태인 경우 true를 반환하는 계산된 속성입니다.
메일 주소	email	string	사용자 전자 메일 주소
filesystem_layout	filesystem_layout	string	파일 시스템 레이아웃
first_login_at	first_login_at	string	사용자의 첫 번째 로그인 시간
ftp_permission	ftp_permission	boolean	사용자가 FTP 또는 FTPS를 사용하여 액세스할 수 있나요?
group_ids	group_ids	string	이 사용자가 멤버인 그룹 ID의 쉼표로 구분된 목록
header_text	header_text	string	UI 헤더에서 사용자에게 표시할 텍스트
language	language	string	기본 설정 언어
last_login_at	last_login_at	string	프로토콜을 통해 사용자의 가장 최근 로그인 시간
last_web_login_at	last_web_login_at	string	웹을 통한 사용자의 가장 최근 로그인 시간
last_ftp_login_at	last_ftp_login_at	string	FTP를 통한 사용자의 가장 최근 로그인 시간
last_sftp_login_at	last_sftp_login_at	string	SFTP를 통한 사용자의 가장 최근 로그인 시간
last_dav_login_at	last_dav_login_at	string	WebDAV를 통한 사용자의 가장 최근 로그인 시간
last_desktop_login_at	last_desktop_login_at	string	데스크톱 앱을 통한 사용자의 가장 최근 로그인 시간
last_restapi_login_at	last_restapi_login_at	string	Rest API를 통한 사용자의 가장 최근 로그인 시간
last_api_use_at	last_api_use_at	string	사용자의 최신 API 사용 시간
최근 활동 시간	last_active_at	string	가장 최근 로그인, 가장 최근 API 사용, 사용 또는 생성의 최신인 사용자의 가장 최근 활동 시간
last_protocol_cipher	last_protocol_cipher	string	사용된 최신 프로토콜 및 암호
lockout_expires	lockout_expires	string	해당하는 경우 사용자가 더 이상 잠기지 않을 시간입니다.
이름	name	string	사용자의 전체 이름
회사	company	string	사용자의 회사
메모	notes	string	사용자에 대한 모든 내부 메모
notification_daily_send_time	notification_daily_send_time	integer	매일 알림을 보내야 하는 시간. 0~23 범위일 수 있습니다.
office_integration_enabled	office_integration_enabled	boolean	웹용 Office와 통합을 사용하도록 설정하시겠습니까?
partner_admin	partner_admin	boolean	이 사용자가 파트너 관리자인가요?
partner_id	partner_id	integer	이 사용자가 파트너에 속한 경우 파트너 ID
partner_name	partner_name	string	이 사용자가 파트너에 속한 경우 파트너의 이름
password_set_at	password_set_at	string	사용자의 암호가 마지막으로 설정된 시간
password_validity_days	password_validity_days	integer	사용자가 동일한 암호를 사용할 수 있도록 허용하는 일 수입니다.
public_keys_count	public_keys_count	integer	이 사용자와 연결된 공개 키 수
receive_admin_alerts	receive_admin_alerts	boolean	사용자가 인증서 만료 알림 및 초과분과 같은 관리자 경고를 받아야 하나요?
require_2fa	require_2fa	string	2FA 필수 설정
require_login_by	require_login_by	string	사용자가 지정된 날짜까지 로그인하도록 요구합니다. 그렇지 않으면 사용하지 않도록 설정됩니다.
active_2fa	active_2fa	boolean	2fa가 사용자에 대해 활성화되어 있나요?
require_password_change	require_password_change	boolean	다음 사용자 로그인 시 암호 변경이 필요합니까?
password_expired	password_expired	boolean	사용자의 암호가 만료되었나요?
readonly_site_admin	readonly_site_admin	boolean	사용자가 이 사이트에 대한 모든(비대금 청구) 사이트 구성을 볼 수 있나요?
restapi_permission	restapi_permission	boolean	이 사용자가 웹앱, 데스크톱 앱, SDK 또는 REST API에 액세스할 수 있나요? (이러한 모든 도구는 내부적으로 API를 사용하므로 하나의 통합 권한 집합입니다.)
self_managed	self_managed	boolean	이 사용자가 자체 자격 증명을 관리하나요 아니면 공유 또는 봇 사용자인가요?
sftp_permission	sftp_permission	boolean	사용자가 SFTP를 사용하여 액세스할 수 있나요?
site_admin	site_admin	boolean	사용자가 이 사이트의 관리자인가요?
site_id	site_id	integer	사이트 아이디
skip_welcome_screen	skip_welcome_screen	boolean	UI에서 시작 페이지를 건너뛰시겠습니까?
ssl_required	ssl_required	string	SSL 필수 설정
sso_strategy_id	sso_strategy_id	integer	해당하는 경우 사용자의 SSO(Single Sign-On) 전략 ID입니다.
subscribe_to_newsletter	subscribe_to_newsletter	boolean	사용자가 뉴스레터를 구독하나요?
externally_managed	externally_managed	boolean	이 사용자는 SsoStrategy에서 관리되고 있나요?
tags	tags	string	이 사용자에 대한 태그의 쉼표로 구분된 목록입니다. 태그는 특정 태그를 대상으로 할 수 있는 UserLifecycleRules와 같은 다른 기능에 사용됩니다. 태그는 소문자, 숫자 및 하이픈만 포함해야 합니다.
시간대	time_zone	string	사용자 표준 시간대
type_of_2fa	type_of_2fa	string	프로그래밍 방식으로 사용하기 위해 사용 중인 2FA 메서드의 형식입니다. 사전emailyubiwebauthntotp순으로 정렬되고 밑줄로 조인된 여러 값 중 하나sms, 또는 여러 값이 됩니다. 사용자에게 지정된 메서드 중 하나 이상이 있는지 여부를 지정하지 않습니다.
type_of_2fa_for_display	type_of_2fa_for_display	string	사용 중인 2FA 메서드의 형식으로, UI에 표시하기 위해 형식이 지정됩니다. 이와 달리 type_of_2fa이 값은 사용자가 동일한 형식의 메서드를 1개 이상 사용하는 경우 명확하게 표시됩니다.
user_root	user_root	string	FTP의 루트 폴더입니다(적절한 사이트 전체 설정이 설정된 경우 선택적으로 SFTP). API, 데스크톱 또는 웹 인터페이스에는 사용되지 않습니다.
user_home	user_home	string	FTP 또는 SFTP의 홈 폴더입니다. API, 데스크톱 또는 웹 인터페이스에는 사용되지 않습니다.
days_remaining_until_password_expire	days_remaining_until_password_expire	integer	암호가 만료될 때까지 남은 일 수
password_expire_at	password_expire_at	string	암호 만료 날짜/시간

사용자 표시

작업 ID:

GetUsersId

사용자 표시

매개 변수

Name	키	필수	형식	Description
아이디	id	True	integer	사용자 ID.

반환

Name	경로	형식	Description
아이디	id	integer	사용자 ID
사용자 이름	username	string	사용자의 사용자 이름
admin_group_ids	admin_group_ids	array of integer	이 사용자가 관리자인 그룹 ID 목록
allowed_ips	allowed_ips	string	허용되는 IP 목록(해당하는 경우)입니다. 줄 새로 고리 구분
attachments_permission	attachments_permission	boolean	이 경우 true사용자가 번들을 만들 수 있습니다(링크 공유). 대신 번들 권한을 사용합니다.
api_keys_count	api_keys_count	integer	이 사용자와 연결된 API 키 수
authenticate_until	authenticate_until	string	사용자를 비활성화할 예약된 날짜 또는 시간
authentication_method	authentication_method	string	이 사용자는 어떻게 인증됩니까?
avatar_url	avatar_url	string	사용자의 아바타를 보유하는 URL
청구	billable	boolean	청구 가능한 사용자 레코드인가요?
billing_permission	billing_permission	boolean	이 사용자가 계정, 결제 및 청구서에 대한 작업을 수행하도록 허용하시겠습니까?
bypass_site_allowed_ips	bypass_site_allowed_ips	boolean	이 사용자가 사이트 전체 IP 블랙리스트를 건너뛰도록 허용하시겠습니까?
bypass_user_lifecycle_rules	bypass_user_lifecycle_rules	boolean	사용자 수명 주기 규칙에서 이 사용자를 제외하시겠습니까?
생성_시간	created_at	string	이 사용자를 만든 경우
dav_permission	dav_permission	boolean	사용자가 WebDAV에 연결할 수 있나요?
사용 안 함	disabled	boolean	사용자가 사용하지 않도록 설정되어 있나요? 비활성화된 사용자는 로그인할 수 없으며 청구 용도로 계산되지 않습니다. 사용자는 사이트 설정을 통해 비활성 기간 후에 자동으로 비활성화되거나 특정 날짜 이후에 비활성화되도록 예약할 수 있습니다.
disabled_expired_or_inactive	disabled_expired_or_inactive	boolean	사용자가 비활성화되었거나 만료되었거나 비활성 상태인 경우 true를 반환하는 계산된 속성입니다.
메일 주소	email	string	사용자 전자 메일 주소
filesystem_layout	filesystem_layout	string	파일 시스템 레이아웃
first_login_at	first_login_at	string	사용자의 첫 번째 로그인 시간
ftp_permission	ftp_permission	boolean	사용자가 FTP 또는 FTPS를 사용하여 액세스할 수 있나요?
group_ids	group_ids	string	이 사용자가 멤버인 그룹 ID의 쉼표로 구분된 목록
header_text	header_text	string	UI 헤더에서 사용자에게 표시할 텍스트
language	language	string	기본 설정 언어
last_login_at	last_login_at	string	프로토콜을 통해 사용자의 가장 최근 로그인 시간
last_web_login_at	last_web_login_at	string	웹을 통한 사용자의 가장 최근 로그인 시간
last_ftp_login_at	last_ftp_login_at	string	FTP를 통한 사용자의 가장 최근 로그인 시간
last_sftp_login_at	last_sftp_login_at	string	SFTP를 통한 사용자의 가장 최근 로그인 시간
last_dav_login_at	last_dav_login_at	string	WebDAV를 통한 사용자의 가장 최근 로그인 시간
last_desktop_login_at	last_desktop_login_at	string	데스크톱 앱을 통한 사용자의 가장 최근 로그인 시간
last_restapi_login_at	last_restapi_login_at	string	Rest API를 통한 사용자의 가장 최근 로그인 시간
last_api_use_at	last_api_use_at	string	사용자의 최신 API 사용 시간
최근 활동 시간	last_active_at	string	가장 최근 로그인, 가장 최근 API 사용, 사용 또는 생성의 최신인 사용자의 가장 최근 활동 시간
last_protocol_cipher	last_protocol_cipher	string	사용된 최신 프로토콜 및 암호
lockout_expires	lockout_expires	string	해당하는 경우 사용자가 더 이상 잠기지 않을 시간입니다.
이름	name	string	사용자의 전체 이름
회사	company	string	사용자의 회사
메모	notes	string	사용자에 대한 모든 내부 메모
notification_daily_send_time	notification_daily_send_time	integer	매일 알림을 보내야 하는 시간. 0~23 범위일 수 있습니다.
office_integration_enabled	office_integration_enabled	boolean	웹용 Office와 통합을 사용하도록 설정하시겠습니까?
partner_admin	partner_admin	boolean	이 사용자가 파트너 관리자인가요?
partner_id	partner_id	integer	이 사용자가 파트너에 속한 경우 파트너 ID
partner_name	partner_name	string	이 사용자가 파트너에 속한 경우 파트너의 이름
password_set_at	password_set_at	string	사용자의 암호가 마지막으로 설정된 시간
password_validity_days	password_validity_days	integer	사용자가 동일한 암호를 사용할 수 있도록 허용하는 일 수입니다.
public_keys_count	public_keys_count	integer	이 사용자와 연결된 공개 키 수
receive_admin_alerts	receive_admin_alerts	boolean	사용자가 인증서 만료 알림 및 초과분과 같은 관리자 경고를 받아야 하나요?
require_2fa	require_2fa	string	2FA 필수 설정
require_login_by	require_login_by	string	사용자가 지정된 날짜까지 로그인하도록 요구합니다. 그렇지 않으면 사용하지 않도록 설정됩니다.
active_2fa	active_2fa	boolean	2fa가 사용자에 대해 활성화되어 있나요?
require_password_change	require_password_change	boolean	다음 사용자 로그인 시 암호 변경이 필요합니까?
password_expired	password_expired	boolean	사용자의 암호가 만료되었나요?
readonly_site_admin	readonly_site_admin	boolean	사용자가 이 사이트에 대한 모든(비대금 청구) 사이트 구성을 볼 수 있나요?
restapi_permission	restapi_permission	boolean	이 사용자가 웹앱, 데스크톱 앱, SDK 또는 REST API에 액세스할 수 있나요? (이러한 모든 도구는 내부적으로 API를 사용하므로 하나의 통합 권한 집합입니다.)
self_managed	self_managed	boolean	이 사용자가 자체 자격 증명을 관리하나요 아니면 공유 또는 봇 사용자인가요?
sftp_permission	sftp_permission	boolean	사용자가 SFTP를 사용하여 액세스할 수 있나요?
site_admin	site_admin	boolean	사용자가 이 사이트의 관리자인가요?
site_id	site_id	integer	사이트 아이디
skip_welcome_screen	skip_welcome_screen	boolean	UI에서 시작 페이지를 건너뛰시겠습니까?
ssl_required	ssl_required	string	SSL 필수 설정
sso_strategy_id	sso_strategy_id	integer	해당하는 경우 사용자의 SSO(Single Sign-On) 전략 ID입니다.
subscribe_to_newsletter	subscribe_to_newsletter	boolean	사용자가 뉴스레터를 구독하나요?
externally_managed	externally_managed	boolean	이 사용자는 SsoStrategy에서 관리되고 있나요?
tags	tags	string	이 사용자에 대한 태그의 쉼표로 구분된 목록입니다. 태그는 특정 태그를 대상으로 할 수 있는 UserLifecycleRules와 같은 다른 기능에 사용됩니다. 태그는 소문자, 숫자 및 하이픈만 포함해야 합니다.
시간대	time_zone	string	사용자 표준 시간대
type_of_2fa	type_of_2fa	string	프로그래밍 방식으로 사용하기 위해 사용 중인 2FA 메서드의 형식입니다. 사전emailyubiwebauthntotp순으로 정렬되고 밑줄로 조인된 여러 값 중 하나sms, 또는 여러 값이 됩니다. 사용자에게 지정된 메서드 중 하나 이상이 있는지 여부를 지정하지 않습니다.
type_of_2fa_for_display	type_of_2fa_for_display	string	사용 중인 2FA 메서드의 형식으로, UI에 표시하기 위해 형식이 지정됩니다. 이와 달리 type_of_2fa이 값은 사용자가 동일한 형식의 메서드를 1개 이상 사용하는 경우 명확하게 표시됩니다.
user_root	user_root	string	FTP의 루트 폴더입니다(적절한 사이트 전체 설정이 설정된 경우 선택적으로 SFTP). API, 데스크톱 또는 웹 인터페이스에는 사용되지 않습니다.
user_home	user_home	string	FTP 또는 SFTP의 홈 폴더입니다. API, 데스크톱 또는 웹 인터페이스에는 사용되지 않습니다.
days_remaining_until_password_expire	days_remaining_until_password_expire	integer	암호가 만료될 때까지 남은 일 수
password_expire_at	password_expire_at	string	암호 만료 날짜/시간

파일 다운로드

작업 ID:

DownloadFile

파일 다운로드

매개 변수

Name	키	필수	형식	Description
경로	path	True	string	작동할 경로입니다.

반환

파일 콘텐츠

binary

파일 또는 폴더 복사

작업 ID:

FileActionCopy

파일 또는 폴더 복사

매개 변수

Name	키	필수	형식	Description
경로	path	True	string	작동할 경로입니다.
목적지	destination	True	string	대상 경로를 복사합니다.

반환

Name	경로	형식	Description
status	status	string	파일 작업의 상태입니다.
file_migration_id	file_migration_id	integer	상태가 보류 중인 경우 상태 업데이트를 확인하기 위한 파일 마이그레이션의 ID입니다.

파일 또는 폴더 삭제

작업 ID:

DeleteFilesPath

파일 또는 폴더 삭제

매개 변수

Name	키	필수	형식	Description
경로	path	True	string	작동할 경로입니다.

파일 또는 폴더 이동

작업 ID:

FileActionMove

파일 또는 폴더 이동

매개 변수

Name	키	필수	형식	Description
경로	path	True	string	작동할 경로입니다.
목적지	destination	True	string	대상 경로를 이동합니다.

반환

Name	경로	형식	Description
status	status	string	파일 작업의 상태입니다.
file_migration_id	file_migration_id	integer	상태가 보류 중인 경우 상태 업데이트를 확인하기 위한 파일 마이그레이션의 ID입니다.

파일 업로드

작업 ID:

UploadFile

파일 업로드

매개 변수

Name	키	필수	형식	Description
경로	path	True	string	작동할 경로입니다.
파일 콘텐츠	body	True	binary	업로드할 파일 콘텐츠입니다. Files.com 저장하려는 정확한 바이트를 보냅니다.

폴더 만들기

작업 ID:

PostFoldersPath

폴더 만들기

매개 변수

Name	키	필수	형식	Description
경로	path	True	string	작동할 경로입니다.

반환

Name	경로	형식	Description
경로	path	string	파일 또는 폴더 경로입니다. 슬래시로 구분해야 하지만 슬래시로 시작하거나 끝내서는 안 됩니다. 최대 5,000자입니다.
created_by_id	created_by_id	integer	파일 또는 폴더를 만든 사용자의 사용자 ID
created_by_api_key_id	created_by_api_key_id	integer	파일 또는 폴더를 만든 API 키의 ID
created_by_as2_incoming_message_id	created_by_as2_incoming_message_id	integer	파일 또는 폴더를 만든 AS2 수신 메시지의 ID
created_by_automation_id	created_by_automation_id	integer	파일 또는 폴더를 만든 Automation의 ID
created_by_bundle_registration_id	created_by_bundle_registration_id	integer	파일 또는 폴더를 만든 번들 등록의 ID
created_by_inbox_id	created_by_inbox_id	integer	파일 또는 폴더를 만든 받은 편지함의 ID
created_by_remote_server_id	created_by_remote_server_id	integer	파일 또는 폴더를 만든 원격 서버의 ID
created_by_sync_id	created_by_sync_id	integer	파일 또는 폴더를 만든 동기화의 ID
custom_metadata	custom_metadata	object	키 및 값의 사용자 지정 메타데이터 맵입니다. 키 32개, 키당 256자, 값당 1024자로 제한됩니다.
display_name	display_name	string	파일 또는 폴더 표시 이름
type	type	string	형식: directory 또는 file.
size	size	integer	파일 또는 폴더 크기
생성_시간	created_at	string	파일 생성 날짜 또는 시간
last_modified_by_id	last_modified_by_id	integer	파일 또는 폴더를 마지막으로 수정한 사용자의 사용자 ID
last_modified_by_api_key_id	last_modified_by_api_key_id	integer	파일 또는 폴더를 마지막으로 수정한 API 키의 ID
last_modified_by_automation_id	last_modified_by_automation_id	integer	파일 또는 폴더를 마지막으로 수정한 Automation의 ID
last_modified_by_bundle_registration_id	last_modified_by_bundle_registration_id	integer	파일 또는 폴더를 마지막으로 수정한 번들 등록의 ID
last_modified_by_remote_server_id	last_modified_by_remote_server_id	integer	파일 또는 폴더를 마지막으로 수정한 원격 서버의 ID
last_modified_by_sync_id	last_modified_by_sync_id	integer	파일 또는 폴더를 마지막으로 수정한 동기화의 ID
mtime	mtime	string	서버에 따라 마지막으로 수정한 날짜 또는 시간 파일입니다. 수정된 타임스탬프가 전송되었는지에 관계없이 파일의 마지막 Files.com 작업의 타임스탬프입니다.
provided_mtime	provided_mtime	string	마지막으로 수정한 날짜 또는 시간을 설정한 클라이언트에 따라 파일을 작성합니다. Files.com 데스크톱, FTP, SFTP 및 WebDAV 클라이언트가 수정된 시간을 설정할 수 있습니다. 이를 통해 데스크톱<->클라우드 동기화는 때때로 수정된 상태를 유지할 수 있습니다.
Crc32	crc32	string	파일 CRC32 체크섬입니다. 때로는 지연되므로 빈 응답을 받으면 기다렸다가 다시 시도하십시오.
md5	md5	string	파일 MD5 체크섬입니다. 때로는 지연되므로 빈 응답을 받으면 기다렸다가 다시 시도하십시오.
sha1	sha1	string	파일 SHA1 체크섬입니다. 때로는 지연되므로 빈 응답을 받으면 기다렸다가 다시 시도하십시오.
sha256	sha256	string	SHA256 체크섬 파일 때로는 지연되므로 빈 응답을 받으면 기다렸다가 다시 시도하십시오.
MIME 유형 (mime_type)	mime_type	string	MIME 형식입니다. 파일 이름 확장명에서 결정되며 내부적으로 별도로 저장되지 않습니다.
region	region	string	지역 위치
permissions	permissions	string	현재 사용자의 권한을 나타내는 짧은 문자열입니다. (읽기), (쓰기),w (삭제), ld (목록) 또는 모든 조합일 r 수 있습니다.
subfolders_locked?	subfolders_locked?	boolean	하위 폴더가 잠겨 있고 수정할 수 없나요?
is_locked	is_locked	boolean	이 폴더가 잠겨 있고 수정할 수 없나요?
download_uri	download_uri	string	파일을 다운로드하는 링크입니다. 다운로드 요청에 대한 응답으로만 제공됩니다.
priority_color	priority_color	string	파일 또는 폴더의 책갈피 또는 우선 순위 색
preview_id	preview_id	integer	파일 미리 보기 ID
아이디	preview.id	integer	미리 보기 ID
status	preview.status	string	미리 보기 상태입니다. 유효하지 않거나, not_generated, 생성, 완료 또는 file_too_large 수 있습니다.
download_uri	preview.download_uri	string	미리 보기 다운로드 링크
type	preview.type	string	미리 보기 유형입니다. 이미지, pdf, pdf_native, 비디오 또는 오디오일 수 있습니다.
size	preview.size	string	미리 보기 크기

정의

이진법

기본 데이터 형식 'binary'입니다.