CLOUDP-179700 Update help text of all update commands that have array…

…s to clarify updating such array will wipe out previous data (#1972)

docs/atlascli/command/atlas-customDbRoles-update.txt

@@ -64,15 +64,15 @@ Options
    * - --inheritedRole
      - strings
      - false
-     - List of inherited roles and the database on which the role is granted.
+     - List of inherited roles and the database on which the role is granted. Passing this flag replaces preexisting data.
    * - -o, --output
      - string
      - false
      - Output format. Valid values are json, json-path, go-template, or go-template-file.
    * - --privilege
      - strings
      - false
-     - List of actions per database and collection. If no database or collections are provided, cluster scope is assumed.
+     - List of actions per database and collection. If no database or collections are provided, cluster scope is assumed. Passing this flag replaces preexisting data.
    * - --projectId
      - string
      - false

docs/atlascli/command/atlas-dataLakePipelines-update.txt

@@ -80,7 +80,7 @@ Options
    * - --sinkPartitionField
      - strings
      - false
-     - Ordered fields used to physically organize data in the destination.
+     - Ordered fields used to physically organize data in the destination. Passing this flag replaces preexisting data.
    * - --sourceClusterName
      - string
      - false
@@ -104,7 +104,7 @@ Options
    * - --transform
      - strings
      - false
-     - Fields to be excluded for this data lake pipeline.
+     - Fields to be excluded for this data lake pipeline. Passing this flag replaces preexisting data.
 
 Inherited Options
 -----------------

docs/atlascli/command/atlas-dbusers-update.txt

@@ -72,11 +72,11 @@ Options
    * - --role
      - strings
      - false
-     - User's roles and the databases or collections on which the roles apply.
+     - User's roles and the databases or collections on which the roles apply. Passing this flag replaces preexisting data.
    * - --scope
      - strings
      - false
-     - Array of clusters and Atlas Data Lakes that this user has access to.
+     - Array of clusters and Atlas Data Lakes that this user has access to. Passing this flag replaces preexisting data.
    * - -u, --username
      - string
      - false

docs/atlascli/command/atlas-organizations-apiKeys-assign.txt

@@ -76,7 +76,7 @@ Options
    * - --role
      - strings
      - false
-     - Role or roles that you want to assign to the API key. To assign more than one role, you can specify each role with a separate role flag or specify all of the roles as a comma-separated list using one role flag. Valid values are ORG_OWNER, ORG_MEMBER, ORG_GROUP_CREATOR, ORG_BILLING_ADMIN, and ORG_READ_ONLY.
+     - Role or roles that you want to assign to the API key. To assign more than one role, you can specify each role with a separate role flag or specify all of the roles as a comma-separated list using one role flag. Valid values are ORG_OWNER, ORG_MEMBER, ORG_GROUP_CREATOR, ORG_BILLING_ADMIN, and ORG_READ_ONLY. Passing this flag replaces preexisting data.
 
 Inherited Options
 -----------------

docs/atlascli/command/atlas-organizations-invitations-update.txt

@@ -74,7 +74,7 @@ Options
    * - --role
      - strings
      - true
-     - User's roles for the associated organization. Valid values include ORG_OWNER, ORG_MEMBER, ORG_GROUP_CREATOR, ORG_BILLING_ADMIN, and ORG_READ_ONLY.
+     - User's roles for the associated organization. Valid values include ORG_OWNER, ORG_MEMBER, ORG_GROUP_CREATOR, ORG_BILLING_ADMIN, and ORG_READ_ONLY. Passing this flag replaces preexisting data.
 
 Inherited Options
 -----------------

docs/atlascli/command/atlas-projects-invitations-update.txt

@@ -74,7 +74,7 @@ Options
    * - --role
      - strings
      - true
-     - User's roles for the associated organization. Valid values include ORG_OWNER, ORG_MEMBER, ORG_GROUP_CREATOR, ORG_BILLING_ADMIN, and ORG_READ_ONLY.
+     - User's roles for the associated organization. Valid values include ORG_OWNER, ORG_MEMBER, ORG_GROUP_CREATOR, ORG_BILLING_ADMIN, and ORG_READ_ONLY. Passing this flag replaces preexisting data.
 
 Inherited Options
 -----------------

docs/atlascli/command/atlas-projects-teams-update.txt

@@ -68,7 +68,7 @@ Options
    * - --role
      - strings
      - true
-     - User role that applies to all members of the specified team for the associated project. Valid values include GROUP_CLUSTER_MANAGER, GROUP_DATA_ACCESS_ADMIN, GROUP_DATA_ACCESS_READ_ONLY, GROUP_DATA_ACCESS_READ_WRITE, GROUP_OWNER, and GROUP_READ_ONLY.
+     - User role that applies to all members of the specified team for the associated project. Valid values include GROUP_CLUSTER_MANAGER, GROUP_DATA_ACCESS_ADMIN, GROUP_DATA_ACCESS_READ_ONLY, GROUP_DATA_ACCESS_READ_WRITE, GROUP_OWNER, and GROUP_READ_ONLY. Passing this flag replaces preexisting data.
 
 Inherited Options
 -----------------

docs/mongocli/command/mongocli-atlas-customDbRoles-update.txt

@@ -64,15 +64,15 @@ Options
    * - --inheritedRole
      - strings
      - false
-     - List of inherited roles and the database on which the role is granted.
+     - List of inherited roles and the database on which the role is granted. Passing this flag replaces preexisting data.
    * - -o, --output
      - string
      - false
      - Output format. Valid values are json, json-path, go-template, or go-template-file.
    * - --privilege
      - strings
      - false
-     - List of actions per database and collection. If no database or collections are provided, cluster scope is assumed.
+     - List of actions per database and collection. If no database or collections are provided, cluster scope is assumed. Passing this flag replaces preexisting data.
    * - --projectId
      - string
      - false

docs/mongocli/command/mongocli-atlas-dbusers-update.txt

@@ -72,11 +72,11 @@ Options
    * - --role
      - strings
      - false
-     - User's roles and the databases or collections on which the roles apply.
+     - User's roles and the databases or collections on which the roles apply. Passing this flag replaces preexisting data.
    * - --scope
      - strings
      - false
-     - Array of clusters and Atlas Data Lakes that this user has access to.
+     - Array of clusters and Atlas Data Lakes that this user has access to. Passing this flag replaces preexisting data.
    * - -u, --username
      - string
      - false

docs/mongocli/command/mongocli-cloud-manager-backups-config-update.txt

@@ -62,15 +62,15 @@ Options
    * - --excludedNamespace
      - strings
      - false
-     - List of database names and collection names to omit from the backup.
+     - List of database names and collection names to omit from the backup. Passing this flag replaces preexisting data.
    * - -h, --help
      - 
      - false
      - help for update
    * - --includedNamespace
      - strings
      - false
-     - List of database names and collection names to include in the backup.
+     - List of database names and collection names to include in the backup. Passing this flag replaces preexisting data.
    * - -o, --output
      - string
      - false

docs/mongocli/command/mongocli-cloud-manager-featurePolicies-update.txt

@@ -56,7 +56,7 @@ Options
    * - --policy
      - strings
      - false
-     - List of policies that the external system applies to this Ops Manager Project.
+     - List of policies that the external system applies to this Ops Manager Project. Passing this flag replaces preexisting data.
    * - --projectId
      - string
      - false

docs/mongocli/command/mongocli-cloud-manager-maintenanceWindows-update.txt

@@ -54,7 +54,7 @@ Options
    * - --alertType
      - strings
      - false
-     - Alert types to silence during maintenance window. Valid values are HOST, REPLICA_SET, CLUSTER, AGENT, or BACKUP.
+     - Alert types to silence during maintenance window. Valid values are HOST, REPLICA_SET, CLUSTER, AGENT, or BACKUP. Passing this flag replaces preexisting data.
    * - --desc
      - string
      - false

docs/mongocli/command/mongocli-iam-globalApiKeys-update.txt

@@ -66,7 +66,7 @@ Options
    * - --role
      - strings
      - true
-     - Role or roles that you want to assign to the API key. To assign more than one role, you can specify each role with a separate role flag or specify all of the roles as a comma-separated list using one role flag. Valid values are GLOBAL_AUTOMATION_ADMIN, GLOBAL_BACKUP_ADMIN GLOBAL_MONITORING_ADMIN, GLOBAL_OWNER, GLOBAL_READ_ONLY,GLOBAL_USER_ADMIN.
+     - Role or roles that you want to assign to the API key. To assign more than one role, you can specify each role with a separate role flag or specify all of the roles as a comma-separated list using one role flag. Valid values are GLOBAL_AUTOMATION_ADMIN, GLOBAL_BACKUP_ADMIN GLOBAL_MONITORING_ADMIN, GLOBAL_OWNER, GLOBAL_READ_ONLY,GLOBAL_USER_ADMIN. Passing this flag replaces preexisting data.
 
 Inherited Options
 -----------------

docs/mongocli/command/mongocli-iam-organizations-apiKeys-assign.txt

@@ -76,7 +76,7 @@ Options
    * - --role
      - strings
      - false
-     - Role or roles that you want to assign to the API key. To assign more than one role, you can specify each role with a separate role flag or specify all of the roles as a comma-separated list using one role flag. Valid values are ORG_OWNER, ORG_MEMBER, ORG_GROUP_CREATOR, ORG_BILLING_ADMIN, and ORG_READ_ONLY.
+     - Role or roles that you want to assign to the API key. To assign more than one role, you can specify each role with a separate role flag or specify all of the roles as a comma-separated list using one role flag. Valid values are ORG_OWNER, ORG_MEMBER, ORG_GROUP_CREATOR, ORG_BILLING_ADMIN, and ORG_READ_ONLY. Passing this flag replaces preexisting data.
 
 Inherited Options
 -----------------

docs/mongocli/command/mongocli-iam-organizations-invitations-update.txt

@@ -74,7 +74,7 @@ Options
    * - --role
      - strings
      - true
-     - User's roles  for the associated organization. To learn which values MCLI accepts, see the Items Enum for roles in the Atlas API spec: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/#operation/createOrganizationInvitation/.
+     - User's roles  for the associated organization. To learn which values MCLI accepts, see the Items Enum for roles in the Atlas API spec: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/#operation/createOrganizationInvitation/. Passing this flag replaces preexisting data.
 
 Inherited Options
 -----------------

docs/mongocli/command/mongocli-iam-projects-invitations-update.txt

@@ -74,7 +74,7 @@ Options
    * - --role
      - strings
      - true
-     - User's roles  for the associated organization. To learn which values MCLI accepts, see the Items Enum for roles in the Atlas API spec: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/#operation/createOrganizationInvitation/.
+     - User's roles  for the associated organization. To learn which values MCLI accepts, see the Items Enum for roles in the Atlas API spec: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/#operation/createOrganizationInvitation/. Passing this flag replaces preexisting data.
 
 Inherited Options
 -----------------

docs/mongocli/command/mongocli-iam-projects-teams-update.txt

@@ -68,7 +68,7 @@ Options
    * - --role
      - strings
      - true
-     - User role that applies to all members of the specified team for the associated project. Valid values include GROUP_CLUSTER_MANAGER, GROUP_DATA_ACCESS_ADMIN, GROUP_DATA_ACCESS_READ_ONLY, GROUP_DATA_ACCESS_READ_WRITE, GROUP_OWNER, and GROUP_READ_ONLY.
+     - User role that applies to all members of the specified team for the associated project. Valid values include GROUP_CLUSTER_MANAGER, GROUP_DATA_ACCESS_ADMIN, GROUP_DATA_ACCESS_READ_ONLY, GROUP_DATA_ACCESS_READ_WRITE, GROUP_OWNER, and GROUP_READ_ONLY. Passing this flag replaces preexisting data.
 
 Inherited Options
 -----------------

docs/mongocli/command/mongocli-ops-manager-admin-backups-blockstores-update.txt

@@ -66,7 +66,7 @@ Options
    * - --label
      - strings
      - false
-     - Array of tags to manage which backup jobs Ops Manager can assign to which blockstores.
+     - Array of tags to manage which backup jobs Ops Manager can assign to which blockstores. Passing this flag replaces preexisting data.
    * - --loadFactor
      - int
      - false

docs/mongocli/command/mongocli-ops-manager-admin-backups-fileSystems-update.txt

@@ -66,7 +66,7 @@ Options
    * - --label
      - strings
      - false
-     - Array of tags to manage which backup jobs Ops Manager can assign to which blockstores.
+     - Array of tags to manage which backup jobs Ops Manager can assign to which blockstores. Passing this flag replaces preexisting data.
    * - --loadFactor
      - int
      - false

docs/mongocli/command/mongocli-ops-manager-admin-backups-oplog-update.txt

@@ -66,7 +66,7 @@ Options
    * - --label
      - strings
      - false
-     - Array of tags to manage which backup jobs Ops Manager can assign to which blockstores.
+     - Array of tags to manage which backup jobs Ops Manager can assign to which blockstores. Passing this flag replaces preexisting data.
    * - --maxCapacityGB
      - int
      - false

docs/mongocli/command/mongocli-ops-manager-admin-backups-s3-update.txt

@@ -82,7 +82,7 @@ Options
    * - --label
      - strings
      - false
-     - Array of tags to manage which backup jobs Ops Manager can assign to which blockstores.
+     - Array of tags to manage which backup jobs Ops Manager can assign to which blockstores. Passing this flag replaces preexisting data.
    * - --loadFactor
      - int
      - false

docs/mongocli/command/mongocli-ops-manager-admin-backups-sync-update.txt

@@ -66,7 +66,7 @@ Options
    * - --label
      - strings
      - false
-     - Array of tags to manage which backup jobs Ops Manager can assign to which blockstores.
+     - Array of tags to manage which backup jobs Ops Manager can assign to which blockstores. Passing this flag replaces preexisting data.
    * - --loadFactor
      - int
      - false

docs/mongocli/command/mongocli-ops-manager-backups-config-update.txt

@@ -62,15 +62,15 @@ Options
    * - --excludedNamespace
      - strings
      - false
-     - List of database names and collection names to omit from the backup.
+     - List of database names and collection names to omit from the backup. Passing this flag replaces preexisting data.
    * - -h, --help
      - 
      - false
      - help for update
    * - --includedNamespace
      - strings
      - false
-     - List of database names and collection names to include in the backup.
+     - List of database names and collection names to include in the backup. Passing this flag replaces preexisting data.
    * - -o, --output
      - string
      - false

docs/mongocli/command/mongocli-ops-manager-featurePolicies-update.txt

@@ -56,7 +56,7 @@ Options
    * - --policy
      - strings
      - false
-     - List of policies that the external system applies to this Ops Manager Project.
+     - List of policies that the external system applies to this Ops Manager Project. Passing this flag replaces preexisting data.
    * - --projectId
      - string
      - false

docs/mongocli/command/mongocli-ops-manager-maintenanceWindows-update.txt

@@ -54,7 +54,7 @@ Options
    * - --alertType
      - strings
      - false
-     - Alert types to silence during maintenance window. Valid values are HOST, REPLICA_SET, CLUSTER, AGENT, or BACKUP.
+     - Alert types to silence during maintenance window. Valid values are HOST, REPLICA_SET, CLUSTER, AGENT, or BACKUP. Passing this flag replaces preexisting data.
    * - --desc
      - string
      - false

internal/cli/atlas/customdbroles/update.go

@@ -115,8 +115,8 @@ func UpdateBuilder() *cobra.Command {
 		},
 	}
 
