Skip to content
pCon.configurator onlineDocumentation
Esc
↑↓navigate↵open⌘Jpreview
On this page

UUID

Synopsis

typedef string UUID;

An Universally Unique Identifier (UUID) is a 128-bit number that is meant to uniquely identify a resource over time and space1 without the need for central coordination in the generation of UUIDs.

The Online Configurator web service interfaces use strings to represent UUIDs. For this purpose UUIDs are formatted as 32 hexadecimal digits (using lower case letters), separated by hyphens (-) into five groups of 8, 4, 4, 4, and 12 digits.

In some contexts, a special null-UUID is required to indicate special semantics. Because the Online Configurator web service interfaces prohibit the use of null for entities of type string, either the empty string ("") or the string "00000000-0000-0000-0000-000000000000" may be used as a null-UUID. The Online Configurator always uses the second form for null-UUIDs returned by web service operations.

Footnotes

  1. In theory, due to the limited value range of about 3 x 1038, it could happen that the same UUID is accidentally used to identify different resources. In practice, however, this is quite unlikely and, given a reasonable generator for UUIDs, one can assume that one such identifier will never be unintentionally used for another resource. ↩