> ## Documentation Index
> Fetch the complete documentation index at: https://starforge.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# sf volume

> Volumes a job can mount

## `sf volume`

Volumes a job can mount

```bash theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
sf volume <subcommand>
```

| 命令                 | 说明                                  |
| ------------------ | ----------------------------------- |
| `sf volume create` | Create an empty volume              |
| `sf volume ls`     | List the volumes you can reference  |
| `sf volume push`   | Add a folder's files to a volume    |
| `sf volume rm`     | Delete a volume, or files inside it |

### `sf volume create`

Create an empty volume

```bash theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
sf volume create <NAME> [options]
```

| 参数     | 说明                                                              |
| ------ | --------------------------------------------------------------- |
| `NAME` | \<owner>/\<name>, or a bare name in your own namespace (**必填**) |

| 选项                    | 说明                                    |
| --------------------- | ------------------------------------- |
| `--public`            | Let every signed-in user reference it |
| `--description`, `-d` | One line shown in the listing         |

### `sf volume ls`

List the volumes you can reference

```bash theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
sf volume ls
```

除 `--help` 外没有其他选项。

### `sf volume push`

Add a folder's files to a volume

```bash theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
sf volume push <DIRECTORY> [options]
```

| 参数          | 说明                                                                  |
| ----------- | ------------------------------------------------------------------- |
| `DIRECTORY` | Everything under it is uploaded, minus OS and Office noise (**必填**) |

| 选项                      | 说明                                                                          |
| ----------------------- | --------------------------------------------------------------------------- |
| `--name`, `-n`          | \<owner>/\<name>, or a bare name in your own namespace (**必填**)             |
| `--concurrency` `<int>` | Uploads in flight. The right number depends on the link, not on us (默认 `8`) |

### `sf volume rm`

Delete a volume, or files inside it

```bash theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
sf volume rm <NAME> [options]
```

| 参数     | 说明                        |
| ------ | ------------------------- |
| `NAME` | \<owner>/\<name> (**必填**) |

| 选项             | 说明                                                                              |
| -------------- | ------------------------------------------------------------------------------- |
| `--path`, `-p` | Delete these files or directories instead of the whole volume; repeatable (可重复) |
| `--yes`, `-y`  | Skip the confirmation                                                           |