Delete Remote Application Version CLI

This command will delete distributions of an application version from a distribution target, such as an edge node.

Parameter	Description
Command-name	version-delete-remote
Abbreviation	vdr
Command arguments:
`application-key`	The application key defined for the application.
`version`	Version of the application version to delete.
Command options:
`--city`	[Optional] Wildcard filter for site city name. Mutually exclusive with `--dist-rules`.
`--country-codes`	[Optional] Semicolon-separated(;) list of wildcard filters for site country codes. Country code doesn't expect country phone code, but codes in this format, for example, US, GB, or FR. Mutually exclusive with `--dist-rules`.
`--dist-rules`	[Optional] Path to a file, which includes the distribution rules in a JSON format. Mutually exclusive with `--site`, `--city`, and `--country-codes`.
`--dry-run`	[Default: `false`] Perform a simulation of the operation.
`--quiet`	[Default: `false`] Set to true to skip the delete confirmation message. When `$CI` is `true`, the default value is `true`.
`--site`	[Optional] Wildcard filter for site name. Mutually exclusive with `--dist-rules`.

Delete Application Version Remotely Examples

Delete Application Version Remotely Example 1

Delete the distributions of version 1.0.0 of the application named myApp from edge nodes matching the provided distribution rules defined in the specified file.

jf apptrust version-delete-remote  --dist-rules=/path/to/dist-rules.json myApp 1.0.0

Frequently Asked Questions

Common questions about deleting an application version's remote distributions.

plusFAQs

Q: How do I delete an application version's distributions from an edge node using the JFrog CLI?

A: Run jf apptrust version-delete-remote (alias vdr) with the application key and version, optionally with a distribution filter such as --dist-rules, --site, --city, or --country-codes to narrow which distributions are removed. See the delete examples.

Q: What happens if I combine --dist-rules with --site, --city, or --country-codes?

A: These options are mutually exclusive. Use --dist-rules alone with a JSON rules file, or use --site, --city, and --country-codes together without --dist-rules.

Q: Can I preview a remote delete before it runs?

A: Yes. Pass --dry-run to simulate the operation without deleting any distributions.

Q: Does version-delete-remote ask for confirmation before deleting?

A: By default yes, unless you pass --quiet, which skips the confirmation message. In CI environments where $CI is true, --quiet defaults to true.

Q: What do I need to provide before running version-delete-remote?

A: You need the application's application-key and the version to delete. You can optionally narrow the operation with a distribution filter such as --dist-rules, --site, --city, or --country-codes.