Restsh v4.6.1

• General
  • Fix: MO_F5_AS3_INCLUDE_DECLARATION - print errors to STDERR
• GitLab Module
  • Feat: Improve pagination support
  • Fix: Pagination is 1-indexed and max per page is 100

Restsh v4.6.0

This version introduces the MyF5 API module.

• General
  • Feat: Add restsh.util.print_formated to pretty print json with plain text fallback
  • Feat: Add restsh.util.print_formated_err to pretty print json with plain text fallback as error
  • Doc: Add more tutorials
  • Upd: Pad output of KV
• Axians Automation Framework
  • Feat: aafw.art.template.list - Lists all Application Ready Templates
  • Feat: aafw.pipeline.start.f5update
  • Feat: aafw.pipeline.start.task.sysdb
  • Upd: Remove obsolete TASK_HOST option from aafw.pipeline.start.do
• Certificate Module
  • Feat: Add support for ML-DSA algorithm for key handling
  • Feat: New commands
    • cert.bundle.verify: Verifies a certificate bundle against itself.
    • cert.key.info: Shows the public key type
    • cert.key.public.verify: Check public key consistency
    • cert.x509.create: Creates a self-signed certificate
    • cert.x509.fingerprint: Prints the sha256 fingerprint of the certificate.
  • Upd: Remove <alg> parameter where possible
• GitLab Module
  • Feat: gitlab.group.exists
  • Feat: gitlab.project.create - Add default project settings
  • Feat: gitlab.project.schedules.state
  • Feat: gitlab.project.job_token_scope.push
  • Feat: Group access token management
    • gitlab.group.access_token.create
    • gitlab.group.access_token.list
    • gitlab.group.access_token.revoke
    • gitlab.group.access_token.rotate
  • Feat: Project access token management
    • gitlab.project.access_token.create
    • gitlab.project.access_token.list
    • gitlab.project.access_token.revoke
    • gitlab.project.access_token.rotate
  • Upd: gitlab.project.schedules.list - Add ref to list
  • Fix: gitlab.mr.automerge, gitlab.mr.merge - Get SHA of the merge request, this is required since GitLab 19.2.
• F5 TMOS Module
  • Feat: Route Domain management
    • f5.net.route-domain.create
    • f5.net.route-domain.delete
    • f5.net.route-domain.get
    • f5.net.route-domain.list
  • Feat: f5.sys.snmp.user.create - Add options for authentication and privacy protocol
  • Feat: f5.ltm.vs.list - Shows enabled state and description
  • Feat: f5.ltm.vs.list.state - Like f5.ltm.vs.list but with availability state
  • Feat: f5.sslreport.generate - Add option to create markdown report
  • Feat: Support of the new declarative API (Experimental)
    • f5.declared.app.declare - Create or update an app
    • f5.declared.app.get - Get the app declaration
    • f5.declared.app.list - Lists all app declarations
    • f5.declared.app.remove - Removes an app declaration
  • Feat: Partition management
    • f5.partition.create
    • f5.partition.delete
    • f5.partition.list
  • Feat: tmsh script management
    • f5.cli.script.create
    • f5.cli.script.delete
    • f5.cli.script.get
    • f5.cli.script.list
    • f5.cli.script.run
    • f5.cli.script.update
  • Feat: New and reworked functions for software and volume management
    • f5.software.hotfix.install
    • f5.software.hotfix.list
    • f5.software.image.delete
    • f5.software.image.download
    • f5.software.image.install
    • f5.software.image.list
    • f5.software.image.upload
    • f5.software.volume.activate
    • f5.software.volume.active
    • f5.software.volume.cpcfg
    • f5.software.volume.delete
    • f5.software.volume.list
  • Upd: f5.sys.service.restart - Add workaround for httpd restart
  • Upd: f5.asm.live-update.list - Add option to hide previously installed updates
  • Upd: f5.cluster.traffic-group.masquerade.set - Add check for invalid MACs for F5OS
  • Upd: f5.sys.snmp.user.delete - Support fullPath
• F5OS-A Module
  • Feat: Enhanced tenant management
    • Add f5osa.tenant.create
    • Add f5osa.tenant.delete
    • Add f5osa.tenant.get
    • Add f5osa.tenant.state
    • Add f5osa.tenant.image.list
  • Feat: Dockerized services management
    • Add f5osa.service.list
    • Add f5osa.service.restart
