(DOCSP-30198) Clarifies options/args required if you don't use file option (#2002)

Author: sarahsimpers

docs/atlascli/command/atlas-clusters-create.txt

@@ -43,7 +43,7 @@ Arguments
    * - name
      - string
      - false
-     - Name of the cluster. The cluster name cannot be changed after the cluster is created. Cluster name can contain ASCII letters, numbers, and hyphens.
+     - Name of the cluster. The cluster name cannot be changed after the cluster is created. Cluster name can contain ASCII letters, numbers, and hyphens. You must specify the cluster name argument if you don't use the --file option.
 
 Options
 -------
@@ -99,11 +99,11 @@ Options
    * - --provider
      - string
      - false
-     - Name of your cloud service provider. Valid values are AWS, AZURE, or GCP.
+     - Name of your cloud service provider. Valid values are AWS, AZURE, or GCP. You must specify the provider option if you don't use the --file option.
    * - -r, --region
      - string
      - false
-     - Physical location of your MongoDB cluster. For a complete list of supported AWS regions, see: https://www.mongodb.com/docs/atlas/reference/amazon-aws/. For a complete list of supported Azure regions, see: https://www.mongodb.com/docs/atlas/reference/microsoft-azure/#microsoft-azure. For a complete list of supported GCP regions, see: https://www.mongodb.com/docs/atlas/reference/google-gcp/..
+     - Physical location of your MongoDB cluster. You must specify the region option if you don't use the --file option. For a complete list of supported AWS regions, see: https://www.mongodb.com/docs/atlas/reference/amazon-aws/. For a complete list of supported Azure regions, see: https://www.mongodb.com/docs/atlas/reference/microsoft-azure/#microsoft-azure. For a complete list of supported GCP regions, see: https://www.mongodb.com/docs/atlas/reference/google-gcp/.
    * - -s, --shards
      - int
      - false

docs/mongocli/command/mongocli-atlas-clusters-create.txt

@@ -43,7 +43,7 @@ Arguments
    * - name
      - string
      - false
-     - Name of the cluster. The cluster name cannot be changed after the cluster is created. Cluster name can contain ASCII letters, numbers, and hyphens.
+     - Name of the cluster. The cluster name cannot be changed after the cluster is created. Cluster name can contain ASCII letters, numbers, and hyphens. You must specify the cluster name argument if you don't use the --file option.
 
 Options
 -------
@@ -99,11 +99,11 @@ Options
    * - --provider
      - string
      - false
-     - Name of your cloud service provider. Valid values are AWS, AZURE, or GCP.
+     - Name of your cloud service provider. Valid values are AWS, AZURE, or GCP. You must specify the provider option if you don't use the --file option.
    * - -r, --region
      - string
      - false
-     - Physical location of your MongoDB cluster. For a complete list of supported AWS regions, see: https://www.mongodb.com/docs/atlas/reference/amazon-aws/. For a complete list of supported Azure regions, see: https://www.mongodb.com/docs/atlas/reference/microsoft-azure/#microsoft-azure. For a complete list of supported GCP regions, see: https://www.mongodb.com/docs/atlas/reference/google-gcp/..
+     - Physical location of your MongoDB cluster. You must specify the region option if you don't use the --file option. For a complete list of supported AWS regions, see: https://www.mongodb.com/docs/atlas/reference/amazon-aws/. For a complete list of supported Azure regions, see: https://www.mongodb.com/docs/atlas/reference/microsoft-azure/#microsoft-azure. For a complete list of supported GCP regions, see: https://www.mongodb.com/docs/atlas/reference/google-gcp/.
    * - -s, --shards
      - int
      - false

internal/cli/atlas/clusters/create.go

