vrl 0.32.0

Vector Remap Language
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38

{
  "anchor": "random_bytes",
  "name": "random_bytes",
  "category": "Random",
  "description": "A cryptographically secure random number generator. Returns a string value containing the number of random bytes requested.",
  "arguments": [
    {
      "name": "length",
      "description": "The number of bytes to generate. Must not be larger than 64k.",
      "required": true,
      "type": [
        "integer"
      ]
    }
  ],
  "return": {
    "types": [
      "string"
    ]
  },
  "internal_failure_reasons": [
    "`length` is negative.",
    "`length` is larger than the maximum value (64k)."
  ],
  "examples": [
    {
      "title": "Generate random base 64 encoded bytes",
      "source": "encode_base64(random_bytes(16))",
      "return": "LNu0BBgUbh7XAlXbjSOomQ=="
    },
    {
      "title": "Generate 16 random bytes",
      "source": "length(random_bytes(16))",
      "return": 16
    }
  ],
  "pure": true
}