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,274 @@
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 List, Optional
11
+ from typing_extensions import Annotated, NotRequired, TypedDict
12
+
13
+
14
+ class OutputSnsType(str, Enum, metaclass=utils.OpenEnumMeta):
15
+ SNS = "sns"
16
+
17
+
18
+ class OutputSnsAuthenticationMethod(str, Enum, metaclass=utils.OpenEnumMeta):
19
+ r"""AWS authentication method. Choose Auto to use IAM roles."""
20
+
21
+ AUTO = "auto"
22
+ MANUAL = "manual"
23
+ SECRET = "secret"
24
+
25
+
26
+ class OutputSnsSignatureVersion(str, Enum, metaclass=utils.OpenEnumMeta):
27
+ r"""Signature version to use for signing SNS requests"""
28
+
29
+ V2 = "v2"
30
+ V4 = "v4"
31
+
32
+
33
+ class OutputSnsBackpressureBehavior(str, Enum, metaclass=utils.OpenEnumMeta):
34
+ r"""How to handle events when all receivers are exerting backpressure"""
35
+
36
+ BLOCK = "block"
37
+ DROP = "drop"
38
+ QUEUE = "queue"
39
+
40
+
41
+ class OutputSnsCompression(str, Enum, metaclass=utils.OpenEnumMeta):
42
+ r"""Codec to use to compress the persisted data"""
43
+
44
+ NONE = "none"
45
+ GZIP = "gzip"
46
+
47
+
48
+ class OutputSnsQueueFullBehavior(str, Enum, metaclass=utils.OpenEnumMeta):
49
+ 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."""
50
+
51
+ BLOCK = "block"
52
+ DROP = "drop"
53
+
54
+
55
+ class OutputSnsMode(str, Enum, metaclass=utils.OpenEnumMeta):
56
+ 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."""
57
+
58
+ ERROR = "error"
59
+ BACKPRESSURE = "backpressure"
60
+ ALWAYS = "always"
61
+
62
+
63
+ class OutputSnsPqControlsTypedDict(TypedDict):
64
+ pass
65
+
66
+
67
+ class OutputSnsPqControls(BaseModel):
68
+ pass
69
+
70
+
71
+ class OutputSnsTypedDict(TypedDict):
72
+ topic_arn: str
73
+ r"""The ARN of the SNS topic to send events to. When a non-AWS URL is specified, format must be: '{url}/myQueueName'. E.g., 'https://host:port/myQueueName'. Must be a JavaScript expression (which can evaluate to a constant value), enclosed in quotes or backticks. Can be evaluated only at initialization time. Example referencing a Global Variable: `https://host:port/myQueue-${C.vars.myVar}`"""
74
+ message_group_id: str
75
+ r"""Messages in the same group are processed in a FIFO manner. Must be a JavaScript expression (which can evaluate to a constant value), enclosed in quotes or backticks. Can be evaluated only at init time. Example referencing a Global Variable: `https://host:port/myQueue-${C.vars.myVar}`."""
76
+ id: NotRequired[str]
77
+ r"""Unique ID for this output"""
78
+ type: NotRequired[OutputSnsType]
79
+ pipeline: NotRequired[str]
80
+ r"""Pipeline to process data before sending out to this output"""
81
+ system_fields: NotRequired[List[str]]
82
+ r"""Fields to automatically add to events, such as cribl_pipe. Supports wildcards."""
83
+ environment: NotRequired[str]
84
+ r"""Optionally, enable this config only on a specified Git branch. If empty, will be enabled everywhere."""
85
+ streamtags: NotRequired[List[str]]
86
+ r"""Tags for filtering and grouping in @{product}"""
87
+ max_retries: NotRequired[float]
88
+ r"""Maximum number of retries before the output returns an error. Note that not all errors are retryable. The retries use an exponential backoff policy."""
89
+ aws_authentication_method: NotRequired[OutputSnsAuthenticationMethod]
90
+ r"""AWS authentication method. Choose Auto to use IAM roles."""
91
+ aws_secret_key: NotRequired[str]
92
+ region: NotRequired[str]
93
+ r"""Region where the SNS is located"""
94
+ endpoint: NotRequired[str]
95
+ r"""SNS service endpoint. If empty, defaults to the AWS Region-specific endpoint. Otherwise, it must point to SNS-compatible endpoint."""
96
+ signature_version: NotRequired[OutputSnsSignatureVersion]
97
+ r"""Signature version to use for signing SNS requests"""
98
+ reuse_connections: NotRequired[bool]
99
+ r"""Reuse connections between requests, which can improve performance"""
100
+ reject_unauthorized: NotRequired[bool]
101
+ r"""Reject certificates that cannot be verified against a valid CA, such as self-signed certificates"""
102
+ enable_assume_role: NotRequired[bool]
103
+ r"""Use Assume Role credentials to access SNS"""
104
+ assume_role_arn: NotRequired[str]
105
+ r"""Amazon Resource Name (ARN) of the role to assume"""
106
+ assume_role_external_id: NotRequired[str]
107
+ r"""External ID to use when assuming role"""
108
+ duration_seconds: NotRequired[float]
109
+ r"""Duration of the assumed role's session, in seconds. Minimum is 900 (15 minutes), default is 3600 (1 hour), and maximum is 43200 (12 hours)."""
110
+ on_backpressure: NotRequired[OutputSnsBackpressureBehavior]
111
+ r"""How to handle events when all receivers are exerting backpressure"""
112
+ description: NotRequired[str]
113
+ aws_api_key: NotRequired[str]
114
+ aws_secret: NotRequired[str]
115
+ r"""Select or create a stored secret that references your access key and secret key"""
116
+ pq_max_file_size: NotRequired[str]
117
+ r"""The maximum size to store in each queue file before closing and optionally compressing (KB, MB, etc.)"""
118
+ pq_max_size: NotRequired[str]
119
+ 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."""
120
+ pq_path: NotRequired[str]
121
+ r"""The location for the persistent queue files. To this field's value, the system will append: /<worker-id>/<output-id>."""
122
+ pq_compress: NotRequired[OutputSnsCompression]
123
+ r"""Codec to use to compress the persisted data"""
124
+ pq_on_backpressure: NotRequired[OutputSnsQueueFullBehavior]
125
+ 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."""
126
+ pq_mode: NotRequired[OutputSnsMode]
127
+ 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."""
128
+ pq_controls: NotRequired[OutputSnsPqControlsTypedDict]
129
+
130
+
131
+ class OutputSns(BaseModel):
132
+ topic_arn: Annotated[str, pydantic.Field(alias="topicArn")]
133
+ r"""The ARN of the SNS topic to send events to. When a non-AWS URL is specified, format must be: '{url}/myQueueName'. E.g., 'https://host:port/myQueueName'. Must be a JavaScript expression (which can evaluate to a constant value), enclosed in quotes or backticks. Can be evaluated only at initialization time. Example referencing a Global Variable: `https://host:port/myQueue-${C.vars.myVar}`"""
134
+
135
+ message_group_id: Annotated[str, pydantic.Field(alias="messageGroupId")]
136
+ r"""Messages in the same group are processed in a FIFO manner. Must be a JavaScript expression (which can evaluate to a constant value), enclosed in quotes or backticks. Can be evaluated only at init time. Example referencing a Global Variable: `https://host:port/myQueue-${C.vars.myVar}`."""
137
+
138
+ id: Optional[str] = None
139
+ r"""Unique ID for this output"""
140
+
141
+ type: Annotated[
142
+ Optional[OutputSnsType], PlainValidator(validate_open_enum(False))
143
+ ] = None
144
+
145
+ pipeline: Optional[str] = None
146
+ r"""Pipeline to process data before sending out to this output"""
147
+
148
+ system_fields: Annotated[
149
+ Optional[List[str]], pydantic.Field(alias="systemFields")
150
+ ] = None
151
+ r"""Fields to automatically add to events, such as cribl_pipe. Supports wildcards."""
152
+
153
+ environment: Optional[str] = None
154
+ r"""Optionally, enable this config only on a specified Git branch. If empty, will be enabled everywhere."""
155
+
156
+ streamtags: Optional[List[str]] = None
157
+ r"""Tags for filtering and grouping in @{product}"""
158
+
159
+ max_retries: Annotated[Optional[float], pydantic.Field(alias="maxRetries")] = None
160
+ r"""Maximum number of retries before the output returns an error. Note that not all errors are retryable. The retries use an exponential backoff policy."""
161
+
162
+ aws_authentication_method: Annotated[
163
+ Annotated[
164
+ Optional[OutputSnsAuthenticationMethod],
165
+ PlainValidator(validate_open_enum(False)),
166
+ ],
167
+ pydantic.Field(alias="awsAuthenticationMethod"),
168
+ ] = OutputSnsAuthenticationMethod.AUTO
169
+ r"""AWS authentication method. Choose Auto to use IAM roles."""
170
+
171
+ aws_secret_key: Annotated[Optional[str], pydantic.Field(alias="awsSecretKey")] = (
172
+ None
173
+ )
174
+
175
+ region: Optional[str] = None
176
+ r"""Region where the SNS is located"""
177
+
178
+ endpoint: Optional[str] = None
179
+ r"""SNS service endpoint. If empty, defaults to the AWS Region-specific endpoint. Otherwise, it must point to SNS-compatible endpoint."""
180
+
181
+ signature_version: Annotated[
182
+ Annotated[
183
+ Optional[OutputSnsSignatureVersion],
184
+ PlainValidator(validate_open_enum(False)),
185
+ ],
186
+ pydantic.Field(alias="signatureVersion"),
187
+ ] = OutputSnsSignatureVersion.V4
188
+ r"""Signature version to use for signing SNS requests"""
189
+
190
+ reuse_connections: Annotated[
191
+ Optional[bool], pydantic.Field(alias="reuseConnections")
192
+ ] = True
193
+ r"""Reuse connections between requests, which can improve performance"""
194
+
195
+ reject_unauthorized: Annotated[
196
+ Optional[bool], pydantic.Field(alias="rejectUnauthorized")
197
+ ] = True
198
+ r"""Reject certificates that cannot be verified against a valid CA, such as self-signed certificates"""
199
+
200
+ enable_assume_role: Annotated[
201
+ Optional[bool], pydantic.Field(alias="enableAssumeRole")
202
+ ] = False
203
+ r"""Use Assume Role credentials to access SNS"""
204
+
205
+ assume_role_arn: Annotated[Optional[str], pydantic.Field(alias="assumeRoleArn")] = (
206
+ None
207
+ )
208
+ r"""Amazon Resource Name (ARN) of the role to assume"""
209
+
210
+ assume_role_external_id: Annotated[
211
+ Optional[str], pydantic.Field(alias="assumeRoleExternalId")
212
+ ] = None
213
+ r"""External ID to use when assuming role"""
214
+
215
+ duration_seconds: Annotated[
216
+ Optional[float], pydantic.Field(alias="durationSeconds")
217
+ ] = 3600
218
+ r"""Duration of the assumed role's session, in seconds. Minimum is 900 (15 minutes), default is 3600 (1 hour), and maximum is 43200 (12 hours)."""
219
+
220
+ on_backpressure: Annotated[
221
+ Annotated[
222
+ Optional[OutputSnsBackpressureBehavior],
223
+ PlainValidator(validate_open_enum(False)),
224
+ ],
225
+ pydantic.Field(alias="onBackpressure"),
226
+ ] = OutputSnsBackpressureBehavior.BLOCK
227
+ r"""How to handle events when all receivers are exerting backpressure"""
228
+
229
+ description: Optional[str] = None
230
+
231
+ aws_api_key: Annotated[Optional[str], pydantic.Field(alias="awsApiKey")] = None
232
+
233
+ aws_secret: Annotated[Optional[str], pydantic.Field(alias="awsSecret")] = None
234
+ r"""Select or create a stored secret that references your access key and secret key"""
235
+
236
+ pq_max_file_size: Annotated[
237
+ Optional[str], pydantic.Field(alias="pqMaxFileSize")
238
+ ] = "1 MB"
239
+ r"""The maximum size to store in each queue file before closing and optionally compressing (KB, MB, etc.)"""
240
+
241
+ pq_max_size: Annotated[Optional[str], pydantic.Field(alias="pqMaxSize")] = "5GB"
242
+ 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."""
243
+
244
+ pq_path: Annotated[Optional[str], pydantic.Field(alias="pqPath")] = (
245
+ "$CRIBL_HOME/state/queues"
246
+ )
247
+ r"""The location for the persistent queue files. To this field's value, the system will append: /<worker-id>/<output-id>."""
248
+
249
+ pq_compress: Annotated[
250
+ Annotated[
251
+ Optional[OutputSnsCompression], PlainValidator(validate_open_enum(False))
252
+ ],
253
+ pydantic.Field(alias="pqCompress"),
254
+ ] = OutputSnsCompression.NONE
255
+ r"""Codec to use to compress the persisted data"""
256
+
257
+ pq_on_backpressure: Annotated[
258
+ Annotated[
259
+ Optional[OutputSnsQueueFullBehavior],
260
+ PlainValidator(validate_open_enum(False)),
261
+ ],
262
+ pydantic.Field(alias="pqOnBackpressure"),
263
+ ] = OutputSnsQueueFullBehavior.BLOCK
264
+ 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."""
265
+
266
+ pq_mode: Annotated[
267
+ Annotated[Optional[OutputSnsMode], PlainValidator(validate_open_enum(False))],
268
+ pydantic.Field(alias="pqMode"),
269
+ ] = OutputSnsMode.ERROR
270
+ 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."""
271
+
272
+ pq_controls: Annotated[
273
+ Optional[OutputSnsPqControls], pydantic.Field(alias="pqControls")
274
+ ] = None
@@ -0,0 +1,383 @@
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 List, Optional
11
+ from typing_extensions import Annotated, NotRequired, TypedDict
12
+
13
+
14
+ class OutputSplunkType(str, Enum, metaclass=utils.OpenEnumMeta):
15
+ SPLUNK = "splunk"
16
+
17
+
18
+ class OutputSplunkNestedFieldSerialization(str, Enum, metaclass=utils.OpenEnumMeta):
19
+ r"""How to serialize nested fields into index-time fields"""
20
+
21
+ JSON = "json"
22
+ NONE = "none"
23
+
24
+
25
+ class OutputSplunkMinimumTLSVersion(str, Enum, metaclass=utils.OpenEnumMeta):
26
+ TL_SV1 = "TLSv1"
27
+ TL_SV1_1 = "TLSv1.1"
28
+ TL_SV1_2 = "TLSv1.2"
29
+ TL_SV1_3 = "TLSv1.3"
30
+
31
+
32
+ class OutputSplunkMaximumTLSVersion(str, Enum, metaclass=utils.OpenEnumMeta):
33
+ TL_SV1 = "TLSv1"
34
+ TL_SV1_1 = "TLSv1.1"
35
+ TL_SV1_2 = "TLSv1.2"
36
+ TL_SV1_3 = "TLSv1.3"
37
+
38
+
39
+ class OutputSplunkTLSSettingsClientSideTypedDict(TypedDict):
40
+ disabled: NotRequired[bool]
41
+ reject_unauthorized: NotRequired[bool]
42
+ r"""Reject certificates that are not authorized by a CA in the CA certificate path, or by another
43
+ trusted CA (such as the system's). Defaults to Enabled. Overrides the toggle from Advanced Settings, when also present.
44
+ """
45
+ servername: NotRequired[str]
46
+ r"""Server name for the SNI (Server Name Indication) TLS extension. It must be a host name, and not an IP address."""
47
+ certificate_name: NotRequired[str]
48
+ r"""The name of the predefined certificate"""
49
+ ca_path: NotRequired[str]
50
+ r"""Path on client in which to find CA certificates to verify the server's cert. PEM format. Can reference $ENV_VARS."""
51
+ priv_key_path: NotRequired[str]
52
+ r"""Path on client in which to find the private key to use. PEM format. Can reference $ENV_VARS."""
53
+ cert_path: NotRequired[str]
54
+ r"""Path on client in which to find certificates to use. PEM format. Can reference $ENV_VARS."""
55
+ passphrase: NotRequired[str]
56
+ r"""Passphrase to use to decrypt private key"""
57
+ min_version: NotRequired[OutputSplunkMinimumTLSVersion]
58
+ max_version: NotRequired[OutputSplunkMaximumTLSVersion]
59
+
60
+
61
+ class OutputSplunkTLSSettingsClientSide(BaseModel):
62
+ disabled: Optional[bool] = True
63
+
64
+ reject_unauthorized: Annotated[
65
+ Optional[bool], pydantic.Field(alias="rejectUnauthorized")
66
+ ] = True
67
+ r"""Reject certificates that are not authorized by a CA in the CA certificate path, or by another
68
+ trusted CA (such as the system's). Defaults to Enabled. Overrides the toggle from Advanced Settings, when also present.
69
+ """
70
+
71
+ servername: Optional[str] = None
72
+ r"""Server name for the SNI (Server Name Indication) TLS extension. It must be a host name, and not an IP address."""
73
+
74
+ certificate_name: Annotated[
75
+ Optional[str], pydantic.Field(alias="certificateName")
76
+ ] = None
77
+ r"""The name of the predefined certificate"""
78
+
79
+ ca_path: Annotated[Optional[str], pydantic.Field(alias="caPath")] = None
80
+ r"""Path on client in which to find CA certificates to verify the server's cert. PEM format. Can reference $ENV_VARS."""
81
+
82
+ priv_key_path: Annotated[Optional[str], pydantic.Field(alias="privKeyPath")] = None
83
+ r"""Path on client in which to find the private key to use. PEM format. Can reference $ENV_VARS."""
84
+
85
+ cert_path: Annotated[Optional[str], pydantic.Field(alias="certPath")] = None
86
+ r"""Path on client in which to find certificates to use. PEM format. Can reference $ENV_VARS."""
87
+
88
+ passphrase: Optional[str] = None
89
+ r"""Passphrase to use to decrypt private key"""
90
+
91
+ min_version: Annotated[
92
+ Annotated[
93
+ Optional[OutputSplunkMinimumTLSVersion],
94
+ PlainValidator(validate_open_enum(False)),
95
+ ],
96
+ pydantic.Field(alias="minVersion"),
97
+ ] = None
98
+
99
+ max_version: Annotated[
100
+ Annotated[
101
+ Optional[OutputSplunkMaximumTLSVersion],
102
+ PlainValidator(validate_open_enum(False)),
103
+ ],
104
+ pydantic.Field(alias="maxVersion"),
105
+ ] = None
106
+
107
+
108
+ class OutputSplunkMaxS2SVersion(str, Enum, metaclass=utils.OpenEnumMeta):
109
+ r"""The highest S2S protocol version to advertise during handshake"""
110
+
111
+ V3 = "v3"
112
+ V4 = "v4"
113
+
114
+
115
+ class OutputSplunkBackpressureBehavior(str, Enum, metaclass=utils.OpenEnumMeta):
116
+ r"""How to handle events when all receivers are exerting backpressure"""
117
+
118
+ BLOCK = "block"
119
+ DROP = "drop"
120
+ QUEUE = "queue"
121
+
122
+
123
+ class OutputSplunkAuthenticationMethod(str, Enum, metaclass=utils.OpenEnumMeta):
124
+ r"""Select Manual to enter an auth token directly, or select Secret to use a text secret to authenticate"""
125
+
126
+ MANUAL = "manual"
127
+ SECRET = "secret"
128
+
129
+
130
+ class OutputSplunkCompressCompression(str, Enum, metaclass=utils.OpenEnumMeta):
131
+ r"""Controls whether the sender should send compressed data to the server. Select 'Disabled' to reject compressed connections or 'Always' to ignore server's configuration and send compressed data."""
132
+
133
+ DISABLED = "disabled"
134
+ AUTO = "auto"
135
+ ALWAYS = "always"
136
+
137
+
138
+ class OutputSplunkPqCompressCompression(str, Enum, metaclass=utils.OpenEnumMeta):
139
+ r"""Codec to use to compress the persisted data"""
140
+
141
+ NONE = "none"
142
+ GZIP = "gzip"
143
+
144
+
145
+ class OutputSplunkQueueFullBehavior(str, Enum, metaclass=utils.OpenEnumMeta):
146
+ 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."""
147
+
148
+ BLOCK = "block"
149
+ DROP = "drop"
150
+
151
+
152
+ class OutputSplunkMode(str, Enum, metaclass=utils.OpenEnumMeta):
153
+ 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."""
154
+
155
+ ERROR = "error"
156
+ BACKPRESSURE = "backpressure"
157
+ ALWAYS = "always"
158
+
159
+
160
+ class OutputSplunkPqControlsTypedDict(TypedDict):
161
+ pass
162
+
163
+
164
+ class OutputSplunkPqControls(BaseModel):
165
+ pass
166
+
167
+
168
+ class OutputSplunkTypedDict(TypedDict):
169
+ host: str
170
+ r"""The hostname of the receiver"""
171
+ id: NotRequired[str]
172
+ r"""Unique ID for this output"""
173
+ type: NotRequired[OutputSplunkType]
174
+ pipeline: NotRequired[str]
175
+ r"""Pipeline to process data before sending out to this output"""
176
+ system_fields: NotRequired[List[str]]
177
+ r"""Fields to automatically add to events, such as cribl_pipe. Supports wildcards."""
178
+ environment: NotRequired[str]
179
+ r"""Optionally, enable this config only on a specified Git branch. If empty, will be enabled everywhere."""
180
+ streamtags: NotRequired[List[str]]
181
+ r"""Tags for filtering and grouping in @{product}"""
182
+ port: NotRequired[float]
183
+ r"""The port to connect to on the provided host"""
184
+ nested_fields: NotRequired[OutputSplunkNestedFieldSerialization]
185
+ r"""How to serialize nested fields into index-time fields"""
186
+ throttle_rate_per_sec: NotRequired[str]
187
+ r"""Rate (in bytes per second) to throttle while writing to an output. Accepts values with multiple-byte units, such as KB, MB, and GB. (Example: 42 MB) Default value of 0 specifies no throttling."""
188
+ connection_timeout: NotRequired[float]
189
+ r"""Amount of time (milliseconds) to wait for the connection to establish before retrying"""
190
+ write_timeout: NotRequired[float]
191
+ r"""Amount of time (milliseconds) to wait for a write to complete before assuming connection is dead"""
192
+ tls: NotRequired[OutputSplunkTLSSettingsClientSideTypedDict]
193
+ enable_multi_metrics: NotRequired[bool]
194
+ r"""Output metrics in multiple-metric format in a single event. Supported in Splunk 8.0 and above."""
195
+ enable_ack: NotRequired[bool]
196
+ r"""Check if indexer is shutting down and stop sending data. This helps minimize data loss during shutdown."""
197
+ log_failed_requests: NotRequired[bool]
198
+ r"""Use to troubleshoot issues with sending data"""
199
+ max_s2_sversion: NotRequired[OutputSplunkMaxS2SVersion]
200
+ r"""The highest S2S protocol version to advertise during handshake"""
201
+ on_backpressure: NotRequired[OutputSplunkBackpressureBehavior]
202
+ r"""How to handle events when all receivers are exerting backpressure"""
203
+ auth_type: NotRequired[OutputSplunkAuthenticationMethod]
204
+ r"""Select Manual to enter an auth token directly, or select Secret to use a text secret to authenticate"""
205
+ description: NotRequired[str]
206
+ max_failed_health_checks: NotRequired[float]
207
+ r"""Maximum number of times healthcheck can fail before we close connection. If set to 0 (disabled), and the connection to Splunk is forcibly closed, some data loss might occur."""
208
+ compress: NotRequired[OutputSplunkCompressCompression]
209
+ r"""Controls whether the sender should send compressed data to the server. Select 'Disabled' to reject compressed connections or 'Always' to ignore server's configuration and send compressed data."""
210
+ pq_max_file_size: NotRequired[str]
211
+ r"""The maximum size to store in each queue file before closing and optionally compressing (KB, MB, etc.)"""
212
+ pq_max_size: NotRequired[str]
213
+ 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."""
214
+ pq_path: NotRequired[str]
215
+ r"""The location for the persistent queue files. To this field's value, the system will append: /<worker-id>/<output-id>."""
216
+ pq_compress: NotRequired[OutputSplunkPqCompressCompression]
217
+ r"""Codec to use to compress the persisted data"""
218
+ pq_on_backpressure: NotRequired[OutputSplunkQueueFullBehavior]
219
+ 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."""
220
+ pq_mode: NotRequired[OutputSplunkMode]
221
+ 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."""
222
+ pq_controls: NotRequired[OutputSplunkPqControlsTypedDict]
223
+ auth_token: NotRequired[str]
224
+ r"""Shared secret token to use when establishing a connection to a Splunk indexer."""
225
+ text_secret: NotRequired[str]
226
+ r"""Select or create a stored text secret"""
227
+
228
+
229
+ class OutputSplunk(BaseModel):
230
+ host: str
231
+ r"""The hostname of the receiver"""
232
+
233
+ id: Optional[str] = None
234
+ r"""Unique ID for this output"""
235
+
236
+ type: Annotated[
237
+ Optional[OutputSplunkType], PlainValidator(validate_open_enum(False))
238
+ ] = None
239
+
240
+ pipeline: Optional[str] = None
241
+ r"""Pipeline to process data before sending out to this output"""
242
+
243
+ system_fields: Annotated[
244
+ Optional[List[str]], pydantic.Field(alias="systemFields")
245
+ ] = None
246
+ r"""Fields to automatically add to events, such as cribl_pipe. Supports wildcards."""
247
+
248
+ environment: Optional[str] = None
249
+ r"""Optionally, enable this config only on a specified Git branch. If empty, will be enabled everywhere."""
250
+
251
+ streamtags: Optional[List[str]] = None
252
+ r"""Tags for filtering and grouping in @{product}"""
253
+
254
+ port: Optional[float] = 9997
255
+ r"""The port to connect to on the provided host"""
256
+
257
+ nested_fields: Annotated[
258
+ Annotated[
259
+ Optional[OutputSplunkNestedFieldSerialization],
260
+ PlainValidator(validate_open_enum(False)),
261
+ ],
262
+ pydantic.Field(alias="nestedFields"),
263
+ ] = OutputSplunkNestedFieldSerialization.NONE
264
+ r"""How to serialize nested fields into index-time fields"""
265
+
266
+ throttle_rate_per_sec: Annotated[
267
+ Optional[str], pydantic.Field(alias="throttleRatePerSec")
268
+ ] = "0"
269
+ r"""Rate (in bytes per second) to throttle while writing to an output. Accepts values with multiple-byte units, such as KB, MB, and GB. (Example: 42 MB) Default value of 0 specifies no throttling."""
270
+
271
+ connection_timeout: Annotated[
272
+ Optional[float], pydantic.Field(alias="connectionTimeout")
273
+ ] = 10000
274
+ r"""Amount of time (milliseconds) to wait for the connection to establish before retrying"""
275
+
276
+ write_timeout: Annotated[Optional[float], pydantic.Field(alias="writeTimeout")] = (
277
+ 60000
278
+ )
279
+ r"""Amount of time (milliseconds) to wait for a write to complete before assuming connection is dead"""
280
+
281
+ tls: Optional[OutputSplunkTLSSettingsClientSide] = None
282
+
283
+ enable_multi_metrics: Annotated[
284
+ Optional[bool], pydantic.Field(alias="enableMultiMetrics")
285
+ ] = False
286
+ r"""Output metrics in multiple-metric format in a single event. Supported in Splunk 8.0 and above."""
287
+
288
+ enable_ack: Annotated[Optional[bool], pydantic.Field(alias="enableACK")] = True
289
+ r"""Check if indexer is shutting down and stop sending data. This helps minimize data loss during shutdown."""
290
+
291
+ log_failed_requests: Annotated[
292
+ Optional[bool], pydantic.Field(alias="logFailedRequests")
293
+ ] = False
294
+ r"""Use to troubleshoot issues with sending data"""
295
+
296
+ max_s2_sversion: Annotated[
297
+ Annotated[
298
+ Optional[OutputSplunkMaxS2SVersion],
299
+ PlainValidator(validate_open_enum(False)),
300
+ ],
301
+ pydantic.Field(alias="maxS2Sversion"),
302
+ ] = OutputSplunkMaxS2SVersion.V3
303
+ r"""The highest S2S protocol version to advertise during handshake"""
304
+
305
+ on_backpressure: Annotated[
306
+ Annotated[
307
+ Optional[OutputSplunkBackpressureBehavior],
308
+ PlainValidator(validate_open_enum(False)),
309
+ ],
310
+ pydantic.Field(alias="onBackpressure"),
311
+ ] = OutputSplunkBackpressureBehavior.BLOCK
312
+ r"""How to handle events when all receivers are exerting backpressure"""
313
+
314
+ auth_type: Annotated[
315
+ Annotated[
316
+ Optional[OutputSplunkAuthenticationMethod],
317
+ PlainValidator(validate_open_enum(False)),
318
+ ],
319
+ pydantic.Field(alias="authType"),
320
+ ] = OutputSplunkAuthenticationMethod.MANUAL
321
+ r"""Select Manual to enter an auth token directly, or select Secret to use a text secret to authenticate"""
322
+
323
+ description: Optional[str] = None
324
+
325
+ max_failed_health_checks: Annotated[
326
+ Optional[float], pydantic.Field(alias="maxFailedHealthChecks")
327
+ ] = 1
328
+ r"""Maximum number of times healthcheck can fail before we close connection. If set to 0 (disabled), and the connection to Splunk is forcibly closed, some data loss might occur."""
329
+
330
+ compress: Annotated[
331
+ Optional[OutputSplunkCompressCompression],
332
+ PlainValidator(validate_open_enum(False)),
333
+ ] = OutputSplunkCompressCompression.DISABLED
334
+ r"""Controls whether the sender should send compressed data to the server. Select 'Disabled' to reject compressed connections or 'Always' to ignore server's configuration and send compressed data."""
335
+
336
+ pq_max_file_size: Annotated[
337
+ Optional[str], pydantic.Field(alias="pqMaxFileSize")
338
+ ] = "1 MB"
339
+ r"""The maximum size to store in each queue file before closing and optionally compressing (KB, MB, etc.)"""
340
+
341
+ pq_max_size: Annotated[Optional[str], pydantic.Field(alias="pqMaxSize")] = "5GB"
342
+ 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."""
343
+
344
+ pq_path: Annotated[Optional[str], pydantic.Field(alias="pqPath")] = (
345
+ "$CRIBL_HOME/state/queues"
346
+ )
347
+ r"""The location for the persistent queue files. To this field's value, the system will append: /<worker-id>/<output-id>."""
348
+
349
+ pq_compress: Annotated[
350
+ Annotated[
351
+ Optional[OutputSplunkPqCompressCompression],
352
+ PlainValidator(validate_open_enum(False)),
353
+ ],
354
+ pydantic.Field(alias="pqCompress"),
355
+ ] = OutputSplunkPqCompressCompression.NONE
356
+ r"""Codec to use to compress the persisted data"""
357
+
358
+ pq_on_backpressure: Annotated[
359
+ Annotated[
360
+ Optional[OutputSplunkQueueFullBehavior],
361
+ PlainValidator(validate_open_enum(False)),
362
+ ],
363
+ pydantic.Field(alias="pqOnBackpressure"),
364
+ ] = OutputSplunkQueueFullBehavior.BLOCK
365
+ 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."""
366
+
367
+ pq_mode: Annotated[
368
+ Annotated[
369
+ Optional[OutputSplunkMode], PlainValidator(validate_open_enum(False))
370
+ ],
371
+ pydantic.Field(alias="pqMode"),
372
+ ] = OutputSplunkMode.ERROR
373
+ 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."""
374
+
375
+ pq_controls: Annotated[
376
+ Optional[OutputSplunkPqControls], pydantic.Field(alias="pqControls")
377
+ ] = None
378
+
379
+ auth_token: Annotated[Optional[str], pydantic.Field(alias="authToken")] = ""
380
+ r"""Shared secret token to use when establishing a connection to a Splunk indexer."""
381
+
382
+ text_secret: Annotated[Optional[str], pydantic.Field(alias="textSecret")] = None
383
+ r"""Select or create a stored text secret"""