Delete group (DELETE /v3/groups/{group_id})
Deletes the specified group.
If a multi-region user executes this API, a 403 error occurs.
A certain period of time is required for the synchronization of a deleted group with other regions in use.
Request headers
Content-type
Indicates the format of content defined in the MIME specification.
Specify application/json. (required)
| Data type | Cardinality |
|---|---|
| xsd:string | 1..1 |
Accept
Indicates the accept format defined in the MIME specification.
Specify application/json. (optional)
| Data type | Cardinality |
|---|---|
| xsd:string | 1..1 |
X-Auth-Token
Valid authentication token
| Data type | Cardinality |
|---|---|
| xsd:string | 1..1 |
Request parameters
group_id
Group ID (required)
| Data type | Cardinality | Parent element | Child element |
|---|---|---|---|
| xsd:string | 1..1 | None | None |
Response headers
HTTP status code
Returns the HTTP status code of the request.
One of the following values will be returned.
- 204:
- Normal completion
- 401:
- The token is invalid.
- 403:
- Authority to execute the requested action not possessed.
- 404:
- The specified group was not found.
- 500:
- An internal error occurred.
- 504:
- The processing was not completed within a certain period of time.
| Data type | Cardinality |
|---|---|
| int | 1..1 |