@robinmordasiewicz/f5xc-api-mcp 3.3.1 → 3.5.0

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.
Files changed (262) hide show
  1. package/dist/generator/openapi-parser.d.ts +355 -0
  2. package/dist/generator/openapi-parser.d.ts.map +1 -1
  3. package/dist/generator/openapi-parser.js +202 -2
  4. package/dist/generator/openapi-parser.js.map +1 -1
  5. package/dist/generator/tool-generator.d.ts +29 -2
  6. package/dist/generator/tool-generator.d.ts.map +1 -1
  7. package/dist/generator/tool-generator.js +144 -28
  8. package/dist/generator/tool-generator.js.map +1 -1
  9. package/dist/index.d.ts +2 -10
  10. package/dist/index.d.ts.map +1 -1
  11. package/dist/index.js +28 -33
  12. package/dist/index.js.map +1 -1
  13. package/dist/prompts/workflows.d.ts.map +1 -1
  14. package/dist/prompts/workflows.js +30 -174
  15. package/dist/prompts/workflows.js.map +1 -1
  16. package/dist/resources/handlers.d.ts +0 -2
  17. package/dist/resources/handlers.d.ts.map +1 -1
  18. package/dist/resources/handlers.js +0 -51
  19. package/dist/resources/handlers.js.map +1 -1
  20. package/dist/server.d.ts +1 -1
  21. package/dist/server.d.ts.map +1 -1
  22. package/dist/server.js +1 -2
  23. package/dist/server.js.map +1 -1
  24. package/dist/tools/discovery/describe.d.ts +1 -0
  25. package/dist/tools/discovery/describe.d.ts.map +1 -1
  26. package/dist/tools/discovery/describe.js +10 -8
  27. package/dist/tools/discovery/describe.js.map +1 -1
  28. package/dist/tools/discovery/execute.d.ts +1 -3
  29. package/dist/tools/discovery/execute.d.ts.map +1 -1
  30. package/dist/tools/discovery/execute.js +1 -34
  31. package/dist/tools/discovery/execute.js.map +1 -1
  32. package/dist/tools/generated/admin_console_and_ui/index.d.ts +8 -0
  33. package/dist/tools/generated/admin_console_and_ui/index.d.ts.map +1 -0
  34. package/dist/tools/generated/admin_console_and_ui/index.js +259 -0
  35. package/dist/tools/generated/admin_console_and_ui/index.js.map +1 -0
  36. package/dist/tools/generated/api/index.d.ts +8 -0
  37. package/dist/tools/generated/{vpn → api}/index.d.ts.map +1 -1
  38. package/dist/tools/generated/api/index.js +5812 -0
  39. package/dist/tools/generated/api/index.js.map +1 -0
  40. package/dist/tools/generated/authentication/index.d.ts +8 -0
  41. package/dist/tools/generated/authentication/index.d.ts.map +1 -0
  42. package/dist/tools/generated/authentication/index.js +858 -0
  43. package/dist/tools/generated/authentication/index.js.map +1 -0
  44. package/dist/tools/generated/bigip/index.d.ts.map +1 -1
  45. package/dist/tools/generated/bigip/index.js +1660 -0
  46. package/dist/tools/generated/bigip/index.js.map +1 -1
  47. package/dist/tools/generated/billing_and_usage/index.d.ts +8 -0
  48. package/dist/tools/generated/billing_and_usage/index.d.ts.map +1 -0
  49. package/dist/tools/generated/billing_and_usage/index.js +2283 -0
  50. package/dist/tools/generated/billing_and_usage/index.js.map +1 -0
  51. package/dist/tools/generated/blindfold/index.d.ts +8 -0
  52. package/dist/tools/generated/blindfold/index.d.ts.map +1 -0
  53. package/dist/tools/generated/blindfold/index.js +3462 -0
  54. package/dist/tools/generated/blindfold/index.js.map +1 -0
  55. package/dist/tools/generated/bot_and_threat_defense/index.d.ts +8 -0
  56. package/dist/tools/generated/bot_and_threat_defense/index.d.ts.map +1 -0
  57. package/dist/tools/generated/bot_and_threat_defense/index.js +2264 -0
  58. package/dist/tools/generated/bot_and_threat_defense/index.js.map +1 -0
  59. package/dist/tools/generated/cdn/index.d.ts.map +1 -1
  60. package/dist/tools/generated/cdn/index.js +1498 -0
  61. package/dist/tools/generated/cdn/index.js.map +1 -1
  62. package/dist/tools/generated/ce_management/index.d.ts +8 -0
  63. package/dist/tools/generated/ce_management/index.d.ts.map +1 -0
  64. package/dist/tools/generated/ce_management/index.js +3437 -0
  65. package/dist/tools/generated/ce_management/index.js.map +1 -0
  66. package/dist/tools/generated/certificates/index.d.ts +8 -0
  67. package/dist/tools/generated/certificates/index.d.ts.map +1 -0
  68. package/dist/tools/generated/certificates/index.js +2279 -0
  69. package/dist/tools/generated/certificates/index.js.map +1 -0
  70. package/dist/tools/generated/cloud_infrastructure/index.d.ts +8 -0
  71. package/dist/tools/generated/cloud_infrastructure/index.d.ts.map +1 -0
  72. package/dist/tools/generated/cloud_infrastructure/index.js +3585 -0
  73. package/dist/tools/generated/cloud_infrastructure/index.js.map +1 -0
  74. package/dist/tools/generated/container_services/index.d.ts +8 -0
  75. package/dist/tools/generated/container_services/index.d.ts.map +1 -0
  76. package/dist/tools/generated/container_services/index.js +1806 -0
  77. package/dist/tools/generated/container_services/index.js.map +1 -0
  78. package/dist/tools/generated/data_and_privacy_security/index.d.ts +8 -0
  79. package/dist/tools/generated/data_and_privacy_security/index.d.ts.map +1 -0
  80. package/dist/tools/generated/data_and_privacy_security/index.js +1519 -0
  81. package/dist/tools/generated/data_and_privacy_security/index.js.map +1 -0
  82. package/dist/tools/generated/data_intelligence/index.d.ts +8 -0
  83. package/dist/tools/generated/data_intelligence/index.d.ts.map +1 -0
  84. package/dist/tools/generated/data_intelligence/index.js +1495 -0
  85. package/dist/tools/generated/data_intelligence/index.js.map +1 -0
  86. package/dist/tools/generated/ddos/index.d.ts +8 -0
  87. package/dist/tools/generated/ddos/index.d.ts.map +1 -0
  88. package/dist/tools/generated/ddos/index.js +7427 -0
  89. package/dist/tools/generated/ddos/index.js.map +1 -0
  90. package/dist/tools/generated/dns/index.d.ts +8 -0
  91. package/dist/tools/generated/dns/index.d.ts.map +1 -0
  92. package/dist/tools/generated/dns/index.js +5604 -0
  93. package/dist/tools/generated/dns/index.js.map +1 -0
  94. package/dist/tools/generated/generative_ai/index.d.ts +8 -0
  95. package/dist/tools/generated/generative_ai/index.d.ts.map +1 -0
  96. package/dist/tools/generated/generative_ai/index.js +972 -0
  97. package/dist/tools/generated/generative_ai/index.js.map +1 -0
  98. package/dist/tools/generated/managed_kubernetes/index.d.ts +8 -0
  99. package/dist/tools/generated/managed_kubernetes/index.d.ts.map +1 -0
  100. package/dist/tools/generated/managed_kubernetes/index.js +2858 -0
  101. package/dist/tools/generated/managed_kubernetes/index.js.map +1 -0
  102. package/dist/tools/generated/marketplace/index.d.ts +8 -0
  103. package/dist/tools/generated/marketplace/index.d.ts.map +1 -0
  104. package/dist/tools/generated/marketplace/index.js +4022 -0
  105. package/dist/tools/generated/marketplace/index.js.map +1 -0
  106. package/dist/tools/generated/network/index.d.ts +8 -0
  107. package/dist/tools/generated/network/index.d.ts.map +1 -0
  108. package/dist/tools/generated/network/index.js +11132 -0
  109. package/dist/tools/generated/network/index.js.map +1 -0
  110. package/dist/tools/generated/network_security/index.d.ts +8 -0
  111. package/dist/tools/generated/network_security/index.d.ts.map +1 -0
  112. package/dist/tools/generated/network_security/index.js +7827 -0
  113. package/dist/tools/generated/network_security/index.js.map +1 -0
  114. package/dist/tools/generated/nginx_one/index.d.ts +8 -0
  115. package/dist/tools/generated/nginx_one/index.d.ts.map +1 -0
  116. package/dist/tools/generated/nginx_one/index.js +1598 -0
  117. package/dist/tools/generated/nginx_one/index.js.map +1 -0
  118. package/dist/tools/generated/object_storage/index.d.ts +8 -0
  119. package/dist/tools/generated/object_storage/index.d.ts.map +1 -0
  120. package/dist/tools/generated/object_storage/index.js +964 -0
  121. package/dist/tools/generated/object_storage/index.js.map +1 -0
  122. package/dist/tools/generated/observability/index.d.ts.map +1 -1
  123. package/dist/tools/generated/observability/index.js +3521 -4641
  124. package/dist/tools/generated/observability/index.js.map +1 -1
  125. package/dist/tools/generated/rate_limiting/index.d.ts +8 -0
  126. package/dist/tools/generated/rate_limiting/index.d.ts.map +1 -0
  127. package/dist/tools/generated/rate_limiting/index.js +1712 -0
  128. package/dist/tools/generated/rate_limiting/index.js.map +1 -0
  129. package/dist/tools/generated/secops_and_incident_response/index.d.ts +8 -0
  130. package/dist/tools/generated/secops_and_incident_response/index.d.ts.map +1 -0
  131. package/dist/tools/generated/secops_and_incident_response/index.js +578 -0
  132. package/dist/tools/generated/secops_and_incident_response/index.js.map +1 -0
  133. package/dist/tools/generated/service_mesh/index.d.ts.map +1 -1
  134. package/dist/tools/generated/service_mesh/index.js +3810 -438
  135. package/dist/tools/generated/service_mesh/index.js.map +1 -1
  136. package/dist/tools/generated/shape/index.d.ts +8 -0
  137. package/dist/tools/generated/shape/index.d.ts.map +1 -0
  138. package/dist/tools/generated/shape/index.js +18464 -0
  139. package/dist/tools/generated/shape/index.js.map +1 -0
  140. package/dist/tools/generated/sites/index.d.ts +8 -0
  141. package/dist/tools/generated/sites/index.d.ts.map +1 -0
  142. package/dist/tools/generated/sites/index.js +11494 -0
  143. package/dist/tools/generated/sites/index.js.map +1 -0
  144. package/dist/tools/generated/statistics/index.d.ts +8 -0
  145. package/dist/tools/generated/statistics/index.d.ts.map +1 -0
  146. package/dist/tools/generated/statistics/index.js +7557 -0
  147. package/dist/tools/generated/statistics/index.js.map +1 -0
  148. package/dist/tools/generated/support/index.d.ts +8 -0
  149. package/dist/tools/generated/support/index.d.ts.map +1 -0
  150. package/dist/tools/generated/support/index.js +5334 -0
  151. package/dist/tools/generated/support/index.js.map +1 -0
  152. package/dist/tools/generated/telemetry_and_insights/index.d.ts +8 -0
  153. package/dist/tools/generated/telemetry_and_insights/index.d.ts.map +1 -0
  154. package/dist/tools/generated/telemetry_and_insights/index.js +2304 -0
  155. package/dist/tools/generated/telemetry_and_insights/index.js.map +1 -0
  156. package/dist/tools/generated/tenant_and_identity/index.d.ts +8 -0
  157. package/dist/tools/generated/tenant_and_identity/index.d.ts.map +1 -0
  158. package/dist/tools/generated/tenant_and_identity/index.js +17560 -0
  159. package/dist/tools/generated/tenant_and_identity/index.js.map +1 -0
  160. package/dist/tools/generated/threat_campaign/index.d.ts +8 -0
  161. package/dist/tools/generated/threat_campaign/index.d.ts.map +1 -0
  162. package/dist/tools/generated/threat_campaign/index.js +99 -0
  163. package/dist/tools/generated/threat_campaign/index.js.map +1 -0
  164. package/dist/tools/generated/users/index.d.ts +8 -0
  165. package/dist/tools/generated/users/index.d.ts.map +1 -0
  166. package/dist/tools/generated/users/index.js +1376 -0
  167. package/dist/tools/generated/users/index.js.map +1 -0
  168. package/dist/tools/generated/virtual/index.d.ts +8 -0
  169. package/dist/tools/generated/virtual/index.d.ts.map +1 -0
  170. package/dist/tools/generated/virtual/index.js +10103 -0
  171. package/dist/tools/generated/virtual/index.js.map +1 -0
  172. package/dist/tools/generated/vpm_and_node_management/index.d.ts +8 -0
  173. package/dist/tools/generated/vpm_and_node_management/index.d.ts.map +1 -0
  174. package/dist/tools/generated/vpm_and_node_management/index.js +85 -0
  175. package/dist/tools/generated/vpm_and_node_management/index.js.map +1 -0
  176. package/dist/tools/generated/waf/index.d.ts +8 -0
  177. package/dist/tools/generated/waf/index.d.ts.map +1 -0
  178. package/dist/tools/generated/waf/index.js +3802 -0
  179. package/dist/tools/generated/waf/index.js.map +1 -0
  180. package/dist/tools/registry.d.ts.map +1 -1
  181. package/dist/tools/registry.js +68 -36
  182. package/dist/tools/registry.js.map +1 -1
  183. package/package.json +3 -1
  184. package/dist/cli/index.d.ts +0 -16
  185. package/dist/cli/index.d.ts.map +0 -1
  186. package/dist/cli/index.js +0 -116
  187. package/dist/cli/index.js.map +0 -1
  188. package/dist/cli/setup.d.ts +0 -54
  189. package/dist/cli/setup.d.ts.map +0 -1
  190. package/dist/cli/setup.js +0 -347
  191. package/dist/cli/setup.js.map +0 -1
  192. package/dist/tools/generated/ai_intelligence/index.d.ts +0 -8
  193. package/dist/tools/generated/ai_intelligence/index.d.ts.map +0 -1
  194. package/dist/tools/generated/ai_intelligence/index.js +0 -282
  195. package/dist/tools/generated/ai_intelligence/index.js.map +0 -1
  196. package/dist/tools/generated/api_security/index.d.ts +0 -8
  197. package/dist/tools/generated/api_security/index.d.ts.map +0 -1
  198. package/dist/tools/generated/api_security/index.js +0 -1852
  199. package/dist/tools/generated/api_security/index.js.map +0 -1
  200. package/dist/tools/generated/applications/index.d.ts +0 -8
  201. package/dist/tools/generated/applications/index.d.ts.map +0 -1
  202. package/dist/tools/generated/applications/index.js +0 -1589
  203. package/dist/tools/generated/applications/index.js.map +0 -1
  204. package/dist/tools/generated/billing/index.d.ts +0 -8
  205. package/dist/tools/generated/billing/index.d.ts.map +0 -1
  206. package/dist/tools/generated/billing/index.js +0 -759
  207. package/dist/tools/generated/billing/index.js.map +0 -1
  208. package/dist/tools/generated/config/index.d.ts +0 -8
  209. package/dist/tools/generated/config/index.d.ts.map +0 -1
  210. package/dist/tools/generated/config/index.js +0 -316
  211. package/dist/tools/generated/config/index.js.map +0 -1
  212. package/dist/tools/generated/identity/index.d.ts +0 -8
  213. package/dist/tools/generated/identity/index.d.ts.map +0 -1
  214. package/dist/tools/generated/identity/index.js +0 -5371
  215. package/dist/tools/generated/identity/index.js.map +0 -1
  216. package/dist/tools/generated/infrastructure/index.d.ts +0 -8
  217. package/dist/tools/generated/infrastructure/index.d.ts.map +0 -1
  218. package/dist/tools/generated/infrastructure/index.js +0 -5342
  219. package/dist/tools/generated/infrastructure/index.js.map +0 -1
  220. package/dist/tools/generated/infrastructure_protection/index.d.ts +0 -8
  221. package/dist/tools/generated/infrastructure_protection/index.d.ts.map +0 -1
  222. package/dist/tools/generated/infrastructure_protection/index.js +0 -2919
  223. package/dist/tools/generated/infrastructure_protection/index.js.map +0 -1
  224. package/dist/tools/generated/integrations/index.d.ts +0 -8
  225. package/dist/tools/generated/integrations/index.d.ts.map +0 -1
  226. package/dist/tools/generated/integrations/index.js +0 -1995
  227. package/dist/tools/generated/integrations/index.js.map +0 -1
  228. package/dist/tools/generated/load_balancer/index.d.ts +0 -8
  229. package/dist/tools/generated/load_balancer/index.d.ts.map +0 -1
  230. package/dist/tools/generated/load_balancer/index.js +0 -2269
  231. package/dist/tools/generated/load_balancer/index.js.map +0 -1
  232. package/dist/tools/generated/networking/index.d.ts +0 -8
  233. package/dist/tools/generated/networking/index.d.ts.map +0 -1
  234. package/dist/tools/generated/networking/index.js +0 -11289
  235. package/dist/tools/generated/networking/index.js.map +0 -1
  236. package/dist/tools/generated/nginx/index.d.ts +0 -8
  237. package/dist/tools/generated/nginx/index.d.ts.map +0 -1
  238. package/dist/tools/generated/nginx/index.js +0 -680
  239. package/dist/tools/generated/nginx/index.js.map +0 -1
  240. package/dist/tools/generated/operations/index.d.ts +0 -8
  241. package/dist/tools/generated/operations/index.d.ts.map +0 -1
  242. package/dist/tools/generated/operations/index.js +0 -1759
  243. package/dist/tools/generated/operations/index.js.map +0 -1
  244. package/dist/tools/generated/security/index.d.ts +0 -8
  245. package/dist/tools/generated/security/index.d.ts.map +0 -1
  246. package/dist/tools/generated/security/index.js +0 -9111
  247. package/dist/tools/generated/security/index.js.map +0 -1
  248. package/dist/tools/generated/shape_security/index.d.ts +0 -8
  249. package/dist/tools/generated/shape_security/index.d.ts.map +0 -1
  250. package/dist/tools/generated/shape_security/index.js +0 -4121
  251. package/dist/tools/generated/shape_security/index.js.map +0 -1
  252. package/dist/tools/generated/subscriptions/index.d.ts +0 -8
  253. package/dist/tools/generated/subscriptions/index.d.ts.map +0 -1
  254. package/dist/tools/generated/subscriptions/index.js +0 -778
  255. package/dist/tools/generated/subscriptions/index.js.map +0 -1
  256. package/dist/tools/generated/tenant_management/index.d.ts +0 -8
  257. package/dist/tools/generated/tenant_management/index.d.ts.map +0 -1
  258. package/dist/tools/generated/tenant_management/index.js +0 -2292
  259. package/dist/tools/generated/tenant_management/index.js.map +0 -1
  260. package/dist/tools/generated/vpn/index.d.ts +0 -8
  261. package/dist/tools/generated/vpn/index.js +0 -1183
  262. package/dist/tools/generated/vpn/index.js.map +0 -1
