다음을 통해 공유

상자

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

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

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

Box API 상태

Box API 중단을 추적하려면 이 리소스를 사용하세요.

알려진 문제 및 제한 사항

  1. 커넥터는 SSO(Single Sign-On) 연결을 지원하지 않습니다. 대신 표준 연결을 사용하세요.
  2. 파일 식별자 매개 변수를 실제 파일 이름과 혼동하지 마세요. Box REST API 제한으로 인해 [\ { } " <>] 문자가 있는 잘못된 파일 식별자가 커넥터 GetawayTimeout 오류로 이어질 수 있습니다.
  3. 루트 폴더를 포함하여 지정된 경로(폴더 경로 또는 파일 경로)의 각 폴더에는 10000개 이상의 항목이 포함되어서는 안됩니다.
  4. 파일 선택기를 사용하여 폴더의 파일을 선택할 때 결과 경로는 '//All Files'(예: '//All Files/My Folder/MyFile.txt')로 시작할 수 있습니다. 루트에 새 'All Files' 폴더를 만들지 않도록 하려면 이 경로를 수동으로 '/My Folder/MyFile.txt'로 변경해야 합니다. 루트 폴더를 참조하려면 '//All Files' -> '/'와 같은 단일 슬래시를 사용합니다.
  5. 대부분의 경우 해당 이벤트의 발생 시 트리거가 거의 즉시 발생하지만 기본 API 제한으로 인해 트리거의 실행 지연이 최대 1일이 걸릴 수 있는 드문 상황이 있을 수 있습니다. 자세한 내용은 (Box Events API)로 이동합니다. 해당 기간 동안 폴더에 파일을 보관하는 것이 좋습니다. 그렇지 않으면 트리거 논리에 의해 보고되지 않습니다.
  6. 폴더에 파일이 이미 있는 경우 동일한 이름으로 파일을 다시 업로드하는 것은 create 이벤트로 간주되지 않고 이벤트를 업데이트합니다.
  7. 이 커넥터는 더 이상 테이블 형식 커넥터가 아니므로 Excel 커넥터를 포함하여 테이블 형식 데이터 원본으로 사용할 수 없습니다.
  8. 이 커넥터는 백 엔드에 no-op 요청을 보낼 수 있습니다.

일반 제한

이름 가치
최대 파일 크기(MB) 75
최대 폴더 항목 수 10000
대역폭 시간 간격(연결당) 내에서 커넥터 간 전송되는 최대 메가바이트 수 1000
대역폭 시간 간격(밀리초) 60000

제한 한도

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

동작

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

파일 ID를 사용하여 Box에서 파일 메타데이터를 검색합니다.
ID를 사용하여 파일 콘텐츠 가져오기

ID를 사용하여 Box에서 파일 콘텐츠를 검색합니다.
경로를 사용하여 파일 메타데이터 가져오기

경로를 사용하여 Box에서 파일 메타데이터를 검색합니다.
경로를 사용하여 파일 콘텐츠 가져오기

경로를 사용하여 Box에서 파일 내용을 검색합니다.
루트 폴더에 파일 및 폴더 나열

Box 루트 폴더의 파일 및 폴더를 나열합니다.
파일 만들기

Box에 파일을 업로드합니다.
파일 복사

Box의 파일 경로에 파일을 복사합니다.
파일 삭제

Box에서 기존 파일을 삭제합니다.
파일 업데이트

Box에서 기존 파일을 업데이트합니다.
폴더에 보관 추출

보관 파일을 Box의 폴더로 추출합니다(예: .zip).
폴더의 파일 및 폴더 나열

Box 폴더의 파일 및 폴더를 나열합니다.

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

작업 ID:
GetFileMetadata

파일 ID를 사용하여 Box에서 파일 메타데이터를 검색합니다.

매개 변수

Name 키 필수 형식 Description
파일 ID
 id True string

Box에 있는 파일의 고유 식별자입니다.

반환

Blob 메타데이터

몸
BlobMetadata

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

작업 ID:
GetFileContent

ID를 사용하여 Box에서 파일 콘텐츠를 검색합니다.

매개 변수

Name 키 필수 형식 Description
파일 ID
 id True string

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

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

반환

파일의 내용입니다.

File Content(파일 내용)
binary

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

작업 ID:
GetFileMetadataByPath

경로를 사용하여 Box에서 파일 메타데이터를 검색합니다.

매개 변수

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

Box에서 파일에 대한 고유 경로입니다.

반환

Blob 메타데이터

몸
BlobMetadata

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

작업 ID:
GetFileContentByPath

경로를 사용하여 Box에서 파일 내용을 검색합니다.

매개 변수

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

Box에서 파일에 대한 고유 경로입니다.
콘텐츠 형식 유추
 inferContentType boolean

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

반환

파일의 내용입니다.

File Content(파일 내용)
binary

루트 폴더에 파일 및 폴더 나열

작업 ID:
ListRootFolder

Box 루트 폴더의 파일 및 폴더를 나열합니다.

반환

response
array of BlobMetadata

파일 만들기

작업 ID:
CreateFile

Box에 파일을 업로드합니다.

매개 변수

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

Box에 파일을 업로드할 폴더 경로입니다.
파일 이름
 name True string

Box에서 만들 파일의 이름입니다.
File Content(파일 내용)
 body True binary

Box에 업로드할 파일의 콘텐츠입니다.

반환

Blob 메타데이터

몸
BlobMetadata

파일 복사

작업 ID:
CopyFile

Box의 파일 경로에 파일을 복사합니다.

매개 변수

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

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

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

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

반환

Blob 메타데이터

몸
BlobMetadata

파일 삭제

작업 ID:
DeleteFile

Box에서 기존 파일을 삭제합니다.

매개 변수

Name 키 필수 형식 Description
파일 ID
 id True string

Box에서 삭제할 파일의 고유 식별자입니다.

파일 업데이트

작업 ID:
UpdateFile

Box에서 기존 파일을 업데이트합니다.

매개 변수

Name 키 필수 형식 Description
파일 ID
 id True string

Box에서 업데이트할 파일의 고유 식별자입니다.
File Content(파일 내용)
 body True binary

Box에서 업데이트할 파일의 콘텐츠입니다.

반환

Blob 메타데이터

몸
BlobMetadata

폴더에 보관 추출

작업 ID:
ExtractFolderV2

보관 파일을 Box의 폴더로 추출합니다(예: .zip).

매개 변수

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

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

보관 내용을 추출할 Box의 경로입니다.
덮어쓰기
 overwrite boolean

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

반환

response
array of BlobMetadata

폴더의 파일 및 폴더 나열

작업 ID:
ListFolder

Box 폴더의 파일 및 폴더를 나열합니다.

매개 변수

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

Box에 있는 폴더의 고유 식별자입니다.

반환

response
array of BlobMetadata

트리거

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

이 작업은 폴더에 새 파일을 만들 때 흐름을 트리거합니다. 하위 폴더에서 파일이 추가/업데이트되면 트리거가 실행되지 않습니다. 하위 폴더에서 트리거해야 하는 경우 여러 트리거를 만들어야 합니다. 트리거> 설정에 대해 '분할 켜기' 옵션이 해제된 경우 트리거 실행에 성공하면 '파일 목록' 출력에 대한 빈 배열이 생성됩니다.
파일이 만들어지는 경우(속성에만 해당) [사용되지 않음]

이 작업은 더 이상 사용되지 않습니다. 파일을 만들 때(속성에만 해당)(V2)를 대신 사용하세요.

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

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

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

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

이 작업은 폴더에서 파일이 수정될 때 흐름을 트리거합니다. 하위 폴더에서 파일이 추가/업데이트되면 트리거가 실행되지 않습니다. 하위 폴더에서 트리거해야 하는 경우 여러 트리거를 만들어야 합니다. 트리거> 설정에 대해 '분할 켜기' 옵션이 해제된 경우 트리거 실행에 성공하면 '파일 목록' 출력에 대한 빈 배열이 생성됩니다.

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

작업 ID:
OnNewFilesV2

이 작업은 폴더에 새 파일을 만들 때 흐름을 트리거합니다. 하위 폴더에서 파일이 추가/업데이트되면 트리거가 실행되지 않습니다. 하위 폴더에서 트리거해야 하는 경우 여러 트리거를 만들어야 합니다. 트리거> 설정에 대해 '분할 켜기' 옵션이 해제된 경우 트리거 실행에 성공하면 '파일 목록' 출력에 대한 빈 배열이 생성됩니다.

매개 변수

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

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

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

반환

Blob 메타데이터

파일 목록
BlobMetadata

파일이 만들어지는 경우(속성에만 해당) [사용되지 않음]

작업 ID:
OnNewFiles

이 작업은 더 이상 사용되지 않습니다. 파일을 만들 때(속성에만 해당)(V2)를 대신 사용하세요.

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

매개 변수

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

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

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

반환

Blob 메타데이터

파일 목록
BlobMetadata

파일이 만들어지는 경우 [사용되지 않음]

작업 ID:
OnNewFile

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

매개 변수

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

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

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

반환

파일의 내용입니다.

File Content(파일 내용)
binary

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

작업 ID:
OnUpdatedFiles

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

매개 변수

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

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

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

반환

Blob 메타데이터

파일 목록
BlobMetadata

파일이 수정되는 경우 [사용되지 않음]

작업 ID:
OnUpdatedFile

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

매개 변수

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

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

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

반환

파일의 내용입니다.

File Content(파일 내용)
binary

파일이 수정된 경우(속성에만 해당) (V2)(미리 보기)

작업 ID:
OnUpdatedFilesV2

이 작업은 폴더에서 파일이 수정될 때 흐름을 트리거합니다. 하위 폴더에서 파일이 추가/업데이트되면 트리거가 실행되지 않습니다. 하위 폴더에서 트리거해야 하는 경우 여러 트리거를 만들어야 합니다. 트리거> 설정에 대해 '분할 켜기' 옵션이 해제된 경우 트리거 실행에 성공하면 '파일 목록' 출력에 대한 빈 배열이 생성됩니다.

매개 변수

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

파일 또는 폴더의 파일로케이터입니다.
최근 수정자
 LastModifiedBy string

파일 또는 폴더를 마지막으로 수정한 사용자입니다.

이진법

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