Caixa
Box™ é um serviço que mantém seus arquivos seguros, sincronizados e fáceis de compartilhar. Ligue-se ao Box para gerir os seus ficheiros. Você pode executar várias ações, como carregar, atualizar, obter e excluir arquivos no Box.
Este conector está disponível nos seguintes produtos e regiões:
| Serviço | Class | Regiões |
|---|---|---|
| Estúdio Copiloto | Standard | Todas as regiões do Power Automatic , exceto as seguintes: - China Cloud operado pela 21Vianet |
| Aplicações Lógicas | Standard | Todas as regiões do Logic Apps , exceto as seguintes: - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Aplicações Power | Standard | Todas as regiões do Power Apps , exceto as seguintes: - China Cloud operado pela 21Vianet |
| Automatize o poder | Standard | Todas as regiões do Power Automatic , 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 | |
|---|---|
| Editora | Microsoft |
| Sítio Web | https://www.box.com/ |
| Política de privacidade | https://www.box.com/legal/privacypolicy |
Status da API da caixa
Use este recurso para rastrear interrupções da API do Box
Problemas conhecidos e limitações
- O conector não suporta conexões de logon único (SSO), use a conexão padrão em vez disso.
- Não confunda o parâmetro File Identifier com o nome do arquivo real. Devido às restrições da API Box REST, identificadores de arquivo inválidos com os seguintes caracteres - [\ { } " <>] podem levar a erros GetawayTimeout 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 '//All Files', por exemplo '//All Files/My Folder/MyFile.txt'. Para evitar a criação de uma nova pasta 'Todos os Ficheiros' na raiz, este caminho deve ser alterado manualmente para '/My Folder/MyFile.txt'. Para referenciar a pasta raiz use uma única barra, como '//All Files' -> '/'.
- Os gatilhos disparam sobre a 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 às limitações subjacentes da API. Para saber mais, vá para (Box Events API). Recomenda-se manter um arquivo em uma pasta durante esse período. Caso contrário, não será relatado pela lógica do gatilho.
- Se já existir um ficheiro numa pasta, o recarregamento do ficheiro com o mesmo nome não será considerado como evento de criação, mas como 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 de no-op para o back-end.
Limites Gerais
| Nome | Valor |
|---|---|
| Tamanho máximo do ficheiro (em MB) | 75 |
| Contagem máxima de itens de pasta | 10000 |
| Número máximo de megabytes sendo transferidos de/para o 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 |
Limites de Limitação
| Name | Chamadas | Período de Renovação |
|---|---|---|
| Chamadas de API por conexão | 100 | 60 segundos |
Ações
| Atualizar ficheiro |
Atualiza um arquivo existente no Box. |
| Copiar ficheiro |
Copie um arquivo para um caminho de arquivo no Box. |
| Criar ficheiro |
Carrega um ficheiro para o Box. |
| Eliminar ficheiro |
Exclui um arquivo existente do Box. |
| Extrair arquivo para pasta |
Extrai um arquivo morto para 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 de arquivo usando id |
Recupera o conteúdo do arquivo do Box usando id. |
| Obter conteúdo de arquivo usando o caminho |
Recupera o conteúdo do arquivo do Box usando o caminho. |
| Obter metadados de arquivo usando id |
Recupera os metadados do arquivo do Box usando a ID do arquivo. |
| Obter metadados de arquivo usando o caminho |
Recupera os metadados do arquivo do Box usando o caminho. |
Atualizar ficheiro
Atualiza um arquivo existente no Box.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID do arquivo
|
id | True | string |
O identificador exclusivo do arquivo a ser atualizado no Box. |
|
Conteúdo do Ficheiro
|
body | True | binary |
O conteúdo do arquivo a ser atualizado no Box. |
Devoluções
Metadados de Blob
- Body
- BlobMetadata
Copiar ficheiro
Copie um arquivo para um caminho de arquivo no Box.
Parâmetros
| Name | Chave | Necessá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. |
|
Substituir
|
overwrite | boolean |
Substitui o arquivo de destino se definido como 'true'. |
Devoluções
Metadados de Blob
- Body
- BlobMetadata
Criar ficheiro
Carrega um ficheiro para o Box.
Parâmetros
| Name | Chave | Necessá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 Ficheiro
|
body | True | binary |
O conteúdo do ficheiro a carregar para o Box. |
Devoluções
Metadados de Blob
- Body
- BlobMetadata
Eliminar ficheiro
Exclui um arquivo existente do Box.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID do arquivo
|
id | True | string |
O identificador exclusivo do arquivo a ser excluído do Box. |
Extrair arquivo para pasta
Extrai um arquivo morto para uma pasta no Box (exemplo: .zip).
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Caminho do arquivo de origem
|
source | True | string |
O caminho para o arquivo morto. |
|
Caminho da pasta de destino
|
destination | True | string |
O caminho no Box para extrair o conteúdo do arquivo. |
|
Substituir
|
overwrite | boolean |
Substitui os arquivos de destino se definido como 'true'. |
Devoluções
- response
- array of BlobMetadata
Listar arquivos e pastas na pasta
Lista os arquivos e pastas em uma pasta Box.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID da pasta
|
id | True | string |
O identificador exclusivo da pasta no Box. |
Devoluções
- response
- array of BlobMetadata
Listar arquivos e pastas na pasta raiz
Obter conteúdo de arquivo usando id
Recupera o conteúdo do arquivo do Box usando id.
Parâmetros
| Name | Chave | Necessá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 booleano (true, false) para inferir o tipo de conteúdo com base na extensão. |
Devoluções
O conteúdo do arquivo.
- Conteúdo do Ficheiro
- binary
Obter conteúdo de arquivo usando o caminho
Recupera o conteúdo do arquivo do Box usando o caminho.
Parâmetros
| Name | Chave | Necessá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 booleano (true, false) para inferir o tipo de conteúdo com base na extensão. |
Devoluções
O conteúdo do arquivo.
- Conteúdo do Ficheiro
- binary
Obter metadados de arquivo usando id
Recupera os metadados do arquivo do Box usando a ID do arquivo.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID do arquivo
|
id | True | string |
O identificador exclusivo do arquivo no Box. |
Devoluções
Metadados de Blob
- Body
- BlobMetadata
Obter metadados de arquivo usando o caminho
Recupera os metadados do arquivo do Box usando o caminho.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Caminho do arquivo
|
path | True | string |
O caminho exclusivo para o arquivo no Box. |
Devoluções
Metadados de Blob
- Body
- BlobMetadata
Acionadores
| Quando um arquivo é criado (somente propriedades) (V2) |
Esta operação dispara um fluxo quando um novo arquivo é criado em uma pasta. O gatilho não é acionado se um arquivo for adicionado/atualizado em uma subpasta. Se for necessário acionar em subpastas, vários gatilhos devem ser criados. Caso a opção 'Split On' esteja desativada para Trigger-Settings, execuções de gatilho bem-sucedidas> podem produzir matriz vazia para a saída 'Lista de arquivos'. |
| Quando um arquivo é criado (somente propriedades) [DEPRECATED] |
Esta ação foi preterida. Em vez disso, use Quando um arquivo é criado (somente propriedades) (V2).
|
| Quando um arquivo é criado [DEPRECATED] |
Aciona um fluxo quando um novo arquivo é criado em uma pasta Box. O gatilho não é acionado se um arquivo for adicionado/atualizado em uma subpasta. Se for necessário acionar em subpastas, vários gatilhos devem ser criados. |
| Quando um arquivo é modificado [DEPRECATED] |
Aciona um fluxo quando um arquivo é modificado em uma pasta Box. O gatilho não é acionado se um arquivo for adicionado/atualizado em uma subpasta. Se for necessário acionar em subpastas, vários gatilhos devem ser criados. |
| Quando um ficheiro é modificado (apenas propriedades) |
Esta operação dispara um fluxo quando um arquivo é modificado em uma pasta. O gatilho não é acionado se um arquivo for adicionado/atualizado em uma subpasta. Se for necessário acionar em subpastas, vários gatilhos devem ser criados. |
| Quando um ficheiro é modificado (apenas propriedades) (V2) (Pré-visualização) |
Esta operação dispara um fluxo quando um arquivo é modificado em uma pasta. O gatilho não é acionado se um arquivo for adicionado/atualizado em uma subpasta. Se for necessário acionar em subpastas, vários gatilhos devem ser criados. Caso a opção 'Split On' esteja desativada para Trigger-Settings, execuções de gatilho bem-sucedidas> podem produzir matriz vazia para a saída 'Lista de arquivos'. |
Quando um arquivo é criado (somente propriedades) (V2)
Esta operação dispara um fluxo quando um novo arquivo é criado em uma pasta. O gatilho não é acionado se um arquivo for adicionado/atualizado em uma subpasta. Se for necessário acionar em subpastas, vários gatilhos devem ser criados. Caso a opção 'Split On' esteja desativada para Trigger-Settings, execuções de gatilho bem-sucedidas> podem produzir matriz vazia para a saída 'Lista de arquivos'.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Folder
|
folderId | True | string |
O identificador exclusivo da pasta. |
|
Número de ficheiros a devolver
|
maxFileCount | integer |
Número máximo de arquivos a serem retornados por uma única execução de gatilho (1-100). Observe que a configuração 'Dividir em' pode forçar o gatilho a processar cada item individualmente. |
Devoluções
Metadados de Blob
- Lista de ficheiros
- BlobMetadata
Quando um arquivo é criado (somente propriedades) [DEPRECATED]
Esta ação foi preterida. Em vez disso, use Quando um arquivo é criado (somente propriedades) (V2).
Esta operação dispara um fluxo quando um novo arquivo é criado em uma pasta. O gatilho não é acionado se um arquivo for adicionado/atualizado em uma subpasta. Se for necessário acionar em subpastas, vários gatilhos devem ser criados.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Folder
|
folderId | True | string |
O identificador exclusivo da pasta. |
|
Número de ficheiros a devolver
|
maxFileCount | integer |
Número máximo de arquivos a serem retornados por uma única execução de gatilho (1-100). Observe que a configuração 'Dividir em' pode forçar o gatilho a processar cada item individualmente. |
Devoluções
Metadados de Blob
- Lista de ficheiros
- BlobMetadata
Quando um arquivo é criado [DEPRECATED]
Aciona um fluxo quando um novo arquivo é criado em uma pasta Box. O gatilho não é acionado se um arquivo for adicionado/atualizado em uma subpasta. Se for necessário acionar em subpastas, vários gatilhos devem ser criados.
Parâmetros
| Name | Chave | Necessá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 booleano (true, false) para inferir o tipo de conteúdo com base na extensão. |
Devoluções
O conteúdo do arquivo.
- Conteúdo do Ficheiro
- binary
Quando um arquivo é modificado [DEPRECATED]
Aciona um fluxo quando um arquivo é modificado em uma pasta Box. O gatilho não é acionado se um arquivo for adicionado/atualizado em uma subpasta. Se for necessário acionar em subpastas, vários gatilhos devem ser criados.
Parâmetros
| Name | Chave | Necessá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 booleano (true, false) para inferir o tipo de conteúdo com base na extensão. |
Devoluções
O conteúdo do arquivo.
- Conteúdo do Ficheiro
- binary
Quando um ficheiro é modificado (apenas propriedades)
Esta operação dispara um fluxo quando um arquivo é modificado em uma pasta. O gatilho não é acionado se um arquivo for adicionado/atualizado em uma subpasta. Se for necessário acionar em subpastas, vários gatilhos devem ser criados.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Folder
|
folderId | True | string |
Selecione uma pasta |
|
Número de ficheiros a devolver
|
maxFileCount | integer |
Número máximo de arquivos a serem retornados por uma única execução de gatilho (1-100). Observe que a configuração 'Dividir em' pode forçar o gatilho a processar cada item individualmente. |
Devoluções
Metadados de Blob
- Lista de ficheiros
- BlobMetadata
Quando um ficheiro é modificado (apenas propriedades) (V2) (Pré-visualização)
Esta operação dispara um fluxo quando um arquivo é modificado em uma pasta. O gatilho não é acionado se um arquivo for adicionado/atualizado em uma subpasta. Se for necessário acionar em subpastas, vários gatilhos devem ser criados. Caso a opção 'Split On' esteja desativada para Trigger-Settings, execuções de gatilho bem-sucedidas> podem produzir matriz vazia para a saída 'Lista de arquivos'.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Folder
|
folderId | True | string |
Selecione uma pasta |
|
Número de ficheiros a devolver
|
maxFileCount | integer |
Número máximo de arquivos a serem retornados por uma única execução de gatilho (1-100). Observe que a configuração 'Dividir em' pode forçar o gatilho a processar cada item individualmente. |
Devoluções
Metadados de Blob
- Lista de ficheiros
- BlobMetadata
Definições
BlobMetadata
Metadados de Blob
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Id
|
Id | string |
A ID exclusiva do arquivo ou pasta. |
|
Nome
|
Name | string |
O nome do arquivo ou pasta. |
|
Nome de Exibição
|
DisplayName | string |
O nome para exibição do arquivo ou pasta. |
|
Caminho
|
Path | string |
O caminho do arquivo ou pasta. |
|
Última modificação
|
LastModified | date-time |
A data e a hora em que o arquivo ou pasta foi modificado pela última vez. |
|
Tamanho
|
Size | integer |
O tamanho do arquivo ou pasta. |
|
MediaType
|
MediaType | string |
O tipo de mídia do arquivo ou pasta. |
|
IsFolder
|
IsFolder | boolean |
Um valor booleano (true, false) para indicar se o blob é ou não uma pasta. |
|
ETag
|
ETag | string |
O etag do arquivo ou pasta. |
|
Localizador de arquivos
|
FileLocator | string |
O localizador de arquivos do arquivo ou pasta. |
|
Última modificação por
|
LastModifiedBy | string |
O usuário que modificou o arquivo ou pasta pela última vez. |
binário
Este é o tipo de dados básico 'binário'.