云化CLI参考

云线界面使你能够通过命令行与云线交互举例说,您可以执行并上传API操作,将命令输入终端而不必花时间建立正式编码环境额外辅助命令帮助测试变换、优化和其他常用动作也可以将批量文件命令归并到自动化劳累任务

我们邀请你试免费 云性CLI简介在线课程,在那里你可以得到云化提供多上传、管理变换选项概述,并学习如何通过命令行轻易应用这些选项

安装配置

1. 预设条件:云化CLI使用时需要Python3.6或以后使用可安装 Pythonhttps://www.python.org.Python包安装程序Pip网路装配式

2. 安装云式CLI运行

3. 令所有你焊德命令指针云化产品环境CLOUDIORY_URL环境变量取表单 : @ .

   例例设置临时环境变量

   • Mac或Linux

   • Windows上:

   可能宁可设置持久环境变量,但请注意,通过存储入壳启动脚本,你可能置API机密于险境
   小技巧

   可复制并粘贴 API环境变量从 机牌板页 云化控制台.

4. 通过运行检查配置 :

   响应返回表单

设置配置参数

可设置任意配置参数通过附送CLOUDIORY_URL环境变量查询字符串设置时默认配置或设置替代配置时使用配置命令

举个例子使用云式数据中心https://api-eu.www.aaaalireno.com并设置自定义域名域名.com中添加上传前缀并名码参数环境变量

可见运行配置参数设置sld配置命令 :

升级

更新云化CLI最新版

基础命令

帮助启动命令中有一些基本命令可用

列表命令输入 :

查看CLI版本PythonSDK和Python输入

查看可用管理员API方法

查看可用上传API方法,输入

显示搜索API用法输入

查看可用工具输入 :

看命令概述列表所有可用命令或命令引用语法细节使用示例命令

查看视频看CLI安装配置,加一些基本命令

教程内容

---

命令概述

全云化CLI命令启动焊德.命令通用语法如下:

举例说,下命令运行贝斯特登录入口官网下载resources_by_moderation方法中管理员API限制信息输出到ERROR层次返回最多40个原文件的细节感知点错误检测反磁件插件,保存输出文件调用'输出.txt'

可分解命令如下:

语法	实例
cli选项	逆差
命令	管理员
命令选项	save输出.txt 最大结果40 资源类型原型
方法论	贝斯特登录入口官网下载resources_by_moderation
方法参数	perception_point 拒绝

可选参数可指定为命令选项(如上例)或使用分配值语法

• 如果指定为命令选项,则可以在方法前后定位或直觉定位
• if descript使用分配语法

上例可用下列方式输入:

或(使用语法分配值):

CLI选项

CLI选项	描述性
-c,-config	告诉CLI哪个产品环境通过指定环境变量运行命令重置默认配置
-C,-config_saved	告诉CLI哪个产品环境通过指定保存配置运行命令看配置命令重置默认配置
-v,-verbosity(级别)	具体说明信息输出层次:Critical、Error、Warning、INFO或DEBUG
--version	显示CLI版本、PythonSDK基础和Python
--help	显示帮助

命令类

API命令

命令	描述性
管理员	从管理员API运行方法
上传程序	运行方法上传API
搜索	运行搜索方法管理API
提供	运行方法提供API

文件管理

命令	描述性
迁移	取外部媒体文件列表,用相同前缀引用URL
同步	本地文件夹和云文件夹同步
上传_dir	上传资产文件夹并维护文件夹结构
再生源	重生衍生资产与命名变换或变换字符串相关

帮助者

命令	描述性
实用值	运行工具法
建材	返回模板代码实现指定的云部件或功能
URL	生成云式URL

配置

命令	描述性
配置	管理产品环境配置

---

命令引用

管理员

上头管理员命令允许运行通过adminAPI调用的任何方法管理员API受率限制贝斯特登录入口官网下载API提供全控所有上传媒体资产(资源)、获取社会简介图片、生成变换等

看管理员API引用细节方法

语法

命令选项

选题	描述性
o,-objectal参数	可选参数原始字符串
O,-可选参数分解	可选参数解析字符串
sss	列表所有可用方法
save(文件名)	保存输出到文件
-d-doc	打开管理员API引用浏览器中
--help	显示帮助

方法论

使用焊德管理员列表所有可用管理员API方法并引用管理员API引用查看适用于每种方法的参数

例举方法贝斯特登录入口官网下载resources_by_tag需要参数标签识别和各种可选参数列表最多十部视频最大结果并资源类型贴上动物标签,输入 :

实例

