Add names to list assignments

bp list-assignment-with-names

Optionally allow a caller of the list assignment API to ask for the entities returned to include their names.

Problem Description

The current list assignment API returns just the IDs of the entities. In general, for this to be useful, a client would typically have to convert these IDs into the names of the entities. It would be much more efficient if this could be done in the server as part of the API.

Proposed Change

Support an additional query parameter include_names to the list assignment API. If specified as true, then each of the entities returned will include the name. For entities who’s name is only unique within a domain, the domain name is also returned. The ability to list assignments by entity name is also supported.

While we could return all the attributes of each entity, given the potential large number of elements in a collection, we only include the name. The id is also still returned so that if the caller needs the full entity they can obtain it.

Alternatives

Leave things the way they are.

Data Model Impact

None

REST API Impact

None, other than to support the additional query parameter.

Security Impact

None

Notifications Impact

None

Other End User Impact

None

Performance Impact

There is obviously a potential performance impact for large collections. This will be minimized where possible with efficient SQL coding.

Other Deployer Impact

None

Developer Impact

None

Implementation

Assignee(s)

Primary assignee:

henry-nash

Work Items

  • Add manager/driver support for names

  • Add controller for names

  • Add keystoneclient library support for names

  • Add openstack cli support for names

Dependencies

None

Testing

None

Documentation Impact

Changes to user documentation to describe new API.

References

None