-	cmd.Flags().StringSliceVar(&opts.inheritedRoles, flag.InheritedRole, []string{}, usage.InheritedRoles)
-	cmd.Flags().StringSliceVar(&opts.action, flag.Privilege, []string{}, usage.PrivilegeAction)
+	cmd.Flags().StringSliceVar(&opts.inheritedRoles, flag.InheritedRole, []string{}, usage.InheritedRoles+usage.UpdateWarning)
+	cmd.Flags().StringSliceVar(&opts.action, flag.Privilege, []string{}, usage.PrivilegeAction+usage.UpdateWarning)
 	cmd.Flags().BoolVar(&opts.append, flag.Append, false, usage.Append)
 
 	cmd.Flags().StringVar(&opts.ProjectID, flag.ProjectID, "", usage.ProjectID)

internal/cli/atlas/datalakepipelines/update.go

@@ -175,13 +175,13 @@ func UpdateBuilder() *cobra.Command {
 
 	cmd.Flags().StringVar(&opts.sinkMetadataProvider, flag.SinkMetadataProvider, "", usage.SinkMetadataProvider)
 	cmd.Flags().StringVar(&opts.sinkMetadataRegion, flag.SinkMetadataRegion, "", usage.SinkMetadataRegion)
-	cmd.Flags().StringSliceVar(&opts.sinkPartitionField, flag.SinkPartitionField, nil, usage.SinkPartitionField)
+	cmd.Flags().StringSliceVar(&opts.sinkPartitionField, flag.SinkPartitionField, nil, usage.SinkPartitionField+usage.UpdateWarning)
 	cmd.Flags().StringVar(&opts.sourceType, flag.SourceType, "", usage.SourceType)
 	cmd.Flags().StringVar(&opts.sourceClusterName, flag.SourceClusterName, "", usage.SourceClusterName)
 	cmd.Flags().StringVar(&opts.sourceCollectionName, flag.SourceCollectionName, "", usage.SourceCollectionName)
 	cmd.Flags().StringVar(&opts.sourceDatabaseName, flag.SourceDatabaseName, "", usage.SourceDatabaseName)
 	cmd.Flags().StringVar(&opts.sourcePolicyItemID, flag.SourcePolicyItemID, "", usage.SourcePolicyItemID)
-	cmd.Flags().StringSliceVar(&opts.transform, flag.Transform, nil, usage.Transform)
+	cmd.Flags().StringSliceVar(&opts.transform, flag.Transform, nil, usage.Transform+usage.UpdateWarning)
 	cmd.Flags().StringVarP(&opts.filename, flag.File, flag.FileShort, "", usage.PipelineFilename)
 
 	_ = cmd.MarkFlagFilename(flag.File)

internal/cli/atlas/dbusers/update.go

@@ -110,8 +110,8 @@ func UpdateBuilder() *cobra.Command {
 
 	cmd.Flags().StringVarP(&opts.username, flag.Username, flag.UsernameShort, "", usage.DBUsername)
 	cmd.Flags().StringVarP(&opts.password, flag.Password, flag.PasswordShort, "", usage.Password)
-	cmd.Flags().StringSliceVar(&opts.roles, flag.Role, []string{}, usage.Roles)
-	cmd.Flags().StringSliceVar(&opts.scopes, flag.Scope, []string{}, usage.Scopes)
+	cmd.Flags().StringSliceVar(&opts.roles, flag.Role, []string{}, usage.Roles+usage.UpdateWarning)
+	cmd.Flags().StringSliceVar(&opts.scopes, flag.Scope, []string{}, usage.Scopes+usage.UpdateWarning)
 
 	cmd.Flags().StringVar(&opts.ProjectID, flag.ProjectID, "", usage.ProjectID)
 	cmd.Flags().StringVarP(&opts.Output, flag.Output, flag.OutputShort, "", usage.FormatOut)

internal/cli/atlas/organizations/apikeys/update.go

@@ -95,7 +95,7 @@ To view possible values for the apiKeyId argument, run %s organizations apiKeys
 		},
 	}
 
