Box
O Box™ é um serviço que mantém seus arquivos seguros, sincronizados e fáceis de compartilhar. Conecte-se ao Box para gerenciar seus arquivos. Você pode executar várias ações, como carregar, atualizar, obter e excluir arquivos no Box.
Esse conector está disponível nos seguintes produtos e regiões:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Standard | Todas as regiões do Power Automate , exceto as seguintes: - China Cloud operado pela 21Vianet |
| Aplicativos Lógicos | Standard | Todas as regiões dos Aplicativos Lógicos , exceto as seguintes: - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Power Apps | Standard | Todas as regiões do Power Apps , exceto as seguintes: - China Cloud operado pela 21Vianet |
| Power Automate | Standard | Todas as regiões do Power Automate , exceto as seguintes: - China Cloud operado pela 21Vianet |
| Contato | |
|---|---|
| Nome | Microsoft |
| URL |
Suporte do Microsoft LogicApps Suporte do Microsoft Power Automate Suporte do Microsoft Power Apps |
| Metadados do conector | |
|---|---|
| Publicador | Microsoft |
| Site | https://www.box.com/ |
| Política de privacidade | https://www.box.com/legal/privacypolicy |
Status da API da caixa
Use esse recurso para acompanhar interrupções da API do Box
Problemas e limitações conhecidos
- O conector não dá suporte a conexões de SSO (Logon Único), use a conexão padrão.
- Não confunda o parâmetro Identificador de Arquivo com o nome do arquivo real. Devido às restrições da API REST do Box, identificadores de arquivo inválidos com os seguintes caracteres – [\ { } " <>] podem levar a erros de EscapeTimeout do conector.
- Cada pasta no caminho especificado (Caminho da Pasta ou Caminho do Arquivo), incluindo a pasta raiz, não deve conter mais de 10000 itens.
- Ao escolher um arquivo de uma pasta usando o seletor de arquivos, o caminho resultante pode começar com '//Todos os Arquivos', por exemplo'/Todos os Arquivos/Minha Pasta/MyFile.txt'. Para evitar a criação da nova pasta 'Todos os Arquivos' na raiz, esse caminho deve ser alterado manualmente para '/Minha Pasta/MyFile.txt'. Para fazer referência à pasta raiz, use uma única barra, como '//Todos os Arquivos' -> '/'.
- Gatilhos disparam na ocorrência do evento correspondente quase imediatamente na maioria dos casos, mas pode haver circunstâncias raras em que o atraso do gatilho para disparar pode levar até um dia devido a limitações de API subjacentes. Para saber mais, acesse (API de Eventos do Box). É recomendável manter um arquivo em uma pasta para esse período. Caso contrário, ele não será relatado pela lógica de gatilho.
- Se um arquivo já existir em uma pasta, o novo upload de arquivo com o mesmo nome não será considerado como evento de criação, mas evento de atualização.
- Esse conector não é mais um conector tabular e, portanto, não pode ser usado como uma fonte de dados tabular , inclusive para o conector do Excel.
- Esse conector pode enviar uma solicitação no-op para o back-end.
Limites Gerais
| Nome | Value |
|---|---|
| Tamanho máximo do arquivo (em MB) | 75 |
| Contagem máxima de itens de pasta | 10000 |
| Número máximo de megabytes sendo transferidos para/do conector dentro de um intervalo de tempo de largura de banda (por conexão) | 1000 |
| Intervalo de tempo de largura de banda (em milissegundos) | 60000 |
Limitações
| Nome | Chamadas | Período de renovação |
|---|---|---|
| Chamadas à API por conexão | 100 | 60 segundos |
Ações
| Atualizar arquivo |
Atualiza um arquivo existente no Box. |
| Copiar arquivo |
Copie um arquivo para um caminho de arquivo no Box. |
| Criar arquivo |
Carrega um arquivo no Box. |
| Excluir arquivo |
Exclui um arquivo existente do Box. |
| Extrair arquivo morto para pasta |
Extrai um arquivo morto em uma pasta no Box (exemplo: .zip). |
| Listar arquivos e pastas na pasta |
Lista os arquivos e pastas em uma pasta Box. |
| Listar arquivos e pastas na pasta raiz |
Lista os arquivos e pastas na pasta raiz box. |
| Obter conteúdo do arquivo usando id |
Recupera o conteúdo do arquivo do Box usando id. |
| Obter conteúdo do arquivo usando o caminho |
Recupera o conteúdo do arquivo do Box usando o caminho. |
| Obter metadados de arquivo usando id |
Recupera os metadados de arquivo do Box usando a ID do arquivo. |
| Obter metadados de arquivo usando o caminho |
Recupera os metadados de arquivo do Box usando o caminho. |
Atualizar arquivo
Atualiza um arquivo existente no Box.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do arquivo
|
id | True | string |
O identificador exclusivo do arquivo a ser atualizado no Box. |
|
Conteúdo do arquivo
|
body | True | binary |
O conteúdo do arquivo a ser atualizado no Box. |
Retornos
Metadados de blob
- Corpo
- BlobMetadata
Copiar arquivo
Copie um arquivo para um caminho de arquivo no Box.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Url de origem
|
source | True | string |
A URL para o arquivo de origem. |
|
Caminho do arquivo de destino
|
destination | True | string |
O caminho do arquivo de destino no Box, incluindo o nome do arquivo de destino. |
|
Sobrescrever
|
overwrite | boolean |
Substitui o arquivo de destino se definido como 'true'. |
Retornos
Metadados de blob
- Corpo
- BlobMetadata
Criar arquivo
Carrega um arquivo no Box.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Caminho da pasta
|
folderPath | True | string |
O caminho da pasta para carregar o arquivo no Box. |
|
Nome do Arquivo
|
name | True | string |
O nome do arquivo a ser criado no Box. |
|
Conteúdo do arquivo
|
body | True | binary |
O conteúdo do arquivo a ser carregado no Box. |
Retornos
Metadados de blob
- Corpo
- BlobMetadata
Excluir arquivo
Exclui um arquivo existente do Box.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do arquivo
|
id | True | string |
O identificador exclusivo do arquivo a ser excluído do Box. |
Extrair arquivo morto para pasta
Extrai um arquivo morto em uma pasta no Box (exemplo: .zip).
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Caminho do arquivo de arquivo de origem
|
source | True | string |
O caminho para o arquivo morto. |
|
Caminho da pasta de destino
|
destination | True | string |
O caminho em Box para extrair o conteúdo do arquivo morto. |
|
Sobrescrever
|
overwrite | boolean |
Substitui os arquivos de destino se definido como 'true'. |
Retornos
- response
- array of BlobMetadata
Listar arquivos e pastas na pasta
Lista os arquivos e pastas em uma pasta Box.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID da pasta
|
id | True | string |
O identificador exclusivo da pasta no Box. |
Retornos
- response
- array of BlobMetadata
Listar arquivos e pastas na pasta raiz
Obter conteúdo do arquivo usando id
Recupera o conteúdo do arquivo do Box usando id.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do arquivo
|
id | True | string |
O identificador exclusivo do arquivo no Box. |
|
Inferir tipo de conteúdo
|
inferContentType | boolean |
Um valor booliano (true, false) para inferir o tipo de conteúdo com base na extensão. |
Retornos
O conteúdo do ficheiro.
- Conteúdo do arquivo
- binary
Obter conteúdo do arquivo usando o caminho
Recupera o conteúdo do arquivo do Box usando o caminho.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Caminho do Arquivo
|
path | True | string |
O caminho exclusivo para o arquivo no Box. |
|
Inferir tipo de conteúdo
|
inferContentType | boolean |
Um valor booliano (true, false) para inferir o tipo de conteúdo com base na extensão. |
Retornos
O conteúdo do ficheiro.
- Conteúdo do arquivo
- binary
Obter metadados de arquivo usando id
Recupera os metadados de arquivo do Box usando a ID do arquivo.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do arquivo
|
id | True | string |
O identificador exclusivo do arquivo no Box. |
Retornos
Metadados de blob
- Corpo
- BlobMetadata
Obter metadados de arquivo usando o caminho
Recupera os metadados de arquivo do Box usando o caminho.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Caminho do Arquivo
|
path | True | string |
O caminho exclusivo para o arquivo no Box. |
Retornos
Metadados de blob
- Corpo
- BlobMetadata
Gatilhos
| Quando um arquivo é criado (somente propriedades) (V2) |
Essa operação dispara um fluxo quando um novo arquivo é criado em uma pasta. O gatilho não será acionado se um arquivo for adicionado/atualizado em uma subpasta. Se for necessário disparar em subpastas, vários gatilhos deverão ser criados. Caso a opção 'Split On' esteja desativada para execuções de gatilho bem-sucedidas de Configurações de> Gatilho pode produzir uma matriz vazia para a saída 'Lista de Arquivos'. |
| Quando um arquivo é criado (somente propriedades) [PRETERIDO] |
Esta ação foi preterida. Use quando um arquivo for criado (somente propriedades) (V2).
|
| Quando um arquivo é criado [PRETERIDO] |
Dispara um fluxo quando um novo arquivo é criado em uma pasta Box. O gatilho não será acionado se um arquivo for adicionado/atualizado em uma subpasta. Se for necessário disparar em subpastas, vários gatilhos deverão ser criados. |
| Quando um arquivo é modificado (somente propriedades) |
Essa operação dispara um fluxo quando um arquivo é modificado em uma pasta. O gatilho não será acionado se um arquivo for adicionado/atualizado em uma subpasta. Se for necessário disparar em subpastas, vários gatilhos deverão ser criados. |
| Quando um arquivo é modificado (somente propriedades) (V2) (versão prévia) |
Essa operação dispara um fluxo quando um arquivo é modificado em uma pasta. O gatilho não será acionado se um arquivo for adicionado/atualizado em uma subpasta. Se for necessário disparar em subpastas, vários gatilhos deverão ser criados. Caso a opção 'Split On' esteja desativada para execuções de gatilho bem-sucedidas de Configurações de> Gatilho pode produzir uma matriz vazia para a saída 'Lista de Arquivos'. |
| Quando um arquivo é modificado [PRETERIDO] |
Dispara um fluxo quando um arquivo é modificado em uma pasta Box. O gatilho não será acionado se um arquivo for adicionado/atualizado em uma subpasta. Se for necessário disparar em subpastas, vários gatilhos deverão ser criados. |
Quando um arquivo é criado (somente propriedades) (V2)
Essa operação dispara um fluxo quando um novo arquivo é criado em uma pasta. O gatilho não será acionado se um arquivo for adicionado/atualizado em uma subpasta. Se for necessário disparar em subpastas, vários gatilhos deverão ser criados. Caso a opção 'Split On' esteja desativada para execuções de gatilho bem-sucedidas de Configurações de> Gatilho pode produzir uma matriz vazia para a saída 'Lista de Arquivos'.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Pasta
|
folderId | True | string |
O identificador exclusivo da pasta. |
|
Número de arquivos a serem retornados
|
maxFileCount | integer |
Número máximo de arquivos a serem retornados por execução de gatilho único (1 a 100). Observe que a configuração 'Split On' pode forçar o gatilho a processar cada item individualmente. |
Retornos
Metadados de blob
- Lista de arquivos
- BlobMetadata
Quando um arquivo é criado (somente propriedades) [PRETERIDO]
Esta ação foi preterida. Use quando um arquivo for criado (somente propriedades) (V2).
Essa operação dispara um fluxo quando um novo arquivo é criado em uma pasta. O gatilho não será acionado se um arquivo for adicionado/atualizado em uma subpasta. Se for necessário disparar em subpastas, vários gatilhos deverão ser criados.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Pasta
|
folderId | True | string |
O identificador exclusivo da pasta. |
|
Número de arquivos a serem retornados
|
maxFileCount | integer |
Número máximo de arquivos a serem retornados por execução de gatilho único (1 a 100). Observe que a configuração 'Split On' pode forçar o gatilho a processar cada item individualmente. |
Retornos
Metadados de blob
- Lista de arquivos
- BlobMetadata
Quando um arquivo é criado [PRETERIDO]
Dispara um fluxo quando um novo arquivo é criado em uma pasta Box. O gatilho não será acionado se um arquivo for adicionado/atualizado em uma subpasta. Se for necessário disparar em subpastas, vários gatilhos deverão ser criados.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID da pasta
|
folderId | True | string |
O identificador exclusivo da pasta no Box. |
|
Inferir tipo de conteúdo
|
inferContentType | boolean |
Um valor booliano (true, false) para inferir o tipo de conteúdo com base na extensão. |
Retornos
O conteúdo do ficheiro.
- Conteúdo do arquivo
- binary
Quando um arquivo é modificado (somente propriedades)
Essa operação dispara um fluxo quando um arquivo é modificado em uma pasta. O gatilho não será acionado se um arquivo for adicionado/atualizado em uma subpasta. Se for necessário disparar em subpastas, vários gatilhos deverão ser criados.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Pasta
|
folderId | True | string |
Selecionar uma pasta |
|
Número de arquivos a serem retornados
|
maxFileCount | integer |
Número máximo de arquivos a serem retornados por execução de gatilho único (1 a 100). Observe que a configuração 'Split On' pode forçar o gatilho a processar cada item individualmente. |
Retornos
Metadados de blob
- Lista de arquivos
- BlobMetadata
Quando um arquivo é modificado (somente propriedades) (V2) (versão prévia)
Essa operação dispara um fluxo quando um arquivo é modificado em uma pasta. O gatilho não será acionado se um arquivo for adicionado/atualizado em uma subpasta. Se for necessário disparar em subpastas, vários gatilhos deverão ser criados. Caso a opção 'Split On' esteja desativada para execuções de gatilho bem-sucedidas de Configurações de> Gatilho pode produzir uma matriz vazia para a saída 'Lista de Arquivos'.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Pasta
|
folderId | True | string |
Selecionar uma pasta |
|
Número de arquivos a serem retornados
|
maxFileCount | integer |
Número máximo de arquivos a serem retornados por execução de gatilho único (1 a 100). Observe que a configuração 'Split On' pode forçar o gatilho a processar cada item individualmente. |
Retornos
Metadados de blob
- Lista de arquivos
- BlobMetadata
Quando um arquivo é modificado [PRETERIDO]
Dispara um fluxo quando um arquivo é modificado em uma pasta Box. O gatilho não será acionado se um arquivo for adicionado/atualizado em uma subpasta. Se for necessário disparar em subpastas, vários gatilhos deverão ser criados.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID da pasta
|
folderId | True | string |
O identificador exclusivo da pasta no Box. |
|
Inferir tipo de conteúdo
|
inferContentType | boolean |
Um valor booliano (true, false) para inferir o tipo de conteúdo com base na extensão. |
Retornos
O conteúdo do ficheiro.
- Conteúdo do arquivo
- binary
Definições
BlobMetadata
Metadados de blob
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID
|
Id | string |
A ID exclusiva do arquivo ou pasta. |
|
Nome
|
Name | string |
O nome do arquivo ou pasta. |
|
DisplayName
|
DisplayName | string |
O nome de exibição do arquivo ou pasta. |
|
Caminho
|
Path | string |
O caminho do arquivo ou pasta. |
|
LastModified
|
LastModified | date-time |
A data e a hora em que o arquivo ou a pasta foi modificado pela última vez. |
|
Tamanho
|
Size | integer |
O tamanho do arquivo ou pasta. |
|
Tipo de Mídia
|
MediaType | string |
O tipo de mídia do arquivo ou pasta. |
|
IsFolder
|
IsFolder | boolean |
Um valor booliano (true, false) para indicar se o blob é ou não uma pasta. |
|
Etag
|
ETag | string |
A etag do arquivo ou pasta. |
|
FileLocator
|
FileLocator | string |
O filelocator do arquivo ou pasta. |
|
LastModifiedBy
|
LastModifiedBy | string |
O usuário que modificou o arquivo ou a pasta pela última vez. |
binário
Esse é o tipo de dados básico 'binary'.