다음을 통해 공유

Dropbox

Dropbox는 파일을 안전하고 동기화되고 쉽게 공유할 수 있도록 하는 서비스입니다. Dropbox에 연결하여 파일을 관리합니다. Dropbox에서 파일 업로드, 업데이트, 가져오기 및 삭제와 같은 다양한 작업을 수행할 수 있습니다.

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

서비스 클래스 Regions
Copilot Studio 스탠다드 다음을 제외한 모든 Power Automate 지역 :
     - 미국 정부(GCC High)
     - 21Vianet에서 운영하는 중국 클라우드
     - 미국 국방부(DoD)
논리 앱 스탠다드 다음을 제외한 모든 Logic Apps 지역 :
     - Azure 중국 지역
     - 미국 국방부(DoD)
Power Apps 스탠다드 다음을 제외한 모든 Power Apps 지역 :
     - 미국 정부(GCC High)
     - 21Vianet에서 운영하는 중국 클라우드
     - 미국 국방부(DoD)
Power Automate 스탠다드 다음을 제외한 모든 Power Automate 지역 :
     - 미국 정부(GCC High)
     - 21Vianet에서 운영하는 중국 클라우드
     - 미국 국방부(DoD)
연락처
이름 Microsoft
URL Microsoft LogicApps 지원
Microsoft Power Automate 지원
Microsoft Power Apps 지원
커넥터 메타데이터
게시자 Microsoft
웹 사이트 https://www.dropbox.com/
개인 정보 보호 정책 https://www.dropbox.com/privacy

알려진 문제 및 제한 사항

  1. Dropbox REST API의 제한 사항으로 인해 현재 개인 및 공유 폴더만 지원합니다. 팀 폴더는 지원되지 않습니다.
  2. 하위 폴더에서 파일이 추가/업데이트되면 트리거가 실행되지 않습니다. 하위 폴더에서 트리거해야 하는 경우 여러 트리거를 만들어야 합니다.
  3. 그룹에 비공개인 폴더는 선택할 수 없습니다. 해당 그룹의 구성원인 경우에도 해당 그룹입니다.
  4. 이 커넥터는 더 이상 테이블 형식 커넥터가 아니므로 Excel 커넥터를 포함하여 테이블 형식 데이터 원본으로 사용할 수 없습니다.
  5. 이 커넥터는 백 엔드에 no-op 요청을 보낼 수 있습니다.

일반 제한

이름 가치
최대 파일 크기(MB) 50
복사 작업의 최대 파일 크기(MB) 300
대역폭 시간 간격(연결당) 내에서 커넥터 간 전송되는 최대 메가바이트 수 1000
대역폭 시간 간격(밀리초) 60000

제한 한도

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

동작

경로를 사용하여 파일 메타데이터 가져오기

이 작업은 경로를 사용하여 파일의 메타데이터를 가져옵니다.
경로를 사용하여 파일 콘텐츠 가져오기

이 작업은 경로를 사용하여 파일의 콘텐츠를 가져옵니다.
루트 폴더의 파일 나열

이 작업은 루트 폴더의 파일 및 하위 폴더 목록을 가져옵니다.
파일 만들기

이 작업은 폴더에 파일을 만듭니다.
파일 메타데이터 가져오기

이 작업은 파일에 대한 메타데이터를 가져옵니다.
파일 복사

이 작업은 Dropbox에 파일을 복사합니다.
파일 삭제

이 작업은 파일을 삭제합니다.
파일 업데이트

이 작업은 파일을 업데이트합니다.
파일 콘텐츠 가져오기

이 작업은 파일의 콘텐츠를 가져옵니다.
폴더에 보관 추출

이 작업은 보관 파일을 폴더(예: .zip)로 추출합니다.
폴더의 파일 나열

이 작업은 폴더의 파일 및 하위 폴더 목록을 가져옵니다.

경로를 사용하여 파일 메타데이터 가져오기

작업 ID:
GetFileMetadataByPath

이 작업은 경로를 사용하여 파일의 메타데이터를 가져옵니다.

매개 변수

Name 키 필수 형식 Description
파일 경로
 path True string

파일의 고유 경로입니다.

반환

Blob 메타데이터

몸
BlobMetadata

경로를 사용하여 파일 콘텐츠 가져오기

작업 ID:
GetFileContentByPath

이 작업은 경로를 사용하여 파일의 콘텐츠를 가져옵니다.

매개 변수