-	cmd.Flags().StringSliceVar(&opts.roles, flag.Role, []string{}, usage.APIKeyRoles)
+	cmd.Flags().StringSliceVar(&opts.roles, flag.Role, []string{}, usage.APIKeyRoles+usage.UpdateWarning)
 	cmd.Flags().StringVar(&opts.desc, flag.Description, "", usage.APIKeyDescription)
 
 	cmd.Flags().StringVar(&opts.OrgID, flag.OrgID, "", usage.OrgID)

internal/cli/atlas/organizations/invitations/update.go

@@ -109,7 +109,7 @@ func UpdateBuilder() *cobra.Command {
 	}
 
 	cmd.Flags().StringVar(&opts.username, flag.Email, "", usage.Email)
-	cmd.Flags().StringSliceVar(&opts.roles, flag.Role, []string{}, usage.OrgRole)
+	cmd.Flags().StringSliceVar(&opts.roles, flag.Role, []string{}, usage.OrgRole+usage.UpdateWarning)
 	cmd.Flags().StringVar(&opts.OrgID, flag.OrgID, "", usage.OrgID)
 	cmd.Flags().StringVarP(&opts.Output, flag.Output, flag.OutputShort, "", usage.FormatOut)
 	_ = cmd.RegisterFlagCompletionFunc(flag.Output, opts.AutoCompleteOutputFlag())

