v1

Single containers

Rename a single container

Change the current name of an existing single container that is identified by the container ID or name (corresponding IBM Containers command: cf ic rename <old_name> <new_name>).

post/containers/{name_or_id}/rename

Path parameters

name_or_idstring required

The unique identifier or name of the container that you want to rename. Run cf ic ps -a or call the GET /containers/json?all=true endpoint to review all containers in your space.

Query parameters

namestring required

The new name for the container. The characters in the name can include uppercase letters, lowercase letters, numbers, periods (.), underscores (_), or hyphens (-), but the name must start with a letter.

Headers

X-Auth-Tokenstring required

The Bluemix JSON web token that you receive when logging into Bluemix. Run cf oauth-token to retrieve your access token.

X-Auth-Project-Idstring required

The unique ID of your organization space where you want to create or work with your containers. Run cf space <space_name> --guid, where <space_name> is the name of your space, to retrieve your space ID.

Response

No Content. The request to rename the container has been initiated.