коробка

Box™ — это служба, которая обеспечивает безопасность файлов, синхронизацию и простоту совместного использования. Подключитесь к Box для управления файлами. Вы можете выполнять различные действия, такие как отправка, обновление, получение и удаление файлов в Box.

Этот соединитель доступен в следующих продуктах и регионах:

Услуга	Class	Регионы
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

Метаданные соединителя
Publisher	Microsoft
Веб-сайт	https://www.box.com/
Политика конфиденциальности	https://www.box.com/legal/privacypolicy

Состояние API Box

Используйте этот ресурс для отслеживания сбоев API Box

Известные проблемы и ограничения

1. Соединитель не поддерживает подключения единого входа(SSO), вместо этого используйте стандартное подключение.
2. Не путайте параметр идентификатора файла с фактическим именем файла. Из-за ограничений REST API Box недопустимые идентификаторы файлов со следующими символами — [\ { } " <>] могут привести к ошибкам getawayTimeout соединителя.
3. Каждая папка в указанном пути (путь к папке или путь к файлу), включая корневую папку, не должна содержать более 10000 элементов.
4. При выборе файла папки с помощью средства выбора файлов результирующий путь может начинаться с "//Все файлы", например "/Все файлы/мои папки/MyFile.txt". Чтобы избежать создания новой папки "Все файлы" в корневом каталоге, этот путь следует вручную изменить на "/Моя папка/MyFile.txt". Для ссылки на корневую папку используйте одну косую черту, например "//Все файлы" —> "/".
5. Триггеры запускаются при возникновении соответствующего события почти сразу в большинстве случаев, но в большинстве случаев могут возникнуть редкие случаи, когда задержка триггера для пожара может занять до одного дня из-за базовых ограничений API. Дополнительные сведения см. в API событий Box. Рекомендуется хранить файл в папке в течение этого периода. В противном случае он не будет сообщаться логикой триггера.
6. Если файл уже существует в папке, повторное отправка файла с тем же именем не будет считаться событием создания, но событием обновления.
7. Этот соединитель больше не является табличным соединителем, поэтому его нельзя использовать в качестве табличного источника данных, включая соединитель Excel.
8. Этот соединитель может отправить no-op запрос на серверную часть.

Общие ограничения

Имя	Ценность
Максимальный размер файла (в МБ)	75
Максимальное число элементов папок	10000
Максимальное количество мегабайт, передаваемых в соединитель или из соединителя в течение интервала времени пропускной способности (на соединение)	1000
Интервал времени пропускной способности (в милисекундах)	60 000

Ограничения регулирования

Имя	Вызовы	Период обновления
Вызовы API для каждого подключения	100	60 секунд

Действия

Вывод списка файлов и папок в корневой папке	Выводит список файлов и папок в корневой папке Box.
Вывод списка файлов и папок в папке	Выводит список файлов и папок в папке Box.
Извлечение архива в папку	Извлекает архивный файл в папку в Box (например, .zip).
Копирование файла	Скопируйте файл в путь к файлу в Box.
Обновление файла	Обновляет существующий файл в Box.
Получение метаданных файла с помощью идентификатора	Извлекает метаданные файла из Box с помощью идентификатора файла.
Получение метаданных файла с помощью пути	Извлекает метаданные файла из Box с помощью пути.
Получение содержимого файла с помощью идентификатора	Извлекает содержимое файла из Box с помощью идентификатора.
Получение содержимого файла с помощью пути	Извлекает содержимое файла из Box с помощью пути.
Создать файл	Отправляет файл в Box.
Удалить файл	Удаляет существующий файл из Box.

Вывод списка файлов и папок в корневой папке

Идентификатор операции:

ListRootFolder

Выводит список файлов и папок в корневой папке Box.

Возвращаемое значение

response

array of BlobMetadata

Вывод списка файлов и папок в папке

Идентификатор операции:

ListFolder

Выводит список файлов и папок в папке Box.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Идентификатор папки	id	True	string	Уникальный идентификатор папки в Box.

Возвращаемое значение

response

array of BlobMetadata

Извлечение архива в папку

Идентификатор операции:

ExtractFolderV2

Извлекает архивный файл в папку в Box (например, .zip).

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Путь к файлу исходного архива	source	True	string	Путь к архиву.
Путь к папке назначения	destination	True	string	Путь в Box для извлечения содержимого архива.
Перезаписать	overwrite		boolean	Перезаписывает конечные файлы, если задано значение true.

Возвращаемое значение

response

array of BlobMetadata

Копирование файла

Идентификатор операции:

CopyFile

Скопируйте файл в путь к файлу в Box.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Url-адрес источника	source	True	string	URL-адрес исходного файла.
Путь к целевому файлу	destination	True	string	Путь к целевому файлу в Box, включая имя целевого файла.
Перезаписать	overwrite		boolean	Перезаписывает целевой файл, если задано значение true.

Возвращаемое значение

Метаданные больших двоичных объектов

Тело

BlobMetadata

Обновление файла

Идентификатор операции:

UpdateFile

Обновляет существующий файл в Box.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Идентификатор файла	id	True	string	Уникальный идентификатор файла для обновления в Box.
Содержимое файла	body	True	binary	Содержимое файла для обновления в Box.

Возвращаемое значение

Метаданные больших двоичных объектов

Тело

BlobMetadata

Получение метаданных файла с помощью идентификатора

Идентификатор операции:

GetFileMetadata

Извлекает метаданные файла из Box с помощью идентификатора файла.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Идентификатор файла	id	True	string	Уникальный идентификатор файла в Box.

Возвращаемое значение

Метаданные больших двоичных объектов

Тело

BlobMetadata

Получение метаданных файла с помощью пути

Идентификатор операции:

GetFileMetadataByPath

Извлекает метаданные файла из Box с помощью пути.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Путь к файлу	path	True	string	Уникальный путь к файлу в Box.

Возвращаемое значение

Метаданные больших двоичных объектов

Тело

BlobMetadata

Получение содержимого файла с помощью идентификатора

Идентификатор операции:

GetFileContent

Извлекает содержимое файла из Box с помощью идентификатора.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Идентификатор файла	id	True	string	Уникальный идентификатор файла в Box.
Тип контента вывода	inferContentType		boolean	Логическое значение (true, false) для вывода типа контента на основе расширения.

Возвращаемое значение

Содержимое файла.

Содержимое файла

binary

Получение содержимого файла с помощью пути

Идентификатор операции:

GetFileContentByPath

Извлекает содержимое файла из Box с помощью пути.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Путь к файлу	path	True	string	Уникальный путь к файлу в Box.
Тип контента вывода	inferContentType		boolean	Логическое значение (true, false) для вывода типа контента на основе расширения.

Возвращаемое значение

Содержимое файла.

Содержимое файла

binary

Создать файл

Идентификатор операции:

CreateFile

Отправляет файл в Box.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Путь к папке	folderPath	True	string	Путь к папке для отправки файла в Box.
Имя файла	name	True	string	Имя файла, создаваемого в Box.
Содержимое файла	body	True	binary	Содержимое файла для отправки в Box.

Возвращаемое значение

Метаданные больших двоичных объектов

Тело

BlobMetadata

Удалить файл

Идентификатор операции:

DeleteFile

Удаляет существующий файл из Box.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Идентификатор файла	id	True	string	Уникальный идентификатор файла для удаления из Box.

Триггеры

При изменении файла (только свойств)	Эта операция активирует поток при изменении файла в папке. Триггер не запускается, если файл добавляется или обновляется в вложенной папке. Если требуется активировать в вложенных папках, необходимо создать несколько триггеров.
При изменении файла (только свойств) (версия 2) (предварительная версия)	Эта операция активирует поток при изменении файла в папке. Триггер не запускается, если файл добавляется или обновляется в вложенной папке. Если требуется активировать в вложенных папках, необходимо создать несколько триггеров. Если параметр Split On отключен для> успешных запусков триггера "Параметры триггера" может создать пустой массив для выходных данных "Список файлов".
При изменении файла [DEPRECATED]	Активирует поток при изменении файла в папке Box. Триггер не запускается, если файл добавляется или обновляется в вложенной папке. Если требуется активировать в вложенных папках, необходимо создать несколько триггеров.
При создании файла (только свойств) (версия 2)	Эта операция активирует поток при создании нового файла в папке. Триггер не запускается, если файл добавляется или обновляется в вложенной папке. Если требуется активировать в вложенных папках, необходимо создать несколько триггеров. Если параметр Split On отключен для> успешных запусков триггера "Параметры триггера" может создать пустой массив для выходных данных "Список файлов".
При создании файла (только свойств) [DEPRECATED]	Это действие устарело. Используйте, если файл создается (только свойства) (версия 2). Эта операция активирует поток при создании нового файла в папке. Триггер не запускается, если файл добавляется или обновляется в вложенной папке. Если требуется активировать в вложенных папках, необходимо создать несколько триггеров.
При создании файла [DEPRECATED]	Активирует поток при создании нового файла в папке Box. Триггер не запускается, если файл добавляется или обновляется в вложенной папке. Если требуется активировать в вложенных папках, необходимо создать несколько триггеров.

При изменении файла (только свойств)

Идентификатор операции:

OnUpdatedFiles

Эта операция активирует поток при изменении файла в папке. Триггер не запускается, если файл добавляется или обновляется в вложенной папке. Если требуется активировать в вложенных папках, необходимо создать несколько триггеров.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Folder	folderId	True	string	Выбор папки
Количество возвращаемых файлов	maxFileCount		integer	Максимальное количество файлов для возврата по одному триггеру (1–100). Обратите внимание, что параметр Split On может принудительно активировать обработку каждого элемента по отдельности.

Возвращаемое значение

Метаданные больших двоичных объектов

Список файлов

BlobMetadata

При изменении файла (только свойств) (версия 2) (предварительная версия)

Идентификатор операции:

OnUpdatedFilesV2

Эта операция активирует поток при изменении файла в папке. Триггер не запускается, если файл добавляется или обновляется в вложенной папке. Если требуется активировать в вложенных папках, необходимо создать несколько триггеров. Если параметр Split On отключен для> успешных запусков триггера "Параметры триггера" может создать пустой массив для выходных данных "Список файлов".

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Folder	folderId	True	string	Выбор папки
Количество возвращаемых файлов	maxFileCount		integer	Максимальное количество файлов для возврата по одному триггеру (1–100). Обратите внимание, что параметр Split On может принудительно активировать обработку каждого элемента по отдельности.

Возвращаемое значение

Метаданные больших двоичных объектов

Список файлов

BlobMetadata

При изменении файла [DEPRECATED]

Идентификатор операции:

OnUpdatedFile

Активирует поток при изменении файла в папке Box. Триггер не запускается, если файл добавляется или обновляется в вложенной папке. Если требуется активировать в вложенных папках, необходимо создать несколько триггеров.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Идентификатор папки	folderId	True	string	Уникальный идентификатор папки в Box.
Тип контента вывода	inferContentType		boolean	Логическое значение (true, false) для вывода типа контента на основе расширения.

Возвращаемое значение

Содержимое файла.

Содержимое файла

binary

При создании файла (только свойств) (версия 2)

Идентификатор операции:

OnNewFilesV2

Эта операция активирует поток при создании нового файла в папке. Триггер не запускается, если файл добавляется или обновляется в вложенной папке. Если требуется активировать в вложенных папках, необходимо создать несколько триггеров. Если параметр Split On отключен для> успешных запусков триггера "Параметры триггера" может создать пустой массив для выходных данных "Список файлов".

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Folder	folderId	True	string	Уникальный идентификатор папки.
Количество возвращаемых файлов	maxFileCount		integer	Максимальное количество файлов для возврата по одному триггеру (1–100). Обратите внимание, что параметр Split On может принудительно активировать обработку каждого элемента по отдельности.

Возвращаемое значение

Метаданные больших двоичных объектов

Список файлов

BlobMetadata

При создании файла (только свойств) [DEPRECATED]

Идентификатор операции:

OnNewFiles

Это действие устарело. Используйте, если файл создается (только свойства) (версия 2).

Эта операция активирует поток при создании нового файла в папке. Триггер не запускается, если файл добавляется или обновляется в вложенной папке. Если требуется активировать в вложенных папках, необходимо создать несколько триггеров.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Folder	folderId	True	string	Уникальный идентификатор папки.
Количество возвращаемых файлов	maxFileCount		integer	Максимальное количество файлов для возврата по одному триггеру (1–100). Обратите внимание, что параметр Split On может принудительно активировать обработку каждого элемента по отдельности.

Возвращаемое значение

Метаданные больших двоичных объектов

Список файлов

BlobMetadata

При создании файла [DEPRECATED]

Идентификатор операции:

OnNewFile

Активирует поток при создании нового файла в папке Box. Триггер не запускается, если файл добавляется или обновляется в вложенной папке. Если требуется активировать в вложенных папках, необходимо создать несколько триггеров.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Идентификатор папки	folderId	True	string	Уникальный идентификатор папки в Box.
Тип контента вывода	inferContentType		boolean	Логическое значение (true, false) для вывода типа контента на основе расширения.

Возвращаемое значение

Содержимое файла.

Содержимое файла

binary

Определения

BlobMetadata

Метаданные больших двоичных объектов

Имя	Путь	Тип	Описание
Идентификатор	Id	string	Уникальный идентификатор файла или папки.
Имя	Name	string	Имя файла или папки.
Отображаемое имя	DisplayName	string	Отображаемое имя файла или папки.
Путь	Path	string	Путь к файлу или папке.
ПоследнееИзменение	LastModified	date-time	Дата и время последнего изменения файла или папки.
Size	Size	integer	Размер файла или папки.
Тип мультимедиа	MediaType	string	Тип носителя файла или папки.
IsFolder	IsFolder	boolean	Логическое значение (true, false), указывающее, является ли большой двоичный объект папкой.
ЭТаг	ETag	string	Etag файла или папки.
FileLocator	FileLocator	string	Файловый указатель файла или папки.
Последнее изменение сделано	LastModifiedBy	string	Пользователь, который последний раз изменил файл или папку.

бинарный

Это базовый тип данных binary.