mirror of
https://github.com/podman-container-tools/podman.git
synced 2026-08-05 00:15:44 +00:00
d01b7ae534
Add a podman volume rename command, REST API endpoint, and bindings for renaming volumes. The rename updates both the VolumeConfig and VolumeState tables in a single transaction and moves the volume directory on disk, rolling back if the transaction fails. Renaming an anonymous volume converts it to a named volume. Volumes that are in use, mounted, or backed by a volume plugin or the image driver cannot be renamed. Fixes: #28189 Signed-off-by: MayorFaj <mayorfaj@gmail.com>
39 lines
933 B
Markdown
39 lines
933 B
Markdown
% podman-rename 1
|
|
|
|
## NAME
|
|
podman\-rename - Rename an existing container
|
|
|
|
## SYNOPSIS
|
|
**podman rename** *container* *newname*
|
|
|
|
**podman container rename** *container* *newname*
|
|
|
|
## DESCRIPTION
|
|
Rename changes the name of an existing container.
|
|
The old name is freed, and is available for use.
|
|
This command can be run on containers in any state.
|
|
However, running containers may not fully receive the effects until they are restarted - for example, a running container may still use the old name in its logs.
|
|
Use **podman volume rename** to rename volumes.
|
|
At present, pods cannot be renamed.
|
|
|
|
## OPTIONS
|
|
|
|
## EXAMPLES
|
|
|
|
Rename container with a given name.
|
|
```
|
|
$ podman rename oldContainer aNewName
|
|
```
|
|
|
|
Rename container with a given ID.
|
|
```
|
|
$ podman rename 717716c00a6b testcontainer
|
|
```
|
|
|
|
Create an alias for container with a given ID.
|
|
```
|
|
$ podman container rename 6e7514b47180 databaseCtr
|
|
```
|
|
|
|
## SEE ALSO
|
|
**[podman(1)](podman.1.md)**
|