c8y(1)

πŸ“¦ version 2.56.1, in nixpkgs unstable

πŸ‘‘ c8y(1) β€” the c8y manual, but make it make sense

okay so bestie, welcome to c8y(1) πŸ’– this is the manual page for the c8y command-line tool, and today's main character is the c8y-ui-plugins-delete subcommand. it's giving "delete a UI plugin from your tenant" energy and honestly? iconic. let's get into it πŸŽ€


✨ NAME ✨

c8y-ui-plugins-delete β€” Delete UI plugin πŸ’…


πŸ¦‹ SYNOPSIS πŸ¦‹

c8y ui plugins delete [flags]

like, that's the whole vibe. command, subcommand, subcommand, and then whatever flags you feel like adding ✨


🌸 DESCRIPTION 🌸

okay so fr fr what this does: it deletes an existing UI plugin from the tenant. that's it, that's the whole thing. it's a delete command, so be normal about it β€” she does not undo 😭


πŸ”₯ OPTIONS πŸ”₯

here's the main-character flag list for the delete command itself 🫢

  • -h, --help[=false] β€” help for delete. classic, always there for you πŸ’–
  • --id="" β€” the plugin, and heads up it's required. also accepts pipeline input, so you can pipe it in like a boss πŸŽ€
  • --processingMode="" β€” the Cumulocity processing mode. yes bestie, that one 🌈

🌟 OPTIONS INHERITED FROM PARENT COMMANDS 🌟

