v1

Container Groups

Map a public route to a container group.

If you want your container group to be accessible from the Internet, you need to expose a public port and map a public route to it (corresponding IBM Containers command: cf ic route map -n <host> -d <domain> <group>). Every route consists of the host name and domain.

post/containers/groups/{name_or_id}/maproute

Path parameters

name_or_idstring required

The name or unique ID of the container group to which you want to map a public route. Run cf ic group list or call the GET /containers/groups endpoint to retrieve a list of container groups in your space.

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.

Request body

domainstring

The default system domain is mybluemix.net and already provides a SSL certificate, so you can access your container groups with HTTPS without any additional configuration.

hoststring

The host name of your container group, such as mycontainerhost. Do not include underscores (_) in the host name. The host and the domain combined form the full public route URL, such as http://mycontainerhost.mybluemix.net.

Response

OK. The route that you specified was successfully mapped to the container group.

Idstring

Unique identifier representing a specific container group.

Warningsstring[]

Warning information (Initial warning is empty).