Dropbox
Dropbox to usługa, która zapewnia bezpieczeństwo, synchronizowanie i łatwe udostępnianie plików. Połącz się z usługą Dropbox, aby zarządzać plikami. W usłudze Dropbox 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: - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| 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: - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Power Automate | Standard | Wszystkie regiony usługi Power Automate z wyjątkiem następujących: - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| 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.dropbox.com/ |
| Zasady ochrony prywatności | https://www.dropbox.com/privacy |
Znane problemy i ograniczenia
- Ze względu na ograniczenia interfejsu API REST usługi Dropbox obecnie obsługujemy tylko foldery osobiste i udostępnione. Foldery zespołu nie są obsługiwane.
- 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.
- Nie można wybrać folderu, który jest prywatny dla grupy. Nawet jeśli jesteś członkiem tej grupy.
- 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) | 50 |
| Maksymalny rozmiar pliku dla operacji kopiowania (w MB) | 300 |
| 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 |
Ta operacja aktualizuje plik. |
| Kopiuj plik |
Ta operacja kopiuje plik do usługi Dropbox. |
| Pobieranie metadanych pliku |
Ta operacja pobiera metadane dla pliku. |
| Pobieranie metadanych pliku przy użyciu ścieżki |
Ta operacja pobiera metadane pliku przy użyciu ścieżki. |
| Pobieranie zawartości pliku przy użyciu ścieżki |
Ta operacja pobiera zawartość pliku przy użyciu ścieżki. |
| Pobierz zawartość pliku |
Ta operacja pobiera zawartość pliku. |
| Usuń plik |
Ta operacja usuwa plik. |
| Utwórz plik |
Ta operacja tworzy plik w folderze. |
| Wyodrębnianie archiwum do folderu |
Ta operacja wyodrębnia plik archiwum do folderu (na przykład: .zip). |
| Wyświetlanie listy plików w folderze |
Ta operacja pobiera listę plików i podfolderów w folderze. |
| Wyświetlanie listy plików w folderze głównym |
Ta operacja pobiera listę plików i podfolderów w folderze głównym. |
Aktualizowanie pliku
Ta operacja aktualizuje plik.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
File
|
id | True | string |
Unikatowy identyfikator pliku. |
|
Zawartość pliku
|
body | True | binary |
Zawartość pliku. |
Zwraca
Metadane obiektu blob
- Body
- BlobMetadata
Kopiuj plik
Ta operacja kopiuje plik do usługi Dropbox.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Źródłowy adres URL
|
source | True | string |
Adres URL do pliku źródłowego |
|
Docelowa ścieżka pliku
|
destination | True | string |
Docelowa ścieżka pliku, 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
Ta operacja pobiera metadane dla pliku.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
File
|
id | True | string |
Unikatowy identyfikator pliku. |
Zwraca
Metadane obiektu blob
- Body
- BlobMetadata
Pobieranie metadanych pliku przy użyciu ścieżki
Ta operacja pobiera metadane pliku przy użyciu ścieżki.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Ścieżka pliku
|
path | True | string |
Unikatowa ścieżka pliku. |
Zwraca
Metadane obiektu blob
- Body
- BlobMetadata
Pobieranie zawartości pliku przy użyciu ścieżki
Ta operacja pobiera zawartość pliku przy użyciu ścieżki.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Ścieżka pliku
|
path | True | string |
Unikatowa ścieżka pliku. |
|
Wnioskowanie typu zawartości
|
inferContentType | boolean |
Wartość logiczna (true, false) do wnioskowania typu zawartości na podstawie rozszerzenia. |
Zwraca
Zawartość pliku.
- Zawartość pliku
- binary
Pobierz zawartość pliku
Ta operacja pobiera zawartość pliku.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
File
|
id | True | string |
Unikatowy identyfikator pliku. |
|
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
Ta operacja usuwa plik.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
File
|
id | True | string |
Unikatowy identyfikator pliku. |
Utwórz plik
Ta operacja tworzy plik w folderze.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Ścieżka folderu
|
folderPath | True | string |
Ścieżka do folderu. |
|
Nazwa pliku
|
name | True | string |
Nazwa pliku. |
|
Zawartość pliku
|
body | True | binary |
Zawartość pliku. |
Zwraca
Metadane obiektu blob
- Body
- BlobMetadata
Wyodrębnianie archiwum do folderu
Ta operacja wyodrębnia plik archiwum do folderu (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 do 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 w folderze
Ta operacja pobiera listę plików i podfolderów w folderze.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Folder
|
id | True | string |
Unikatowy identyfikator folderu. |
Zwraca
- response
- array of BlobMetadata
Wyświetlanie listy plików w folderze głównym
Ta operacja pobiera listę plików i podfolderów w folderze głównym.
Zwraca
- response
- array of BlobMetadata
Wyzwalacze
| Gdy plik jest modyfikowany |
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) |
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. |
| Po utworzeniu pliku |
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. |
| Po utworzeniu pliku (tylko właściwości) |
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. |
Gdy plik jest modyfikowany
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 |
Unikatowy identyfikator folderu. |
|
Wnioskowanie typu zawartości
|
inferContentType | boolean |
Wartość logiczna (true, false) do wnioskowania typu zawartości na podstawie rozszerzenia. |
Zwraca
Zawartość pliku.
- Zawartość pliku
- binary
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
Po utworzeniu pliku
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. |
|
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 utworzeniu pliku (tylko właściwości)
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
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. |
binarny
Jest to podstawowy typ danych "binary".