@@ -0,0 +1,3802 @@
1
+ /**
2
+ * Generated tool definitions for waf domain
3
+ * DO NOT EDIT - This file is auto-generated by scripts/generate.ts
4
+ */
5
+ export const wafTools = [
6
+ {
7
+ toolName: "f5xc-api-waf-active-staged-signature-list",
8
+ method: "GET",
9
+ path: "/api/config/namespaces/{namespace}/virtual_hosts/{vh_name}/active_staged_signatures",
10
+ operation: "list",
11
+ domain: "waf",
12
+ resource: "active-staged-signature",
13
+ summary: "Active Staged Signatures.",
14
+ description: "API to GET active Staged Signatures.",
15
+ pathParameters: [
16
+ {
17
+ description: "Namespace\nFetch WAF signatures changelog for the given namespace.",
18
+ in: "path",
19
+ name: "namespace",
20
+ required: true,
21
+ schema: {
22
+ type: "string",
23
+ },
24
+ "x-displayname": "Namespace",
25
+ "x-ves-example": "Shared",
26
+ },
27
+ {
28
+ description: "Vh_name\nVirtual Host for current request.",
29
+ in: "path",
30
+ name: "vh_name",
31
+ required: true,
32
+ schema: {
33
+ type: "string",
34
+ },
35
+ "x-displayname": "Virtual Host Name.",
36
+ "x-ves-example": "Blogging-app.",
37
+ },
38
+ ],
39
+ queryParameters: [],
40
+ requestBodySchema: null,
41
+ responseSchema: {
42
+ $ref: "#/components/schemas/waf_signatures_changelogReleasedSignaturesRsp",
43
+ },
44
+ requiredParams: ["namespace", "vh_name"],
45
+ operationId: "ves.io.schema.waf_signatures_changelog.WafSignatureChangelogCustomApi.GetActiveStagedSignatures",
46
+ tags: ["Other"],
47
+ sourceFile: "domains/waf.json",
48
+ displayName: null,
49
+ dangerLevel: "low",
50
+ sideEffects: null,
51
+ requiredFields: ["path.namespace", "path.vh_name"],
52
+ confirmationRequired: false,
53
+ parameterExamples: {
54
+ namespace: "Shared",
55
+ vh_name: "Blogging-app.",
56
+ },
57
+ validationRules: {},
58
+ operationMetadata: {
59
+ common_errors: [
60
+ {
61
+ code: 401,
62
+ message: "Authentication required",
63
+ solution: "Provide valid API credentials",
64
+ },
65
+ {
66
+ code: 403,
67
+ message: "Permission denied",
68
+ solution: "Check access permissions for this operation",
69
+ },
70
+ {
71
+ code: 404,
72
+ message: "Resource not found",
73
+ solution: "Verify resource name, namespace, and path",
74
+ },
75
+ {
76
+ code: 409,
77
+ message: "Resource already exists",
78
+ solution: "Use different name or update existing resource",
79
+ },
80
+ {
81
+ code: 429,
82
+ message: "Rate limit exceeded",
83
+ solution: "Wait before retrying the operation",
84
+ },
85
+ {
86
+ code: 500,
87
+ message: "Server error",
88
+ solution: "Retry operation or contact support",
89
+ },
90
+ ],
91
+ conditions: {
92
+ postconditions: [],
93
+ prerequisites: ["Active namespace"],
94
+ },
95
+ confirmation_required: false,
96
+ danger_level: "low",
97
+ field_docs: {},
98
+ optional_fields: [],
99
+ performance_impact: {
100
+ latency: "moderate",
101
+ resource_usage: "moderate",
102
+ },
103
+ purpose: "List all active-staged-signatures",
104
+ required_fields: ["path.namespace", "path.vh_name"],
105
+ side_effects: {},
106
+ },
107
+ curlExample: null,
108
+ },
109
+ {
110
+ toolName: "f5xc-api-waf-aggregation-create",
111
+ method: "POST",
112
+ path: "/api/data/namespaces/system/app_security/all_ns_events/aggregation",
113
+ operation: "create",
114
+ domain: "waf",
115
+ resource: "aggregation",
116
+ summary: "Security Events Aggregation Query All Namespaces.",
117
+ description: "GET summary/aggregation data for security events in the given namespace.\nFor `system` namespace, all security events for the tenant matching the query specified\nin the request will be considered for aggregation. User may query security events that matches various\nfields such as `vh_name`, `sec_event_type`, `src_site`, `city`, `country`.",
118
+ pathParameters: [],
119
+ queryParameters: [],
120
+ requestBodySchema: null,
121
+ responseSchema: {
122
+ $ref: "#/components/schemas/app_securitySecurityEventsAggregationResponse",
123
+ },
124
+ requiredParams: [],
125
+ operationId: "ves.io.schema.app_security.AppSecurityMonitoringAPI.SecurityEventsAggregationQueryAllNamespaces",
126
+ tags: ["Other"],
127
+ sourceFile: "domains/waf.json",
128
+ displayName: null,
129
+ dangerLevel: "medium",
130
+ sideEffects: {
131
+ creates: ["aggregation"],
132
+ },
133
+ requiredFields: ["metadata.name", "metadata.namespace"],
134
+ confirmationRequired: false,
135
+ parameterExamples: {},
136
+ validationRules: {},
137
+ operationMetadata: {
138
+ common_errors: [
139
+ {
140
+ code: 401,
141
+ message: "Authentication required",
142
+ solution: "Provide valid API credentials",
143
+ },
144
+ {
145
+ code: 403,
146
+ message: "Permission denied",
147
+ solution: "Check access permissions for this operation",
148
+ },
149
+ {
150
+ code: 404,
151
+ message: "Resource not found",
152
+ solution: "Verify resource name, namespace, and path",
153
+ },
154
+ {
155
+ code: 409,
156
+ message: "Resource already exists",
157
+ solution: "Use different name or update existing resource",
158
+ },
159
+ {
160
+ code: 429,
161
+ message: "Rate limit exceeded",
162
+ solution: "Wait before retrying the operation",
163
+ },
164
+ {
165
+ code: 500,
166
+ message: "Server error",
167
+ solution: "Retry operation or contact support",
168
+ },
169
+ ],
170
+ conditions: {
171
+ postconditions: ["Aggregation resource created", "Resource assigned unique identifier"],
172
+ prerequisites: ["Active namespace"],
173
+ },
174
+ confirmation_required: false,
175
+ danger_level: "medium",
176
+ field_docs: {},
177
+ optional_fields: [],
178
+ performance_impact: {
179
+ latency: "low",
180
+ resource_usage: "low",
181
+ },
182
+ purpose: "Create new aggregation",
183
+ required_fields: ["metadata.name", "metadata.namespace"],
184
+ side_effects: {
185
+ creates: ["aggregation"],
186
+ },
187
+ },
188
+ curlExample: null,
189
+ },
190
+ {
191
+ toolName: "f5xc-api-waf-all-ns-event-create",
192
+ method: "POST",
193
+ path: "/api/data/namespaces/system/app_security/all_ns_events",
194
+ operation: "create",
195
+ domain: "waf",
196
+ resource: "all-ns-event",
197
+ summary: "Security Events Query All Namespaces.",
198
+ description: "GET security events for the given namespace.\nFor `system` namespace, all security events for the tenant matching the query specified\nin the request will be returned in the response. User may query security events that matches various\nfields such as `vh_name`, `sec_event_type`, `src_site`, `city`, `country`.\nThis API is specific to system namespace.",
199
+ pathParameters: [],
200
+ queryParameters: [],
201
+ requestBodySchema: null,
202
+ responseSchema: {
203
+ $ref: "#/components/schemas/app_securitySecurityEventsResponse",
204
+ },
205
+ requiredParams: [],
206
+ operationId: "ves.io.schema.app_security.AppSecurityMonitoringAPI.SecurityEventsQueryAllNamespaces",
207
+ tags: ["Other"],
208
+ sourceFile: "domains/waf.json",
209
+ displayName: null,
210
+ dangerLevel: "medium",
211
+ sideEffects: {
212
+ creates: ["all-ns-event"],
213
+ },
214
+ requiredFields: ["metadata.name", "metadata.namespace"],
215
+ confirmationRequired: false,
216
+ parameterExamples: {},
217
+ validationRules: {},
218
+ operationMetadata: {
219
+ common_errors: [
220
+ {
221
+ code: 401,
222
+ message: "Authentication required",
223
+ solution: "Provide valid API credentials",
224
+ },
225
+ {
226
+ code: 403,
227
+ message: "Permission denied",
228
+ solution: "Check access permissions for this operation",
229
+ },
230
+ {
231
+ code: 404,
232
+ message: "Resource not found",
233
+ solution: "Verify resource name, namespace, and path",
234
+ },
235
+ {
236
+ code: 409,
237
+ message: "Resource already exists",
238
+ solution: "Use different name or update existing resource",
239
+ },
240
+ {
241
+ code: 429,
242
+ message: "Rate limit exceeded",
243
+ solution: "Wait before retrying the operation",
244
+ },
245
+ {
246
+ code: 500,
247
+ message: "Server error",
248
+ solution: "Retry operation or contact support",
249
+ },
250
+ ],
251
+ conditions: {
252
+ postconditions: ["All-ns-event resource created", "Resource assigned unique identifier"],
253
+ prerequisites: ["Active namespace"],
254
+ },
255
+ confirmation_required: false,
256
+ danger_level: "medium",
257
+ field_docs: {},
258
+ optional_fields: [],
259
+ performance_impact: {
260
+ latency: "low",
261
+ resource_usage: "low",
262
+ },
263
+ purpose: "Create new all-ns-event",
264
+ required_fields: ["metadata.name", "metadata.namespace"],
265
+ side_effects: {
266
+ creates: ["all-ns-event"],
267
+ },
268
+ },
269
+ curlExample: null,
270
+ },
271
+ {
272
+ toolName: "f5xc-api-waf-all-ns-metric-create",
273
+ method: "POST",
274
+ path: "/api/data/namespaces/system/app_firewall/all_ns_metrics",
275
+ operation: "create",
276
+ domain: "waf",
277
+ resource: "all-ns-metric",
278
+ summary: "MetricsAllNamespaces.",
279
+ description: "App Firewall metrics.",
280
+ pathParameters: [],
281
+ queryParameters: [],
282
+ requestBodySchema: null,
283
+ responseSchema: {
284
+ $ref: "#/components/schemas/app_firewallMetricsResponse",
285
+ },
286
+ requiredParams: [],
287
+ operationId: "ves.io.schema.app_firewall.CustomDataAPI.MetricsAllNamespaces",
288
+ tags: ["Security"],
289
+ sourceFile: "domains/waf.json",
290
+ displayName: null,
291
+ dangerLevel: "medium",
292
+ sideEffects: {
293
+ creates: ["all-ns-metric"],
294
+ },
295
+ requiredFields: ["metadata.name", "metadata.namespace"],
296
+ confirmationRequired: false,
297
+ parameterExamples: {},
298
+ validationRules: {},
299
+ operationMetadata: {
300
+ common_errors: [
301
+ {
302
+ code: 401,
303
+ message: "Authentication required",
304
+ solution: "Provide valid API credentials",
305
+ },
306
+ {
307
+ code: 403,
308
+ message: "Permission denied",
309
+ solution: "Check access permissions for this operation",
310
+ },
311
+ {
312
+ code: 404,
313
+ message: "Resource not found",
314
+ solution: "Verify resource name, namespace, and path",
315
+ },
316
+ {
317
+ code: 409,
318
+ message: "Resource already exists",
319
+ solution: "Use different name or update existing resource",
320
+ },
321
+ {
322
+ code: 429,
323
+ message: "Rate limit exceeded",
324
+ solution: "Wait before retrying the operation",
325
+ },
326
+ {
327
+ code: 500,
328
+ message: "Server error",
329
+ solution: "Retry operation or contact support",
330
+ },
331
+ ],
332
+ conditions: {
333
+ postconditions: ["All-ns-metric resource created", "Resource assigned unique identifier"],
334
+ prerequisites: ["Active namespace"],
335
+ },
336
+ confirmation_required: false,
337
+ danger_level: "medium",
338
+ field_docs: {},
339
+ optional_fields: [],
340
+ performance_impact: {
341
+ latency: "low",
342
+ resource_usage: "low",
343
+ },
344
+ purpose: "Create new all-ns-metric",
345
+ required_fields: ["metadata.name", "metadata.namespace"],
346
+ side_effects: {
347
+ creates: ["all-ns-metric"],
348
+ },
349
+ },
350
+ curlExample: null,
351
+ },
352
+ {
353
+ toolName: "f5xc-api-waf-app-firewall-create",
354
+ method: "POST",
355
+ path: "/api/config/namespaces/{metadata.namespace}/app_firewalls",
356
+ operation: "create",
357
+ domain: "waf",
358
+ resource: "app-firewall",
359
+ summary: "Create Application Firewall.",
360
+ description: "Create Application Firewall.",
361
+ pathParameters: [
362
+ {
363
+ description: 'Namespace\nThis defines the workspace within which each the configuration object is to be created.\nMust be a DNS_LABEL format. For a namespace object itself, namespace value will be ""',
364
+ in: "path",
365
+ name: "metadata.namespace",
366
+ required: true,
367
+ schema: {
368
+ type: "string",
369
+ },
370
+ "x-displayname": "Namespace",
371
+ "x-ves-example": "Staging",
372
+ },
373
+ ],
374
+ queryParameters: [],
375
+ requestBodySchema: {
376
+ $ref: "#/components/schemas/app_firewallCreateRequest",
377
+ },
378
+ responseSchema: {
379
+ $ref: "#/components/schemas/app_firewallCreateResponse",
380
+ },
381
+ requiredParams: ["body", "metadata.namespace"],
382
+ operationId: "ves.io.schema.app_firewall.API.Create",
383
+ tags: ["Other"],
384
+ sourceFile: "domains/waf.json",
385
+ displayName: null,
386
+ dangerLevel: "medium",
387
+ sideEffects: {
388
+ creates: ["app-firewall"],
389
+ },
390
+ requiredFields: ["metadata.name", "metadata.namespace", "path.metadata.namespace"],
391
+ confirmationRequired: false,
392
+ parameterExamples: {
393
+ "metadata.namespace": "Staging",
394
+ },
395
+ validationRules: {},
396
+ operationMetadata: {
397
+ common_errors: [
398
+ {
399
+ code: 401,
400
+ message: "Authentication required",
401
+ solution: "Provide valid API credentials",
402
+ },
403
+ {
404
+ code: 403,
405
+ message: "Permission denied",
406
+ solution: "Check access permissions for this operation",
407
+ },
408
+ {
409
+ code: 404,
410
+ message: "Resource not found",
411
+ solution: "Verify resource name, namespace, and path",
412
+ },
413
+ {
414
+ code: 409,
415
+ message: "Resource already exists",
416
+ solution: "Use different name or update existing resource",
417
+ },
418
+ {
419
+ code: 429,
420
+ message: "Rate limit exceeded",
421
+ solution: "Wait before retrying the operation",
422
+ },
423
+ {
424
+ code: 500,
425
+ message: "Server error",
426
+ solution: "Retry operation or contact support",
427
+ },
428
+ ],
429
+ conditions: {
430
+ postconditions: ["App-firewall resource created", "Resource assigned unique identifier"],
431
+ prerequisites: ["Active namespace"],
432
+ },
433
+ confirmation_required: false,
434
+ danger_level: "medium",
435
+ field_docs: {},
436
+ optional_fields: [],
437
+ performance_impact: {
438
+ latency: "low",
439
+ resource_usage: "low",
440
+ },
441
+ purpose: "Create new app-firewall",
442
+ required_fields: ["metadata.name", "metadata.namespace", "path.metadata.namespace"],
443
+ side_effects: {
444
+ creates: ["app-firewall"],
445
+ },
446
+ },
447
+ curlExample: 'curl -X POST "$F5XC_API_URL/api/config/namespaces/default/app_firewalls" \\\n -H "Authorization: APIToken $F5XC_API_TOKEN" \\\n -H "Content-Type: application/json" \\\n -d @waf-policy.json\n',
448
+ },
449
+ {
450
+ toolName: "f5xc-api-waf-app-firewall-delete",
451
+ method: "DELETE",
452
+ path: "/api/config/namespaces/{namespace}/app_firewalls/{name}",
453
+ operation: "delete",
454
+ domain: "waf",
455
+ resource: "app-firewall",
456
+ summary: "DELETE Application Firewall.",
457
+ description: "DELETE the specified app_firewall.",
458
+ pathParameters: [
459
+ {
460
+ description: "Name\nName of the configuration object.",
461
+ in: "path",
462
+ name: "name",
463
+ required: true,
464
+ schema: {
465
+ type: "string",
466
+ },
467
+ "x-displayname": "Name",
468
+ "x-ves-example": "Name",
469
+ },
470
+ {
471
+ description: "Namespace\nNamespace in which the configuration object is present.",
472
+ in: "path",
473
+ name: "namespace",
474
+ required: true,
475
+ schema: {
476
+ type: "string",
477
+ },
478
+ "x-displayname": "Namespace",
479
+ "x-ves-example": "Ns1",
480
+ },
481
+ ],
482
+ queryParameters: [],
483
+ requestBodySchema: {
484
+ $ref: "#/components/schemas/app_firewallDeleteRequest",
485
+ },
486
+ responseSchema: {},
487
+ requiredParams: ["body", "name", "namespace"],
488
+ operationId: "ves.io.schema.app_firewall.API.Delete",
489
+ tags: ["Other"],
490
+ sourceFile: "domains/waf.json",
491
+ displayName: null,
492
+ dangerLevel: "high",
493
+ sideEffects: {
494
+ deletes: ["app-firewall", "contained_resources"],
495
+ },
496
+ requiredFields: ["path.name", "path.namespace"],
497
+ confirmationRequired: true,
498
+ parameterExamples: {
499
+ name: "Name",
500
+ namespace: "Ns1",
501
+ },
502
+ validationRules: {},
503
+ operationMetadata: {
504
+ common_errors: [
505
+ {
506
+ code: 401,
507
+ message: "Authentication required",
508
+ solution: "Provide valid API credentials",
509
+ },
510
+ {
511
+ code: 403,
512
+ message: "Permission denied",
513
+ solution: "Check access permissions for this operation",
514
+ },
515
+ {
516
+ code: 404,
517
+ message: "Resource not found",
518
+ solution: "Verify resource name, namespace, and path",
519
+ },
520
+ {
521
+ code: 409,
522
+ message: "Resource already exists",
523
+ solution: "Use different name or update existing resource",
524
+ },
525
+ {
526
+ code: 429,
527
+ message: "Rate limit exceeded",
528
+ solution: "Wait before retrying the operation",
529
+ },
530
+ {
531
+ code: 500,
532
+ message: "Server error",
533
+ solution: "Retry operation or contact support",
534
+ },
535
+ ],
536
+ conditions: {
537
+ postconditions: ["Resource removed from system", "Associated resources may be affected"],
538
+ prerequisites: ["Active namespace"],
539
+ },
540
+ confirmation_required: true,
541
+ danger_level: "high",
542
+ field_docs: {},
543
+ optional_fields: [],
544
+ performance_impact: {
545
+ latency: "high",
546
+ resource_usage: "moderate",
547
+ },
548
+ purpose: "Delete app-firewall",
549
+ required_fields: ["path.name", "path.namespace"],
550
+ side_effects: {
551
+ deletes: ["app-firewall", "contained_resources"],
552
+ },
553
+ },
554
+ curlExample: 'curl -X POST "$F5XC_API_URL/api/config/namespaces/default/app_firewalls" \\\n -H "Authorization: APIToken $F5XC_API_TOKEN" \\\n -H "Content-Type: application/json" \\\n -d @waf-policy.json\n',
555
+ },
556
+ {
557
+ toolName: "f5xc-api-waf-app-firewall-get",
558
+ method: "GET",
559
+ path: "/api/config/namespaces/{namespace}/app_firewalls/{name}",
560
+ operation: "get",
561
+ domain: "waf",
562
+ resource: "app-firewall",
563
+ summary: "GET Application Firewall.",
564
+ description: "GET Application Firewall.",
565
+ pathParameters: [
566
+ {
567
+ description: "Name\nThe name of the configuration object to be fetched.",
568
+ in: "path",
569
+ name: "name",
570
+ required: true,
571
+ schema: {
572
+ type: "string",
573
+ },
574
+ "x-displayname": "Name",
575
+ "x-ves-example": "Name",
576
+ },
577
+ {
578
+ description: "Namespace\nThe namespace in which the configuration object is present.",
579
+ in: "path",
580
+ name: "namespace",
581
+ required: true,
582
+ schema: {
583
+ type: "string",
584
+ },
585
+ "x-displayname": "Namespace",
586
+ "x-ves-example": "Ns1",
587
+ },
588
+ ],
589
+ queryParameters: [
590
+ {
591
+ description: "The format in which the configuration object is to be fetched. This could be for example\n - in GetSpec form for the contents of object\n - in CreateRequest form to create a new similar object\n - to ReplaceRequest form to replace changeable values\n\nDefault format of returned resource\nResponse should be in CreateRequest format\nResponse should be in ReplaceRequest format\nResponse should be in StatusObject(s) format\nResponse should be in format of GetSpecType\nResponse should have other objects referring to this object\nResponse should have deleted and disabled objects referrred by this object.",
592
+ in: "query",
593
+ name: "response_format",
594
+ required: false,
595
+ schema: {
596
+ default: "GET_RSP_FORMAT_DEFAULT",
597
+ enum: [
598
+ "GET_RSP_FORMAT_DEFAULT",
599
+ "GET_RSP_FORMAT_FOR_CREATE",
600
+ "GET_RSP_FORMAT_FOR_REPLACE",
601
+ "GET_RSP_FORMAT_STATUS",
602
+ "GET_RSP_FORMAT_READ",
603
+ "GET_RSP_FORMAT_REFERRING_OBJECTS",
604
+ "GET_RSP_FORMAT_BROKEN_REFERENCES",
605
+ ],
606
+ type: "string",
607
+ },
608
+ "x-displayname": "Broken Referred Objects.",
609
+ },
610
+ ],
611
+ requestBodySchema: null,
612
+ responseSchema: {
613
+ $ref: "#/components/schemas/app_firewallGetResponse",
614
+ },
615
+ requiredParams: ["name", "namespace"],
616
+ operationId: "ves.io.schema.app_firewall.API.Get",
617
+ tags: ["Other"],
618
+ sourceFile: "domains/waf.json",
619
+ displayName: null,
620
+ dangerLevel: "low",
621
+ sideEffects: null,
622
+ requiredFields: ["path.name", "path.namespace"],
623
+ confirmationRequired: false,
624
+ parameterExamples: {
625
+ name: "Name",
626
+ namespace: "Ns1",
627
+ },
628
+ validationRules: {},
629
+ operationMetadata: {
630
+ common_errors: [
631
+ {
632
+ code: 401,
633
+ message: "Authentication required",
634
+ solution: "Provide valid API credentials",
635
+ },
636
+ {
637
+ code: 403,
638
+ message: "Permission denied",
639
+ solution: "Check access permissions for this operation",
640
+ },
641
+ {
642
+ code: 404,
643
+ message: "Resource not found",
644
+ solution: "Verify resource name, namespace, and path",
645
+ },
646
+ {
647
+ code: 409,
648
+ message: "Resource already exists",
649
+ solution: "Use different name or update existing resource",
650
+ },
651
+ {
652
+ code: 429,
653
+ message: "Rate limit exceeded",
654
+ solution: "Wait before retrying the operation",
655
+ },
656
+ {
657
+ code: 500,
658
+ message: "Server error",
659
+ solution: "Retry operation or contact support",
660
+ },
661
+ ],
662
+ conditions: {
663
+ postconditions: [],
664
+ prerequisites: ["Active namespace"],
665
+ },
666
+ confirmation_required: false,
667
+ danger_level: "low",
668
+ field_docs: {},
669
+ optional_fields: [],
670
+ performance_impact: {
671
+ latency: "low",
672
+ resource_usage: "low",
673
+ },
674
+ purpose: "Retrieve specific app-firewall",
675
+ required_fields: ["path.name", "path.namespace"],
676
+ side_effects: {},
677
+ },
678
+ curlExample: 'curl -X POST "$F5XC_API_URL/api/config/namespaces/default/app_firewalls" \\\n -H "Authorization: APIToken $F5XC_API_TOKEN" \\\n -H "Content-Type: application/json" \\\n -d @waf-policy.json\n',
679
+ },
680
+ {
681
+ toolName: "f5xc-api-waf-app-firewall-list",
682
+ method: "GET",
683
+ path: "/api/config/namespaces/{namespace}/app_firewalls",
684
+ operation: "list",
685
+ domain: "waf",
686
+ resource: "app-firewall",
687
+ summary: "List Application Firewall.",
688
+ description: "List the set of app_firewall in a namespace.",
689
+ pathParameters: [
690
+ {
691
+ description: "Namespace\nNamespace to scope the listing of app_firewall.",
692
+ in: "path",
693
+ name: "namespace",
694
+ required: true,
695
+ schema: {
696
+ type: "string",
697
+ },
698
+ "x-displayname": "Namespace",
699
+ "x-ves-example": "Ns1",
700
+ },
701
+ ],
702
+ queryParameters: [
703
+ {
704
+ description: "A LabelSelectorType expression that every item in list response will satisfy.",
705
+ in: "query",
706
+ name: "label_filter",
707
+ required: false,
708
+ schema: {
709
+ type: "string",
710
+ },
711
+ "x-displayname": "Label Filter.",
712
+ "x-ves-example": "Env in (staging, testing), tier in (web, db)",
713
+ },
714
+ {
715
+ description: 'X-example: ""\nExtra fields to return along with summary fields.',
716
+ in: "query",
717
+ name: "report_fields",
718
+ required: false,
719
+ schema: {
720
+ items: {
721
+ type: "string",
722
+ },
723
+ type: "array",
724
+ },
725
+ "x-displayname": "Report Fields.",
726
+ },
727
+ {
728
+ description: 'X-example: ""\nExtra status fields to return along with summary fields.',
729
+ in: "query",
730
+ name: "report_status_fields",
731
+ required: false,
732
+ schema: {
733
+ items: {
734
+ type: "string",
735
+ },
736
+ type: "array",
737
+ },
738
+ "x-displayname": "Report Status Fields.",
739
+ },
740
+ ],
741
+ requestBodySchema: null,
742
+ responseSchema: {
743
+ $ref: "#/components/schemas/app_firewallListResponse",
744
+ },
745
+ requiredParams: ["namespace"],
746
+ operationId: "ves.io.schema.app_firewall.API.List",
747
+ tags: ["Other"],
748
+ sourceFile: "domains/waf.json",
749
+ displayName: null,
750
+ dangerLevel: "low",
751
+ sideEffects: null,
752
+ requiredFields: ["path.namespace"],
753
+ confirmationRequired: false,
754
+ parameterExamples: {
755
+ label_filter: "Env in (staging, testing), tier in (web, db)",
756
+ namespace: "Ns1",
757
+ },
758
+ validationRules: {},
759
+ operationMetadata: {
760
+ common_errors: [
761
+ {
762
+ code: 401,
763
+ message: "Authentication required",
764
+ solution: "Provide valid API credentials",
765
+ },
766
+ {
767
+ code: 403,
768
+ message: "Permission denied",
769
+ solution: "Check access permissions for this operation",
770
+ },
771
+ {
772
+ code: 404,
773
+ message: "Resource not found",
774
+ solution: "Verify resource name, namespace, and path",
775
+ },
776
+ {
777
+ code: 409,
778
+ message: "Resource already exists",
779
+ solution: "Use different name or update existing resource",
780
+ },
781
+ {
782
+ code: 429,
783
+ message: "Rate limit exceeded",
784
+ solution: "Wait before retrying the operation",
785
+ },
786
+ {
787
+ code: 500,
788
+ message: "Server error",
789
+ solution: "Retry operation or contact support",
790
+ },
791
+ ],
792
+ conditions: {
793
+ postconditions: [],
794
+ prerequisites: ["Active namespace"],
795
+ },
796
+ confirmation_required: false,
797
+ danger_level: "low",
798
+ field_docs: {},
799
+ optional_fields: [],
800
+ performance_impact: {
801
+ latency: "moderate",
802
+ resource_usage: "moderate",
803
+ },
804
+ purpose: "List all app-firewalls",
805
+ required_fields: ["path.namespace"],
806
+ side_effects: {},
807
+ },
808
+ curlExample: 'curl -X POST "$F5XC_API_URL/api/config/namespaces/default/app_firewalls" \\\n -H "Authorization: APIToken $F5XC_API_TOKEN" \\\n -H "Content-Type: application/json" \\\n -d @waf-policy.json\n',
809
+ },
810
+ {
811
+ toolName: "f5xc-api-waf-app-firewall-update",
812
+ method: "PUT",
813
+ path: "/api/config/namespaces/{metadata.namespace}/app_firewalls/{metadata.name}",
814
+ operation: "update",
815
+ domain: "waf",
816
+ resource: "app-firewall",
817
+ summary: "Replace Application Firewall.",
818
+ description: "Replace Application Firewall.",
819
+ pathParameters: [
820
+ {
821
+ description: "Name\nThe configuration object to be replaced will be looked up by name.",
822
+ in: "path",
823
+ name: "metadata.name",
824
+ required: true,
825
+ schema: {
826
+ type: "string",
827
+ },
828
+ "x-displayname": "Name",
829
+ "x-ves-example": "Example-corp-web.",
830
+ },
831
+ {
832
+ description: 'Namespace\nThis defines the workspace within which each the configuration object is to be created.\nMust be a DNS_LABEL format. For a namespace object itself, namespace value will be ""',
833
+ in: "path",
834
+ name: "metadata.namespace",
835
+ required: true,
836
+ schema: {
837
+ type: "string",
838
+ },
839
+ "x-displayname": "Namespace",
840
+ "x-ves-example": "Staging",
841
+ },
842
+ ],
843
+ queryParameters: [],
844
+ requestBodySchema: {
845
+ $ref: "#/components/schemas/app_firewallReplaceRequest",
846
+ },
847
+ responseSchema: {
848
+ $ref: "#/components/schemas/app_firewallReplaceResponse",
849
+ },
850
+ requiredParams: ["body", "metadata.name", "metadata.namespace"],
851
+ operationId: "ves.io.schema.app_firewall.API.Replace",
852
+ tags: ["Other"],
853
+ sourceFile: "domains/waf.json",
854
+ displayName: null,
855
+ dangerLevel: "medium",
856
+ sideEffects: {
857
+ modifies: ["app-firewall"],
858
+ },
859
+ requiredFields: ["path.metadata.name", "path.metadata.namespace"],
860
+ confirmationRequired: false,
861
+ parameterExamples: {
862
+ "metadata.name": "Example-corp-web.",
863
+ "metadata.namespace": "Staging",
864
+ },
865
+ validationRules: {},
866
+ operationMetadata: {
867
+ common_errors: [
868
+ {
869
+ code: 401,
870
+ message: "Authentication required",
871
+ solution: "Provide valid API credentials",
872
+ },
873
+ {
874
+ code: 403,
875
+ message: "Permission denied",
876
+ solution: "Check access permissions for this operation",
877
+ },
878
+ {
879
+ code: 404,
880
+ message: "Resource not found",
881
+ solution: "Verify resource name, namespace, and path",
882
+ },
883
+ {
884
+ code: 409,
885
+ message: "Resource already exists",
886
+ solution: "Use different name or update existing resource",
887
+ },
888
+ {
889
+ code: 429,
890
+ message: "Rate limit exceeded",
891
+ solution: "Wait before retrying the operation",
892
+ },
893
+ {
894
+ code: 500,
895
+ message: "Server error",
896
+ solution: "Retry operation or contact support",
897
+ },
898
+ ],
899
+ conditions: {
900
+ postconditions: ["Resource updated with new values"],
901
+ prerequisites: ["Active namespace"],
902
+ },
903
+ confirmation_required: false,
904
+ danger_level: "medium",
905
+ field_docs: {},
906
+ optional_fields: [],
907
+ performance_impact: {
908
+ latency: "low",
909
+ resource_usage: "low",
910
+ },
911
+ purpose: "Replace existing app-firewall",
912
+ required_fields: ["path.metadata.name", "path.metadata.namespace"],
913
+ side_effects: {
914
+ modifies: ["app-firewall"],
915
+ },
916
+ },
917
+ curlExample: 'curl -X POST "$F5XC_API_URL/api/config/namespaces/default/app_firewalls" \\\n -H "Authorization: APIToken $F5XC_API_TOKEN" \\\n -H "Content-Type: application/json" \\\n -d @waf-policy.json\n',
918
+ },
919
+ {
920
+ toolName: "f5xc-api-waf-enhanced-firewall-policy-create",
921
+ method: "POST",
922
+ path: "/api/config/namespaces/{metadata.namespace}/enhanced_firewall_policys",
923
+ operation: "create",
924
+ domain: "waf",
925
+ resource: "enhanced-firewall-policy",
926
+ summary: "Create Enhanced Firewall Policy.",
927
+ description: "Shape of Enhanced Firewall Policy specification.",
928
+ pathParameters: [
929
+ {
930
+ description: 'Namespace\nThis defines the workspace within which each the configuration object is to be created.\nMust be a DNS_LABEL format. For a namespace object itself, namespace value will be ""',
931
+ in: "path",
932
+ name: "metadata.namespace",
933
+ required: true,
934
+ schema: {
935
+ type: "string",
936
+ },
937
+ "x-displayname": "Namespace",
938
+ "x-ves-example": "Staging",
939
+ },
940
+ ],
941
+ queryParameters: [],
942
+ requestBodySchema: {
943
+ $ref: "#/components/schemas/enhanced_firewall_policyCreateRequest",
944
+ },
945
+ responseSchema: {
946
+ $ref: "#/components/schemas/enhanced_firewall_policyCreateResponse",
947
+ },
948
+ requiredParams: ["body", "metadata.namespace"],
949
+ operationId: "ves.io.schema.enhanced_firewall_policy.API.Create",
950
+ tags: ["Other"],
951
+ sourceFile: "domains/waf.json",
952
+ displayName: null,
953
+ dangerLevel: "medium",
954
+ sideEffects: {
955
+ creates: ["enhanced-firewall-policy"],
956
+ },
957
+ requiredFields: ["metadata.name", "metadata.namespace", "path.metadata.namespace"],
958
+ confirmationRequired: false,
959
+ parameterExamples: {
960
+ "metadata.namespace": "Staging",
961
+ },
962
+ validationRules: {},
963
+ operationMetadata: {
964
+ common_errors: [
965
+ {
966
+ code: 401,
967
+ message: "Authentication required",
968
+ solution: "Provide valid API credentials",
969
+ },
970
+ {
971
+ code: 403,
972
+ message: "Permission denied",
973
+ solution: "Check access permissions for this operation",
974
+ },
975
+ {
976
+ code: 404,
977
+ message: "Resource not found",
978
+ solution: "Verify resource name, namespace, and path",
979
+ },
980
+ {
981
+ code: 409,
982
+ message: "Resource already exists",
983
+ solution: "Use different name or update existing resource",
984
+ },
985
+ {
986
+ code: 429,
987
+ message: "Rate limit exceeded",
988
+ solution: "Wait before retrying the operation",
989
+ },
990
+ {
991
+ code: 500,
992
+ message: "Server error",
993
+ solution: "Retry operation or contact support",
994
+ },
995
+ ],
996
+ conditions: {
997
+ postconditions: [
998
+ "Enhanced-firewall-policy resource created",
999
+ "Resource assigned unique identifier",
1000
+ ],
1001
+ prerequisites: ["Active namespace", "Policy parameters defined"],
1002
+ },
1003
+ confirmation_required: false,
1004
+ danger_level: "medium",
1005
+ field_docs: {},
1006
+ optional_fields: [],
1007
+ performance_impact: {
1008
+ latency: "low",
1009
+ resource_usage: "low",
1010
+ },
1011
+ purpose: "Create new enhanced-firewall-policy",
1012
+ required_fields: ["metadata.name", "metadata.namespace", "path.metadata.namespace"],
1013
+ side_effects: {
1014
+ creates: ["enhanced-firewall-policy"],
1015
+ },
1016
+ },
1017
+ curlExample: null,
1018
+ },
1019
+ {
1020
+ toolName: "f5xc-api-waf-enhanced-firewall-policy-delete",
1021
+ method: "DELETE",
1022
+ path: "/api/config/namespaces/{namespace}/enhanced_firewall_policys/{name}",
1023
+ operation: "delete",
1024
+ domain: "waf",
1025
+ resource: "enhanced-firewall-policy",
1026
+ summary: "DELETE Enhanced Firewall Policy.",
1027
+ description: "DELETE the specified enhanced_firewall_policy.",
1028
+ pathParameters: [
1029
+ {
1030
+ description: "Name\nName of the configuration object.",
1031
+ in: "path",
1032
+ name: "name",
1033
+ required: true,
1034
+ schema: {
1035
+ type: "string",
1036
+ },
1037
+ "x-displayname": "Name",
1038
+ "x-ves-example": "Name",
1039
+ },
1040
+ {
1041
+ description: "Namespace\nNamespace in which the configuration object is present.",
1042
+ in: "path",
1043
+ name: "namespace",
1044
+ required: true,
1045
+ schema: {
1046
+ type: "string",
1047
+ },
1048
+ "x-displayname": "Namespace",
1049
+ "x-ves-example": "Ns1",
1050
+ },
1051
+ ],
1052
+ queryParameters: [],
1053
+ requestBodySchema: {
1054
+ $ref: "#/components/schemas/enhanced_firewall_policyDeleteRequest",
1055
+ },
1056
+ responseSchema: {},
1057
+ requiredParams: ["body", "name", "namespace"],
1058
+ operationId: "ves.io.schema.enhanced_firewall_policy.API.Delete",
1059
+ tags: ["Other"],
1060
+ sourceFile: "domains/waf.json",
1061
+ displayName: null,
1062
+ dangerLevel: "high",
1063
+ sideEffects: {
1064
+ deletes: ["enhanced-firewall-policy", "contained_resources"],
1065
+ },
1066
+ requiredFields: ["path.name", "path.namespace"],
1067
+ confirmationRequired: true,
1068
+ parameterExamples: {
1069
+ name: "Name",
1070
+ namespace: "Ns1",
1071
+ },
1072
+ validationRules: {},
1073
+ operationMetadata: {
1074
+ common_errors: [
1075
+ {
1076
+ code: 401,
1077
+ message: "Authentication required",
1078
+ solution: "Provide valid API credentials",
1079
+ },
1080
+ {
1081
+ code: 403,
1082
+ message: "Permission denied",
1083
+ solution: "Check access permissions for this operation",
1084
+ },
1085
+ {
1086
+ code: 404,
1087
+ message: "Resource not found",
1088
+ solution: "Verify resource name, namespace, and path",
1089
+ },
1090
+ {
1091
+ code: 409,
1092
+ message: "Resource already exists",
1093
+ solution: "Use different name or update existing resource",
1094
+ },
1095
+ {
1096
+ code: 429,
1097
+ message: "Rate limit exceeded",
1098
+ solution: "Wait before retrying the operation",
1099
+ },
1100
+ {
1101
+ code: 500,
1102
+ message: "Server error",
1103
+ solution: "Retry operation or contact support",
1104
+ },
1105
+ ],
1106
+ conditions: {
1107
+ postconditions: ["Resource removed from system", "Associated resources may be affected"],
1108
+ prerequisites: ["Active namespace", "Policy parameters defined"],
1109
+ },
1110
+ confirmation_required: true,
1111
+ danger_level: "high",
1112
+ field_docs: {},
1113
+ optional_fields: [],
1114
+ performance_impact: {
1115
+ latency: "high",
1116
+ resource_usage: "moderate",
1117
+ },
1118
+ purpose: "Delete enhanced-firewall-policy",
1119
+ required_fields: ["path.name", "path.namespace"],
1120
+ side_effects: {
1121
+ deletes: ["enhanced-firewall-policy", "contained_resources"],
1122
+ },
1123
+ },
1124
+ curlExample: null,
1125
+ },
1126
+ {
1127
+ toolName: "f5xc-api-waf-enhanced-firewall-policy-get",
1128
+ method: "GET",
1129
+ path: "/api/config/namespaces/{namespace}/enhanced_firewall_policys/{name}",
1130
+ operation: "get",
1131
+ domain: "waf",
1132
+ resource: "enhanced-firewall-policy",
1133
+ summary: "GET Enhanced Firewall Policy.",
1134
+ description: "Shape of the Enhanced Firewall Policy specification.",
1135
+ pathParameters: [
1136
+ {
1137
+ description: "Name\nThe name of the configuration object to be fetched.",
1138
+ in: "path",
1139
+ name: "name",
1140
+ required: true,
1141
+ schema: {
1142
+ type: "string",
1143
+ },
1144
+ "x-displayname": "Name",
1145
+ "x-ves-example": "Name",
1146
+ },
1147
+ {
1148
+ description: "Namespace\nThe namespace in which the configuration object is present.",
1149
+ in: "path",
1150
+ name: "namespace",
1151
+ required: true,
1152
+ schema: {
1153
+ type: "string",
1154
+ },
1155
+ "x-displayname": "Namespace",
1156
+ "x-ves-example": "Ns1",
1157
+ },
1158
+ ],
1159
+ queryParameters: [
1160
+ {
1161
+ description: "The format in which the configuration object is to be fetched. This could be for example\n - in GetSpec form for the contents of object\n - in CreateRequest form to create a new similar object\n - to ReplaceRequest form to replace changeable values\n\nDefault format of returned resource\nResponse should be in CreateRequest format\nResponse should be in ReplaceRequest format\nResponse should be in StatusObject(s) format\nResponse should be in format of GetSpecType\nResponse should have other objects referring to this object\nResponse should have deleted and disabled objects referrred by this object.",
1162
+ in: "query",
1163
+ name: "response_format",
1164
+ required: false,
1165
+ schema: {
1166
+ default: "GET_RSP_FORMAT_DEFAULT",
1167
+ enum: [
1168
+ "GET_RSP_FORMAT_DEFAULT",
1169
+ "GET_RSP_FORMAT_FOR_CREATE",
1170
+ "GET_RSP_FORMAT_FOR_REPLACE",
1171
+ "GET_RSP_FORMAT_STATUS",
1172
+ "GET_RSP_FORMAT_READ",
1173
+ "GET_RSP_FORMAT_REFERRING_OBJECTS",
1174
+ "GET_RSP_FORMAT_BROKEN_REFERENCES",
1175
+ ],
1176
+ type: "string",
1177
+ },
1178
+ "x-displayname": "Broken Referred Objects.",
1179
+ },
1180
+ ],
1181
+ requestBodySchema: null,
1182
+ responseSchema: {
1183
+ $ref: "#/components/schemas/enhanced_firewall_policyGetResponse",
1184
+ },
1185
+ requiredParams: ["name", "namespace"],
1186
+ operationId: "ves.io.schema.enhanced_firewall_policy.API.Get",
1187
+ tags: ["Other"],
1188
+ sourceFile: "domains/waf.json",
1189
+ displayName: null,
1190
+ dangerLevel: "low",
1191
+ sideEffects: null,
1192
+ requiredFields: ["path.name", "path.namespace"],
1193
+ confirmationRequired: false,
1194
+ parameterExamples: {
1195
+ name: "Name",
1196
+ namespace: "Ns1",
1197
+ },
1198
+ validationRules: {},
1199
+ operationMetadata: {
1200
+ common_errors: [
1201
+ {
1202
+ code: 401,
1203
+ message: "Authentication required",
1204
+ solution: "Provide valid API credentials",
1205
+ },
1206
+ {
1207
+ code: 403,
1208
+ message: "Permission denied",
1209
+ solution: "Check access permissions for this operation",
1210
+ },
1211
+ {
1212
+ code: 404,
1213
+ message: "Resource not found",
1214
+ solution: "Verify resource name, namespace, and path",
1215
+ },
1216
+ {
1217
+ code: 409,
1218
+ message: "Resource already exists",
1219
+ solution: "Use different name or update existing resource",
1220
+ },
1221
+ {
1222
+ code: 429,
1223
+ message: "Rate limit exceeded",
1224
+ solution: "Wait before retrying the operation",
1225
+ },
1226
+ {
1227
+ code: 500,
1228
+ message: "Server error",
1229
+ solution: "Retry operation or contact support",
1230
+ },
1231
+ ],
1232
+ conditions: {
1233
+ postconditions: [],
1234
+ prerequisites: ["Active namespace", "Policy parameters defined"],
1235
+ },
1236
+ confirmation_required: false,
1237
+ danger_level: "low",
1238
+ field_docs: {},
1239
+ optional_fields: [],
1240
+ performance_impact: {
1241
+ latency: "low",
1242
+ resource_usage: "low",
1243
+ },
1244
+ purpose: "Retrieve specific enhanced-firewall-policy",
1245
+ required_fields: ["path.name", "path.namespace"],
1246
+ side_effects: {},
1247
+ },
1248
+ curlExample: null,
1249
+ },
1250
+ {
1251
+ toolName: "f5xc-api-waf-enhanced-firewall-policy-list",
1252
+ method: "GET",
1253
+ path: "/api/config/namespaces/{namespace}/enhanced_firewall_policys",
1254
+ operation: "list",
1255
+ domain: "waf",
1256
+ resource: "enhanced-firewall-policy",
1257
+ summary: "List Enhanced Firewall Policy.",
1258
+ description: "List the set of enhanced_firewall_policy in a namespace.",
1259
+ pathParameters: [
1260
+ {
1261
+ description: "Namespace\nNamespace to scope the listing of enhanced_firewall_policy.",
1262
+ in: "path",
1263
+ name: "namespace",
1264
+ required: true,
1265
+ schema: {
1266
+ type: "string",
1267
+ },
1268
+ "x-displayname": "Namespace",
1269
+ "x-ves-example": "Ns1",
1270
+ },
1271
+ ],
1272
+ queryParameters: [
1273
+ {
1274
+ description: "A LabelSelectorType expression that every item in list response will satisfy.",
1275
+ in: "query",
1276
+ name: "label_filter",
1277
+ required: false,
1278
+ schema: {
1279
+ type: "string",
1280
+ },
1281
+ "x-displayname": "Label Filter.",
1282
+ "x-ves-example": "Env in (staging, testing), tier in (web, db)",
1283
+ },
1284
+ {
1285
+ description: 'X-example: ""\nExtra fields to return along with summary fields.',
1286
+ in: "query",
1287
+ name: "report_fields",
1288
+ required: false,
1289
+ schema: {
1290
+ items: {
1291
+ type: "string",
1292
+ },
1293
+ type: "array",
1294
+ },
1295
+ "x-displayname": "Report Fields.",
1296
+ },
1297
+ {
1298
+ description: 'X-example: ""\nExtra status fields to return along with summary fields.',
1299
+ in: "query",
1300
+ name: "report_status_fields",
1301
+ required: false,
1302
+ schema: {
1303
+ items: {
1304
+ type: "string",
1305
+ },
1306
+ type: "array",
1307
+ },
1308
+ "x-displayname": "Report Status Fields.",
1309
+ },
1310
+ ],
1311
+ requestBodySchema: null,
1312
+ responseSchema: {
1313
+ $ref: "#/components/schemas/enhanced_firewall_policyListResponse",
1314
+ },
1315
+ requiredParams: ["namespace"],
1316
+ operationId: "ves.io.schema.enhanced_firewall_policy.API.List",
1317
+ tags: ["Other"],
1318
+ sourceFile: "domains/waf.json",
1319
+ displayName: null,
1320
+ dangerLevel: "low",
1321
+ sideEffects: null,
1322
+ requiredFields: ["path.namespace"],
1323
+ confirmationRequired: false,
1324
+ parameterExamples: {
1325
+ label_filter: "Env in (staging, testing), tier in (web, db)",
1326
+ namespace: "Ns1",
1327
+ },
1328
+ validationRules: {},
1329
+ operationMetadata: {
1330
+ common_errors: [
1331
+ {
1332
+ code: 401,
1333
+ message: "Authentication required",
1334
+ solution: "Provide valid API credentials",
1335
+ },
1336
+ {
1337
+ code: 403,
1338
+ message: "Permission denied",
1339
+ solution: "Check access permissions for this operation",
1340
+ },
1341
+ {
1342
+ code: 404,
1343
+ message: "Resource not found",
1344
+ solution: "Verify resource name, namespace, and path",
1345
+ },
1346
+ {
1347
+ code: 409,
1348
+ message: "Resource already exists",
1349
+ solution: "Use different name or update existing resource",
1350
+ },
1351
+ {
1352
+ code: 429,
1353
+ message: "Rate limit exceeded",
1354
+ solution: "Wait before retrying the operation",
1355
+ },
1356
+ {
1357
+ code: 500,
1358
+ message: "Server error",
1359
+ solution: "Retry operation or contact support",
1360
+ },
1361
+ ],
1362
+ conditions: {
1363
+ postconditions: [],
1364
+ prerequisites: ["Active namespace", "Policy parameters defined"],
1365
+ },
1366
+ confirmation_required: false,
1367
+ danger_level: "low",
1368
+ field_docs: {},
1369
+ optional_fields: [],
1370
+ performance_impact: {
1371
+ latency: "moderate",
1372
+ resource_usage: "moderate",
1373
+ },
1374
+ purpose: "List all enhanced-firewall-policys",
1375
+ required_fields: ["path.namespace"],
1376
+ side_effects: {},
1377
+ },
1378
+ curlExample: null,
1379
+ },
1380
+ {
1381
+ toolName: "f5xc-api-waf-enhanced-firewall-policy-update",
1382
+ method: "PUT",
1383
+ path: "/api/config/namespaces/{metadata.namespace}/enhanced_firewall_policys/{metadata.name}",
1384
+ operation: "update",
1385
+ domain: "waf",
1386
+ resource: "enhanced-firewall-policy",
1387
+ summary: "Replace Enhanced Firewall Policy.",
1388
+ description: "Shape of Enhanced Firewall Policy replace specification.",
1389
+ pathParameters: [
1390
+ {
1391
+ description: "Name\nThe configuration object to be replaced will be looked up by name.",
1392
+ in: "path",
1393
+ name: "metadata.name",
1394
+ required: true,
1395
+ schema: {
1396
+ type: "string",
1397
+ },
1398
+ "x-displayname": "Name",
1399
+ "x-ves-example": "Example-corp-web.",
1400
+ },
1401
+ {
1402
+ description: 'Namespace\nThis defines the workspace within which each the configuration object is to be created.\nMust be a DNS_LABEL format. For a namespace object itself, namespace value will be ""',
1403
+ in: "path",
1404
+ name: "metadata.namespace",
1405
+ required: true,
1406
+ schema: {
1407
+ type: "string",
1408
+ },
1409
+ "x-displayname": "Namespace",
1410
+ "x-ves-example": "Staging",
1411
+ },
1412
+ ],
1413
+ queryParameters: [],
1414
+ requestBodySchema: {
1415
+ $ref: "#/components/schemas/enhanced_firewall_policyReplaceRequest",
1416
+ },
1417
+ responseSchema: {
1418
+ $ref: "#/components/schemas/enhanced_firewall_policyReplaceResponse",
1419
+ },
1420
+ requiredParams: ["body", "metadata.name", "metadata.namespace"],
1421
+ operationId: "ves.io.schema.enhanced_firewall_policy.API.Replace",
1422
+ tags: ["Other"],
1423
+ sourceFile: "domains/waf.json",
1424
+ displayName: null,
1425
+ dangerLevel: "medium",
1426
+ sideEffects: {
1427
+ modifies: ["enhanced-firewall-policy"],
1428
+ },
1429
+ requiredFields: ["path.metadata.name", "path.metadata.namespace"],
1430
+ confirmationRequired: false,
1431
+ parameterExamples: {
1432
+ "metadata.name": "Example-corp-web.",
1433
+ "metadata.namespace": "Staging",
1434
+ },
1435
+ validationRules: {},
1436
+ operationMetadata: {
1437
+ common_errors: [
1438
+ {
1439
+ code: 401,
1440
+ message: "Authentication required",
1441
+ solution: "Provide valid API credentials",
1442
+ },
1443
+ {
1444
+ code: 403,
1445
+ message: "Permission denied",
1446
+ solution: "Check access permissions for this operation",
1447
+ },
1448
+ {
1449
+ code: 404,
1450
+ message: "Resource not found",
1451
+ solution: "Verify resource name, namespace, and path",
1452
+ },
1453
+ {
1454
+ code: 409,
1455
+ message: "Resource already exists",
1456
+ solution: "Use different name or update existing resource",
1457
+ },
1458
+ {
1459
+ code: 429,
1460
+ message: "Rate limit exceeded",
1461
+ solution: "Wait before retrying the operation",
1462
+ },
1463
+ {
1464
+ code: 500,
1465
+ message: "Server error",
1466
+ solution: "Retry operation or contact support",
1467
+ },
1468
+ ],
1469
+ conditions: {
1470
+ postconditions: ["Resource updated with new values"],
1471
+ prerequisites: ["Active namespace", "Policy parameters defined"],
1472
+ },
1473
+ confirmation_required: false,
1474
+ danger_level: "medium",
1475
+ field_docs: {},
1476
+ optional_fields: [],
1477
+ performance_impact: {
1478
+ latency: "low",
1479
+ resource_usage: "low",
1480
+ },
1481
+ purpose: "Replace existing enhanced-firewall-policy",
1482
+ required_fields: ["path.metadata.name", "path.metadata.namespace"],
1483
+ side_effects: {
1484
+ modifies: ["enhanced-firewall-policy"],
1485
+ },
1486
+ },
1487
+ curlExample: null,
1488
+ },
1489
+ {
1490
+ toolName: "f5xc-api-waf-event-create",
1491
+ method: "POST",
1492
+ path: "/api/data/namespaces/{namespace}/app_security/events",
1493
+ operation: "create",
1494
+ domain: "waf",
1495
+ resource: "event",
1496
+ summary: "Security Events Query.",
1497
+ description: "GET security events for the given namespace.\nFor `system` namespace, all security events for the tenant matching the query specified\nin the request will be returned in the response. User may query security events that matches various\nfields such as `vh_name`, `sec_event_type`, `src_site`, `city`, `country`.",
1498
+ pathParameters: [
1499
+ {
1500
+ description: "Namespace\n\nfetch security events for a given namespace.",
1501
+ in: "path",
1502
+ name: "namespace",
1503
+ required: true,
1504
+ schema: {
1505
+ type: "string",
1506
+ },
1507
+ "x-displayname": "Namespace",
1508
+ "x-ves-example": "Bloggin-app-namespace-1.",
1509
+ },
1510
+ ],
1511
+ queryParameters: [],
1512
+ requestBodySchema: null,
1513
+ responseSchema: {
1514
+ $ref: "#/components/schemas/app_securitySecurityEventsResponse",
1515
+ },
1516
+ requiredParams: ["namespace"],
1517
+ operationId: "ves.io.schema.app_security.AppSecurityMonitoringAPI.SecurityEventsQuery",
1518
+ tags: ["Other"],
1519
+ sourceFile: "domains/waf.json",
1520
+ displayName: null,
1521
+ dangerLevel: "medium",
1522
+ sideEffects: {
1523
+ creates: ["event"],
1524
+ },
1525
+ requiredFields: ["metadata.name", "metadata.namespace", "path.namespace"],
1526
+ confirmationRequired: false,
1527
+ parameterExamples: {
1528
+ namespace: "Bloggin-app-namespace-1.",
1529
+ },
1530
+ validationRules: {},
1531
+ operationMetadata: {
1532
+ common_errors: [
1533
+ {
1534
+ code: 401,
1535
+ message: "Authentication required",
1536
+ solution: "Provide valid API credentials",
1537
+ },
1538
+ {
1539
+ code: 403,
1540
+ message: "Permission denied",
1541
+ solution: "Check access permissions for this operation",
1542
+ },
1543
+ {
1544
+ code: 404,
1545
+ message: "Resource not found",
1546
+ solution: "Verify resource name, namespace, and path",
1547
+ },
1548
+ {
1549
+ code: 409,
1550
+ message: "Resource already exists",
1551
+ solution: "Use different name or update existing resource",
1552
+ },
1553
+ {
1554
+ code: 429,
1555
+ message: "Rate limit exceeded",
1556
+ solution: "Wait before retrying the operation",
1557
+ },
1558
+ {
1559
+ code: 500,
1560
+ message: "Server error",
1561
+ solution: "Retry operation or contact support",
1562
+ },
1563
+ ],
1564
+ conditions: {
1565
+ postconditions: ["Event resource created", "Resource assigned unique identifier"],
1566
+ prerequisites: ["Active namespace"],
1567
+ },
1568
+ confirmation_required: false,
1569
+ danger_level: "medium",
1570
+ field_docs: {},
1571
+ optional_fields: [],
1572
+ performance_impact: {
1573
+ latency: "low",
1574
+ resource_usage: "low",
1575
+ },
1576
+ purpose: "Create new event",
1577
+ required_fields: ["metadata.name", "metadata.namespace", "path.namespace"],
1578
+ side_effects: {
1579
+ creates: ["event"],
1580
+ },
1581
+ },
1582
+ curlExample: null,
1583
+ },
1584
+ {
1585
+ toolName: "f5xc-api-waf-hit-create",
1586
+ method: "POST",
1587
+ path: "/api/data/namespaces/{namespace}/enhanced_firewall_policy/hits",
1588
+ operation: "create",
1589
+ domain: "waf",
1590
+ resource: "hit",
1591
+ summary: "Enhanced Firewall Policy Hits.",
1592
+ description: "GET the counter for Enhanced Firewall Policy hits for a given namespace.",
1593
+ pathParameters: [
1594
+ {
1595
+ description: "Namespace\nNamespace is used to scope Enhanced Firewall Policy hits for the given namespace.",
1596
+ in: "path",
1597
+ name: "namespace",
1598
+ required: true,
1599
+ schema: {
1600
+ type: "string",
1601
+ },
1602
+ "x-displayname": "Namespace",
1603
+ "x-ves-example": "Ns1",
1604
+ },
1605
+ ],
1606
+ queryParameters: [],
1607
+ requestBodySchema: {
1608
+ $ref: "#/components/schemas/enhanced_firewall_policyEnhancedFirewallPolicyHitsRequest",
1609
+ },
1610
+ responseSchema: {
1611
+ $ref: "#/components/schemas/enhanced_firewall_policyEnhancedFirewallPolicyHitsResponse",
1612
+ },
1613
+ requiredParams: ["body", "namespace"],
1614
+ operationId: "ves.io.schema.enhanced_firewall_policy.CustomDataAPI.EnhancedFirewallPolicyHits",
1615
+ tags: ["Other"],
1616
+ sourceFile: "domains/waf.json",
1617
+ displayName: null,
1618
+ dangerLevel: "medium",
1619
+ sideEffects: {
1620
+ creates: ["hit"],
1621
+ },
1622
+ requiredFields: ["metadata.name", "metadata.namespace", "path.namespace"],
1623
+ confirmationRequired: false,
1624
+ parameterExamples: {
1625
+ namespace: "Ns1",
1626
+ },
1627
+ validationRules: {},
1628
+ operationMetadata: {
1629
+ common_errors: [
1630
+ {
1631
+ code: 401,
1632
+ message: "Authentication required",
1633
+ solution: "Provide valid API credentials",
1634
+ },
1635
+ {
1636
+ code: 403,
1637
+ message: "Permission denied",
1638
+ solution: "Check access permissions for this operation",
1639
+ },
1640
+ {
1641
+ code: 404,
1642
+ message: "Resource not found",
1643
+ solution: "Verify resource name, namespace, and path",
1644
+ },
1645
+ {
1646
+ code: 409,
1647
+ message: "Resource already exists",
1648
+ solution: "Use different name or update existing resource",
1649
+ },
1650
+ {
1651
+ code: 429,
1652
+ message: "Rate limit exceeded",
1653
+ solution: "Wait before retrying the operation",
1654
+ },
1655
+ {
1656
+ code: 500,
1657
+ message: "Server error",
1658
+ solution: "Retry operation or contact support",
1659
+ },
1660
+ ],
1661
+ conditions: {
1662
+ postconditions: ["Hit resource created", "Resource assigned unique identifier"],
1663
+ prerequisites: ["Active namespace", "Policy parameters defined"],
1664
+ },
1665
+ confirmation_required: false,
1666
+ danger_level: "medium",
1667
+ field_docs: {},
1668
+ optional_fields: [],
1669
+ performance_impact: {
1670
+ latency: "low",
1671
+ resource_usage: "low",
1672
+ },
1673
+ purpose: "Create new hit",
1674
+ required_fields: ["metadata.name", "metadata.namespace", "path.namespace"],
1675
+ side_effects: {
1676
+ creates: ["hit"],
1677
+ },
1678
+ },
1679
+ curlExample: null,
1680
+ },
1681
+ {
1682
+ toolName: "f5xc-api-waf-incident-create",
1683
+ method: "POST",
1684
+ path: "/api/data/namespaces/{namespace}/app_security/incidents",
1685
+ operation: "create",
1686
+ domain: "waf",
1687
+ resource: "incident",
1688
+ summary: "Security Incidents Query.",
1689
+ description: "GET security incidents for the given namespace.\nFor `system` namespace, all security incidents for the tenant matching the query specified\nin the request will be returned in the response. User may query security incidents that matches various\nfields such as `vh_name`, `intent`, `city`, `country`.",
1690
+ pathParameters: [
1691
+ {
1692
+ description: "Namespace\nFetch security incidents for a given namespace.",
1693
+ in: "path",
1694
+ name: "namespace",
1695
+ required: true,
1696
+ schema: {
1697
+ type: "string",
1698
+ },
1699
+ "x-displayname": "Namespace",
1700
+ "x-ves-example": "Bloggin-app-namespace-1.",
1701
+ },
1702
+ ],
1703
+ queryParameters: [],
1704
+ requestBodySchema: {
1705
+ $ref: "#/components/schemas/app_securitySecurityIncidentsRequest",
1706
+ },
1707
+ responseSchema: {
1708
+ $ref: "#/components/schemas/app_securitySecurityIncidentsResponse",
1709
+ },
1710
+ requiredParams: ["body", "namespace"],
1711
+ operationId: "ves.io.schema.app_security.AppSecurityMonitoringAPI.SecurityIncidentsQuery",
1712
+ tags: ["Other"],
1713
+ sourceFile: "domains/waf.json",
1714
+ displayName: null,
1715
+ dangerLevel: "medium",
1716
+ sideEffects: {
1717
+ creates: ["incident"],
1718
+ },
1719
+ requiredFields: ["metadata.name", "metadata.namespace", "path.namespace"],
1720
+ confirmationRequired: false,
1721
+ parameterExamples: {
1722
+ namespace: "Bloggin-app-namespace-1.",
1723
+ },
1724
+ validationRules: {},
1725
+ operationMetadata: {
1726
+ common_errors: [
1727
+ {
1728
+ code: 401,
1729
+ message: "Authentication required",
1730
+ solution: "Provide valid API credentials",
1731
+ },
1732
+ {
1733
+ code: 403,
1734
+ message: "Permission denied",
1735
+ solution: "Check access permissions for this operation",
1736
+ },
1737
+ {
1738
+ code: 404,
1739
+ message: "Resource not found",
1740
+ solution: "Verify resource name, namespace, and path",
1741
+ },
1742
+ {
1743
+ code: 409,
1744
+ message: "Resource already exists",
1745
+ solution: "Use different name or update existing resource",
1746
+ },
1747
+ {
1748
+ code: 429,
1749
+ message: "Rate limit exceeded",
1750
+ solution: "Wait before retrying the operation",
1751
+ },
1752
+ {
1753
+ code: 500,
1754
+ message: "Server error",
1755
+ solution: "Retry operation or contact support",
1756
+ },
1757
+ ],
1758
+ conditions: {
1759
+ postconditions: ["Incident resource created", "Resource assigned unique identifier"],
1760
+ prerequisites: ["Active namespace"],
1761
+ },
1762
+ confirmation_required: false,
1763
+ danger_level: "medium",
1764
+ field_docs: {},
1765
+ optional_fields: [],
1766
+ performance_impact: {
1767
+ latency: "low",
1768
+ resource_usage: "low",
1769
+ },
1770
+ purpose: "Create new incident",
1771
+ required_fields: ["metadata.name", "metadata.namespace", "path.namespace"],
1772
+ side_effects: {
1773
+ creates: ["incident"],
1774
+ },
1775
+ },
1776
+ curlExample: null,
1777
+ },
1778
+ {
1779
+ toolName: "f5xc-api-waf-loadbalancer-create",
1780
+ method: "POST",
1781
+ path: "/api/data/namespaces/system/app_security/all_ns_search/loadbalancers",
1782
+ operation: "create",
1783
+ domain: "waf",
1784
+ resource: "loadbalancer",
1785
+ summary: "Search load balancers All Namespaces.",
1786
+ description: "GET list of virtual hosts matching label filter.",
1787
+ pathParameters: [],
1788
+ queryParameters: [],
1789
+ requestBodySchema: null,
1790
+ responseSchema: {
1791
+ $ref: "#/components/schemas/app_securitySearchLoadBalancersResponse",
1792
+ },
1793
+ requiredParams: [],
1794
+ operationId: "ves.io.schema.app_security.AppSecurityMonitoringAPI.SearchLoadBalancersAllNamespaces",
1795
+ tags: ["Other"],
1796
+ sourceFile: "domains/waf.json",
1797
+ displayName: null,
1798
+ dangerLevel: "medium",
1799
+ sideEffects: {
1800
+ creates: ["loadbalancer"],
1801
+ },
1802
+ requiredFields: ["metadata.name", "metadata.namespace"],
1803
+ confirmationRequired: false,
1804
+ parameterExamples: {},
1805
+ validationRules: {},
1806
+ operationMetadata: {
1807
+ common_errors: [
1808
+ {
1809
+ code: 401,
1810
+ message: "Authentication required",
1811
+ solution: "Provide valid API credentials",
1812
+ },
1813
+ {
1814
+ code: 403,
1815
+ message: "Permission denied",
1816
+ solution: "Check access permissions for this operation",
1817
+ },
1818
+ {
1819
+ code: 404,
1820
+ message: "Resource not found",
1821
+ solution: "Verify resource name, namespace, and path",
1822
+ },
1823
+ {
1824
+ code: 409,
1825
+ message: "Resource already exists",
1826
+ solution: "Use different name or update existing resource",
1827
+ },
1828
+ {
1829
+ code: 429,
1830
+ message: "Rate limit exceeded",
1831
+ solution: "Wait before retrying the operation",
1832
+ },
1833
+ {
1834
+ code: 500,
1835
+ message: "Server error",
1836
+ solution: "Retry operation or contact support",
1837
+ },
1838
+ ],
1839
+ conditions: {
1840
+ postconditions: ["Loadbalancer resource created", "Resource assigned unique identifier"],
1841
+ prerequisites: ["Active namespace"],
1842
+ },
1843
+ confirmation_required: false,
1844
+ danger_level: "medium",
1845
+ field_docs: {},
1846
+ optional_fields: [],
1847
+ performance_impact: {
1848
+ latency: "low",
1849
+ resource_usage: "low",
1850
+ },
1851
+ purpose: "Create new loadbalancer",
1852
+ required_fields: ["metadata.name", "metadata.namespace"],
1853
+ side_effects: {
1854
+ creates: ["loadbalancer"],
1855
+ },
1856
+ },
1857
+ curlExample: null,
1858
+ },
1859
+ {
1860
+ toolName: "f5xc-api-waf-metric-create",
1861
+ method: "POST",
1862
+ path: "/api/data/namespaces/{namespace}/app_firewall/metrics",
1863
+ operation: "create",
1864
+ domain: "waf",
1865
+ resource: "metric",
1866
+ summary: "Metrics",
1867
+ description: "App Firewall metrics.",
1868
+ pathParameters: [
1869
+ {
1870
+ description: "Namespace",
1871
+ in: "path",
1872
+ name: "namespace",
1873
+ required: true,
1874
+ schema: {
1875
+ type: "string",
1876
+ },
1877
+ "x-displayname": "Namespace",
1878
+ "x-ves-example": "System",
1879
+ },
1880
+ ],
1881
+ queryParameters: [],
1882
+ requestBodySchema: null,
1883
+ responseSchema: {
1884
+ $ref: "#/components/schemas/app_firewallMetricsResponse",
1885
+ },
1886
+ requiredParams: ["namespace"],
1887
+ operationId: "ves.io.schema.app_firewall.CustomDataAPI.Metrics",
1888
+ tags: ["Security"],
1889
+ sourceFile: "domains/waf.json",
1890
+ displayName: null,
1891
+ dangerLevel: "medium",
1892
+ sideEffects: {
1893
+ creates: ["metric"],
1894
+ },
1895
+ requiredFields: ["metadata.name", "metadata.namespace", "path.namespace"],
1896
+ confirmationRequired: false,
1897
+ parameterExamples: {
1898
+ namespace: "System",
1899
+ },
1900
+ validationRules: {},
1901
+ operationMetadata: {
1902
+ common_errors: [
1903
+ {
1904
+ code: 401,
1905
+ message: "Authentication required",
1906
+ solution: "Provide valid API credentials",
1907
+ },
1908
+ {
1909
+ code: 403,
1910
+ message: "Permission denied",
1911
+ solution: "Check access permissions for this operation",
1912
+ },
1913
+ {
1914
+ code: 404,
1915
+ message: "Resource not found",
1916
+ solution: "Verify resource name, namespace, and path",
1917
+ },
1918
+ {
1919
+ code: 409,
1920
+ message: "Resource already exists",
1921
+ solution: "Use different name or update existing resource",
1922
+ },
1923
+ {
1924
+ code: 429,
1925
+ message: "Rate limit exceeded",
1926
+ solution: "Wait before retrying the operation",
1927
+ },
1928
+ {
1929
+ code: 500,
1930
+ message: "Server error",
1931
+ solution: "Retry operation or contact support",
1932
+ },
1933
+ ],
1934
+ conditions: {
1935
+ postconditions: ["Metric resource created", "Resource assigned unique identifier"],
1936
+ prerequisites: ["Active namespace"],
1937
+ },
1938
+ confirmation_required: false,
1939
+ danger_level: "medium",
1940
+ field_docs: {},
1941
+ optional_fields: [],
1942
+ performance_impact: {
1943
+ latency: "low",
1944
+ resource_usage: "low",
1945
+ },
1946
+ purpose: "Create new metric",
1947
+ required_fields: ["metadata.name", "metadata.namespace", "path.namespace"],
1948
+ side_effects: {
1949
+ creates: ["metric"],
1950
+ },
1951
+ },
1952
+ curlExample: null,
1953
+ },
1954
+ {
1955
+ toolName: "f5xc-api-waf-protocol-inspection-create",
1956
+ method: "POST",
1957
+ path: "/api/config/namespaces/{metadata.namespace}/protocol_inspections",
1958
+ operation: "create",
1959
+ domain: "waf",
1960
+ resource: "protocol-inspection",
1961
+ summary: "Create Protocol Inspection.",
1962
+ description: "Create Protocol Inspection Specification in a given namespace. If one already exists it will give an error.",
1963
+ pathParameters: [
1964
+ {
1965
+ description: 'Namespace\nThis defines the workspace within which each the configuration object is to be created.\nMust be a DNS_LABEL format. For a namespace object itself, namespace value will be ""',
1966
+ in: "path",
1967
+ name: "metadata.namespace",
1968
+ required: true,
1969
+ schema: {
1970
+ type: "string",
1971
+ },
1972
+ "x-displayname": "Namespace",
1973
+ "x-ves-example": "Staging",
1974
+ },
1975
+ ],
1976
+ queryParameters: [],
1977
+ requestBodySchema: {
1978
+ $ref: "#/components/schemas/protocol_inspectionCreateRequest",
1979
+ },
1980
+ responseSchema: {
1981
+ $ref: "#/components/schemas/protocol_inspectionCreateResponse",
1982
+ },
1983
+ requiredParams: ["body", "metadata.namespace"],
1984
+ operationId: "ves.io.schema.protocol_inspection.API.Create",
1985
+ tags: ["Other"],
1986
+ sourceFile: "domains/waf.json",
1987
+ displayName: null,
1988
+ dangerLevel: "medium",
1989
+ sideEffects: {
1990
+ creates: ["protocol-inspection"],
1991
+ },
1992
+ requiredFields: ["metadata.name", "metadata.namespace", "path.metadata.namespace"],
1993
+ confirmationRequired: false,
1994
+ parameterExamples: {
1995
+ "metadata.namespace": "Staging",
1996
+ },
1997
+ validationRules: {},
1998
+ operationMetadata: {
1999
+ common_errors: [
2000
+ {
2001
+ code: 401,
2002
+ message: "Authentication required",
2003
+ solution: "Provide valid API credentials",
2004
+ },
2005
+ {
2006
+ code: 403,
2007
+ message: "Permission denied",
2008
+ solution: "Check access permissions for this operation",
2009
+ },
2010
+ {
2011
+ code: 404,
2012
+ message: "Resource not found",
2013
+ solution: "Verify resource name, namespace, and path",
2014
+ },
2015
+ {
2016
+ code: 409,
2017
+ message: "Resource already exists",
2018
+ solution: "Use different name or update existing resource",
2019
+ },
2020
+ {
2021
+ code: 429,
2022
+ message: "Rate limit exceeded",
2023
+ solution: "Wait before retrying the operation",
2024
+ },
2025
+ {
2026
+ code: 500,
2027
+ message: "Server error",
2028
+ solution: "Retry operation or contact support",
2029
+ },
2030
+ ],
2031
+ conditions: {
2032
+ postconditions: [
2033
+ "Protocol-inspection resource created",
2034
+ "Resource assigned unique identifier",
2035
+ ],
2036
+ prerequisites: ["Active namespace"],
2037
+ },
2038
+ confirmation_required: false,
2039
+ danger_level: "medium",
2040
+ field_docs: {},
2041
+ optional_fields: [],
2042
+ performance_impact: {
2043
+ latency: "low",
2044
+ resource_usage: "low",
2045
+ },
2046
+ purpose: "Create new protocol-inspection",
2047
+ required_fields: ["metadata.name", "metadata.namespace", "path.metadata.namespace"],
2048
+ side_effects: {
2049
+ creates: ["protocol-inspection"],
2050
+ },
2051
+ },
2052
+ curlExample: 'curl -X POST "$F5XC_API_URL/api/config/namespaces/default/protocol_inspections" \\\n -H "Authorization: APIToken $F5XC_API_TOKEN" \\\n -H "Content-Type: application/json" \\\n -d @example.json',
2053
+ },
2054
+ {
2055
+ toolName: "f5xc-api-waf-protocol-inspection-delete",
2056
+ method: "DELETE",
2057
+ path: "/api/config/namespaces/{namespace}/protocol_inspections/{name}",
2058
+ operation: "delete",
2059
+ domain: "waf",
2060
+ resource: "protocol-inspection",
2061
+ summary: "DELETE Configure Protocol Inspection.",
2062
+ description: "DELETE the specified protocol_inspection.",
2063
+ pathParameters: [
2064
+ {
2065
+ description: "Name\nName of the configuration object.",
2066
+ in: "path",
2067
+ name: "name",
2068
+ required: true,
2069
+ schema: {
2070
+ type: "string",
2071
+ },
2072
+ "x-displayname": "Name",
2073
+ "x-ves-example": "Name",
2074
+ },
2075
+ {
2076
+ description: "Namespace\nNamespace in which the configuration object is present.",
2077
+ in: "path",
2078
+ name: "namespace",
2079
+ required: true,
2080
+ schema: {
2081
+ type: "string",
2082
+ },
2083
+ "x-displayname": "Namespace",
2084
+ "x-ves-example": "Ns1",
2085
+ },
2086
+ ],
2087
+ queryParameters: [],
2088
+ requestBodySchema: {
2089
+ $ref: "#/components/schemas/protocol_inspectionDeleteRequest",
2090
+ },
2091
+ responseSchema: {},
2092
+ requiredParams: ["body", "name", "namespace"],
2093
+ operationId: "ves.io.schema.protocol_inspection.API.Delete",
2094
+ tags: ["Other"],
2095
+ sourceFile: "domains/waf.json",
2096
+ displayName: null,
2097
+ dangerLevel: "high",
2098
+ sideEffects: {
2099
+ deletes: ["protocol-inspection", "contained_resources"],
2100
+ },
2101
+ requiredFields: ["path.name", "path.namespace"],
2102
+ confirmationRequired: true,
2103
+ parameterExamples: {
2104
+ name: "Name",
2105
+ namespace: "Ns1",
2106
+ },
2107
+ validationRules: {},
2108
+ operationMetadata: {
2109
+ common_errors: [
2110
+ {
2111
+ code: 401,
2112
+ message: "Authentication required",
2113
+ solution: "Provide valid API credentials",
2114
+ },
2115
+ {
2116
+ code: 403,
2117
+ message: "Permission denied",
2118
+ solution: "Check access permissions for this operation",
2119
+ },
2120
+ {
2121
+ code: 404,
2122
+ message: "Resource not found",
2123
+ solution: "Verify resource name, namespace, and path",
2124
+ },
2125
+ {
2126
+ code: 409,
2127
+ message: "Resource already exists",
2128
+ solution: "Use different name or update existing resource",
2129
+ },
2130
+ {
2131
+ code: 429,
2132
+ message: "Rate limit exceeded",
2133
+ solution: "Wait before retrying the operation",
2134
+ },
2135
+ {
2136
+ code: 500,
2137
+ message: "Server error",
2138
+ solution: "Retry operation or contact support",
2139
+ },
2140
+ ],
2141
+ conditions: {
2142
+ postconditions: ["Resource removed from system", "Associated resources may be affected"],
2143
+ prerequisites: ["Active namespace"],
2144
+ },
2145
+ confirmation_required: true,
2146
+ danger_level: "high",
2147
+ field_docs: {},
2148
+ optional_fields: [],
2149
+ performance_impact: {
2150
+ latency: "high",
2151
+ resource_usage: "moderate",
2152
+ },
2153
+ purpose: "Delete protocol-inspection",
2154
+ required_fields: ["path.name", "path.namespace"],
2155
+ side_effects: {
2156
+ deletes: ["protocol-inspection", "contained_resources"],
2157
+ },
2158
+ },
2159
+ curlExample: 'curl -X POST "$F5XC_API_URL/api/config/namespaces/default/protocol_inspections" \\\n -H "Authorization: APIToken $F5XC_API_TOKEN" \\\n -H "Content-Type: application/json" \\\n -d @example.json',
2160
+ },
2161
+ {
2162
+ toolName: "f5xc-api-waf-protocol-inspection-get",
2163
+ method: "GET",
2164
+ path: "/api/config/namespaces/{namespace}/protocol_inspections/{name}",
2165
+ operation: "get",
2166
+ domain: "waf",
2167
+ resource: "protocol-inspection",
2168
+ summary: "GET Protocol Inspection.",
2169
+ description: "GET Protocol Inspection details.",
2170
+ pathParameters: [
2171
+ {
2172
+ description: "Name\nThe name of the configuration object to be fetched.",
2173
+ in: "path",
2174
+ name: "name",
2175
+ required: true,
2176
+ schema: {
2177
+ type: "string",
2178
+ },
2179
+ "x-displayname": "Name",
2180
+ "x-ves-example": "Name",
2181
+ },
2182
+ {
2183
+ description: "Namespace\nThe namespace in which the configuration object is present.",
2184
+ in: "path",
2185
+ name: "namespace",
2186
+ required: true,
2187
+ schema: {
2188
+ type: "string",
2189
+ },
2190
+ "x-displayname": "Namespace",
2191
+ "x-ves-example": "Ns1",
2192
+ },
2193
+ ],
2194
+ queryParameters: [
2195
+ {
2196
+ description: "The format in which the configuration object is to be fetched. This could be for example\n - in GetSpec form for the contents of object\n - in CreateRequest form to create a new similar object\n - to ReplaceRequest form to replace changeable values\n\nDefault format of returned resource\nResponse should be in CreateRequest format\nResponse should be in ReplaceRequest format\nResponse should be in StatusObject(s) format\nResponse should be in format of GetSpecType\nResponse should have other objects referring to this object\nResponse should have deleted and disabled objects referrred by this object.",
2197
+ in: "query",
2198
+ name: "response_format",
2199
+ required: false,
2200
+ schema: {
2201
+ default: "GET_RSP_FORMAT_DEFAULT",
2202
+ enum: [
2203
+ "GET_RSP_FORMAT_DEFAULT",
2204
+ "GET_RSP_FORMAT_FOR_CREATE",
2205
+ "GET_RSP_FORMAT_FOR_REPLACE",
2206
+ "GET_RSP_FORMAT_STATUS",
2207
+ "GET_RSP_FORMAT_READ",
2208
+ "GET_RSP_FORMAT_REFERRING_OBJECTS",
2209
+ "GET_RSP_FORMAT_BROKEN_REFERENCES",
2210
+ ],
2211
+ type: "string",
2212
+ },
2213
+ "x-displayname": "Broken Referred Objects.",
2214
+ },
2215
+ ],
2216
+ requestBodySchema: null,
2217
+ responseSchema: {
2218
+ $ref: "#/components/schemas/protocol_inspectionGetResponse",
2219
+ },
2220
+ requiredParams: ["name", "namespace"],
2221
+ operationId: "ves.io.schema.protocol_inspection.API.Get",
2222
+ tags: ["Other"],
2223
+ sourceFile: "domains/waf.json",
2224
+ displayName: null,
2225
+ dangerLevel: "low",
2226
+ sideEffects: null,
2227
+ requiredFields: ["path.name", "path.namespace"],
2228
+ confirmationRequired: false,
2229
+ parameterExamples: {
2230
+ name: "Name",
2231
+ namespace: "Ns1",
2232
+ },
2233
+ validationRules: {},
2234
+ operationMetadata: {
2235
+ common_errors: [
2236
+ {
2237
+ code: 401,
2238
+ message: "Authentication required",
2239
+ solution: "Provide valid API credentials",
2240
+ },
2241
+ {
2242
+ code: 403,
2243
+ message: "Permission denied",
2244
+ solution: "Check access permissions for this operation",
2245
+ },
2246
+ {
2247
+ code: 404,
2248
+ message: "Resource not found",
2249
+ solution: "Verify resource name, namespace, and path",
2250
+ },
2251
+ {
2252
+ code: 409,
2253
+ message: "Resource already exists",
2254
+ solution: "Use different name or update existing resource",
2255
+ },
2256
+ {
2257
+ code: 429,
2258
+ message: "Rate limit exceeded",
2259
+ solution: "Wait before retrying the operation",
2260
+ },
2261
+ {
2262
+ code: 500,
2263
+ message: "Server error",
2264
+ solution: "Retry operation or contact support",
2265
+ },
2266
+ ],
2267
+ conditions: {
2268
+ postconditions: [],
2269
+ prerequisites: ["Active namespace"],
2270
+ },
2271
+ confirmation_required: false,
2272
+ danger_level: "low",
2273
+ field_docs: {},
2274
+ optional_fields: [],
2275
+ performance_impact: {
2276
+ latency: "low",
2277
+ resource_usage: "low",
2278
+ },
2279
+ purpose: "Retrieve specific protocol-inspection",
2280
+ required_fields: ["path.name", "path.namespace"],
2281
+ side_effects: {},
2282
+ },
2283
+ curlExample: 'curl -X POST "$F5XC_API_URL/api/config/namespaces/default/protocol_inspections" \\\n -H "Authorization: APIToken $F5XC_API_TOKEN" \\\n -H "Content-Type: application/json" \\\n -d @example.json',
2284
+ },
2285
+ {
2286
+ toolName: "f5xc-api-waf-protocol-inspection-list",
2287
+ method: "GET",
2288
+ path: "/api/config/namespaces/{namespace}/protocol_inspections",
2289
+ operation: "list",
2290
+ domain: "waf",
2291
+ resource: "protocol-inspection",
2292
+ summary: "List Configure Protocol Inspection.",
2293
+ description: "List the set of protocol_inspection in a namespace.",
2294
+ pathParameters: [
2295
+ {
2296
+ description: "Namespace\nNamespace to scope the listing of protocol_inspection.",
2297
+ in: "path",
2298
+ name: "namespace",
2299
+ required: true,
2300
+ schema: {
2301
+ type: "string",
2302
+ },
2303
+ "x-displayname": "Namespace",
2304
+ "x-ves-example": "Ns1",
2305
+ },
2306
+ ],
2307
+ queryParameters: [
2308
+ {
2309
+ description: "A LabelSelectorType expression that every item in list response will satisfy.",
2310
+ in: "query",
2311
+ name: "label_filter",
2312
+ required: false,
2313
+ schema: {
2314
+ type: "string",
2315
+ },
2316
+ "x-displayname": "Label Filter.",
2317
+ "x-ves-example": "Env in (staging, testing), tier in (web, db)",
2318
+ },
2319
+ {
2320
+ description: 'X-example: ""\nExtra fields to return along with summary fields.',
2321
+ in: "query",
2322
+ name: "report_fields",
2323
+ required: false,
2324
+ schema: {
2325
+ items: {
2326
+ type: "string",
2327
+ },
2328
+ type: "array",
2329
+ },
2330
+ "x-displayname": "Report Fields.",
2331
+ },
2332
+ {
2333
+ description: 'X-example: ""\nExtra status fields to return along with summary fields.',
2334
+ in: "query",
2335
+ name: "report_status_fields",
2336
+ required: false,
2337
+ schema: {
2338
+ items: {
2339
+ type: "string",
2340
+ },
2341
+ type: "array",
2342
+ },
2343
+ "x-displayname": "Report Status Fields.",
2344
+ },
2345
+ ],
2346
+ requestBodySchema: null,
2347
+ responseSchema: {
2348
+ $ref: "#/components/schemas/protocol_inspectionListResponse",
2349
+ },
2350
+ requiredParams: ["namespace"],
2351
+ operationId: "ves.io.schema.protocol_inspection.API.List",
2352
+ tags: ["Other"],
2353
+ sourceFile: "domains/waf.json",
2354
+ displayName: null,
2355
+ dangerLevel: "low",
2356
+ sideEffects: null,
2357
+ requiredFields: ["path.namespace"],
2358
+ confirmationRequired: false,
2359
+ parameterExamples: {
2360
+ label_filter: "Env in (staging, testing), tier in (web, db)",
2361
+ namespace: "Ns1",
2362
+ },
2363
+ validationRules: {},
2364
+ operationMetadata: {
2365
+ common_errors: [
2366
+ {
2367
+ code: 401,
2368
+ message: "Authentication required",
2369
+ solution: "Provide valid API credentials",
2370
+ },
2371
+ {
2372
+ code: 403,
2373
+ message: "Permission denied",
2374
+ solution: "Check access permissions for this operation",
2375
+ },
2376
+ {
2377
+ code: 404,
2378
+ message: "Resource not found",
2379
+ solution: "Verify resource name, namespace, and path",
2380
+ },
2381
+ {
2382
+ code: 409,
2383
+ message: "Resource already exists",
2384
+ solution: "Use different name or update existing resource",
2385
+ },
2386
+ {
2387
+ code: 429,
2388
+ message: "Rate limit exceeded",
2389
+ solution: "Wait before retrying the operation",
2390
+ },
2391
+ {
2392
+ code: 500,
2393
+ message: "Server error",
2394
+ solution: "Retry operation or contact support",
2395
+ },
2396
+ ],
2397
+ conditions: {
2398
+ postconditions: [],
2399
+ prerequisites: ["Active namespace"],
2400
+ },
2401
+ confirmation_required: false,
2402
+ danger_level: "low",
2403
+ field_docs: {},
2404
+ optional_fields: [],
2405
+ performance_impact: {
2406
+ latency: "moderate",
2407
+ resource_usage: "moderate",
2408
+ },
2409
+ purpose: "List all protocol-inspections",
2410
+ required_fields: ["path.namespace"],
2411
+ side_effects: {},
2412
+ },
2413
+ curlExample: 'curl -X POST "$F5XC_API_URL/api/config/namespaces/default/protocol_inspections" \\\n -H "Authorization: APIToken $F5XC_API_TOKEN" \\\n -H "Content-Type: application/json" \\\n -d @example.json',
2414
+ },
2415
+ {
2416
+ toolName: "f5xc-api-waf-protocol-inspection-update",
2417
+ method: "PUT",
2418
+ path: "/api/config/namespaces/{metadata.namespace}/protocol_inspections/{metadata.name}",
2419
+ operation: "update",
2420
+ domain: "waf",
2421
+ resource: "protocol-inspection",
2422
+ summary: "Replace Protocol Inspection.",
2423
+ description: "Replace Protocol Inspection specification in a given namespace.",
2424
+ pathParameters: [
2425
+ {
2426
+ description: "Name\nThe configuration object to be replaced will be looked up by name.",
2427
+ in: "path",
2428
+ name: "metadata.name",
2429
+ required: true,
2430
+ schema: {
2431
+ type: "string",
2432
+ },
2433
+ "x-displayname": "Name",
2434
+ "x-ves-example": "Example-corp-web.",
2435
+ },
2436
+ {
2437
+ description: 'Namespace\nThis defines the workspace within which each the configuration object is to be created.\nMust be a DNS_LABEL format. For a namespace object itself, namespace value will be ""',
2438
+ in: "path",
2439
+ name: "metadata.namespace",
2440
+ required: true,
2441
+ schema: {
2442
+ type: "string",
2443
+ },
2444
+ "x-displayname": "Namespace",
2445
+ "x-ves-example": "Staging",
2446
+ },
2447
+ ],
2448
+ queryParameters: [],
2449
+ requestBodySchema: {
2450
+ $ref: "#/components/schemas/protocol_inspectionReplaceRequest",
2451
+ },
2452
+ responseSchema: {
2453
+ $ref: "#/components/schemas/protocol_inspectionReplaceResponse",
2454
+ },
2455
+ requiredParams: ["body", "metadata.name", "metadata.namespace"],
2456
+ operationId: "ves.io.schema.protocol_inspection.API.Replace",
2457
+ tags: ["Other"],
2458
+ sourceFile: "domains/waf.json",
2459
+ displayName: null,
2460
+ dangerLevel: "medium",
2461
+ sideEffects: {
2462
+ modifies: ["protocol-inspection"],
2463
+ },
2464
+ requiredFields: ["path.metadata.name", "path.metadata.namespace"],
2465
+ confirmationRequired: false,
2466
+ parameterExamples: {
2467
+ "metadata.name": "Example-corp-web.",
2468
+ "metadata.namespace": "Staging",
2469
+ },
2470
+ validationRules: {},
2471
+ operationMetadata: {
2472
+ common_errors: [
2473
+ {
2474
+ code: 401,
2475
+ message: "Authentication required",
2476
+ solution: "Provide valid API credentials",
2477
+ },
2478
+ {
2479
+ code: 403,
2480
+ message: "Permission denied",
2481
+ solution: "Check access permissions for this operation",
2482
+ },
2483
+ {
2484
+ code: 404,
2485
+ message: "Resource not found",
2486
+ solution: "Verify resource name, namespace, and path",
2487
+ },
2488
+ {
2489
+ code: 409,
2490
+ message: "Resource already exists",
2491
+ solution: "Use different name or update existing resource",
2492
+ },
2493
+ {
2494
+ code: 429,
2495
+ message: "Rate limit exceeded",
2496
+ solution: "Wait before retrying the operation",
2497
+ },
2498
+ {
2499
+ code: 500,
2500
+ message: "Server error",
2501
+ solution: "Retry operation or contact support",
2502
+ },
2503
+ ],
2504
+ conditions: {
2505
+ postconditions: ["Resource updated with new values"],
2506
+ prerequisites: ["Active namespace"],
2507
+ },
2508
+ confirmation_required: false,
2509
+ danger_level: "medium",
2510
+ field_docs: {},
2511
+ optional_fields: [],
2512
+ performance_impact: {
2513
+ latency: "low",
2514
+ resource_usage: "low",
2515
+ },
2516
+ purpose: "Replace existing protocol-inspection",
2517
+ required_fields: ["path.metadata.name", "path.metadata.namespace"],
2518
+ side_effects: {
2519
+ modifies: ["protocol-inspection"],
2520
+ },
2521
+ },
2522
+ curlExample: 'curl -X POST "$F5XC_API_URL/api/config/namespaces/default/protocol_inspections" \\\n -H "Authorization: APIToken $F5XC_API_TOKEN" \\\n -H "Content-Type: application/json" \\\n -d @example.json',
2523
+ },
2524
+ {
2525
+ toolName: "f5xc-api-waf-released-signature-list",
2526
+ method: "GET",
2527
+ path: "/api/config/namespaces/{namespace}/virtual_hosts/{vh_name}/released_signatures",
2528
+ operation: "list",
2529
+ domain: "waf",
2530
+ resource: "released-signature",
2531
+ summary: "Released Signatures.",
2532
+ description: "API to GET Released Signatures.",
2533
+ pathParameters: [
2534
+ {
2535
+ description: "Namespace\nFetch WAF signatures changelog for the given namespace.",
2536
+ in: "path",
2537
+ name: "namespace",
2538
+ required: true,
2539
+ schema: {
2540
+ type: "string",
2541
+ },
2542
+ "x-displayname": "Namespace",
2543
+ "x-ves-example": "Shared",
2544
+ },
2545
+ {
2546
+ description: "Vh_name\nVirtual Host for current request.",
2547
+ in: "path",
2548
+ name: "vh_name",
2549
+ required: true,
2550
+ schema: {
2551
+ type: "string",
2552
+ },
2553
+ "x-displayname": "Virtual Host Name.",
2554
+ "x-ves-example": "Blogging-app.",
2555
+ },
2556
+ ],
2557
+ queryParameters: [],
2558
+ requestBodySchema: null,
2559
+ responseSchema: {
2560
+ $ref: "#/components/schemas/waf_signatures_changelogReleasedSignaturesRsp",
2561
+ },
2562
+ requiredParams: ["namespace", "vh_name"],
2563
+ operationId: "ves.io.schema.waf_signatures_changelog.WafSignatureChangelogCustomApi.GetReleasedSignatures",
2564
+ tags: ["Other"],
2565
+ sourceFile: "domains/waf.json",
2566
+ displayName: null,
2567
+ dangerLevel: "low",
2568
+ sideEffects: null,
2569
+ requiredFields: ["path.namespace", "path.vh_name"],
2570
+ confirmationRequired: false,
2571
+ parameterExamples: {
2572
+ namespace: "Shared",
2573
+ vh_name: "Blogging-app.",
2574
+ },
2575
+ validationRules: {},
2576
+ operationMetadata: {
2577
+ common_errors: [
2578
+ {
2579
+ code: 401,
2580
+ message: "Authentication required",
2581
+ solution: "Provide valid API credentials",
2582
+ },
2583
+ {
2584
+ code: 403,
2585
+ message: "Permission denied",
2586
+ solution: "Check access permissions for this operation",
2587
+ },
2588
+ {
2589
+ code: 404,
2590
+ message: "Resource not found",
2591
+ solution: "Verify resource name, namespace, and path",
2592
+ },
2593
+ {
2594
+ code: 409,
2595
+ message: "Resource already exists",
2596
+ solution: "Use different name or update existing resource",
2597
+ },
2598
+ {
2599
+ code: 429,
2600
+ message: "Rate limit exceeded",
2601
+ solution: "Wait before retrying the operation",
2602
+ },
2603
+ {
2604
+ code: 500,
2605
+ message: "Server error",
2606
+ solution: "Retry operation or contact support",
2607
+ },
2608
+ ],
2609
+ conditions: {
2610
+ postconditions: [],
2611
+ prerequisites: ["Active namespace"],
2612
+ },
2613
+ confirmation_required: false,
2614
+ danger_level: "low",
2615
+ field_docs: {},
2616
+ optional_fields: [],
2617
+ performance_impact: {
2618
+ latency: "moderate",
2619
+ resource_usage: "moderate",
2620
+ },
2621
+ purpose: "List all released-signatures",
2622
+ required_fields: ["path.namespace", "path.vh_name"],
2623
+ side_effects: {},
2624
+ },
2625
+ curlExample: null,
2626
+ },
2627
+ {
2628
+ toolName: "f5xc-api-waf-rule-hit-create",
2629
+ method: "POST",
2630
+ path: "/api/data/namespaces/{namespace}/wafs/metrics/client/rule_hits",
2631
+ operation: "create",
2632
+ domain: "waf",
2633
+ resource: "rule-hit",
2634
+ summary: "Client Rule Hits Metrics.",
2635
+ description: "GET number of rule hits per client for a given namespace.\nThe rule hits counter can be aggregated based on one or more labels listed here.\nNAMESPACE, APP_TYPE, VIRTUAL_HOST, SITE, SERVICE, INSTANCE, WAF_INSTANCE_ID, RULE_ID, RULE_SEVERITY, RULE_TAG.",
2636
+ pathParameters: [
2637
+ {
2638
+ description: "Namespace\n\nnamespace is used to scope the WAF rule hits for the given namespace.",
2639
+ in: "path",
2640
+ name: "namespace",
2641
+ required: true,
2642
+ schema: {
2643
+ type: "string",
2644
+ },
2645
+ "x-displayname": "Namespace",
2646
+ "x-ves-example": "Bloggin-app-namespace-1.",
2647
+ },
2648
+ ],
2649
+ queryParameters: [],
2650
+ requestBodySchema: null,
2651
+ responseSchema: {
2652
+ $ref: "#/components/schemas/wafRuleHitsCountResponse",
2653
+ },
2654
+ requiredParams: ["namespace"],
2655
+ operationId: "ves.io.schema.waf.WAFMonitoringAPI.ClientRuleHitsMetrics",
2656
+ tags: ["Other"],
2657
+ sourceFile: "domains/waf.json",
2658
+ displayName: null,
2659
+ dangerLevel: "medium",
2660
+ sideEffects: {
2661
+ creates: ["rule-hit"],
2662
+ },
2663
+ requiredFields: ["metadata.name", "metadata.namespace", "path.namespace"],
2664
+ confirmationRequired: false,
2665
+ parameterExamples: {
2666
+ namespace: "Bloggin-app-namespace-1.",
2667
+ },
2668
+ validationRules: {},
2669
+ operationMetadata: {
2670
+ common_errors: [
2671
+ {
2672
+ code: 401,
2673
+ message: "Authentication required",
2674
+ solution: "Provide valid API credentials",
2675
+ },
2676
+ {
2677
+ code: 403,
2678
+ message: "Permission denied",
2679
+ solution: "Check access permissions for this operation",
2680
+ },
2681
+ {
2682
+ code: 404,
2683
+ message: "Resource not found",
2684
+ solution: "Verify resource name, namespace, and path",
2685
+ },
2686
+ {
2687
+ code: 409,
2688
+ message: "Resource already exists",
2689
+ solution: "Use different name or update existing resource",
2690
+ },
2691
+ {
2692
+ code: 429,
2693
+ message: "Rate limit exceeded",
2694
+ solution: "Wait before retrying the operation",
2695
+ },
2696
+ {
2697
+ code: 500,
2698
+ message: "Server error",
2699
+ solution: "Retry operation or contact support",
2700
+ },
2701
+ ],
2702
+ conditions: {
2703
+ postconditions: ["Rule-hit resource created", "Resource assigned unique identifier"],
2704
+ prerequisites: ["Active namespace", "Policy parameters defined"],
2705
+ },
2706
+ confirmation_required: false,
2707
+ danger_level: "medium",
2708
+ field_docs: {},
2709
+ optional_fields: [],
2710
+ performance_impact: {
2711
+ latency: "low",
2712
+ resource_usage: "low",
2713
+ },
2714
+ purpose: "Create new rule-hit",
2715
+ required_fields: ["metadata.name", "metadata.namespace", "path.namespace"],
2716
+ side_effects: {
2717
+ creates: ["rule-hit"],
2718
+ },
2719
+ },
2720
+ curlExample: null,
2721
+ },
2722
+ {
2723
+ toolName: "f5xc-api-waf-scroll-create",
2724
+ method: "POST",
2725
+ path: "/api/data/namespaces/{namespace}/app_security/events/scroll",
2726
+ operation: "create",
2727
+ domain: "waf",
2728
+ resource: "scroll",
2729
+ summary: "Security Event Scroll Query.",
2730
+ description: 'Scroll request is used to fetch large number of security events in multiple batches with each SecurityEventResponse\ncontaining no more than 500 messages. To scroll through more than 500 or all messages, one can use the\nSecurityEventScrollRequest. Use the scroll_id returned in the SecurityEventResponse to fetch the next batch of security events\nand one can continue this process till the scroll_id returned is "" which indicates no more events to scroll.',
2731
+ pathParameters: [
2732
+ {
2733
+ description: "Namespace\nfetch the WAF security events scoped by namespace.",
2734
+ in: "path",
2735
+ name: "namespace",
2736
+ required: true,
2737
+ schema: {
2738
+ type: "string",
2739
+ },
2740
+ "x-displayname": "Namespace",
2741
+ "x-ves-example": "Bloggin-app-namespace-1.",
2742
+ },
2743
+ ],
2744
+ queryParameters: [],
2745
+ requestBodySchema: {
2746
+ $ref: "#/components/schemas/app_securitySecurityEventsScrollRequest",
2747
+ },
2748
+ responseSchema: {
2749
+ $ref: "#/components/schemas/app_securitySecurityEventsResponse",
2750
+ },
2751
+ requiredParams: ["body", "namespace"],
2752
+ operationId: "docs_cloud_f5_com_0020_public_ves_io_schema_app_security_ves_swagger_ves.io.schema.app_security.AppSecurityMonitoringAPI.SecurityEventsScrollQuery",
2753
+ tags: ["Other"],
2754
+ sourceFile: "domains/waf.json",
2755
+ displayName: null,
2756
+ dangerLevel: "medium",
2757
+ sideEffects: {
2758
+ creates: ["scroll"],
2759
+ },
2760
+ requiredFields: ["metadata.name", "metadata.namespace", "path.namespace"],
2761
+ confirmationRequired: false,
2762
+ parameterExamples: {
2763
+ namespace: "Bloggin-app-namespace-1.",
2764
+ },
2765
+ validationRules: {},
2766
+ operationMetadata: {
2767
+ common_errors: [
2768
+ {
2769
+ code: 401,
2770
+ message: "Authentication required",
2771
+ solution: "Provide valid API credentials",
2772
+ },
2773
+ {
2774
+ code: 403,
2775
+ message: "Permission denied",
2776
+ solution: "Check access permissions for this operation",
2777
+ },
2778
+ {
2779
+ code: 404,
2780
+ message: "Resource not found",
2781
+ solution: "Verify resource name, namespace, and path",
2782
+ },
2783
+ {
2784
+ code: 409,
2785
+ message: "Resource already exists",
2786
+ solution: "Use different name or update existing resource",
2787
+ },
2788
+ {
2789
+ code: 429,
2790
+ message: "Rate limit exceeded",
2791
+ solution: "Wait before retrying the operation",
2792
+ },
2793
+ {
2794
+ code: 500,
2795
+ message: "Server error",
2796
+ solution: "Retry operation or contact support",
2797
+ },
2798
+ ],
2799
+ conditions: {
2800
+ postconditions: ["Scroll resource created", "Resource assigned unique identifier"],
2801
+ prerequisites: ["Active namespace"],
2802
+ },
2803
+ confirmation_required: false,
2804
+ danger_level: "medium",
2805
+ field_docs: {},
2806
+ optional_fields: [],
2807
+ performance_impact: {
2808
+ latency: "low",
2809
+ resource_usage: "low",
2810
+ },
2811
+ purpose: "Create new scroll",
2812
+ required_fields: ["metadata.name", "metadata.namespace", "path.namespace"],
2813
+ side_effects: {
2814
+ creates: ["scroll"],
2815
+ },
2816
+ },
2817
+ curlExample: null,
2818
+ },
2819
+ {
2820
+ toolName: "f5xc-api-waf-scroll-list",
2821
+ method: "GET",
2822
+ path: "/api/data/namespaces/{namespace}/app_security/events/scroll",
2823
+ operation: "list",
2824
+ domain: "waf",
2825
+ resource: "scroll",
2826
+ summary: "Security Event Scroll Query.",
2827
+ description: 'Scroll request is used to fetch large number of security events in multiple batches with each SecurityEventResponse\ncontaining no more than 500 messages. To scroll through more than 500 or all messages, one can use the\nSecurityEventScrollRequest. Use the scroll_id returned in the SecurityEventResponse to fetch the next batch of security events\nand one can continue this process till the scroll_id returned is "" which indicates no more events to scroll.',
2828
+ pathParameters: [
2829
+ {
2830
+ description: "Namespace\nfetch the WAF security events scoped by namespace.",
2831
+ in: "path",
2832
+ name: "namespace",
2833
+ required: true,
2834
+ schema: {
2835
+ type: "string",
2836
+ },
2837
+ "x-displayname": "Namespace",
2838
+ "x-ves-example": "Bloggin-app-namespace-1.",
2839
+ },
2840
+ ],
2841
+ queryParameters: [
2842
+ {
2843
+ description: "Long Base-64 encoded string which can be used to retrieve next batch of security events.",
2844
+ in: "query",
2845
+ name: "scroll_id",
2846
+ required: false,
2847
+ schema: {
2848
+ type: "string",
2849
+ },
2850
+ "x-displayname": "Scroll ID",
2851
+ "x-ves-example": "DXF1ZXJ5QW5kRmV0Y2gBAAAAAAAAAD4WYm9laVYtZndUQlNsdDcwakFMNjU1QQ==.",
2852
+ },
2853
+ ],
2854
+ requestBodySchema: null,
2855
+ responseSchema: {
2856
+ $ref: "#/components/schemas/app_securitySecurityEventsResponse",
2857
+ },
2858
+ requiredParams: ["namespace"],
2859
+ operationId: "ves.io.schema.app_security.AppSecurityMonitoringAPI.SecurityEventsScrollQuery",
2860
+ tags: ["Other"],
2861
+ sourceFile: "domains/waf.json",
2862
+ displayName: null,
2863
+ dangerLevel: "low",
2864
+ sideEffects: null,
2865
+ requiredFields: ["path.namespace"],
2866
+ confirmationRequired: false,
2867
+ parameterExamples: {
2868
+ namespace: "Bloggin-app-namespace-1.",
2869
+ scroll_id: "DXF1ZXJ5QW5kRmV0Y2gBAAAAAAAAAD4WYm9laVYtZndUQlNsdDcwakFMNjU1QQ==.",
2870
+ },
2871
+ validationRules: {},
2872
+ operationMetadata: {
2873
+ common_errors: [
2874
+ {
2875
+ code: 401,
2876
+ message: "Authentication required",
2877
+ solution: "Provide valid API credentials",
2878
+ },
2879
+ {
2880
+ code: 403,
2881
+ message: "Permission denied",
2882
+ solution: "Check access permissions for this operation",
2883
+ },
2884
+ {
2885
+ code: 404,
2886
+ message: "Resource not found",
2887
+ solution: "Verify resource name, namespace, and path",
2888
+ },
2889
+ {
2890
+ code: 409,
2891
+ message: "Resource already exists",
2892
+ solution: "Use different name or update existing resource",
2893
+ },
2894
+ {
2895
+ code: 429,
2896
+ message: "Rate limit exceeded",
2897
+ solution: "Wait before retrying the operation",
2898
+ },
2899
+ {
2900
+ code: 500,
2901
+ message: "Server error",
2902
+ solution: "Retry operation or contact support",
2903
+ },
2904
+ ],
2905
+ conditions: {
2906
+ postconditions: [],
2907
+ prerequisites: ["Active namespace"],
2908
+ },
2909
+ confirmation_required: false,
2910
+ danger_level: "low",
2911
+ field_docs: {},
2912
+ optional_fields: [],
2913
+ performance_impact: {
2914
+ latency: "moderate",
2915
+ resource_usage: "moderate",
2916
+ },
2917
+ purpose: "List all scrolls",
2918
+ required_fields: ["path.namespace"],
2919
+ side_effects: {},
2920
+ },
2921
+ curlExample: null,
2922
+ },
2923
+ {
2924
+ toolName: "f5xc-api-waf-security-event-create",
2925
+ method: "POST",
2926
+ path: "/api/data/namespaces/{namespace}/wafs/metrics/client/security_events",
2927
+ operation: "create",
2928
+ domain: "waf",
2929
+ resource: "security-event",
2930
+ summary: "Client Security Events Metrics.",
2931
+ description: "GET number of security events per client for a given namespace.\nThe security events counter can be aggregated based on one or more labels listed here.\nNAMESPACE, APP_TYPE, VIRTUAL_HOST, SITE, SERVICE, INSTANCE, WAF_INSTANCE_ID, WAF_MODE.",
2932
+ pathParameters: [
2933
+ {
2934
+ description: "Namespace\nnamespace is used to scope the WAF security events for the given namespace.",
2935
+ in: "path",
2936
+ name: "namespace",
2937
+ required: true,
2938
+ schema: {
2939
+ type: "string",
2940
+ },
2941
+ "x-displayname": "Namespace",
2942
+ "x-ves-example": "Bloggin-app-namespace-1.",
2943
+ },
2944
+ ],
2945
+ queryParameters: [],
2946
+ requestBodySchema: null,
2947
+ responseSchema: {
2948
+ $ref: "#/components/schemas/wafSecurityEventsCountResponse",
2949
+ },
2950
+ requiredParams: ["namespace"],
2951
+ operationId: "ves.io.schema.waf.WAFMonitoringAPI.ClientSecurityEventsMetrics",
2952
+ tags: ["Other"],
2953
+ sourceFile: "domains/waf.json",
2954
+ displayName: null,
2955
+ dangerLevel: "medium",
2956
+ sideEffects: {
2957
+ creates: ["security-event"],
2958
+ },
2959
+ requiredFields: ["metadata.name", "metadata.namespace", "path.namespace"],
2960
+ confirmationRequired: false,
2961
+ parameterExamples: {
2962
+ namespace: "Bloggin-app-namespace-1.",
2963
+ },
2964
+ validationRules: {},
2965
+ operationMetadata: {
2966
+ common_errors: [
2967
+ {
2968
+ code: 401,
2969
+ message: "Authentication required",
2970
+ solution: "Provide valid API credentials",
2971
+ },
2972
+ {
2973
+ code: 403,
2974
+ message: "Permission denied",
2975
+ solution: "Check access permissions for this operation",
2976
+ },
2977
+ {
2978
+ code: 404,
2979
+ message: "Resource not found",
2980
+ solution: "Verify resource name, namespace, and path",
2981
+ },
2982
+ {
2983
+ code: 409,
2984
+ message: "Resource already exists",
2985
+ solution: "Use different name or update existing resource",
2986
+ },
2987
+ {
2988
+ code: 429,
2989
+ message: "Rate limit exceeded",
2990
+ solution: "Wait before retrying the operation",
2991
+ },
2992
+ {
2993
+ code: 500,
2994
+ message: "Server error",
2995
+ solution: "Retry operation or contact support",
2996
+ },
2997
+ ],
2998
+ conditions: {
2999
+ postconditions: ["Security-event resource created", "Resource assigned unique identifier"],
3000
+ prerequisites: ["Active namespace"],
3001
+ },
3002
+ confirmation_required: false,
3003
+ danger_level: "medium",
3004
+ field_docs: {},
3005
+ optional_fields: [],
3006
+ performance_impact: {
3007
+ latency: "low",
3008
+ resource_usage: "low",
3009
+ },
3010
+ purpose: "Create new security-event",
3011
+ required_fields: ["metadata.name", "metadata.namespace", "path.namespace"],
3012
+ side_effects: {
3013
+ creates: ["security-event"],
3014
+ },
3015
+ },
3016
+ curlExample: null,
3017
+ },
3018
+ {
3019
+ toolName: "f5xc-api-waf-staged-signature-create",
3020
+ method: "POST",
3021
+ path: "/api/ml/data/namespaces/{namespace}/virtual_hosts/{vh_name}/staged_signatures",
3022
+ operation: "create",
3023
+ domain: "waf",
3024
+ resource: "staged-signature",
3025
+ summary: "Staged Signatures.",
3026
+ description: "API to GET Staged Signatures.",
3027
+ pathParameters: [
3028
+ {
3029
+ description: "Namespace\nFetch staged signatures for the given namespace.",
3030
+ in: "path",
3031
+ name: "namespace",
3032
+ required: true,
3033
+ schema: {
3034
+ type: "string",
3035
+ },
3036
+ "x-displayname": "Namespace",
3037
+ "x-ves-example": "Shared",
3038
+ },
3039
+ {
3040
+ description: "Vh_name\nVirtual Host for current request.",
3041
+ in: "path",
3042
+ name: "vh_name",
3043
+ required: true,
3044
+ schema: {
3045
+ type: "string",
3046
+ },
3047
+ "x-displayname": "Virtual Host Name.",
3048
+ "x-ves-example": "Blogging-app.",
3049
+ },
3050
+ ],
3051
+ queryParameters: [],
3052
+ requestBodySchema: {
3053
+ $ref: "#/components/schemas/waf_signatures_changelogStagedSignaturesReq",
3054
+ },
3055
+ responseSchema: {
3056
+ $ref: "#/components/schemas/waf_signatures_changelogStagedSignaturesRsp",
3057
+ },
3058
+ requiredParams: ["body", "namespace", "vh_name"],
3059
+ operationId: "ves.io.schema.waf_signatures_changelog.SignatureCustomApi.GetStagedSignatures",
3060
+ tags: ["Other"],
3061
+ sourceFile: "domains/waf.json",
3062
+ displayName: null,
3063
+ dangerLevel: "medium",
3064
+ sideEffects: {
3065
+ creates: ["staged-signature"],
3066
+ },
3067
+ requiredFields: ["metadata.name", "metadata.namespace", "path.namespace", "path.vh_name"],
3068
+ confirmationRequired: false,
3069
+ parameterExamples: {
3070
+ namespace: "Shared",
3071
+ vh_name: "Blogging-app.",
3072
+ },
3073
+ validationRules: {},
3074
+ operationMetadata: {
3075
+ common_errors: [
3076
+ {
3077
+ code: 401,
3078
+ message: "Authentication required",
3079
+ solution: "Provide valid API credentials",
3080
+ },
3081
+ {
3082
+ code: 403,
3083
+ message: "Permission denied",
3084
+ solution: "Check access permissions for this operation",
3085
+ },
3086
+ {
3087
+ code: 404,
3088
+ message: "Resource not found",
3089
+ solution: "Verify resource name, namespace, and path",
3090
+ },
3091
+ {
3092
+ code: 409,
3093
+ message: "Resource already exists",
3094
+ solution: "Use different name or update existing resource",
3095
+ },
3096
+ {
3097
+ code: 429,
3098
+ message: "Rate limit exceeded",
3099
+ solution: "Wait before retrying the operation",
3100
+ },
3101
+ {
3102
+ code: 500,
3103
+ message: "Server error",
3104
+ solution: "Retry operation or contact support",
3105
+ },
3106
+ ],
3107
+ conditions: {
3108
+ postconditions: [
3109
+ "Staged-signature resource created",
3110
+ "Resource assigned unique identifier",
3111
+ ],
3112
+ prerequisites: ["Active namespace"],
3113
+ },
3114
+ confirmation_required: false,
3115
+ danger_level: "medium",
3116
+ field_docs: {},
3117
+ optional_fields: [],
3118
+ performance_impact: {
3119
+ latency: "low",
3120
+ resource_usage: "low",
3121
+ },
3122
+ purpose: "Create new staged-signature",
3123
+ required_fields: ["metadata.name", "metadata.namespace", "path.namespace", "path.vh_name"],
3124
+ side_effects: {
3125
+ creates: ["staged-signature"],
3126
+ },
3127
+ },
3128
+ curlExample: null,
3129
+ },
3130
+ {
3131
+ toolName: "f5xc-api-waf-suspicious-user-log-create",
3132
+ method: "POST",
3133
+ path: "/api/data/namespaces/{namespace}/app_security/suspicious_user_logs",
3134
+ operation: "create",
3135
+ domain: "waf",
3136
+ resource: "suspicious-user-log",
3137
+ summary: "Suspicious User Logs Query.",
3138
+ description: "GET suspicious user logs for the given namespace.\nFor `system` namespace, all suspicious users logs for the tenant matching the query specified\nin the request will be returned in the response. User may query suspicious user logs that matches various\nfields such as `vh_name`, `user`, `site`, `city`, `country`.",
3139
+ pathParameters: [
3140
+ {
3141
+ description: "Namespace\n\nfetch suspicious user logs for a given namespace.",
3142
+ in: "path",
3143
+ name: "namespace",
3144
+ required: true,
3145
+ schema: {
3146
+ type: "string",
3147
+ },
3148
+ "x-displayname": "Namespace",
3149
+ "x-ves-example": "Bloggin-app-namespace-1.",
3150
+ },
3151
+ ],
3152
+ queryParameters: [],
3153
+ requestBodySchema: {
3154
+ $ref: "#/components/schemas/app_securitySuspiciousUserLogsRequest",
3155
+ },
3156
+ responseSchema: {
3157
+ $ref: "#/components/schemas/app_securitySuspiciousUserLogsResponse",
3158
+ },
3159
+ requiredParams: ["body", "namespace"],
3160
+ operationId: "ves.io.schema.app_security.AppSecurityMonitoringAPI.SuspiciousUserLogsQuery",
3161
+ tags: ["Other"],
3162
+ sourceFile: "domains/waf.json",
3163
+ displayName: null,
3164
+ dangerLevel: "medium",
3165
+ sideEffects: {
3166
+ creates: ["suspicious-user-log"],
3167
+ },
3168
+ requiredFields: ["metadata.name", "metadata.namespace", "path.namespace"],
3169
+ confirmationRequired: false,
3170
+ parameterExamples: {
3171
+ namespace: "Bloggin-app-namespace-1.",
3172
+ },
3173
+ validationRules: {},
3174
+ operationMetadata: {
3175
+ common_errors: [
3176
+ {
3177
+ code: 401,
3178
+ message: "Authentication required",
3179
+ solution: "Provide valid API credentials",
3180
+ },
3181
+ {
3182
+ code: 403,
3183
+ message: "Permission denied",
3184
+ solution: "Check access permissions for this operation",
3185
+ },
3186
+ {
3187
+ code: 404,
3188
+ message: "Resource not found",
3189
+ solution: "Verify resource name, namespace, and path",
3190
+ },
3191
+ {
3192
+ code: 409,
3193
+ message: "Resource already exists",
3194
+ solution: "Use different name or update existing resource",
3195
+ },
3196
+ {
3197
+ code: 429,
3198
+ message: "Rate limit exceeded",
3199
+ solution: "Wait before retrying the operation",
3200
+ },
3201
+ {
3202
+ code: 500,
3203
+ message: "Server error",
3204
+ solution: "Retry operation or contact support",
3205
+ },
3206
+ ],
3207
+ conditions: {
3208
+ postconditions: [
3209
+ "Suspicious-user-log resource created",
3210
+ "Resource assigned unique identifier",
3211
+ ],
3212
+ prerequisites: ["Active namespace"],
3213
+ },
3214
+ confirmation_required: false,
3215
+ danger_level: "medium",
3216
+ field_docs: {},
3217
+ optional_fields: [],
3218
+ performance_impact: {
3219
+ latency: "low",
3220
+ resource_usage: "low",
3221
+ },
3222
+ purpose: "Create new suspicious-user-log",
3223
+ required_fields: ["metadata.name", "metadata.namespace", "path.namespace"],
3224
+ side_effects: {
3225
+ creates: ["suspicious-user-log"],
3226
+ },
3227
+ },
3228
+ curlExample: null,
3229
+ },
3230
+ {
3231
+ toolName: "f5xc-api-waf-waf-exclusion-policy-create",
3232
+ method: "POST",
3233
+ path: "/api/config/namespaces/{metadata.namespace}/waf_exclusion_policys",
3234
+ operation: "create",
3235
+ domain: "waf",
3236
+ resource: "waf-exclusion-policy",
3237
+ summary: "Create WAF Exclusion Policy.",
3238
+ description: "Create a WAF exclusion policy.",
3239
+ pathParameters: [
3240
+ {
3241
+ description: 'Namespace\nThis defines the workspace within which each the configuration object is to be created.\nMust be a DNS_LABEL format. For a namespace object itself, namespace value will be ""',
3242
+ in: "path",
3243
+ name: "metadata.namespace",
3244
+ required: true,
3245
+ schema: {
3246
+ type: "string",
3247
+ },
3248
+ "x-displayname": "Namespace",
3249
+ "x-ves-example": "Staging",
3250
+ },
3251
+ ],
3252
+ queryParameters: [],
3253
+ requestBodySchema: {
3254
+ $ref: "#/components/schemas/waf_exclusion_policyCreateRequest",
3255
+ },
3256
+ responseSchema: {
3257
+ $ref: "#/components/schemas/waf_exclusion_policyCreateResponse",
3258
+ },
3259
+ requiredParams: ["body", "metadata.namespace"],
3260
+ operationId: "ves.io.schema.waf_exclusion_policy.API.Create",
3261
+ tags: ["Other"],
3262
+ sourceFile: "domains/waf.json",
3263
+ displayName: null,
3264
+ dangerLevel: "medium",
3265
+ sideEffects: {
3266
+ creates: ["waf-exclusion-policy"],
3267
+ },
3268
+ requiredFields: ["metadata.name", "metadata.namespace", "path.metadata.namespace"],
3269
+ confirmationRequired: false,
3270
+ parameterExamples: {
3271
+ "metadata.namespace": "Staging",
3272
+ },
3273
+ validationRules: {},
3274
+ operationMetadata: {
3275
+ common_errors: [
3276
+ {
3277
+ code: 401,
3278
+ message: "Authentication required",
3279
+ solution: "Provide valid API credentials",
3280
+ },
3281
+ {
3282
+ code: 403,
3283
+ message: "Permission denied",
3284
+ solution: "Check access permissions for this operation",
3285
+ },
3286
+ {
3287
+ code: 404,
3288
+ message: "Resource not found",
3289
+ solution: "Verify resource name, namespace, and path",
3290
+ },
3291
+ {
3292
+ code: 409,
3293
+ message: "Resource already exists",
3294
+ solution: "Use different name or update existing resource",
3295
+ },
3296
+ {
3297
+ code: 429,
3298
+ message: "Rate limit exceeded",
3299
+ solution: "Wait before retrying the operation",
3300
+ },
3301
+ {
3302
+ code: 500,
3303
+ message: "Server error",
3304
+ solution: "Retry operation or contact support",
3305
+ },
3306
+ ],
3307
+ conditions: {
3308
+ postconditions: [
3309
+ "Waf-exclusion-policy resource created",
3310
+ "Resource assigned unique identifier",
3311
+ ],
3312
+ prerequisites: ["Active namespace", "Policy parameters defined"],
3313
+ },
3314
+ confirmation_required: false,
3315
+ danger_level: "medium",
3316
+ field_docs: {},
3317
+ optional_fields: [],
3318
+ performance_impact: {
3319
+ latency: "low",
3320
+ resource_usage: "low",
3321
+ },
3322
+ purpose: "Create new waf-exclusion-policy",
3323
+ required_fields: ["metadata.name", "metadata.namespace", "path.metadata.namespace"],
3324
+ side_effects: {
3325
+ creates: ["waf-exclusion-policy"],
3326
+ },
3327
+ },
3328
+ curlExample: null,
3329
+ },
3330
+ {
3331
+ toolName: "f5xc-api-waf-waf-exclusion-policy-delete",
3332
+ method: "DELETE",
3333
+ path: "/api/config/namespaces/{namespace}/waf_exclusion_policys/{name}",
3334
+ operation: "delete",
3335
+ domain: "waf",
3336
+ resource: "waf-exclusion-policy",
3337
+ summary: "DELETE WAF Exclusion Policy.",
3338
+ description: "DELETE the specified waf_exclusion_policy.",
3339
+ pathParameters: [
3340
+ {
3341
+ description: "Name\nName of the configuration object.",
3342
+ in: "path",
3343
+ name: "name",
3344
+ required: true,
3345
+ schema: {
3346
+ type: "string",
3347
+ },
3348
+ "x-displayname": "Name",
3349
+ "x-ves-example": "Name",
3350
+ },
3351
+ {
3352
+ description: "Namespace\nNamespace in which the configuration object is present.",
3353
+ in: "path",
3354
+ name: "namespace",
3355
+ required: true,
3356
+ schema: {
3357
+ type: "string",
3358
+ },
3359
+ "x-displayname": "Namespace",
3360
+ "x-ves-example": "Ns1",
3361
+ },
3362
+ ],
3363
+ queryParameters: [],
3364
+ requestBodySchema: {
3365
+ $ref: "#/components/schemas/waf_exclusion_policyDeleteRequest",
3366
+ },
3367
+ responseSchema: {},
3368
+ requiredParams: ["body", "name", "namespace"],
3369
+ operationId: "ves.io.schema.waf_exclusion_policy.API.Delete",
3370
+ tags: ["Other"],
3371
+ sourceFile: "domains/waf.json",
3372
+ displayName: null,
3373
+ dangerLevel: "high",
3374
+ sideEffects: {
3375
+ deletes: ["waf-exclusion-policy", "contained_resources"],
3376
+ },
3377
+ requiredFields: ["path.name", "path.namespace"],
3378
+ confirmationRequired: true,
3379
+ parameterExamples: {
3380
+ name: "Name",
3381
+ namespace: "Ns1",
3382
+ },
3383
+ validationRules: {},
3384
+ operationMetadata: {
3385
+ common_errors: [
3386
+ {
3387
+ code: 401,
3388
+ message: "Authentication required",
3389
+ solution: "Provide valid API credentials",
3390
+ },
3391
+ {
3392
+ code: 403,
3393
+ message: "Permission denied",
3394
+ solution: "Check access permissions for this operation",
3395
+ },
3396
+ {
3397
+ code: 404,
3398
+ message: "Resource not found",
3399
+ solution: "Verify resource name, namespace, and path",
3400
+ },
3401
+ {
3402
+ code: 409,
3403
+ message: "Resource already exists",
3404
+ solution: "Use different name or update existing resource",
3405
+ },
3406
+ {
3407
+ code: 429,
3408
+ message: "Rate limit exceeded",
3409
+ solution: "Wait before retrying the operation",
3410
+ },
3411
+ {
3412
+ code: 500,
3413
+ message: "Server error",
3414
+ solution: "Retry operation or contact support",
3415
+ },
3416
+ ],
3417
+ conditions: {
3418
+ postconditions: ["Resource removed from system", "Associated resources may be affected"],
3419
+ prerequisites: ["Active namespace", "Policy parameters defined"],
3420
+ },
3421
+ confirmation_required: true,
3422
+ danger_level: "high",
3423
+ field_docs: {},
3424
+ optional_fields: [],
3425
+ performance_impact: {
3426
+ latency: "high",
3427
+ resource_usage: "moderate",
3428
+ },
3429
+ purpose: "Delete waf-exclusion-policy",
3430
+ required_fields: ["path.name", "path.namespace"],
3431
+ side_effects: {
3432
+ deletes: ["waf-exclusion-policy", "contained_resources"],
3433
+ },
3434
+ },
3435
+ curlExample: null,
3436
+ },
3437
+ {
3438
+ toolName: "f5xc-api-waf-waf-exclusion-policy-get",
3439
+ method: "GET",
3440
+ path: "/api/config/namespaces/{namespace}/waf_exclusion_policys/{name}",
3441
+ operation: "get",
3442
+ domain: "waf",
3443
+ resource: "waf-exclusion-policy",
3444
+ summary: "GET WAF Exclusion Policy.",
3445
+ description: "Retrieve a WAF exclusion policy.",
3446
+ pathParameters: [
3447
+ {
3448
+ description: "Name\nThe name of the configuration object to be fetched.",
3449
+ in: "path",
3450
+ name: "name",
3451
+ required: true,
3452
+ schema: {
3453
+ type: "string",
3454
+ },
3455
+ "x-displayname": "Name",
3456
+ "x-ves-example": "Name",
3457
+ },
3458
+ {
3459
+ description: "Namespace\nThe namespace in which the configuration object is present.",
3460
+ in: "path",
3461
+ name: "namespace",
3462
+ required: true,
3463
+ schema: {
3464
+ type: "string",
3465
+ },
3466
+ "x-displayname": "Namespace",
3467
+ "x-ves-example": "Ns1",
3468
+ },
3469
+ ],
3470
+ queryParameters: [
3471
+ {
3472
+ description: "The format in which the configuration object is to be fetched. This could be for example\n - in GetSpec form for the contents of object\n - in CreateRequest form to create a new similar object\n - to ReplaceRequest form to replace changeable values\n\nDefault format of returned resource\nResponse should be in CreateRequest format\nResponse should be in ReplaceRequest format\nResponse should be in StatusObject(s) format\nResponse should be in format of GetSpecType\nResponse should have other objects referring to this object\nResponse should have deleted and disabled objects referrred by this object.",
3473
+ in: "query",
3474
+ name: "response_format",
3475
+ required: false,
3476
+ schema: {
3477
+ default: "GET_RSP_FORMAT_DEFAULT",
3478
+ enum: [
3479
+ "GET_RSP_FORMAT_DEFAULT",
3480
+ "GET_RSP_FORMAT_FOR_CREATE",
3481
+ "GET_RSP_FORMAT_FOR_REPLACE",
3482
+ "GET_RSP_FORMAT_STATUS",
3483
+ "GET_RSP_FORMAT_READ",
3484
+ "GET_RSP_FORMAT_REFERRING_OBJECTS",
3485
+ "GET_RSP_FORMAT_BROKEN_REFERENCES",
3486
+ ],
3487
+ type: "string",
3488
+ },
3489
+ "x-displayname": "Broken Referred Objects.",
3490
+ },
3491
+ ],
3492
+ requestBodySchema: null,
3493
+ responseSchema: {
3494
+ $ref: "#/components/schemas/waf_exclusion_policyGetResponse",
3495
+ },
3496
+ requiredParams: ["name", "namespace"],
3497
+ operationId: "ves.io.schema.waf_exclusion_policy.API.Get",
3498
+ tags: ["Other"],
3499
+ sourceFile: "domains/waf.json",
3500
+ displayName: null,
3501
+ dangerLevel: "low",
3502
+ sideEffects: null,
3503
+ requiredFields: ["path.name", "path.namespace"],
3504
+ confirmationRequired: false,
3505
+ parameterExamples: {
3506
+ name: "Name",
3507
+ namespace: "Ns1",
3508
+ },
3509
+ validationRules: {},
3510
+ operationMetadata: {
3511
+ common_errors: [
3512
+ {
3513
+ code: 401,
3514
+ message: "Authentication required",
3515
+ solution: "Provide valid API credentials",
3516
+ },
3517
+ {
3518
+ code: 403,
3519
+ message: "Permission denied",
3520
+ solution: "Check access permissions for this operation",
3521
+ },
3522
+ {
3523
+ code: 404,
3524
+ message: "Resource not found",
3525
+ solution: "Verify resource name, namespace, and path",
3526
+ },
3527
+ {
3528
+ code: 409,
3529
+ message: "Resource already exists",
3530
+ solution: "Use different name or update existing resource",
3531
+ },
3532
+ {
3533
+ code: 429,
3534
+ message: "Rate limit exceeded",
3535
+ solution: "Wait before retrying the operation",
3536
+ },
3537
+ {
3538
+ code: 500,
3539
+ message: "Server error",
3540
+ solution: "Retry operation or contact support",
3541
+ },
3542
+ ],
3543
+ conditions: {
3544
+ postconditions: [],
3545
+ prerequisites: ["Active namespace", "Policy parameters defined"],
3546
+ },
3547
+ confirmation_required: false,
3548
+ danger_level: "low",
3549
+ field_docs: {},
3550
+ optional_fields: [],
3551
+ performance_impact: {
3552
+ latency: "low",
3553
+ resource_usage: "low",
3554
+ },
3555
+ purpose: "Retrieve specific waf-exclusion-policy",
3556
+ required_fields: ["path.name", "path.namespace"],
3557
+ side_effects: {},
3558
+ },
3559
+ curlExample: null,
3560
+ },
3561
+ {
3562
+ toolName: "f5xc-api-waf-waf-exclusion-policy-list",
3563
+ method: "GET",
3564
+ path: "/api/config/namespaces/{namespace}/waf_exclusion_policys",
3565
+ operation: "list",
3566
+ domain: "waf",
3567
+ resource: "waf-exclusion-policy",
3568
+ summary: "List WAF Exclusion Policy.",
3569
+ description: "List the set of waf_exclusion_policy in a namespace.",
3570
+ pathParameters: [
3571
+ {
3572
+ description: "Namespace\nNamespace to scope the listing of waf_exclusion_policy.",
3573
+ in: "path",
3574
+ name: "namespace",
3575
+ required: true,
3576
+ schema: {
3577
+ type: "string",
3578
+ },
3579
+ "x-displayname": "Namespace",
3580
+ "x-ves-example": "Ns1",
3581
+ },
3582
+ ],
3583
+ queryParameters: [
3584
+ {
3585
+ description: "A LabelSelectorType expression that every item in list response will satisfy.",
3586
+ in: "query",
3587
+ name: "label_filter",
3588
+ required: false,
3589
+ schema: {
3590
+ type: "string",
3591
+ },
3592
+ "x-displayname": "Label Filter.",
3593
+ "x-ves-example": "Env in (staging, testing), tier in (web, db)",
3594
+ },
3595
+ {
3596
+ description: 'X-example: ""\nExtra fields to return along with summary fields.',
3597
+ in: "query",
3598
+ name: "report_fields",
3599
+ required: false,
3600
+ schema: {
3601
+ items: {
3602
+ type: "string",
3603
+ },
3604
+ type: "array",
3605
+ },
3606
+ "x-displayname": "Report Fields.",
3607
+ },
3608
+ {
3609
+ description: 'X-example: ""\nExtra status fields to return along with summary fields.',
3610
+ in: "query",
3611
+ name: "report_status_fields",
3612
+ required: false,
3613
+ schema: {
3614
+ items: {
3615
+ type: "string",
3616
+ },
3617
+ type: "array",
3618
+ },
3619
+ "x-displayname": "Report Status Fields.",
3620
+ },
3621
+ ],
3622
+ requestBodySchema: null,
3623
+ responseSchema: {
3624
+ $ref: "#/components/schemas/waf_exclusion_policyListResponse",
3625
+ },
3626
+ requiredParams: ["namespace"],
3627
+ operationId: "ves.io.schema.waf_exclusion_policy.API.List",
3628
+ tags: ["Other"],
3629
+ sourceFile: "domains/waf.json",
3630
+ displayName: null,
3631
+ dangerLevel: "low",
3632
+ sideEffects: null,
3633
+ requiredFields: ["path.namespace"],
3634
+ confirmationRequired: false,
3635
+ parameterExamples: {
3636
+ label_filter: "Env in (staging, testing), tier in (web, db)",
3637
+ namespace: "Ns1",
3638
+ },
3639
+ validationRules: {},
3640
+ operationMetadata: {
3641
+ common_errors: [
3642
+ {
3643
+ code: 401,
3644
+ message: "Authentication required",
3645
+ solution: "Provide valid API credentials",
3646
+ },
3647
+ {
3648
+ code: 403,
3649
+ message: "Permission denied",
3650
+ solution: "Check access permissions for this operation",
3651
+ },
3652
+ {
3653
+ code: 404,
3654
+ message: "Resource not found",
3655
+ solution: "Verify resource name, namespace, and path",
3656
+ },
3657
+ {
3658
+ code: 409,
3659
+ message: "Resource already exists",
3660
+ solution: "Use different name or update existing resource",
3661
+ },
3662
+ {
3663
+ code: 429,
3664
+ message: "Rate limit exceeded",
3665
+ solution: "Wait before retrying the operation",
3666
+ },
3667
+ {
3668
+ code: 500,
3669
+ message: "Server error",
3670
+ solution: "Retry operation or contact support",
3671
+ },
3672
+ ],
3673
+ conditions: {
3674
+ postconditions: [],
3675
+ prerequisites: ["Active namespace", "Policy parameters defined"],
3676
+ },
3677
+ confirmation_required: false,
3678
+ danger_level: "low",
3679
+ field_docs: {},
3680
+ optional_fields: [],
3681
+ performance_impact: {
3682
+ latency: "moderate",
3683
+ resource_usage: "moderate",
3684
+ },
3685
+ purpose: "List all waf-exclusion-policys",
3686
+ required_fields: ["path.namespace"],
3687
+ side_effects: {},
3688
+ },
3689
+ curlExample: null,
3690
+ },
3691
+ {
3692
+ toolName: "f5xc-api-waf-waf-exclusion-policy-update",
3693
+ method: "PUT",
3694
+ path: "/api/config/namespaces/{metadata.namespace}/waf_exclusion_policys/{metadata.name}",
3695
+ operation: "update",
3696
+ domain: "waf",
3697
+ resource: "waf-exclusion-policy",
3698
+ summary: "Replace WAF Exclusion Policy.",
3699
+ description: "Replace an existing WAF exclusion policy.",
3700
+ pathParameters: [
3701
+ {
3702
+ description: "Name\nThe configuration object to be replaced will be looked up by name.",
3703
+ in: "path",
3704
+ name: "metadata.name",
3705
+ required: true,
3706
+ schema: {
3707
+ type: "string",
3708
+ },
3709
+ "x-displayname": "Name",
3710
+ "x-ves-example": "Example-corp-web.",
3711
+ },
3712
+ {
3713
+ description: 'Namespace\nThis defines the workspace within which each the configuration object is to be created.\nMust be a DNS_LABEL format. For a namespace object itself, namespace value will be ""',
3714
+ in: "path",
3715
+ name: "metadata.namespace",
3716
+ required: true,
3717
+ schema: {
3718
+ type: "string",
3719
+ },
3720
+ "x-displayname": "Namespace",
3721
+ "x-ves-example": "Staging",
3722
+ },
3723
+ ],
3724
+ queryParameters: [],
3725
+ requestBodySchema: {
3726
+ $ref: "#/components/schemas/waf_exclusion_policyReplaceRequest",
3727
+ },
3728
+ responseSchema: {
3729
+ $ref: "#/components/schemas/waf_exclusion_policyReplaceResponse",
3730
+ },
3731
+ requiredParams: ["body", "metadata.name", "metadata.namespace"],
3732
+ operationId: "ves.io.schema.waf_exclusion_policy.API.Replace",
3733
+ tags: ["Other"],
3734
+ sourceFile: "domains/waf.json",
3735
+ displayName: null,
3736
+ dangerLevel: "medium",
3737
+ sideEffects: {
3738
+ modifies: ["waf-exclusion-policy"],
3739
+ },
3740
+ requiredFields: ["path.metadata.name", "path.metadata.namespace"],
3741
+ confirmationRequired: false,
3742
+ parameterExamples: {
3743
+ "metadata.name": "Example-corp-web.",
3744
+ "metadata.namespace": "Staging",
3745
+ },
3746
+ validationRules: {},
3747
+ operationMetadata: {
3748
+ common_errors: [
3749
+ {
3750
+ code: 401,
3751
+ message: "Authentication required",
3752
+ solution: "Provide valid API credentials",
3753
+ },
3754
+ {
3755
+ code: 403,
3756
+ message: "Permission denied",
3757
+ solution: "Check access permissions for this operation",
3758
+ },
3759
+ {
3760
+ code: 404,
3761
+ message: "Resource not found",
3762
+ solution: "Verify resource name, namespace, and path",
3763
+ },
3764
+ {
3765
+ code: 409,
3766
+ message: "Resource already exists",
3767
+ solution: "Use different name or update existing resource",
3768
+ },
3769
+ {
3770
+ code: 429,
3771
+ message: "Rate limit exceeded",
3772
+ solution: "Wait before retrying the operation",
3773
+ },
3774
+ {
3775
+ code: 500,
3776
+ message: "Server error",
3777
+ solution: "Retry operation or contact support",
3778
+ },
3779
+ ],
3780
+ conditions: {
3781
+ postconditions: ["Resource updated with new values"],
3782
+ prerequisites: ["Active namespace", "Policy parameters defined"],
3783
+ },
3784
+ confirmation_required: false,
3785
+ danger_level: "medium",
3786
+ field_docs: {},
3787
+ optional_fields: [],
3788
+ performance_impact: {
3789
+ latency: "low",
3790
+ resource_usage: "low",
3791
+ },
3792
+ purpose: "Replace existing waf-exclusion-policy",
3793
+ required_fields: ["path.metadata.name", "path.metadata.namespace"],
3794
+ side_effects: {
3795
+ modifies: ["waf-exclusion-policy"],
3796
+ },
3797
+ },
3798
+ curlExample: null,
3799
+ },
3800
+ ];
3801
+ export default wafTools;
3802
+ //# sourceMappingURL=index.js.map