@robinmordasiewicz/f5xc-api-mcp 3.3.1 → 3.4.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 (235) hide show
  1. package/dist/generator/openapi-parser.d.ts +418 -0
  2. package/dist/generator/openapi-parser.d.ts.map +1 -1
  3. package/dist/generator/openapi-parser.js +132 -0
  4. package/dist/generator/openapi-parser.js.map +1 -1
  5. package/dist/generator/tool-generator.d.ts +29 -1
  6. package/dist/generator/tool-generator.d.ts.map +1 -1
  7. package/dist/generator/tool-generator.js +150 -7
  8. package/dist/generator/tool-generator.js.map +1 -1
  9. package/dist/tools/discovery/describe.d.ts +1 -0
  10. package/dist/tools/discovery/describe.d.ts.map +1 -1
  11. package/dist/tools/discovery/describe.js +10 -8
  12. package/dist/tools/discovery/describe.js.map +1 -1
  13. package/dist/tools/generated/admin_console_and_ui/index.d.ts +8 -0
  14. package/dist/tools/generated/admin_console_and_ui/index.d.ts.map +1 -0
  15. package/dist/tools/generated/admin_console_and_ui/index.js +285 -0
  16. package/dist/tools/generated/admin_console_and_ui/index.js.map +1 -0
  17. package/dist/tools/generated/api/index.d.ts +8 -0
  18. package/dist/tools/generated/{vpn → api}/index.d.ts.map +1 -1
  19. package/dist/tools/generated/api/index.js +6668 -0
  20. package/dist/tools/generated/api/index.js.map +1 -0
  21. package/dist/tools/generated/authentication/index.d.ts +8 -0
  22. package/dist/tools/generated/authentication/index.d.ts.map +1 -0
  23. package/dist/tools/generated/authentication/index.js +1005 -0
  24. package/dist/tools/generated/authentication/index.js.map +1 -0
  25. package/dist/tools/generated/bigip/index.d.ts.map +1 -1
  26. package/dist/tools/generated/bigip/index.js +2045 -0
  27. package/dist/tools/generated/bigip/index.js.map +1 -1
  28. package/dist/tools/generated/billing_and_usage/index.d.ts +8 -0
  29. package/dist/tools/generated/billing_and_usage/index.d.ts.map +1 -0
  30. package/dist/tools/generated/billing_and_usage/index.js +2702 -0
  31. package/dist/tools/generated/billing_and_usage/index.js.map +1 -0
  32. package/dist/tools/generated/blindfold/index.d.ts +8 -0
  33. package/dist/tools/generated/blindfold/index.d.ts.map +1 -0
  34. package/dist/tools/generated/blindfold/index.js +3998 -0
  35. package/dist/tools/generated/blindfold/index.js.map +1 -0
  36. package/dist/tools/generated/bot_and_threat_defense/index.d.ts +8 -0
  37. package/dist/tools/generated/bot_and_threat_defense/index.d.ts.map +1 -0
  38. package/dist/tools/generated/bot_and_threat_defense/index.js +2584 -0
  39. package/dist/tools/generated/bot_and_threat_defense/index.js.map +1 -0
  40. package/dist/tools/generated/cdn/index.d.ts.map +1 -1
  41. package/dist/tools/generated/cdn/index.js +1904 -0
  42. package/dist/tools/generated/cdn/index.js.map +1 -1
  43. package/dist/tools/generated/ce_management/index.d.ts +8 -0
  44. package/dist/tools/generated/ce_management/index.d.ts.map +1 -0
  45. package/dist/tools/generated/ce_management/index.js +3963 -0
  46. package/dist/tools/generated/ce_management/index.js.map +1 -0
  47. package/dist/tools/generated/certificates/index.d.ts +8 -0
  48. package/dist/tools/generated/certificates/index.d.ts.map +1 -0
  49. package/dist/tools/generated/certificates/index.js +2579 -0
  50. package/dist/tools/generated/certificates/index.js.map +1 -0
  51. package/dist/tools/generated/cloud_infrastructure/index.d.ts +8 -0
  52. package/dist/tools/generated/cloud_infrastructure/index.d.ts.map +1 -0
  53. package/dist/tools/generated/cloud_infrastructure/index.js +4124 -0
  54. package/dist/tools/generated/cloud_infrastructure/index.js.map +1 -0
  55. package/dist/tools/generated/container_services/index.d.ts +8 -0
  56. package/dist/tools/generated/container_services/index.d.ts.map +1 -0
  57. package/dist/tools/generated/container_services/index.js +2054 -0
  58. package/dist/tools/generated/container_services/index.js.map +1 -0
  59. package/dist/tools/generated/data_and_privacy_security/index.d.ts +8 -0
  60. package/dist/tools/generated/data_and_privacy_security/index.d.ts.map +1 -0
  61. package/dist/tools/generated/data_and_privacy_security/index.js +1708 -0
  62. package/dist/tools/generated/data_and_privacy_security/index.js.map +1 -0
  63. package/dist/tools/generated/data_intelligence/index.d.ts +8 -0
  64. package/dist/tools/generated/data_intelligence/index.d.ts.map +1 -0
  65. package/dist/tools/generated/data_intelligence/index.js +1770 -0
  66. package/dist/tools/generated/data_intelligence/index.js.map +1 -0
  67. package/dist/tools/generated/ddos/index.d.ts +8 -0
  68. package/dist/tools/generated/ddos/index.d.ts.map +1 -0
  69. package/dist/tools/generated/ddos/index.js +8511 -0
  70. package/dist/tools/generated/ddos/index.js.map +1 -0
  71. package/dist/tools/generated/dns/index.d.ts +8 -0
  72. package/dist/tools/generated/dns/index.d.ts.map +1 -0
  73. package/dist/tools/generated/dns/index.js +6460 -0
  74. package/dist/tools/generated/dns/index.js.map +1 -0
  75. package/dist/tools/generated/generative_ai/index.d.ts +8 -0
  76. package/dist/tools/generated/generative_ai/index.d.ts.map +1 -0
  77. package/dist/tools/generated/generative_ai/index.js +1215 -0
  78. package/dist/tools/generated/generative_ai/index.js.map +1 -0
  79. package/dist/tools/generated/managed_kubernetes/index.d.ts +8 -0
  80. package/dist/tools/generated/managed_kubernetes/index.d.ts.map +1 -0
  81. package/dist/tools/generated/managed_kubernetes/index.js +3233 -0
  82. package/dist/tools/generated/managed_kubernetes/index.js.map +1 -0
  83. package/dist/tools/generated/marketplace/index.d.ts +8 -0
  84. package/dist/tools/generated/marketplace/index.d.ts.map +1 -0
  85. package/dist/tools/generated/marketplace/index.js +4580 -0
  86. package/dist/tools/generated/marketplace/index.js.map +1 -0
  87. package/dist/tools/generated/network/index.d.ts +8 -0
  88. package/dist/tools/generated/network/index.d.ts.map +1 -0
  89. package/dist/tools/generated/network/index.js +12616 -0
  90. package/dist/tools/generated/network/index.js.map +1 -0
  91. package/dist/tools/generated/network_security/index.d.ts +8 -0
  92. package/dist/tools/generated/network_security/index.d.ts.map +1 -0
  93. package/dist/tools/generated/network_security/index.js +8884 -0
  94. package/dist/tools/generated/network_security/index.js.map +1 -0
  95. package/dist/tools/generated/nginx_one/index.d.ts +8 -0
  96. package/dist/tools/generated/nginx_one/index.d.ts.map +1 -0
  97. package/dist/tools/generated/nginx_one/index.js +1820 -0
  98. package/dist/tools/generated/nginx_one/index.js.map +1 -0
  99. package/dist/tools/generated/object_storage/index.d.ts +8 -0
  100. package/dist/tools/generated/object_storage/index.d.ts.map +1 -0
  101. package/dist/tools/generated/object_storage/index.js +1055 -0
  102. package/dist/tools/generated/object_storage/index.js.map +1 -0
  103. package/dist/tools/generated/observability/index.d.ts.map +1 -1
  104. package/dist/tools/generated/observability/index.js +4243 -4618
  105. package/dist/tools/generated/observability/index.js.map +1 -1
  106. package/dist/tools/generated/rate_limiting/index.d.ts +8 -0
  107. package/dist/tools/generated/rate_limiting/index.d.ts.map +1 -0
  108. package/dist/tools/generated/rate_limiting/index.js +1937 -0
  109. package/dist/tools/generated/rate_limiting/index.js.map +1 -0
  110. package/dist/tools/generated/secops_and_incident_response/index.d.ts +8 -0
  111. package/dist/tools/generated/secops_and_incident_response/index.d.ts.map +1 -0
  112. package/dist/tools/generated/secops_and_incident_response/index.js +653 -0
  113. package/dist/tools/generated/secops_and_incident_response/index.js.map +1 -0
  114. package/dist/tools/generated/service_mesh/index.d.ts.map +1 -1
  115. package/dist/tools/generated/service_mesh/index.js +4532 -438
  116. package/dist/tools/generated/service_mesh/index.js.map +1 -1
  117. package/dist/tools/generated/shape/index.d.ts +8 -0
  118. package/dist/tools/generated/shape/index.d.ts.map +1 -0
  119. package/dist/tools/generated/shape/index.js +21784 -0
  120. package/dist/tools/generated/shape/index.js.map +1 -0
  121. package/dist/tools/generated/sites/index.d.ts +8 -0
  122. package/dist/tools/generated/sites/index.d.ts.map +1 -0
  123. package/dist/tools/generated/sites/index.js +13252 -0
  124. package/dist/tools/generated/sites/index.js.map +1 -0
  125. package/dist/tools/generated/statistics/index.d.ts +8 -0
  126. package/dist/tools/generated/statistics/index.d.ts.map +1 -0
  127. package/dist/tools/generated/statistics/index.js +8837 -0
  128. package/dist/tools/generated/statistics/index.js.map +1 -0
  129. package/dist/tools/generated/support/index.d.ts +8 -0
  130. package/dist/tools/generated/support/index.d.ts.map +1 -0
  131. package/dist/tools/generated/support/index.js +6215 -0
  132. package/dist/tools/generated/support/index.js.map +1 -0
  133. package/dist/tools/generated/telemetry_and_insights/index.d.ts +8 -0
  134. package/dist/tools/generated/telemetry_and_insights/index.d.ts.map +1 -0
  135. package/dist/tools/generated/telemetry_and_insights/index.js +2773 -0
  136. package/dist/tools/generated/telemetry_and_insights/index.js.map +1 -0
  137. package/dist/tools/generated/tenant_and_identity/index.d.ts +8 -0
  138. package/dist/tools/generated/tenant_and_identity/index.d.ts.map +1 -0
  139. package/dist/tools/generated/tenant_and_identity/index.js +20456 -0
  140. package/dist/tools/generated/tenant_and_identity/index.js.map +1 -0
  141. package/dist/tools/generated/threat_campaign/index.d.ts +8 -0
  142. package/dist/tools/generated/threat_campaign/index.d.ts.map +1 -0
  143. package/dist/tools/generated/threat_campaign/index.js +112 -0
  144. package/dist/tools/generated/threat_campaign/index.js.map +1 -0
  145. package/dist/tools/generated/users/index.d.ts +8 -0
  146. package/dist/tools/generated/users/index.d.ts.map +1 -0
  147. package/dist/tools/generated/users/index.js +1572 -0
  148. package/dist/tools/generated/users/index.js.map +1 -0
  149. package/dist/tools/generated/virtual/index.d.ts +8 -0
  150. package/dist/tools/generated/virtual/index.d.ts.map +1 -0
  151. package/dist/tools/generated/virtual/index.js +11540 -0
  152. package/dist/tools/generated/virtual/index.js.map +1 -0
  153. package/dist/tools/generated/vpm_and_node_management/index.d.ts +8 -0
  154. package/dist/tools/generated/vpm_and_node_management/index.d.ts.map +1 -0
  155. package/dist/tools/generated/vpm_and_node_management/index.js +98 -0
  156. package/dist/tools/generated/vpm_and_node_management/index.js.map +1 -0
  157. package/dist/tools/generated/waf/index.d.ts +8 -0
  158. package/dist/tools/generated/waf/index.d.ts.map +1 -0
  159. package/dist/tools/generated/waf/index.js +4440 -0
  160. package/dist/tools/generated/waf/index.js.map +1 -0
  161. package/dist/tools/registry.d.ts.map +1 -1
  162. package/dist/tools/registry.js +68 -36
  163. package/dist/tools/registry.js.map +1 -1
  164. package/package.json +3 -1
  165. package/dist/tools/generated/ai_intelligence/index.d.ts +0 -8
  166. package/dist/tools/generated/ai_intelligence/index.d.ts.map +0 -1
  167. package/dist/tools/generated/ai_intelligence/index.js +0 -282
  168. package/dist/tools/generated/ai_intelligence/index.js.map +0 -1
  169. package/dist/tools/generated/api_security/index.d.ts +0 -8
  170. package/dist/tools/generated/api_security/index.d.ts.map +0 -1
  171. package/dist/tools/generated/api_security/index.js +0 -1852
  172. package/dist/tools/generated/api_security/index.js.map +0 -1
  173. package/dist/tools/generated/applications/index.d.ts +0 -8
  174. package/dist/tools/generated/applications/index.d.ts.map +0 -1
  175. package/dist/tools/generated/applications/index.js +0 -1589
  176. package/dist/tools/generated/applications/index.js.map +0 -1
  177. package/dist/tools/generated/billing/index.d.ts +0 -8
  178. package/dist/tools/generated/billing/index.d.ts.map +0 -1
  179. package/dist/tools/generated/billing/index.js +0 -759
  180. package/dist/tools/generated/billing/index.js.map +0 -1
  181. package/dist/tools/generated/config/index.d.ts +0 -8
  182. package/dist/tools/generated/config/index.d.ts.map +0 -1
  183. package/dist/tools/generated/config/index.js +0 -316
  184. package/dist/tools/generated/config/index.js.map +0 -1
  185. package/dist/tools/generated/identity/index.d.ts +0 -8
  186. package/dist/tools/generated/identity/index.d.ts.map +0 -1
  187. package/dist/tools/generated/identity/index.js +0 -5371
  188. package/dist/tools/generated/identity/index.js.map +0 -1
  189. package/dist/tools/generated/infrastructure/index.d.ts +0 -8
  190. package/dist/tools/generated/infrastructure/index.d.ts.map +0 -1
  191. package/dist/tools/generated/infrastructure/index.js +0 -5342
  192. package/dist/tools/generated/infrastructure/index.js.map +0 -1
  193. package/dist/tools/generated/infrastructure_protection/index.d.ts +0 -8
  194. package/dist/tools/generated/infrastructure_protection/index.d.ts.map +0 -1
  195. package/dist/tools/generated/infrastructure_protection/index.js +0 -2919
  196. package/dist/tools/generated/infrastructure_protection/index.js.map +0 -1
  197. package/dist/tools/generated/integrations/index.d.ts +0 -8
  198. package/dist/tools/generated/integrations/index.d.ts.map +0 -1
  199. package/dist/tools/generated/integrations/index.js +0 -1995
  200. package/dist/tools/generated/integrations/index.js.map +0 -1
  201. package/dist/tools/generated/load_balancer/index.d.ts +0 -8
  202. package/dist/tools/generated/load_balancer/index.d.ts.map +0 -1
  203. package/dist/tools/generated/load_balancer/index.js +0 -2269
  204. package/dist/tools/generated/load_balancer/index.js.map +0 -1
  205. package/dist/tools/generated/networking/index.d.ts +0 -8
  206. package/dist/tools/generated/networking/index.d.ts.map +0 -1
  207. package/dist/tools/generated/networking/index.js +0 -11289
  208. package/dist/tools/generated/networking/index.js.map +0 -1
  209. package/dist/tools/generated/nginx/index.d.ts +0 -8
  210. package/dist/tools/generated/nginx/index.d.ts.map +0 -1
  211. package/dist/tools/generated/nginx/index.js +0 -680
  212. package/dist/tools/generated/nginx/index.js.map +0 -1
  213. package/dist/tools/generated/operations/index.d.ts +0 -8
  214. package/dist/tools/generated/operations/index.d.ts.map +0 -1
  215. package/dist/tools/generated/operations/index.js +0 -1759
  216. package/dist/tools/generated/operations/index.js.map +0 -1
  217. package/dist/tools/generated/security/index.d.ts +0 -8
  218. package/dist/tools/generated/security/index.d.ts.map +0 -1
  219. package/dist/tools/generated/security/index.js +0 -9111
  220. package/dist/tools/generated/security/index.js.map +0 -1
  221. package/dist/tools/generated/shape_security/index.d.ts +0 -8
  222. package/dist/tools/generated/shape_security/index.d.ts.map +0 -1
  223. package/dist/tools/generated/shape_security/index.js +0 -4121
  224. package/dist/tools/generated/shape_security/index.js.map +0 -1
  225. package/dist/tools/generated/subscriptions/index.d.ts +0 -8
  226. package/dist/tools/generated/subscriptions/index.d.ts.map +0 -1
  227. package/dist/tools/generated/subscriptions/index.js +0 -778
  228. package/dist/tools/generated/subscriptions/index.js.map +0 -1
  229. package/dist/tools/generated/tenant_management/index.d.ts +0 -8
  230. package/dist/tools/generated/tenant_management/index.d.ts.map +0 -1
  231. package/dist/tools/generated/tenant_management/index.js +0 -2292
  232. package/dist/tools/generated/tenant_management/index.js.map +0 -1
  233. package/dist/tools/generated/vpn/index.d.ts +0 -8
  234. package/dist/tools/generated/vpn/index.js +0 -1183
  235. package/dist/tools/generated/vpn/index.js.map +0 -1
