Updating a Security Group
PUT /v2/security_groups/:guid
Request
Route
PUT /v2/security_groups/dbc8b22c-6beb-4e3f-aa02-760b3943746f
Parameters
| Name |
Description |
Valid Values |
Example Values |
|
guid
|
The guid of the Security Group
|
|
|
Body
| Name |
Description |
Default |
Valid Values |
Example Values |
|
name
|
The name of the security group.
|
|
|
|
|
rules
|
The egress rules for apps that belong to this security group.
A rule consists of a protocol (tcp,icmp,udp,all), destination CIDR or destination range,
port or port range (tcp,udp,all), type (control signal for icmp), code (control signal for icmp),
log (enables logging for the egress rule)
|
|
|
[
{
"protocol": "icmp",
"destination": "0.0.0.0/0",
"type": 0,
"code": 1
},
{
"protocol": "tcp",
"destination": "0.0.0.0/0",
"ports": "2048-3000",
"log": true
},
{
"protocol": "udp",
"destination": "0.0.0.0/0",
"ports": "53, 5353"
},
{
"protocol": "all",
"destination": "0.0.0.0/0"
}
]
|
|
space_guids
|
The list of associated spaces.
|
|
|
|
{
"name": "new_name",
"rules": [
]
}
Headers
cURL
curl "https://api.[your-domain.com]/v2/security_groups/dbc8b22c-6beb-4e3f-aa02-760b3943746f" -d '{
"name": "new_name",
"rules": [
]
}' -X PUT \
-H "Authorization: bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoidWFhLWlkLTI3NiIsImVtYWlsIjoiZW1haWwtMTkzQHNvbWVkb21haW4uY29tIiwic2NvcGUiOlsiY2xvdWRfY29udHJvbGxlci5hZG1pbiJdLCJhdWQiOlsiY2xvdWRfY29udHJvbGxlciJdLCJleHAiOjE0MzY4Mjk3OTF9.RHDhQrPtwzppsFiz43NPXzOUPkCVHZrZ64y0Lax-FdE" \
-H "Host: example.org" \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Cookie: "
Response
Status
201 Created
Body
{
"metadata": {
"guid": "dbc8b22c-6beb-4e3f-aa02-760b3943746f",
"url": "/v2/security_groups/dbc8b22c-6beb-4e3f-aa02-760b3943746f",
"created_at": "2015-07-06T23:23:06Z",
"updated_at": "2015-07-06T23:23:11Z"
},
"entity": {
"name": "new_name",
"rules": [
],
"running_default": false,
"staging_default": false,
"spaces_url": "/v2/security_groups/dbc8b22c-6beb-4e3f-aa02-760b3943746f/spaces"
}
}
Headers