Pudełko
Box™ to usługa, która zapewnia bezpieczeństwo, synchronizowanie i łatwe udostępnianie plików. Połącz się z usługą Box, aby zarządzać plikami. W usłudze Box można wykonywać różne akcje, takie jak przekazywanie, aktualizowanie, pobieranie i usuwanie plików.
Ten łącznik jest dostępny w następujących produktach i regionach:
| Usługa | Class | Regions |
|---|---|---|
| Copilot Studio | Standard | Wszystkie regiony usługi Power Automate z wyjątkiem następujących: - China Cloud obsługiwane przez firmę 21Vianet |
| Logic Apps | Standard | Wszystkie regiony usługi Logic Apps z wyjątkiem następujących: — Regiony platformy Azure (Chiny) - Departament Obrony USA (DoD) |
| Power Apps | Standard | Wszystkie regiony usługi Power Apps z wyjątkiem następujących: - China Cloud obsługiwane przez firmę 21Vianet |
| Power Automate | Standard | Wszystkie regiony usługi Power Automate z wyjątkiem następujących: - China Cloud obsługiwane przez firmę 21Vianet |
| Kontakt | |
|---|---|
| Name | Microsoft |
| adres URL |
Obsługa usługi Microsoft LogicApps Pomoc techniczna usługi Microsoft Power Automate Obsługa usługi Microsoft Power Apps |
| Metadane łącznika | |
|---|---|
| Publisher | Microsoft |
| Witryna internetowa | https://www.box.com/ |
| Zasady ochrony prywatności | https://www.box.com/legal/privacypolicy |
Stan interfejsu API usługi Box
Użyj tego zasobu, aby śledzić awarie interfejsu API usługi Box
Znane problemy i ograniczenia
- Łącznik nie obsługuje połączeń logowania jednokrotnego(SSO), zamiast tego użyj połączenia standardowego.
- Nie należy mylić parametru identyfikatora pliku z rzeczywistą nazwą pliku. Ze względu na ograniczenia interfejsu API REST usługi Box nieprawidłowe identyfikatory plików z następującymi znakami — [\ { } " <>] może prowadzić do błędów getawayTimeout łącznika.
- Każdy folder w określonej ścieżce (ścieżka folderu lub ścieżka pliku), w tym folder główny nie może zawierać więcej niż 10000 elementów.
- Podczas wybierania pliku folderu przy użyciu selektora plików wynikowa ścieżka może rozpoczynać się od ciągu "//All Files", na przykład "//All Files/My Folder/MyFile.txt". Aby uniknąć tworzenia nowego folderu "Wszystkie pliki" w katalogu głównym, ta ścieżka powinna zostać ręcznie zmieniona na "/Mój folder/MyFile.txt". W przypadku odwoływania się do folderu głównego użyj pojedynczego ukośnika, takiego jak "//Wszystkie pliki" -> "/".
- Wyzwalacze są uruchamiane na wystąpieniu odpowiedniego zdarzenia niemal natychmiast w większości przypadków, ale może wystąpić rzadkie okoliczności, gdy opóźnienie wyzwalacza może potrwać do jednego dnia z powodu podstawowych ograniczeń interfejsu API. Aby dowiedzieć się więcej, przejdź do strony (Interfejs API zdarzeń usługi Box). Zaleca się przechowywanie pliku w folderze przez ten okres. W przeciwnym razie nie zostanie zgłoszony przez logikę wyzwalacza.
- Jeśli plik już istnieje w folderze, ponowne przekazanie pliku o tej samej nazwie nie będzie traktowane jako zdarzenie tworzenia, ale aktualizowanie zdarzenia.
- Ten łącznik nie jest już łącznikiem tabelarycznym i dlatego nie może być używany jako tabelaryczne źródło danych — w tym łącznik programu Excel.
- Ten łącznik może wysłać żądanie no-op do zaplecza.
Ogólne limity
| Name | Wartość |
|---|---|
| Maksymalny rozmiar pliku (w MB) | 75 |
| Maksymalna liczba elementów folderu | 10000 |
| Maksymalna liczba megabajtów przesyłanych do/z łącznika w przedziale czasu przepustowości (na połączenie) | 1000 |
| Interwał czasu przepustowości (w milisekundach) | 60000 |
Limity ograniczania
| Nazwa | Wywołania | Okres odnowienia |
|---|---|---|
| Wywołania interfejsu API na połączenie | 100 | 60 sekund |
Akcje
| Aktualizowanie pliku |
Aktualizuje istniejący plik w usłudze Box. |
| Kopiuj plik |
Skopiuj plik do ścieżki pliku w usłudze Box. |
| Pobieranie metadanych pliku przy użyciu identyfikatora |
Pobiera metadane pliku z usługi Box przy użyciu identyfikatora pliku. |
| Pobieranie metadanych pliku przy użyciu ścieżki |
Pobiera metadane pliku z usługi Box przy użyciu ścieżki. |
| Pobieranie zawartości pliku przy użyciu identyfikatora |
Pobiera zawartość pliku z usługi Box przy użyciu identyfikatora. |
| Pobieranie zawartości pliku przy użyciu ścieżki |
Pobiera zawartość pliku z usługi Box przy użyciu ścieżki. |
| Usuń plik |
Usuwa istniejący plik z usługi Box. |
| Utwórz plik |
Przekazuje plik do usługi Box. |
| Wyodrębnianie archiwum do folderu |
Wyodrębnia plik archiwum do folderu w usłudze Box (na przykład: .zip). |
| Wyświetlanie listy plików i folderów w folderze |
Wyświetla listę plików i folderów w folderze Box. |
| Wyświetlanie listy plików i folderów w folderze głównym |
Wyświetla listę plików i folderów w folderze głównym usługi Box. |
Aktualizowanie pliku
Aktualizuje istniejący plik w usłudze Box.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator pliku
|
id | True | string |
Unikatowy identyfikator pliku do zaktualizowania w usłudze Box. |
|
Zawartość pliku
|
body | True | binary |
Zawartość pliku do zaktualizowania w usłudze Box. |
Zwraca
Metadane obiektu blob
- Body
- BlobMetadata
Kopiuj plik
Skopiuj plik do ścieżki pliku w usłudze Box.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Adres URL źródła
|
source | True | string |
Adres URL do pliku źródłowego. |
|
Docelowa ścieżka pliku
|
destination | True | string |
Docelowa ścieżka pliku w polu, w tym nazwa pliku docelowego. |
|
Zastąpić
|
overwrite | boolean |
Zastępuje plik docelowy, jeśli jest ustawiony na wartość "true". |
Zwraca
Metadane obiektu blob
- Body
- BlobMetadata
Pobieranie metadanych pliku przy użyciu identyfikatora
Pobiera metadane pliku z usługi Box przy użyciu identyfikatora pliku.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator pliku
|
id | True | string |
Unikatowy identyfikator pliku w usłudze Box. |
Zwraca
Metadane obiektu blob
- Body
- BlobMetadata
Pobieranie metadanych pliku przy użyciu ścieżki
Pobiera metadane pliku z usługi Box przy użyciu ścieżki.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Ścieżka pliku
|
path | True | string |
Unikatowa ścieżka do pliku w usłudze Box. |
Zwraca
Metadane obiektu blob
- Body
- BlobMetadata
Pobieranie zawartości pliku przy użyciu identyfikatora
Pobiera zawartość pliku z usługi Box przy użyciu identyfikatora.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator pliku
|
id | True | string |
Unikatowy identyfikator pliku w usłudze Box. |
|
Wnioskowanie typu zawartości
|
inferContentType | boolean |
Wartość logiczna (true, false) do wnioskowania typu zawartości na podstawie rozszerzenia. |
Zwraca
Zawartość pliku.
- Zawartość pliku
- binary
Pobieranie zawartości pliku przy użyciu ścieżki
Pobiera zawartość pliku z usługi Box przy użyciu ścieżki.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Ścieżka pliku
|
path | True | string |
Unikatowa ścieżka do pliku w usłudze Box. |
|
Wnioskowanie typu zawartości
|
inferContentType | boolean |
Wartość logiczna (true, false) do wnioskowania typu zawartości na podstawie rozszerzenia. |
Zwraca
Zawartość pliku.
- Zawartość pliku
- binary
Usuń plik
Usuwa istniejący plik z usługi Box.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator pliku
|
id | True | string |
Unikatowy identyfikator pliku do usunięcia z usługi Box. |
Utwórz plik
Przekazuje plik do usługi Box.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Ścieżka folderu
|
folderPath | True | string |
Ścieżka folderu do przekazania pliku do urządzenia Box. |
|
Nazwa pliku
|
name | True | string |
Nazwa pliku do utworzenia w usłudze Box. |
|
Zawartość pliku
|
body | True | binary |
Zawartość pliku do przekazania do urządzenia Box. |
Zwraca
Metadane obiektu blob
- Body
- BlobMetadata
Wyodrębnianie archiwum do folderu
Wyodrębnia plik archiwum do folderu w usłudze Box (na przykład: .zip).
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Ścieżka pliku archiwum źródłowego
|
source | True | string |
Ścieżka do pliku archiwum. |
|
Ścieżka folderu docelowego
|
destination | True | string |
Ścieżka w usłudze Box w celu wyodrębnienia zawartości archiwum. |
|
Zastąpić
|
overwrite | boolean |
Zastępuje pliki docelowe, jeśli ustawiono wartość "true". |
Zwraca
- response
- array of BlobMetadata
Wyświetlanie listy plików i folderów w folderze
Wyświetla listę plików i folderów w folderze Box.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator folderu
|
id | True | string |
Unikatowy identyfikator folderu w usłudze Box. |
Zwraca
- response
- array of BlobMetadata
Wyświetlanie listy plików i folderów w folderze głównym
Wyświetla listę plików i folderów w folderze głównym usługi Box.
Zwraca
- response
- array of BlobMetadata
Wyzwalacze
| Gdy plik jest modyfikowany (tylko właściwości) |
Ta operacja wyzwala przepływ po zmodyfikowaniu pliku w folderze. Wyzwalacz nie jest uruchamiany, jeśli plik zostanie dodany/zaktualizowany w podfolderze. Jeśli jest to wymagane do wyzwolenia w podfolderach, należy utworzyć wiele wyzwalaczy. |
| Gdy plik jest modyfikowany (tylko właściwości) (wersja 2) (wersja zapoznawcza) |
Ta operacja wyzwala przepływ po zmodyfikowaniu pliku w folderze. Wyzwalacz nie jest uruchamiany, jeśli plik zostanie dodany/zaktualizowany w podfolderze. Jeśli jest to wymagane do wyzwolenia w podfolderach, należy utworzyć wiele wyzwalaczy. Jeśli opcja "Podziel wł." jest wyłączona w przypadku pomyślnych przebiegów wyzwalacza ustawienia wyzwalacza>, może spowodować wygenerowanie pustej tablicy dla danych wyjściowych "Lista plików". |
| Po utworzeniu pliku (tylko właściwości) (wersja 2) |
Ta operacja wyzwala przepływ po utworzeniu nowego pliku w folderze. Wyzwalacz nie jest uruchamiany, jeśli plik zostanie dodany/zaktualizowany w podfolderze. Jeśli jest to wymagane do wyzwolenia w podfolderach, należy utworzyć wiele wyzwalaczy. Jeśli opcja "Podziel wł." jest wyłączona w przypadku pomyślnych przebiegów wyzwalacza ustawienia wyzwalacza>, może spowodować wygenerowanie pustej tablicy dla danych wyjściowych "Lista plików". |
| Po utworzeniu pliku (tylko właściwości) [PRZESTARZAŁE] |
Ta akcja została przestarzała. Zamiast tego użyj polecenia Gdy plik jest tworzony (tylko właściwości) (wersja 2).
|
| Po utworzeniu pliku [PRZESTARZAŁE] |
Wyzwala przepływ po utworzeniu nowego pliku w folderze Box. Wyzwalacz nie jest uruchamiany, jeśli plik zostanie dodany/zaktualizowany w podfolderze. Jeśli jest to wymagane do wyzwolenia w podfolderach, należy utworzyć wiele wyzwalaczy. |
| Po zmodyfikowaniu pliku [PRZESTARZAŁE] |
Wyzwala przepływ po zmodyfikowaniu pliku w folderze Box. Wyzwalacz nie jest uruchamiany, jeśli plik zostanie dodany/zaktualizowany w podfolderze. Jeśli jest to wymagane do wyzwolenia w podfolderach, należy utworzyć wiele wyzwalaczy. |
Gdy plik jest modyfikowany (tylko właściwości)
Ta operacja wyzwala przepływ po zmodyfikowaniu pliku w folderze. Wyzwalacz nie jest uruchamiany, jeśli plik zostanie dodany/zaktualizowany w podfolderze. Jeśli jest to wymagane do wyzwolenia w podfolderach, należy utworzyć wiele wyzwalaczy.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Folder
|
folderId | True | string |
Wybieranie folderu |
|
Liczba plików do zwrócenia
|
maxFileCount | integer |
Maksymalna liczba plików zwracanych przez uruchomienie pojedynczego wyzwalacza (1–100). Należy pamiętać, że ustawienie "Split On" może wymusić wyzwalanie przetwarzania poszczególnych elementów osobno. |
Zwraca
Metadane obiektu blob
- Lista plików
- BlobMetadata
Gdy plik jest modyfikowany (tylko właściwości) (wersja 2) (wersja zapoznawcza)
Ta operacja wyzwala przepływ po zmodyfikowaniu pliku w folderze. Wyzwalacz nie jest uruchamiany, jeśli plik zostanie dodany/zaktualizowany w podfolderze. Jeśli jest to wymagane do wyzwolenia w podfolderach, należy utworzyć wiele wyzwalaczy. Jeśli opcja "Podziel wł." jest wyłączona w przypadku pomyślnych przebiegów wyzwalacza ustawienia wyzwalacza>, może spowodować wygenerowanie pustej tablicy dla danych wyjściowych "Lista plików".
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Folder
|
folderId | True | string |
Wybieranie folderu |
|
Liczba plików do zwrócenia
|
maxFileCount | integer |
Maksymalna liczba plików zwracanych przez uruchomienie pojedynczego wyzwalacza (1–100). Należy pamiętać, że ustawienie "Split On" może wymusić wyzwalanie przetwarzania poszczególnych elementów osobno. |
Zwraca
Metadane obiektu blob
- Lista plików
- BlobMetadata
Po utworzeniu pliku (tylko właściwości) (wersja 2)
Ta operacja wyzwala przepływ po utworzeniu nowego pliku w folderze. Wyzwalacz nie jest uruchamiany, jeśli plik zostanie dodany/zaktualizowany w podfolderze. Jeśli jest to wymagane do wyzwolenia w podfolderach, należy utworzyć wiele wyzwalaczy. Jeśli opcja "Podziel wł." jest wyłączona w przypadku pomyślnych przebiegów wyzwalacza ustawienia wyzwalacza>, może spowodować wygenerowanie pustej tablicy dla danych wyjściowych "Lista plików".
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Folder
|
folderId | True | string |
Unikatowy identyfikator folderu. |
|
Liczba plików do zwrócenia
|
maxFileCount | integer |
Maksymalna liczba plików zwracanych przez uruchomienie pojedynczego wyzwalacza (1–100). Należy pamiętać, że ustawienie "Split On" może wymusić wyzwalanie przetwarzania poszczególnych elementów osobno. |
Zwraca
Metadane obiektu blob
- Lista plików
- BlobMetadata
Po utworzeniu pliku (tylko właściwości) [PRZESTARZAŁE]
Ta akcja została przestarzała. Zamiast tego użyj polecenia Gdy plik jest tworzony (tylko właściwości) (wersja 2).
Ta operacja wyzwala przepływ po utworzeniu nowego pliku w folderze. Wyzwalacz nie jest uruchamiany, jeśli plik zostanie dodany/zaktualizowany w podfolderze. Jeśli jest to wymagane do wyzwolenia w podfolderach, należy utworzyć wiele wyzwalaczy.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Folder
|
folderId | True | string |
Unikatowy identyfikator folderu. |
|
Liczba plików do zwrócenia
|
maxFileCount | integer |
Maksymalna liczba plików zwracanych przez uruchomienie pojedynczego wyzwalacza (1–100). Należy pamiętać, że ustawienie "Split On" może wymusić wyzwalanie przetwarzania poszczególnych elementów osobno. |
Zwraca
Metadane obiektu blob
- Lista plików
- BlobMetadata
Po utworzeniu pliku [PRZESTARZAŁE]
Wyzwala przepływ po utworzeniu nowego pliku w folderze Box. Wyzwalacz nie jest uruchamiany, jeśli plik zostanie dodany/zaktualizowany w podfolderze. Jeśli jest to wymagane do wyzwolenia w podfolderach, należy utworzyć wiele wyzwalaczy.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator folderu
|
folderId | True | string |
Unikatowy identyfikator folderu w usłudze Box. |
|
Wnioskowanie typu zawartości
|
inferContentType | boolean |
Wartość logiczna (true, false) do wnioskowania typu zawartości na podstawie rozszerzenia. |
Zwraca
Zawartość pliku.
- Zawartość pliku
- binary
Po zmodyfikowaniu pliku [PRZESTARZAŁE]
Wyzwala przepływ po zmodyfikowaniu pliku w folderze Box. Wyzwalacz nie jest uruchamiany, jeśli plik zostanie dodany/zaktualizowany w podfolderze. Jeśli jest to wymagane do wyzwolenia w podfolderach, należy utworzyć wiele wyzwalaczy.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator folderu
|
folderId | True | string |
Unikatowy identyfikator folderu w usłudze Box. |
|
Wnioskowanie typu zawartości
|
inferContentType | boolean |
Wartość logiczna (true, false) do wnioskowania typu zawartości na podstawie rozszerzenia. |
Zwraca
Zawartość pliku.
- Zawartość pliku
- binary
Definicje
BlobMetadata
Metadane obiektu blob
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Id
|
Id | string |
Unikatowy identyfikator pliku lub folderu. |
|
Name
|
Name | string |
Nazwa pliku lub folderu. |
|
Nazwa wyświetlana
|
DisplayName | string |
Nazwa wyświetlana pliku lub folderu. |
|
Ścieżka
|
Path | string |
Ścieżka pliku lub folderu. |
|
Ostatnia modyfikacja
|
LastModified | date-time |
Data i godzina ostatniej modyfikacji pliku lub folderu. |
|
Rozmiar
|
Size | integer |
Rozmiar pliku lub folderu. |
|
Typ nośnika
|
MediaType | string |
Typ nośnika pliku lub folderu. |
|
IsFolder
|
IsFolder | boolean |
Wartość logiczna (true, false) wskazująca, czy obiekt blob jest folderem. |
|
ETag
|
ETag | string |
Element etag pliku lub folderu. |
|
FileLocator
|
FileLocator | string |
Filelocator pliku lub folderu. |
|
Ostatnio zmodyfikowane przez
|
LastModifiedBy | string |
Użytkownik, który ostatnio zmodyfikował plik lub folder. |
binarny
Jest to podstawowy typ danych "binary".