Not clear which parameters are required

[jongio]

Entered
az iot device send-d2c-message

Got this

I would like some indication that tells me which parameters are required.

[digimaun]

I'm using azure cli 2.0.46 and iot extension 0.6.0

When entering az iot device send-d2c-message there is a notification before the usage info:

az iot device send-d2c-message: error: the following arguments are required: --device-id/-d

To expand the parameters and see clear indicator for required, append -h or --help to the command i.e. az iot device send-d2c-message -h:

Command
az iot device send-d2c-message : Send an mqtt device-to-cloud message.
Supports application and system properties to send with message.

Arguments
--device-id -d [Required] : Target Device.
--da --data : Message body. Default: Ping from Az CLI IoT Extension.
...

Try testing the required param notification with commands that have multiple required params

Input:
az iot hub configuration create

Output:

az iot hub configuration create: error: the following arguments are required: --config-id/-c, --content/-k

[jongio]

If I provide -d, then it tells me I also need to provide a iot hub name or connection string.

Would be good for user to know that either one of those are required as well.

[jongio]

@digimaun can this be closed?

[digimaun]

Yea -- we have an upcoming release including change #389 which improves visibility + description of --hub-name and --login in --help. Combined with improved Az CLI usage error output (which will output command examples) and an investigation activity for usage of argparse mutual exclusion #398.