Skip to content

Commit 99e5f55

Browse files
Improve UUID definition details
Extracted the most relevant information from Wikipedia and UUIDTools to be placed directly in this documentation.
1 parent 71faacb commit 99e5f55

File tree

1 file changed

+23
-5
lines changed

1 file changed

+23
-5
lines changed

content/en-us/reference/engine/classes/HttpService.yaml

Lines changed: 23 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -109,16 +109,34 @@ properties:
109109
methods:
110110
- name: HttpService:GenerateGUID
111111
summary: |
112-
Generates a UUID/GUID random string, optionally with curly braces.
112+
Generates a /GUID random string, optionally with curly braces.
113113
description: |
114-
This method randomly creates a universally unique identifier
115-
([UUID](https://en.wikipedia.org/wiki/Universally_unique_identifier))
114+
This method generates a **random universally unique identifier
115+
([UUID](https://en.wikipedia.org/wiki/Universally_unique_identifier))**
116116
string. The sixteen octets of a UUID are represented as 32 hexadecimal
117117
(base 16) digits, displayed in 5 groups separated by hyphens in the form
118118
`8-4-4-4-12` for a total of 36 characters, for example
119119
`123e4567-e89b-12d3-a456-426655440000`. The UUID specification used is
120-
[Version 4 (Random Data)](https://en.wikipedia.org/wiki/Universally_unique_identifier#Version_4_(random))
121-
Variant 1 (DCE 1.1, ISO/IEC 11578:1996).
120+
Version 4 (Random Data), Variant 1 (DCE 1.1, ISO/IEC 11578:1996).
121+
(See
122+
[UUIDTools](https://www.uuidtools.com/uuid-versions-explained#version-4)
123+
or
124+
[Wikipedia](https://en.wikipedia.org/wiki/Universally_unique_identifier#Version_4_(random))
125+
for more info.)
126+
127+
Version 4 UUIDs are the most commonly used due to their simplicity, as
128+
they are entirely randomly generated.
129+
This version does not have certain features that other UUID
130+
versions have, such as encoded timestamps, MAC addresses, or provide
131+
time-based sorting like [UUIDv7](https://uuid7.com/) or
132+
[ULID](https://github.com/ulid/spec)).
133+
134+
There are over 5.3 x 10<sup>36</sup> unique v4 UUIDs. The
135+
probability to find a duplicate within 103 trillion version-4 UUIDs is one
136+
in a billion. The number of random version-4 UUIDs which need to be
137+
generated in order to have a 50% probability of at least one collision is
138+
2.71 quintillion.
139+
([Source: Wikipedia](https://en.wikipedia.org/wiki/Universally_unique_identifier#Collisions))
122140
123141
The `wrapInCurlyBraces` argument determines whether the returned string is
124142
wrapped in curly braces (`{}`). For instance:

0 commit comments

Comments
 (0)