Freigeben über

Kiste

Box™ ist ein Dienst, der Ihre Dateien sicher, synchronisiert und einfach freigeben kann. Stellen Sie eine Verbindung mit Box her, um Ihre Dateien zu verwalten. Sie können verschiedene Aktionen wie Hochladen, Aktualisieren, Abrufen und Löschen von Dateien in Box ausführen.

Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:

Dienstleistung Class Regions
Copilot Studio Norm Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche:
     - China Cloud betrieben von 21Vianet
Logik-Apps Norm Alle Logik-Apps-Regionen mit Ausnahme der folgenden Bereiche:
     - Azure China-Regionen
     - US Department of Defense (DoD)
Power Apps Norm Alle Power Apps-Regionen mit Ausnahme der folgenden:
     - China Cloud betrieben von 21Vianet
Power Automate Norm Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche:
     - China Cloud betrieben von 21Vianet
Kontakt
Name Microsoft
URL Microsoft LogicApps-Unterstützung
Microsoft Power Automate-Support
Microsoft Power Apps-Unterstützung
Connectormetadaten
Herausgeber Microsoft
Webseite https://www.box.com/
Datenschutzrichtlinie https://www.box.com/legal/privacypolicy

Box-API-Status

Verwenden Sie diese Ressource, um Box-API-Ausfälle nachzuverfolgen.

