aspera-cli 4.21.2 → 4.23.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (105) hide show
  1. checksums.yaml +4 -4
  2. checksums.yaml.gz.sig +0 -0
  3. data/BUGS.md +1 -1
  4. data/CHANGELOG.md +402 -374
  5. data/CONTRIBUTING.md +6 -10
  6. data/README.md +1018 -687
  7. data/lib/aspera/agent/base.rb +9 -5
  8. data/lib/aspera/agent/connect.rb +30 -28
  9. data/lib/aspera/agent/desktop.rb +29 -25
  10. data/lib/aspera/agent/direct.rb +137 -125
  11. data/lib/aspera/agent/httpgw.rb +22 -26
  12. data/lib/aspera/agent/node.rb +14 -11
  13. data/lib/aspera/agent/transferd.rb +6 -2
  14. data/lib/aspera/api/aoc.rb +15 -18
  15. data/lib/aspera/api/cos_node.rb +1 -1
  16. data/lib/aspera/api/httpgw.rb +15 -7
  17. data/lib/aspera/api/node.rb +6 -4
  18. data/lib/aspera/ascmd.rb +17 -9
  19. data/lib/aspera/ascp/installation.rb +21 -19
  20. data/lib/aspera/ascp/management.rb +1 -1
  21. data/lib/aspera/assert.rb +14 -5
  22. data/lib/aspera/cli/error.rb +2 -2
  23. data/lib/aspera/cli/extended_value.rb +38 -19
  24. data/lib/aspera/cli/formatter.rb +48 -48
  25. data/lib/aspera/cli/hints.rb +10 -2
  26. data/lib/aspera/cli/main.rb +190 -168
  27. data/lib/aspera/cli/manager.rb +16 -16
  28. data/lib/aspera/cli/plugin.rb +24 -21
  29. data/lib/aspera/cli/plugin_factory.rb +1 -1
  30. data/lib/aspera/cli/plugins/alee.rb +1 -1
  31. data/lib/aspera/cli/plugins/aoc.rb +173 -126
  32. data/lib/aspera/cli/plugins/ats.rb +19 -17
  33. data/lib/aspera/cli/plugins/config.rb +87 -98
  34. data/lib/aspera/cli/plugins/console.rb +5 -3
  35. data/lib/aspera/cli/plugins/faspex.rb +39 -35
  36. data/lib/aspera/cli/plugins/faspex5.rb +104 -80
  37. data/lib/aspera/cli/plugins/faspio.rb +13 -1
  38. data/lib/aspera/cli/plugins/httpgw.rb +13 -1
  39. data/lib/aspera/cli/plugins/node.rb +336 -205
  40. data/lib/aspera/cli/plugins/orchestrator.rb +34 -40
  41. data/lib/aspera/cli/plugins/preview.rb +3 -3
  42. data/lib/aspera/cli/plugins/server.rb +7 -6
  43. data/lib/aspera/cli/plugins/shares.rb +5 -5
  44. data/lib/aspera/cli/sync_actions.rb +19 -18
  45. data/lib/aspera/cli/transfer_agent.rb +11 -15
  46. data/lib/aspera/cli/transfer_progress.rb +2 -2
  47. data/lib/aspera/cli/version.rb +1 -1
  48. data/lib/aspera/command_line_builder.rb +116 -95
  49. data/lib/aspera/coverage.rb +4 -3
  50. data/lib/aspera/data_repository.rb +1 -0
  51. data/lib/aspera/environment.rb +7 -6
  52. data/lib/aspera/faspex_gw.rb +14 -14
  53. data/lib/aspera/faspex_postproc.rb +7 -6
  54. data/lib/aspera/hash_ext.rb +2 -2
  55. data/lib/aspera/json_rpc.rb +1 -1
  56. data/lib/aspera/keychain/encrypted_hash.rb +47 -34
  57. data/lib/aspera/keychain/factory.rb +41 -0
  58. data/lib/aspera/keychain/hashicorp_vault.rb +71 -0
  59. data/lib/aspera/keychain/macos_security.rb +19 -11
  60. data/lib/aspera/log.rb +29 -34
  61. data/lib/aspera/nagios.rb +6 -6
  62. data/lib/aspera/node_simulator.rb +8 -8
  63. data/lib/aspera/oauth/base.rb +10 -6
  64. data/lib/aspera/oauth/factory.rb +6 -6
  65. data/lib/aspera/oauth/url_json.rb +6 -6
  66. data/lib/aspera/persistency_action_once.rb +6 -4
  67. data/lib/aspera/persistency_folder.rb +2 -2
  68. data/lib/aspera/preview/file_types.rb +40 -33
  69. data/lib/aspera/preview/generator.rb +1 -1
  70. data/lib/aspera/preview/options.rb +16 -16
  71. data/lib/aspera/preview/terminal.rb +3 -3
  72. data/lib/aspera/preview/utils.rb +11 -13
  73. data/lib/aspera/products/connect.rb +2 -1
  74. data/lib/aspera/products/desktop.rb +1 -1
  75. data/lib/aspera/products/transferd.rb +1 -1
  76. data/lib/aspera/proxy_auto_config.rb +2 -2
  77. data/lib/aspera/rest.rb +70 -50
  78. data/lib/aspera/rest_error_analyzer.rb +1 -0
  79. data/lib/aspera/rest_errors_aspera.rb +1 -1
  80. data/lib/aspera/secret_hider.rb +5 -5
  81. data/lib/aspera/ssh.rb +5 -5
  82. data/lib/aspera/temp_file_manager.rb +1 -0
  83. data/lib/aspera/timer_limiter.rb +7 -5
  84. data/lib/aspera/transfer/async_conf.schema.yaml +716 -0
  85. data/lib/aspera/transfer/convert.rb +29 -0
  86. data/lib/aspera/transfer/error_info.rb +66 -66
  87. data/lib/aspera/transfer/parameters.rb +13 -68
  88. data/lib/aspera/transfer/spec.rb +5 -6
  89. data/lib/aspera/transfer/spec.schema.yaml +753 -0
  90. data/lib/aspera/transfer/spec_doc.rb +62 -0
  91. data/lib/aspera/transfer/sync.rb +37 -76
  92. data/lib/aspera/transfer/sync_instance.schema.yaml +20 -0
  93. data/lib/aspera/transfer/sync_session.schema.yaml +86 -0
  94. data/lib/aspera/transfer/uri.rb +6 -6
  95. data/lib/aspera/uri_reader.rb +1 -1
  96. data/lib/aspera/web_auth.rb +1 -1
  97. data/lib/aspera/web_server_simple.rb +53 -44
  98. data.tar.gz.sig +0 -0
  99. metadata +38 -7
  100. metadata.gz.sig +0 -0
  101. data/examples/build_package.sh +0 -28
  102. data/examples/dascli +0 -30
  103. data/examples/get_proto_file.rb +0 -8
  104. data/examples/proxy.pac +0 -60
  105. data/lib/aspera/transfer/spec.yaml +0 -718
data/CHANGELOG.md CHANGED
@@ -1,20 +1,48 @@
1
1
  # Changes (Release notes)
2
2
 
3
- * 4.21.2
3
+ * 4.23.0 2025-08-11
4
+ * New Features:
5
+ * `aoc`: #201: Added `package_folder` option to place each received package in its own subfolder named after a package attribute. Default is `@none:` which means no subfolder will be created.
6
+ * `config`: Added `transferd` version 1.1.6.
7
+ * Issues Fixed:
8
+ * `server`: #209: missing home folder for transfer user shall not cause an error.
9
+ * `direct`: #205: `kill` blocks `cmd` on Windows.
10
+ * Breaking Changes:
11
+ * `config`: In `ascp info`: `openssldir` → `ascp_openssl_dir`, `openssl_version` → `ascp_openssl_version`, `sdk_ascp_version` → `ascp_version`
12
+
13
+ * 4.22.0 2025-06-23
14
+
15
+ * New Features:
16
+ * `faspex5`: Support paging for Faspex5 browsing.
17
+ * `aoc`: #196 Command `packages list` now also supports option `once_only`.
18
+ * `vault`: Support for IBM HashiCorp Vault to store secrets.
19
+ * `wizard`: Preset name can now be specified as optional positional parameter.
20
+ * `config`: New command `ascp schema` displays JSON schema for transfer spec for all, or just one agent.
21
+ * `node`: #198 By default do not allow creation of folder if a link exists with the same name. Use option `query` with parameter `check` set to `false` to disable.
22
+ * `node`: In gen4 operations, also used in `aoc files`, new commands: `mklink`, `mkfile`.
23
+ * Issues Fixed:
24
+ * `aoc`: #195 `package receive ALL` for shared inbox without workspace now works.
25
+ * Breaking Changes:
26
+ * `faspex5`, `aoc`: `gateway` now takes argument as `Hash` with `url` instead of only `String`.
27
+ * `faspex5 postprocessing`: Now takes a flat `Hash`, instead of multi-level `Hash`.
28
+ * HTTP: More retry parameters.
29
+ * `node`: renamed command `http_node_download` to `cat`, and it directly displays the content of the file in the terminal unless option `--output` is specified.
30
+
31
+ * 4.21.2 2025-04-11
4
32
 
5
33
  * New Features:
6
34
  * **container**: Updated Ruby to 3.4.2
7
35
  * Issues Fixed:
8
36
  * **global**: #185 `@val:` shall stop processing extended values
9
- * **global**: #186 Removed dependency on openssl 3.3 gem to avoid msys dep on Windows.
37
+ * **global**: #186 Removed dependency on OpenSSL 3.3 gem to avoid MSYS2 dep on Windows.
10
38
  * `echo`: Display of list (Array) was showing only first element of it.
