# create

## Usage

```
ionosctl compute backupunit create [flags]
```

## Aliases

For `backupunit` command:

```
[b backup]
```

For `create` command:

```
[c]
```

## Description

Use this command to create a BackupUnit under a particular contract. You need to specify the name, email and password for the new BackupUnit.

Notes:

* The name assigned to the BackupUnit will be concatenated with the contract number to create the login name for the backup system. The name may NOT be changed after creation.
* The password set here is used along with the login name described above to register the backup agent with the backup system. When setting the password, please make a note of it, as the value cannot be retrieved using the Cloud API.
* The e-mail address supplied here does NOT have to be the same as your Cloud API username. This e-mail address will receive service reports from the backup system.
* To login to backup agent, please use <https://dcd.ionos.com/latest/> and access BackupUnit Console or use <https://backup.ionos.com>

Required values to run a command:

* Name
* Email
* Password

## Options

```
  -u, --api-url string    Override default host URL. Preferred over the config file override 'cloud' and env var 'IONOS_API_URL' (default "https://api.ionos.com")
      --cols strings      Set of columns to be printed on output 
                          Available columns: [BackupUnitId Name Email State] (default [BackupUnitId,Name,Email,State])
  -c, --config string     Configuration file used for authentication (default "$XDG_CONFIG_HOME/ionosctl/config.yaml")
  -D, --depth int         Level of detail for response objects (default 1)
  -e, --email string      The e-mail address you want to assign to the BackupUnit (required)
  -F, --filters strings   Limit results to results containing the specified filter:KEY1=VALUE1,KEY2=VALUE2
  -f, --force             Force command to execute without user input
  -h, --help              Print usage
      --limit int         Maximum number of items to return per request (default 50)
  -n, --name string       Alphanumeric name you want to assign to the BackupUnit (required)
      --no-headers        Don't print table headers when table output is used
      --offset int        Number of items to skip before starting to collect the results
      --order-by string   Property to order the results by
  -o, --output string     Desired output format [text|json|api-json] (default "text")
  -p, --password string   Alphanumeric password you want to assign to the BackupUnit (required)
      --query string      JMESPath query string to filter the output
  -q, --quiet             Quiet output
  -t, --timeout int       Timeout option for Request for BackupUnit creation [seconds] (default 60)
  -v, --verbose count     Increase verbosity level [-v, -vv, -vvv]
```

## Examples

```
ionosctl compute backupunit create --name NAME --email EMAIL --password PASSWORD
```