Bekannte Probleme und Einschränkungen

  1. Der Connector unterstützt keine SSO-Verbindungen (Single Sign On), verwenden Sie stattdessen die Standardverbindung.
  2. Verwechseln Sie den Parameter "Dateibezeichner" nicht mit dem tatsächlichen Dateinamen. Aufgrund von Box-REST-API-Einschränkungen können ungültige Dateibezeichner mit den folgenden Zeichen - [\ { } " <>] zu Connector GetawayTimeout-Fehlern führen.
  3. Jeder Ordner im angegebenen Pfad (Ordnerpfad oder Dateipfad), einschließlich des Stammordners, darf nicht mehr als 10000 Elemente enthalten.
  4. Wenn Sie eine Datei eines Ordners mithilfe der Dateiauswahl auswählen, kann der resultierende Pfad mit "//Alle Dateien" beginnen, z. B. "//Alle Dateien/Mein Ordner/MyFile.txt". Um das Erstellen eines neuen Ordners "Alle Dateien" im Stammverzeichnis zu vermeiden, sollte dieser Pfad manuell in "/Mein Ordner/MyFile.txt" geändert werden. Verwenden Sie zum Verweisen auf den Stammordner einen einzelnen Schrägstrich, z. B. "//Alle Dateien" -> "/".
  5. Trigger werden in den meisten Fällen fast sofort auf das Auftreten des entsprechenden Ereignisses ausgelöst, aber es kann seltene Umstände geben, wenn die Verzögerung des Triggers zum Auslösen aufgrund zugrunde liegender API-Einschränkungen bis zu einem Tag dauern kann. Weitere Informationen finden Sie unter (Box Events API). Es wird empfohlen, eine Datei für diesen Zeitraum in einem Ordner zu speichern. Andernfalls wird sie nicht von der Triggerlogik gemeldet.
  6. Wenn eine Datei bereits in einem Ordner vorhanden ist, wird der erneute Upload mit demselben Namen nicht als "Ereignis erstellen", sondern als Updateereignis betrachtet.
  7. Dieser Verbinder ist kein tabellarischer Verbinder mehr und kann daher nicht als tabellarische Datenquelle verwendet werden – auch für den Excel-Connector.
  8. Dieser Connector sendet möglicherweise eine no-op Anforderung an das Back-End.

Allgemeine Grenzwerte

Name Wert
Maximale Dateigröße (in MB) 75
Maximale Anzahl von Ordnerelementen 10000
Maximale Anzahl von Megabytes, die innerhalb eines Bandbreitenzeitintervalls (pro Verbindung) an/vom Connector übertragen werden 1.000
Bandbreitenzeitintervall (in Milisekunden) 60000

Drosselungsgrenzwerte

Name Aufrufe Verlängerungszeitraum
API-Aufrufe pro Verbindung 100 60 Sekunden

Aktionen

Abrufen von Dateiinhalten mithilfe der ID

Ruft den Dateiinhalt aus Box mithilfe der ID ab.
Abrufen von Dateiinhalten mithilfe des Pfads

Ruft den Dateiinhalt aus Box mithilfe des Pfads ab.
Abrufen von Dateimetadaten mithilfe der ID

Ruft die Dateimetadaten aus Box mithilfe der Datei-ID ab.
Abrufen von Dateimetadaten mithilfe des Pfads

Ruft die Dateimetadaten aus Box mithilfe des Pfads ab.
Archiv in Ordner extrahieren

Extrahiert eine Archivdatei in einen Ordner in Box (Beispiel: .zip).
Auflisten von Dateien und Ordnern im Ordner

Listet die Dateien und Ordner in einem Box-Ordner auf.
Auflisten von Dateien und Ordnern im Stammordner

Listet die Dateien und Ordner im Box-Stammordner auf.
Datei aktualisieren

Aktualisiert eine vorhandene Datei in Box.
Datei erstellen

Lädt eine Datei in Box hoch.
Datei kopieren

Kopieren Sie eine Datei in einen Dateipfad in Box.
Datei löschen

Löscht eine vorhandene Datei aus Box.

Abrufen von Dateiinhalten mithilfe der ID

Vorgangs-ID:
GetFileContent

Ruft den Dateiinhalt aus Box mithilfe der ID ab.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Datei-ID
 id True string

Der eindeutige Bezeichner der Datei in Box.
Inhaltstyp ableiten
 inferContentType boolean

Ein boolescher Wert (true, false), um den Inhaltstyp basierend auf der Erweiterung abzuleiten.

Gibt zurück

Der Inhalt der Datei.

Inhalt der Datei
binary

Abrufen von Dateiinhalten mithilfe des Pfads

Vorgangs-ID:
GetFileContentByPath

Ruft den Dateiinhalt aus Box mithilfe des Pfads ab.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Dateipfad
 path True string

Der eindeutige Pfad zur Datei in Box.
Inhaltstyp ableiten
 inferContentType boolean

Ein boolescher Wert (true, false), um den Inhaltstyp basierend auf der Erweiterung abzuleiten.

Gibt zurück

Der Inhalt der Datei.

Inhalt der Datei
binary

Abrufen von Dateimetadaten mithilfe der ID

Vorgangs-ID:
GetFileMetadata

Ruft die Dateimetadaten aus Box mithilfe der Datei-ID ab.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Datei-ID
 id True string

Der eindeutige Bezeichner der Datei in Box.

Gibt zurück

Blobmetadaten

Body
BlobMetadata

Abrufen von Dateimetadaten mithilfe des Pfads

Vorgangs-ID:
GetFileMetadataByPath

Ruft die Dateimetadaten aus Box mithilfe des Pfads ab.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Dateipfad
 path True string

Der eindeutige Pfad zur Datei in Box.

Gibt zurück

Blobmetadaten

Body
BlobMetadata

Archiv in Ordner extrahieren

Vorgangs-ID:
ExtractFolderV2

Extrahiert eine Archivdatei in einen Ordner in Box (Beispiel: .zip).

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Quellarchivdateipfad
 source True string

Der Pfad zur Archivdatei.
Zielordnerpfad
 destination True string

Der Pfad in Box zum Extrahieren des Archivinhalts.
Überschreiben
 overwrite boolean

Überschreibt die Zieldateien, wenn sie auf "true" festgelegt sind.

Gibt zurück

response
array of BlobMetadata

Auflisten von Dateien und Ordnern im Ordner

Vorgangs-ID:
ListFolder

Listet die Dateien und Ordner in einem Box-Ordner auf.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Ordner-ID
 id True string

Der eindeutige Bezeichner des Ordners in Box.

Gibt zurück

response
array of BlobMetadata

Auflisten von Dateien und Ordnern im Stammordner

Vorgangs-ID:
ListRootFolder

Listet die Dateien und Ordner im Box-Stammordner auf.

Gibt zurück

response
array of BlobMetadata

Datei aktualisieren

Vorgangs-ID:
UpdateFile

Aktualisiert eine vorhandene Datei in Box.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Datei-ID
 id True string

Der eindeutige Bezeichner der Datei, die in Box aktualisiert werden soll.
Inhalt der Datei
 body True binary

Der Inhalt der Datei, die in Box aktualisiert werden soll.

Gibt zurück

Blobmetadaten

Body
BlobMetadata

Datei erstellen

Vorgangs-ID:
CreateFile

Lädt eine Datei in Box hoch.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Ordnerpfad
 folderPath True string

Der Ordnerpfad zum Hochladen der Datei in Box.
Dateiname
 name True string

Der Name der datei, die in Box erstellt werden soll.
Inhalt der Datei
 body True binary

Der Inhalt der Datei, die in Box hochgeladen werden soll.

Gibt zurück

Blobmetadaten

Body
BlobMetadata

Datei kopieren

Vorgangs-ID:
CopyFile

Kopieren Sie eine Datei in einen Dateipfad in Box.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Quell-URL
 source True string

Die URL zur Quelldatei.
Zieldateipfad
 destination True string

Der Zieldateipfad in Box, einschließlich Zieldateiname.
Überschreiben
 overwrite boolean

Überschreibt die Zieldatei, wenn sie auf "true" festgelegt ist.

Gibt zurück

Blobmetadaten

Body
BlobMetadata

Datei löschen

Vorgangs-ID:
DeleteFile

Löscht eine vorhandene Datei aus Box.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Datei-ID
 id True string

Der eindeutige Bezeichner der Datei, die aus Box gelöscht werden soll.

Auslöser

Beim Erstellen einer Datei (nur Eigenschaften) (V2)

Dieser Vorgang löst einen Fluss aus, wenn eine neue Datei in einem Ordner erstellt wird. Der Trigger wird nicht ausgelöst, wenn eine Datei in einem Unterordner hinzugefügt/aktualisiert wird. Wenn sie für Unterordner ausgelöst werden muss, sollten mehrere Trigger erstellt werden. Wenn die Option "Bei teilen" für erfolgreiche Triggereinstellungen> deaktiviert ist, kann ein leeres Array für die Ausgabe "Liste der Dateien" erzeugt werden.
Wenn eine Datei erstellt wird (nur Eigenschaften) [VERALTET]

Diese Aktion ist veraltet. Verwenden Sie stattdessen die Verwendung, wenn eine Datei erstellt wird (nur Eigenschaften) (V2 ).

Dieser Vorgang löst einen Fluss aus, wenn eine neue Datei in einem Ordner erstellt wird. Der Trigger wird nicht ausgelöst, wenn eine Datei in einem Unterordner hinzugefügt/aktualisiert wird. Wenn sie für Unterordner ausgelöst werden muss, sollten mehrere Trigger erstellt werden.
Wenn eine Datei erstellt wird [VERALTET]

Löst einen Fluss aus, wenn eine neue Datei in einem Box-Ordner erstellt wird. Der Trigger wird nicht ausgelöst, wenn eine Datei in einem Unterordner hinzugefügt/aktualisiert wird. Wenn sie für Unterordner ausgelöst werden muss, sollten mehrere Trigger erstellt werden.
Wenn eine Datei geändert wird (nur Eigenschaften)

Dieser Vorgang löst einen Fluss aus, wenn eine Datei in einem Ordner geändert wird. Der Trigger wird nicht ausgelöst, wenn eine Datei in einem Unterordner hinzugefügt/aktualisiert wird. Wenn sie für Unterordner ausgelöst werden muss, sollten mehrere Trigger erstellt werden.
Wenn eine Datei geändert wird (nur Eigenschaften) (V2) (Vorschau)

Dieser Vorgang löst einen Fluss aus, wenn eine Datei in einem Ordner geändert wird. Der Trigger wird nicht ausgelöst, wenn eine Datei in einem Unterordner hinzugefügt/aktualisiert wird. Wenn sie für Unterordner ausgelöst werden muss, sollten mehrere Trigger erstellt werden. Wenn die Option "Bei teilen" für erfolgreiche Triggereinstellungen> deaktiviert ist, kann ein leeres Array für die Ausgabe "Liste der Dateien" erzeugt werden.
Wenn eine Datei geändert wird [VERALTET]

Löst einen Fluss aus, wenn eine Datei in einem Box-Ordner geändert wird. Der Trigger wird nicht ausgelöst, wenn eine Datei in einem Unterordner hinzugefügt/aktualisiert wird. Wenn sie für Unterordner ausgelöst werden muss, sollten mehrere Trigger erstellt werden.

Beim Erstellen einer Datei (nur Eigenschaften) (V2)

Vorgangs-ID:
OnNewFilesV2

Dieser Vorgang löst einen Fluss aus, wenn eine neue Datei in einem Ordner erstellt wird. Der Trigger wird nicht ausgelöst, wenn eine Datei in einem Unterordner hinzugefügt/aktualisiert wird. Wenn sie für Unterordner ausgelöst werden muss, sollten mehrere Trigger erstellt werden. Wenn die Option "Bei teilen" für erfolgreiche Triggereinstellungen> deaktiviert ist, kann ein leeres Array für die Ausgabe "Liste der Dateien" erzeugt werden.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Ordner
 folderId True string

Der eindeutige Bezeichner des Ordners.
Anzahl der zurückzugebenden Dateien
 maxFileCount integer

Maximale Anzahl von Dateien, die von einem einzelnen Triggerlauf zurückgegeben werden sollen (1-100). Beachten Sie, dass die Einstellung "Split On" die Verarbeitung jedes Elements einzeln erzwingen kann.

Gibt zurück

Blobmetadaten

Liste der Dateien
BlobMetadata

Wenn eine Datei erstellt wird (nur Eigenschaften) [VERALTET]

Vorgangs-ID:
OnNewFiles

Diese Aktion ist veraltet. Verwenden Sie stattdessen die Verwendung, wenn eine Datei erstellt wird (nur Eigenschaften) (V2 ).

Dieser Vorgang löst einen Fluss aus, wenn eine neue Datei in einem Ordner erstellt wird. Der Trigger wird nicht ausgelöst, wenn eine Datei in einem Unterordner hinzugefügt/aktualisiert wird. Wenn sie für Unterordner ausgelöst werden muss, sollten mehrere Trigger erstellt werden.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Ordner
 folderId True string

Der eindeutige Bezeichner des Ordners.
Anzahl der zurückzugebenden Dateien
 maxFileCount integer

Maximale Anzahl von Dateien, die von einem einzelnen Triggerlauf zurückgegeben werden sollen (1-100). Beachten Sie, dass die Einstellung "Split On" die Verarbeitung jedes Elements einzeln erzwingen kann.

Gibt zurück

Blobmetadaten

Liste der Dateien
BlobMetadata

Wenn eine Datei erstellt wird [VERALTET]

Vorgangs-ID:
OnNewFile

Löst einen Fluss aus, wenn eine neue Datei in einem Box-Ordner erstellt wird. Der Trigger wird nicht ausgelöst, wenn eine Datei in einem Unterordner hinzugefügt/aktualisiert wird. Wenn sie für Unterordner ausgelöst werden muss, sollten mehrere Trigger erstellt werden.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Ordner-ID
 folderId True string

Der eindeutige Bezeichner des Ordners in Box.
Inhaltstyp ableiten
 inferContentType boolean

Ein boolescher Wert (true, false), um den Inhaltstyp basierend auf der Erweiterung abzuleiten.

Gibt zurück

Der Inhalt der Datei.

Inhalt der Datei
binary

Wenn eine Datei geändert wird (nur Eigenschaften)

Vorgangs-ID:
OnUpdatedFiles

Dieser Vorgang löst einen Fluss aus, wenn eine Datei in einem Ordner geändert wird. Der Trigger wird nicht ausgelöst, wenn eine Datei in einem Unterordner hinzugefügt/aktualisiert wird. Wenn sie für Unterordner ausgelöst werden muss, sollten mehrere Trigger erstellt werden.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Ordner
 folderId True string

Auswählen eines Ordners
Anzahl der zurückzugebenden Dateien
 maxFileCount integer

Maximale Anzahl von Dateien, die von einem einzelnen Triggerlauf zurückgegeben werden sollen (1-100). Beachten Sie, dass die Einstellung "Split On" die Verarbeitung jedes Elements einzeln erzwingen kann.

Gibt zurück

Blobmetadaten

Liste der Dateien
BlobMetadata

Wenn eine Datei geändert wird (nur Eigenschaften) (V2) (Vorschau)

Vorgangs-ID:
OnUpdatedFilesV2

Dieser Vorgang löst einen Fluss aus, wenn eine Datei in einem Ordner geändert wird. Der Trigger wird nicht ausgelöst, wenn eine Datei in einem Unterordner hinzugefügt/aktualisiert wird. Wenn sie für Unterordner ausgelöst werden muss, sollten mehrere Trigger erstellt werden. Wenn die Option "Bei teilen" für erfolgreiche Triggereinstellungen> deaktiviert ist, kann ein leeres Array für die Ausgabe "Liste der Dateien" erzeugt werden.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Ordner
 folderId True string

Auswählen eines Ordners
Anzahl der zurückzugebenden Dateien
 maxFileCount integer

Maximale Anzahl von Dateien, die von einem einzelnen Triggerlauf zurückgegeben werden sollen (1-100). Beachten Sie, dass die Einstellung "Split On" die Verarbeitung jedes Elements einzeln erzwingen kann.

Gibt zurück

Blobmetadaten

Liste der Dateien
BlobMetadata

Wenn eine Datei geändert wird [VERALTET]

Vorgangs-ID:
OnUpdatedFile

Löst einen Fluss aus, wenn eine Datei in einem Box-Ordner geändert wird. Der Trigger wird nicht ausgelöst, wenn eine Datei in einem Unterordner hinzugefügt/aktualisiert wird. Wenn sie für Unterordner ausgelöst werden muss, sollten mehrere Trigger erstellt werden.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Ordner-ID
 folderId True string

Der eindeutige Bezeichner des Ordners in Box.
Inhaltstyp ableiten
 inferContentType boolean

Ein boolescher Wert (true, false), um den Inhaltstyp basierend auf der Erweiterung abzuleiten.

Gibt zurück

Der Inhalt der Datei.

Inhalt der Datei
binary

Definitionen

BlobMetadata

Blobmetadaten

Name Pfad Typ Beschreibung
Id
 Id string

Die eindeutige ID der Datei oder des Ordners.
Name
 Name string

Der Name der Datei oder des Ordners.
Anzeigename
 DisplayName string

Der Anzeigename der Datei oder des Ordners.
Pfad
 Path string

Der Pfad der Datei oder des Ordners.
LastModified
 LastModified date-time

Datum und Uhrzeit der letzten Änderung der Datei oder des Ordners.
Größe
 Size integer

Die Größe der Datei oder des Ordners.
Medientyp
 MediaType string

Der Medientyp der Datei oder des Ordners.
IsFolder
 IsFolder boolean

Ein boolescher Wert (true, false), der angibt, ob es sich bei dem Blob um einen Ordner handelt.
ETag
 ETag string

Das Etag der Datei oder des Ordners.
FileLocator
 FileLocator string

Der Filelocator der Datei oder des Ordners.
LastModifiedBy
 LastModifiedBy string

Der Benutzer, der die Datei oder den Ordner zuletzt geändert hat.

binär

Dies ist der grundlegende Datentyp "binary".