显示产品环境中所有标签

列出产品环境内所有资源类型

创建命名变换后上传预置使用命名变换

---

上传程序

上头上传程序命令允许运行通过上传API调用的任何方法上传API允许您上传和管理介质资产

看上传a细节方法

语法

命令选项

选题	描述性
o,-objectal参数	可选参数原始字符串
O,-可选参数分解	可选参数解析字符串
sss	列表上传API中所有可用方法
save(文件名)	保存输出到文件
-d-doc	打开上传a浏览器中
--help	显示帮助

方法论

使用sld上传程序列表所有可用上传API方法并引用上传a查看适用于每种方法的参数

例举方法重命名需要两个参数from_public_id并to_public_id和各种可选参数重命名相片1到相片2,制作相片2私自并撤销光片1to_类型并无效输入 :

实例

想象一下你有一连串照片 并想转成幻灯片秀可上传标签并随后从图像中创建动画GIF下例中,我们有一个本地文件夹,内存鸟图像Bash脚本从文件夹内运行并上传本地文件夹中每个JPG后使用多维从所有图像创建动画GIF法并贴上Bird标签,在每个框架间延迟1300ms

结果显示鸟图像滑动

下还有一个例子多维动作方法 :

教程内容

上传ai方法从PDF页面生成图像图例

教程内容

---

搜索

上头搜索命令运行管理员API搜索方法论方法允许您过滤并检索产品环境所有资产的信息,同时帮助查询表达式使用类似Luceen查询语言

看搜索方法文档获取更多细节

语法

命令选项

选题	描述性
f,-with_field	指定非默认资产属性f标签互换.或选,你可包含多个这些选项,例如f标签-f上下文.
fi,-fields	指定结果中应包含哪些资产属性(连同默认属性子集)为逗号分离列表,例如fi标签解析.或选,你可包含多个这些选项,例如fi标签-fi上下文.重置指定值带_field.
s,-sort_bject	排序查找结果指定字段向上或向下
a集合	指定属性计算并返回聚合计数
-n,-max_结果(整数)	最大结果返回默认值:10最大值:500
-c,-next_cror	继续使用已有游标搜索
A-自动机	返回所有结果可多次调用管理员API
F-F	运行时跳过确认自动嵌入式.
ff,-filter_fields	指定响应中哪些属性显示为逗号分离表,例如ff格式公有性.或选,你可包含多个这些选项,例如ff格式-ff公开_id.响应中不显示其他属性 。可使用过滤默认字段以及通过使用添加字段带_field或字段内.
t,-tl	可缓存搜索 URLTL 秒数默认值:300
-u-url	构建可缓存搜索 URL
json(文件名)	保存JSON输出文件
sv文件名	CSV输出保存到文件
-d-doc	打开搜索API文档页
--help	显示帮助

表达式

搜索表达式支持表达式见表达式.

实例

查找贴上最后一天上传并大于100kB图像贝斯特登录入口官网下载响应中包括标签字段,按上移顺序对结果排序,并限制返回结果为30个资源:

样本输出 :

由响应显示公有标签ff公有i:

样本输出 :

---

提供

上头提供命令允许运行通过提供API调用的任何方法提供API使你能够创建和管理产品环境,用户名并用户群.提供API可用企业平面图请求.

看提供a参考细节方法

调用提供方法

• 产品环境需要搭建提供

• 你需要搭建CLOUDINARY_ACCOUNT_URL环境变量取表单 : @ .设置临时环境变量,例如

  • Mac或Linux

  • Windows上:

  小技巧

  可复制并粘贴组件 CLOUDINARY_ACCOUNT_URL从 提供API访问段 账号页 云控制台设置.if您的账号不设备 请求后For 企业平面图),你看不到此段

语法

命令选项

选题	描述性
o,-objectal参数	可选参数原始字符串
O,-可选参数分解	可选参数解析字符串
sss	列表提供API中所有可用方法
save(文件名)	保存输出到文件
-d-doc	打开提供a参考浏览器中
--help	显示帮助

方法论

使用焊接提供列表所有可用提供API方法并引用提供a参考查看适用于每种方法的参数

举例说 方法更新用户中包含一个参数用户标识和各种可选参数更新用户标识7f08f1f1fc910bf1f25274aef11d27至管理员输入 :

实例

创建产品环境调用docs-de云调用docs-demo-cloud基于现有产品环境ID0918b03ea306482e4858ee1ac2e7c8:

样本响应 :

