az vmware cluster create has a mandatory flag that is lacks documentation

[theav8or]

Related command

Please clarify difference between --hosts and --size parameters in KB (https://learn.microsoft.com/en-us/cli/azure/vmware/cluster?view=azure-cli-latest#az-vmware-cluster-create) and provide examples how to use 'az vmware cluster' commads to create and expand VMware clusters in AVS."

Resource Provider

Microsoft.AVS/privateClouds

Description of Feature or Work Requested

Command
az vmware cluster create : Create a cluster in a private cloud. The maximum number of clusters
is 4.

Arguments
--hosts [Required] : A cluster's hosts in the private cloud.
--name -n [Required] : Name of the cluster.
--private-cloud -c [Required] : Name of the private cloud.
--resource-group -g [Required] : Name of resource group. You can configure the default group
using az configure --defaults group=<name>.

Minimum API Version Required

Extensions: vmware 5.0.2

Swagger PR link / SDK link

https://portal.microsofticm.com/imp/v3/incidents/details/335010837/home

Request Example

az vmware cluster create --help

Target Date

2022-09-15

Additional context

No response

[yonzhan]

Thank you for opening this issue, we will look into it.

[cataggar]

This looks to be a bug on this line:
https://github.com/Azure/azure-cli-extensions/blob/main/src/vmware/azext_vmware/_params.py#L35

c.argument('hosts', nargs='+', help='A cluster\'s hosts in the private cloud.')

Hosts should not be required.

c.argument('hosts', nargs='*', help='A cluster\'s hosts in the private cloud.')

The corresponding API example for Clusters_CreateOrUpdate is:
https://github.com/Azure/azure-rest-api-specs/blob/main/specification/vmware/resource-manager/Microsoft.AVS/stable/2022-05-01/examples/Clusters_CreateOrUpdate.json