api-sig/terms.md
2014-10-13 21:59:04 -04:00

27 lines
1.1 KiB
Markdown

Terms
=====
As Phil Karlson [once said](http://martinfowler.com/bliki/TwoHardThings.html):
> There are only two hard things in Computer Science: cache invalidation and
> naming things.
Over time, various terms and synonyms for those terms generate some
controversy, and different teams end up using different words to reference the
same object or resource. This document serves to record decisions that were
made regarding certain terms, and attempts to succinctly define each term.
* ***project*** vs. ***tenant***
***project*** shall be used to describe the concept of a group of OpenStack
users that share a common set of quotas. The older term ***tenant*** should
*not* be used in OpenStack REST APIs.
* ***server*** vs. ***instance***
***server*** shall be used to describe a virtual machine, a bare-metal machine,
or a containerized virtual machine that is used by OpenStack users for
compute purposes. The older term ***instance*** that is also by Amazon Web
Services EC2 API to describe a virtual machine, should *not* be used in
OpenStack REST APIs.