Where can I find the endpoint types definition or convention?

asked 2017-02-15 04:51:02 -0500

xiongyw gravatar image

updated 2017-02-15 04:54:00 -0500


During configuring ceilometer component, I found a item called "interface" in the [service_credentials] section/group. The help text tells the following:

# Type of endpoint in Identity service catalog to use for communication with
# OpenStack services. (string value)
# Allowed values: public, internal, admin, auth, publicURL, internalURL, adminURL
# Deprecated group/name - [service_credentials]/os_endpoint_type
#interface = public

It seems that the interface item is corresponding to the same-named field of keystone.endpoint table. By checking the content of the endpoint table, I see public/internal/admin rows (for keystone). Although I have a vague understanding of the differences among public/internal/admin interfaces, why there are also publicURL/internalURL/adminURL/auth? What's the differences among them all? Is there a document to describe that?

Thanks a lot,


edit retag flag offensive close merge delete


As a deployer, you can differentiate between public APIs, accessed from external apps; internal APIs e.g. when Nova communicates with Neutron; and APIs only for admin purposes. You can set up three different networks for the three access types. Or you can run all 3 API types on the same endpoint.

Bernd Bausch gravatar imageBernd Bausch ( 2017-02-15 06:16:11 -0500 )edit

One may be justified to say that this could be better documented. Since the above is my interpretation, I didn't label it as answer. YMMV.

Bernd Bausch gravatar imageBernd Bausch ( 2017-02-15 06:17:28 -0500 )edit

Thanks for your reply, Bernd. It seems my question was not very clear. I intended to know the difference between, for example, "internal" and "internalURL", "public" and "publicURL".

xiongyw gravatar imagexiongyw ( 2017-02-15 07:36:48 -0500 )edit