@@ -245,7 +245,7 @@ For full control of your deployment, or to create multi-cloud clusters, provide
 			return opts.Run()
 		},
 		Annotations: map[string]string{
-			"nameDesc": "Name of the cluster. The cluster name cannot be changed after the cluster is created. Cluster name can contain ASCII letters, numbers, and hyphens.",
+			"nameDesc": "Name of the cluster. The cluster name cannot be changed after the cluster is created. Cluster name can contain ASCII letters, numbers, and hyphens. You must specify the cluster name argument if you don't use the --file option.",
 			"output":   createTmpl,
 		},
 	}
@@ -257,8 +257,8 @@ For full control of your deployment, or to create multi-cloud clusters, provide
 		defaultDiskSize    = 2
 		defaultShardSize   = 1
 	)
-	cmd.Flags().StringVar(&opts.provider, flag.Provider, "", usage.Provider)
-	cmd.Flags().StringVarP(&opts.region, flag.Region, flag.RegionShort, "", usage.Region)
+	cmd.Flags().StringVar(&opts.provider, flag.Provider, "", usage.CreateProvider)
+	cmd.Flags().StringVarP(&opts.region, flag.Region, flag.RegionShort, "", usage.CreateRegion)
 	cmd.Flags().IntVarP(&opts.members, flag.Members, flag.MembersShort, defaultMembersSize, usage.Members)
 	cmd.Flags().StringVar(&opts.tier, flag.Tier, atlasM2, usage.Tier)
 	cmd.Flags().Float64Var(&opts.diskSizeGB, flag.DiskSizeGB, defaultDiskSize, usage.DiskSizeGB)

internal/usage/usage.go

@@ -320,8 +320,10 @@ dbName and collection are required only for built-in roles.`
 	AccessListType                            = "Type of access list entry. Valid values are cidrBlock, ipAddress, or awsSecurityGroup."
 	Service                                   = "Type of MongoDB service. Valid values are cloud, cloudgov, cloud-manager, or ops-manager."
 	Provider                                  = "Name of your cloud service provider. Valid values are AWS, AZURE, or GCP."
+	CreateProvider                            = "Name of your cloud service provider. Valid values are AWS, AZURE, or GCP. You must specify the provider option if you don't use the --file option."
 	ClusterTypes                              = "Type of the cluster that you want to create. Valid values are REPLICASET or SHARDED."
 	Region                                    = "Physical location of your MongoDB cluster. For a complete list of supported AWS regions, see: https://www.mongodb.com/docs/atlas/reference/amazon-aws/. For a complete list of supported Azure regions, see: https://www.mongodb.com/docs/atlas/reference/microsoft-azure/#microsoft-azure. For a complete list of supported GCP regions, see: https://www.mongodb.com/docs/atlas/reference/google-gcp/.."
+	CreateRegion                              = "Physical location of your MongoDB cluster. You must specify the region option if you don't use the --file option. For a complete list of supported AWS regions, see: https://www.mongodb.com/docs/atlas/reference/amazon-aws/. For a complete list of supported Azure regions, see: https://www.mongodb.com/docs/atlas/reference/microsoft-azure/#microsoft-azure. For a complete list of supported GCP regions, see: https://www.mongodb.com/docs/atlas/reference/google-gcp/."
 	AWSIAMType                                = "AWS IAM method by which the provided username is authenticated. Valid values are NONE, USER, or ROLE. If you set this to USER or ROLE, the user authenticates with IAM credentials and doesn't need a password. If you set this to USER or ROLE, you can't set --x509Type or --ldapType to any value other than NONE."
 	X509Type                                  = "X.509 method by which the provided username is authenticated.  Valid values are NONE, MANAGED, or CUSTOMER. If you set this to MANAGED the user authenticates with an Atlas-managed X.509 certificate. If you set this to CUSTOMER, the user authenticates with a self-managed X.509 certificate. If you set this to MANAGED or CUSTOMER, you can't set --awsIAMType or --ldapType to any value other than NONE."
 	LDAPType                                  = "LDAP method by which the provided username is authenticated. Valid values are NONE, USER, or GROUP. If you set this to USER or GROUP, the user authenticates with LDAP. If you set this to USER or GROUP, you can't set --x509Type or --awsIAMType to any value other than NONE."