Updated on 2025-10-24 GMT+08:00

Delete Group

Function

After a group is created, you can delete it if it is no longer needed.

Authorization Information

Each account has all the permissions required to call all APIs, but IAM users must be assigned the required permissions.

  • If you are using role/policy-based authorization, see Permissions Policies and Supported Actions for details on the required permissions.
  • If you are using identity policy-based authorization, the following identity policy-based permissions are required.

    Action

    Access Level

    Resource Type (*: required)

    Condition Key

    Alias

    Dependencies

    coc:application:deleteGroup

    Write

    application *

    -

    -

    -

URI

DELETE /v1/groups/{id}

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

id

Yes

String

Definition:

Group ID.

Constraints:

N/A

Value range:

The value is a string. It contains 24 characters.

Default value:

N/A

Table 2 Query Parameters

Parameter

Mandatory

Type

Description

force_delete

No

Boolean

Definition:

Whether to forcibly delete static information about microservices.

Constraints:

N/A

Value range:

  • true: The group is forcibly deleted. The system directly clears the resources associated with the group and deletes the group.

  • false: Only resource groups that are not associated with any resource group can be deleted.

Default value:

N/A

Request Parameters

None

Response Parameters

Status code: 200

The group is deleted.

None

Example Requests

The group is deleted.

DELETE https://{Endpoint}/v1/groups/{id}?force_delete=true

Example Responses

None

Status Codes

Status Code

Description

200

The group is deleted.

Error Codes

See Error Codes.