Authorizations
API key for authentication. Make sure to include the word apikey
, followed by a single space and then your token.
Example: apikey 1234$abcdef
Path Parameters
Project ID
Region ID
Security group ID
Body
List of rules to create or delete
Name
"some_name"
Update key-value tags using JSON Merge Patch semantics (RFC 7386). Provide key-value pairs to add or update tags. Set tag values to null
to remove tags. Unspecified tags remain unchanged. Read-only tags are always preserved and cannot be modified.
Examples:
* Add/update tags: {'tags': {'environment': 'production', 'team': 'backend'}}
adds new tags or updates existing ones.
* Delete tags: {'tags': {'
old_tag': null}}
removes specific tags.
* Remove all tags: {'tags': null}
removes all user-managed tags (read-only tags are preserved).
* Partial update: {'tags': {'environment': 'staging'}}
only updates specified tags.
* Mixed operations: {'tags': {'environment': 'production', '
cost_center': 'engineering', '
deprecated_tag': null}}
adds/updates 'environment' and 'cost_center
' while removing 'deprecated_tag
', preserving other existing tags.
* Replace all: first delete existing tags with null values, then add new ones in the same request.
{
"my-tag": "my-tag-value",
"my-tag-to-remove": null
}
Response
Updated security group details
Datetime when the security group was created
"2019-06-18T11:56:16+0000"
Security group ID
"00000000-0000-4000-8000-000000000000"
Security group name
"my_security_group"
Project ID
1337
Region name
"Luxembourg 1"
Region ID
7
The number of revisions
1
Tags for a security group
[
{
"key": "my-tag",
"read_only": false,
"value": "my-tag-value"
}
]
Datetime when the security group was last updated
"2019-06-18T11:57:00+0000"
Security group description
"Some description"
Security group rules