EMemma
Security groups

Delete security group

This method deletes a security group.

A security group refers to a set of rules that determine what network traffic is allowed to enter or leave a particular compute instance. It acts as a virtual firewall, controlling inbound and outbound traffic based on predefined rules.

Security groups operate based on predefined rules that allow traffic based on specified criteria, such as source IP address, destination IP address, port number, and protocol.

You can't delete a security group if any compute instance is using this security group. To delete a security group, first remove a compute instance from the security group using this method: POST /v1/security-groups/{securityGroupId}/instances

delete/v1/security-groups/{securityGroupId}

Request

  • Base URL
    https://api.emma.ms/external
  • Auth
    HTTP bearer

Path parameters

securityGroupIdinteger required

ID of the security group

Response

Successful operation

idinteger

Security group id

namestring

Security group name

createdByIdinteger

ID of the user who created the security group

createdByNamestring

Name of the user who created the security group

modifiedByIdinteger

ID of the user who last edited the security group

modifiedByNamestring

Name of the user who last edited the security group

createdAtstring

Date and time of the security group's creation

modifiedAtstring

Date and time of the security group's last update

synchronizationStatus'SYNCHRONIZED' | 'DESYNCHRONIZED' | 'SYNCHRONIZING'

Synchronization status of the security group. When you make changes in the rules the changes are propagated to the respective provider’s security groups. While this is happening the security groups have the status Synchronizing. After it is done the status changes to Synchronized. When another VM is added to the security group it will not be synchronized at first with the other VMs, therefore the status will be Desynchronized.

recomposingStatus'RECOMPOSED' | 'RECOMPOSING'

Recomposing status of the security group. When a new Virtual machine is added to the Security group it starts a synchronization process. During this process the Security group will have a Recomposing status.

lastModificationErrorDescriptionstring

Text of the error when the Security group was last edited

Example response

{
  "id": 5,
  "name": "default",
  "createdById": 123,
  "createdByName": "Jack Rur",
  "modifiedById": 123,
  "modifiedByName": "Jack Rur",
  "createdAt": "2023-08-31T09:26:19.347+00:00",
  "modifiedAt": "2023-08-31T09:26:19.347+00:00",
  "lastModificationErrorDescription": "Unable to update security group",
  "rules": [
    {
      "type": "Custom TCP",
      "policy": "ALLOW",
      "direction": "INBOUND",
      "protocol": "TCP",
      "ports": "30321",
      "ipRange": "0.0.0.0/0",
      "isMutable": true
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.