Sdílet prostřednictvím

Krabice

Box™ je služba, která udržuje vaše soubory v bezpečí, synchronizované a snadno sdílet. Připojte se k Boxu a spravujte soubory. V Boxu můžete provádět různé akce, jako je nahrávání, aktualizace, získávání a odstraňování souborů.

Tento konektor je dostupný v následujících produktech a oblastech:

Service Class Regions
Copilot Studio Standard Všechny oblasti Power Automate s výjimkou následujících:
     - China Cloud provozovaný společností 21Vianet
Logic Apps Standard Všechny oblasti Logic Apps s výjimkou následujících:
     – Oblasti Azure China
     - Ministerstvo obrany USA (DoD)
Power Apps Standard Všechny oblasti Power Apps s výjimkou následujících:
     - China Cloud provozovaný společností 21Vianet
Power Automate Standard Všechny oblasti Power Automate s výjimkou následujících:
     - China Cloud provozovaný společností 21Vianet
Kontakt
Název Microsoft
URL Podpora Microsoft LogicApps
Podpora microsoft Power Automate
Podpora Microsoft Power Apps
Metadata konektoru
Vydavatel Microsoft
Internetová stránka https://www.box.com/
Zásady ochrany osobních údajů https://www.box.com/legal/privacypolicy

Stav rozhraní API boxu

Pokud chcete sledovat výpadky rozhraní BOX API, použijte tento prostředek.

