cribl-control-plane 0.0.13__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.


This version of cribl-control-plane might be problematic. Click here for more details.

Files changed (197) hide show
  1. cribl_control_plane/__init__.py +17 -0
  2. cribl_control_plane/_hooks/__init__.py +5 -0
  3. cribl_control_plane/_hooks/clientcredentials.py +211 -0
  4. cribl_control_plane/_hooks/registration.py +13 -0
  5. cribl_control_plane/_hooks/sdkhooks.py +81 -0
  6. cribl_control_plane/_hooks/types.py +112 -0
  7. cribl_control_plane/_version.py +15 -0
  8. cribl_control_plane/auth_sdk.py +184 -0
  9. cribl_control_plane/basesdk.py +358 -0
  10. cribl_control_plane/errors/__init__.py +60 -0
  11. cribl_control_plane/errors/apierror.py +38 -0
  12. cribl_control_plane/errors/criblcontrolplaneerror.py +26 -0
  13. cribl_control_plane/errors/error.py +24 -0
  14. cribl_control_plane/errors/healthstatus_error.py +38 -0
  15. cribl_control_plane/errors/no_response_error.py +13 -0
  16. cribl_control_plane/errors/responsevalidationerror.py +25 -0
  17. cribl_control_plane/health.py +166 -0
  18. cribl_control_plane/httpclient.py +126 -0
  19. cribl_control_plane/models/__init__.py +7305 -0
  20. cribl_control_plane/models/addhectokenrequest.py +34 -0
  21. cribl_control_plane/models/authtoken.py +13 -0
  22. cribl_control_plane/models/createinputhectokenbyidop.py +45 -0
  23. cribl_control_plane/models/createinputop.py +24 -0
  24. cribl_control_plane/models/createoutputop.py +24 -0
  25. cribl_control_plane/models/createoutputtestbyidop.py +46 -0
  26. cribl_control_plane/models/criblevent.py +14 -0
  27. cribl_control_plane/models/deleteinputbyidop.py +37 -0
  28. cribl_control_plane/models/deleteoutputbyidop.py +37 -0
  29. cribl_control_plane/models/deleteoutputpqbyidop.py +36 -0
  30. cribl_control_plane/models/getinputbyidop.py +37 -0
  31. cribl_control_plane/models/getoutputbyidop.py +37 -0
  32. cribl_control_plane/models/getoutputpqbyidop.py +36 -0
  33. cribl_control_plane/models/getoutputsamplesbyidop.py +37 -0
  34. cribl_control_plane/models/healthstatus.py +36 -0
  35. cribl_control_plane/models/input.py +199 -0
  36. cribl_control_plane/models/inputappscope.py +448 -0
  37. cribl_control_plane/models/inputazureblob.py +308 -0
  38. cribl_control_plane/models/inputcollection.py +208 -0
  39. cribl_control_plane/models/inputconfluentcloud.py +585 -0
  40. cribl_control_plane/models/inputcribl.py +165 -0
  41. cribl_control_plane/models/inputcriblhttp.py +341 -0
  42. cribl_control_plane/models/inputcribllakehttp.py +342 -0
  43. cribl_control_plane/models/inputcriblmetrics.py +175 -0
  44. cribl_control_plane/models/inputcribltcp.py +299 -0
  45. cribl_control_plane/models/inputcrowdstrike.py +410 -0
  46. cribl_control_plane/models/inputdatadogagent.py +364 -0
  47. cribl_control_plane/models/inputdatagen.py +180 -0
  48. cribl_control_plane/models/inputedgeprometheus.py +551 -0
  49. cribl_control_plane/models/inputelastic.py +494 -0
  50. cribl_control_plane/models/inputeventhub.py +360 -0
  51. cribl_control_plane/models/inputexec.py +213 -0
  52. cribl_control_plane/models/inputfile.py +259 -0
  53. cribl_control_plane/models/inputfirehose.py +341 -0
  54. cribl_control_plane/models/inputgooglepubsub.py +247 -0
  55. cribl_control_plane/models/inputgrafana_union.py +1247 -0
  56. cribl_control_plane/models/inputhttp.py +403 -0
  57. cribl_control_plane/models/inputhttpraw.py +407 -0
  58. cribl_control_plane/models/inputjournalfiles.py +208 -0
  59. cribl_control_plane/models/inputkafka.py +581 -0
  60. cribl_control_plane/models/inputkinesis.py +363 -0
  61. cribl_control_plane/models/inputkubeevents.py +182 -0
  62. cribl_control_plane/models/inputkubelogs.py +256 -0
  63. cribl_control_plane/models/inputkubemetrics.py +233 -0
  64. cribl_control_plane/models/inputloki.py +468 -0
  65. cribl_control_plane/models/inputmetrics.py +290 -0
  66. cribl_control_plane/models/inputmodeldriventelemetry.py +274 -0
  67. cribl_control_plane/models/inputmsk.py +654 -0
  68. cribl_control_plane/models/inputnetflow.py +224 -0
  69. cribl_control_plane/models/inputoffice365mgmt.py +384 -0
  70. cribl_control_plane/models/inputoffice365msgtrace.py +449 -0
  71. cribl_control_plane/models/inputoffice365service.py +377 -0
  72. cribl_control_plane/models/inputopentelemetry.py +516 -0
  73. cribl_control_plane/models/inputprometheus.py +464 -0
  74. cribl_control_plane/models/inputprometheusrw.py +470 -0
  75. cribl_control_plane/models/inputrawudp.py +207 -0
  76. cribl_control_plane/models/inputs3.py +416 -0
  77. cribl_control_plane/models/inputs3inventory.py +440 -0
  78. cribl_control_plane/models/inputsecuritylake.py +425 -0
  79. cribl_control_plane/models/inputsnmp.py +274 -0
  80. cribl_control_plane/models/inputsplunk.py +387 -0
  81. cribl_control_plane/models/inputsplunkhec.py +478 -0
  82. cribl_control_plane/models/inputsplunksearch.py +537 -0
  83. cribl_control_plane/models/inputsqs.py +320 -0
  84. cribl_control_plane/models/inputsyslog_union.py +759 -0
  85. cribl_control_plane/models/inputsystemmetrics.py +533 -0
  86. cribl_control_plane/models/inputsystemstate.py +417 -0
  87. cribl_control_plane/models/inputtcp.py +359 -0
  88. cribl_control_plane/models/inputtcpjson.py +334 -0
  89. cribl_control_plane/models/inputwef.py +498 -0
  90. cribl_control_plane/models/inputwindowsmetrics.py +457 -0
  91. cribl_control_plane/models/inputwineventlogs.py +222 -0
  92. cribl_control_plane/models/inputwiz.py +334 -0
  93. cribl_control_plane/models/inputzscalerhec.py +439 -0
  94. cribl_control_plane/models/listinputop.py +24 -0
  95. cribl_control_plane/models/listoutputop.py +24 -0
  96. cribl_control_plane/models/logininfo.py +16 -0
  97. cribl_control_plane/models/output.py +229 -0
  98. cribl_control_plane/models/outputazureblob.py +471 -0
  99. cribl_control_plane/models/outputazuredataexplorer.py +660 -0
  100. cribl_control_plane/models/outputazureeventhub.py +321 -0
  101. cribl_control_plane/models/outputazurelogs.py +386 -0
  102. cribl_control_plane/models/outputclickhouse.py +650 -0
  103. cribl_control_plane/models/outputcloudwatch.py +273 -0
  104. cribl_control_plane/models/outputconfluentcloud.py +591 -0
  105. cribl_control_plane/models/outputcriblhttp.py +494 -0
  106. cribl_control_plane/models/outputcribllake.py +396 -0
  107. cribl_control_plane/models/outputcribltcp.py +387 -0
  108. cribl_control_plane/models/outputcrowdstrikenextgensiem.py +410 -0
  109. cribl_control_plane/models/outputdatadog.py +472 -0
  110. cribl_control_plane/models/outputdataset.py +437 -0
  111. cribl_control_plane/models/outputdefault.py +55 -0
  112. cribl_control_plane/models/outputdevnull.py +50 -0
  113. cribl_control_plane/models/outputdiskspool.py +89 -0
  114. cribl_control_plane/models/outputdls3.py +560 -0
  115. cribl_control_plane/models/outputdynatracehttp.py +454 -0
  116. cribl_control_plane/models/outputdynatraceotlp.py +486 -0
  117. cribl_control_plane/models/outputelastic.py +494 -0
  118. cribl_control_plane/models/outputelasticcloud.py +407 -0
  119. cribl_control_plane/models/outputexabeam.py +297 -0
  120. cribl_control_plane/models/outputfilesystem.py +357 -0
  121. cribl_control_plane/models/outputgooglechronicle.py +486 -0
  122. cribl_control_plane/models/outputgooglecloudlogging.py +557 -0
  123. cribl_control_plane/models/outputgooglecloudstorage.py +499 -0
  124. cribl_control_plane/models/outputgooglepubsub.py +274 -0
  125. cribl_control_plane/models/outputgrafanacloud_union.py +1024 -0
  126. cribl_control_plane/models/outputgraphite.py +225 -0
  127. cribl_control_plane/models/outputhoneycomb.py +369 -0
  128. cribl_control_plane/models/outputhumiohec.py +389 -0
  129. cribl_control_plane/models/outputinfluxdb.py +523 -0
  130. cribl_control_plane/models/outputkafka.py +581 -0
  131. cribl_control_plane/models/outputkinesis.py +312 -0
  132. cribl_control_plane/models/outputloki.py +425 -0
  133. cribl_control_plane/models/outputminio.py +512 -0
  134. cribl_control_plane/models/outputmsk.py +654 -0
  135. cribl_control_plane/models/outputnetflow.py +80 -0
  136. cribl_control_plane/models/outputnewrelic.py +424 -0
  137. cribl_control_plane/models/outputnewrelicevents.py +401 -0
  138. cribl_control_plane/models/outputopentelemetry.py +669 -0
  139. cribl_control_plane/models/outputprometheus.py +485 -0
  140. cribl_control_plane/models/outputring.py +121 -0
  141. cribl_control_plane/models/outputrouter.py +83 -0
  142. cribl_control_plane/models/outputs3.py +556 -0
  143. cribl_control_plane/models/outputsamplesresponse.py +14 -0
  144. cribl_control_plane/models/outputsecuritylake.py +505 -0
  145. cribl_control_plane/models/outputsentinel.py +488 -0
  146. cribl_control_plane/models/outputsentineloneaisiem.py +505 -0
  147. cribl_control_plane/models/outputservicenow.py +543 -0
  148. cribl_control_plane/models/outputsignalfx.py +369 -0
  149. cribl_control_plane/models/outputsnmp.py +80 -0
  150. cribl_control_plane/models/outputsns.py +274 -0
  151. cribl_control_plane/models/outputsplunk.py +383 -0
  152. cribl_control_plane/models/outputsplunkhec.py +434 -0
  153. cribl_control_plane/models/outputsplunklb.py +558 -0
  154. cribl_control_plane/models/outputsqs.py +328 -0
  155. cribl_control_plane/models/outputstatsd.py +224 -0
  156. cribl_control_plane/models/outputstatsdext.py +225 -0
  157. cribl_control_plane/models/outputsumologic.py +378 -0
  158. cribl_control_plane/models/outputsyslog.py +415 -0
  159. cribl_control_plane/models/outputtcpjson.py +413 -0
  160. cribl_control_plane/models/outputtestrequest.py +15 -0
  161. cribl_control_plane/models/outputtestresponse.py +29 -0
  162. cribl_control_plane/models/outputwavefront.py +369 -0
  163. cribl_control_plane/models/outputwebhook.py +689 -0
  164. cribl_control_plane/models/outputxsiam.py +415 -0
  165. cribl_control_plane/models/schemeclientoauth.py +24 -0
  166. cribl_control_plane/models/security.py +36 -0
  167. cribl_control_plane/models/updatehectokenrequest.py +31 -0
  168. cribl_control_plane/models/updateinputbyidop.py +44 -0
  169. cribl_control_plane/models/updateinputhectokenbyidandtokenop.py +52 -0
  170. cribl_control_plane/models/updateoutputbyidop.py +44 -0
  171. cribl_control_plane/outputs.py +1615 -0
  172. cribl_control_plane/py.typed +1 -0
  173. cribl_control_plane/sdk.py +164 -0
  174. cribl_control_plane/sdkconfiguration.py +36 -0
  175. cribl_control_plane/sources.py +1355 -0
  176. cribl_control_plane/types/__init__.py +21 -0
  177. cribl_control_plane/types/basemodel.py +39 -0
  178. cribl_control_plane/utils/__init__.py +187 -0
  179. cribl_control_plane/utils/annotations.py +55 -0
  180. cribl_control_plane/utils/datetimes.py +23 -0
  181. cribl_control_plane/utils/enums.py +74 -0
  182. cribl_control_plane/utils/eventstreaming.py +238 -0
  183. cribl_control_plane/utils/forms.py +223 -0
  184. cribl_control_plane/utils/headers.py +136 -0
  185. cribl_control_plane/utils/logger.py +27 -0
  186. cribl_control_plane/utils/metadata.py +118 -0
  187. cribl_control_plane/utils/queryparams.py +205 -0
  188. cribl_control_plane/utils/requestbodies.py +66 -0
  189. cribl_control_plane/utils/retries.py +217 -0
  190. cribl_control_plane/utils/security.py +207 -0
  191. cribl_control_plane/utils/serializers.py +249 -0
  192. cribl_control_plane/utils/unmarshal_json_response.py +24 -0
  193. cribl_control_plane/utils/url.py +155 -0
  194. cribl_control_plane/utils/values.py +137 -0
  195. cribl_control_plane-0.0.13.dist-info/METADATA +489 -0
  196. cribl_control_plane-0.0.13.dist-info/RECORD +197 -0
  197. cribl_control_plane-0.0.13.dist-info/WHEEL +4 -0