11
- * `transferd`: support for version 1.1.5+
39
+ * `transferd`: Support for version 1.1.5+
12
40
  * Breaking Changes:
13
41
  * `preview`: Updated Image Magick to v7+
14
42
  * `aoc`: `admin subscription` split into `admin subscription account` and `admin subscription usage`
15
43
  * **agent**: `alpha` renamed to `desktop`
16
44
 
17
- * 4.21.1
45
+ * 4.21.1 2025-03-15
18
46
 
19
47
  * New Features:
20
48
  * `config`: New command: `transferd` to list and install specific version of `asperatransferd` and `ascp`
@@ -25,86 +53,86 @@
25
53
  * `config`: #175 `ascli config preset set GLOBAL version_check_days 0` causes a bad `config.yaml` to be written
26
54
  * `config`: #180 problem in `ascp install`
27
55
  * `config`: Soft links in transfer SDK archive are correctly extracted
28
- * `aoc`: #184 token cache shall be different per aoc org.
56
+ * `aoc`: #184 token cache shall be different per AoC org.
29
57
  * `aoc`: Fix `packages delete` not working.
30
- * `direct` agent: #174 Race condition fix with `ascp`: timeout waiting mgt port connect (select not readable)
58
+ * `direct` agent: #174 Race condition fix with `ascp`: timeout waiting management port connect (select not readable)
31
59
  * `preview`: #177 fix bug that prevents preview generation to work.
32
60
  * Breaking Changes:
33
- * `transferd`: Use of Aspera Transfer Daemon requires minimum version 1.1.4. agent `trsdk` renamed `transferd`.
61
+ * `transferd`: Use of Aspera Transfer Daemon requires minimum version 1.1.4. Agent `trsdk` renamed `transferd`.
34
62
  * `ascp`: Default SDK version is now 1.1.4. Removes support for ascp4.
35
63
  * `node`: Removed deprecated command prefix `exec:`, use `@ruby:` instead.
36
- * **global**: Now uses openssl 3.
37
- * **global**: Ruby minimum versions is now 3.1 (mainly due to switch to openssl 3). Future minimum is 3.2. Recommended is 3.4. (that removes macOS default ruby support. Newer Ruby version shall be installed on macOS with `brew`)
64
+ * **global**: Now uses OpenSSL 3.
65
+ * **global**: Ruby minimum versions is now 3.1 (mainly due to switch to OpenSSL 3). Future minimum is 3.2. Recommended is 3.4. (that removes macOS default ruby support. Newer Ruby version shall be installed on macOS with `brew`)
38
66
  * **global**: Options `transpose_single` and `multi_table` replaced with single option `multi_single` and values: `no`, `yes`, `single`.
39
67
  * **global**: Column name for single object is now `field` instead of `key`.
40
68
 
41
- * 4.20.0
69
+ * 4.20.0 2025-01-21
42
70
 
