v3 - `type` field unclear for create service operation

[Jamie Hannaford]

The create service operation (http://developer.openstack.org/api-ref-identity-v3.html#createService), has a required key called "type", but the accompanying description is really unclear.

"""
The MIME Media Type of the serialized policy blob.
"""

I have no idea what this means - could we have a more accessible and assumption-free definition? :)

[Anne Gentle (annegentle)]

Agreed. Subscribing some keystone devs.

[Dolph Mathews (dolph)]

From keystone's perspective, a policy blob can be based on any technology. oslo.policy's policy.json (and thus type="application/json") is the conventional solution in OpenStack today, but you might want to use an alternative policy engine which uses a policy language of a different type (for example, type="application/xacml+xml").

[Diane Fleming (diane-fleming)]

The error is in the "create policy" call. The "create service" call included the wrong "type" request parameter, which I corrected in addition to the create policy "type" parameter description.

[OpenStack Infra (hudson-openstack)]

Fix proposed to branch: master
Review: https://review.openstack.org/215841

[OpenStack Infra (hudson-openstack)]

Reviewed: https://review.openstack.org/215841
Committed: https://git.openstack.org/cgit/openstack/api-site/commit/?id=82fbf10b8b2a6e7ce7482b8b8335b9cfb5ef4e30
Submitter: Jenkins
Branch: master

commit 82fbf10b8b2a6e7ce7482b8b8335b9cfb5ef4e30
Author: Diane Fleming <email address hidden>
Date: Fri Aug 21 18:58:46 2015 -0500

    Fix "type" description for create service and create policy

    Change-Id: Iba2b245f6acd39c538647327f53e7473468733ac
    Closes-Bug: #1466882