Známé problémy a omezení

  1. Konektor nepodporuje připojení jednotného přihlašování (SSO), použijte místo toho standardní připojení.
  2. Nezaměňujte parametr identifikátoru souboru se skutečným názvem souboru. Kvůli omezením rozhraní REST API boxu můžou neplatné identifikátory souborů s následujícími znaky – [\ { } " <>] vést k chybám konektoru GetawayTimeout.
  3. Každá složka v zadané cestě (cesta ke složce nebo cesta k souboru), včetně kořenové složky nesmí obsahovat více než 1 0000 položek.
  4. Při výběru souboru složky pomocí výběru souboru může výsledná cesta začínat na //Všechny soubory, například //All Files/My Folder/MyFile.txt. Abyste se vyhnuli vytváření nové složky Všechny soubory v kořenovém adresáři, měla by se tato cesta ručně změnit na /Moje složka/MyFile.txt. Pro odkazování na kořenovou složku použijte jedno lomítko, například //All Files –> /.
  5. Triggery se ve většině případů aktivují téměř okamžitě u výskytu odpovídající události, ale v důsledku omezení základního rozhraní API může trvat až jeden den zpoždění triggeru. Další informace najdete v části (Box Events API). Pro toto období doporučujeme uchovávat soubor ve složce. Jinak ji logika triggeru neohlásí.
  6. Pokud již soubor ve složce existuje, soubor se znovu nahraje se stejným názvem, nebude považován za událost vytvoření, ale aktualizaci události.
  7. Tento konektor už není tabulkovým konektorem, a proto ho nelze použít jako tabulkový zdroj dat , včetně konektoru aplikace Excel.
  8. Tento konektor může odeslat no-op požadavek na back-end.

Obecné limity

Název Hodnota
Maximální velikost souboru (v MB) 75
Maximální počet položek složky 10000
Maximální počet megabajtů přenášených do/z konektoru v časovém intervalu šířky pásma (na připojení) 1 000
Časový interval šířky pásma (v milisekundách) 60000

Limity omezování

Name Volání Období obnovení
Volání rozhraní API na připojení 100 60 sekund

Akce

Aktualizovat soubor

Aktualizuje existující soubor v Boxu.
Extrahování archivu do složky

Extrahuje soubor archivu do složky v Boxu (příklad: .zip).
Kopírování souboru

Zkopírujte soubor do cesty k souboru v Boxu.
Odstranit soubor

Odstraní existující soubor z Boxu.
Vytvořit soubor

Nahraje soubor do Boxu.
Výpis souborů a složek v kořenové složce

Zobrazí seznam souborů a složek v kořenové složce Boxu.
Výpis souborů a složek ve složce

Zobrazí seznam souborů a složek ve složce Box.
Získání metadat souboru pomocí cesty

Načte metadata souboru z Boxu pomocí cesty.
Získání metadat souborů pomocí ID

Načte metadata souboru z Boxu pomocí ID souboru.
Získání obsahu souboru pomocí cesty

Načte obsah souboru z Boxu pomocí cesty.
Získání obsahu souboru pomocí ID

Načte obsah souboru z Boxu pomocí ID.

Aktualizovat soubor

ID operace:
UpdateFile

Aktualizuje existující soubor v Boxu.

Parametry

Name Klíč Vyžadováno Typ Description
ID souboru
 id True string

Jedinečný identifikátor souboru, který se má aktualizovat v Boxu.
Obsah souboru
 body True binary

Obsah souboru, který se má aktualizovat v Boxu.

Návraty

Metadata objektů blob

Body
BlobMetadata

Extrahování archivu do složky

ID operace:
ExtractFolderV2

Extrahuje soubor archivu do složky v Boxu (příklad: .zip).

Parametry

Name Klíč Vyžadováno Typ Description
Cesta k souboru zdrojového archivu
 source True string

Cesta k souboru archivu.
Cílová cesta ke složce
 destination True string

Cesta v Boxu k extrahování obsahu archivu.
Přepsat
 overwrite boolean

Pokud je nastavená hodnota true, přepíše cílové soubory.

Návraty

response
array of BlobMetadata

Kopírování souboru

ID operace:
CopyFile

Zkopírujte soubor do cesty k souboru v Boxu.

Parametry

Name Klíč Vyžadováno Typ Description
Zdrojová adresa URL
 source True string

Adresa URL zdrojového souboru.
Cílová cesta k souboru
 destination True string

Cílová cesta k souboru v Boxu, včetně cílového názvu souboru.
Přepsat
 overwrite boolean

Pokud je nastavená hodnota true, přepíše cílový soubor.

Návraty

Metadata objektů blob

Body
BlobMetadata

Odstranit soubor

ID operace:
DeleteFile

Odstraní existující soubor z Boxu.

Parametry

Name Klíč Vyžadováno Typ Description
ID souboru
 id True string

Jedinečný identifikátor souboru, který chcete odstranit z Boxu.

Vytvořit soubor

ID operace:
CreateFile

Nahraje soubor do Boxu.

Parametry

Name Klíč Vyžadováno Typ Description
Cesta ke složce
 folderPath True string

Cesta ke složce pro nahrání souboru do Boxu.
Název souboru
 name True string

Název souboru, který chcete vytvořit v Boxu.
Obsah souboru
 body True binary

Obsah souboru, který chcete nahrát do Boxu.

Návraty

Metadata objektů blob

Body
BlobMetadata

Výpis souborů a složek v kořenové složce

ID operace:
ListRootFolder

Zobrazí seznam souborů a složek v kořenové složce Boxu.

Návraty

response
array of BlobMetadata

Výpis souborů a složek ve složce

ID operace:
ListFolder

Zobrazí seznam souborů a složek ve složce Box.

Parametry

Name Klíč Vyžadováno Typ Description
ID složky
 id True string

Jedinečný identifikátor složky v Boxu.

Návraty

response
array of BlobMetadata

Získání metadat souboru pomocí cesty

ID operace:
GetFileMetadataByPath

Načte metadata souboru z Boxu pomocí cesty.

Parametry

Name Klíč Vyžadováno Typ Description
Cesta k souboru
 path True string

Jedinečná cesta k souboru v Boxu.

Návraty

Metadata objektů blob

Body
BlobMetadata

Získání metadat souborů pomocí ID

ID operace:
GetFileMetadata

Načte metadata souboru z Boxu pomocí ID souboru.

Parametry

Name Klíč Vyžadováno Typ Description
ID souboru
 id True string

Jedinečný identifikátor souboru v boxu.

Návraty

Metadata objektů blob

Body
BlobMetadata

Získání obsahu souboru pomocí cesty

ID operace:
GetFileContentByPath

Načte obsah souboru z Boxu pomocí cesty.

Parametry

Name Klíč Vyžadováno Typ Description
Cesta k souboru
 path True string

Jedinečná cesta k souboru v Boxu.
Odvození typu obsahu
 inferContentType boolean

Logická hodnota (true, false) pro odvození typu obsahu na základě rozšíření.

Návraty

Obsah souboru.

Obsah souboru
binary

Získání obsahu souboru pomocí ID

ID operace:
GetFileContent

Načte obsah souboru z Boxu pomocí ID.

Parametry

Name Klíč Vyžadováno Typ Description
ID souboru
 id True string

Jedinečný identifikátor souboru v boxu.
Odvození typu obsahu
 inferContentType boolean

Logická hodnota (true, false) pro odvození typu obsahu na základě rozšíření.

Návraty

Obsah souboru.

Obsah souboru
binary

Aktivační události

Při vytvoření souboru (pouze vlastnosti) (V2)

Tato operace aktivuje tok při vytvoření nového souboru ve složce. Trigger se neaktivuje, pokud je soubor přidaný nebo aktualizovaný v podsložce. Pokud se vyžaduje k aktivaci v podsložkách, mělo by se vytvořit více aktivačních událostí. V případě, že je u úspěšných spuštění aktivačních událostí nastavení triggeru> vypnutá možnost Split On (Rozdělit zapnuto), může být pro výstup seznamu souborů generované prázdné pole.
Při vytvoření souboru (pouze vlastnosti) [ZASTARALÉ]

Tato akce je zastaralá. Použijte místo toho soubor Při vytvoření souboru (pouze vlastnosti) (V2).

Tato operace aktivuje tok při vytvoření nového souboru ve složce. Trigger se neaktivuje, pokud je soubor přidaný nebo aktualizovaný v podsložce. Pokud se vyžaduje k aktivaci v podsložkách, mělo by se vytvořit více aktivačních událostí.
Při vytvoření souboru [ZASTARALÉ]

Aktivuje tok při vytvoření nového souboru ve složce Box. Trigger se neaktivuje, pokud je soubor přidaný nebo aktualizovaný v podsložce. Pokud se vyžaduje k aktivaci v podsložkách, mělo by se vytvořit více aktivačních událostí.
Při změně souboru (pouze vlastnosti)

Tato operace aktivuje tok při úpravě souboru ve složce. Trigger se neaktivuje, pokud je soubor přidaný nebo aktualizovaný v podsložce. Pokud se vyžaduje k aktivaci v podsložkách, mělo by se vytvořit více aktivačních událostí.
Při změně souboru (pouze vlastnosti) (V2) (Preview)

Tato operace aktivuje tok při úpravě souboru ve složce. Trigger se neaktivuje, pokud je soubor přidaný nebo aktualizovaný v podsložce. Pokud se vyžaduje k aktivaci v podsložkách, mělo by se vytvořit více aktivačních událostí. V případě, že je u úspěšných spuštění aktivačních událostí nastavení triggeru> vypnutá možnost Split On (Rozdělit zapnuto), může být pro výstup seznamu souborů generované prázdné pole.
Při změně souboru [ZASTARALÉ]

Aktivuje tok při úpravě souboru ve složce Boxu. Trigger se neaktivuje, pokud je soubor přidaný nebo aktualizovaný v podsložce. Pokud se vyžaduje k aktivaci v podsložkách, mělo by se vytvořit více aktivačních událostí.

Při vytvoření souboru (pouze vlastnosti) (V2)

ID operace:
OnNewFilesV2

Tato operace aktivuje tok při vytvoření nového souboru ve složce. Trigger se neaktivuje, pokud je soubor přidaný nebo aktualizovaný v podsložce. Pokud se vyžaduje k aktivaci v podsložkách, mělo by se vytvořit více aktivačních událostí. V případě, že je u úspěšných spuštění aktivačních událostí nastavení triggeru> vypnutá možnost Split On (Rozdělit zapnuto), může být pro výstup seznamu souborů generované prázdné pole.

Parametry

Name Klíč Vyžadováno Typ Description
Složka
 folderId True string

Jedinečný identifikátor složky.
Počet souborů, které se mají vrátit
 maxFileCount integer

Maximální počet souborů, které se mají vrátit jedním spuštěním triggeru (1–100). Všimněte si, že nastavení Split On může vynutit, aby trigger zpracovával jednotlivé položky jednotlivě.

Návraty

Metadata objektů blob

Seznam souborů
BlobMetadata

Při vytvoření souboru (pouze vlastnosti) [ZASTARALÉ]

ID operace:
OnNewFiles

Tato akce je zastaralá. Použijte místo toho soubor Při vytvoření souboru (pouze vlastnosti) (V2).

Tato operace aktivuje tok při vytvoření nového souboru ve složce. Trigger se neaktivuje, pokud je soubor přidaný nebo aktualizovaný v podsložce. Pokud se vyžaduje k aktivaci v podsložkách, mělo by se vytvořit více aktivačních událostí.

Parametry

Name Klíč Vyžadováno Typ Description
Složka
 folderId True string

Jedinečný identifikátor složky.
Počet souborů, které se mají vrátit
 maxFileCount integer

Maximální počet souborů, které se mají vrátit jedním spuštěním triggeru (1–100). Všimněte si, že nastavení Split On může vynutit, aby trigger zpracovával jednotlivé položky jednotlivě.

Návraty

Metadata objektů blob

Seznam souborů
BlobMetadata

Při vytvoření souboru [ZASTARALÉ]

ID operace:
OnNewFile

Aktivuje tok při vytvoření nového souboru ve složce Box. Trigger se neaktivuje, pokud je soubor přidaný nebo aktualizovaný v podsložce. Pokud se vyžaduje k aktivaci v podsložkách, mělo by se vytvořit více aktivačních událostí.

Parametry

Name Klíč Vyžadováno Typ Description
ID složky
 folderId True string

Jedinečný identifikátor složky v Boxu.
Odvození typu obsahu
 inferContentType boolean

Logická hodnota (true, false) pro odvození typu obsahu na základě rozšíření.

Návraty

Obsah souboru.

Obsah souboru
binary

Při změně souboru (pouze vlastnosti)

ID operace:
OnUpdatedFiles

Tato operace aktivuje tok při úpravě souboru ve složce. Trigger se neaktivuje, pokud je soubor přidaný nebo aktualizovaný v podsložce. Pokud se vyžaduje k aktivaci v podsložkách, mělo by se vytvořit více aktivačních událostí.

Parametry

Name Klíč Vyžadováno Typ Description
Složka
 folderId True string

Výběr složky
Počet souborů, které se mají vrátit
 maxFileCount integer

Maximální počet souborů, které se mají vrátit jedním spuštěním triggeru (1–100). Všimněte si, že nastavení Split On může vynutit, aby trigger zpracovával jednotlivé položky jednotlivě.

Návraty

Metadata objektů blob

Seznam souborů
BlobMetadata

Při změně souboru (pouze vlastnosti) (V2) (Preview)

ID operace:
OnUpdatedFilesV2

Tato operace aktivuje tok při úpravě souboru ve složce. Trigger se neaktivuje, pokud je soubor přidaný nebo aktualizovaný v podsložce. Pokud se vyžaduje k aktivaci v podsložkách, mělo by se vytvořit více aktivačních událostí. V případě, že je u úspěšných spuštění aktivačních událostí nastavení triggeru> vypnutá možnost Split On (Rozdělit zapnuto), může být pro výstup seznamu souborů generované prázdné pole.

Parametry

Name Klíč Vyžadováno Typ Description
Složka
 folderId True string

Výběr složky
Počet souborů, které se mají vrátit
 maxFileCount integer

Maximální počet souborů, které se mají vrátit jedním spuštěním triggeru (1–100). Všimněte si, že nastavení Split On může vynutit, aby trigger zpracovával jednotlivé položky jednotlivě.

Návraty

Metadata objektů blob

Seznam souborů
BlobMetadata

Při změně souboru [ZASTARALÉ]

ID operace:
OnUpdatedFile

Aktivuje tok při úpravě souboru ve složce Boxu. Trigger se neaktivuje, pokud je soubor přidaný nebo aktualizovaný v podsložce. Pokud se vyžaduje k aktivaci v podsložkách, mělo by se vytvořit více aktivačních událostí.

Parametry

Name Klíč Vyžadováno Typ Description
ID složky
 folderId True string

Jedinečný identifikátor složky v Boxu.
Odvození typu obsahu
 inferContentType boolean

Logická hodnota (true, false) pro odvození typu obsahu na základě rozšíření.

Návraty

Obsah souboru.

Obsah souboru
binary

Definice

BlobMetadata

Metadata objektů blob

Name Cesta Typ Description
identifikační číslo
 Id string

Jedinečné ID souboru nebo složky.
Název
 Name string

Název souboru nebo složky.
ZobrazovanéJméno
 DisplayName string

Zobrazovaný název souboru nebo složky.
Cesta
 Path string

Cesta k souboru nebo složce.
Naposledy upraveno
 LastModified date-time

Datum a čas poslední změny souboru nebo složky.
Velikost
 Size integer

Velikost souboru nebo složky.
MediaType
 MediaType string

Typ média souboru nebo složky.
IsFolder
 IsFolder boolean

Logická hodnota (true, false) označující, jestli je objekt blob složkou nebo ne.
ETag
 ETag string

Etag souboru nebo složky.
FileLocator
 FileLocator string

Lokátor souboru nebo složky.
Poslední úprava provedena kým
 LastModifiedBy string

Uživatel, který soubor nebo složku naposledy upravil

binární

Toto je základní datový typ Binary.