创建用户调用John Smith,他们的邮箱地址johnsmith@example.com中带media_library_user角色访问带ID的产品环境0918b03ea306482e4858ee1ac2e7c8并7ad7f4e93ba3f349ee63642fb68e42:

样本响应 :

---

迁移

使用迁移命令迁移外部媒体文件列表URL迁移文件列入单文件并必须全部有相同的前缀

语法

命令选项

选题	描述性
-d,-destricte	URL使用分离器如果未指定定界符,则新线假设为分隔符
-v-verbose	输出文件
--help	显示帮助

上传映像

安市自动加载URL映射并配置产品环境上传设置集成上传映像名映射文件夹

文件库

内含URL文件名,每个文件均有URL前缀自动加载URL映射.

实例

URL文件指向想迁移到云化产品环境的资产例子中所有资产前缀为s/upload.wikimedia.org/wikipedia/commons/

文件调用url文件.txt看上去像这个

https://upload.wikimedia.org/wikipedia/commons/c/cb/Eden_Gardens_under_floodlights_during_a_match.jpg;https://upload.wikimedia.org/wikipedia/commons/d/dc/Historical_cricket_bat_art.jpg;https://upload.wikimedia.org/wikipedia/commons/a/ae/Olympic_flag.jpg;https://upload.wikimedia.org/wikipedia/commons/3/35/Olympic-flag-Victoria.jpg

优先配置自动加载URL映射产品环境上传设置映射云文件夹,例如,emote-media文件夹若不存在则会自动创建

可创建云控制台上传映射上传设置或使用CLI如下:

运行此命令迁移所有资产url文件.txt切入点远程媒体文件夹云化产品环境返回verbose输出

样本动词输出 :

---

同步

上头同步命令同步本地文件夹和云文件夹,维护文件夹结构

语法

命令选项

选题	描述性
--push	从本地文件夹推换云端文件夹
--pull	从云文件夹调换本地文件夹
HH隐蔽	内含隐藏文件同步
-w,-convent_works	指定并发网络线程数默认数:30
F-F	删除文件时跳过确认
k-keep-unique	唯一文件保留在目标文件夹中
-D,-Eletion批量大小(整数)	指定批量大小删除远程资产默认数:30
o,-objectal参数	安市可选上传参数转成生字符串
O,-可选参数分解	安市可选上传参数传递解析字符串
--help	显示帮助

本地文件夹

本地文件夹与云文件夹同步

cloudinary_folder

云端全路径与本地文件夹同步可使用前向斜线分离文件夹指定路径

• 固定文件夹模式cloudinary_folder上传资产公共标识的第一部分(直至最后前向斜线)。
• 动态文件夹模式cloudinary_folder算法资产文件夹上传资产

实例

推送本地文件夹修改 my_images至云端文件夹修改 my_cld_images/my_images

样本输出 :

后从云文件夹删除两个文件下拉修改回带-F选项本地文件夹,免提示确认删除文件

样本输出 :

---

上传_dir

使用上传_dir命令上传资产文件夹并维护文件夹结构

语法

命令选项