okay this is the big one. these all come from the parent commands, meaning you get them for free whether you asked or not. no cap, here's every single one πŸ‘‘

  • --abortOnErrors=10 β€” abort the batch when you hit the specified number of errors πŸ’€
  • --allowEmptyPipe[=false] β€” don't fail when the piped input (stdin) is empty. she's tolerant like that πŸ™ˆ
  • --cache[=false] β€” enable cached responses ✨
  • --cacheBodyPaths=[] β€” cache should limit hashing to selected paths in the json body. empty means all values πŸ“
  • --cacheTTL="60s" β€” cache time-to-live (TTL) as a duration, i.e. 60s, 2m ⏳
  • -c, --compact[=false] β€” compact instead of pretty-printed output when using json output. pretty print is the default if the output is the terminal πŸ’…
  • --confirm[=false] β€” prompt for confirmation πŸ™‹β€β™€οΈ
  • --confirmText="" β€” custom confirmation text, for when you want your own words ✍️
  • --currentPage=0 β€” the current page which should be returned πŸ“„
  • --customQueryParam=[] β€” add custom URL query parameters. i.e. --customQueryParam 'withCustomOption=true,myOtherOption=myvalue' πŸ”—
  • --debug[=false] β€” set very verbose log messages. she's chatty πŸ—£οΈ
  • --delay="0ms" β€” delay after each request, i.e. 5ms, 1.2s πŸ•
  • --delayBefore="0ms" β€” delay before each request, i.e. 5ms, 1.2s πŸ•
  • --dry[=false] β€” dry run. don't send any data to the server πŸ™…β€β™€οΈ
  • --dryFormat="markdown" β€” dry run output format, i.e. json, dump, markdown or curl πŸ“
  • --examples[=false] β€” show examples for the current command πŸ‘€
  • --filter=[] β€” apply a client-side filter to the response before returning it to you πŸ”
  • --flatten[=false] β€” flatten json output by replacing nested json properties with properties whose names are represented by dot notation πŸͺ„
  • -f, --force[=false] β€” do not prompt for confirmation. ignored when using --confirm ⚑
  • -H, --header=[] β€” custom headers. i.e. --header "Accept: value, AnotherHeader: myvalue" πŸ“¨
  • --includeAll[=false] β€” include all results by iterating through each page πŸ—‚οΈ
  • -k, --insecure[=false] β€” allow insecure server connections when using SSL. careful with that one bestie 😬
  • -l, --logMessage="" β€” add a custom message to the activity log πŸͺ΅
  • --maxJobs=0 β€” maximum number of jobs. 0 = unlimited (use with caution!) β€” and yes, that caution is in the original, so like, be careful πŸ’€
  • --noAccept[=false] β€” ignore the Accept header, which removes the Accept header from requests. however, PUT and POST requests will only see the effect πŸ€·β€β™€οΈ
  • --noCache[=false] β€” force disabling of cached responses (overwrites the cache setting) 🚫
  • -M, --noColor[=false] β€” don't use colors when displaying log entries on the console 🌈❌
  • --noLog[=false] β€” disables the activity log for the current command πŸ”‡
  • --noProgress[=false] β€” disable progress bars πŸ“Š
  • --noProxy[=false] β€” ignore the proxy settings πŸšͺ
  • -n, --nullInput[=false] β€” don't read the input (stdin). useful if using in shell for/while loops πŸ”
  • -o, --output="table" β€” output format, i.e. table, json, csv, csvheader πŸ“€
  • --outputFile="" β€” save JSON output to a file (after select/view) πŸ’Ύ
  • --outputFileRaw="" β€” save the raw response to a file (before select/view) πŸ’Ύ
  • --outputTemplate="" β€” jsonnet template to apply to the output 🧩
  • -p, --pageSize=5 β€” maximum results per page πŸ“‘
  • --progress[=false] β€” show the progress bar. this will also disable any other verbose output 🎚️
  • --proxy="" β€” proxy setting, i.e. http://10.0.0.1:8080 🌐
  • -r, --raw[=false] β€” show the raw response. this mode will force output=json and view=off πŸ“œ
  • --retries=3 β€” max number of attempts when a failed http call is encountered πŸ”
  • --select=[] β€” comma separated list of properties to return. wildcards and globstar accepted, i.e. --select 'id,name,type,**.serialNumber' 🎯
  • --session="" β€” session configuration πŸ”
  • --sessionMode="" β€” override the default session mode for a single command, which would normally be disabled πŸŽ›οΈ
  • -P, --sessionPassword="" β€” override session password 🀫
  • -U, --sessionUsername="" β€” override session username. i.e. peter or t1234/peter (with tenant) πŸ§‘β€πŸ’»
  • --silentExit[=false] β€” silent status codes do not affect the exit code 🀐
  • --silentStatusCodes="" β€” status codes which will not print out an error message πŸ™Š
  • --timeout="600s" β€” request timeout duration, i.e. 60s, 2m ⏱️
  • --totalPages=0 β€” total number of pages to get πŸ“š
  • -v, --verbose[=false] β€” verbose logging πŸ—£οΈ
  • --view="auto" β€” use views when displaying data on the terminal. disable using --view off πŸ–ΌοΈ
  • --withError[=false] β€” errors will be printed on stdout instead of stderr πŸ”€
  • --withTotalElements[=false] β€” request Cumulocity to include the total elements in the response statistics under .statistics.totalElements (introduced in 10.13) πŸ”’
  • -t, --withTotalPages[=false] β€” request Cumulocity to include the total pages in the response statistics under .statistics.totalPages πŸ“–
  • --workers=1 β€” number of workers πŸ‘―β€β™€οΈ

🧚 EXAMPLE 🧚

okay so here's the moment you've been waiting for, a real live example 🎬

$ c8y ui plugins delete --id "my-example-app"

and that deletes it β€” Remove UI plugin πŸ’…βœ¨


πŸ’œ SEE ALSO πŸ’œ


and that's the whole page bestie 🌈 that was c8y(1), rendered from source/version c8y(1) and dated Jan 1980 β€” yes, Jan 1980, the manpage is a vintage icon and we respect her πŸ‘‘πŸ’– mwah, go delete some plugins responsibly πŸŽ€

πŸ“¦ where this page comes from