• MyF5 Module: New module for the MyF5 API (Experimental)
  • Feat: Generic download functions
    • Add myf5.downloads.metadata
    • Add myf5.downloads.product
    • Add myf5.downloads.product.containers
    • Add myf5.downloads.product.families
    • Add myf5.downloads.product.files
    • Add myf5.downloads.product.lines
    • Add myf5.downloads.product.links
  • Feat: myf5.downloads.get.as3 - Download latest or specific AS3 version
  • Feat: myf5.downloads.get.do - Download latest or specific DO version

Restsh v4.5.2

• F5 TMOS Module
  • Fix: f5.ltm.clientssl.list - List certificate

Restsh v4.5.1

This is a small bug fix release.

• Certificate Module
  • Fix: cert.csr.pubkey.hash - Print correct hash
  • Fix: cert.x509.pubkey.hash - Print correct hash
• GitLab Module
  • Fix: gitlab.group.clone - Run fetch before pull to update a local repository

Restsh v4.5.0

This is the first version that is released under GPL-3.0-or-later.

Restsh is only compatible with Bash 5 or newer and checks the Bash version now on startup.

• General
  • Feat: Support proxy authentication
  • Feat: Add restsh.passphrase
  • Feat: Add restsh.util.check.string to validate values like names, ids, etc.
  • Feat: Add restsh.util.check.filename to validate values like filenames and paths
  • Feat: Add restsh.util.check.uint to validate unsigned integer values
  • Feat: Add restsh.util.check.bool to validate boolean values (true, false)
  • Feat: Add restsh.util.jsonencode
  • Feat: Add f5.device.reboot
  • Upd: Centralize module files in modules folder
  • Upd: Add restsh.setup alias
  • Upd: restsh.util.setvar - Add check for valid filenames
  • Upd: restsh.util.setvars - Add warning for invalid filenames
  • Upd: Documentation
  • Upd: Revised Mustache Template Engine
  • Upd: XARGS - do not run command with empty argument
  • Fix: F5 Token Authentication - Token renewal
• Axians Automation Framework
  • Feat: aafw.art.new - Support iRule Framework configuration
  • Feat: aafw.pipeline.start.task.cluster
  • Feat: aafw.pipeline.start.task.liveupdate
  • Feat: aafw.pipeline.start.task.asmtemplates
• Certificate Module
  • Feat: cert.csr.pubkey
  • Feat: cert.csr.pubkey.hash, cert.key.public.hash, cert.x509.pubkey.hash - Print SHA256 hash of public keys
• F5 TMOS Module
  • Feat: f5.sys.license
  • Feat: f5.asm.policy.exists
  • Feat: f5.asm.template.update
  • Feat: f5.asm.entity.filetypes.remove
  • Feat: f5.asm.entity.urls-allowed.add, f5.asm.entity.urls.remove
  • Feat: f5.asm-live-update.check - Add wait option
  • Feat: f5.asm.live-update.file.cleanup
  • Feat: f5.asm.live-update.file.download
  • Feat: f5.asm.live-update.stage
  • Feat: f5.asm.policy.signatureset.remove, f5.asm.policy.signatureset.getid
  • Feat: f5.botdefense.profile.delete
  • Feat: f5.ltm.clientssl.delete
  • Feat: f5.net.selfip.delete
  • Feat: f5.net.vlan.delete
  • Feat: f5.cluster.traffic-group.masquerade.set
  • Upd: f5.cert.expire - Add option to not fail on expired certificates
  • Upd: f5.device.cert.reset - Add required options for old cert/key name
  • Upd: f5.ltm.datagroup.internal.list - Add option for raw json output
  • Upd: f5.ltm.datagroup.internal.create, f5.ltm.datagroup.internal.update - Add option for CSV separator
  • Upd: f5.run - Add option to run command in background
  • Fix: f5.asm.template.import - Delete uploaded file after import
  • Fix: f5.device.cert.install - Always use server.crt and server.key as current certificate-key-pair
  • Fix: f5.ltm.vs.modify - Use fullPath to modify the VS
  • Del: Removed support for F5 deprecated telemetry streaming
• GitLab Module
  • Feat: gitlab.project.get, gitlab.project.exists
  • Feat: gitlab.repository.file.add
  • Feat: gitlab.group.path, gitlab.project.path
  • Feat: gitlab.group.purge, gitlab.project.purge - Purges a project/group (delete and permanently delete in one step)
  • Feat: gitlab.group.move, gitlab.group.rename
  • Feat: gitlab.runner.delete
  • Feat: gitlab.branch.exists
  • Upd: gitlab.group.create - support 'group/subgroup` as name
  • Upd: gitlab.group.delete, gitlab.project.delete - Support id's