Updating a Security Group
PUT /v2/security_groups/:guid
Request
Route
PUT /v2/security_groups/085a9568-6d3b-4f27-9306-633f1443ba45
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). This field is limited to 16MB.
|
|
|
[
{
"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/085a9568-6d3b-4f27-9306-633f1443ba45" -d '{
"name": "new_name",
"rules": [
]
}' -X PUT \
-H "Authorization: bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoidWFhLWlkLTk5IiwiZW1haWwiOiJlbWFpbC03MEBzb21lZG9tYWluLmNvbSIsInNjb3BlIjpbImNsb3VkX2NvbnRyb2xsZXIuYWRtaW4iXSwiYXVkIjpbImNsb3VkX2NvbnRyb2xsZXIiXSwiZXhwIjoxNDUzODM3MjU5fQ.2pltP4f71h_7oKEsAIIJBv75ItGHolr62raSr_GWMG8" \
-H "Host: example.org" \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Cookie: "
Response
Status
201 Created
Body
{
"metadata": {
"guid": "085a9568-6d3b-4f27-9306-633f1443ba45",
"url": "/v2/security_groups/085a9568-6d3b-4f27-9306-633f1443ba45",
"created_at": "2016-01-19T19:40:58Z",
"updated_at": "2016-01-19T19:40:59Z"
},
"entity": {
"name": "new_name",
"rules": [
],
"running_default": false,
"staging_default": false,
"spaces_url": "/v2/security_groups/085a9568-6d3b-4f27-9306-633f1443ba45/spaces"
}
}
Headers