Name 키 필수 형식 Description
파일 경로
 path True string

파일의 고유 경로입니다.
콘텐츠 형식 유추
 inferContentType boolean

확장에 따라 콘텐츠 형식을 유추하는 부울 값(true, false)입니다.

반환

파일의 내용입니다.

File Content(파일 내용)
binary

루트 폴더의 파일 나열

작업 ID:
ListRootFolder

이 작업은 루트 폴더의 파일 및 하위 폴더 목록을 가져옵니다.

반환

response
array of BlobMetadata

파일 만들기

작업 ID:
CreateFile

이 작업은 폴더에 파일을 만듭니다.

매개 변수

Name 키 필수 형식 Description
폴더 경로
 folderPath True string

파일 경로입니다.
파일 이름
 name True string

파일 이름입니다.
File Content(파일 내용)
 body True binary

파일의 내용입니다.

반환

Blob 메타데이터

몸
BlobMetadata

파일 메타데이터 가져오기

작업 ID:
GetFileMetadata

이 작업은 파일에 대한 메타데이터를 가져옵니다.

매개 변수

Name 키 필수 형식 Description
File
 id True string

파일의 고유 식별자입니다.

반환

Blob 메타데이터

몸
BlobMetadata

파일 복사

작업 ID:
CopyFile

이 작업은 Dropbox에 파일을 복사합니다.

매개 변수

Name 키 필수 형식 Description
원본 URL
 source True string

원본 파일의 URL입니다.
대상 파일 경로
 destination True string

대상 파일 이름을 포함한 대상 파일 경로입니다.
덮어쓰기
 overwrite boolean

'true'로 설정된 경우 대상 파일을 덮어씁니다.

반환

Blob 메타데이터

몸
BlobMetadata

파일 삭제

작업 ID:
DeleteFile

이 작업은 파일을 삭제합니다.

매개 변수

Name 키 필수 형식 Description
File
 id True string

파일의 고유 식별자입니다.

파일 업데이트

작업 ID:
UpdateFile

이 작업은 파일을 업데이트합니다.

매개 변수

Name 키 필수 형식 Description
File
 id True string

파일의 고유 식별자입니다.
File Content(파일 내용)
 body True binary

파일의 내용입니다.

반환

Blob 메타데이터

몸
BlobMetadata

파일 콘텐츠 가져오기

작업 ID:
GetFileContent

이 작업은 파일의 콘텐츠를 가져옵니다.

매개 변수

Name 키 필수 형식 Description
File
 id True string

파일의 고유 식별자입니다.
콘텐츠 형식 유추
 inferContentType boolean

확장에 따라 콘텐츠 형식을 유추하는 부울 값(true, false)입니다.

반환

파일의 내용입니다.

File Content(파일 내용)
binary

폴더에 보관 추출

작업 ID:
ExtractFolderV2

이 작업은 보관 파일을 폴더(예: .zip)로 추출합니다.

매개 변수

Name 키 필수 형식 Description
원본 보관 파일 경로
 source True string

보관 파일의 경로입니다.
대상 폴더 경로
 destination True string

보관 콘텐츠를 추출하는 경로입니다.
덮어쓰기
 overwrite boolean

'true'로 설정된 경우 대상 파일을 덮어씁니다.

반환

response
array of BlobMetadata

폴더의 파일 나열

작업 ID:
ListFolder

이 작업은 폴더의 파일 및 하위 폴더 목록을 가져옵니다.

매개 변수

Name 키 필수 형식 Description
폴더
 id True string

폴더의 고유 식별자입니다.

반환

response
array of BlobMetadata

트리거

파일이 만들어지는 경우

이 작업은 폴더에 새 파일을 만들 때 흐름을 트리거합니다. 하위 폴더에서 파일이 추가/업데이트되면 트리거가 실행되지 않습니다. 하위 폴더에서 트리거해야 하는 경우 여러 트리거를 만들어야 합니다.
파일이 만들어지는 경우(속성에만 해당)

이 작업은 폴더에 새 파일을 만들 때 흐름을 트리거합니다. 하위 폴더에서 파일이 추가/업데이트되면 트리거가 실행되지 않습니다. 하위 폴더에서 트리거해야 하는 경우 여러 트리거를 만들어야 합니다.
파일이 수정되는 경우

