方框 CLI 数据

Box CLI是一个方便用户的指令行工具,它允许技术和非技术用户利用Box API进行常规或批量动作. 无需写入任何代码,因为这些行为是通过 一组命令。 。 。 .

除了其他功能外,Box CLI还包括以下功能: 功能:

• 散装动作 - Csv文件可用于批量执行命令,电子表格的每行都作为单独的API呼叫处理.
• 作为用户头 - 代表另一个用户行事.
• 搜索 API - 在您的 Box Enterprise 账户中搜索文件和文件夹 .

和AI探员一起工作? 安装官员 盒式技能 (单位:千美元)npx skills add box/box-for-ai)帮助您的助手正确使用 Box CLI 和 Box API .

目录

• 开始
  • CLI 安装
    • Windows (macOS) 安装器
    • Linux 节点安装( C)
  • 快速登录
  • JWT 的 CLI 和服务器认证
  • 注销
• 安全存储
  • 何为安全存储
  • 平台支持
  • Linux 安装
  • 自动迁移
  • 数据位置
• 使用量
• 命令主题
  • 问题、虫子和特性请求?
  • 版本数
    • 支持的版本
    • 版本时间表
  • 协助箱式CLI
  • 版权和许可证

开始

CLI 安装

Windows和macOS都有安装器。 但是,如果您想在其他环境中构建CLI,则可以使用原始源代码.

Windows (macOS) 安装器

要在您的机器上安装最新的 CLI, 请下载最新的 .exe 用于窗口或 .pkg 用于macOS 用于 最新发布。 。 。 .

Linux 节点安装( C)

此外,CLI可以作为节点包被安装在包括Linux在内的任何平台上. 要做到这一点,你需要拥有 节点联署材料 安装在您的机器上.

npm install --global @box/cli

快速登录

安装后运行 box login 来报名 有三个选择:

• [1] 官方专箱CLI App - 不需要设置应用程序。 使用预定义的范围仅限于内容动作.
• [2] 您自己的平台 OAuth app ——为自定义范围或特定配置输入客户端ID和客户端秘密.
• [q] 退出 ——退出登录流量.

您也可以在提示时直接粘贴客户端ID(任何16到99个字符之间的输入都被确认为客户端ID).

快开始 - 跳过提示,直接通过官方Box CLI App授权:

box login -d

浏览器窗口打开以获得授权 。 一旦你允许访问,CLI创造了新的环境,你就可以出发了. 见 认证文件 更多细节.

平台 App - 运行 box login选择 [2],然后从 Box 开发者控制台见 带有 OAuth 2.0 指南的框 CLI 编辑 认证文件 用于设置指令.

JWT 的 CLI 和服务器认证

或者,从CLI箱开始, 下载和安装 CLI, 使用 JWT 的服务器认证设置 Box 应用程序 从您的平台 App的配置页面下载 JSON 配置文件 Box 开发者控制台 如下 JWT CLI指南。然后,通过指向您的配置文件来设定 CLI :

$ box configure:environments:add PATH_TO_CONFIG_FILE
Successfully added CLI environment "default"

如果您用 JWT 认证手动生成了您自己的私钥, 您需要将 CLI 指向 您的私密密钥文件位置 :

$ box configure:environments:add PATH_TO_CONFIG_FILE --private-key-path PATH_TO_PRIVATE_KEY --name ManualKey
Successfully added CLI environment "ManualKey"

注销

要在当前环境中签名, 请运行 :

box logout

这将取消 Box 上的访问符并清除本地的快取 。 对 OAuth , 运行 box login 重新授权。 对于CCG和JWT,在下一个命令上会自动获取一个新的令牌. 使用 -f 跳过确认提示,或 --on-revoke-failure=clear 编号 : --on-revoke-failure=abort 当撤销令牌失败时控制行为。 见 box logout 详细情况.

安全存储

Box CLI 使用安全存储保护您的敏感数据:

何为安全存储

• 环境配置:客户身份、客户秘密以及企业身份、私人钥匙和公共钥匙
• 身份验证: 为所有配置环境访问令牌并刷新令牌

平台支持

Linux 安装

在 Linux 系统中, 您需要安装 libsecret-1-dev 安全储存.

说明: 如果不安装 libsecret, CLI 将自动返回到纯文本文件中存储证书 ~/.box/你仍然可以使用CLI, 但是为了安全起见,我们建议安装 libsecret.

自动迁移

当您升级到安全存储支持的版本时 :

• 现有的纯文本证书会自动读取
• 在下一个令牌刷新或配置更新时, 证书会迁移到安全存储
• 在成功迁移后, 将自动删除旧的纯文本文件
• 不需要人工操作!

数据位置

• 安全存储: 证书存储在您的OS 密钥链/证书管理器中
• 后退( 如果无法安全存储)数字 : ~/.box/box_environments.json 财务报告和审定财务报表 ~/.box/{environment}_token_cache.json

使用量

$ box --version
box-cli/0.0.0 darwin-x64 node-v10.10.0
$ box users:get --help
Get information about a Box user

USAGE
  $ box users:get [ID]

ARGUMENTS
  ID  [default: me] ID of the user to get; defaults to the current user

