generate docs

Author: DiogoFerrao

docs/stackit_mongodbflex_backup.md

@@ -31,6 +31,7 @@ stackit mongodbflex backup [flags]
 * [stackit mongodbflex](./stackit_mongodbflex.md)	 - Provides functionality for MongoDB Flex
 * [stackit mongodbflex backup describe](./stackit_mongodbflex_backup_describe.md)	 - Shows details of a backup for a MongoDB Flex instance
 * [stackit mongodbflex backup list](./stackit_mongodbflex_backup_list.md)	 - Lists all backups which are available for a MongoDB Flex instance
+* [stackit mongodbflex backup restore](./stackit_mongodbflex_backup_restore.md)	 - Restores a MongoDB Flex instance from a backup
 * [stackit mongodbflex backup restore-jobs](./stackit_mongodbflex_backup_restore-jobs.md)	 - Lists all restore jobs which have been run for a MongoDB Flex instance
 * [stackit mongodbflex backup schedule](./stackit_mongodbflex_backup_schedule.md)	 - Shows details of the backup schedule and retention policy of a MongoDB Flex instance
 * [stackit mongodbflex backup update-schedule](./stackit_mongodbflex_backup_update-schedule.md)	 - Updates the backup schedule and retention policy for a MongoDB Flex instance

docs/stackit_mongodbflex_backup_restore.md

@@ -0,0 +1,51 @@
+## stackit mongodbflex backup restore
+
+Restores a MongoDB Flex instance from a backup
+
+### Synopsis
+
+Restores a MongoDB Flex instance from a backup of an instance or clones a MongoDB Flex instance from a point-in-time snapshot.
+The backup is specified by a backup id and the point-in-time snapshot is specified by a timestamp.
+The instance to apply the backup to can be specified, otherwise it will be the same as the backup.
+
+```
+stackit mongodbflex backup restore [flags]
+```
+
+### Examples
+
+```
+  Restores a MongoDB Flex instance with id "yyy" using backup with id "zzz"
+  $ stackit mongodbflex backup restore --instance-id yyy --backup-id zzz
+
+  Clone a MongoDB Flex instance with id "yyy" via point-in-time restore to timestamp "zzz"
+  $ stackit mongodbflex backup restore --instance-id yyy --timestamp zzz
+
+  Restores a MongoDB Flex instance with id "yyy" using backup from instance with id "zzz" with backup id "aaa"
+  $ stackit mongodbflex backup restore --instance-id zzz --backup-instance-id yyy --backup-id aaa
+```
+
+### Options
+
+```
+      --backup-id string            Backup id
+      --backup-instance-id string   Instance id of the target instance to restore the backup to
+  -h, --help                        Help for "stackit mongodbflex backup restore"
+      --instance-id string          Instance id
+      --timestamp string            Timestamp of the snapshot to clone the instance from
+```
+
+### Options inherited from parent commands
+
+```
+  -y, --assume-yes             If set, skips all confirmation prompts
+      --async                  If set, runs the command asynchronously
+  -o, --output-format string   Output format, one of ["json" "pretty" "none"]
+  -p, --project-id string      Project ID
+      --verbosity string       Verbosity of the CLI, one of ["debug" "info" "warning" "error"] (default "info")
+```
+
+### SEE ALSO
+
+* [stackit mongodbflex backup](./stackit_mongodbflex_backup.md)	 - Provides functionality for MongoDB Flex instance backups
+

internal/cmd/mongodbflex/backup/restore/restore.go

@@ -39,9 +39,9 @@ func NewCmd(p *print.Printer) *cobra.Command {
 		Use:   "restore",
 		Short: "Restores a MongoDB Flex instance from a backup",
 		Long: fmt.Sprintf("%s\n%s\n%s",
-			"Restores a MongoDB Flex instance from a backup of an instance.",
-			"The backup can be specified by either a backup id or a timestamp.",
-			"The target instance can be specified, otherwise the target instance will be the same as the backup.",
+			"Restores a MongoDB Flex instance from a backup of an instance or clones a MongoDB Flex instance from a point-in-time snapshot.",
+			"The backup is specified by a backup id and the point-in-time snapshot is specified by a timestamp.",
+			"The instance to apply the backup to can be specified, otherwise it will be the same as the backup.",
 		),
 		Args: args.NoArgs,
 		Example: examples.Build(
@@ -139,9 +139,9 @@ func NewCmd(p *print.Printer) *cobra.Command {
 
 func configureFlags(cmd *cobra.Command) {
 	cmd.Flags().Var(flags.UUIDFlag(), instanceIdFlag, "Instance id")
-	cmd.Flags().Var(flags.UUIDFlag(), backupInstanceIdFlag, "Backup instance id")
+	cmd.Flags().Var(flags.UUIDFlag(), backupInstanceIdFlag, "Instance id of the target instance to restore the backup to")
 	cmd.Flags().String(backupIdFlag, "", "Backup id")
-	cmd.Flags().String(timestampFlag, "", "Timestamp of the backup")
+	cmd.Flags().String(timestampFlag, "", "Timestamp of the snapshot to clone the instance from")
 
 	err := flags.MarkFlagsRequired(cmd, instanceIdFlag)
 	cobra.CheckErr(err)