internal/cli/atlas/projects/invitations/update.go

@@ -108,7 +108,7 @@ func UpdateBuilder() *cobra.Command {
 	}
 
 	cmd.Flags().StringVar(&opts.username, flag.Email, "", usage.Email)
-	cmd.Flags().StringSliceVar(&opts.roles, flag.Role, []string{}, usage.OrgRole)
+	cmd.Flags().StringSliceVar(&opts.roles, flag.Role, []string{}, usage.OrgRole+usage.UpdateWarning)
 	cmd.Flags().StringVar(&opts.ProjectID, flag.ProjectID, "", usage.ProjectID)
 	cmd.Flags().StringVarP(&opts.Output, flag.Output, flag.OutputShort, "", usage.FormatOut)
 	_ = cmd.RegisterFlagCompletionFunc(flag.Output, opts.AutoCompleteOutputFlag())

internal/cli/atlas/projects/teams/update.go

@@ -89,7 +89,7 @@ func UpdateBuilder() *cobra.Command {
 		},
 	}
 
-	cmd.Flags().StringSliceVar(&opts.roles, flag.Role, []string{}, usage.TeamRole)
+	cmd.Flags().StringSliceVar(&opts.roles, flag.Role, []string{}, usage.TeamRole+usage.UpdateWarning)
 
 	cmd.Flags().StringVar(&opts.ProjectID, flag.ProjectID, "", usage.ProjectID)
 	cmd.Flags().StringVarP(&opts.Output, flag.Output, flag.OutputShort, "", usage.FormatOut)

