Add project_id attribute to group response

Add project_id attribute to group response

https://blueprints.launchpad.net/cinder/+spec/add-project-id-to-group-response

This blueprint proposes to add project_id attribute to the response body of list groups with detail and show group detail APIs.

Problem Description

Currently, the group show response doesn’t include project_id. It is an important parameter while differentiating between multiple groups in horizon.

Use Cases

As horizon is adding a tab for group listing with detail in the admin panel[1], it requires project_id as a response parameter from the groups API. It is similar to what is implemented in volumes and snapshots list.

Proposed change

This spec proposes to add project_id attribute to the response body of list groups with detail and show group detail APIs.

Add a new microverion API to add project_id attribute to the response body of list groups with detail and show group detail APIs:

  • List groups with detail GET /v3/{project_id}/groups/detail
  • Show group detail GET /v3/{project_id}/groups/{group_id}

Alternatives

None

REST API impact

Add a new microversion in Cinder API.

  • List groups with detail:

    GET /v3/{project_id}/groups/detail
    Response BODY:
    {
        "groups": [{
            ...
            "project_id": "7ccf4863071f44aeb8f141f65780c51b"
        }]
    }
    
  • Show group detail:

    GET /v3/{project_id}/groups/{group_id}
    Response BODY:
    {
        "groups": [{
            ...
            "project_id": "7ccf4863071f44aeb8f141f65780c51b"
        }]
    }
    

Calling this method shows project_id for a group. It is intended for admins to use, which is used to display the project_id to which the group belongs, and controlled by GROUP_ATTRIBUTES_POLICY.

Data model impact

None

Security impact

None

Notifications impact

None

Other end user impact

None

Performance Impact

None

Other deployer impact

None

Developer impact

None

Implementation

Assignee(s)

Primary assignee:
Rajat Dhasmana <rajatdhasmana@gmail.com>

Work Items

  • Add a new microversion.
  • Add project_id to the response body of list groups with detail and show group detail APIs.
  • Add the related unit tests.
  • Update related list groups with detail and show group detail api doc.

Dependencies

None

Testing

  • Unit-tests, tempest and other related test should be implemented

Documentation Impact

None

Creative Commons Attribution 3.0 License

Except where otherwise noted, this document is licensed under Creative Commons Attribution 3.0 License. See all OpenStack Legal Documents.

cinder-specs 0.0.1.dev506