이 작업은 폴더에서 파일이 수정될 때 흐름을 트리거합니다. 하위 폴더에서 파일이 추가/업데이트되면 트리거가 실행되지 않습니다. 하위 폴더에서 트리거해야 하는 경우 여러 트리거를 만들어야 합니다.
파일이 수정되는 경우(속성에만 해당)

이 작업은 폴더에서 파일이 수정될 때 흐름을 트리거합니다. 하위 폴더에서 파일이 추가/업데이트되면 트리거가 실행되지 않습니다. 하위 폴더에서 트리거해야 하는 경우 여러 트리거를 만들어야 합니다.

파일이 만들어지는 경우

작업 ID:
OnNewFile

이 작업은 폴더에 새 파일을 만들 때 흐름을 트리거합니다. 하위 폴더에서 파일이 추가/업데이트되면 트리거가 실행되지 않습니다. 하위 폴더에서 트리거해야 하는 경우 여러 트리거를 만들어야 합니다.

매개 변수

Name 키 필수 형식 Description
폴더
 folderId True string

폴더의 고유 식별자입니다.
콘텐츠 형식 유추
 inferContentType boolean

확장에 따라 콘텐츠 형식을 유추하는 부울 값(true, false)입니다.

반환

파일의 내용입니다.

File Content(파일 내용)
binary

파일이 만들어지는 경우(속성에만 해당)

작업 ID:
OnNewFiles

이 작업은 폴더에 새 파일을 만들 때 흐름을 트리거합니다. 하위 폴더에서 파일이 추가/업데이트되면 트리거가 실행되지 않습니다. 하위 폴더에서 트리거해야 하는 경우 여러 트리거를 만들어야 합니다.

매개 변수

Name 키 필수 형식 Description
폴더
 folderId True string

폴더의 고유 식별자입니다.
반환할 파일 수
 maxFileCount integer

단일 트리거 실행(1-100)으로 반환할 최대 파일 수입니다. '분할 켜기' 설정은 트리거가 각 항목을 개별적으로 처리하도록 강제할 수 있습니다.

반환

Blob 메타데이터

파일 목록
BlobMetadata

파일이 수정되는 경우

작업 ID:
OnUpdatedFile

이 작업은 폴더에서 파일이 수정될 때 흐름을 트리거합니다. 하위 폴더에서 파일이 추가/업데이트되면 트리거가 실행되지 않습니다. 하위 폴더에서 트리거해야 하는 경우 여러 트리거를 만들어야 합니다.

매개 변수

Name 키 필수 형식 Description
폴더
 folderId True string

폴더의 고유 식별자입니다.
콘텐츠 형식 유추
 inferContentType boolean

확장에 따라 콘텐츠 형식을 유추하는 부울 값(true, false)입니다.

반환

파일의 내용입니다.

File Content(파일 내용)
binary

파일이 수정되는 경우(속성에만 해당)

작업 ID:
OnUpdatedFiles

이 작업은 폴더에서 파일이 수정될 때 흐름을 트리거합니다. 하위 폴더에서 파일이 추가/업데이트되면 트리거가 실행되지 않습니다. 하위 폴더에서 트리거해야 하는 경우 여러 트리거를 만들어야 합니다.

매개 변수

Name 키 필수 형식 Description
폴더
 folderId True string

폴더 선택
반환할 파일 수
 maxFileCount integer

단일 트리거 실행(1-100)으로 반환할 최대 파일 수입니다. '분할 켜기' 설정은 트리거가 각 항목을 개별적으로 처리하도록 강제할 수 있습니다.

반환

Blob 메타데이터

파일 목록
BlobMetadata

정의

BlobMetadata

Blob 메타데이터

Name 경로 형식 Description
아이디
 Id string

파일 또는 폴더의 고유 ID입니다.
이름
 Name string

파일 또는 폴더의 이름입니다.
디스플레이 이름
 DisplayName string

파일 또는 폴더의 표시 이름입니다.
경로
 Path string

파일 또는 폴더의 경로입니다.
마지막 수정
 LastModified date-time

파일 또는 폴더가 마지막으로 수정된 날짜와 시간입니다.
Size
 Size integer

파일 또는 폴더의 크기입니다.
미디어 유형
 MediaType string

파일 또는 폴더의 미디어 형식입니다.
IsFolder
 IsFolder boolean

Blob이 폴더인지 여부를 나타내는 부울 값(true, false)입니다.
ETag
 ETag string

파일 또는 폴더의 etag입니다.
FileLocator
 FileLocator string

파일 또는 폴더의 파일로케이터입니다.

이진법

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