OPTIONS
  -h, --help                             Show CLI help
  -s, --save                             Save report to default reports folder on disk
  -t, --token=token                      Provide a token to perform this call
  -v, --verbose                          Show verbose output, which can be helpful for debugging
  -y, --yes                              Automatically respond yes to all confirmation prompts
  --as-user=as-user                      Provide an ID for a user
  --bulk-file-path=bulk-file-path        File path to bulk .csv or .json objects
  --csv                                  Output formatted CSV
  --fields=fields                        Comma separated list of fields to show
  --json                                 Output formatted JSON
  --no-color                             Turn off colors for logging
  --save-to-file-path=save-to-file-path  Override default file path to save report
$ box users:get
Type: user
ID: '77777'
Name: Example User
Login: [email protected]
Created At: '2016-12-07T17:30:40-08:00'
Modified At: '2018-11-15T17:33:06-08:00'
Language: en
Timezone: America/Los_Angeles
Space Amount: 10737418240
Space Used: 53569393
Max Upload Size: 5368709120
Status: active
Job Title: ''
Phone: ''
Address: ''
Avatar URL: 'https://app.box.com/api/avatar/large/77777'

命令主题

• box ai - 请求使用Box AI支持LLMS。 这是直接使用的,而不是由AI代理使用.
• box autocomplete - 显示自动完成安装指令
• box collaboration-allowlist - 清单合作许可列表条目
• box collaborations - 管理协作
• box collections - 列出你的收藏
• box comments - 管理文件的注释
• box configure - 配置盒式CLI
• box device-pins - 列出您企业的所有设备指针
• box events - 参加活动
• box file-requests - 将已有的文件请求复制到新文件夹
• box files - 管理文件
• box folders - 管理文件夹
• box groups - 列出所有团体
• box help - 显示 Box CLI 的帮助
• box hubs - 当前用户的列表框枢纽
• box integration-mappings - 列出Slack集成绘图
• box legal-hold-policies - 法律控股政策清单
• box login - 与 OAuth 2.0 签名,并创建一个新的环境(或用 -- reauthization 更新现有的环境).
• box logout - 撤销访问令牌并清除本地令牌缓存.
• box metadata-cascade-policies - 在文件夹上列出元数据级联政策
• box metadata-query - 使用类似 SQL 的语法创建搜索以返回匹配特定元数据的项目
• box metadata-templates - 获取企业号中的所有元数据模板
• box oss - 打印Box CLI中使用的开源许可软件包清单
• box recent-items - 列出过去90天查阅的文件资料,最多1 000件
• box request - 手动指定框 API 请求
• box retention-policies - 列出企业的所有留存政策
• box search - 在您的企业号搜索文件和文件夹
• box shared-links - 管理共享链接
• box sign-requests - 名单签名请求
• box sign-templates - 列表标志模板
• box storage-policies - 清单存储政策
• box tasks - 管理任务
• box terms-of-service - 列出贵国企业的服务条件
• box tokens - 拿个纪念品 默认返回服务账户符号
• box trash - 列出垃圾桶中的所有项目
• box update - 使用 GitHub 更新 BoxCLI
• box users - 列出所有方框用户
• box version
• box watermarking - 在物品上贴上水印
• box web-links - 管理网页链接
• box webhooks - 列出所有网点

问题、虫子和特性请求?

浏览发行票或者,如果那样行不通的话, 提交新文件 有人会回来找你的 如果你对 API框中,您可以发送到 框开发者论坛。 。 。 .

版本数

我们使用修改后的版本 语义版本 所有变化。 见 版本策略 从2022年7月30日起生效的细节.

支持的版本

只支持当前SDK的MAJOR版本. 新的功能,功能,错误修正,和安全更新将只被添加到目前的MAJOR版本.

目前发行的版本处于我们SDK开发的前沿,面向正在积极开发,想要最新而最出名的客户. 我们没有说明新功能的发布日期,而是设定一个固定的次要或补丁发布cadence最长为2至3个月(而我们可能更经常地发布). 同时,没有关于重大或断裂释放的时间表。 相反,我们将提前四分之一通报即将发生的突破性变化,以使客户能够计划升级。 我们总是建议所有用户对使用中的任何主要版本运行最新发布的小版本。 我们强烈建议尽早在EOL日期之前升级到最新的SDK主版.

版本时间表

协助箱式CLI

1. 克隆这回波.
2. 运行 npm install。 。 。 .
3. 运行 npm test 确保一切正常运行.
4. 进行您想要的更改 src/ 目录。 确保添加相应的测试 输入 test/ 目录!
5. 用您的修改创建一个拉动请求——我们将审查,帮助您得到合并.

详情请参见 捐款准则。 。 。 .

版权和许可证

版权2018 Box, Inc. 版权所有.

根据Apache许可证第2.0版("License"); 您不得使用此文件,除非符合许可证. 您可在下列地点获得许可证副本:

http://www.apache.org/licenses/LICENSE-2.0 (中文(简体) )

除非适用的法律要求或书面同意,否则软件 根据许可证发放的是在“AS IS”BASIS上发放的, 没有任何明示或暗示的警告或条件. 有关许可的特定语言的许可证 许可证的限制.

该软件包括第三方图书馆,这些图书馆按照自己的许可证条款分发; 见 (原始内容存档于2013-10-10). LICENSE-TARTY.txt 详细情况.