# disk

Operations with disks

## Usage

```bash
apolo disk [OPTIONS] COMMAND [ARGS]...
```

Operations with disks.

**Commands:**

| Usage               | Description          |
| ------------------- | -------------------- |
| [*create*](#create) | Create a disk        |
| [*get*](#get)       | Get disk DISK\_ID    |
| [*ls*](#ls)         | List disks           |
| [*rm*](#rm)         | Remove disk DISK\_ID |

### create

Create a disk

#### Usage

```bash
apolo disk create [OPTIONS] STORAGE
```

Create a disk

Create a disk with at least storage amount `STORAGE`.

To specify the amount, you can use the following suffixes: "k`KMGTPEZY`" To use decimal quantities, append "b" or "B". For example:

* 1K or 1k is `1024` bytes
* 1Kb or `1KB` is `1000` bytes
* `20G` is 20 \* 2 ^ 30 bytes
* `20G`b or `20GB` is 20.`000`.`000`.`000` bytes

Note that server can have big granularity (for example, 1G) so it will possibly round-up the amount you requested.

#### Examples

```bash

$ apolo disk create 10G
$ apolo disk create 500M
```

#### Options

| Name                         | Description                                                                                                                                                                   |
| ---------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| *--help*                     | Show this message and exit.                                                                                                                                                   |
| *--cluster CLUSTER*          | Perform in a specified cluster (the current cluster by default).                                                                                                              |
| *--name NAME*                | Optional disk name                                                                                                                                                            |
| *--org ORG*                  | Perform in a specified org (the current org by default).                                                                                                                      |
| *--project PROJECT*          | Create disk in a specified project (the current project by default).                                                                                                          |
| *--timeout-unused TIMEDELTA* | Optional disk lifetime limit after last usage in the format '1d2h3m4s' (some parts may be missing). Set '0' to disable. Default value '1d' can be changed in the user config. |

### get

Get disk DISK\_ID

#### Usage

```bash
apolo disk get [OPTIONS] DISK
```

Get disk `DISK`\_ID.

#### Options

| Name                | Description                                                   |
| ------------------- | ------------------------------------------------------------- |
| *--help*            | Show this message and exit.                                   |
| *--cluster CLUSTER* | Look on a specified cluster (the current cluster by default). |
| *--full-uri*        | Output full disk URI.                                         |
| *--org ORG*         | Look on a specified org (the current org by default).         |
| *--project PROJECT* | Look on a specified project (the current project by default). |

### ls

List disks

#### Usage

```bash
apolo disk ls [OPTIONS]
```

List disks.

#### Options

| Name                | Description                                                   |
| ------------------- | ------------------------------------------------------------- |
| *--help*            | Show this message and exit.                                   |
| *--all-orgs*        | Show disks in all orgs.                                       |
| *--all-projects*    | Show disks in all projects.                                   |
| *--cluster CLUSTER* | Look on a specified cluster (the current cluster by default). |
| *--full-uri*        | Output full disk URI.                                         |
| *--long-format*     | Output all info about disk.                                   |
| *--org ORG*         | Look on a specified org (the current org by default).         |
| *--project PROJECT* | Look on a specified project (the current project by default). |

### rm

Remove disk DISK\_ID

#### Usage

```bash
apolo disk rm [OPTIONS] DISKS...
```

Remove disk `DISK`\_ID.

#### Options

| Name                | Description                                                      |
| ------------------- | ---------------------------------------------------------------- |
| *--help*            | Show this message and exit.                                      |
| *--cluster CLUSTER* | Perform on a specified cluster (the current cluster by default). |
| *--org ORG*         | Perform on a specified org (the current org by default).         |
| *--project PROJECT* | Perform on a specified project (the current project by default). |