Set an instance’s security groups

Sets the complete list of security groups on one instance, by name: groups you list are added, groups you leave out are removed. List instances shows each instance’s current groups.

PUT /v1/instance/security-groups

curl -X PUT https://api.redu.cloud/v1/instance/security-groups \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"instanceId": "9b8a7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d", "securityGroups": ["default", "db-from-app"]}'

import requests
resp = requests.put(
    "https://api.redu.cloud/v1/instance/security-groups",
    headers={"x-api-key": "YOUR_API_KEY"},
    json={"instanceId": "9b8a7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d", "securityGroups": ["default", "db-from-app"]},
)
resp.raise_for_status()
print(resp.json()["security_groups"])

Answers once the instance has exactly these groups:

{ "message": "Security groups updated", "security_groups": ["default", "db-from-app"] }

An instance always keeps at least one group: with none, it gets no traffic at all.

When an instance gets a public URL, redu opens that port in the groups the instance has at that moment. A group you attach later does not have it: keep a group with the port, or add the rule to the new group first.

Errors

Errors use the API’s standard shape, { "error": { "code", "message", "hint"? } }.