internal/cli/atlas/search/update.go

@@ -126,7 +126,7 @@ func UpdateBuilder() *cobra.Command {
 	cmd.Flags().StringVar(&opts.analyzer, flag.Analyzer, defaultAnalyzer, usage.Analyzer)
 	cmd.Flags().StringVar(&opts.searchAnalyzer, flag.SearchAnalyzer, defaultAnalyzer, usage.SearchAnalyzer)
 	cmd.Flags().BoolVar(&opts.dynamic, flag.Dynamic, false, usage.Dynamic)
-	cmd.Flags().StringSliceVar(&opts.fields, flag.Field, nil, usage.SearchFields)
+	cmd.Flags().StringSliceVar(&opts.fields, flag.Field, nil, usage.SearchFields+usage.UpdateWarning)
 	cmd.Flags().StringVarP(&opts.filename, flag.File, flag.FileShort, "", usage.SearchFilename)
 
 	_ = cmd.MarkFlagFilename(flag.File)

internal/cli/iam/globalapikeys/update.go

@@ -84,7 +84,7 @@ func UpdateBuilder() *cobra.Command {
 		},
 	}
 
-	cmd.Flags().StringSliceVar(&opts.roles, flag.Role, []string{}, usage.GlobalAPIKeyRoles)
+	cmd.Flags().StringSliceVar(&opts.roles, flag.Role, []string{}, usage.GlobalAPIKeyRoles+usage.UpdateWarning)
 	cmd.Flags().StringVar(&opts.desc, flag.Description, "", usage.APIKeyDescription)
 
 	cmd.Flags().StringVarP(&opts.Output, flag.Output, flag.OutputShort, "", usage.FormatOut)

internal/cli/iam/organizations/apikeys/update.go

@@ -95,7 +95,7 @@ To view possible values for the apiKeyId argument, run %s organizations apiKeys
 		},
 	}
 
-	cmd.Flags().StringSliceVar(&opts.roles, flag.Role, []string{}, usage.APIKeyRoles)
+	cmd.Flags().StringSliceVar(&opts.roles, flag.Role, []string{}, usage.APIKeyRoles+usage.UpdateWarning)
 	cmd.Flags().StringVar(&opts.desc, flag.Description, "", usage.APIKeyDescription)
 
 	cmd.Flags().StringVar(&opts.OrgID, flag.OrgID, "", usage.OrgID)