Unbind a public IP address from a container

https://containers-api.ng.bluemix.net/v3/containers/{name_or_id}/floating-ips/{ip}/unbind

This endpoint unbinds a public IP address from a container (corresponding IBM Containers command: `cf ic ip unbind <ip_adress> <container>`). The container that is unbound from the IP address will not be accessible from the internet anymore. The public IP address will be further allocated to the space and can be used to be bound to other containers.

Access Token Required: API Key

Path Parameters

name_or_idstringrequired

The name or ID of the container that you want to bind to the public IP address. Run the `cf ic ps` command or call the `GET /containers/json` endpoint to retrieve a list of containers in your space.

ipstringrequired

The public IP address that you want to unbind from your container. Note: After unbinding a public IP address, this IP address will still be allocated to the space and can be used to be bound to other containers.

Responses

{
  "success": true,
  "data": {
    "id": "abc123",
    "created_at": "2025-01-01T00:00:00Z"
  }
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request parameters"
  }
}

Language

CredentialsAPI KEY

API Key

Enter token below to save for later

cURL Request

1curl --request POST \
2     --url 'https://containers-api.ng.bluemix.net/v3/containers/{name_or_id}/floating-ips/{ip}/unbind' \
3     --header 'accept: application/json' \
4     --header 'content-type: application/json'

Response

1{
2  "success": true,
3  "data": {
4    "id": "abc123",
5    "created_at": "2025-01-01T00:00:00Z"
6  }
7}

POST