选题	描述性
glob模式	glob模式例举使用/*.jpg只上传JPG文件
HH隐蔽	包含隐藏文件
o,-objectal参数	安市可选上传参数转成生字符串
O,-可选参数分解	安市可选上传参数传递解析字符串
t, -- transformation	转换应用所有上传
-f,-文件夹	云形全路径上传资产可指定整条路径,例如path1/path2/path3不存在文件夹自动创建 固定文件夹模式中,指定的文件夹路径是上传资产公共标识的第一部分(直达最终前向斜线)。 动态文件夹路径资产文件夹上传资产
-p,-preset	上头上传预置使用方式
e,-Exclude-dir-name	使用此选项时,父目录内容上传,但不上传父目录本身
-w,-convent_works	指定并发网络线程数默认数:30
-d-doc	显示文档上传_dir.
--help	显示帮助

本地文件夹

本地文件夹上传至云如果省略此参数,则上传当前文件夹的内容

实例

上传本地文件夹myimages中所有内容和子文件夹my_images_on_cloudinary覆盖现有文件

产生云形文件夹结构

Home+-My_images_on_cludiany+-My_images++
          
          

与上标相同,但不包括父文件夹名myimages.

产生云形文件夹结构

home+-myimages_on_cludian
          
          

视频显示上传_dir动作命令 :

教程内容

---

再生源

使用再生源命令重生所有衍生资产与具体命名变换或变换字符串相关更新命名变换失效后使用此功能,并用最新版本资产重新填充缓存

语法

命令选项

选题	描述性
eager通知_url	webhook通知URL
ea-eager-async	异步生成
A-自动机	自动引导API调用
F-F	跳过初始确认
-n,-max_结果(整数)	最大结果返回默认值:10最大值:500
-w,-convent_works	指定并发网络线程数默认数:30
--help	显示帮助

transformation_name

或名a命名变换举个例子黑边界或变换字符串等t_black-border/a_50/l_icon/fl_layer_apply,g_west.

实例

异步重生所有资产使用命名变换小方块中跳过初始确认并通知专用webhook

样本响应 :

恢复使用变换字符串生成的所有资产t_small-square/f_avif,fl_aavif/a_30/jpg中跳过初始确认

样本响应 :

---

实用值

上头实用值命令允许运行云化实用法

语法

命令选项

选题	描述性
o,-objectal参数	可选参数原始字符串
O,-可选参数分解	可选参数解析字符串
sss	列表所有可用工具方法
--help	显示帮助

方法论

使用焊德用法列表所有可用工具方法参考下表链接查看每种方法适用的参数

方法定义	学习更多
api_sign_request	使用云后端SDKs生成SHA认证签名
云化_url	嵌入图片网页使用SDKs
download_archive_url	下载_archive_url语法
download_backedup_asset	下载备份法
下载文件夹	下载文件夹语法
download_zip_url	下载_zip_url语法
private_download_url	提供受时间限制私媒体资产访问
verify_api_response_signature	验证JSON响应签名
verify_notification_signature	验证通知签名

实例

生成签名时参数签名{timestamp} 1595793040,public_idAPI秘密32312716117519:

样本输出 :

生成 URL以公有ID交付资产采样宽度为300像素,高度为100像素

样本输出 :

---

建材

上头建材命令返回模板代码执行指定的云式部件或功能

语法

命令选项

选题	描述性
-ll-list语言	列表可用语言
it-list-templates	列表可用模板
--help	显示帮助

语言类

可变语言
ython语言
html(默认)
节点
红宝石

模板化

端点	描述性
find_all_empty_folders	返回模板代码查找空文件夹
media_library_widget	返回模板代码媒体库部件.
产品装饰	返回模板代码产品画廊.
上传widget	返回模板代码上传部件.
视频播放器	返回模板代码视频播放器.

实例

生成样本代码执行网页基本上传部件

样本输出 :

生成样本Python代码查找所有空文件夹

样本输出 :

---

URL

上头URL命令生成云式URL,可在浏览器中任选打开

语法

命令选项

选题	描述性
-rt,-resource类型	资产类型
t,-类型[上载,私有,认证,取取取,列表,url2png	上头交付类型.
OOOpen	生成衍生资产并打开浏览器
s,-sign	生成签名URL
--help	显示帮助

变换

变换资产URL语法使用变换URLAPI引用.

实例

使用公共ID执行图像下演变换docs/animals_on_road:

• 调整宽度到400像素使用用自动重力缩图裁剪模式
• 使用 10 色和60%细节应用向量化效果
• 加维格内特特效果加强40

样本输出 :

使用URL2PNG上加抓取云端主页顶部截图,对抓取图像应用灰度效果,并打开浏览器变换图像URL2PNG上加号要求URL签名,使用-s选项

样本输出 :

---

配置

配置指向特定云产品环境环境环境环境环境环境环境环境环境环境环境环境环境环境环境环境环境环境环境环境环境环境环境环境环境环境环境环境环境环境环境环境环境环境环境环境环境环境环境环境环境环境环境环境环境环境环境环境环境环境环境环境环境环境环境环境环境环境环境环境环境环境环境环境默认配置设置安装配置.使用不同的配置允许访问不同的云化产品环境

上头配置命令显示当前配置并允许管理更多配置

可明文指定附加云化产品环境环境环境环境变量-c选项或保存配置C级选项)

例举使用-c选项 :

使用保存配置actx

可使用配置命令创建、删除和列表保存配置

并见:设置配置参数

语法

选项

选题	描述性
n-n-n-nv_var_url	创建并命名云环境变量配置
sss	列表全部保存配置
s,-show	显示指定配置细节
m,-rm	删除指定配置
url,-from_url	从云环境变量创建配置配置名称为云名
--help	显示帮助

实例

在这些例子中,我们使用环境变量编译

显示当前配置

创建附加配置命名计数器显示细节,显示上传预设并配置成此产品环境,然后删除配置

从环境变量创建附加配置配置自动提供与云名同名,在此例云名.上传图片到产品环境并应用相关标签

将全部保存配置列表为文件配置txt, 并删除所有配置