Box
Box™ es un servicio que mantiene los archivos seguros, sincronizados y fáciles de compartir. Conéctese a Box para administrar los archivos. Puede realizar varias acciones, como cargar, actualizar, obtener y eliminar archivos en Box.
Este conector está disponible en los siguientes productos y regiones:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Estándar | Todas las regiones de Power Automate excepto las siguientes: - China Cloud operado por 21Vianet |
| Aplicaciones lógicas | Estándar | Todas las regiones de Logic Apps excepto las siguientes: - Regiones de Azure China - Departamento de Defensa de EE. UU. (DoD) |
| Power Apps | Estándar | Todas las regiones de Power Apps excepto las siguientes: - China Cloud operado por 21Vianet |
| Power Automate | Estándar | Todas las regiones de Power Automate excepto las siguientes: - China Cloud operado por 21Vianet |
| Contacto | |
|---|---|
| Nombre | Microsoft |
| URL |
Compatibilidad con Microsoft LogicApps Soporte técnico de Microsoft Power Automate Soporte técnico de Microsoft Power Apps |
| Metadatos del conector | |
|---|---|
| Publicador | Microsoft |
| Sitio web | https://www.box.com/ |
| Directiva de privacidad | https://www.box.com/legal/privacypolicy |
Estado de la API de Box
Use este recurso para realizar un seguimiento de las interrupciones de la API de Box.
Problemas y limitaciones conocidos
- El conector no admite conexiones de inicio de sesión único (SSO), use la conexión estándar en su lugar.
- No confunda el parámetro Identificador de archivo con el nombre de archivo real. Debido a las restricciones de la API REST de Box, los identificadores de archivo no válidos con los siguientes caracteres: [\ { } " <>] pueden provocar errores de GetawayTimeout del conector.
- Cada carpeta de la ruta de acceso especificada (ruta de acceso de carpeta o ruta de acceso de archivo), incluida la carpeta raíz, no debe contener más de 10000 elementos.
- Al elegir un archivo de una carpeta mediante el selector de archivos, la ruta de acceso resultante puede comenzar con "//Todos los archivos", por ejemplo "//Todos los archivos/Mi carpeta/MyFile.txt". Para evitar crear una nueva carpeta "Todos los archivos" en la raíz, esta ruta de acceso se debe cambiar manualmente a "/Mi carpeta/MyFile.txt". Para hacer referencia a la carpeta raíz, use una sola barra diagonal, como "//Todos los archivos" -> "/".
- Los desencadenadores se activan en la repetición del evento correspondiente casi inmediatamente en la mayoría de los casos, pero podría haber circunstancias poco frecuentes cuando el retraso del desencadenador para activarse puede tardar hasta un día debido a las limitaciones subyacentes de la API. Para más información, vaya a (API de eventos de Box). Se recomienda mantener un archivo en una carpeta durante ese período. De lo contrario, la lógica del desencadenador no lo notificará.
- Si ya existe un archivo en una carpeta, el archivo se volverá a cargar con el mismo nombre no se considerará como evento de creación, pero evento de actualización.
- Este conector ya no es un conector tabular y, por tanto, no se puede usar como origen de datos tabulares, incluido para el conector de Excel.
- Este conector puede enviar una solicitud de no-op al back-end.
Límites generales
| Nombre | Importancia |
|---|---|
| Tamaño máximo de archivo (en MB) | 75 |
| Número máximo de elementos de carpeta | 10000 |
| Número máximo de megabytes que se transfieren hacia o desde el conector dentro de un intervalo de tiempo de ancho de banda (por conexión) | 1 000 |
| Intervalo de tiempo de ancho de banda (en milisegundos) | 60000 |
Limitaciones
| Nombre | Llamadas | Período de renovación |
|---|---|---|
| Llamadas API por conexión | 100 | 60 segundos |
Acciones
| Actualizar archivo |
Actualiza un archivo existente en Box. |
| Copiar archivo |
Copie un archivo en una ruta de acceso de archivo en Box. |
| Crear archivo |
Carga un archivo en Box. |
| Eliminar archivo |
Elimina un archivo existente de Box. |
| Enumerar archivos y carpetas en la carpeta |
Enumera los archivos y carpetas de una carpeta Box. |
| Enumerar archivos y carpetas en la carpeta raíz |
Enumera los archivos y carpetas de la carpeta raíz de Box. |
| Extracción del archivo en la carpeta |
Extrae un archivo de archivo en una carpeta de Box (ejemplo: .zip). |
| Obtención de metadatos de archivo mediante id. |
Recupera los metadatos de archivo de Box mediante el identificador de archivo. |
| Obtención de metadatos de archivo mediante la ruta de acceso |
Recupera los metadatos de archivo de Box mediante la ruta de acceso. |
| Obtención del contenido del archivo mediante el identificador |
Recupera el contenido del archivo de Box mediante id. |
| Obtención del contenido del archivo mediante la ruta de acceso |
Recupera el contenido del archivo de Box mediante la ruta de acceso. |
Actualizar archivo
Actualiza un archivo existente en Box.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de archivo
|
id | True | string |
Identificador único del archivo que se va a actualizar en Box. |
|
Contenido del archivo
|
body | True | binary |
Contenido del archivo que se va a actualizar en Box. |
Devoluciones
Metadatos de blob
- Body
- BlobMetadata
Copiar archivo
Copie un archivo en una ruta de acceso de archivo en Box.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Dirección URL de origen
|
source | True | string |
Dirección URL al archivo de origen. |
|
Ruta de acceso del archivo de destino
|
destination | True | string |
Ruta de acceso del archivo de destino en Box, incluido el nombre de archivo de destino. |
|
Sobrescribir
|
overwrite | boolean |
Sobrescribe el archivo de destino si se establece en "true". |
Devoluciones
Metadatos de blob
- Body
- BlobMetadata
Crear archivo
Carga un archivo en Box.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Ruta de acceso de carpeta
|
folderPath | True | string |
Ruta de acceso de carpeta para cargar el archivo en Box. |
|
Nombre de archivo
|
name | True | string |
Nombre del archivo que se va a crear en Box. |
|
Contenido del archivo
|
body | True | binary |
Contenido del archivo que se va a cargar en Box. |
Devoluciones
Metadatos de blob
- Body
- BlobMetadata
Eliminar archivo
Elimina un archivo existente de Box.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de archivo
|
id | True | string |
Identificador único del archivo que se va a eliminar de Box. |
Enumerar archivos y carpetas en la carpeta
Enumera los archivos y carpetas de una carpeta Box.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de carpeta
|
id | True | string |
Identificador único de la carpeta en Box. |
Devoluciones
- response
- array of BlobMetadata
Enumerar archivos y carpetas en la carpeta raíz
Enumera los archivos y carpetas de la carpeta raíz de Box.
Devoluciones
- response
- array of BlobMetadata
Extracción del archivo en la carpeta
Extrae un archivo de archivo en una carpeta de Box (ejemplo: .zip).
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Ruta de acceso del archivo de archivo de origen
|
source | True | string |
Ruta de acceso al archivo de archivo. |
|
Ruta de acceso de la carpeta de destino
|
destination | True | string |
Ruta de acceso de Box para extraer el contenido del archivo. |
|
Sobrescribir
|
overwrite | boolean |
Sobrescribe los archivos de destino si se establece en "true". |
Devoluciones
- response
- array of BlobMetadata
Obtención de metadatos de archivo mediante id.
Recupera los metadatos de archivo de Box mediante el identificador de archivo.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de archivo
|
id | True | string |
Identificador único del archivo en Box. |
Devoluciones
Metadatos de blob
- Body
- BlobMetadata
Obtención de metadatos de archivo mediante la ruta de acceso
Recupera los metadatos de archivo de Box mediante la ruta de acceso.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Ruta de acceso del archivo
|
path | True | string |
Ruta de acceso única al archivo en Box. |
Devoluciones
Metadatos de blob
- Body
- BlobMetadata
Obtención del contenido del archivo mediante el identificador
Recupera el contenido del archivo de Box mediante id.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de archivo
|
id | True | string |
Identificador único del archivo en Box. |
|
Inferencia de tipo de contenido
|
inferContentType | boolean |
Valor booleano (true, false) para inferir el tipo de contenido en función de la extensión. |
Devoluciones
Contenido del archivo.
- Contenido del archivo
- binary
Obtención del contenido del archivo mediante la ruta de acceso
Recupera el contenido del archivo de Box mediante la ruta de acceso.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Ruta de acceso del archivo
|
path | True | string |
Ruta de acceso única al archivo en Box. |
|
Inferencia de tipo de contenido
|
inferContentType | boolean |
Valor booleano (true, false) para inferir el tipo de contenido en función de la extensión. |
Devoluciones
Contenido del archivo.
- Contenido del archivo
- binary
Desencadenadores
| Cuando se crea un archivo (solo propiedades) (V2) |
Esta operación desencadena un flujo cuando se crea un nuevo archivo en una carpeta. El desencadenador no se activa si se agrega o actualiza un archivo en una subcarpeta. Si es necesario desencadenar en subcarpetas, se deben crear varios desencadenadores. En caso de que la opción "Dividir activado" esté desactivada para las ejecuciones de desencadenador correctas del desencadenador> puede producir una matriz vacía para la salida "Lista de archivos". |
| Cuando se crea un archivo (solo propiedades) [EN DESUSO] |
Esta acción ha quedado en desuso. Use cuando se crea un archivo (solo propiedades) (V2).
|
| Cuando se crea un archivo [EN DESUSO] |
Desencadena un flujo cuando se crea un nuevo archivo en una carpeta Box. El desencadenador no se activa si se agrega o actualiza un archivo en una subcarpeta. Si es necesario desencadenar en subcarpetas, se deben crear varios desencadenadores. |
| Cuando se modifica un archivo (solo propiedades) |
Esta operación desencadena un flujo cuando se modifica un archivo en una carpeta. El desencadenador no se activa si se agrega o actualiza un archivo en una subcarpeta. Si es necesario desencadenar en subcarpetas, se deben crear varios desencadenadores. |
| Cuando se modifica un archivo (solo propiedades) (V2) (versión preliminar) |
Esta operación desencadena un flujo cuando se modifica un archivo en una carpeta. El desencadenador no se activa si se agrega o actualiza un archivo en una subcarpeta. Si es necesario desencadenar en subcarpetas, se deben crear varios desencadenadores. En caso de que la opción "Dividir activado" esté desactivada para las ejecuciones de desencadenador correctas del desencadenador> puede producir una matriz vacía para la salida "Lista de archivos". |
| Cuando se modifica un archivo [EN DESUSO] |
Desencadena un flujo cuando se modifica un archivo en una carpeta Box. El desencadenador no se activa si se agrega o actualiza un archivo en una subcarpeta. Si es necesario desencadenar en subcarpetas, se deben crear varios desencadenadores. |
Cuando se crea un archivo (solo propiedades) (V2)
Esta operación desencadena un flujo cuando se crea un nuevo archivo en una carpeta. El desencadenador no se activa si se agrega o actualiza un archivo en una subcarpeta. Si es necesario desencadenar en subcarpetas, se deben crear varios desencadenadores. En caso de que la opción "Dividir activado" esté desactivada para las ejecuciones de desencadenador correctas del desencadenador> puede producir una matriz vacía para la salida "Lista de archivos".
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Carpeta
|
folderId | True | string |
Identificador único de la carpeta. |
|
Número de archivos que se van a devolver
|
maxFileCount | integer |
Número máximo de archivos devueltos por una sola ejecución de desencadenador (1-100). Tenga en cuenta que la configuración "Dividir activado" puede forzar el desencadenador para procesar cada elemento individualmente. |
Devoluciones
Metadatos de blob
- Lista de archivos
- BlobMetadata
Cuando se crea un archivo (solo propiedades) [EN DESUSO]
Esta acción ha quedado en desuso. Use cuando se crea un archivo (solo propiedades) (V2).
Esta operación desencadena un flujo cuando se crea un nuevo archivo en una carpeta. El desencadenador no se activa si se agrega o actualiza un archivo en una subcarpeta. Si es necesario desencadenar en subcarpetas, se deben crear varios desencadenadores.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Carpeta
|
folderId | True | string |
Identificador único de la carpeta. |
|
Número de archivos que se van a devolver
|
maxFileCount | integer |
Número máximo de archivos devueltos por una sola ejecución de desencadenador (1-100). Tenga en cuenta que la configuración "Dividir activado" puede forzar el desencadenador para procesar cada elemento individualmente. |
Devoluciones
Metadatos de blob
- Lista de archivos
- BlobMetadata
Cuando se crea un archivo [EN DESUSO]
Desencadena un flujo cuando se crea un nuevo archivo en una carpeta Box. El desencadenador no se activa si se agrega o actualiza un archivo en una subcarpeta. Si es necesario desencadenar en subcarpetas, se deben crear varios desencadenadores.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de carpeta
|
folderId | True | string |
Identificador único de la carpeta en Box. |
|
Inferencia de tipo de contenido
|
inferContentType | boolean |
Valor booleano (true, false) para inferir el tipo de contenido en función de la extensión. |
Devoluciones
Contenido del archivo.
- Contenido del archivo
- binary
Cuando se modifica un archivo (solo propiedades)
Esta operación desencadena un flujo cuando se modifica un archivo en una carpeta. El desencadenador no se activa si se agrega o actualiza un archivo en una subcarpeta. Si es necesario desencadenar en subcarpetas, se deben crear varios desencadenadores.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Carpeta
|
folderId | True | string |
Selección de una carpeta |
|
Número de archivos que se van a devolver
|
maxFileCount | integer |
Número máximo de archivos devueltos por una sola ejecución de desencadenador (1-100). Tenga en cuenta que la configuración "Dividir activado" puede forzar el desencadenador para procesar cada elemento individualmente. |
Devoluciones
Metadatos de blob
- Lista de archivos
- BlobMetadata
Cuando se modifica un archivo (solo propiedades) (V2) (versión preliminar)
Esta operación desencadena un flujo cuando se modifica un archivo en una carpeta. El desencadenador no se activa si se agrega o actualiza un archivo en una subcarpeta. Si es necesario desencadenar en subcarpetas, se deben crear varios desencadenadores. En caso de que la opción "Dividir activado" esté desactivada para las ejecuciones de desencadenador correctas del desencadenador> puede producir una matriz vacía para la salida "Lista de archivos".
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Carpeta
|
folderId | True | string |
Selección de una carpeta |
|
Número de archivos que se van a devolver
|
maxFileCount | integer |
Número máximo de archivos devueltos por una sola ejecución de desencadenador (1-100). Tenga en cuenta que la configuración "Dividir activado" puede forzar el desencadenador para procesar cada elemento individualmente. |
Devoluciones
Metadatos de blob
- Lista de archivos
- BlobMetadata
Cuando se modifica un archivo [EN DESUSO]
Desencadena un flujo cuando se modifica un archivo en una carpeta Box. El desencadenador no se activa si se agrega o actualiza un archivo en una subcarpeta. Si es necesario desencadenar en subcarpetas, se deben crear varios desencadenadores.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de carpeta
|
folderId | True | string |
Identificador único de la carpeta en Box. |
|
Inferencia de tipo de contenido
|
inferContentType | boolean |
Valor booleano (true, false) para inferir el tipo de contenido en función de la extensión. |
Devoluciones
Contenido del archivo.
- Contenido del archivo
- binary
Definiciones
BlobMetadata
Metadatos de blob
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Id
|
Id | string |
Identificador único del archivo o carpeta. |
|
Nombre
|
Name | string |
Nombre del archivo o carpeta. |
|
DisplayName (Nombre para mostrar)
|
DisplayName | string |
Nombre para mostrar del archivo o carpeta. |
|
Ruta
|
Path | string |
Ruta de acceso del archivo o carpeta. |
|
ÚltimaModificación
|
LastModified | date-time |
Fecha y hora en que se modificó por última vez el archivo o carpeta. |
|
Tamaño
|
Size | integer |
Tamaño del archivo o carpeta. |
|
Tipo de medio
|
MediaType | string |
Tipo de medio del archivo o carpeta. |
|
IsFolder
|
IsFolder | boolean |
Valor booleano (true, false) para indicar si el blob es una carpeta o no. |
|
ETag
|
ETag | string |
Etiqueta etag del archivo o carpeta. |
|
FileLocator
|
FileLocator | string |
Filelocator del archivo o carpeta. |
|
Última modificación por
|
LastModifiedBy | string |
Usuario que modificó por última vez el archivo o la carpeta. |
binario
Este es el tipo de datos básico "binary".