@@ -0,0 +1,415 @@
1
+ """Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
2
+
3
+ from __future__ import annotations
4
+ from cribl_control_plane import utils
5
+ from cribl_control_plane.types import BaseModel
6
+ from cribl_control_plane.utils import validate_open_enum
7
+ from enum import Enum
8
+ import pydantic
9
+ from pydantic.functional_validators import PlainValidator
10
+ from typing import Any, List, Optional
11
+ from typing_extensions import Annotated, NotRequired, TypedDict
12
+
13
+
14
+ class OutputXsiamType(str, Enum, metaclass=utils.OpenEnumMeta):
15
+ XSIAM = "xsiam"
16
+
17
+
18
+ class OutputXsiamExtraHTTPHeaderTypedDict(TypedDict):
19
+ value: str
20
+ name: NotRequired[str]
21
+
22
+
23
+ class OutputXsiamExtraHTTPHeader(BaseModel):
24
+ value: str
25
+
26
+ name: Optional[str] = None
27
+
28
+
29
+ class OutputXsiamFailedRequestLoggingMode(str, Enum, metaclass=utils.OpenEnumMeta):
30
+ r"""Data to log when a request fails. All headers are redacted by default, unless listed as safe headers below."""
31
+
32
+ PAYLOAD = "payload"
33
+ PAYLOAD_AND_HEADERS = "payloadAndHeaders"
34
+ NONE = "none"
35
+
36
+
37
+ class OutputXsiamAuthenticationMethod(str, Enum, metaclass=utils.OpenEnumMeta):
38
+ r"""Enter a token directly, or provide a secret referencing a token"""
39
+
40
+ TOKEN = "token"
41
+ SECRET = "secret"
42
+
43
+
44
+ class OutputXsiamResponseRetrySettingTypedDict(TypedDict):
45
+ http_status: float
46
+ r"""The HTTP response status code that will trigger retries"""
47
+ initial_backoff: NotRequired[float]
48
+ r"""How long, in milliseconds, Cribl Stream should wait before initiating backoff. Maximum interval is 600,000 ms (10 minutes)."""
49
+ backoff_rate: NotRequired[float]
50
+ r"""Base for exponential backoff. A value of 2 (default) means Cribl Stream will retry after 2 seconds, then 4 seconds, then 8 seconds, etc."""
51
+ max_backoff: NotRequired[float]
52
+ r"""The maximum backoff interval, in milliseconds, Cribl Stream should apply. Default (and minimum) is 10,000 ms (10 seconds); maximum is 180,000 ms (180 seconds)."""
53
+
54
+
55
+ class OutputXsiamResponseRetrySetting(BaseModel):
56
+ http_status: Annotated[float, pydantic.Field(alias="httpStatus")]
57
+ r"""The HTTP response status code that will trigger retries"""
58
+
59
+ initial_backoff: Annotated[
60
+ Optional[float], pydantic.Field(alias="initialBackoff")
61
+ ] = 1000
62
+ r"""How long, in milliseconds, Cribl Stream should wait before initiating backoff. Maximum interval is 600,000 ms (10 minutes)."""
63
+
64
+ backoff_rate: Annotated[Optional[float], pydantic.Field(alias="backoffRate")] = 2
65
+ r"""Base for exponential backoff. A value of 2 (default) means Cribl Stream will retry after 2 seconds, then 4 seconds, then 8 seconds, etc."""
66
+
67
+ max_backoff: Annotated[Optional[float], pydantic.Field(alias="maxBackoff")] = 10000
68
+ r"""The maximum backoff interval, in milliseconds, Cribl Stream should apply. Default (and minimum) is 10,000 ms (10 seconds); maximum is 180,000 ms (180 seconds)."""
69
+
70
+
71
+ class OutputXsiamTimeoutRetrySettingsTypedDict(TypedDict):
72
+ timeout_retry: NotRequired[bool]
73
+ initial_backoff: NotRequired[float]
74
+ r"""How long, in milliseconds, Cribl Stream should wait before initiating backoff. Maximum interval is 600,000 ms (10 minutes)."""
75
+ backoff_rate: NotRequired[float]
76
+ r"""Base for exponential backoff. A value of 2 (default) means Cribl Stream will retry after 2 seconds, then 4 seconds, then 8 seconds, etc."""
77
+ max_backoff: NotRequired[float]
78
+ r"""The maximum backoff interval, in milliseconds, Cribl Stream should apply. Default (and minimum) is 10,000 ms (10 seconds); maximum is 180,000 ms (180 seconds)."""
79
+
80
+
81
+ class OutputXsiamTimeoutRetrySettings(BaseModel):
82
+ timeout_retry: Annotated[Optional[bool], pydantic.Field(alias="timeoutRetry")] = (
83
+ False
84
+ )
85
+
86
+ initial_backoff: Annotated[
87
+ Optional[float], pydantic.Field(alias="initialBackoff")
88
+ ] = 1000
89
+ r"""How long, in milliseconds, Cribl Stream should wait before initiating backoff. Maximum interval is 600,000 ms (10 minutes)."""
90
+
91
+ backoff_rate: Annotated[Optional[float], pydantic.Field(alias="backoffRate")] = 2
92
+ r"""Base for exponential backoff. A value of 2 (default) means Cribl Stream will retry after 2 seconds, then 4 seconds, then 8 seconds, etc."""
93
+
94
+ max_backoff: Annotated[Optional[float], pydantic.Field(alias="maxBackoff")] = 10000
95
+ r"""The maximum backoff interval, in milliseconds, Cribl Stream should apply. Default (and minimum) is 10,000 ms (10 seconds); maximum is 180,000 ms (180 seconds)."""
96
+
97
+
98
+ class OutputXsiamBackpressureBehavior(str, Enum, metaclass=utils.OpenEnumMeta):
99
+ r"""How to handle events when all receivers are exerting backpressure"""
100
+
101
+ BLOCK = "block"
102
+ DROP = "drop"
103
+ QUEUE = "queue"
104
+
105
+
106
+ class OutputXsiamURLTypedDict(TypedDict):
107
+ url: Any
108
+ weight: NotRequired[float]
109
+ r"""Assign a weight (>0) to each endpoint to indicate its traffic-handling capability"""
110
+
111
+
112
+ class OutputXsiamURL(BaseModel):
113
+ url: Any
114
+
115
+ weight: Optional[float] = 1
116
+ r"""Assign a weight (>0) to each endpoint to indicate its traffic-handling capability"""
117
+
118
+
119
+ class OutputXsiamCompression(str, Enum, metaclass=utils.OpenEnumMeta):
120
+ r"""Codec to use to compress the persisted data"""
121
+
122
+ NONE = "none"
123
+ GZIP = "gzip"
124
+
125
+
126
+ class OutputXsiamQueueFullBehavior(str, Enum, metaclass=utils.OpenEnumMeta):
127
+ r"""How to handle events when the queue is exerting backpressure (full capacity or low disk). 'Block' is the same behavior as non-PQ blocking. 'Drop new data' throws away incoming data, while leaving the contents of the PQ unchanged."""
128
+
129
+ BLOCK = "block"
130
+ DROP = "drop"
131
+
132
+
133
+ class OutputXsiamMode(str, Enum, metaclass=utils.OpenEnumMeta):
134
+ r"""In Error mode, PQ writes events to the filesystem if the Destination is unavailable. In Backpressure mode, PQ writes events to the filesystem when it detects backpressure from the Destination. In Always On mode, PQ always writes events to the filesystem."""
135
+
136
+ ERROR = "error"
137
+ BACKPRESSURE = "backpressure"
138
+ ALWAYS = "always"
139
+
140
+
141
+ class OutputXsiamPqControlsTypedDict(TypedDict):
142
+ pass
143
+
144
+
145
+ class OutputXsiamPqControls(BaseModel):
146
+ pass
147
+
148
+
149
+ class OutputXsiamTypedDict(TypedDict):
150
+ id: str
151
+ r"""Unique ID for this output"""
152
+ type: OutputXsiamType
153
+ pipeline: NotRequired[str]
154
+ r"""Pipeline to process data before sending out to this output"""
155
+ system_fields: NotRequired[List[str]]
156
+ r"""Fields to automatically add to events, such as cribl_pipe. Supports wildcards."""
157
+ environment: NotRequired[str]
158
+ r"""Optionally, enable this config only on a specified Git branch. If empty, will be enabled everywhere."""
159
+ streamtags: NotRequired[List[str]]
160
+ r"""Tags for filtering and grouping in @{product}"""
161
+ load_balanced: NotRequired[bool]
162
+ r"""Enable for optimal performance. Even if you have one hostname, it can expand to multiple IPs. If disabled, consider enabling round-robin DNS."""
163
+ concurrency: NotRequired[float]
164
+ r"""Maximum number of ongoing requests before blocking"""
165
+ max_payload_size_kb: NotRequired[float]
166
+ r"""Maximum size, in KB, of the request body"""
167
+ max_payload_events: NotRequired[float]
168
+ r"""Maximum number of events to include in the request body. Default is 0 (unlimited)."""
169
+ reject_unauthorized: NotRequired[bool]
170
+ r"""Reject certificates not authorized by a CA in the CA certificate path or by another trusted CA (such as the system's).
171
+ Enabled by default. When this setting is also present in TLS Settings (Client Side),
172
+ that value will take precedence.
173
+ """
174
+ timeout_sec: NotRequired[float]
175
+ r"""Amount of time, in seconds, to wait for a request to complete before canceling it"""
176
+ flush_period_sec: NotRequired[float]
177
+ r"""Maximum time between requests. Small values could cause the payload size to be smaller than the configured Body size limit."""
178
+ extra_http_headers: NotRequired[List[OutputXsiamExtraHTTPHeaderTypedDict]]
179
+ r"""Headers to add to all events"""
180
+ failed_request_logging_mode: NotRequired[OutputXsiamFailedRequestLoggingMode]
181
+ r"""Data to log when a request fails. All headers are redacted by default, unless listed as safe headers below."""
182
+ safe_headers: NotRequired[List[str]]
183
+ r"""List of headers that are safe to log in plain text"""
184
+ auth_type: NotRequired[OutputXsiamAuthenticationMethod]
185
+ r"""Enter a token directly, or provide a secret referencing a token"""
186
+ response_retry_settings: NotRequired[List[OutputXsiamResponseRetrySettingTypedDict]]
187
+ r"""Automatically retry after unsuccessful response status codes, such as 429 (Too Many Requests) or 503 (Service Unavailable)"""
188
+ timeout_retry_settings: NotRequired[OutputXsiamTimeoutRetrySettingsTypedDict]
189
+ response_honor_retry_after_header: NotRequired[bool]
190
+ r"""Honor any Retry-After header that specifies a delay (in seconds) no longer than 180 seconds after the retry request. @{product} limits the delay to 180 seconds, even if the Retry-After header specifies a longer delay. When enabled, takes precedence over user-configured retry options. When disabled, all Retry-After headers are ignored."""
191
+ throttle_rate_req_per_sec: NotRequired[int]
192
+ r"""Maximum number of requests to limit to per second"""
193
+ on_backpressure: NotRequired[OutputXsiamBackpressureBehavior]
194
+ r"""How to handle events when all receivers are exerting backpressure"""
195
+ total_memory_limit_kb: NotRequired[float]
196
+ r"""Maximum total size of the batches waiting to be sent. If left blank, defaults to 5 times the max body size (if set). If 0, no limit is enforced."""
197
+ description: NotRequired[str]
198
+ url: NotRequired[str]
199
+ r"""XSIAM endpoint URL to send events to, such as https://api-{tenant external URL}/logs/v1/event"""
200
+ use_round_robin_dns: NotRequired[bool]
201
+ r"""Enable round-robin DNS lookup. When a DNS server returns multiple addresses, @{product} will cycle through them in the order returned. For optimal performance, consider enabling this setting for non-load balanced destinations."""
202
+ exclude_self: NotRequired[bool]
203
+ r"""Exclude all IPs of the current host from the list of any resolved hostnames"""
204
+ urls: NotRequired[List[OutputXsiamURLTypedDict]]
205
+ dns_resolve_period_sec: NotRequired[float]
206
+ r"""The interval in which to re-resolve any hostnames and pick up destinations from A records"""
207
+ load_balance_stats_period_sec: NotRequired[float]
208
+ r"""How far back in time to keep traffic stats for load balancing purposes"""
209
+ token: NotRequired[str]
210
+ r"""XSIAM authentication token"""
211
+ text_secret: NotRequired[str]
212
+ r"""Select or create a stored text secret"""
213
+ pq_max_file_size: NotRequired[str]
214
+ r"""The maximum size to store in each queue file before closing and optionally compressing (KB, MB, etc.)"""
215
+ pq_max_size: NotRequired[str]
216
+ r"""The maximum disk space that the queue can consume (as an average per Worker Process) before queueing stops. Enter a numeral with units of KB, MB, etc."""
217
+ pq_path: NotRequired[str]
218
+ r"""The location for the persistent queue files. To this field's value, the system will append: /<worker-id>/<output-id>."""
219
+ pq_compress: NotRequired[OutputXsiamCompression]
220
+ r"""Codec to use to compress the persisted data"""
221
+ pq_on_backpressure: NotRequired[OutputXsiamQueueFullBehavior]
222
+ r"""How to handle events when the queue is exerting backpressure (full capacity or low disk). 'Block' is the same behavior as non-PQ blocking. 'Drop new data' throws away incoming data, while leaving the contents of the PQ unchanged."""
223
+ pq_mode: NotRequired[OutputXsiamMode]
224
+ r"""In Error mode, PQ writes events to the filesystem if the Destination is unavailable. In Backpressure mode, PQ writes events to the filesystem when it detects backpressure from the Destination. In Always On mode, PQ always writes events to the filesystem."""
225
+ pq_controls: NotRequired[OutputXsiamPqControlsTypedDict]
226
+
227
+
228
+ class OutputXsiam(BaseModel):
229
+ id: str
230
+ r"""Unique ID for this output"""
231
+
232
+ type: Annotated[OutputXsiamType, PlainValidator(validate_open_enum(False))]
233
+
234
+ pipeline: Optional[str] = None
235
+ r"""Pipeline to process data before sending out to this output"""
236
+
237
+ system_fields: Annotated[
238
+ Optional[List[str]], pydantic.Field(alias="systemFields")
239
+ ] = None
240
+ r"""Fields to automatically add to events, such as cribl_pipe. Supports wildcards."""
241
+
242
+ environment: Optional[str] = None
243
+ r"""Optionally, enable this config only on a specified Git branch. If empty, will be enabled everywhere."""
244
+
245
+ streamtags: Optional[List[str]] = None
246
+ r"""Tags for filtering and grouping in @{product}"""
247
+
248
+ load_balanced: Annotated[Optional[bool], pydantic.Field(alias="loadBalanced")] = (
249
+ False
250
+ )
251
+ r"""Enable for optimal performance. Even if you have one hostname, it can expand to multiple IPs. If disabled, consider enabling round-robin DNS."""
252
+
253
+ concurrency: Optional[float] = 5
254
+ r"""Maximum number of ongoing requests before blocking"""
255
+
256
+ max_payload_size_kb: Annotated[
257
+ Optional[float], pydantic.Field(alias="maxPayloadSizeKB")
258
+ ] = 10000
259
+ r"""Maximum size, in KB, of the request body"""
260
+
261
+ max_payload_events: Annotated[
262
+ Optional[float], pydantic.Field(alias="maxPayloadEvents")
263
+ ] = 0
264
+ r"""Maximum number of events to include in the request body. Default is 0 (unlimited)."""
265
+
266
+ reject_unauthorized: Annotated[
267
+ Optional[bool], pydantic.Field(alias="rejectUnauthorized")
268
+ ] = True
269
+ r"""Reject certificates not authorized by a CA in the CA certificate path or by another trusted CA (such as the system's).
270
+ Enabled by default. When this setting is also present in TLS Settings (Client Side),
271
+ that value will take precedence.
272
+ """
273
+
274
+ timeout_sec: Annotated[Optional[float], pydantic.Field(alias="timeoutSec")] = 30
275
+ r"""Amount of time, in seconds, to wait for a request to complete before canceling it"""
276
+
277
+ flush_period_sec: Annotated[
278
+ Optional[float], pydantic.Field(alias="flushPeriodSec")
279
+ ] = 1
280
+ r"""Maximum time between requests. Small values could cause the payload size to be smaller than the configured Body size limit."""
281
+
282
+ extra_http_headers: Annotated[
283
+ Optional[List[OutputXsiamExtraHTTPHeader]],
284
+ pydantic.Field(alias="extraHttpHeaders"),
285
+ ] = None
286
+ r"""Headers to add to all events"""
287
+
288
+ failed_request_logging_mode: Annotated[
289
+ Annotated[
290
+ Optional[OutputXsiamFailedRequestLoggingMode],
291
+ PlainValidator(validate_open_enum(False)),
292
+ ],
293
+ pydantic.Field(alias="failedRequestLoggingMode"),
294
+ ] = OutputXsiamFailedRequestLoggingMode.NONE
295
+ r"""Data to log when a request fails. All headers are redacted by default, unless listed as safe headers below."""
296
+
297
+ safe_headers: Annotated[
298
+ Optional[List[str]], pydantic.Field(alias="safeHeaders")
299
+ ] = None
300
+ r"""List of headers that are safe to log in plain text"""
301
+
302
+ auth_type: Annotated[
303
+ Annotated[
304
+ Optional[OutputXsiamAuthenticationMethod],
305
+ PlainValidator(validate_open_enum(False)),
306
+ ],
307
+ pydantic.Field(alias="authType"),
308
+ ] = OutputXsiamAuthenticationMethod.TOKEN
309
+ r"""Enter a token directly, or provide a secret referencing a token"""
310
+
311
+ response_retry_settings: Annotated[
312
+ Optional[List[OutputXsiamResponseRetrySetting]],
313
+ pydantic.Field(alias="responseRetrySettings"),
314
+ ] = None
315
+ r"""Automatically retry after unsuccessful response status codes, such as 429 (Too Many Requests) or 503 (Service Unavailable)"""
316
+
317
+ timeout_retry_settings: Annotated[
318
+ Optional[OutputXsiamTimeoutRetrySettings],
319
+ pydantic.Field(alias="timeoutRetrySettings"),
320
+ ] = None
321
+
322
+ response_honor_retry_after_header: Annotated[
323
+ Optional[bool], pydantic.Field(alias="responseHonorRetryAfterHeader")
324
+ ] = False
325
+ r"""Honor any Retry-After header that specifies a delay (in seconds) no longer than 180 seconds after the retry request. @{product} limits the delay to 180 seconds, even if the Retry-After header specifies a longer delay. When enabled, takes precedence over user-configured retry options. When disabled, all Retry-After headers are ignored."""
326
+
327
+ throttle_rate_req_per_sec: Annotated[
328
+ Optional[int], pydantic.Field(alias="throttleRateReqPerSec")
329
+ ] = 400
330
+ r"""Maximum number of requests to limit to per second"""
331
+
332
+ on_backpressure: Annotated[
333
+ Annotated[
334
+ Optional[OutputXsiamBackpressureBehavior],
335
+ PlainValidator(validate_open_enum(False)),
336
+ ],
337
+ pydantic.Field(alias="onBackpressure"),
338
+ ] = OutputXsiamBackpressureBehavior.BLOCK
339
+ r"""How to handle events when all receivers are exerting backpressure"""
340
+
341
+ total_memory_limit_kb: Annotated[
342
+ Optional[float], pydantic.Field(alias="totalMemoryLimitKB")
343
+ ] = None
344
+ r"""Maximum total size of the batches waiting to be sent. If left blank, defaults to 5 times the max body size (if set). If 0, no limit is enforced."""
345
+
346
+ description: Optional[str] = None
347
+
348
+ url: Optional[str] = "http://localhost:8088/logs/v1/event"
349
+ r"""XSIAM endpoint URL to send events to, such as https://api-{tenant external URL}/logs/v1/event"""
350
+
351
+ use_round_robin_dns: Annotated[
352
+ Optional[bool], pydantic.Field(alias="useRoundRobinDns")
353
+ ] = False
354
+ r"""Enable round-robin DNS lookup. When a DNS server returns multiple addresses, @{product} will cycle through them in the order returned. For optimal performance, consider enabling this setting for non-load balanced destinations."""
355
+
356
+ exclude_self: Annotated[Optional[bool], pydantic.Field(alias="excludeSelf")] = False
357
+ r"""Exclude all IPs of the current host from the list of any resolved hostnames"""
358
+
359
+ urls: Optional[List[OutputXsiamURL]] = None
360
+
361
+ dns_resolve_period_sec: Annotated[
362
+ Optional[float], pydantic.Field(alias="dnsResolvePeriodSec")
363
+ ] = 600
364
+ r"""The interval in which to re-resolve any hostnames and pick up destinations from A records"""
365
+
366
+ load_balance_stats_period_sec: Annotated[
367
+ Optional[float], pydantic.Field(alias="loadBalanceStatsPeriodSec")
368
+ ] = 300
369
+ r"""How far back in time to keep traffic stats for load balancing purposes"""
370
+
371
+ token: Optional[str] = None
372
+ r"""XSIAM authentication token"""
373
+
374
+ text_secret: Annotated[Optional[str], pydantic.Field(alias="textSecret")] = None
375
+ r"""Select or create a stored text secret"""
376
+
377
+ pq_max_file_size: Annotated[
378
+ Optional[str], pydantic.Field(alias="pqMaxFileSize")
379
+ ] = "1 MB"
380
+ r"""The maximum size to store in each queue file before closing and optionally compressing (KB, MB, etc.)"""
381
+
382
+ pq_max_size: Annotated[Optional[str], pydantic.Field(alias="pqMaxSize")] = "5GB"
383
+ r"""The maximum disk space that the queue can consume (as an average per Worker Process) before queueing stops. Enter a numeral with units of KB, MB, etc."""
384
+
385
+ pq_path: Annotated[Optional[str], pydantic.Field(alias="pqPath")] = (
386
+ "$CRIBL_HOME/state/queues"
387
+ )
388
+ r"""The location for the persistent queue files. To this field's value, the system will append: /<worker-id>/<output-id>."""
389
+
390
+ pq_compress: Annotated[
391
+ Annotated[
392
+ Optional[OutputXsiamCompression], PlainValidator(validate_open_enum(False))
393
+ ],
394
+ pydantic.Field(alias="pqCompress"),
395
+ ] = OutputXsiamCompression.NONE
396
+ r"""Codec to use to compress the persisted data"""
397
+
398
+ pq_on_backpressure: Annotated[
399
+ Annotated[
400
+ Optional[OutputXsiamQueueFullBehavior],
401
+ PlainValidator(validate_open_enum(False)),
402
+ ],
403
+ pydantic.Field(alias="pqOnBackpressure"),
404
+ ] = OutputXsiamQueueFullBehavior.BLOCK
405
+ r"""How to handle events when the queue is exerting backpressure (full capacity or low disk). 'Block' is the same behavior as non-PQ blocking. 'Drop new data' throws away incoming data, while leaving the contents of the PQ unchanged."""
406
+
407
+ pq_mode: Annotated[
408
+ Annotated[Optional[OutputXsiamMode], PlainValidator(validate_open_enum(False))],
409
+ pydantic.Field(alias="pqMode"),
410
+ ] = OutputXsiamMode.ERROR
411
+ r"""In Error mode, PQ writes events to the filesystem if the Destination is unavailable. In Backpressure mode, PQ writes events to the filesystem when it detects backpressure from the Destination. In Always On mode, PQ always writes events to the filesystem."""
412
+
413
+ pq_controls: Annotated[
414
+ Optional[OutputXsiamPqControls], pydantic.Field(alias="pqControls")
415
+ ] = None
@@ -0,0 +1,24 @@
1
+ """Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
2
+
3
+ from __future__ import annotations
4
+ from cribl_control_plane.types import BaseModel
5
+ from cribl_control_plane.utils import FieldMetadata, SecurityMetadata
6
+ from typing_extensions import Annotated, TypedDict
7
+
8
+
9
+ class SchemeClientOauthTypedDict(TypedDict):
10
+ client_id: str
11
+ client_secret: str
12
+ token_url: str
13
+
14
+
15
+ class SchemeClientOauth(BaseModel):
16
+ client_id: Annotated[
17
+ str, FieldMetadata(security=SecurityMetadata(field_name="clientID"))
18
+ ]
19
+
20
+ client_secret: Annotated[
21
+ str, FieldMetadata(security=SecurityMetadata(field_name="clientSecret"))
22
+ ]
23
+
24
+ token_url: str = "https://login.cribl.cloud/oauth/token"
@@ -0,0 +1,36 @@
1
+ """Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
2
+
3
+ from __future__ import annotations
4
+ from .schemeclientoauth import SchemeClientOauth, SchemeClientOauthTypedDict
5
+ from cribl_control_plane.types import BaseModel
6
+ from cribl_control_plane.utils import FieldMetadata, SecurityMetadata
7
+ from typing import Optional
8
+ from typing_extensions import Annotated, NotRequired, TypedDict
9
+
10
+
11
+ class SecurityTypedDict(TypedDict):
12
+ bearer_auth: NotRequired[str]
13
+ client_oauth: NotRequired[SchemeClientOauthTypedDict]
14
+
15
+
16
+ class Security(BaseModel):
17
+ bearer_auth: Annotated[
18
+ Optional[str],
19
+ FieldMetadata(
20
+ security=SecurityMetadata(
21
+ scheme=True,
22
+ scheme_type="http",
23
+ sub_type="bearer",
24
+ field_name="Authorization",
25
+ )
26
+ ),
27
+ ] = None
28
+
29
+ client_oauth: Annotated[
30
+ Optional[SchemeClientOauth],
31
+ FieldMetadata(
32
+ security=SecurityMetadata(
33
+ scheme=True, scheme_type="oauth2", sub_type="client_credentials"
34
+ )
35
+ ),
36
+ ] = None
@@ -0,0 +1,31 @@
1
+ """Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
2
+
3
+ from __future__ import annotations
4
+ from cribl_control_plane.types import BaseModel
5
+ from typing import List, Optional
6
+ from typing_extensions import NotRequired, TypedDict
7
+
8
+
9
+ class UpdateHecTokenRequestMetadatumTypedDict(TypedDict):
10
+ name: str
11
+ value: str
12
+
13
+
14
+ class UpdateHecTokenRequestMetadatum(BaseModel):
15
+ name: str
16
+
17
+ value: str
18
+
19
+
20
+ class UpdateHecTokenRequestTypedDict(TypedDict):
21
+ description: NotRequired[str]
22
+ enabled: NotRequired[bool]
23
+ metadata: NotRequired[List[UpdateHecTokenRequestMetadatumTypedDict]]
24
+
25
+
26
+ class UpdateHecTokenRequest(BaseModel):
27
+ description: Optional[str] = None
28
+
29
+ enabled: Optional[bool] = None
30
+
31
+ metadata: Optional[List[UpdateHecTokenRequestMetadatum]] = None
@@ -0,0 +1,44 @@
1
+ """Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
2
+
3
+ from __future__ import annotations
4
+ from .input import Input, InputTypedDict
5
+ from cribl_control_plane.types import BaseModel
6
+ from cribl_control_plane.utils import FieldMetadata, PathParamMetadata, RequestMetadata
7
+ from typing import List, Optional
8
+ from typing_extensions import Annotated, NotRequired, TypedDict
9
+
10
+
11
+ class UpdateInputByIDRequestTypedDict(TypedDict):
12
+ id: str
13
+ r"""Unique ID to PATCH"""
14
+ input: InputTypedDict
15
+ r"""Source object to be updated"""
16
+
17
+
18
+ class UpdateInputByIDRequest(BaseModel):
19
+ id: Annotated[
20
+ str, FieldMetadata(path=PathParamMetadata(style="simple", explode=False))
21
+ ]
22
+ r"""Unique ID to PATCH"""
23
+
24
+ input: Annotated[
25
+ Input, FieldMetadata(request=RequestMetadata(media_type="application/json"))
26
+ ]
27
+ r"""Source object to be updated"""
28
+
29
+
30
+ class UpdateInputByIDResponseTypedDict(TypedDict):
31
+ r"""a list of Source objects"""
32
+
33
+ count: NotRequired[int]
34
+ r"""number of items present in the items array"""
35
+ items: NotRequired[List[InputTypedDict]]
36
+
37
+
38
+ class UpdateInputByIDResponse(BaseModel):
39
+ r"""a list of Source objects"""
40
+
41
+ count: Optional[int] = None
42
+ r"""number of items present in the items array"""
43
+
44
+ items: Optional[List[Input]] = None
@@ -0,0 +1,52 @@
1
+ """Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
2
+
3
+ from __future__ import annotations
4
+ from .updatehectokenrequest import UpdateHecTokenRequest, UpdateHecTokenRequestTypedDict
5
+ from cribl_control_plane.types import BaseModel
6
+ from cribl_control_plane.utils import FieldMetadata, PathParamMetadata, RequestMetadata
7
+ from typing import Any, Dict, List, Optional
8
+ from typing_extensions import Annotated, NotRequired, TypedDict
9
+
10
+
11
+ class UpdateInputHecTokenByIDAndTokenRequestTypedDict(TypedDict):
12
+ id: str
13
+ r"""HEC Source id"""
14
+ token: str
15
+ r"""token to update"""
16
+ update_hec_token_request: UpdateHecTokenRequestTypedDict
17
+ r"""UpdateHecTokenRequest object"""
18
+
19
+
20
+ class UpdateInputHecTokenByIDAndTokenRequest(BaseModel):
21
+ id: Annotated[
22
+ str, FieldMetadata(path=PathParamMetadata(style="simple", explode=False))
23
+ ]
24
+ r"""HEC Source id"""
25
+
26
+ token: Annotated[
27
+ str, FieldMetadata(path=PathParamMetadata(style="simple", explode=False))
28
+ ]
29
+ r"""token to update"""
30
+
31
+ update_hec_token_request: Annotated[
32
+ UpdateHecTokenRequest,
33
+ FieldMetadata(request=RequestMetadata(media_type="application/json")),
34
+ ]
35
+ r"""UpdateHecTokenRequest object"""
36
+
37
+
38
+ class UpdateInputHecTokenByIDAndTokenResponseTypedDict(TypedDict):
39
+ r"""a list of any objects"""
40
+
41
+ count: NotRequired[int]
42
+ r"""number of items present in the items array"""
43
+ items: NotRequired[List[Dict[str, Any]]]
44
+
45
+
46
+ class UpdateInputHecTokenByIDAndTokenResponse(BaseModel):
47
+ r"""a list of any objects"""
48
+
49
+ count: Optional[int] = None
50
+ r"""number of items present in the items array"""
51
+
52
+ items: Optional[List[Dict[str, Any]]] = None
@@ -0,0 +1,44 @@
1
+ """Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
2
+
3
+ from __future__ import annotations
4
+ from .output import Output, OutputTypedDict
5
+ from cribl_control_plane.types import BaseModel
6
+ from cribl_control_plane.utils import FieldMetadata, PathParamMetadata, RequestMetadata
7
+ from typing import List, Optional
8
+ from typing_extensions import Annotated, NotRequired, TypedDict
9
+
10
+
11
+ class UpdateOutputByIDRequestTypedDict(TypedDict):
12
+ id: str
13
+ r"""Unique ID to PATCH"""
14
+ output: OutputTypedDict
15
+ r"""Output object to be updated"""
16
+
17
+
18
+ class UpdateOutputByIDRequest(BaseModel):
19
+ id: Annotated[
20
+ str, FieldMetadata(path=PathParamMetadata(style="simple", explode=False))
21
+ ]
22
+ r"""Unique ID to PATCH"""
23
+
24
+ output: Annotated[
25
+ Output, FieldMetadata(request=RequestMetadata(media_type="application/json"))
26
+ ]
27
+ r"""Output object to be updated"""
28
+
29
+
30
+ class UpdateOutputByIDResponseTypedDict(TypedDict):
31
+ r"""a list of Output objects"""
32
+
33
+ count: NotRequired[int]
34
+ r"""number of items present in the items array"""
35
+ items: NotRequired[List[OutputTypedDict]]
36
+
37
+
38
+ class UpdateOutputByIDResponse(BaseModel):
39
+ r"""a list of Output objects"""
40
+
41
+ count: Optional[int] = None
42
+ r"""number of items present in the items array"""
43
+
44
+ items: Optional[List[Output]] = None