c8y(1)

πŸ“¦ version 2.56.1, in nixpkgs unstable

okay bestie, welcome to the c8y(1) manual page for c8y-devicemanagement-certificates-update β€” the little command that updates a trusted device certificate. no cap, we’re about to go through every flag like it’s a group chat. πŸ’…βœ¨

🌸 NAME 🌸

c8y-devicemanagement-certificates-update β€” Update trusted device certificate. that’s the name, that’s the assignment, periodt. πŸŽ€

✨ SYNOPSIS ✨

the shape is giving:

c8y devicemanagement certificates update [flags]

πŸ¦‹ DESCRIPTION πŸ¦‹

Update settings of an existing trusted device certificate. lowkey exactly what it says: existing trusted device cert, settings updated. πŸ¦‹

πŸ’– OPTIONS πŸ’–

here’s the whole flag menu, bestie β€” don’t skip a single one, iykyk. πŸ’–

  • --autoRegistrationEnabled[=false] β€” Enable auto registration ✨
  • -d, --data=[] β€” static data to be applied to body. accepts json or shorthand json, i.e. --data 'value1=1,my.nested.value=100' πŸ“
  • -h, --help[=false] β€” help for update 🫢
  • --id=[] β€” Certificate fingerprint or name (accepts pipeline) πŸ”₯
  • --name="" β€” Certificate name πŸŽ€
  • --processingMode="" β€” Cumulocity processing mode 🌈
  • --status="" β€” Status ⭐
  • --template="" β€” Body template 🧚
  • --templateVars=[] β€” Body template variables πŸ’œ
  • --tenant="" β€” Tenant id πŸ‘‘

🫢 OPTIONS INHERITED FROM PARENT COMMANDS 🫢

these are inherited from parent commands, so they’re like the family hand-me-downs but useful. 🫢

  • --abortOnErrors=10 β€” Abort batch when reaching specified number of errors ⚠️
  • --allowEmptyPipe[=false] β€” Don't fail when piped input is empty (stdin) 🫧
  • --cache[=false] β€” Enable cached responses πŸ’Ύ
  • --cacheBodyPaths=[] β€” Cache should limit hashing of selected paths in the json body. Empty indicates 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 output is the terminal 🧼
  • --confirm[=false] β€” Prompt for confirmation πŸ™ˆ
  • --confirmText="" β€” Custom confirmation text πŸ’¬
  • --currentPage=0 β€” 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 πŸ›
  • --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 response before returning it to the user 🫧
  • --flatten[=false] β€” flatten json output by replacing nested json properties with properties where their 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 πŸ”“
  • -l, --logMessage="" β€” Add custom message to the activity log πŸͺ΅
  • --maxJobs=0 β€” Maximum number of jobs. 0 = unlimited (use with caution!) ⚠️
  • --noAccept[=false] β€” Ignore Accept header will remove the Accept header from requests, however PUT and POST requests will only see the effect 🚫
  • --noCache[=false] β€” Force disabling of cached responses (overwrites 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 file (after select/view) πŸ’Ύ
  • --outputFileRaw="" β€” Save raw response to file (before select/view) πŸ—‚οΈ
  • --outputTemplate="" β€” jsonnet template to apply to the output 🧩
  • -p, --pageSize=5 β€” Maximum results per page πŸ“„
  • --progress[=false] β€” Show 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 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 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 🌈

examples that ate:

$ c8y devicemanagement certificates update --id abcedef0123456789abcedef0123456789 --status DISABLED
Update device certificate by id/fingerprint

$ c8y devicemanagement certificates update --id MyCert --status DISABLED
Update device certificate by name

πŸ‘‘ SEE ALSO πŸ‘‘

c8y-devicemanagement-certificates(1) β€” go see the parent command, it’s giving main character energy. πŸ‘‘

mwah πŸ’‹ β€” source/version: the c8y(1) manual; date: Jan 1980. byeee, go slay those certs 🫢

πŸ“¦ where this page comes from