# 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). |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.apolo.us/index/apolo-cli/commands/disk.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.