43
- ATTENTION: [Faspex version 4 is now end of support](https://www.ibm.com/support/pages/lifecycle/search?q=faspex): the `faspex` plugin will be deprecated. Servers shall be upgraded to Faspex 5, and users use plugin `faspex5`.
71
+ ATTENTION: [Faspex version 4 is now end of support](https://www.ibm.com/support/pages/lifecycle/search?q=faspex): The `faspex` plugin will be deprecated. Servers shall be upgraded to Faspex 5, and users use plugin `faspex5`.
44
72
 
45
73
  * New Features:
46
74
  * `aoc`: Improved usability for creation of Admin shared folders.
47
75
  * `node`: New option `node_cache` (bool) for gen4 operations.
48
- * `node`: Option `root_id` now works always for node gen4, as well as `%id:` for file selection in addition to path.
76
+ * `node`: Option `root_id` now always works for node gen4, as well as `%id:` for file selection in addition to path.
49
77
  * `node`: `transfer list` now uses the `iteration_token` to retrieve all values. Option `once_only` is now supported.
50
- * **global**: option `http_options` now include retry options.
78
+ * **global**: Option `http_options` now include retry options.
51
79
  * Issues Fixed:
52
80
  * `aoc`: Fixed `find` command not working. (undefined variable)
53
- * `aoc`: #165 aoc mkdir now follows the last link of containing folder
81
+ * `aoc`: #165 AoC `mkdir` now follows the last link of containing folder
54
82
  * Breaking Changes:
55
83
  * Internal: Basic REST calls now return data directly. (no more `data` key). For advanced calls, use `call`.
56
- * Internal: Transfer SDK download is now a 2-step procedure: First get the YAML file from github with URLS for the various platforms and versions, and then download the archive from the official IBM repository.
57
- **global**: option `format=multi` is replaced with option `multi_table=yes`
58
- * `faspex5`: removed deprecated option `value` replaced with positional parameter.
84
+ * Internal: Transfer SDK download is now a 2-step procedure: First get the YAML file from GitHub with URLs for the various platforms and versions, and then download the archive from the official IBM repository.
85
+ **global**: Option `format=multi` is replaced with option `multi_table=yes`
86
+ * `faspex5`: Removed deprecated option `value` replaced with positional parameter.
59
87
 
60
- * 4.19.0
88
+ * 4.19.0 2024-10-02
61
89
 
62
90
  * New Features:
63
- * `server`: add support for `async` (Aspera Sync) from Transfer SDK
64
- * **global**: #156 support sending folders with httpgw
65
- * **global**: new value for option `format`: `multi`
91
+ * `server`: Add support for `async` (Aspera Sync) from Transfer SDK
92
+ * **global**: #156 support sending folders with `httpgw`
93
+ * **global**: New value for option `format`: `multi`
66
94
  * Issues Fixed:
67
95
  * `aoc`: #157 fix problem with `files browse` on a link
68
- * `sync`: better documentation and handling of options.
96
+ * `sync`: Better documentation and handling of options.
69
97
  * Breaking Changes:
70
98
  * **global**: Default value for direct agent option `transfer_info.multi_incr_udp` is `true` on Windows, and now `false` on other platforms.
71
99
  * **global**: Token based transfers now use the RSA key only. Direct agent option `transfer_info.client_ssh_key` allows changing this behavior.
72
100
 
73
- * 4.18.1
101
+ * 4.18.1 2024-08-21
74
102
 
75
103
  * New Features:
76
- * none
104
+ * None
77
105
  * Issues Fixed:
78
106
  * **global**: #146 (@junkimu) Fix problem on Windows WRT terminal detection
79
- * **global**: node gen4 (aoc) browsing through link now follows the link correctly
107
+ * **global**: Node gen4 (`aoc`) browsing through link now follows the link correctly
80
108
  * `shares`: #147 Fix problem for `shares files mkdir`
81
109
  * Breaking Changes:
82
110
  * **global**: Removed option `id`, deprecated since 4.14.0
83
111
 
84
- * 4.18.0
112
+ * 4.18.0 2024-07-10
85
113
 
86
114
  * New Features:
87
- * `faspex5`: added command `admin configuration` for global parameters.
88
- * `faspex5`: added command `admin clean_deleted`.
89
- * `faspex5`: added resource `distribution_list`.
115
+ * `faspex5`: Added command `admin configuration` for global parameters.
116
+ * `faspex5`: Added command `admin clean_deleted`.
117
+ * `faspex5`: Added resource `distribution_list`.
90
118
  * `node`: "gen3" browse now returns all elements using pages, and supports option `query` with parameter `recursive`, `max`, `self`.
91
- * `httpgw`: new plugin, detect the GW.
92
- * `faspio`: new plugin, configure bridges.
93
- * `config`: `ascp info` also shows the version of the openssl library used by `ascp`.
94
- * `node`: new action: `transport` to display transfer address and ports
95
- * **global**: added option `http_proxy`, as an alias to env var `http_proxy`.
119
+ * `httpgw`: New plugin, detect the GW.
120
+ * `faspio`: New plugin, configure bridges.
121
+ * `config`: `ascp info` also shows the version of the OpenSSL library used by `ascp`.
122
+ * `node`: New action: `transport` to display transfer address and ports
123
+ * **global**: Added option `http_proxy`, as an alias to env var `http_proxy`.
96
124
  * **global**: Possibility to filter fields when using formats like `json` or `yaml`.
97
125
  * Issues Fixed:
98
- * `faspex5`: fixed support for percent selector for metadata profiles.
126
+ * `faspex5`: Fixed support for percent selector for metadata profiles.
99
127
  * Breaking Changes:
100
128
  * `aoc` : `admin resource` is deprecated, use just `admin`.
101
129
  * `faspex5` : `admin resource` is deprecated, use just `admin`.
102
- * **global**: option `value` is deprecated and replaced with option `query` when used in generic commands: `delete` and `list`, as well as node ak browse, node stream and watch folder list. (#142)
103
- * **global**: option `warnings` (and short `w`) is removed. To get ruby warnings invoke with `ruby -w .../ascli ...`. See `Makefile` in `test`
104
- * **global**: option `table_style` now expects a Hash, not String.
130
+ * **global**: Option `value` is deprecated and replaced with option `query` when used in generic commands: `delete` and `list`, as well as node access_key browse, node stream and watch folder list. (#142)
131
+ * **global**: Option `warnings` (and short `w`) is removed. To get ruby warnings invoke with `ruby -w .../ascli ...`. See `Makefile` in `test`
132
+ * **global**: Option `table_style` now expects a Hash, not String.
105
133
  * **bss**: Removed unused plugin.
106
134
 
107
- * 4.17.0
135
+ * 4.17.0 2024-07-13
108
136
 
109
137
  * New Features:
110
138
  * `faspex5`: Automatic detection of HTTPGW.
@@ -138,259 +166,259 @@
138
166
  * 4.16.0 2024-02-15
139
167
 
140
168
  * New Features:
141
- * **global**: option `output` to redirect result to a file instead of `stdout`
142
- * **global**: new option `silent_insecure`
143
- * `config`: keys added to `config ascp info`
144
- * `config`: added command `pubkey` to extract public key from private key
145
- * `config`: new command `vault info`
146
- * `faspex5`: added `shared_folders` management
147
- * `faspex5`: if package has content protection, ask passphrase interactively, unless `content_protection=null` in `ts`
148
- * `faspex`: added `INIT` for `once_only`
149
- * `aoc`: added `INIT` for `once_only`
150
- * `aoc`: more list commands honor option `query`
169
+ * **global**: Option `output` to redirect result to a file instead of `stdout`
170
+ * **global**: New option `silent_insecure`
171
+ * `config`: Keys added to `config ascp info`
172
+ * `config`: Added command `pubkey` to extract public key from private key
173
+ * `config`: New command `vault info`
174
+ * `faspex5`: Added `shared_folders` management
175
+ * `faspex5`: If package has content protection, ask passphrase interactively, unless `content_protection=null` in `ts`
176
+ * `faspex`: Added `INIT` for `once_only`
177
+ * `aoc`: Added `INIT` for `once_only`
178
+ * `aoc`: More list commands honor option `query`
151
179
  * Issues Fixed:
152
- * `config`: wizard was failing due to `require` of optional gem.
153
- * `aoc`: use paging to list entities, instead of just one page(e.g. retrieve all packages)
180
+ * `config`: Wizard was failing due to `require` of optional gem.
181
+ * `aoc`: Use paging to list entities, instead of just one page(e.g. retrieve all packages)
154
182
  * `faspex5`: When receiving ALL packages, only get those with status `completed`.
155
- * `direct` agent: better support for WSS
183
+ * `direct` agent: Better support for WSS
156
184
  * Breaking Changes:
157
- * `shares`: option `type` for users and groups is replaced with mandatory positional argument with same value.
158
- * `aoc`, `faspex`: package `recv` command changed to `receive`, for consistency with faspex5 (`recv` is now an alias command)
185
+ * `shares`: Option `type` for users and groups is replaced with mandatory positional argument with same value.
186
+ * `aoc`, `faspex`: Package `recv` command changed to `receive`, for consistency with faspex5 (`recv` is now an alias command)
159
187
 
160
188
  * 4.15.0 2023-11-18
161
189
 
162
- * General: removed many redundant options, more consistency between plugins, see below in "break".
190
+ * General: Removed many redundant options, more consistency between plugins, see below in "break".
163
191
  * New Features:
164
- * **global**: added resolution hints for well known issues.
165
- * **global**: extended value expression `@extend:` finds and replace extended values in a string (e.g. for JSON)
166
- * **global**: option `fields` now supports `RegExp`
167
- * **global**: option `home` to set the main folder for configuration and cache
168
- * **global**: option `ignore_certificate` to specify specific URLs instead of global option `insecure`
169
- * **global**: option `cert_stores` to specify alternate certificate stores
170
- * **global**: uniform progress bar for any type of transfer.
171
- * **global**: add extended value types: `re` and `yaml`
172
- * **global**: option `pid_file` to write tool's PID during execution, deleted on exit
173
- * `config`: command `remote_certificate` to retrieve a remote certificate
174
- * `config`: added logger level `trace1` and `trace2`
175
- * `config`: `wizard` can detect multiple applications at the same address or url.
176
- * `aoc`: wizard accepts public links
177
- * `aoc`: support private links, and possibility to list shared folder with workspace `@json:null`
178
- * `orchestrator`: error analysis for workflow start
179
- * `httpgw`: now supports pseudo file for testing: e.g. `faux:///testfile?1k`
180
- * `node`: added command `transfer sessions` to list all sessions of all transfers
181
- * `node`: generate bearer token from private key and user information
182
- * `node`: access node API with bearer token as credentials
183
- * **global**: agent `direct` allows ignoring certificate for wss using http options
184
- * `preview`: command `show` generates a preview and displays it in terminal
192
+ * **global**: Added resolution hints for well known issues.
193
+ * **global**: Extended value expression `@extend:` finds and replace extended values in a string (e.g. for JSON)
194
+ * **global**: Option `fields` now supports `RegExp`
195
+ * **global**: Option `home` to set the main folder for configuration and cache
196
+ * **global**: Option `ignore_certificate` to specify specific URLs instead of global option `insecure`
197
+ * **global**: Option `cert_stores` to specify alternate certificate stores
198
+ * **global**: Uniform progress bar for any type of transfer.
199
+ * **global**: Add extended value types: `re` and `yaml`
200
+ * **global**: Option `pid_file` to write tool's PID during execution, deleted on exit
201
+ * `config`: Command `remote_certificate` to retrieve a remote certificate
202
+ * `config`: Added logger level `trace1` and `trace2`
203
+ * `config`: `wizard` can detect multiple applications at the same address or URL.
204
+ * `aoc`: Wizard accepts public links
205
+ * `aoc`: Support private links, and possibility to list shared folder with workspace `@json:null`
206
+ * `orchestrator`: Error analysis for workflow start
207
+ * `httpgw`: Now supports pseudo file for testing: e.g. `faux:///testfile?1k`
208
+ * `node`: Added command `transfer sessions` to list all sessions of all transfers
209
+ * `node`: Generate bearer token from private key and user information
210
+ * `node`: Access node API with bearer token as credentials
211
+ * **global**: Agent `direct` allows ignoring certificate for WSS using HTTP options
212
+ * `preview`: Command `show` generates a preview and displays it in terminal
185
213
  * Issues Fixed:
186
214
  * Ruby warning: `net/protocol.rb:68: warning: already initialized constant Net::ProtocRetryError` solved by removing dependency on `net-smtp` from gem spec (already in base ruby).
187
215
  * Breaking Changes:
188
- * **global**: commands `detect` and `wizard` takes now a mandatory argument: address or url instead of option `url`.
189
- * **global**: renamed option `pkeypath` to `key_path`
190
- * **global**: renamed option `notif_to` to `notify_to` and `notif_template` to `notify_template`
191
- * **global**: removed extended value handler `incps`, as it is never used (use `extend` instead).
192
- * **global**: option `fields`: `+prop` is replaced with: `DEF,prop` and `-field` is replaced with: `DEF,-field`, and whole list is evaluated.
193
- * **global**: replaced option `progress` with option `progressbar` (bool)
194
- * **global**: removed option `rest_debug` and `-r`, replaced with `--log-level=trace2`
195
- * **global**: the default file name for private key when using wizard is change from `aspera_aoc_key` to `my_private_key.pem`
196
- * `faspex5`: removed option and `auth` type `link`: simply provide the public link as `url`
197
- * `faspex`: remote source selection now uses percent selector instead of parameter `id` or `name`
198
- * `faspex`: option `source_name` is now `remote_source`
199
- * `aoc`: selection by name uses percent selector instead of option or parameter `name`
200
- * `aoc`: removed option `link`: use `url` instead
201
- * `aoc`: in command `short_link`, place type before command, e.g. `short_link private create /blah`
202
- * `aoc`: replaced option `operation` with mandatory positional parameter for command `files transfer`
203
- * `aoc`: replaced option `from_folder` with mandatory positional parameter for command `files transfer`
204
- * `orchestrator`: workflow start takes arguments as optional positional extended value instead of option `param`
216
+ * **global**: Commands `detect` and `wizard` takes now a mandatory argument: address or URL instead of option `url`.
217
+ * **global**: Renamed option `pkeypath` to `key_path`
218
+ * **global**: Renamed option `notif_to` to `notify_to` and `notif_template` to `notify_template`
219
+ * **global**: Removed extended value handler `incps`, as it is never used (use `extend` instead).
220
+ * **global**: Option `fields`: `+prop` is replaced with: `DEF,prop` and `-field` is replaced with: `DEF,-field`, and whole list is evaluated.
221
+ * **global**: Replaced option `progress` with option `progressbar` (bool)
222
+ * **global**: Removed option `rest_debug` and `-r`, replaced with `--log-level=trace2`
223
+ * **global**: The default file name for private key when using wizard is change from `aspera_aoc_key` to `my_private_key.pem`
224
+ * `faspex5`: Removed option and `auth` type `link`: simply provide the public link as `url`
225
+ * `faspex`: Remote source selection now uses percent selector instead of parameter `id` or `name`
226
+ * `faspex`: Option `source_name` is now `remote_source`
227
+ * `aoc`: Selection by name uses percent selector instead of option or parameter `name`
228
+ * `aoc`: Removed option `link`: use `url` instead
229
+ * `aoc`: In command `short_link`, place type before command, e.g. `short_link private create /blah`
230
+ * `aoc`: Replaced option `operation` with mandatory positional parameter for command `files transfer`
231
+ * `aoc`: Replaced option `from_folder` with mandatory positional parameter for command `files transfer`
232
+ * `orchestrator`: Workflow start takes arguments as optional positional extended value instead of option `param`
205
233
  * `node`: `find` command now takes an optional `@ruby:` extended value instead of option `query` with prefix: `exec:`
206
- * `sync`: plugin `sync` is removed: actions are available through `server` and `node` plugins.
207
- * `sync`: replaced option `sync_session` with optional positional parameter.
208
- * `preview`: command `scan`, `events` and `trevents` replaced option `query` with optional positional parameter for filter (like `find`).
209
- * **global**: agent `trsdk` parameters `host` and `port` in option `transfer_info` are replaced with parameter `url`, like `grpc://host:port`
234
+ * `sync`: Plugin `sync` is removed: actions are available through `server` and `node` plugins.
235
+ * `sync`: Replaced option `sync_session` with optional positional parameter.
236
+ * `preview`: Command `scan`, `events` and `trevents` replaced option `query` with optional positional parameter for filter (like `find`).
237
+ * **global**: Agent `trsdk` parameters `host` and `port` in option `transfer_info` are replaced with parameter `url`, like `grpc://host:port`
210
238
 
211
239
  * 4.14.0 2023-09-22
212
240
 
213
241
  * New Features:
214
- * `server`: option `passphrase` for simpler command line (#114)
215
- * percent selector for entities identifier
216
- * `faspex5`: shared inbox and workgroup membership management
217
- * `faspex5`: invite external user to shared inbox
218
- * `faspex5`: package list and receive from workgroup and shared inbox
242
+ * `server`: Option `passphrase` for simpler command line (#114)
243
+ * Percent selector for entities identifier
244
+ * `faspex5`: Shared inbox and workgroup membership management
245
+ * `faspex5`: Invite external user to shared inbox
246
+ * `faspex5`: Package list and receive from workgroup and shared inbox
219
247
  * `config`: Command `ascp info` shows default transfer spec.
220
- * **global**: agent `httpgw` synchronous and asynchronous upload modes
221
- * `node`: command `bandwidth_average` to get average bandwidth of node, per periods
248
+ * **global**: Agent `httpgw` synchronous and asynchronous upload modes
249
+ * `node`: Command `bandwidth_average` to get average bandwidth of node, per periods
222
250
  * Issues Fixed:
223
- * option `ts`: deep add and remove of keys. (#117)
224
- * `faspex5`: user lookup for `packages send` shall be exact match (#120)
225
- * **global**: agent `direct` if transfer spec contains "paths" and elements with "destination", but first element has only "source", then destinations were ignored. Now "destination" all or none is enforced.
251
+ * Option `ts`: Deep add and remove of keys. (#117)
252
+ * `faspex5`: User lookup for `packages send` shall be exact match (#120)
253
+ * **global**: Agent `direct` if transfer spec contains "paths" and elements with "destination", but first element has only "source", then destinations were ignored. Now "destination" all or none is enforced.
226
254
  * Breaking Changes:
227
- * using `aoc files` or node gen4 operations (`browse`, `delete`) on a link will follow the link only if path ends with /
228
- * `shares`: command `repository` is changed to `files` for consistency with aoc and upcoming faspex5, but is still available as alias
229
- * `aoc`: better handling of shared links
230
- * **global**: option `value` is deprecated. Use positional parameter for creation data and option `query` for list/delete operations.
231
- * `config`: remove deprecated command: `export_to_cli`
232
- * `config`: removed all legacy preset command, newer command `preset` shall be used now.
233
- * `config`: SDK is now installed in $HOME/.aspera/sdk instead of $HOME/.aspera/ascli/sdk
234
- * `aoc`, `node`: Simplification: gen4 operations: show modify permission thumbnail are now directly under node gen 4 command. Command `file` is suppressed. Option `path` is suppressed. The default expected argument is a path. To provide a file id, use selector syntax: %id:_file_id_
235
- * `node`: option `token_type` is removed, as starting with HSTS 4.3 basic token is only allowed with access keys, so use gen4 operations: `acc do self`
255
+ * Using `aoc files` or node gen4 operations (`browse`, `delete`) on a link will follow the link only if path ends with /
256
+ * `shares`: Command `repository` is changed to `files` for consistency with aoc and upcoming faspex5, but is still available as alias
257
+ * `aoc`: Better handling of shared links
258
+ * **global**: Option `value` is deprecated. Use positional parameter for creation data and option `query` for list/delete operations.
259
+ * `config`: Remove deprecated command: `export_to_cli`
260
+ * `config`: Removed all legacy preset command, newer command `preset` shall be used now.
261
+ * `config`: SDK is now installed in `$HOME/.aspera/sdk` instead of `$HOME/.aspera/ascli/sdk`
262
+ * `aoc`, `node`: Simplification: gen4 operations: show modify permission thumbnail are now directly under node gen 4 command. Command `file` is suppressed. Option `path` is suppressed. The default expected argument is a path. To provide a file ID, use selector syntax: `%id:_file_id_`
263
+ * `node`: Option `token_type` is removed, as starting with HSTS 4.3 basic token is only allowed with access keys, so use gen4 operations: `acc do self`
236
264
 
237
265
  * 4.13.0 2023-06-29
238
266
 
239
267
  * New Features:
240
- * `preview`: option `reencode_ffmpeg` allows overriding all re-encoding options
241
- * `faspex5`: package delete (#107)
242
- * `faspex5`: package recv for inboxes and regular users (#108)
243
- * `faspex5`: smtp management
244
- * `faspex5`: use public link for authorization of package download, using option `link`
245
- * `faspex5`: list content of package, and allow partial download of package
246
- * `faspex5`: list packages support multiple pages and items limitations (`max` and `pmax`)
247
- * `aoc`: files operations with workspace-less user (#109)
248
- * `node`: async with gen3 token (#110)
249
- * `node`: display of preview of file in terminal for access keys
268
+ * `preview`: Option `reencode_ffmpeg` allows overriding all re-encoding options
269
+ * `faspex5`: `package delete` (#107)
270
+ * `faspex5`: `package recv` for inboxes and regular users (#108)
271
+ * `faspex5`: SMTP management
272
+ * `faspex5`: Use public link for authorization of package download, using option `link`
273
+ * `faspex5`: List content of package, and allow partial download of package
274
+ * `faspex5`: List packages support multiple pages and items limitations (`max` and `pmax`)
275
+ * `aoc`: Files operations with workspace-less user (#109)
276
+ * `node`: `async` with gen3 token (#110)
277
+ * `node`: Display of preview of file in terminal for access keys
250
278
  * Issues Fixed:
251
- * `cos`: do not use refresh token when not supported
279
+ * `cos`: Do not use refresh token when not supported
252
280
  * **container**: SDK installed in other folder than `ascli` (#106)
253
281
  * Breaking Changes:
254
- * option `transfer_info` is now cumulative, setting several times merge values
255
- * change(deprecation): Removed support of Ruby 2.4 and 2.5 : too old, no security update since a long time. If you need older ruby version use older gem version.
282
+ * Option `transfer_info` is now cumulative, setting several times merge values
283
+ * Change(deprecation): Removed support of Ruby 2.4 and 2.5 : Too old, no security update since a long time. If you need older ruby version use older gem version.
256
284
 
257
285
  * 4.12.0 2023-03-20
258
286
 
259
287
  * New Features:
260
- * **container**: build image from official gem version, possibility to deploy beta as well
288
+ * **container**: Build image from official gem version, possibility to deploy beta as well
261
289
  * **global**: `delete` operation supports option `value` for deletion parameters
262
- * `aoc`: command `aoc packages recv` accepts option `query` to specify a shared inbox
290
+ * `aoc`: Command `aoc packages recv` accepts option `query` to specify a shared inbox
263
291
  * `faspex`: (v4) user delete accepts option `value` with value `{"destroy":true}` to delete users permanently
264
- * `faspex`: (v4) gateway to faspex 5 for package send
265
- * `faspex5`: possibility to change email templates
266
- * `faspex5`: shared folder list and browse
267
- * `faspex5`: emulate faspex 4 postprocessing, plugin: `faspex5` command: `postprocessing`
268
- * `faspex5`: send package from remote source
269
- * `shares`: option `type` for command `shares admin user`
270
- * `shares`: full support for shares admin operations
292
+ * `faspex`: (v4) gateway to Faspex 5 for package send
293
+ * `faspex5`: Possibility to change email templates
294
+ * `faspex5`: Shared folder list and browse
295
+ * `faspex5`: Emulate Faspex 4 post-processing, plugin: `faspex5` command: `postprocessing`
296
+ * `faspex5`: Send package from remote source
297
+ * `shares`: Option `type` for command `shares admin user`
298
+ * `shares`: Full support for shares admin operations
271
299
  * Breaking Changes:
272
- * `shares`: command `shares admin user saml_import` replaced with `shares admin user import --type=saml`
273
- * `shares`: command `shares admin user ldap_import` replaced with `shares admin user add --type=ldap`
274
- * `shares`: command `app_authorizations` now has sub commands `show` and `modify`
275
- * `shares`: similar changes for `shares admin share user show`
276
- * option `ascp_opts` is removed, and replaced with `transfer_info` parameter `ascp_args`
300
+ * `shares`: Command `shares admin user saml_import` replaced with `shares admin user import --type=saml`
301
+ * `shares`: Command `shares admin user ldap_import` replaced with `shares admin user add --type=ldap`
302
+ * `shares`: Command `app_authorizations` now has sub commands `show` and `modify`
303
+ * `shares`: Similar changes for `shares admin share user show`
304
+ * Option `ascp_opts` is removed, and replaced with `transfer_info` parameter `ascp_args`
277
305
 
278
306
  * 4.11.0 2023-01-26
279
307
 
280
308
  * New Features:
281
- * **global**: `vault`: secret finder, migration from config file
282
- * **global**: allow removal of transfer spec parameter by setting value to `null`
283
- * **global**: option `ascp_opts` allows to provide native `ascp` options on command line
284
- * `node`, `server`: command `sync` added to `node` (gen4) and `server` plugins, also available in `aoc`
309
+ * **global**: `vault`: Secret finder, migration from config file
310
+ * **global**: Allow removal of transfer spec parameter by setting value to `null`
311
+ * **global**: Option `ascp_opts` allows providing native `ascp` options on command line
312
+ * `node`, `server`: Command `sync` added to `node` (gen4) and `server` plugins, also available in `aoc`
285
313
  * Issues Fixed:
286
- * **global**: security: no shell interpolation
287
- * **global**: agent `node`: when WSS is used: no localhost (certificate)
314
+ * **global**: Security: no shell interpolation
315
+ * **global**: Agent `node`: when WSS is used: no localhost (certificate)
288
316
  * `aoc`: #99 `file download` for single shared folder
289
- * `faspex5`: change of API in faspex 5 for send package (paths is mandatory for any type of transfer now)
290
- * **global**: Oauth web authentication was broken, fixed now
317
+ * `faspex5`: Change of API in Faspex 5 for send package (paths is mandatory for any type of transfer now)
318
+ * **global**: OAuth web authentication was broken, fixed now
291
319
  * Breaking Changes:
292
- * **container**: image has entry point
320
+ * **container**: Image has entry point
293
321
  * `aoc`: `admin res node` commands `v3` and `v4` replaced with `do` and command `v3` moved inside `do`
294
- * renamed options for `sync`
295
- * node gen4 operations are moved from aoc plugin to node plugin but made available where gen4 is used
296
- * if wss is enabled on server, use wss
297
- * lots of cleanup and refactoring
322
+ * Renamed options for `sync`
323
+ * Node gen4 operations are moved from aoc plugin to node plugin but made available where gen4 is used
324
+ * If wss is enabled on server, use wss
325
+ * Lots of cleanup and refactoring
298
326
 
299
327
  * 4.10.0 2022-12-02
300
328
 
301
329
  * New Features:
302
- * httpgw transfer agent: support api v2, support transfer through http proxy, including proxy password
303
- * `faspex5`: get bearer token
330
+ * `httpgw`: Transfer agent support API v2, support transfer through HTTP proxy, including proxy password
331
+ * `faspex5`: Get bearer token
304
332
  * Issues Fixed:
305
- * **container**: container version
333
+ * **container**: Container version
306
334
  * Breaking Changes:
307
- * `config`: option `secrets` is renamed to `vault`
335
+ * `config`: Option `secrets` is renamed to `vault`
308
336
 
309
337
  * 4.9.0 2022-09-15
310
338
 
311
339
  * New Features:
312
- * `shares`: import of SAML users and LDAP users
340
+ * `shares`: Import of SAML users and LDAP users
313
341
  * M1 apple silicon support SDK install (uses x86 ascp)
314
- * support bulk operation more globally (create/delete), not all ops , though
315
- * added missing transfer spec parameters, e.g. `src_base`, `password`
316
- * improved documentation on faspex and aoc package send
342
+ * Support bulk operation more globally (create/delete), not all ops , though
343
+ * Added missing transfer spec parameters, e.g. `src_base`, `password`
344
+ * Improved documentation on faspex and aoc package send
317
345
  * Issues Fixed:
318
346
  * `node do` command fixed
319
- * improved secret hiding from logs
347
+ * Improved secret hiding from logs
320
348
  * Breaking Changes:
321
- * removed rarely commands `nodeadmin`, `configuration`, `userdata`, `ctl` from plugin `server`
349
+ * Removed rarely commands `nodeadmin`, `configuration`, `userdata`, `ctl` from plugin `server`
322
350
  as well as option `cmd_prefix`
323
351
  * `ascli` runs as user `cliuser` instead of `root` in container
324
- * default access right for config folder is now user only, including private keys
352
+ * Default access right for config folder is now user only, including private keys
325
353
 
326
354
  * 4.8.0 2022-06-16
327
355
 
328
356
  * New Features:
329
357
  * #76 add resource `group_membership` in `aoc`
330
- * add resource `metadata_profile` in `faspex5`
331
- * add command `user profile` in `faspex5`
332
- * add config wizard for `faspex5`
358
+ * Add resource `metadata_profile` in `faspex5`
359
+ * Add command `user profile` in `faspex5`
360
+ * Add config wizard for `faspex5`
333
361
  * #75 gem is signed
334
362
  * Breaking Changes:
335
- * removed dependency on gem `grpc` which is used only for the `trsdk` transfer agent. Users can install the gem manually if needed.
336
- * hash vault keys are string instead of symbol
337
- * cleanup with rubocop, all strings are immutable now by default, list constants are frozen
338
- * removed Hash.dig implementation because it is by default in Ruby >= 2.3
339
- * default is now to hide secrets on command output. Set option `show_secrets` to reveal secrets.
340
- * option `insecure` displays a warning
363
+ * Removed dependency on gem `grpc` which is used only for the `trsdk` transfer agent. Users can install the gem manually if needed.
364
+ * Hash vault keys are string instead of symbol
365
+ * Cleanup with rubocop, all strings are immutable now by default, list constants are frozen
366
+ * Removed Hash.dig implementation because it is by default in Ruby >= 2.3
367
+ * Default is now to hide secrets on command output. Set option `show_secrets` to reveal secrets.
368
+ * Option `insecure` displays a warning
341
369
 
342
370
  * 4.7.0 2022-03-23
343
371
 
344
372
  * New Features:
345
- * option to specify font used to generate image of text file in `preview`
373
+ * Option to specify font used to generate image of text file in `preview`
346
374
  * #66 improvement for content protection (support standard transfer spec options for direct agent)
347
- * option `fpac` is now applicable to all ruby based HTTP connections, i.e. API calls
348
- * option `show_secrets` to reveal secrets in command output
349
- * added and updated commands for Faspex 5
350
- * option `cache_tokens`
375
+ * Option `fpac` is now applicable to all ruby based HTTP connections, i.e. API calls
376
+ * Option `show_secrets` to reveal secrets in command output
377
+ * Added and updated commands for Faspex 5
378
+ * Option `cache_tokens`
351
379
  * Faspex4 dropbox packages can now be received by id
352
380
  * Issues Fixed:
353
381
  * After AoC version update, wizard did not detect AoC properly
354
382
  * Breaking Changes:
355
- * command `conf gem path` replaces `conf gem_path`
356
- * option `fpac` expects a value instead of URL
357
- * option `cipher` in transfer spec must have hyphen
358
- * renamed option `log_passwords` to `log_secrets`
359
- * removed plugin `shares2` as products is now EOL
383
+ * Command `conf gem path` replaces `conf gem_path`
384
+ * Option `fpac` expects a value instead of URL
385
+ * Option `cipher` in transfer spec must have hyphen
386
+ * Renamed option `log_passwords` to `log_secrets`
387
+ * Removed plugin `shares2` as products is now EOL
360
388
 
361
389
  * 4.6.0 2022-02-04
362
390
 
363
391
  * New Features:
364
- * command `conf plugin create`
365
- * global option `plugin_folder`
366
- * global option `transpose_single`
367
- * simplified metadata passing for shared inbox package creation in AoC
392
+ * Command `conf plugin create`
393
+ * Global option `plugin_folder`
394
+ * Global option `transpose_single`
395
+ * Simplified metadata passing for shared inbox package creation in AoC
368
396
  * Issues Fixed:
369
397
  * #60 ascli executable was not installed by default in 4.5.0
370
- * add password hiding case in logs
398
+ * Add password hiding case in logs
371
399
  * Breaking Changes:
372
- * command `aoc packages shared_inboxes list` replaces `aoc user shared_inboxes`
373
- * command `aoc user profile` replaces `aoc user info`
374
- * command `aoc user workspaces list` replaces `aoc user workspaces`
375
- * command `aoc user workspaces current` replaces `aoc workspace`
376
- * command `conf plugin list` replaces `conf plugins`
377
- * command `conf connect` simplified
400
+ * Command `aoc packages shared_inboxes list` replaces `aoc user shared_inboxes`
401
+ * Command `aoc user profile` replaces `aoc user info`
402
+ * Command `aoc user workspaces list` replaces `aoc user workspaces`
403
+ * Command `aoc user workspaces current` replaces `aoc workspace`
404
+ * Command `conf plugin list` replaces `conf plugins`
405
+ * Command `conf connect` simplified
378
406
 
379
407
  * 4.5.0 2021-12-27
380
408
 
381
409
  * New Features:
382
- * support transfer agent: [Transfer SDK](README.md#agt_trsdk)
383
- * support [http socket options](README.md#http_options)
384
- * logs hide passwords and secrets, option `log_passwords` to enable logging secrets
410
+ * Support transfer agent: [Transfer SDK](README.md#agt_trsdk)
411
+ * Support [http socket options](README.md#http_options)
412
+ * Logs hide passwords and secrets, option `log_passwords` to enable logging secrets
385
413
  * `config vault` supports encrypted passwords, also macos keychain
386
414
  * `config preset` command for consistency with id
387
- * identifier can be provided using either option `id` or directly after the command, e.g. `delete 123` is the same as `delete --id=123`
415
+ * Identifier can be provided using either option `id` or directly after the command, e.g. `delete 123` is the same as `delete --id=123`
388
416
  * Issues Fixed:
389
- * various smaller fixes and renaming of some internal classes (transfer agents and few other)
417
+ * Various smaller fixes and renaming of some internal classes (transfer agents and few other)
390
418
  * Breaking Changes:
391
- * when using wss, use [ruby's CA certs](README.md#certificates)
392
- * unexpected parameter makes exit code not zero
393
- * options `id` and `name` cannot be specified at the same time anymore, use [positional identifier or name selection](README.md#res_select)
419
+ * When using wss, use [ruby's CA certs](README.md#certificates)
420
+ * Unexpected parameter makes exit code not zero
421
+ * Options `id` and `name` cannot be specified at the same time anymore, use [positional identifier or name selection](README.md#res_select)
394
422
  * `aoc admin res node` does not take workspace main node as default node if no `id` specified.
395
423
  * : `orchestrator workflow status` requires id, and supports special id `ALL`
396
424
 
@@ -403,82 +431,82 @@
403
431
  * `node` plugin accepts bearer token and access key as credential
404
432
  * `node` option `token_type` allows using basic token in addition to aspera type.
405
433
  * Breaking Changes:
406
- * `server`: option `username` not mandatory anymore: xfer user is by default. If transfer spec token is provided, password or keys are optional, and bypass keys are used by default.
407
- * resource `apps_new` of `aoc` replaced with `application` (more clear)
434
+ * `server`: Option `username` not mandatory anymore: `xfer` user is by default. If transfer spec token is provided, password or keys are optional, and bypass keys are used by default.
435
+ * Resource `apps_new` of `aoc` replaced with `application` (more clear)
408
436
 
409
437
  * 4.3.0 2021-10-19
410
438
 
411
439
  * New Features:
412
- * parameter `multi_incr_udp` for option `transfer_info`: control if UDP port is incremented when multi-session is used on [`direct`](README.md#agt_direct) transfer agent.
413
- * command `aoc files node_info` to get node information for a given folder in the Files application of AoC. Allows cross-org or cross-workspace transfers.
440
+ * Parameter `multi_incr_udp` for option `transfer_info`: control if UDP port is incremented when multi-session is used on [`direct`](README.md#agt_direct) transfer agent.
441
+ * Command `aoc files node_info` to get node information for a given folder in the Files application of AoC. Allows cross-org or cross-workspace transfers.
414
442
 
415
443
  * 4.2.2 2021-09-23
416
444
 
417
445
  * New Features:
418
446
  * `faspex package list` retrieves the whole list, not just first page
419
- * support web based auth to aoc and faspex 5 using HTTPS, new dependency on gem `webrick`
420
- * the error "Remote host is not who we expected" displays a special remediation message
447
+ * Support web based auth to aoc and faspex 5 using HTTPS, new dependency on gem `webrick`
448
+ * The error "Remote host is not who we expected" displays a special remediation message
421
449
  * `conf ascp spec` displays supported transfer spec
422
- * options `notif_to` and `notif_template` to send email notifications on transfer (and other events)
450
+ * Options `notif_to` and `notif_template` to send email notifications on transfer (and other events)
423
451
  * Issues Fixed:
424
- * space character in `faspe:` url are percent encoded if needed
425
- * `preview scan`: if file_id is unknown, ignore and continue scan
452
+ * Space character in `faspe:` url are percent encoded if needed
453
+ * `preview scan`: If file_id is unknown, ignore and continue scan
426
454
  * Breaking Changes:
427
- * for commands that potentially execute several transfers (`package recv --id=ALL`), if one transfer fails then ascli exits with code 1 (instead of zero=success)
428
- * option `notify` or `aoc` replaced with `notif_to` and `notif_template`
455
+ * For commands that potentially execute several transfers (`package recv --id=ALL`), if one transfer fails then ascli exits with code 1 (instead of zero=success)
456
+ * Option `notify` or `aoc` replaced with `notif_to` and `notif_template`
429
457
 
430
458
  * 4.2.1 2021-09-01
431
459
 
432
460
  * New Features:
433
- * command `faspex package recv` supports link of type: `faspe:`
434
- * command `faspex package recv` supports option `recipient` to specify dropbox with leading `*`
461
+ * Command `faspex package recv` supports link of type: `faspe:`
462
+ * Command `faspex package recv` supports option `recipient` to specify dropbox with leading `*`
435
463
 
436
464
  * 4.2.0 2021-08-24
437
465
 
438
466
  * New Features:
439
- * command `aoc remind` to receive organization membership by email
440
- * in `preview` option `value` to filter out on file name
467
+ * Command `aoc remind` to receive organization membership by email
468
+ * In `preview` option `value` to filter out on file name
441
469
  * `initdemo` to initialize for demo server
442
470
  * [`direct`](README.md#agt_direct) transfer agent options: `spawn_timeout_sec` and `spawn_delay_sec`
443
471
  * Issues Fixed:
444
- * on Windows `conf ascp use` expects ascp.exe
472
+ * On Windows `conf ascp use` expects ascp.exe
445
473
  * (break) multi_session_threshold is Integer, not String
446
474
  * `conf ascp install` renames sdk folder if it already exists (leftover shared lib may make fail)
447
- * removed replace_illegal_chars from default aspera.conf causing "Error creating illegal char conversion table"
475
+ * Removed `replace_illegal_chars` from default `aspera.conf` causing "Error creating illegal char conversion table"
448
476
  * Breaking Changes:
449
477
  * `aoc apiinfo` is removed, use `aoc servers` to provide the list of cloud systems
450
- * parameters for resume in `transfer-info` for [`direct`](README.md#agt_direct) are now in sub-key `"resume"`
478
+ * Parameters for resume in `transfer-info` for [`direct`](README.md#agt_direct) are now in sub-key `"resume"`
451
479
 
452
480
  * 4.1.0 2021-06-23
453
481
 
454
482
  * New Features:
455
- * update documentation with regard to offline and docker installation
456
- * renamed command `nagios_check` to `health`
457
- * agent `http_gw` now supports upload
458
- * added option `sdk_url` to install SDK from local file for offline install
459
- * check new gem version periodically
460
- * the --fields= option, support -_field_name_ to remove a field from default fields
483
+ * Update documentation with regard to offline and docker installation
484
+ * Renamed command `nagios_check` to `health`
485
+ * Agent `http_gw` now supports upload
486
+ * Added option `sdk_url` to install SDK from local file for offline install
487
+ * Check new gem version periodically
488
+ * The --fields= option, support -_field_name_ to remove a field from default fields
461
489
  * Oauth tokens are discarded automatically after 30 minutes (useful for COS delegated refresh tokens)
462
490
  * `mimemagic` is now optional, needs manual install for `preview`, compatible with version 0.4.x
463
491
  * AoC a password can be provided for a public link
464
492
  * `conf doc` take an optional parameter to go to a section
465
- * initial support for Faspex 5 Beta 1
493
+ * Initial support for Faspex 5 Beta 1
466
494
  * Issues Fixed:
467
- * remove keys from transfer spec and command line when not needed
468
- * default to create_dir:true so that sending single file to a folder does not rename file if folder does not exist
495
+ * Remove keys from transfer spec and command line when not needed
496
+ * Default to `create_dir`:`true` so that sending single file to a folder does not rename file if folder does not exist
469
497
 
470
498
  * 4.0.0 2021-02-03
471
499
 
472
500
  * New Features:
473
- * now available as open source (github) with general cleanup
474
- * added possibility to install SDK: `config ascp install`
501
+ * Now available as open source (GitHub) with general cleanup
502
+ * Added possibility to install SDK: `config ascp install`
475
503
  * Breaking Changes:
476
- * changed default tool name from `mlia` to `ascli`
477
- * changed `aspera` command to `aoc`
478
- * changed gem name from `asperalm` to `aspera-cli`
479
- * changed module name from `Asperalm` to `Aspera`
480
- * removed command `folder` in `preview`, merged to `scan`
481
- * persistency files go to sub folder instead of main folder
504
+ * Changed default tool name from `mlia` to `ascli`
505
+ * Changed `aspera` command to `aoc`
506
+ * Changed gem name from `asperalm` to `aspera-cli`
507
+ * Changed module name from `Asperalm` to `Aspera`
508
+ * Removed command `folder` in `preview`, merged to `scan`
509
+ * Persistency files go to sub folder instead of main folder
482
510
 
483
511
  * 0.11.8
484
512
 
@@ -486,300 +514,300 @@
486
514
 
487
515
  * 0.11.7
488
516
 
489
- * rework on rest call error handling
490
- * use option `display` with value `data` to remove out of extraneous information
491
- * fixed option `lock_port` not working
492
- * generate special icon if preview failed
493
- * possibility to choose transfer progress bar type with option `progress`
517
+ * Rework on rest call error handling
518
+ * Use option `display` with value `data` to remove out of extraneous information
519
+ * Fixed option `lock_port` not working
520
+ * Generate special icon if preview failed
521
+ * Possibility to choose transfer progress bar type with option `progress`
494
522
  * AoC package creation now output package id
495
523
 
496
524
  * 0.11.6
497
525
 
498
- * `orchestrator`: added more choice in auth type
499
- * `preview`: cleanup in generator (removed and renamed parameters)
500
- * `preview`: better documentation
501
- * `preview`: animated thumbnails for video (option: `video_png_conv=animated`)
502
- * `preview`: new event trigger: `trevents` (`events` seems broken)
503
- * `preview`: unique tmp folder to avoid clash of multiple instances
504
- * repo: added template for secrets used for testing
526
+ * `orchestrator`: Added more choice in auth type
527
+ * `preview`: Cleanup in generator (removed and renamed parameters)
528
+ * `preview`: Better documentation
529
+ * `preview`: Animated thumbnails for video (option: `video_png_conv=animated`)
530
+ * `preview`: New event trigger: `trevents` (`events` seems broken)
531
+ * `preview`: Unique tmp folder to avoid clash of multiple instances
532
+ * Repo: Added template for secrets used for testing
505
533
 
506
534
  * 0.11.5
507
535
 
508
- * added option `default_ports` for AoC (see manual)
509
- * allow bulk delete in `aspera files` with option `bulk=yes`
510
- * fix getting connect versions
511
- * added section for Aix
512
- * support all ciphers for [`direct`](README.md#agt_direct) agent (including gcm, etc..)
513
- * added transfer spec param `apply_local_docroot` for [`direct`](README.md#agt_direct)
536
+ * Added option `default_ports` for AoC (see manual)
537
+ * Allow bulk delete in `aspera files` with option `bulk=yes`
538
+ * Fix getting connect versions
539
+ * Added section for Aix
540
+ * Support all ciphers for [`direct`](README.md#agt_direct) agent (including gcm, etc..)
541
+ * Added transfer spec param `apply_local_docroot` for [`direct`](README.md#agt_direct)
514
542
 
515
543
  * 0.11.4
516
544
 
517
- * possibility to give shared inbox name when sending a package (else use id and type)
545
+ * Possibility to give shared inbox name when sending a package (else use id and type)
518
546
 
519
547
  * 0.11.3
520
548
 
521
- * minor fixes on multi-session: avoid exception on progress bar
549
+ * Minor fixes on multi-session: Avoid exception on progress bar
522
550
 
523
551
  * 0.11.2
524
552
 
525
- * fixes on multi-session: progress bat and transfer spec param for "direct"
553
+ * Fixes on multi-session: Progress bat and transfer spec param for "direct"
526
554
 
527
555
  * 0.11.1
528
556
 
529
- * enhanced short_link creation commands (see examples)
557
+ * Enhanced short_link creation commands (see examples)
530
558
 
531
559
  * 0.11
532
560
 
533
- * add transfer spec option (agent `direct` only) to provide file list directly to ascp: `EX_file_list`.
561
+ * Add transfer spec option (agent `direct` only) to provide file list directly to ascp: `EX_file_list`.
534
562
 
535
563
  * 0.10.18
536
564
 
537
- * new option in. `server` : `ssh_options`
565
+ * New option in. `server` : `ssh_options`
538
566
 
539
567
  * 0.10.17
540
568
 
541
- * fixed problem on `server` for option `ssh_keys`, now accepts both single value and list.
542
- * new modifier: `@list:<separator>val1<separator>...`
569
+ * Fixed problem on `server` for option `ssh_keys`, now accepts both single value and list.
570
+ * New modifier: `@list:<separator>val1<separator>...`
543
571
 
544
572
  * 0.10.16
545
573
 
546
- * added list of shared inboxes in workspace (or global), use `--query=@json:'{}'`
574
+ * Added list of shared inboxes in workspace (or global), use `--query=@json:'{}'`
547
575
 
548
576
  * 0.10.15
549
577
 
550
- * in case of command line error, display the error cause first, and non-parsed argument second
578
+ * In case of command line error, display the error cause first, and non-parsed argument second
551
579
  * AoC : Activity / Analytics
552
580
 
553
581
  * 0.10.14
554
582
 
555
- * added missing bss plugin
583
+ * Added missing bss plugin
556
584
 
557
585
  * 0.10.13
558
586
 
559
- * added Faspex5 (use option `value` to give API arguments)
587
+ * Added Faspex5 (use option `value` to give API arguments)
560
588
 
561
589
  * 0.10.12
562
590
 
563
- * added support for AoC node registration keys
564
- * replaced option : `local_resume` with `transfer_info` for agent [`direct`](README.md#agt_direct)
591
+ * Added support for AoC node registration keys
592
+ * Replaced option : `local_resume` with `transfer_info` for agent [`direct`](README.md#agt_direct)
565
593
  * Transfer agent is no more a Singleton instance, but only one is used in CLI
566
- * `@incps` : new extended value modifier
567
- * ATS: no more provides access keys secrets: now user must provide it
568
- * begin work on "aoc" transfer agent
594
+ * `@incps` : New extended value modifier
595
+ * ATS: No more provides access keys secrets: now user must provide it
596
+ * Begin work on "aoc" transfer agent
569
597
 
570
598
  * 0.10.11
571
599
 
572
- * minor refactor and fixes
600
+ * Minor refactor and fixes
573
601
 
574
602
  * 0.10.10
575
603
 
576
- * fix on documentation
604
+ * Fix on documentation
577
605
 
578
606
  * 0.10.9.1
579
607
 
580
- * add total number of items for AoC resource list
581
- * better gem version dependency (and fixes to support Ruby 2.0.0)
582
- * removed aoc search_nodes
608
+ * Add total number of items for AoC resource list
609
+ * Better gem version dependency (and fixes to support Ruby 2.0.0)
610
+ * Removed aoc search_nodes
583
611
 
584
612
  * 0.10.8
585
613
 
586
- * removed option: `fasp_proxy`, use pseudo transfer spec parameter: `EX_fasp_proxy_url`
587
- * removed option: `http_proxy`, use pseudo transfer spec parameter: `EX_http_proxy_url`
588
- * several other changes..
614
+ * Removed option: `fasp_proxy`, use pseudo transfer spec parameter: `EX_fasp_proxy_url`
615
+ * Removed option: `http_proxy`, use pseudo transfer spec parameter: `EX_http_proxy_url`
616
+ * Several other changes..
589
617
 
590
618
  * 0.10.7
591
619
 
592
- * fix: ascli fails when username cannot be computed on Linux.
620
+ * Fix: `ascli` fails when username cannot be computed on Linux.
593
621
 
594
622
  * 0.10.6
595
623
 
596
- * FaspManager: transfer spec `authentication` no more needed for local transfer to use Aspera public keys. public keys will be used if there is a token and no key or password is provided.
597
- * gem version requirements made more open
624
+ * FaspManager: Transfer spec `authentication` no more needed for local transfer to use Aspera public keys. public keys will be used if there is a token and no key or password is provided.
625
+ * Gem version requirements made more open
598
626
 
599
627
  * 0.10.5
600
628
 
601
- * fix faspex package receive command not working
629
+ * Fix faspex package receive command not working
602
630
 
603
631
  * 0.10.4
604
632
 
605
- * new options for AoC : `secrets`
633
+ * New options for AoC : `secrets`
606
634
  * `ACLI-533` temp file list folder to use file lists is set by default, and used by `asession`
607
635
 
608
636
  * 0.10.3
609
637
 
610
- * included user name in oauth bearer token cache for AoC when JWT is used.
638
+ * Included user name in oauth bearer token cache for AoC when JWT is used.
611
639
 
612
640
  * 0.10.2
613
641
 
614
- * updated `search_nodes` to be more generic, so it can search not only on access key, but also other queries.
615
- * added doc for "cargo" like actions
616
- * added doc for multi-session
642
+ * Updated `search_nodes` to be more generic, so it can search not only on access key, but also other queries.
643
+ * Added doc for "cargo" like actions
644
+ * Added doc for multi-session
617
645
 
618
646
  * 0.10.1
619
647
 
620
648
  * AoC and node v4 "browse" works now on non-folder items: file, link
621
- * initial support for AoC automation (do not use yet)
649
+ * Initial support for AoC automation (do not use yet)
622
650
 
623
651
  * 0.10
624
652
 
625
- * support for transfer using IBM Cloud Object Storage
626
- * improved `find` action using arbitrary expressions
653
+ * Support for transfer using IBM Cloud Object Storage
654
+ * Improved `find` action using arbitrary expressions
627
655
 
628
656
  * 0.9.36
629
657
 
630
- * added option to specify file pair lists
658
+ * Added option to specify file pair lists
631
659
 
632
660
  * 0.9.35
633
661
 
634
- * updated plugin `preview` , changed parameter names, added documentation
635
- * fix in `ats` plugin : instance id needed in request header
662
+ * `preview`: Changed parameter names, added documentation
663
+ * `ats`: Fix: instance ID needed in request header
636
664
 
637
665
  * 0.9.34
638
666
 
639
- * parser "@preset" can be used again in option "transfer_info"
640
- * some documentation re-organizing
667
+ * Parser "@preset" can be used again in option "transfer_info"
668
+ * Some documentation re-organizing
641
669
 
642
670
  * 0.9.33
643
671
 
644
- * new command to display basic token of node
645
- * new command to display bearer token of node in AoC
646
- * the --fields= option, support +_field_name_ to add a field to default fields
647
- * many small changes
672
+ * New command to display basic token of node
673
+ * New command to display bearer token of node in AoC
674
+ * The --fields= option, support +_field_name_ to add a field to default fields
675
+ * Many small changes
648
676
 
649
677
  * 0.9.32
650
678
 
651
- * all Faspex public links are now supported
652
- * removed faspex operation `recv_publink`
653
- * replaced with option `link` (consistent with AoC)
679
+ * All Faspex public links are now supported
680
+ * Removed faspex operation `recv_publink`
681
+ * Replaced with option `link` (consistent with AoC)
654
682
 
655
683
  * 0.9.31
656
684
 
657
- * added more support for public link: receive and send package, to user or dropbox and files view.
658
- * delete expired file lists
659
- * changed text table gem from text-table to terminal-table because it supports multiline values
685
+ * Added more support for public link: receive and send package, to user or dropbox and files view.
686
+ * Delete expired file lists
687
+ * Changed text table gem from text-table to terminal-table because it supports multiline values
660
688
 
661
689
  * 0.9.27
662
690
 
663
- * basic email support with SMTP
664
- * basic proxy auto config support
691
+ * Basic email support with SMTP
692
+ * Basic proxy auto config support
665
693
 
666
694
  * 0.9.26
667
695
 
668
- * table display with --fields=ALL now includes all column names from all lines, not only first one
669
- * unprocessed argument shows error even if there is an error beforehand
696
+ * Table display with --fields=ALL now includes all column names from all lines, not only first one
697
+ * Unprocessed argument shows error even if there is an error beforehand
670
698
 
671
699
  * 0.9.25
672
700
 
673
- * the option `value` of command `find`, to filter on name, is not optional
701
+ * The option `value` of command `find`, to filter on name, is not optional
674
702
  * `find` now also reports all types (file, folder, link)
675
703
  * `find` now is able to report all fields (type, size, etc...)
676
704
 
677
705
  * 0.9.24
678
706
 
679
- * fix bug where AoC node to node transfer did not work
680
- * fix bug on error if ED25519 private key is defined in .ssh
707
+ * Fix bug where AoC node to node transfer did not work
708
+ * Fix bug on error if ED25519 private key is defined in .ssh
681
709
 
682
710
  * 0.9.23
683
711
 
684
- * defined REST error handlers, more error conditions detected
685
- * commands to select specific ascp location
712
+ * Defined REST error handlers, more error conditions detected
713
+ * Commands to select specific ascp location
686
714
 
687
715
  * 0.9.21
688
716
 
689
- * supports simplified wizard using global client
690
- * only ascp binary is required, other SDK (keys) files are now generated
717
+ * Supports simplified wizard using global client
718
+ * Only ascp binary is required, other SDK (keys) files are now generated
691
719
 
692
720
  * 0.9.20
693
721
 
694
- * improved wizard (prepare for AoC global client id)
695
- * preview generator: added option : --skip-format=&lt;png,mp4&gt;
696
- * removed outdated pictures from this doc
722
+ * Improved wizard (prepare for AoC global client id)
723
+ * Preview generator: Added option : --skip-format=&lt;png,mp4&gt;
724
+ * Removed outdated pictures from this doc
697
725
 
698
726
  * 0.9.19
699
727
 
700
- * added command aspera bearer --scope=xx
728
+ * Added command aspera bearer --scope=xx
701
729
 
702
730
  * 0.9.18
703
731
 
704
- * enhanced aspera admin events to support query
732
+ * Enhanced aspera admin events to support query
705
733
 
706
734
  * 0.9.16
707
735
 
708
736
  * AoC transfers are now reported in activity app
709
- * new interface for Rest class authentication (keep backward compatibility)
737
+ * New interface for Rest class authentication (keep backward compatibility)
710
738
 
711
739
  * 0.9.15
712
740
 
713
- * new feature: "find" command in aspera files
714
- * sample code for transfer API
741
+ * New feature: "find" command in aspera files
742
+ * Sample code for transfer API
715
743
 
716
744
  * 0.9.12
717
745
 
718
- * add nagios commands
719
- * support of ATS for IBM Cloud, removed old version based on aspera id
746
+ * Add nagios commands
747
+ * Support of ATS for IBM Cloud, removed old version based on aspera id
720
748
 
721
749
  * 0.9.11
722
750
 
723
- * change(break): @stdin is now @stdin:
724
- * support of ATS for IBM Cloud, removed old version based on aspera id
751
+ * Change(break): @stdin is now @stdin:
752
+ * Support of ATS for IBM Cloud, removed old version based on aspera id
725
753
 
726
754
  * 0.9.10
727
755
 
728
- * change(break): parameter transfer-node becomes more generic: transfer-info
729
- * Display SaaS storage usage with command: aspera admin res node --id=nn info
730
- * cleaner way of specifying source file list for transfers
731
- * change(break): replaced download_mode option with http_download action
756
+ * Change(break): Parameter transfer-node becomes more generic: `transfer-info`
757
+ * Display SaaS storage usage with command: `aspera admin res node --id=nn info`
758
+ * Cleaner way of specifying source file list for transfers
759
+ * Change(break): Replaced download_mode option with http_download action
732
760
 
733
761
  * 0.9.9
734
762
 
735
- * change(break): "aspera package send" parameter deprecated, use the --value option instead with "recipients" value. See example.
763
+ * Change(break): "aspera package send" parameter deprecated, use the --value option instead with "recipients" value. See example.
736
764
  * Now supports "cargo" for Aspera on Cloud (automatic package download)
737
765
 
738
766
  * 0.9.8
739
767
 
740
- * Faspex: use option once_only set to yes to enable cargo like function. id=NEW deprecated.
741
- * AoC: share to share transfer with command "transfer"
768
+ * Faspex: Use option once_only set to yes to enable cargo like function. id=NEW deprecated.
769
+ * AoC: Share to share transfer with command "transfer"
742
770
 
743
771
  * 0.9.7
744
772
 
745
- * homogeneous transfer spec for `node` and [`direct`](README.md#agt_direct) transfer agents
746
- * preview persistency goes to unique file by default
747
- * catch mxf extension in preview as video
748
- * Faspex: possibility to download all packages by specifying id=ALL
749
- * Faspex: to come: cargo-like function to download only new packages with id=NEW
773
+ * Homogeneous transfer spec for `node` and [`direct`](README.md#agt_direct) transfer agents
774
+ * Preview persistency goes to unique file by default
775
+ * Catch mxf extension in preview as video
776
+ * Faspex: Possibility to download all packages by specifying id=ALL
777
+ * Faspex: To come: Cargo-like function to download only new packages with id=NEW
750
778
 
751
779
  * 0.9.6
752
780
 
753
- * change(break): `@param:`is now `@preset:` and is generic
754
- * AoC: added command to display current workspace information
781
+ * Change(break): `@param:`is now `@preset:` and is generic
782
+ * AoC: Added command to display current workspace information
755
783
 
756
784
  * 0.9.5
757
785
 
758
- * new parameter: new_user_option used to choose between public_link and invite of external users.
759
- * fixed bug in wizard, and wizard uses now product detection
786
+ * New parameter: `new_user_option` used to choose between public_link and invite of external users.
787
+ * Fixed bug in wizard, and wizard uses now product detection
760
788
 
761
789
  * 0.9.4
762
790
 
763
- * change(break): onCloud file list follow --source convention as well (plus specific case for download when first path is source folder, and other are source file names).
791
+ * Change(break): `oncloud file list` follow --source convention as well (plus specific case for download when first path is source folder, and other are source file names).
764
792
  * AoC Package send supports external users
765
- * new command to export AoC config to Aspera CLI config
793
+ * New command to export AoC config to Aspera CLI config
766
794
 
767
795
  * 0.9.3
768
796
 
769
797
  * REST error message show host and code
770
- * option for quiet display
771
- * modified transfer interface and allow token re-generation on error
772
- * async add admin command
773
- * async add db parameters
774
- * change(break): new option "sources" to specify files to transfer
798
+ * Option for quiet display
799
+ * Modified transfer interface and allow token re-generation on error
800
+ * `async` add `admin` command
801
+ * `async` add db parameters
802
+ * Change(break): New option "sources" to specify files to transfer
775
803
 
776
804
  * 0.9.2
777
805
 
778
- * change(break): changed AoC package creation to match API, see AoC section
806
+ * Change(break): Changed AoC package creation to match API, see AoC section
779
807
 
780
808
  * 0.9.1
781
809
 
782
- * change(break): changed faspex package creation to match API, see Faspex section
810
+ * Change(break): Changed faspex package creation to match API, see Faspex section
783
811
 
784
812
  * 0.9
785
813
 
@@ -788,31 +816,31 @@
788
816
 
789
817
  * 0.7.6
790
818
 
791
- * add "sync" plugin
819
+ * Add `sync` plugin
792
820
 
793
821
  * 0.7
794
822
 
795
- * change(break): AoC package recv take option if for package instead of argument.
796
- * change(break): Rest class and Oauth class changed init parameters
797
- * AoC: receive package from public link
798
- * select by col value on output
799
- * added rename (AoC, node)
823
+ * Change(break): AoC `package recv` take option if for package instead of argument.
824
+ * Change(break): Rest class and Oauth class changed init parameters
825
+ * AoC: Receive package from public link
826
+ * Select by col value on output
827
+ * Added rename (AoC, node)
800
828
 
801
829
  * 0.6.19
802
830
 
803
- * change(break): ats server list provisioned &rarr; ats cluster list
804
- * change(break): ats server list clouds &rarr; ats cluster clouds
805
- * change(break): ats server list instance --cloud=x --region=y &rarr; ats cluster show --cloud=x --region=y
806
- * change(break): ats server id xxx &rarr; ats cluster show --id=xxx
807
- * change(break): ats subscriptions &rarr; ats credential subscriptions
808
- * change(break): ats api_key repository list &rarr; ats credential cache list
809
- * change(break): ats api_key list &rarr; ats credential list
810
- * change(break): ats access_key id xxx &rarr; ats access_key --id=xxx
831
+ * Change(break): `ats server list provisioned` &rarr; `ats cluster list`
832
+ * Change(break): `ats server list clouds` &rarr; `ats cluster clouds`
833
+ * Change(break): `ats server list instance --cloud=x --region=y` &rarr; `ats cluster show --cloud=x --region=y`
834
+ * Change(break): `ats server id xxx` &rarr; `ats cluster show --id=xxx`
835
+ * Change(break): `ats subscriptions` &rarr; `ats credential subscriptions`
836
+ * Change(break): `ats api_key repository list` &rarr; `ats credential cache list`
837
+ * Change(break): `ats api_key list` &rarr; `ats credential list`
838
+ * Change(break): `ats access_key id xxx` &rarr; `ats access_key --id=xxx`
811
839
 
812
840
  * 0.6.18
813
841
 
814
- * some commands take now --id option instead of id command.
842
+ * Some commands take now `--id` option instead of `id` command.
815
843
 
816
844
  * 0.6.15
817
845
 
818
- * change(break): "files" application renamed to "aspera" (for "Aspera on Cloud"). "repository" renamed to "files". Default is automatically reset, e.g. in config files and change key "files" to "aspera" in preset "default".
846
+ * Change(break): `files` application renamed to `aspera` (for "Aspera on Cloud"). `repository` renamed to `files`. Default is automatically reset, e.g. in config files and change key `files` to `aspera` in preset `default`.