@@ -0,0 +1,2579 @@
1
+ /**
2
+ * Generated tool definitions for certificates domain
3
+ * DO NOT EDIT - This file is auto-generated by scripts/generate.ts
4
+ */
5
+ export const certificatesTools = [
6
+ {
7
+ toolName: "f5xc-api-certificates-certificate-chain-create",
8
+ method: "POST",
9
+ path: "/api/config/namespaces/{metadata.namespace}/certificate_chains",
10
+ operation: "create",
11
+ domain: "certificates",
12
+ resource: "certificate-chain",
13
+ summary: "Create Certificate Chain.",
14
+ description: "Shape of the Certificate Chain specification.",
15
+ pathParameters: [
16
+ {
17
+ 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 ""',
18
+ in: "path",
19
+ name: "metadata.namespace",
20
+ required: true,
21
+ schema: {
22
+ type: "string",
23
+ },
24
+ "x-displayname": "Namespace",
25
+ "x-ves-example": "Staging",
26
+ },
27
+ ],
28
+ queryParameters: [],
29
+ requestBodySchema: {
30
+ $ref: "#/components/schemas/certificate_chainCreateRequest",
31
+ },
32
+ responseSchema: {
33
+ $ref: "#/components/schemas/certificate_chainCreateResponse",
34
+ },
35
+ requiredParams: ["body", "metadata.namespace"],
36
+ operationId: "ves.io.schema.certificate_chain.API.Create",
37
+ tags: ["Other"],
38
+ sourceFile: "domains/certificates.json",
39
+ displayName: null,
40
+ dangerLevel: "medium",
41
+ sideEffects: {
42
+ creates: ["certificate-chain"],
43
+ },
44
+ requiredFields: ["metadata.name", "metadata.namespace", "path.metadata.namespace"],
45
+ cliExamples: [
46
+ {
47
+ command: "f5xcctl config certificate-chain create {name} --namespace {namespace}",
48
+ description: "Create certificate-chain",
49
+ use_case: "basic_create",
50
+ },
51
+ {
52
+ command: "f5xcctl config certificate-chain create -f {file}.yaml",
53
+ description: "Create from YAML file",
54
+ use_case: "file_based",
55
+ },
56
+ ],
57
+ confirmationRequired: false,
58
+ parameterExamples: {
59
+ "metadata.namespace": "Staging",
60
+ },
61
+ validationRules: {},
62
+ operationMetadata: {
63
+ common_errors: [
64
+ {
65
+ code: 401,
66
+ message: "Authentication required",
67
+ solution: "Provide valid API credentials",
68
+ },
69
+ {
70
+ code: 403,
71
+ message: "Permission denied",
72
+ solution: "Check access permissions for this operation",
73
+ },
74
+ {
75
+ code: 404,
76
+ message: "Resource not found",
77
+ solution: "Verify resource name, namespace, and path",
78
+ },
79
+ {
80
+ code: 409,
81
+ message: "Resource already exists",
82
+ solution: "Use different name or update existing resource",
83
+ },
84
+ {
85
+ code: 429,
86
+ message: "Rate limit exceeded",
87
+ solution: "Wait before retrying the operation",
88
+ },
89
+ {
90
+ code: 500,
91
+ message: "Server error",
92
+ solution: "Retry operation or contact support",
93
+ },
94
+ ],
95
+ conditions: {
96
+ postconditions: [
97
+ "Certificate-chain resource created",
98
+ "Resource assigned unique identifier",
99
+ ],
100
+ prerequisites: ["Active namespace", "Certificate file or data"],
101
+ },
102
+ confirmation_required: false,
103
+ danger_level: "medium",
104
+ examples: [
105
+ {
106
+ command: "f5xcctl config certificate-chain create {name} --namespace {namespace}",
107
+ description: "Create certificate-chain",
108
+ use_case: "basic_create",
109
+ },
110
+ {
111
+ command: "f5xcctl config certificate-chain create -f {file}.yaml",
112
+ description: "Create from YAML file",
113
+ use_case: "file_based",
114
+ },
115
+ ],
116
+ field_docs: {},
117
+ optional_fields: [],
118
+ performance_impact: {
119
+ latency: "low",
120
+ resource_usage: "low",
121
+ },
122
+ purpose: "Create new certificate-chain",
123
+ required_fields: ["metadata.name", "metadata.namespace", "path.metadata.namespace"],
124
+ side_effects: {
125
+ creates: ["certificate-chain"],
126
+ },
127
+ },
128
+ },
129
+ {
130
+ toolName: "f5xc-api-certificates-certificate-chain-delete",
131
+ method: "DELETE",
132
+ path: "/api/config/namespaces/{namespace}/certificate_chains/{name}",
133
+ operation: "delete",
134
+ domain: "certificates",
135
+ resource: "certificate-chain",
136
+ summary: "DELETE Certificate Chain.",
137
+ description: "DELETE the specified certificate_chain.",
138
+ pathParameters: [
139
+ {
140
+ description: "Name\nName of the configuration object.",
141
+ in: "path",
142
+ name: "name",
143
+ required: true,
144
+ schema: {
145
+ type: "string",
146
+ },
147
+ "x-displayname": "Name",
148
+ "x-ves-example": "Name",
149
+ },
150
+ {
151
+ description: "Namespace\nNamespace in which the configuration object is present.",
152
+ in: "path",
153
+ name: "namespace",
154
+ required: true,
155
+ schema: {
156
+ type: "string",
157
+ },
158
+ "x-displayname": "Namespace",
159
+ "x-ves-example": "Ns1",
160
+ },
161
+ ],
162
+ queryParameters: [],
163
+ requestBodySchema: {
164
+ $ref: "#/components/schemas/certificate_chainDeleteRequest",
165
+ },
166
+ responseSchema: {},
167
+ requiredParams: ["body", "name", "namespace"],
168
+ operationId: "ves.io.schema.certificate_chain.API.Delete",
169
+ tags: ["Other"],
170
+ sourceFile: "domains/certificates.json",
171
+ displayName: null,
172
+ dangerLevel: "high",
173
+ sideEffects: {
174
+ deletes: ["certificate-chain", "contained_resources"],
175
+ },
176
+ requiredFields: ["path.name", "path.namespace"],
177
+ cliExamples: [
178
+ {
179
+ command: "f5xcctl config certificate-chain delete {name} --namespace {namespace}",
180
+ description: "Delete certificate-chain",
181
+ use_case: "delete",
182
+ },
183
+ ],
184
+ confirmationRequired: true,
185
+ parameterExamples: {
186
+ name: "Name",
187
+ namespace: "Ns1",
188
+ },
189
+ validationRules: {},
190
+ operationMetadata: {
191
+ common_errors: [
192
+ {
193
+ code: 401,
194
+ message: "Authentication required",
195
+ solution: "Provide valid API credentials",
196
+ },
197
+ {
198
+ code: 403,
199
+ message: "Permission denied",
200
+ solution: "Check access permissions for this operation",
201
+ },
202
+ {
203
+ code: 404,
204
+ message: "Resource not found",
205
+ solution: "Verify resource name, namespace, and path",
206
+ },
207
+ {
208
+ code: 409,
209
+ message: "Resource already exists",
210
+ solution: "Use different name or update existing resource",
211
+ },
212
+ {
213
+ code: 429,
214
+ message: "Rate limit exceeded",
215
+ solution: "Wait before retrying the operation",
216
+ },
217
+ {
218
+ code: 500,
219
+ message: "Server error",
220
+ solution: "Retry operation or contact support",
221
+ },
222
+ ],
223
+ conditions: {
224
+ postconditions: ["Resource removed from system", "Associated resources may be affected"],
225
+ prerequisites: ["Active namespace", "Certificate file or data"],
226
+ },
227
+ confirmation_required: true,
228
+ danger_level: "high",
229
+ examples: [
230
+ {
231
+ command: "f5xcctl config certificate-chain delete {name} --namespace {namespace}",
232
+ description: "Delete certificate-chain",
233
+ use_case: "delete",
234
+ },
235
+ ],
236
+ field_docs: {},
237
+ optional_fields: [],
238
+ performance_impact: {
239
+ latency: "high",
240
+ resource_usage: "moderate",
241
+ },
242
+ purpose: "Delete certificate-chain",
243
+ required_fields: ["path.name", "path.namespace"],
244
+ side_effects: {
245
+ deletes: ["certificate-chain", "contained_resources"],
246
+ },
247
+ },
248
+ },
249
+ {
250
+ toolName: "f5xc-api-certificates-certificate-chain-get",
251
+ method: "GET",
252
+ path: "/api/config/namespaces/{namespace}/certificate_chains/{name}",
253
+ operation: "get",
254
+ domain: "certificates",
255
+ resource: "certificate-chain",
256
+ summary: "GET Certificate Chain.",
257
+ description: "Shape of the Certificate Chain specification.",
258
+ pathParameters: [
259
+ {
260
+ description: "Name\nThe name of the configuration object to be fetched.",
261
+ in: "path",
262
+ name: "name",
263
+ required: true,
264
+ schema: {
265
+ type: "string",
266
+ },
267
+ "x-displayname": "Name",
268
+ "x-ves-example": "Name",
269
+ },
270
+ {
271
+ description: "Namespace\nThe namespace in which the configuration object is present.",
272
+ in: "path",
273
+ name: "namespace",
274
+ required: true,
275
+ schema: {
276
+ type: "string",
277
+ },
278
+ "x-displayname": "Namespace",
279
+ "x-ves-example": "Ns1",
280
+ },
281
+ ],
282
+ queryParameters: [
283
+ {
284
+ 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.",
285
+ in: "query",
286
+ name: "response_format",
287
+ required: false,
288
+ schema: {
289
+ default: "GET_RSP_FORMAT_DEFAULT",
290
+ enum: [
291
+ "GET_RSP_FORMAT_DEFAULT",
292
+ "GET_RSP_FORMAT_FOR_CREATE",
293
+ "GET_RSP_FORMAT_FOR_REPLACE",
294
+ "GET_RSP_FORMAT_STATUS",
295
+ "GET_RSP_FORMAT_READ",
296
+ "GET_RSP_FORMAT_REFERRING_OBJECTS",
297
+ "GET_RSP_FORMAT_BROKEN_REFERENCES",
298
+ ],
299
+ type: "string",
300
+ },
301
+ "x-displayname": "Broken Referred Objects.",
302
+ },
303
+ ],
304
+ requestBodySchema: null,
305
+ responseSchema: {
306
+ $ref: "#/components/schemas/certificate_chainGetResponse",
307
+ },
308
+ requiredParams: ["name", "namespace"],
309
+ operationId: "ves.io.schema.certificate_chain.API.Get",
310
+ tags: ["Other"],
311
+ sourceFile: "domains/certificates.json",
312
+ displayName: null,
313
+ dangerLevel: "low",
314
+ sideEffects: null,
315
+ requiredFields: ["path.name", "path.namespace"],
316
+ cliExamples: [
317
+ {
318
+ command: "f5xcctl config certificate-chain get {name} --namespace {namespace}",
319
+ description: "Get specific certificate-chain",
320
+ use_case: "get_specific",
321
+ },
322
+ ],
323
+ confirmationRequired: false,
324
+ parameterExamples: {
325
+ name: "Name",
326
+ namespace: "Ns1",
327
+ },
328
+ validationRules: {},
329
+ operationMetadata: {
330
+ common_errors: [
331
+ {
332
+ code: 401,
333
+ message: "Authentication required",
334
+ solution: "Provide valid API credentials",
335
+ },
336
+ {
337
+ code: 403,
338
+ message: "Permission denied",
339
+ solution: "Check access permissions for this operation",
340
+ },
341
+ {
342
+ code: 404,
343
+ message: "Resource not found",
344
+ solution: "Verify resource name, namespace, and path",
345
+ },
346
+ {
347
+ code: 409,
348
+ message: "Resource already exists",
349
+ solution: "Use different name or update existing resource",
350
+ },
351
+ {
352
+ code: 429,
353
+ message: "Rate limit exceeded",
354
+ solution: "Wait before retrying the operation",
355
+ },
356
+ {
357
+ code: 500,
358
+ message: "Server error",
359
+ solution: "Retry operation or contact support",
360
+ },
361
+ ],
362
+ conditions: {
363
+ postconditions: [],
364
+ prerequisites: ["Active namespace", "Certificate file or data"],
365
+ },
366
+ confirmation_required: false,
367
+ danger_level: "low",
368
+ examples: [
369
+ {
370
+ command: "f5xcctl config certificate-chain get {name} --namespace {namespace}",
371
+ description: "Get specific certificate-chain",
372
+ use_case: "get_specific",
373
+ },
374
+ ],
375
+ field_docs: {},
376
+ optional_fields: [],
377
+ performance_impact: {
378
+ latency: "low",
379
+ resource_usage: "low",
380
+ },
381
+ purpose: "Retrieve specific certificate-chain",
382
+ required_fields: ["path.name", "path.namespace"],
383
+ side_effects: {},
384
+ },
385
+ },
386
+ {
387
+ toolName: "f5xc-api-certificates-certificate-chain-list",
388
+ method: "GET",
389
+ path: "/api/config/namespaces/{namespace}/certificate_chains",
390
+ operation: "list",
391
+ domain: "certificates",
392
+ resource: "certificate-chain",
393
+ summary: "List Certificate Chain.",
394
+ description: "List the set of certificate_chain in a namespace.",
395
+ pathParameters: [
396
+ {
397
+ description: "Namespace\nNamespace to scope the listing of certificate_chain.",
398
+ in: "path",
399
+ name: "namespace",
400
+ required: true,
401
+ schema: {
402
+ type: "string",
403
+ },
404
+ "x-displayname": "Namespace",
405
+ "x-ves-example": "Ns1",
406
+ },
407
+ ],
408
+ queryParameters: [
409
+ {
410
+ description: "A LabelSelectorType expression that every item in list response will satisfy.",
411
+ in: "query",
412
+ name: "label_filter",
413
+ required: false,
414
+ schema: {
415
+ type: "string",
416
+ },
417
+ "x-displayname": "Label Filter.",
418
+ "x-ves-example": "Env in (staging, testing), tier in (web, db)",
419
+ },
420
+ {
421
+ description: 'X-example: ""\nExtra fields to return along with summary fields.',
422
+ in: "query",
423
+ name: "report_fields",
424
+ required: false,
425
+ schema: {
426
+ items: {
427
+ type: "string",
428
+ },
429
+ type: "array",
430
+ },
431
+ "x-displayname": "Report Fields.",
432
+ },
433
+ {
434
+ description: 'X-example: ""\nExtra status fields to return along with summary fields.',
435
+ in: "query",
436
+ name: "report_status_fields",
437
+ required: false,
438
+ schema: {
439
+ items: {
440
+ type: "string",
441
+ },
442
+ type: "array",
443
+ },
444
+ "x-displayname": "Report Status Fields.",
445
+ },
446
+ ],
447
+ requestBodySchema: null,
448
+ responseSchema: {
449
+ $ref: "#/components/schemas/certificate_chainListResponse",
450
+ },
451
+ requiredParams: ["namespace"],
452
+ operationId: "ves.io.schema.certificate_chain.API.List",
453
+ tags: ["Other"],
454
+ sourceFile: "domains/certificates.json",
455
+ displayName: null,
456
+ dangerLevel: "low",
457
+ sideEffects: null,
458
+ requiredFields: ["path.namespace"],
459
+ cliExamples: [
460
+ {
461
+ command: "f5xcctl config certificate-chain list --namespace {namespace}",
462
+ description: "List all certificate-chains",
463
+ use_case: "list_all",
464
+ },
465
+ ],
466
+ confirmationRequired: false,
467
+ parameterExamples: {
468
+ label_filter: "Env in (staging, testing), tier in (web, db)",
469
+ namespace: "Ns1",
470
+ },
471
+ validationRules: {},
472
+ operationMetadata: {
473
+ common_errors: [
474
+ {
475
+ code: 401,
476
+ message: "Authentication required",
477
+ solution: "Provide valid API credentials",
478
+ },
479
+ {
480
+ code: 403,
481
+ message: "Permission denied",
482
+ solution: "Check access permissions for this operation",
483
+ },
484
+ {
485
+ code: 404,
486
+ message: "Resource not found",
487
+ solution: "Verify resource name, namespace, and path",
488
+ },
489
+ {
490
+ code: 409,
491
+ message: "Resource already exists",
492
+ solution: "Use different name or update existing resource",
493
+ },
494
+ {
495
+ code: 429,
496
+ message: "Rate limit exceeded",
497
+ solution: "Wait before retrying the operation",
498
+ },
499
+ {
500
+ code: 500,
501
+ message: "Server error",
502
+ solution: "Retry operation or contact support",
503
+ },
504
+ ],
505
+ conditions: {
506
+ postconditions: [],
507
+ prerequisites: ["Active namespace", "Certificate file or data"],
508
+ },
509
+ confirmation_required: false,
510
+ danger_level: "low",
511
+ examples: [
512
+ {
513
+ command: "f5xcctl config certificate-chain list --namespace {namespace}",
514
+ description: "List all certificate-chains",
515
+ use_case: "list_all",
516
+ },
517
+ ],
518
+ field_docs: {},
519
+ optional_fields: [],
520
+ performance_impact: {
521
+ latency: "moderate",
522
+ resource_usage: "moderate",
523
+ },
524
+ purpose: "List all certificate-chains",
525
+ required_fields: ["path.namespace"],
526
+ side_effects: {},
527
+ },
528
+ },
529
+ {
530
+ toolName: "f5xc-api-certificates-certificate-chain-update",
531
+ method: "PUT",
532
+ path: "/api/config/namespaces/{metadata.namespace}/certificate_chains/{metadata.name}",
533
+ operation: "update",
534
+ domain: "certificates",
535
+ resource: "certificate-chain",
536
+ summary: "Replace Certificate Chain.",
537
+ description: "Shape of the Certificate Chain specification.",
538
+ pathParameters: [
539
+ {
540
+ description: "Name\nThe configuration object to be replaced will be looked up by name.",
541
+ in: "path",
542
+ name: "metadata.name",
543
+ required: true,
544
+ schema: {
545
+ type: "string",
546
+ },
547
+ "x-displayname": "Name",
548
+ "x-ves-example": "Example-corp-web.",
549
+ },
550
+ {
551
+ 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 ""',
552
+ in: "path",
553
+ name: "metadata.namespace",
554
+ required: true,
555
+ schema: {
556
+ type: "string",
557
+ },
558
+ "x-displayname": "Namespace",
559
+ "x-ves-example": "Staging",
560
+ },
561
+ ],
562
+ queryParameters: [],
563
+ requestBodySchema: {
564
+ $ref: "#/components/schemas/certificate_chainReplaceRequest",
565
+ },
566
+ responseSchema: {
567
+ $ref: "#/components/schemas/certificate_chainReplaceResponse",
568
+ },
569
+ requiredParams: ["body", "metadata.name", "metadata.namespace"],
570
+ operationId: "ves.io.schema.certificate_chain.API.Replace",
571
+ tags: ["Other"],
572
+ sourceFile: "domains/certificates.json",
573
+ displayName: null,
574
+ dangerLevel: "medium",
575
+ sideEffects: {
576
+ modifies: ["certificate-chain"],
577
+ },
578
+ requiredFields: ["path.metadata.name", "path.metadata.namespace"],
579
+ cliExamples: [
580
+ {
581
+ command: "f5xcctl config certificate-chain update {name} --namespace {namespace} -f {file}.yaml",
582
+ description: "Update certificate-chain",
583
+ use_case: "update",
584
+ },
585
+ ],
586
+ confirmationRequired: false,
587
+ parameterExamples: {
588
+ "metadata.name": "Example-corp-web.",
589
+ "metadata.namespace": "Staging",
590
+ },
591
+ validationRules: {},
592
+ operationMetadata: {
593
+ common_errors: [
594
+ {
595
+ code: 401,
596
+ message: "Authentication required",
597
+ solution: "Provide valid API credentials",
598
+ },
599
+ {
600
+ code: 403,
601
+ message: "Permission denied",
602
+ solution: "Check access permissions for this operation",
603
+ },
604
+ {
605
+ code: 404,
606
+ message: "Resource not found",
607
+ solution: "Verify resource name, namespace, and path",
608
+ },
609
+ {
610
+ code: 409,
611
+ message: "Resource already exists",
612
+ solution: "Use different name or update existing resource",
613
+ },
614
+ {
615
+ code: 429,
616
+ message: "Rate limit exceeded",
617
+ solution: "Wait before retrying the operation",
618
+ },
619
+ {
620
+ code: 500,
621
+ message: "Server error",
622
+ solution: "Retry operation or contact support",
623
+ },
624
+ ],
625
+ conditions: {
626
+ postconditions: ["Resource updated with new values"],
627
+ prerequisites: ["Active namespace", "Certificate file or data"],
628
+ },
629
+ confirmation_required: false,
630
+ danger_level: "medium",
631
+ examples: [
632
+ {
633
+ command: "f5xcctl config certificate-chain update {name} --namespace {namespace} -f {file}.yaml",
634
+ description: "Update certificate-chain",
635
+ use_case: "update",
636
+ },
637
+ ],
638
+ field_docs: {},
639
+ optional_fields: [],
640
+ performance_impact: {
641
+ latency: "low",
642
+ resource_usage: "low",
643
+ },
644
+ purpose: "Replace existing certificate-chain",
645
+ required_fields: ["path.metadata.name", "path.metadata.namespace"],
646
+ side_effects: {
647
+ modifies: ["certificate-chain"],
648
+ },
649
+ },
650
+ },
651
+ {
652
+ toolName: "f5xc-api-certificates-certificate-create",
653
+ method: "POST",
654
+ path: "/api/config/namespaces/{metadata.namespace}/certificates",
655
+ operation: "create",
656
+ domain: "certificates",
657
+ resource: "certificate",
658
+ summary: "Create Certificate.",
659
+ description: "Shape of the Certificate specification.",
660
+ pathParameters: [
661
+ {
662
+ 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 ""',
663
+ in: "path",
664
+ name: "metadata.namespace",
665
+ required: true,
666
+ schema: {
667
+ type: "string",
668
+ },
669
+ "x-displayname": "Namespace",
670
+ "x-ves-example": "Staging",
671
+ },
672
+ ],
673
+ queryParameters: [],
674
+ requestBodySchema: {
675
+ $ref: "#/components/schemas/certificateCreateRequest",
676
+ },
677
+ responseSchema: {
678
+ $ref: "#/components/schemas/certificateCreateResponse",
679
+ },
680
+ requiredParams: ["body", "metadata.namespace"],
681
+ operationId: "ves.io.schema.certificate.API.Create",
682
+ tags: ["Other"],
683
+ sourceFile: "domains/certificates.json",
684
+ displayName: null,
685
+ dangerLevel: "medium",
686
+ sideEffects: {
687
+ creates: ["certificate"],
688
+ },
689
+ requiredFields: ["metadata.name", "metadata.namespace", "path.metadata.namespace"],
690
+ cliExamples: [
691
+ {
692
+ command: "f5xcctl config certificate create {name} --namespace {namespace}",
693
+ description: "Create certificate",
694
+ use_case: "basic_create",
695
+ },
696
+ {
697
+ command: "f5xcctl config certificate create -f {file}.yaml",
698
+ description: "Create from YAML file",
699
+ use_case: "file_based",
700
+ },
701
+ ],
702
+ confirmationRequired: false,
703
+ parameterExamples: {
704
+ "metadata.namespace": "Staging",
705
+ },
706
+ validationRules: {},
707
+ operationMetadata: {
708
+ common_errors: [
709
+ {
710
+ code: 401,
711
+ message: "Authentication required",
712
+ solution: "Provide valid API credentials",
713
+ },
714
+ {
715
+ code: 403,
716
+ message: "Permission denied",
717
+ solution: "Check access permissions for this operation",
718
+ },
719
+ {
720
+ code: 404,
721
+ message: "Resource not found",
722
+ solution: "Verify resource name, namespace, and path",
723
+ },
724
+ {
725
+ code: 409,
726
+ message: "Resource already exists",
727
+ solution: "Use different name or update existing resource",
728
+ },
729
+ {
730
+ code: 429,
731
+ message: "Rate limit exceeded",
732
+ solution: "Wait before retrying the operation",
733
+ },
734
+ {
735
+ code: 500,
736
+ message: "Server error",
737
+ solution: "Retry operation or contact support",
738
+ },
739
+ ],
740
+ conditions: {
741
+ postconditions: ["Certificate resource created", "Resource assigned unique identifier"],
742
+ prerequisites: ["Active namespace", "Certificate file or data"],
743
+ },
744
+ confirmation_required: false,
745
+ danger_level: "medium",
746
+ examples: [
747
+ {
748
+ command: "f5xcctl config certificate create {name} --namespace {namespace}",
749
+ description: "Create certificate",
750
+ use_case: "basic_create",
751
+ },
752
+ {
753
+ command: "f5xcctl config certificate create -f {file}.yaml",
754
+ description: "Create from YAML file",
755
+ use_case: "file_based",
756
+ },
757
+ ],
758
+ field_docs: {},
759
+ optional_fields: [],
760
+ performance_impact: {
761
+ latency: "low",
762
+ resource_usage: "low",
763
+ },
764
+ purpose: "Create new certificate",
765
+ required_fields: ["metadata.name", "metadata.namespace", "path.metadata.namespace"],
766
+ side_effects: {
767
+ creates: ["certificate"],
768
+ },
769
+ },
770
+ },
771
+ {
772
+ toolName: "f5xc-api-certificates-certificate-delete",
773
+ method: "DELETE",
774
+ path: "/api/config/namespaces/{namespace}/certificates/{name}",
775
+ operation: "delete",
776
+ domain: "certificates",
777
+ resource: "certificate",
778
+ summary: "DELETE Certificate.",
779
+ description: "DELETE the specified certificate.",
780
+ pathParameters: [
781
+ {
782
+ description: "Name\nName of the configuration object.",
783
+ in: "path",
784
+ name: "name",
785
+ required: true,
786
+ schema: {
787
+ type: "string",
788
+ },
789
+ "x-displayname": "Name",
790
+ "x-ves-example": "Name",
791
+ },
792
+ {
793
+ description: "Namespace\nNamespace in which the configuration object is present.",
794
+ in: "path",
795
+ name: "namespace",
796
+ required: true,
797
+ schema: {
798
+ type: "string",
799
+ },
800
+ "x-displayname": "Namespace",
801
+ "x-ves-example": "Ns1",
802
+ },
803
+ ],
804
+ queryParameters: [],
805
+ requestBodySchema: {
806
+ $ref: "#/components/schemas/certificateDeleteRequest",
807
+ },
808
+ responseSchema: {},
809
+ requiredParams: ["body", "name", "namespace"],
810
+ operationId: "ves.io.schema.certificate.API.Delete",
811
+ tags: ["Other"],
812
+ sourceFile: "domains/certificates.json",
813
+ displayName: null,
814
+ dangerLevel: "high",
815
+ sideEffects: {
816
+ deletes: ["certificate", "contained_resources"],
817
+ },
818
+ requiredFields: ["path.name", "path.namespace"],
819
+ cliExamples: [
820
+ {
821
+ command: "f5xcctl config certificate delete {name} --namespace {namespace}",
822
+ description: "Delete certificate",
823
+ use_case: "delete",
824
+ },
825
+ ],
826
+ confirmationRequired: true,
827
+ parameterExamples: {
828
+ name: "Name",
829
+ namespace: "Ns1",
830
+ },
831
+ validationRules: {},
832
+ operationMetadata: {
833
+ common_errors: [
834
+ {
835
+ code: 401,
836
+ message: "Authentication required",
837
+ solution: "Provide valid API credentials",
838
+ },
839
+ {
840
+ code: 403,
841
+ message: "Permission denied",
842
+ solution: "Check access permissions for this operation",
843
+ },
844
+ {
845
+ code: 404,
846
+ message: "Resource not found",
847
+ solution: "Verify resource name, namespace, and path",
848
+ },
849
+ {
850
+ code: 409,
851
+ message: "Resource already exists",
852
+ solution: "Use different name or update existing resource",
853
+ },
854
+ {
855
+ code: 429,
856
+ message: "Rate limit exceeded",
857
+ solution: "Wait before retrying the operation",
858
+ },
859
+ {
860
+ code: 500,
861
+ message: "Server error",
862
+ solution: "Retry operation or contact support",
863
+ },
864
+ ],
865
+ conditions: {
866
+ postconditions: ["Resource removed from system", "Associated resources may be affected"],
867
+ prerequisites: ["Active namespace", "Certificate file or data"],
868
+ },
869
+ confirmation_required: true,
870
+ danger_level: "high",
871
+ examples: [
872
+ {
873
+ command: "f5xcctl config certificate delete {name} --namespace {namespace}",
874
+ description: "Delete certificate",
875
+ use_case: "delete",
876
+ },
877
+ ],
878
+ field_docs: {},
879
+ optional_fields: [],
880
+ performance_impact: {
881
+ latency: "high",
882
+ resource_usage: "moderate",
883
+ },
884
+ purpose: "Delete certificate",
885
+ required_fields: ["path.name", "path.namespace"],
886
+ side_effects: {
887
+ deletes: ["certificate", "contained_resources"],
888
+ },
889
+ },
890
+ },
891
+ {
892
+ toolName: "f5xc-api-certificates-certificate-get",
893
+ method: "GET",
894
+ path: "/api/config/namespaces/{namespace}/certificates/{name}",
895
+ operation: "get",
896
+ domain: "certificates",
897
+ resource: "certificate",
898
+ summary: "GET Certificate.",
899
+ description: "Shape of the Certificate specification.",
900
+ pathParameters: [
901
+ {
902
+ description: "Name\nThe name of the configuration object to be fetched.",
903
+ in: "path",
904
+ name: "name",
905
+ required: true,
906
+ schema: {
907
+ type: "string",
908
+ },
909
+ "x-displayname": "Name",
910
+ "x-ves-example": "Name",
911
+ },
912
+ {
913
+ description: "Namespace\nThe namespace in which the configuration object is present.",
914
+ in: "path",
915
+ name: "namespace",
916
+ required: true,
917
+ schema: {
918
+ type: "string",
919
+ },
920
+ "x-displayname": "Namespace",
921
+ "x-ves-example": "Ns1",
922
+ },
923
+ ],
924
+ queryParameters: [
925
+ {
926
+ 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.",
927
+ in: "query",
928
+ name: "response_format",
929
+ required: false,
930
+ schema: {
931
+ default: "GET_RSP_FORMAT_DEFAULT",
932
+ enum: [
933
+ "GET_RSP_FORMAT_DEFAULT",
934
+ "GET_RSP_FORMAT_FOR_CREATE",
935
+ "GET_RSP_FORMAT_FOR_REPLACE",
936
+ "GET_RSP_FORMAT_STATUS",
937
+ "GET_RSP_FORMAT_READ",
938
+ "GET_RSP_FORMAT_REFERRING_OBJECTS",
939
+ "GET_RSP_FORMAT_BROKEN_REFERENCES",
940
+ ],
941
+ type: "string",
942
+ },
943
+ "x-displayname": "Broken Referred Objects.",
944
+ },
945
+ ],
946
+ requestBodySchema: null,
947
+ responseSchema: {
948
+ $ref: "#/components/schemas/certificateGetResponse",
949
+ },
950
+ requiredParams: ["name", "namespace"],
951
+ operationId: "ves.io.schema.certificate.API.Get",
952
+ tags: ["Other"],
953
+ sourceFile: "domains/certificates.json",
954
+ displayName: null,
955
+ dangerLevel: "low",
956
+ sideEffects: null,
957
+ requiredFields: ["path.name", "path.namespace"],
958
+ cliExamples: [
959
+ {
960
+ command: "f5xcctl config certificate get {name} --namespace {namespace}",
961
+ description: "Get specific certificate",
962
+ use_case: "get_specific",
963
+ },
964
+ ],
965
+ confirmationRequired: false,
966
+ parameterExamples: {
967
+ name: "Name",
968
+ namespace: "Ns1",
969
+ },
970
+ validationRules: {},
971
+ operationMetadata: {
972
+ common_errors: [
973
+ {
974
+ code: 401,
975
+ message: "Authentication required",
976
+ solution: "Provide valid API credentials",
977
+ },
978
+ {
979
+ code: 403,
980
+ message: "Permission denied",
981
+ solution: "Check access permissions for this operation",
982
+ },
983
+ {
984
+ code: 404,
985
+ message: "Resource not found",
986
+ solution: "Verify resource name, namespace, and path",
987
+ },
988
+ {
989
+ code: 409,
990
+ message: "Resource already exists",
991
+ solution: "Use different name or update existing resource",
992
+ },
993
+ {
994
+ code: 429,
995
+ message: "Rate limit exceeded",
996
+ solution: "Wait before retrying the operation",
997
+ },
998
+ {
999
+ code: 500,
1000
+ message: "Server error",
1001
+ solution: "Retry operation or contact support",
1002
+ },
1003
+ ],
1004
+ conditions: {
1005
+ postconditions: [],
1006
+ prerequisites: ["Active namespace", "Certificate file or data"],
1007
+ },
1008
+ confirmation_required: false,
1009
+ danger_level: "low",
1010
+ examples: [
1011
+ {
1012
+ command: "f5xcctl config certificate get {name} --namespace {namespace}",
1013
+ description: "Get specific certificate",
1014
+ use_case: "get_specific",
1015
+ },
1016
+ ],
1017
+ field_docs: {},
1018
+ optional_fields: [],
1019
+ performance_impact: {
1020
+ latency: "low",
1021
+ resource_usage: "low",
1022
+ },
1023
+ purpose: "Retrieve specific certificate",
1024
+ required_fields: ["path.name", "path.namespace"],
1025
+ side_effects: {},
1026
+ },
1027
+ },
1028
+ {
1029
+ toolName: "f5xc-api-certificates-certificate-list",
1030
+ method: "GET",
1031
+ path: "/api/config/namespaces/{namespace}/certificates",
1032
+ operation: "list",
1033
+ domain: "certificates",
1034
+ resource: "certificate",
1035
+ summary: "List Certificate.",
1036
+ description: "List the set of certificate in a namespace.",
1037
+ pathParameters: [
1038
+ {
1039
+ description: "Namespace\nNamespace to scope the listing of certificate.",
1040
+ in: "path",
1041
+ name: "namespace",
1042
+ required: true,
1043
+ schema: {
1044
+ type: "string",
1045
+ },
1046
+ "x-displayname": "Namespace",
1047
+ "x-ves-example": "Ns1",
1048
+ },
1049
+ ],
1050
+ queryParameters: [
1051
+ {
1052
+ description: "A LabelSelectorType expression that every item in list response will satisfy.",
1053
+ in: "query",
1054
+ name: "label_filter",
1055
+ required: false,
1056
+ schema: {
1057
+ type: "string",
1058
+ },
1059
+ "x-displayname": "Label Filter.",
1060
+ "x-ves-example": "Env in (staging, testing), tier in (web, db)",
1061
+ },
1062
+ {
1063
+ description: 'X-example: ""\nExtra fields to return along with summary fields.',
1064
+ in: "query",
1065
+ name: "report_fields",
1066
+ required: false,
1067
+ schema: {
1068
+ items: {
1069
+ type: "string",
1070
+ },
1071
+ type: "array",
1072
+ },
1073
+ "x-displayname": "Report Fields.",
1074
+ },
1075
+ {
1076
+ description: 'X-example: ""\nExtra status fields to return along with summary fields.',
1077
+ in: "query",
1078
+ name: "report_status_fields",
1079
+ required: false,
1080
+ schema: {
1081
+ items: {
1082
+ type: "string",
1083
+ },
1084
+ type: "array",
1085
+ },
1086
+ "x-displayname": "Report Status Fields.",
1087
+ },
1088
+ ],
1089
+ requestBodySchema: null,
1090
+ responseSchema: {
1091
+ $ref: "#/components/schemas/certificateListResponse",
1092
+ },
1093
+ requiredParams: ["namespace"],
1094
+ operationId: "ves.io.schema.certificate.API.List",
1095
+ tags: ["Other"],
1096
+ sourceFile: "domains/certificates.json",
1097
+ displayName: null,
1098
+ dangerLevel: "low",
1099
+ sideEffects: null,
1100
+ requiredFields: ["path.namespace"],
1101
+ cliExamples: [
1102
+ {
1103
+ command: "f5xcctl config certificate list --namespace {namespace}",
1104
+ description: "List all certificates",
1105
+ use_case: "list_all",
1106
+ },
1107
+ ],
1108
+ confirmationRequired: false,
1109
+ parameterExamples: {
1110
+ label_filter: "Env in (staging, testing), tier in (web, db)",
1111
+ namespace: "Ns1",
1112
+ },
1113
+ validationRules: {},
1114
+ operationMetadata: {
1115
+ common_errors: [
1116
+ {
1117
+ code: 401,
1118
+ message: "Authentication required",
1119
+ solution: "Provide valid API credentials",
1120
+ },
1121
+ {
1122
+ code: 403,
1123
+ message: "Permission denied",
1124
+ solution: "Check access permissions for this operation",
1125
+ },
1126
+ {
1127
+ code: 404,
1128
+ message: "Resource not found",
1129
+ solution: "Verify resource name, namespace, and path",
1130
+ },
1131
+ {
1132
+ code: 409,
1133
+ message: "Resource already exists",
1134
+ solution: "Use different name or update existing resource",
1135
+ },
1136
+ {
1137
+ code: 429,
1138
+ message: "Rate limit exceeded",
1139
+ solution: "Wait before retrying the operation",
1140
+ },
1141
+ {
1142
+ code: 500,
1143
+ message: "Server error",
1144
+ solution: "Retry operation or contact support",
1145
+ },
1146
+ ],
1147
+ conditions: {
1148
+ postconditions: [],
1149
+ prerequisites: ["Active namespace", "Certificate file or data"],
1150
+ },
1151
+ confirmation_required: false,
1152
+ danger_level: "low",
1153
+ examples: [
1154
+ {
1155
+ command: "f5xcctl config certificate list --namespace {namespace}",
1156
+ description: "List all certificates",
1157
+ use_case: "list_all",
1158
+ },
1159
+ ],
1160
+ field_docs: {},
1161
+ optional_fields: [],
1162
+ performance_impact: {
1163
+ latency: "moderate",
1164
+ resource_usage: "moderate",
1165
+ },
1166
+ purpose: "List all certificates",
1167
+ required_fields: ["path.namespace"],
1168
+ side_effects: {},
1169
+ },
1170
+ },
1171
+ {
1172
+ toolName: "f5xc-api-certificates-certificate-update",
1173
+ method: "PUT",
1174
+ path: "/api/config/namespaces/{metadata.namespace}/certificates/{metadata.name}",
1175
+ operation: "update",
1176
+ domain: "certificates",
1177
+ resource: "certificate",
1178
+ summary: "Replace Certificate.",
1179
+ description: "Shape of the Certificate specification.",
1180
+ pathParameters: [
1181
+ {
1182
+ description: "Name\nThe configuration object to be replaced will be looked up by name.",
1183
+ in: "path",
1184
+ name: "metadata.name",
1185
+ required: true,
1186
+ schema: {
1187
+ type: "string",
1188
+ },
1189
+ "x-displayname": "Name",
1190
+ "x-ves-example": "Example-corp-web.",
1191
+ },
1192
+ {
1193
+ 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 ""',
1194
+ in: "path",
1195
+ name: "metadata.namespace",
1196
+ required: true,
1197
+ schema: {
1198
+ type: "string",
1199
+ },
1200
+ "x-displayname": "Namespace",
1201
+ "x-ves-example": "Staging",
1202
+ },
1203
+ ],
1204
+ queryParameters: [],
1205
+ requestBodySchema: {
1206
+ $ref: "#/components/schemas/certificateReplaceRequest",
1207
+ },
1208
+ responseSchema: {
1209
+ $ref: "#/components/schemas/certificateReplaceResponse",
1210
+ },
1211
+ requiredParams: ["body", "metadata.name", "metadata.namespace"],
1212
+ operationId: "ves.io.schema.certificate.API.Replace",
1213
+ tags: ["Other"],
1214
+ sourceFile: "domains/certificates.json",
1215
+ displayName: null,
1216
+ dangerLevel: "medium",
1217
+ sideEffects: {
1218
+ modifies: ["certificate"],
1219
+ },
1220
+ requiredFields: ["path.metadata.name", "path.metadata.namespace"],
1221
+ cliExamples: [
1222
+ {
1223
+ command: "f5xcctl config certificate update {name} --namespace {namespace} -f {file}.yaml",
1224
+ description: "Update certificate",
1225
+ use_case: "update",
1226
+ },
1227
+ ],
1228
+ confirmationRequired: false,
1229
+ parameterExamples: {
1230
+ "metadata.name": "Example-corp-web.",
1231
+ "metadata.namespace": "Staging",
1232
+ },
1233
+ validationRules: {},
1234
+ operationMetadata: {
1235
+ common_errors: [
1236
+ {
1237
+ code: 401,
1238
+ message: "Authentication required",
1239
+ solution: "Provide valid API credentials",
1240
+ },
1241
+ {
1242
+ code: 403,
1243
+ message: "Permission denied",
1244
+ solution: "Check access permissions for this operation",
1245
+ },
1246
+ {
1247
+ code: 404,
1248
+ message: "Resource not found",
1249
+ solution: "Verify resource name, namespace, and path",
1250
+ },
1251
+ {
1252
+ code: 409,
1253
+ message: "Resource already exists",
1254
+ solution: "Use different name or update existing resource",
1255
+ },
1256
+ {
1257
+ code: 429,
1258
+ message: "Rate limit exceeded",
1259
+ solution: "Wait before retrying the operation",
1260
+ },
1261
+ {
1262
+ code: 500,
1263
+ message: "Server error",
1264
+ solution: "Retry operation or contact support",
1265
+ },
1266
+ ],
1267
+ conditions: {
1268
+ postconditions: ["Resource updated with new values"],
1269
+ prerequisites: ["Active namespace", "Certificate file or data"],
1270
+ },
1271
+ confirmation_required: false,
1272
+ danger_level: "medium",
1273
+ examples: [
1274
+ {
1275
+ command: "f5xcctl config certificate update {name} --namespace {namespace} -f {file}.yaml",
1276
+ description: "Update certificate",
1277
+ use_case: "update",
1278
+ },
1279
+ ],
1280
+ field_docs: {},
1281
+ optional_fields: [],
1282
+ performance_impact: {
1283
+ latency: "low",
1284
+ resource_usage: "low",
1285
+ },
1286
+ purpose: "Replace existing certificate",
1287
+ required_fields: ["path.metadata.name", "path.metadata.namespace"],
1288
+ side_effects: {
1289
+ modifies: ["certificate"],
1290
+ },
1291
+ },
1292
+ },
1293
+ {
1294
+ toolName: "f5xc-api-certificates-crl-create",
1295
+ method: "POST",
1296
+ path: "/api/config/namespaces/{metadata.namespace}/crls",
1297
+ operation: "create",
1298
+ domain: "certificates",
1299
+ resource: "crl",
1300
+ summary: "Create CRL.",
1301
+ description: "API to create CRL object.",
1302
+ pathParameters: [
1303
+ {
1304
+ 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 ""',
1305
+ in: "path",
1306
+ name: "metadata.namespace",
1307
+ required: true,
1308
+ schema: {
1309
+ type: "string",
1310
+ },
1311
+ "x-displayname": "Namespace",
1312
+ "x-ves-example": "Staging",
1313
+ },
1314
+ ],
1315
+ queryParameters: [],
1316
+ requestBodySchema: {
1317
+ $ref: "#/components/schemas/crlCreateRequest",
1318
+ },
1319
+ responseSchema: {
1320
+ $ref: "#/components/schemas/crlCreateResponse",
1321
+ },
1322
+ requiredParams: ["body", "metadata.namespace"],
1323
+ operationId: "ves.io.schema.crl.API.Create",
1324
+ tags: ["Other"],
1325
+ sourceFile: "domains/certificates.json",
1326
+ displayName: null,
1327
+ dangerLevel: "medium",
1328
+ sideEffects: {
1329
+ creates: ["crl"],
1330
+ },
1331
+ requiredFields: ["metadata.name", "metadata.namespace", "path.metadata.namespace"],
1332
+ cliExamples: [
1333
+ {
1334
+ command: "f5xcctl config crl create {name} --namespace {namespace}",
1335
+ description: "Create crl",
1336
+ use_case: "basic_create",
1337
+ },
1338
+ {
1339
+ command: "f5xcctl config crl create -f {file}.yaml",
1340
+ description: "Create from YAML file",
1341
+ use_case: "file_based",
1342
+ },
1343
+ ],
1344
+ confirmationRequired: false,
1345
+ parameterExamples: {
1346
+ "metadata.namespace": "Staging",
1347
+ },
1348
+ validationRules: {},
1349
+ operationMetadata: {
1350
+ common_errors: [
1351
+ {
1352
+ code: 401,
1353
+ message: "Authentication required",
1354
+ solution: "Provide valid API credentials",
1355
+ },
1356
+ {
1357
+ code: 403,
1358
+ message: "Permission denied",
1359
+ solution: "Check access permissions for this operation",
1360
+ },
1361
+ {
1362
+ code: 404,
1363
+ message: "Resource not found",
1364
+ solution: "Verify resource name, namespace, and path",
1365
+ },
1366
+ {
1367
+ code: 409,
1368
+ message: "Resource already exists",
1369
+ solution: "Use different name or update existing resource",
1370
+ },
1371
+ {
1372
+ code: 429,
1373
+ message: "Rate limit exceeded",
1374
+ solution: "Wait before retrying the operation",
1375
+ },
1376
+ {
1377
+ code: 500,
1378
+ message: "Server error",
1379
+ solution: "Retry operation or contact support",
1380
+ },
1381
+ ],
1382
+ conditions: {
1383
+ postconditions: ["Crl resource created", "Resource assigned unique identifier"],
1384
+ prerequisites: ["Active namespace"],
1385
+ },
1386
+ confirmation_required: false,
1387
+ danger_level: "medium",
1388
+ examples: [
1389
+ {
1390
+ command: "f5xcctl config crl create {name} --namespace {namespace}",
1391
+ description: "Create crl",
1392
+ use_case: "basic_create",
1393
+ },
1394
+ {
1395
+ command: "f5xcctl config crl create -f {file}.yaml",
1396
+ description: "Create from YAML file",
1397
+ use_case: "file_based",
1398
+ },
1399
+ ],
1400
+ field_docs: {},
1401
+ optional_fields: [],
1402
+ performance_impact: {
1403
+ latency: "low",
1404
+ resource_usage: "low",
1405
+ },
1406
+ purpose: "Create new crl",
1407
+ required_fields: ["metadata.name", "metadata.namespace", "path.metadata.namespace"],
1408
+ side_effects: {
1409
+ creates: ["crl"],
1410
+ },
1411
+ },
1412
+ },
1413
+ {
1414
+ toolName: "f5xc-api-certificates-crl-delete",
1415
+ method: "DELETE",
1416
+ path: "/api/config/namespaces/{namespace}/crls/{name}",
1417
+ operation: "delete",
1418
+ domain: "certificates",
1419
+ resource: "crl",
1420
+ summary: "DELETE CRL.",
1421
+ description: "DELETE the specified CRL.",
1422
+ pathParameters: [
1423
+ {
1424
+ description: "Name\nName of the configuration object.",
1425
+ in: "path",
1426
+ name: "name",
1427
+ required: true,
1428
+ schema: {
1429
+ type: "string",
1430
+ },
1431
+ "x-displayname": "Name",
1432
+ "x-ves-example": "Name",
1433
+ },
1434
+ {
1435
+ description: "Namespace\nNamespace in which the configuration object is present.",
1436
+ in: "path",
1437
+ name: "namespace",
1438
+ required: true,
1439
+ schema: {
1440
+ type: "string",
1441
+ },
1442
+ "x-displayname": "Namespace",
1443
+ "x-ves-example": "Ns1",
1444
+ },
1445
+ ],
1446
+ queryParameters: [],
1447
+ requestBodySchema: {
1448
+ $ref: "#/components/schemas/crlDeleteRequest",
1449
+ },
1450
+ responseSchema: {},
1451
+ requiredParams: ["body", "name", "namespace"],
1452
+ operationId: "ves.io.schema.crl.API.Delete",
1453
+ tags: ["Other"],
1454
+ sourceFile: "domains/certificates.json",
1455
+ displayName: null,
1456
+ dangerLevel: "high",
1457
+ sideEffects: {
1458
+ deletes: ["crl", "contained_resources"],
1459
+ },
1460
+ requiredFields: ["path.name", "path.namespace"],
1461
+ cliExamples: [
1462
+ {
1463
+ command: "f5xcctl config crl delete {name} --namespace {namespace}",
1464
+ description: "Delete crl",
1465
+ use_case: "delete",
1466
+ },
1467
+ ],
1468
+ confirmationRequired: true,
1469
+ parameterExamples: {
1470
+ name: "Name",
1471
+ namespace: "Ns1",
1472
+ },
1473
+ validationRules: {},
1474
+ operationMetadata: {
1475
+ common_errors: [
1476
+ {
1477
+ code: 401,
1478
+ message: "Authentication required",
1479
+ solution: "Provide valid API credentials",
1480
+ },
1481
+ {
1482
+ code: 403,
1483
+ message: "Permission denied",
1484
+ solution: "Check access permissions for this operation",
1485
+ },
1486
+ {
1487
+ code: 404,
1488
+ message: "Resource not found",
1489
+ solution: "Verify resource name, namespace, and path",
1490
+ },
1491
+ {
1492
+ code: 409,
1493
+ message: "Resource already exists",
1494
+ solution: "Use different name or update existing resource",
1495
+ },
1496
+ {
1497
+ code: 429,
1498
+ message: "Rate limit exceeded",
1499
+ solution: "Wait before retrying the operation",
1500
+ },
1501
+ {
1502
+ code: 500,
1503
+ message: "Server error",
1504
+ solution: "Retry operation or contact support",
1505
+ },
1506
+ ],
1507
+ conditions: {
1508
+ postconditions: ["Resource removed from system", "Associated resources may be affected"],
1509
+ prerequisites: ["Active namespace"],
1510
+ },
1511
+ confirmation_required: true,
1512
+ danger_level: "high",
1513
+ examples: [
1514
+ {
1515
+ command: "f5xcctl config crl delete {name} --namespace {namespace}",
1516
+ description: "Delete crl",
1517
+ use_case: "delete",
1518
+ },
1519
+ ],
1520
+ field_docs: {},
1521
+ optional_fields: [],
1522
+ performance_impact: {
1523
+ latency: "high",
1524
+ resource_usage: "moderate",
1525
+ },
1526
+ purpose: "Delete crl",
1527
+ required_fields: ["path.name", "path.namespace"],
1528
+ side_effects: {
1529
+ deletes: ["crl", "contained_resources"],
1530
+ },
1531
+ },
1532
+ },
1533
+ {
1534
+ toolName: "f5xc-api-certificates-crl-get",
1535
+ method: "GET",
1536
+ path: "/api/config/namespaces/{namespace}/crls/{name}",
1537
+ operation: "get",
1538
+ domain: "certificates",
1539
+ resource: "crl",
1540
+ summary: "GET CRL",
1541
+ description: "API to GET CRL.",
1542
+ pathParameters: [
1543
+ {
1544
+ description: "Name\nThe name of the configuration object to be fetched.",
1545
+ in: "path",
1546
+ name: "name",
1547
+ required: true,
1548
+ schema: {
1549
+ type: "string",
1550
+ },
1551
+ "x-displayname": "Name",
1552
+ "x-ves-example": "Name",
1553
+ },
1554
+ {
1555
+ description: "Namespace\nThe namespace in which the configuration object is present.",
1556
+ in: "path",
1557
+ name: "namespace",
1558
+ required: true,
1559
+ schema: {
1560
+ type: "string",
1561
+ },
1562
+ "x-displayname": "Namespace",
1563
+ "x-ves-example": "Ns1",
1564
+ },
1565
+ ],
1566
+ queryParameters: [
1567
+ {
1568
+ 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.",
1569
+ in: "query",
1570
+ name: "response_format",
1571
+ required: false,
1572
+ schema: {
1573
+ default: "GET_RSP_FORMAT_DEFAULT",
1574
+ enum: [
1575
+ "GET_RSP_FORMAT_DEFAULT",
1576
+ "GET_RSP_FORMAT_FOR_CREATE",
1577
+ "GET_RSP_FORMAT_FOR_REPLACE",
1578
+ "GET_RSP_FORMAT_STATUS",
1579
+ "GET_RSP_FORMAT_READ",
1580
+ "GET_RSP_FORMAT_REFERRING_OBJECTS",
1581
+ "GET_RSP_FORMAT_BROKEN_REFERENCES",
1582
+ ],
1583
+ type: "string",
1584
+ },
1585
+ "x-displayname": "Broken Referred Objects.",
1586
+ },
1587
+ ],
1588
+ requestBodySchema: null,
1589
+ responseSchema: {
1590
+ $ref: "#/components/schemas/crlGetResponse",
1591
+ },
1592
+ requiredParams: ["name", "namespace"],
1593
+ operationId: "ves.io.schema.crl.API.Get",
1594
+ tags: ["Other"],
1595
+ sourceFile: "domains/certificates.json",
1596
+ displayName: null,
1597
+ dangerLevel: "low",
1598
+ sideEffects: null,
1599
+ requiredFields: ["path.name", "path.namespace"],
1600
+ cliExamples: [
1601
+ {
1602
+ command: "f5xcctl config crl get {name} --namespace {namespace}",
1603
+ description: "Get specific crl",
1604
+ use_case: "get_specific",
1605
+ },
1606
+ ],
1607
+ confirmationRequired: false,
1608
+ parameterExamples: {
1609
+ name: "Name",
1610
+ namespace: "Ns1",
1611
+ },
1612
+ validationRules: {},
1613
+ operationMetadata: {
1614
+ common_errors: [
1615
+ {
1616
+ code: 401,
1617
+ message: "Authentication required",
1618
+ solution: "Provide valid API credentials",
1619
+ },
1620
+ {
1621
+ code: 403,
1622
+ message: "Permission denied",
1623
+ solution: "Check access permissions for this operation",
1624
+ },
1625
+ {
1626
+ code: 404,
1627
+ message: "Resource not found",
1628
+ solution: "Verify resource name, namespace, and path",
1629
+ },
1630
+ {
1631
+ code: 409,
1632
+ message: "Resource already exists",
1633
+ solution: "Use different name or update existing resource",
1634
+ },
1635
+ {
1636
+ code: 429,
1637
+ message: "Rate limit exceeded",
1638
+ solution: "Wait before retrying the operation",
1639
+ },
1640
+ {
1641
+ code: 500,
1642
+ message: "Server error",
1643
+ solution: "Retry operation or contact support",
1644
+ },
1645
+ ],
1646
+ conditions: {
1647
+ postconditions: [],
1648
+ prerequisites: ["Active namespace"],
1649
+ },
1650
+ confirmation_required: false,
1651
+ danger_level: "low",
1652
+ examples: [
1653
+ {
1654
+ command: "f5xcctl config crl get {name} --namespace {namespace}",
1655
+ description: "Get specific crl",
1656
+ use_case: "get_specific",
1657
+ },
1658
+ ],
1659
+ field_docs: {},
1660
+ optional_fields: [],
1661
+ performance_impact: {
1662
+ latency: "low",
1663
+ resource_usage: "low",
1664
+ },
1665
+ purpose: "Retrieve specific crl",
1666
+ required_fields: ["path.name", "path.namespace"],
1667
+ side_effects: {},
1668
+ },
1669
+ },
1670
+ {
1671
+ toolName: "f5xc-api-certificates-crl-list",
1672
+ method: "GET",
1673
+ path: "/api/config/namespaces/{namespace}/crls",
1674
+ operation: "list",
1675
+ domain: "certificates",
1676
+ resource: "crl",
1677
+ summary: "List CRL",
1678
+ description: "List the set of CRL in a namespace.",
1679
+ pathParameters: [
1680
+ {
1681
+ description: "Namespace\nNamespace to scope the listing of CRL.",
1682
+ in: "path",
1683
+ name: "namespace",
1684
+ required: true,
1685
+ schema: {
1686
+ type: "string",
1687
+ },
1688
+ "x-displayname": "Namespace",
1689
+ "x-ves-example": "Ns1",
1690
+ },
1691
+ ],
1692
+ queryParameters: [
1693
+ {
1694
+ description: "A LabelSelectorType expression that every item in list response will satisfy.",
1695
+ in: "query",
1696
+ name: "label_filter",
1697
+ required: false,
1698
+ schema: {
1699
+ type: "string",
1700
+ },
1701
+ "x-displayname": "Label Filter.",
1702
+ "x-ves-example": "Env in (staging, testing), tier in (web, db)",
1703
+ },
1704
+ {
1705
+ description: 'X-example: ""\nExtra fields to return along with summary fields.',
1706
+ in: "query",
1707
+ name: "report_fields",
1708
+ required: false,
1709
+ schema: {
1710
+ items: {
1711
+ type: "string",
1712
+ },
1713
+ type: "array",
1714
+ },
1715
+ "x-displayname": "Report Fields.",
1716
+ },
1717
+ {
1718
+ description: 'X-example: ""\nExtra status fields to return along with summary fields.',
1719
+ in: "query",
1720
+ name: "report_status_fields",
1721
+ required: false,
1722
+ schema: {
1723
+ items: {
1724
+ type: "string",
1725
+ },
1726
+ type: "array",
1727
+ },
1728
+ "x-displayname": "Report Status Fields.",
1729
+ },
1730
+ ],
1731
+ requestBodySchema: null,
1732
+ responseSchema: {
1733
+ $ref: "#/components/schemas/crlListResponse",
1734
+ },
1735
+ requiredParams: ["namespace"],
1736
+ operationId: "ves.io.schema.crl.API.List",
1737
+ tags: ["Other"],
1738
+ sourceFile: "domains/certificates.json",
1739
+ displayName: null,
1740
+ dangerLevel: "low",
1741
+ sideEffects: null,
1742
+ requiredFields: ["path.namespace"],
1743
+ cliExamples: [
1744
+ {
1745
+ command: "f5xcctl config crl list --namespace {namespace}",
1746
+ description: "List all crls",
1747
+ use_case: "list_all",
1748
+ },
1749
+ ],
1750
+ confirmationRequired: false,
1751
+ parameterExamples: {
1752
+ label_filter: "Env in (staging, testing), tier in (web, db)",
1753
+ namespace: "Ns1",
1754
+ },
1755
+ validationRules: {},
1756
+ operationMetadata: {
1757
+ common_errors: [
1758
+ {
1759
+ code: 401,
1760
+ message: "Authentication required",
1761
+ solution: "Provide valid API credentials",
1762
+ },
1763
+ {
1764
+ code: 403,
1765
+ message: "Permission denied",
1766
+ solution: "Check access permissions for this operation",
1767
+ },
1768
+ {
1769
+ code: 404,
1770
+ message: "Resource not found",
1771
+ solution: "Verify resource name, namespace, and path",
1772
+ },
1773
+ {
1774
+ code: 409,
1775
+ message: "Resource already exists",
1776
+ solution: "Use different name or update existing resource",
1777
+ },
1778
+ {
1779
+ code: 429,
1780
+ message: "Rate limit exceeded",
1781
+ solution: "Wait before retrying the operation",
1782
+ },
1783
+ {
1784
+ code: 500,
1785
+ message: "Server error",
1786
+ solution: "Retry operation or contact support",
1787
+ },
1788
+ ],
1789
+ conditions: {
1790
+ postconditions: [],
1791
+ prerequisites: ["Active namespace"],
1792
+ },
1793
+ confirmation_required: false,
1794
+ danger_level: "low",
1795
+ examples: [
1796
+ {
1797
+ command: "f5xcctl config crl list --namespace {namespace}",
1798
+ description: "List all crls",
1799
+ use_case: "list_all",
1800
+ },
1801
+ ],
1802
+ field_docs: {},
1803
+ optional_fields: [],
1804
+ performance_impact: {
1805
+ latency: "moderate",
1806
+ resource_usage: "moderate",
1807
+ },
1808
+ purpose: "List all crls",
1809
+ required_fields: ["path.namespace"],
1810
+ side_effects: {},
1811
+ },
1812
+ },
1813
+ {
1814
+ toolName: "f5xc-api-certificates-crl-update",
1815
+ method: "PUT",
1816
+ path: "/api/config/namespaces/{metadata.namespace}/crls/{metadata.name}",
1817
+ operation: "update",
1818
+ domain: "certificates",
1819
+ resource: "crl",
1820
+ summary: "Replace CRL.",
1821
+ description: "API to replace CRL object.",
1822
+ pathParameters: [
1823
+ {
1824
+ description: "Name\nThe configuration object to be replaced will be looked up by name.",
1825
+ in: "path",
1826
+ name: "metadata.name",
1827
+ required: true,
1828
+ schema: {
1829
+ type: "string",
1830
+ },
1831
+ "x-displayname": "Name",
1832
+ "x-ves-example": "Example-corp-web.",
1833
+ },
1834
+ {
1835
+ 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 ""',
1836
+ in: "path",
1837
+ name: "metadata.namespace",
1838
+ required: true,
1839
+ schema: {
1840
+ type: "string",
1841
+ },
1842
+ "x-displayname": "Namespace",
1843
+ "x-ves-example": "Staging",
1844
+ },
1845
+ ],
1846
+ queryParameters: [],
1847
+ requestBodySchema: {
1848
+ $ref: "#/components/schemas/crlReplaceRequest",
1849
+ },
1850
+ responseSchema: {
1851
+ $ref: "#/components/schemas/crlReplaceResponse",
1852
+ },
1853
+ requiredParams: ["body", "metadata.name", "metadata.namespace"],
1854
+ operationId: "ves.io.schema.crl.API.Replace",
1855
+ tags: ["Other"],
1856
+ sourceFile: "domains/certificates.json",
1857
+ displayName: null,
1858
+ dangerLevel: "medium",
1859
+ sideEffects: {
1860
+ modifies: ["crl"],
1861
+ },
1862
+ requiredFields: ["path.metadata.name", "path.metadata.namespace"],
1863
+ cliExamples: [
1864
+ {
1865
+ command: "f5xcctl config crl update {name} --namespace {namespace} -f {file}.yaml",
1866
+ description: "Update crl",
1867
+ use_case: "update",
1868
+ },
1869
+ ],
1870
+ confirmationRequired: false,
1871
+ parameterExamples: {
1872
+ "metadata.name": "Example-corp-web.",
1873
+ "metadata.namespace": "Staging",
1874
+ },
1875
+ validationRules: {},
1876
+ operationMetadata: {
1877
+ common_errors: [
1878
+ {
1879
+ code: 401,
1880
+ message: "Authentication required",
1881
+ solution: "Provide valid API credentials",
1882
+ },
1883
+ {
1884
+ code: 403,
1885
+ message: "Permission denied",
1886
+ solution: "Check access permissions for this operation",
1887
+ },
1888
+ {
1889
+ code: 404,
1890
+ message: "Resource not found",
1891
+ solution: "Verify resource name, namespace, and path",
1892
+ },
1893
+ {
1894
+ code: 409,
1895
+ message: "Resource already exists",
1896
+ solution: "Use different name or update existing resource",
1897
+ },
1898
+ {
1899
+ code: 429,
1900
+ message: "Rate limit exceeded",
1901
+ solution: "Wait before retrying the operation",
1902
+ },
1903
+ {
1904
+ code: 500,
1905
+ message: "Server error",
1906
+ solution: "Retry operation or contact support",
1907
+ },
1908
+ ],
1909
+ conditions: {
1910
+ postconditions: ["Resource updated with new values"],
1911
+ prerequisites: ["Active namespace"],
1912
+ },
1913
+ confirmation_required: false,
1914
+ danger_level: "medium",
1915
+ examples: [
1916
+ {
1917
+ command: "f5xcctl config crl update {name} --namespace {namespace} -f {file}.yaml",
1918
+ description: "Update crl",
1919
+ use_case: "update",
1920
+ },
1921
+ ],
1922
+ field_docs: {},
1923
+ optional_fields: [],
1924
+ performance_impact: {
1925
+ latency: "low",
1926
+ resource_usage: "low",
1927
+ },
1928
+ purpose: "Replace existing crl",
1929
+ required_fields: ["path.metadata.name", "path.metadata.namespace"],
1930
+ side_effects: {
1931
+ modifies: ["crl"],
1932
+ },
1933
+ },
1934
+ },
1935
+ {
1936
+ toolName: "f5xc-api-certificates-trusted-ca-list-create",
1937
+ method: "POST",
1938
+ path: "/api/config/namespaces/{metadata.namespace}/trusted_ca_lists",
1939
+ operation: "create",
1940
+ domain: "certificates",
1941
+ resource: "trusted-ca-list",
1942
+ summary: "Create Root CA Certificate.",
1943
+ description: "Shape of the Root CA Certificate specification.",
1944
+ pathParameters: [
1945
+ {
1946
+ 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 ""',
1947
+ in: "path",
1948
+ name: "metadata.namespace",
1949
+ required: true,
1950
+ schema: {
1951
+ type: "string",
1952
+ },
1953
+ "x-displayname": "Namespace",
1954
+ "x-ves-example": "Staging",
1955
+ },
1956
+ ],
1957
+ queryParameters: [],
1958
+ requestBodySchema: {
1959
+ $ref: "#/components/schemas/trusted_ca_listCreateRequest",
1960
+ },
1961
+ responseSchema: {
1962
+ $ref: "#/components/schemas/trusted_ca_listCreateResponse",
1963
+ },
1964
+ requiredParams: ["body", "metadata.namespace"],
1965
+ operationId: "ves.io.schema.trusted_ca_list.API.Create",
1966
+ tags: ["Other"],
1967
+ sourceFile: "domains/certificates.json",
1968
+ displayName: null,
1969
+ dangerLevel: "medium",
1970
+ sideEffects: {
1971
+ creates: ["trusted-ca-list"],
1972
+ },
1973
+ requiredFields: ["metadata.name", "metadata.namespace", "path.metadata.namespace"],
1974
+ cliExamples: [
1975
+ {
1976
+ command: "f5xcctl config trusted-ca-list create -f {file}.yaml",
1977
+ description: "Create from YAML file",
1978
+ use_case: "file_based",
1979
+ },
1980
+ {
1981
+ command: "f5xcctl config trusted-ca-list create {name} --namespace {namespace}",
1982
+ description: "Create trusted-ca-list",
1983
+ use_case: "basic_create",
1984
+ },
1985
+ ],
1986
+ confirmationRequired: false,
1987
+ parameterExamples: {
1988
+ "metadata.namespace": "Staging",
1989
+ },
1990
+ validationRules: {},
1991
+ operationMetadata: {
1992
+ common_errors: [
1993
+ {
1994
+ code: 401,
1995
+ message: "Authentication required",
1996
+ solution: "Provide valid API credentials",
1997
+ },
1998
+ {
1999
+ code: 403,
2000
+ message: "Permission denied",
2001
+ solution: "Check access permissions for this operation",
2002
+ },
2003
+ {
2004
+ code: 404,
2005
+ message: "Resource not found",
2006
+ solution: "Verify resource name, namespace, and path",
2007
+ },
2008
+ {
2009
+ code: 409,
2010
+ message: "Resource already exists",
2011
+ solution: "Use different name or update existing resource",
2012
+ },
2013
+ {
2014
+ code: 429,
2015
+ message: "Rate limit exceeded",
2016
+ solution: "Wait before retrying the operation",
2017
+ },
2018
+ {
2019
+ code: 500,
2020
+ message: "Server error",
2021
+ solution: "Retry operation or contact support",
2022
+ },
2023
+ ],
2024
+ conditions: {
2025
+ postconditions: ["Trusted-ca-list resource created", "Resource assigned unique identifier"],
2026
+ prerequisites: ["Active namespace"],
2027
+ },
2028
+ confirmation_required: false,
2029
+ danger_level: "medium",
2030
+ examples: [
2031
+ {
2032
+ command: "f5xcctl config trusted-ca-list create {name} --namespace {namespace}",
2033
+ description: "Create trusted-ca-list",
2034
+ use_case: "basic_create",
2035
+ },
2036
+ {
2037
+ command: "f5xcctl config trusted-ca-list create -f {file}.yaml",
2038
+ description: "Create from YAML file",
2039
+ use_case: "file_based",
2040
+ },
2041
+ ],
2042
+ field_docs: {},
2043
+ optional_fields: [],
2044
+ performance_impact: {
2045
+ latency: "low",
2046
+ resource_usage: "low",
2047
+ },
2048
+ purpose: "Create new trusted-ca-list",
2049
+ required_fields: ["metadata.name", "metadata.namespace", "path.metadata.namespace"],
2050
+ side_effects: {
2051
+ creates: ["trusted-ca-list"],
2052
+ },
2053
+ },
2054
+ },
2055
+ {
2056
+ toolName: "f5xc-api-certificates-trusted-ca-list-delete",
2057
+ method: "DELETE",
2058
+ path: "/api/config/namespaces/{namespace}/trusted_ca_lists/{name}",
2059
+ operation: "delete",
2060
+ domain: "certificates",
2061
+ resource: "trusted-ca-list",
2062
+ summary: "DELETE Root CA Certificate.",
2063
+ description: "DELETE the specified trusted_ca_list.",
2064
+ pathParameters: [
2065
+ {
2066
+ description: "Name\nName of the configuration object.",
2067
+ in: "path",
2068
+ name: "name",
2069
+ required: true,
2070
+ schema: {
2071
+ type: "string",
2072
+ },
2073
+ "x-displayname": "Name",
2074
+ "x-ves-example": "Name",
2075
+ },
2076
+ {
2077
+ description: "Namespace\nNamespace in which the configuration object is present.",
2078
+ in: "path",
2079
+ name: "namespace",
2080
+ required: true,
2081
+ schema: {
2082
+ type: "string",
2083
+ },
2084
+ "x-displayname": "Namespace",
2085
+ "x-ves-example": "Ns1",
2086
+ },
2087
+ ],
2088
+ queryParameters: [],
2089
+ requestBodySchema: {
2090
+ $ref: "#/components/schemas/trusted_ca_listDeleteRequest",
2091
+ },
2092
+ responseSchema: {},
2093
+ requiredParams: ["body", "name", "namespace"],
2094
+ operationId: "ves.io.schema.trusted_ca_list.API.Delete",
2095
+ tags: ["Other"],
2096
+ sourceFile: "domains/certificates.json",
2097
+ displayName: null,
2098
+ dangerLevel: "high",
2099
+ sideEffects: {
2100
+ deletes: ["trusted-ca-list", "contained_resources"],
2101
+ },
2102
+ requiredFields: ["path.name", "path.namespace"],
2103
+ cliExamples: [
2104
+ {
2105
+ command: "f5xcctl config trusted-ca-list delete {name} --namespace {namespace}",
2106
+ description: "Delete trusted-ca-list",
2107
+ use_case: "delete",
2108
+ },
2109
+ ],
2110
+ confirmationRequired: true,
2111
+ parameterExamples: {
2112
+ name: "Name",
2113
+ namespace: "Ns1",
2114
+ },
2115
+ validationRules: {},
2116
+ operationMetadata: {
2117
+ common_errors: [
2118
+ {
2119
+ code: 401,
2120
+ message: "Authentication required",
2121
+ solution: "Provide valid API credentials",
2122
+ },
2123
+ {
2124
+ code: 403,
2125
+ message: "Permission denied",
2126
+ solution: "Check access permissions for this operation",
2127
+ },
2128
+ {
2129
+ code: 404,
2130
+ message: "Resource not found",
2131
+ solution: "Verify resource name, namespace, and path",
2132
+ },
2133
+ {
2134
+ code: 409,
2135
+ message: "Resource already exists",
2136
+ solution: "Use different name or update existing resource",
2137
+ },
2138
+ {
2139
+ code: 429,
2140
+ message: "Rate limit exceeded",
2141
+ solution: "Wait before retrying the operation",
2142
+ },
2143
+ {
2144
+ code: 500,
2145
+ message: "Server error",
2146
+ solution: "Retry operation or contact support",
2147
+ },
2148
+ ],
2149
+ conditions: {
2150
+ postconditions: ["Resource removed from system", "Associated resources may be affected"],
2151
+ prerequisites: ["Active namespace"],
2152
+ },
2153
+ confirmation_required: true,
2154
+ danger_level: "high",
2155
+ examples: [
2156
+ {
2157
+ command: "f5xcctl config trusted-ca-list delete {name} --namespace {namespace}",
2158
+ description: "Delete trusted-ca-list",
2159
+ use_case: "delete",
2160
+ },
2161
+ ],
2162
+ field_docs: {},
2163
+ optional_fields: [],
2164
+ performance_impact: {
2165
+ latency: "high",
2166
+ resource_usage: "moderate",
2167
+ },
2168
+ purpose: "Delete trusted-ca-list",
2169
+ required_fields: ["path.name", "path.namespace"],
2170
+ side_effects: {
2171
+ deletes: ["trusted-ca-list", "contained_resources"],
2172
+ },
2173
+ },
2174
+ },
2175
+ {
2176
+ toolName: "f5xc-api-certificates-trusted-ca-list-get",
2177
+ method: "GET",
2178
+ path: "/api/config/namespaces/{namespace}/trusted_ca_lists/{name}",
2179
+ operation: "get",
2180
+ domain: "certificates",
2181
+ resource: "trusted-ca-list",
2182
+ summary: "GET Root CA Certificate.",
2183
+ description: "Shape of the Root CA Certificate specification.",
2184
+ pathParameters: [
2185
+ {
2186
+ description: "Name\nThe name of the configuration object to be fetched.",
2187
+ in: "path",
2188
+ name: "name",
2189
+ required: true,
2190
+ schema: {
2191
+ type: "string",
2192
+ },
2193
+ "x-displayname": "Name",
2194
+ "x-ves-example": "Name",
2195
+ },
2196
+ {
2197
+ description: "Namespace\nThe namespace in which the configuration object is present.",
2198
+ in: "path",
2199
+ name: "namespace",
2200
+ required: true,
2201
+ schema: {
2202
+ type: "string",
2203
+ },
2204
+ "x-displayname": "Namespace",
2205
+ "x-ves-example": "Ns1",
2206
+ },
2207
+ ],
2208
+ queryParameters: [
2209
+ {
2210
+ 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.",
2211
+ in: "query",
2212
+ name: "response_format",
2213
+ required: false,
2214
+ schema: {
2215
+ default: "GET_RSP_FORMAT_DEFAULT",
2216
+ enum: [
2217
+ "GET_RSP_FORMAT_DEFAULT",
2218
+ "GET_RSP_FORMAT_FOR_CREATE",
2219
+ "GET_RSP_FORMAT_FOR_REPLACE",
2220
+ "GET_RSP_FORMAT_STATUS",
2221
+ "GET_RSP_FORMAT_READ",
2222
+ "GET_RSP_FORMAT_REFERRING_OBJECTS",
2223
+ "GET_RSP_FORMAT_BROKEN_REFERENCES",
2224
+ ],
2225
+ type: "string",
2226
+ },
2227
+ "x-displayname": "Broken Referred Objects.",
2228
+ },
2229
+ ],
2230
+ requestBodySchema: null,
2231
+ responseSchema: {
2232
+ $ref: "#/components/schemas/trusted_ca_listGetResponse",
2233
+ },
2234
+ requiredParams: ["name", "namespace"],
2235
+ operationId: "ves.io.schema.trusted_ca_list.API.Get",
2236
+ tags: ["Other"],
2237
+ sourceFile: "domains/certificates.json",
2238
+ displayName: null,
2239
+ dangerLevel: "low",
2240
+ sideEffects: null,
2241
+ requiredFields: ["path.name", "path.namespace"],
2242
+ cliExamples: [
2243
+ {
2244
+ command: "f5xcctl config trusted-ca-list get {name} --namespace {namespace}",
2245
+ description: "Get specific trusted-ca-list",
2246
+ use_case: "get_specific",
2247
+ },
2248
+ ],
2249
+ confirmationRequired: false,
2250
+ parameterExamples: {
2251
+ name: "Name",
2252
+ namespace: "Ns1",
2253
+ },
2254
+ validationRules: {},
2255
+ operationMetadata: {
2256
+ common_errors: [
2257
+ {
2258
+ code: 401,
2259
+ message: "Authentication required",
2260
+ solution: "Provide valid API credentials",
2261
+ },
2262
+ {
2263
+ code: 403,
2264
+ message: "Permission denied",
2265
+ solution: "Check access permissions for this operation",
2266
+ },
2267
+ {
2268
+ code: 404,
2269
+ message: "Resource not found",
2270
+ solution: "Verify resource name, namespace, and path",
2271
+ },
2272
+ {
2273
+ code: 409,
2274
+ message: "Resource already exists",
2275
+ solution: "Use different name or update existing resource",
2276
+ },
2277
+ {
2278
+ code: 429,
2279
+ message: "Rate limit exceeded",
2280
+ solution: "Wait before retrying the operation",
2281
+ },
2282
+ {
2283
+ code: 500,
2284
+ message: "Server error",
2285
+ solution: "Retry operation or contact support",
2286
+ },
2287
+ ],
2288
+ conditions: {
2289
+ postconditions: [],
2290
+ prerequisites: ["Active namespace"],
2291
+ },
2292
+ confirmation_required: false,
2293
+ danger_level: "low",
2294
+ examples: [
2295
+ {
2296
+ command: "f5xcctl config trusted-ca-list get {name} --namespace {namespace}",
2297
+ description: "Get specific trusted-ca-list",
2298
+ use_case: "get_specific",
2299
+ },
2300
+ ],
2301
+ field_docs: {},
2302
+ optional_fields: [],
2303
+ performance_impact: {
2304
+ latency: "low",
2305
+ resource_usage: "low",
2306
+ },
2307
+ purpose: "Retrieve specific trusted-ca-list",
2308
+ required_fields: ["path.name", "path.namespace"],
2309
+ side_effects: {},
2310
+ },
2311
+ },
2312
+ {
2313
+ toolName: "f5xc-api-certificates-trusted-ca-list-list",
2314
+ method: "GET",
2315
+ path: "/api/config/namespaces/{namespace}/trusted_ca_lists",
2316
+ operation: "list",
2317
+ domain: "certificates",
2318
+ resource: "trusted-ca-list",
2319
+ summary: "List Root CA Certificate.",
2320
+ description: "List the set of trusted_ca_list in a namespace.",
2321
+ pathParameters: [
2322
+ {
2323
+ description: "Namespace\nNamespace to scope the listing of trusted_ca_list.",
2324
+ in: "path",
2325
+ name: "namespace",
2326
+ required: true,
2327
+ schema: {
2328
+ type: "string",
2329
+ },
2330
+ "x-displayname": "Namespace",
2331
+ "x-ves-example": "Ns1",
2332
+ },
2333
+ ],
2334
+ queryParameters: [
2335
+ {
2336
+ description: "A LabelSelectorType expression that every item in list response will satisfy.",
2337
+ in: "query",
2338
+ name: "label_filter",
2339
+ required: false,
2340
+ schema: {
2341
+ type: "string",
2342
+ },
2343
+ "x-displayname": "Label Filter.",
2344
+ "x-ves-example": "Env in (staging, testing), tier in (web, db)",
2345
+ },
2346
+ {
2347
+ description: 'X-example: ""\nExtra fields to return along with summary fields.',
2348
+ in: "query",
2349
+ name: "report_fields",
2350
+ required: false,
2351
+ schema: {
2352
+ items: {
2353
+ type: "string",
2354
+ },
2355
+ type: "array",
2356
+ },
2357
+ "x-displayname": "Report Fields.",
2358
+ },
2359
+ {
2360
+ description: 'X-example: ""\nExtra status fields to return along with summary fields.',
2361
+ in: "query",
2362
+ name: "report_status_fields",
2363
+ required: false,
2364
+ schema: {
2365
+ items: {
2366
+ type: "string",
2367
+ },
2368
+ type: "array",
2369
+ },
2370
+ "x-displayname": "Report Status Fields.",
2371
+ },
2372
+ ],
2373
+ requestBodySchema: null,
2374
+ responseSchema: {
2375
+ $ref: "#/components/schemas/trusted_ca_listListResponse",
2376
+ },
2377
+ requiredParams: ["namespace"],
2378
+ operationId: "ves.io.schema.trusted_ca_list.API.List",
2379
+ tags: ["Other"],
2380
+ sourceFile: "domains/certificates.json",
2381
+ displayName: null,
2382
+ dangerLevel: "low",
2383
+ sideEffects: null,
2384
+ requiredFields: ["path.namespace"],
2385
+ cliExamples: [
2386
+ {
2387
+ command: "f5xcctl config trusted-ca-list list --namespace {namespace}",
2388
+ description: "List all trusted-ca-lists",
2389
+ use_case: "list_all",
2390
+ },
2391
+ ],
2392
+ confirmationRequired: false,
2393
+ parameterExamples: {
2394
+ label_filter: "Env in (staging, testing), tier in (web, db)",
2395
+ namespace: "Ns1",
2396
+ },
2397
+ validationRules: {},
2398
+ operationMetadata: {
2399
+ common_errors: [
2400
+ {
2401
+ code: 401,
2402
+ message: "Authentication required",
2403
+ solution: "Provide valid API credentials",
2404
+ },
2405
+ {
2406
+ code: 403,
2407
+ message: "Permission denied",
2408
+ solution: "Check access permissions for this operation",
2409
+ },
2410
+ {
2411
+ code: 404,
2412
+ message: "Resource not found",
2413
+ solution: "Verify resource name, namespace, and path",
2414
+ },
2415
+ {
2416
+ code: 409,
2417
+ message: "Resource already exists",
2418
+ solution: "Use different name or update existing resource",
2419
+ },
2420
+ {
2421
+ code: 429,
2422
+ message: "Rate limit exceeded",
2423
+ solution: "Wait before retrying the operation",
2424
+ },
2425
+ {
2426
+ code: 500,
2427
+ message: "Server error",
2428
+ solution: "Retry operation or contact support",
2429
+ },
2430
+ ],
2431
+ conditions: {
2432
+ postconditions: [],
2433
+ prerequisites: ["Active namespace"],
2434
+ },
2435
+ confirmation_required: false,
2436
+ danger_level: "low",
2437
+ examples: [
2438
+ {
2439
+ command: "f5xcctl config trusted-ca-list list --namespace {namespace}",
2440
+ description: "List all trusted-ca-lists",
2441
+ use_case: "list_all",
2442
+ },
2443
+ ],
2444
+ field_docs: {},
2445
+ optional_fields: [],
2446
+ performance_impact: {
2447
+ latency: "moderate",
2448
+ resource_usage: "moderate",
2449
+ },
2450
+ purpose: "List all trusted-ca-lists",
2451
+ required_fields: ["path.namespace"],
2452
+ side_effects: {},
2453
+ },
2454
+ },
2455
+ {
2456
+ toolName: "f5xc-api-certificates-trusted-ca-list-update",
2457
+ method: "PUT",
2458
+ path: "/api/config/namespaces/{metadata.namespace}/trusted_ca_lists/{metadata.name}",
2459
+ operation: "update",
2460
+ domain: "certificates",
2461
+ resource: "trusted-ca-list",
2462
+ summary: "Replace Root CA Certificate.",
2463
+ description: "Shape of the Root CA Certificate specification.",
2464
+ pathParameters: [
2465
+ {
2466
+ description: "Name\nThe configuration object to be replaced will be looked up by name.",
2467
+ in: "path",
2468
+ name: "metadata.name",
2469
+ required: true,
2470
+ schema: {
2471
+ type: "string",
2472
+ },
2473
+ "x-displayname": "Name",
2474
+ "x-ves-example": "Example-corp-web.",
2475
+ },
2476
+ {
2477
+ 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 ""',
2478
+ in: "path",
2479
+ name: "metadata.namespace",
2480
+ required: true,
2481
+ schema: {
2482
+ type: "string",
2483
+ },
2484
+ "x-displayname": "Namespace",
2485
+ "x-ves-example": "Staging",
2486
+ },
2487
+ ],
2488
+ queryParameters: [],
2489
+ requestBodySchema: {
2490
+ $ref: "#/components/schemas/trusted_ca_listReplaceRequest",
2491
+ },
2492
+ responseSchema: {
2493
+ $ref: "#/components/schemas/trusted_ca_listReplaceResponse",
2494
+ },
2495
+ requiredParams: ["body", "metadata.name", "metadata.namespace"],
2496
+ operationId: "ves.io.schema.trusted_ca_list.API.Replace",
2497
+ tags: ["Other"],
2498
+ sourceFile: "domains/certificates.json",
2499
+ displayName: null,
2500
+ dangerLevel: "medium",
2501
+ sideEffects: {
2502
+ modifies: ["trusted-ca-list"],
2503
+ },
2504
+ requiredFields: ["path.metadata.name", "path.metadata.namespace"],
2505
+ cliExamples: [
2506
+ {
2507
+ command: "f5xcctl config trusted-ca-list update {name} --namespace {namespace} -f {file}.yaml",
2508
+ description: "Update trusted-ca-list",
2509
+ use_case: "update",
2510
+ },
2511
+ ],
2512
+ confirmationRequired: false,
2513
+ parameterExamples: {
2514
+ "metadata.name": "Example-corp-web.",
2515
+ "metadata.namespace": "Staging",
2516
+ },
2517
+ validationRules: {},
2518
+ operationMetadata: {
2519
+ common_errors: [
2520
+ {
2521
+ code: 401,
2522
+ message: "Authentication required",
2523
+ solution: "Provide valid API credentials",
2524
+ },
2525
+ {
2526
+ code: 403,
2527
+ message: "Permission denied",
2528
+ solution: "Check access permissions for this operation",
2529
+ },
2530
+ {
2531
+ code: 404,
2532
+ message: "Resource not found",
2533
+ solution: "Verify resource name, namespace, and path",
2534
+ },
2535
+ {
2536
+ code: 409,
2537
+ message: "Resource already exists",
2538
+ solution: "Use different name or update existing resource",
2539
+ },
2540
+ {
2541
+ code: 429,
2542
+ message: "Rate limit exceeded",
2543
+ solution: "Wait before retrying the operation",
2544
+ },
2545
+ {
2546
+ code: 500,
2547
+ message: "Server error",
2548
+ solution: "Retry operation or contact support",
2549
+ },
2550
+ ],
2551
+ conditions: {
2552
+ postconditions: ["Resource updated with new values"],
2553
+ prerequisites: ["Active namespace"],
2554
+ },
2555
+ confirmation_required: false,
2556
+ danger_level: "medium",
2557
+ examples: [
2558
+ {
2559
+ command: "f5xcctl config trusted-ca-list update {name} --namespace {namespace} -f {file}.yaml",
2560
+ description: "Update trusted-ca-list",
2561
+ use_case: "update",
2562
+ },
2563
+ ],
2564
+ field_docs: {},
2565
+ optional_fields: [],
2566
+ performance_impact: {
2567
+ latency: "low",
2568
+ resource_usage: "low",
2569
+ },
2570
+ purpose: "Replace existing trusted-ca-list",
2571
+ required_fields: ["path.metadata.name", "path.metadata.namespace"],
2572
+ side_effects: {
2573
+ modifies: ["trusted-ca-list"],
2574
+ },
2575
+ },
2576
+ },
2577
+ ];
2578
+ export default certificatesTools;
2579
+ //# sourceMappingURL=index.js.map