Dela via

Låda

Box™ är en tjänst som håller dina filer säkra, synkroniserade och enkla att dela. Anslut till Box för att hantera dina filer. Du kan utföra olika åtgärder som att ladda upp, uppdatera, hämta och ta bort filer i Box.

Den här anslutningsappen är tillgänglig i följande produkter och regioner:

Tjänster Class Regioner
Copilot Studio Norm Alla Power Automate-regioner utom följande:
     – China Cloud drivs av 21Vianet
Logiska appar Norm Alla Logic Apps-regioner utom följande:
     – Regioner i Azure Kina
     - US Department of Defense (DoD)
Power Apps Norm Alla Power Apps-regioner utom följande:
     – China Cloud drivs av 21Vianet
Power Automate Norm Alla Power Automate-regioner utom följande:
     – China Cloud drivs av 21Vianet
Kontakt
Namn Microsoft
URL Microsoft LogicApps Support
Microsoft Power Automate-support
Microsoft Power Apps Support
Metadata för anslutningsprogram
Utgivare Microsoft
Webbplats https://www.box.com/
Sekretesspolicy https://www.box.com/legal/privacypolicy

Box API-status

Använd den här resursen för att spåra avbrott i Box API

Kända problem och begränsningar

  1. Anslutningsappen stöder inte anslutningar med enkel inloggning (SSO), använd standardanslutningen i stället.
  2. Förväxla inte filidentifierarparametern med det faktiska filnamnet. På grund av Box REST API-begränsningar kan ogiltiga filidentifierare med följande tecken - [\ { } " <>] leda till anslutningsfel för GetawayTimeout.
  3. Varje mapp i den angivna sökvägen (mappsökväg eller filsökväg), inklusive rotmappen får inte innehålla fler än 1 0000 objekt.
  4. När du väljer en fil i en mapp med filväljaren kan den resulterande sökvägen börja med "//Alla filer", till exempel "//Alla filer/Min mapp/MyFile.txt". För att undvika att skapa den nya mappen Alla filer i roten bör den här sökvägen ändras manuellt till "/Min mapp/MyFile.txt". För att referera till rotmappen använder du ett enda snedstreck, till exempel "//Alla filer" –> "/".
  5. Utlöser eld på motsvarande händelses förekomst nästan omedelbart i de flesta fall, men det kan finnas sällsynta omständigheter när utlösarens fördröjning till brand kan ta upp till en dag på grund av underliggande API-begränsningar. Mer information finns i (Box Events API). Vi rekommenderar att du behåller en fil i en mapp under den perioden. Annars rapporteras det inte av utlösarlogik.
  6. Om det redan finns en fil i en mapp betraktas inte filuppladdning med samma namn som skapa händelse utan uppdateringshändelse.
  7. Den här anslutningsappen är inte längre en tabellanslutning och kan därför inte användas som en tabelldatakälla , inklusive för Excel-anslutningsappen.
  8. Den här anslutningsappen kan skicka en no-op begäran till serverdelen.

Allmänna gränser

Namn Värde
Maximal filstorlek (i MB) 75
Maximalt antal mappobjekt 10000
Maximalt antal megabyte som överförs till/från anslutningsappen inom ett bandbreddsintervall (per anslutning) 1 000
Bandbreddstidsintervall (i miliseconds) 60000

Begränsningsgränser

Name Anrop Förnyelseperiod
API-anrop per anslutning 100 60 sekunder

Åtgärder

Extrahera arkiv till mapp

Extraherar en arkivfil till en mapp i Box (exempel: .zip).
Hämta filinnehåll med hjälp av ID

Hämtar filinnehållet från Box med hjälp av ID.
Hämta filinnehåll med hjälp av sökvägen

Hämtar filinnehållet från Box med hjälp av sökvägen.
Hämta filmetadata med hjälp av ID

Hämtar filmetadata från Box med hjälp av fil-ID.
Hämta filmetadata med hjälp av sökvägen

Hämtar filmetadata från Box med hjälp av sökvägen.
Kopiera fil

Kopiera en fil till en filsökväg i Box.
Skapa fil

Laddar upp en fil till Box.
Ta bort fil

Tar bort en befintlig fil från Box.
Uppdatera fil

Uppdaterar en befintlig fil i Box.
Visa en lista över filer och mappar i mappen

Visar en lista över filer och mappar i en Box-mapp.
Visa en lista över filer och mappar i rotmappen

Visar en lista över filer och mappar i rotmappen Box.

Extrahera arkiv till mapp

Åtgärds-ID:
ExtractFolderV2

Extraherar en arkivfil till en mapp i Box (exempel: .zip).

Parametrar

Name Nyckel Obligatorisk Typ Description
Sökväg till källarkivfil
 source True string

Sökvägen till arkivfilen.
Sökväg till målmapp
 destination True string

Sökvägen i Box för att extrahera arkivinnehållet.
Skriv över
 overwrite boolean

Skriver över målfilerna om de är inställda på "true".

Returer

response
array of BlobMetadata

Hämta filinnehåll med hjälp av ID

Åtgärds-ID:
GetFileContent

Hämtar filinnehållet från Box med hjälp av ID.

Parametrar

Name Nyckel Obligatorisk Typ Description
Fil-ID
 id True string

Den unika identifieraren för filen i Box.
Härled innehållstyp
 inferContentType boolean

Ett booleskt värde (sant, falskt) för att härleda innehållstyp baserat på tillägg.

Returer

Innehållet i filen.

Filinnehåll
binary

Hämta filinnehåll med hjälp av sökvägen

Åtgärds-ID:
GetFileContentByPath

Hämtar filinnehållet från Box med hjälp av sökvägen.

Parametrar

Name Nyckel Obligatorisk Typ Description
Filsökväg
 path True string

Den unika sökvägen till filen i Box.
Härled innehållstyp
 inferContentType boolean

Ett booleskt värde (sant, falskt) för att härleda innehållstyp baserat på tillägg.

Returer

Innehållet i filen.

Filinnehåll
binary

Hämta filmetadata med hjälp av ID

Åtgärds-ID:
GetFileMetadata

Hämtar filmetadata från Box med hjälp av fil-ID.

Parametrar

Name Nyckel Obligatorisk Typ Description
Fil-ID
 id True string

Den unika identifieraren för filen i Box.

Returer

Blob-metadata

Body
BlobMetadata

Hämta filmetadata med hjälp av sökvägen

Åtgärds-ID:
GetFileMetadataByPath

Hämtar filmetadata från Box med hjälp av sökvägen.

Parametrar

Name Nyckel Obligatorisk Typ Description
Filsökväg
 path True string

Den unika sökvägen till filen i Box.

Returer

Blob-metadata

Body
BlobMetadata

Kopiera fil

Åtgärds-ID:
CopyFile

Kopiera en fil till en filsökväg i Box.

Parametrar

Name Nyckel Obligatorisk Typ Description
Käll-URL
 source True string

URL:en till källfilen.
Målfilsökväg
 destination True string

Målfilens sökväg i Box, inklusive målfilnamnet.
Skriv över
 overwrite boolean

Skriver över målfilen om den är inställd på "true".

Returer

Blob-metadata

Body
BlobMetadata

Skapa fil

Åtgärds-ID:
CreateFile

Laddar upp en fil till Box.

Parametrar

Name Nyckel Obligatorisk Typ Description
Mappsökväg
 folderPath True string

Mappsökvägen för att ladda upp filen till Box.
Filnamn
 name True string

Namnet på filen som ska skapas i Box.
Filinnehåll
 body True binary

Innehållet i filen som ska laddas upp till Box.

Returer

Blob-metadata

Body
BlobMetadata

Ta bort fil

Åtgärds-ID:
DeleteFile

Tar bort en befintlig fil från Box.

Parametrar

Name Nyckel Obligatorisk Typ Description
Fil-ID
 id True string

Den unika identifieraren för filen som ska tas bort från Box.

Uppdatera fil

Åtgärds-ID:
UpdateFile

Uppdaterar en befintlig fil i Box.

Parametrar

Name Nyckel Obligatorisk Typ Description
Fil-ID
 id True string

Den unika identifieraren för filen som ska uppdateras i Box.
Filinnehåll
 body True binary

Innehållet i filen som ska uppdateras i Box.

Returer

Blob-metadata

Body
BlobMetadata

Visa en lista över filer och mappar i mappen

Åtgärds-ID:
ListFolder

Visar en lista över filer och mappar i en Box-mapp.

Parametrar

Name Nyckel Obligatorisk Typ Description
Mapp-ID
 id True string

Den unika identifieraren för mappen i Box.

Returer

response
array of BlobMetadata

Visa en lista över filer och mappar i rotmappen

Åtgärds-ID:
ListRootFolder

Visar en lista över filer och mappar i rotmappen Box.

Returer

response
array of BlobMetadata

Utlösare

När en fil skapas (endast egenskaper) (V2)

Den här åtgärden utlöser ett flöde när en ny fil skapas i en mapp. Utlösaren utlöses inte om en fil läggs till/uppdateras i en undermapp. Om det krävs för att utlösa på undermappar bör flera utlösare skapas. Om alternativet "Dela på" är inaktiverat för utlösarkörningar med utlösare för utlösare> kan det generera en tom matris för utdata från "Lista över filer".
När en fil skapas (endast egenskaper) [INAKTUELL]

Den här åtgärden är inaktuell. Använd När en fil skapas (endast egenskaper) (V2) i stället.

Den här åtgärden utlöser ett flöde när en ny fil skapas i en mapp. Utlösaren utlöses inte om en fil läggs till/uppdateras i en undermapp. Om det krävs för att utlösa på undermappar bör flera utlösare skapas.
När en fil skapas [INAKTUELL]

Utlöser ett flöde när en ny fil skapas i en Box-mapp. Utlösaren utlöses inte om en fil läggs till/uppdateras i en undermapp. Om det krävs för att utlösa på undermappar bör flera utlösare skapas.
När en fil ändras (endast egenskaper)

Den här åtgärden utlöser ett flöde när en fil ändras i en mapp. Utlösaren utlöses inte om en fil läggs till/uppdateras i en undermapp. Om det krävs för att utlösa på undermappar bör flera utlösare skapas.
När en fil ändras (endast egenskaper) (V2) (förhandsversion)

Den här åtgärden utlöser ett flöde när en fil ändras i en mapp. Utlösaren utlöses inte om en fil läggs till/uppdateras i en undermapp. Om det krävs för att utlösa på undermappar bör flera utlösare skapas. Om alternativet "Dela på" är inaktiverat för utlösarkörningar med utlösare för utlösare> kan det generera en tom matris för utdata från "Lista över filer".
När en fil ändras [INAKTUELL]

Utlöser ett flöde när en fil ändras i en Box-mapp. Utlösaren utlöses inte om en fil läggs till/uppdateras i en undermapp. Om det krävs för att utlösa på undermappar bör flera utlösare skapas.

När en fil skapas (endast egenskaper) (V2)

Åtgärds-ID:
OnNewFilesV2

Den här åtgärden utlöser ett flöde när en ny fil skapas i en mapp. Utlösaren utlöses inte om en fil läggs till/uppdateras i en undermapp. Om det krävs för att utlösa på undermappar bör flera utlösare skapas. Om alternativet "Dela på" är inaktiverat för utlösarkörningar med utlösare för utlösare> kan det generera en tom matris för utdata från "Lista över filer".

Parametrar

Name Nyckel Obligatorisk Typ Description
Mapp
 folderId True string

Den unika identifieraren för mappen.
Antal filer som ska returneras
 maxFileCount integer

Maximalt antal filer som ska returneras av en utlösarkörning (1–100). Observera att inställningen "Dela på" kan tvinga utlösaren att bearbeta varje objekt individuellt.

Returer

Blob-metadata

Lista över filer
BlobMetadata

När en fil skapas (endast egenskaper) [INAKTUELL]

Åtgärds-ID:
OnNewFiles

Den här åtgärden är inaktuell. Använd När en fil skapas (endast egenskaper) (V2) i stället.

Den här åtgärden utlöser ett flöde när en ny fil skapas i en mapp. Utlösaren utlöses inte om en fil läggs till/uppdateras i en undermapp. Om det krävs för att utlösa på undermappar bör flera utlösare skapas.

Parametrar

Name Nyckel Obligatorisk Typ Description
Mapp
 folderId True string

Den unika identifieraren för mappen.
Antal filer som ska returneras
 maxFileCount integer

Maximalt antal filer som ska returneras av en utlösarkörning (1–100). Observera att inställningen "Dela på" kan tvinga utlösaren att bearbeta varje objekt individuellt.

Returer

Blob-metadata

Lista över filer
BlobMetadata

När en fil skapas [INAKTUELL]

Åtgärds-ID:
OnNewFile

Utlöser ett flöde när en ny fil skapas i en Box-mapp. Utlösaren utlöses inte om en fil läggs till/uppdateras i en undermapp. Om det krävs för att utlösa på undermappar bör flera utlösare skapas.

Parametrar

Name Nyckel Obligatorisk Typ Description
Mapp-ID
 folderId True string

Den unika identifieraren för mappen i Box.
Härled innehållstyp
 inferContentType boolean

Ett booleskt värde (sant, falskt) för att härleda innehållstyp baserat på tillägg.

Returer

Innehållet i filen.

Filinnehåll
binary

När en fil ändras (endast egenskaper)

Åtgärds-ID:
OnUpdatedFiles

Den här åtgärden utlöser ett flöde när en fil ändras i en mapp. Utlösaren utlöses inte om en fil läggs till/uppdateras i en undermapp. Om det krävs för att utlösa på undermappar bör flera utlösare skapas.

Parametrar

Name Nyckel Obligatorisk Typ Description
Mapp
 folderId True string

Välj en mapp
Antal filer som ska returneras
 maxFileCount integer

Maximalt antal filer som ska returneras av en utlösarkörning (1–100). Observera att inställningen "Dela på" kan tvinga utlösaren att bearbeta varje objekt individuellt.

Returer

Blob-metadata

Lista över filer
BlobMetadata

När en fil ändras (endast egenskaper) (V2) (förhandsversion)

Åtgärds-ID:
OnUpdatedFilesV2

Den här åtgärden utlöser ett flöde när en fil ändras i en mapp. Utlösaren utlöses inte om en fil läggs till/uppdateras i en undermapp. Om det krävs för att utlösa på undermappar bör flera utlösare skapas. Om alternativet "Dela på" är inaktiverat för utlösarkörningar med utlösare för utlösare> kan det generera en tom matris för utdata från "Lista över filer".

Parametrar

Name Nyckel Obligatorisk Typ Description
Mapp
 folderId True string

Välj en mapp
Antal filer som ska returneras
 maxFileCount integer

Maximalt antal filer som ska returneras av en utlösarkörning (1–100). Observera att inställningen "Dela på" kan tvinga utlösaren att bearbeta varje objekt individuellt.

Returer

Blob-metadata

Lista över filer
BlobMetadata

När en fil ändras [INAKTUELL]

Åtgärds-ID:
OnUpdatedFile

Utlöser ett flöde när en fil ändras i en Box-mapp. Utlösaren utlöses inte om en fil läggs till/uppdateras i en undermapp. Om det krävs för att utlösa på undermappar bör flera utlösare skapas.

Parametrar

Name Nyckel Obligatorisk Typ Description
Mapp-ID
 folderId True string

Den unika identifieraren för mappen i Box.
Härled innehållstyp
 inferContentType boolean

Ett booleskt värde (sant, falskt) för att härleda innehållstyp baserat på tillägg.

Returer

Innehållet i filen.

Filinnehåll
binary

Definitioner

BlobMetadata

Blob-metadata

Name Sökväg Typ Description
Id
 Id string

Det unika ID:t för filen eller mappen.
Namn
 Name string

Namnet på filen eller mappen.
visningsnamn
 DisplayName string

Visningsnamnet för filen eller mappen.
Väg
 Path string

Sökvägen till filen eller mappen.
Senast ändrad
 LastModified date-time

Datum och tid då filen eller mappen senast ändrades.
Storlek
 Size integer

Storleken på filen eller mappen.
Mediatyp
 MediaType string

Medietypen för filen eller mappen.
IsFolder
 IsFolder boolean

Ett booleskt värde (sant, falskt) som anger om bloben är en mapp eller inte.
ETag (ETag)
 ETag string

Etag för filen eller mappen.
FileLocator
 FileLocator string

Fillokaliseraren för filen eller mappen.
SenastÄndradAv
 LastModifiedBy string

Den användare som senast ändrade filen eller mappen.

binär

Det här är den grundläggande datatypen "binär".