• Native OpenStack API

noa
  1. Help Center
  2. Native OpenStack API
  3. API Reference
  4. Keystone
  5. Group
  6. Deleting a User Group

Deleting a User Group

Function Description

This interface is used to delete a user group. -us_topic_0057845566_p4642693894134">This interface is used to delete a user group. This interface applies only to domain names in the Global zone.

URI

  • URI format

    DELETE /v3/groups/{group_id}

  • URI parameter description

    Parameter

    Mandatory

    Type

    Description

    group_id

    Yes

    String

    ID of a user group.

Request

  • Request header parameter description

    Parameter

    Mandatory

    Type

    Description

    Content-Type

    Yes

    String

    Fill application/json;charset=utf8 in this field.

    X-Auth-Token

    Yes

    String

    Valid token (the token of a user with the op_auth permission or the token of a user with the secu_admin permission under the current domain)

  • Sample request
    curl -i -k -H 'Accept:application/json' -H 'Content-Type:application/json;charset=utf8' -H "X-Auth-Token:$token" -X DELETE https://172.30.48.86:31943/v3/groups/aaec2abd4eba430fbf61541ffde76650

Response

  • Sample response (request successful)

    No response body.

  • Sample response (request failed)
{
    "error": {
        "message": "Could not find group: 57e36148f028402d8b023f2f895fc959",
        "code": 404,
        "title": "Not Found"
    }
}

Status Codes

Status Code

Description

204

The user group is deleted successfully.

400

The server failed to process the request.

401

You must enter a username and password to access the requested page.

403

You are forbidden to access the requested page.

404

The server could not find the requested page.