@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.
- package/dist/generator/openapi-parser.d.ts +418 -0
- package/dist/generator/openapi-parser.d.ts.map +1 -1
- package/dist/generator/openapi-parser.js +132 -0
- package/dist/generator/openapi-parser.js.map +1 -1
- package/dist/generator/tool-generator.d.ts +29 -1
- package/dist/generator/tool-generator.d.ts.map +1 -1
- package/dist/generator/tool-generator.js +150 -7
- package/dist/generator/tool-generator.js.map +1 -1
- package/dist/tools/discovery/describe.d.ts +1 -0
- package/dist/tools/discovery/describe.d.ts.map +1 -1
- package/dist/tools/discovery/describe.js +10 -8
- package/dist/tools/discovery/describe.js.map +1 -1
- package/dist/tools/generated/admin_console_and_ui/index.d.ts +8 -0
- package/dist/tools/generated/admin_console_and_ui/index.d.ts.map +1 -0
- package/dist/tools/generated/admin_console_and_ui/index.js +285 -0
- package/dist/tools/generated/admin_console_and_ui/index.js.map +1 -0
- package/dist/tools/generated/api/index.d.ts +8 -0
- package/dist/tools/generated/{vpn → api}/index.d.ts.map +1 -1
- package/dist/tools/generated/api/index.js +6668 -0
- package/dist/tools/generated/api/index.js.map +1 -0
- package/dist/tools/generated/authentication/index.d.ts +8 -0
- package/dist/tools/generated/authentication/index.d.ts.map +1 -0
- package/dist/tools/generated/authentication/index.js +1005 -0
- package/dist/tools/generated/authentication/index.js.map +1 -0
- package/dist/tools/generated/bigip/index.d.ts.map +1 -1
- package/dist/tools/generated/bigip/index.js +2045 -0
- package/dist/tools/generated/bigip/index.js.map +1 -1
- package/dist/tools/generated/billing_and_usage/index.d.ts +8 -0
- package/dist/tools/generated/billing_and_usage/index.d.ts.map +1 -0
- package/dist/tools/generated/billing_and_usage/index.js +2702 -0
- package/dist/tools/generated/billing_and_usage/index.js.map +1 -0
- package/dist/tools/generated/blindfold/index.d.ts +8 -0
- package/dist/tools/generated/blindfold/index.d.ts.map +1 -0
- package/dist/tools/generated/blindfold/index.js +3998 -0
- package/dist/tools/generated/blindfold/index.js.map +1 -0
- package/dist/tools/generated/bot_and_threat_defense/index.d.ts +8 -0
- package/dist/tools/generated/bot_and_threat_defense/index.d.ts.map +1 -0
- package/dist/tools/generated/bot_and_threat_defense/index.js +2584 -0
- package/dist/tools/generated/bot_and_threat_defense/index.js.map +1 -0
- package/dist/tools/generated/cdn/index.d.ts.map +1 -1
- package/dist/tools/generated/cdn/index.js +1904 -0
- package/dist/tools/generated/cdn/index.js.map +1 -1
- package/dist/tools/generated/ce_management/index.d.ts +8 -0
- package/dist/tools/generated/ce_management/index.d.ts.map +1 -0
- package/dist/tools/generated/ce_management/index.js +3963 -0
- package/dist/tools/generated/ce_management/index.js.map +1 -0
- package/dist/tools/generated/certificates/index.d.ts +8 -0
- package/dist/tools/generated/certificates/index.d.ts.map +1 -0
- package/dist/tools/generated/certificates/index.js +2579 -0
- package/dist/tools/generated/certificates/index.js.map +1 -0
- package/dist/tools/generated/cloud_infrastructure/index.d.ts +8 -0
- package/dist/tools/generated/cloud_infrastructure/index.d.ts.map +1 -0
- package/dist/tools/generated/cloud_infrastructure/index.js +4124 -0
- package/dist/tools/generated/cloud_infrastructure/index.js.map +1 -0
- package/dist/tools/generated/container_services/index.d.ts +8 -0
- package/dist/tools/generated/container_services/index.d.ts.map +1 -0
- package/dist/tools/generated/container_services/index.js +2054 -0
- package/dist/tools/generated/container_services/index.js.map +1 -0
- package/dist/tools/generated/data_and_privacy_security/index.d.ts +8 -0
- package/dist/tools/generated/data_and_privacy_security/index.d.ts.map +1 -0
- package/dist/tools/generated/data_and_privacy_security/index.js +1708 -0
- package/dist/tools/generated/data_and_privacy_security/index.js.map +1 -0
- package/dist/tools/generated/data_intelligence/index.d.ts +8 -0
- package/dist/tools/generated/data_intelligence/index.d.ts.map +1 -0
- package/dist/tools/generated/data_intelligence/index.js +1770 -0
- package/dist/tools/generated/data_intelligence/index.js.map +1 -0
- package/dist/tools/generated/ddos/index.d.ts +8 -0
- package/dist/tools/generated/ddos/index.d.ts.map +1 -0
- package/dist/tools/generated/ddos/index.js +8511 -0
- package/dist/tools/generated/ddos/index.js.map +1 -0
- package/dist/tools/generated/dns/index.d.ts +8 -0
- package/dist/tools/generated/dns/index.d.ts.map +1 -0
- package/dist/tools/generated/dns/index.js +6460 -0
- package/dist/tools/generated/dns/index.js.map +1 -0
- package/dist/tools/generated/generative_ai/index.d.ts +8 -0
- package/dist/tools/generated/generative_ai/index.d.ts.map +1 -0
- package/dist/tools/generated/generative_ai/index.js +1215 -0
- package/dist/tools/generated/generative_ai/index.js.map +1 -0
- package/dist/tools/generated/managed_kubernetes/index.d.ts +8 -0
- package/dist/tools/generated/managed_kubernetes/index.d.ts.map +1 -0
- package/dist/tools/generated/managed_kubernetes/index.js +3233 -0
- package/dist/tools/generated/managed_kubernetes/index.js.map +1 -0
- package/dist/tools/generated/marketplace/index.d.ts +8 -0
- package/dist/tools/generated/marketplace/index.d.ts.map +1 -0
- package/dist/tools/generated/marketplace/index.js +4580 -0
- package/dist/tools/generated/marketplace/index.js.map +1 -0
- package/dist/tools/generated/network/index.d.ts +8 -0
- package/dist/tools/generated/network/index.d.ts.map +1 -0
- package/dist/tools/generated/network/index.js +12616 -0
- package/dist/tools/generated/network/index.js.map +1 -0
- package/dist/tools/generated/network_security/index.d.ts +8 -0
- package/dist/tools/generated/network_security/index.d.ts.map +1 -0
- package/dist/tools/generated/network_security/index.js +8884 -0
- package/dist/tools/generated/network_security/index.js.map +1 -0
- package/dist/tools/generated/nginx_one/index.d.ts +8 -0
- package/dist/tools/generated/nginx_one/index.d.ts.map +1 -0
- package/dist/tools/generated/nginx_one/index.js +1820 -0
- package/dist/tools/generated/nginx_one/index.js.map +1 -0
- package/dist/tools/generated/object_storage/index.d.ts +8 -0
- package/dist/tools/generated/object_storage/index.d.ts.map +1 -0
- package/dist/tools/generated/object_storage/index.js +1055 -0
- package/dist/tools/generated/object_storage/index.js.map +1 -0
- package/dist/tools/generated/observability/index.d.ts.map +1 -1
- package/dist/tools/generated/observability/index.js +4243 -4618
- package/dist/tools/generated/observability/index.js.map +1 -1
- package/dist/tools/generated/rate_limiting/index.d.ts +8 -0
- package/dist/tools/generated/rate_limiting/index.d.ts.map +1 -0
- package/dist/tools/generated/rate_limiting/index.js +1937 -0
- package/dist/tools/generated/rate_limiting/index.js.map +1 -0
- package/dist/tools/generated/secops_and_incident_response/index.d.ts +8 -0
- package/dist/tools/generated/secops_and_incident_response/index.d.ts.map +1 -0
- package/dist/tools/generated/secops_and_incident_response/index.js +653 -0
- package/dist/tools/generated/secops_and_incident_response/index.js.map +1 -0
- package/dist/tools/generated/service_mesh/index.d.ts.map +1 -1
- package/dist/tools/generated/service_mesh/index.js +4532 -438
- package/dist/tools/generated/service_mesh/index.js.map +1 -1
- package/dist/tools/generated/shape/index.d.ts +8 -0
- package/dist/tools/generated/shape/index.d.ts.map +1 -0
- package/dist/tools/generated/shape/index.js +21784 -0
- package/dist/tools/generated/shape/index.js.map +1 -0
- package/dist/tools/generated/sites/index.d.ts +8 -0
- package/dist/tools/generated/sites/index.d.ts.map +1 -0
- package/dist/tools/generated/sites/index.js +13252 -0
- package/dist/tools/generated/sites/index.js.map +1 -0
- package/dist/tools/generated/statistics/index.d.ts +8 -0
- package/dist/tools/generated/statistics/index.d.ts.map +1 -0
- package/dist/tools/generated/statistics/index.js +8837 -0
- package/dist/tools/generated/statistics/index.js.map +1 -0
- package/dist/tools/generated/support/index.d.ts +8 -0
- package/dist/tools/generated/support/index.d.ts.map +1 -0
- package/dist/tools/generated/support/index.js +6215 -0
- package/dist/tools/generated/support/index.js.map +1 -0
- package/dist/tools/generated/telemetry_and_insights/index.d.ts +8 -0
- package/dist/tools/generated/telemetry_and_insights/index.d.ts.map +1 -0
- package/dist/tools/generated/telemetry_and_insights/index.js +2773 -0
- package/dist/tools/generated/telemetry_and_insights/index.js.map +1 -0
- package/dist/tools/generated/tenant_and_identity/index.d.ts +8 -0
- package/dist/tools/generated/tenant_and_identity/index.d.ts.map +1 -0
- package/dist/tools/generated/tenant_and_identity/index.js +20456 -0
- package/dist/tools/generated/tenant_and_identity/index.js.map +1 -0
- package/dist/tools/generated/threat_campaign/index.d.ts +8 -0
- package/dist/tools/generated/threat_campaign/index.d.ts.map +1 -0
- package/dist/tools/generated/threat_campaign/index.js +112 -0
- package/dist/tools/generated/threat_campaign/index.js.map +1 -0
- package/dist/tools/generated/users/index.d.ts +8 -0
- package/dist/tools/generated/users/index.d.ts.map +1 -0
- package/dist/tools/generated/users/index.js +1572 -0
- package/dist/tools/generated/users/index.js.map +1 -0
- package/dist/tools/generated/virtual/index.d.ts +8 -0
- package/dist/tools/generated/virtual/index.d.ts.map +1 -0
- package/dist/tools/generated/virtual/index.js +11540 -0
- package/dist/tools/generated/virtual/index.js.map +1 -0
- package/dist/tools/generated/vpm_and_node_management/index.d.ts +8 -0
- package/dist/tools/generated/vpm_and_node_management/index.d.ts.map +1 -0
- package/dist/tools/generated/vpm_and_node_management/index.js +98 -0
- package/dist/tools/generated/vpm_and_node_management/index.js.map +1 -0
- package/dist/tools/generated/waf/index.d.ts +8 -0
- package/dist/tools/generated/waf/index.d.ts.map +1 -0
- package/dist/tools/generated/waf/index.js +4440 -0
- package/dist/tools/generated/waf/index.js.map +1 -0
- package/dist/tools/registry.d.ts.map +1 -1
- package/dist/tools/registry.js +68 -36
- package/dist/tools/registry.js.map +1 -1
- package/package.json +3 -1
- package/dist/tools/generated/ai_intelligence/index.d.ts +0 -8
- package/dist/tools/generated/ai_intelligence/index.d.ts.map +0 -1
- package/dist/tools/generated/ai_intelligence/index.js +0 -282
- package/dist/tools/generated/ai_intelligence/index.js.map +0 -1
- package/dist/tools/generated/api_security/index.d.ts +0 -8
- package/dist/tools/generated/api_security/index.d.ts.map +0 -1
- package/dist/tools/generated/api_security/index.js +0 -1852
- package/dist/tools/generated/api_security/index.js.map +0 -1
- package/dist/tools/generated/applications/index.d.ts +0 -8
- package/dist/tools/generated/applications/index.d.ts.map +0 -1
- package/dist/tools/generated/applications/index.js +0 -1589
- package/dist/tools/generated/applications/index.js.map +0 -1
- package/dist/tools/generated/billing/index.d.ts +0 -8
- package/dist/tools/generated/billing/index.d.ts.map +0 -1
- package/dist/tools/generated/billing/index.js +0 -759
- package/dist/tools/generated/billing/index.js.map +0 -1
- package/dist/tools/generated/config/index.d.ts +0 -8
- package/dist/tools/generated/config/index.d.ts.map +0 -1
- package/dist/tools/generated/config/index.js +0 -316
- package/dist/tools/generated/config/index.js.map +0 -1
- package/dist/tools/generated/identity/index.d.ts +0 -8
- package/dist/tools/generated/identity/index.d.ts.map +0 -1
- package/dist/tools/generated/identity/index.js +0 -5371
- package/dist/tools/generated/identity/index.js.map +0 -1
- package/dist/tools/generated/infrastructure/index.d.ts +0 -8
- package/dist/tools/generated/infrastructure/index.d.ts.map +0 -1
- package/dist/tools/generated/infrastructure/index.js +0 -5342
- package/dist/tools/generated/infrastructure/index.js.map +0 -1
- package/dist/tools/generated/infrastructure_protection/index.d.ts +0 -8
- package/dist/tools/generated/infrastructure_protection/index.d.ts.map +0 -1
- package/dist/tools/generated/infrastructure_protection/index.js +0 -2919
- package/dist/tools/generated/infrastructure_protection/index.js.map +0 -1
- package/dist/tools/generated/integrations/index.d.ts +0 -8
- package/dist/tools/generated/integrations/index.d.ts.map +0 -1
- package/dist/tools/generated/integrations/index.js +0 -1995
- package/dist/tools/generated/integrations/index.js.map +0 -1
- package/dist/tools/generated/load_balancer/index.d.ts +0 -8
- package/dist/tools/generated/load_balancer/index.d.ts.map +0 -1
- package/dist/tools/generated/load_balancer/index.js +0 -2269
- package/dist/tools/generated/load_balancer/index.js.map +0 -1
- package/dist/tools/generated/networking/index.d.ts +0 -8
- package/dist/tools/generated/networking/index.d.ts.map +0 -1
- package/dist/tools/generated/networking/index.js +0 -11289
- package/dist/tools/generated/networking/index.js.map +0 -1
- package/dist/tools/generated/nginx/index.d.ts +0 -8
- package/dist/tools/generated/nginx/index.d.ts.map +0 -1
- package/dist/tools/generated/nginx/index.js +0 -680
- package/dist/tools/generated/nginx/index.js.map +0 -1
- package/dist/tools/generated/operations/index.d.ts +0 -8
- package/dist/tools/generated/operations/index.d.ts.map +0 -1
- package/dist/tools/generated/operations/index.js +0 -1759
- package/dist/tools/generated/operations/index.js.map +0 -1
- package/dist/tools/generated/security/index.d.ts +0 -8
- package/dist/tools/generated/security/index.d.ts.map +0 -1
- package/dist/tools/generated/security/index.js +0 -9111
- package/dist/tools/generated/security/index.js.map +0 -1
- package/dist/tools/generated/shape_security/index.d.ts +0 -8
- package/dist/tools/generated/shape_security/index.d.ts.map +0 -1
- package/dist/tools/generated/shape_security/index.js +0 -4121
- package/dist/tools/generated/shape_security/index.js.map +0 -1
- package/dist/tools/generated/subscriptions/index.d.ts +0 -8
- package/dist/tools/generated/subscriptions/index.d.ts.map +0 -1
- package/dist/tools/generated/subscriptions/index.js +0 -778
- package/dist/tools/generated/subscriptions/index.js.map +0 -1
- package/dist/tools/generated/tenant_management/index.d.ts +0 -8
- package/dist/tools/generated/tenant_management/index.d.ts.map +0 -1
- package/dist/tools/generated/tenant_management/index.js +0 -2292
- package/dist/tools/generated/tenant_management/index.js.map +0 -1
- package/dist/tools/generated/vpn/index.d.ts +0 -8
- package/dist/tools/generated/vpn/index.js +0 -1183
- package/dist/tools/generated/vpn/index.js.map +0 -1
|
@@ -0,0 +1,1572 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Generated tool definitions for users domain
|
|
3
|
+
* DO NOT EDIT - This file is auto-generated by scripts/generate.ts
|
|
4
|
+
*/
|
|
5
|
+
export const usersTools = [
|
|
6
|
+
{
|
|
7
|
+
toolName: "f5xc-api-users-create-create",
|
|
8
|
+
method: "POST",
|
|
9
|
+
path: "/api/config/namespaces/{namespace}/known_label/create",
|
|
10
|
+
operation: "create",
|
|
11
|
+
domain: "users",
|
|
12
|
+
resource: "create",
|
|
13
|
+
summary: "Create",
|
|
14
|
+
description: "Create creates a new label in shared namespace. Any other namespace requested will return error.",
|
|
15
|
+
pathParameters: [
|
|
16
|
+
{
|
|
17
|
+
description: "Namespace\nNamespace in which to create the label.",
|
|
18
|
+
in: "path",
|
|
19
|
+
name: "namespace",
|
|
20
|
+
required: true,
|
|
21
|
+
schema: {
|
|
22
|
+
type: "string",
|
|
23
|
+
},
|
|
24
|
+
"x-displayname": "Namespace",
|
|
25
|
+
"x-ves-example": "Value",
|
|
26
|
+
},
|
|
27
|
+
],
|
|
28
|
+
queryParameters: [],
|
|
29
|
+
requestBodySchema: {
|
|
30
|
+
$ref: "#/components/schemas/known_labelCreateRequest",
|
|
31
|
+
},
|
|
32
|
+
responseSchema: {
|
|
33
|
+
$ref: "#/components/schemas/known_labelCreateResponse",
|
|
34
|
+
},
|
|
35
|
+
requiredParams: ["body", "namespace"],
|
|
36
|
+
operationId: "ves.io.schema.known_label.CustomAPI.Create",
|
|
37
|
+
tags: ["Configuration"],
|
|
38
|
+
sourceFile: "domains/users.json",
|
|
39
|
+
displayName: null,
|
|
40
|
+
dangerLevel: "medium",
|
|
41
|
+
sideEffects: {
|
|
42
|
+
creates: ["create"],
|
|
43
|
+
},
|
|
44
|
+
requiredFields: ["metadata.name", "metadata.namespace", "path.namespace"],
|
|
45
|
+
cliExamples: [
|
|
46
|
+
{
|
|
47
|
+
command: "f5xcctl config create create {name} --namespace {namespace}",
|
|
48
|
+
description: "Create create",
|
|
49
|
+
use_case: "basic_create",
|
|
50
|
+
},
|
|
51
|
+
{
|
|
52
|
+
command: "f5xcctl config create create -f {file}.yaml",
|
|
53
|
+
description: "Create from YAML file",
|
|
54
|
+
use_case: "file_based",
|
|
55
|
+
},
|
|
56
|
+
],
|
|
57
|
+
confirmationRequired: false,
|
|
58
|
+
parameterExamples: {
|
|
59
|
+
namespace: "Value",
|
|
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: ["Create resource created", "Resource assigned unique identifier"],
|
|
97
|
+
prerequisites: ["Active namespace"],
|
|
98
|
+
},
|
|
99
|
+
confirmation_required: false,
|
|
100
|
+
danger_level: "medium",
|
|
101
|
+
examples: [
|
|
102
|
+
{
|
|
103
|
+
command: "f5xcctl config create create {name} --namespace {namespace}",
|
|
104
|
+
description: "Create create",
|
|
105
|
+
use_case: "basic_create",
|
|
106
|
+
},
|
|
107
|
+
{
|
|
108
|
+
command: "f5xcctl config create create -f {file}.yaml",
|
|
109
|
+
description: "Create from YAML file",
|
|
110
|
+
use_case: "file_based",
|
|
111
|
+
},
|
|
112
|
+
],
|
|
113
|
+
field_docs: {},
|
|
114
|
+
optional_fields: [],
|
|
115
|
+
performance_impact: {
|
|
116
|
+
latency: "low",
|
|
117
|
+
resource_usage: "low",
|
|
118
|
+
},
|
|
119
|
+
purpose: "Create new create",
|
|
120
|
+
required_fields: ["metadata.name", "metadata.namespace", "path.namespace"],
|
|
121
|
+
side_effects: {
|
|
122
|
+
creates: ["create"],
|
|
123
|
+
},
|
|
124
|
+
},
|
|
125
|
+
},
|
|
126
|
+
{
|
|
127
|
+
toolName: "f5xc-api-users-delete-create",
|
|
128
|
+
method: "POST",
|
|
129
|
+
path: "/api/config/namespaces/{namespace}/known_label/delete",
|
|
130
|
+
operation: "create",
|
|
131
|
+
domain: "users",
|
|
132
|
+
resource: "delete",
|
|
133
|
+
summary: "DELETE",
|
|
134
|
+
description: "DELETE will DELETE a given label label key = label value from current tenants shared namespace.",
|
|
135
|
+
pathParameters: [
|
|
136
|
+
{
|
|
137
|
+
description: "Namespace\nNamespace of the label to be deleted.",
|
|
138
|
+
in: "path",
|
|
139
|
+
name: "namespace",
|
|
140
|
+
required: true,
|
|
141
|
+
schema: {
|
|
142
|
+
type: "string",
|
|
143
|
+
},
|
|
144
|
+
"x-displayname": "Namespace",
|
|
145
|
+
"x-ves-example": "Value",
|
|
146
|
+
},
|
|
147
|
+
],
|
|
148
|
+
queryParameters: [],
|
|
149
|
+
requestBodySchema: {
|
|
150
|
+
$ref: "#/components/schemas/known_labelDeleteRequest",
|
|
151
|
+
},
|
|
152
|
+
responseSchema: {
|
|
153
|
+
$ref: "#/components/schemas/known_labelDeleteResponse",
|
|
154
|
+
},
|
|
155
|
+
requiredParams: ["body", "namespace"],
|
|
156
|
+
operationId: "ves.io.schema.known_label.CustomAPI.Delete",
|
|
157
|
+
tags: ["Configuration"],
|
|
158
|
+
sourceFile: "domains/users.json",
|
|
159
|
+
displayName: null,
|
|
160
|
+
dangerLevel: "medium",
|
|
161
|
+
sideEffects: {
|
|
162
|
+
creates: ["delete"],
|
|
163
|
+
},
|
|
164
|
+
requiredFields: ["metadata.name", "metadata.namespace", "path.namespace"],
|
|
165
|
+
cliExamples: [
|
|
166
|
+
{
|
|
167
|
+
command: "f5xcctl config delete create {name} --namespace {namespace}",
|
|
168
|
+
description: "Create delete",
|
|
169
|
+
use_case: "basic_create",
|
|
170
|
+
},
|
|
171
|
+
{
|
|
172
|
+
command: "f5xcctl config delete create -f {file}.yaml",
|
|
173
|
+
description: "Create from YAML file",
|
|
174
|
+
use_case: "file_based",
|
|
175
|
+
},
|
|
176
|
+
],
|
|
177
|
+
confirmationRequired: false,
|
|
178
|
+
parameterExamples: {
|
|
179
|
+
namespace: "Value",
|
|
180
|
+
},
|
|
181
|
+
validationRules: {},
|
|
182
|
+
operationMetadata: {
|
|
183
|
+
common_errors: [
|
|
184
|
+
{
|
|
185
|
+
code: 401,
|
|
186
|
+
message: "Authentication required",
|
|
187
|
+
solution: "Provide valid API credentials",
|
|
188
|
+
},
|
|
189
|
+
{
|
|
190
|
+
code: 403,
|
|
191
|
+
message: "Permission denied",
|
|
192
|
+
solution: "Check access permissions for this operation",
|
|
193
|
+
},
|
|
194
|
+
{
|
|
195
|
+
code: 404,
|
|
196
|
+
message: "Resource not found",
|
|
197
|
+
solution: "Verify resource name, namespace, and path",
|
|
198
|
+
},
|
|
199
|
+
{
|
|
200
|
+
code: 409,
|
|
201
|
+
message: "Resource already exists",
|
|
202
|
+
solution: "Use different name or update existing resource",
|
|
203
|
+
},
|
|
204
|
+
{
|
|
205
|
+
code: 429,
|
|
206
|
+
message: "Rate limit exceeded",
|
|
207
|
+
solution: "Wait before retrying the operation",
|
|
208
|
+
},
|
|
209
|
+
{
|
|
210
|
+
code: 500,
|
|
211
|
+
message: "Server error",
|
|
212
|
+
solution: "Retry operation or contact support",
|
|
213
|
+
},
|
|
214
|
+
],
|
|
215
|
+
conditions: {
|
|
216
|
+
postconditions: ["Delete resource created", "Resource assigned unique identifier"],
|
|
217
|
+
prerequisites: ["Active namespace"],
|
|
218
|
+
},
|
|
219
|
+
confirmation_required: false,
|
|
220
|
+
danger_level: "medium",
|
|
221
|
+
examples: [
|
|
222
|
+
{
|
|
223
|
+
command: "f5xcctl config delete create {name} --namespace {namespace}",
|
|
224
|
+
description: "Create delete",
|
|
225
|
+
use_case: "basic_create",
|
|
226
|
+
},
|
|
227
|
+
{
|
|
228
|
+
command: "f5xcctl config delete create -f {file}.yaml",
|
|
229
|
+
description: "Create from YAML file",
|
|
230
|
+
use_case: "file_based",
|
|
231
|
+
},
|
|
232
|
+
],
|
|
233
|
+
field_docs: {},
|
|
234
|
+
optional_fields: [],
|
|
235
|
+
performance_impact: {
|
|
236
|
+
latency: "low",
|
|
237
|
+
resource_usage: "low",
|
|
238
|
+
},
|
|
239
|
+
purpose: "Create new delete",
|
|
240
|
+
required_fields: ["metadata.name", "metadata.namespace", "path.namespace"],
|
|
241
|
+
side_effects: {
|
|
242
|
+
creates: ["delete"],
|
|
243
|
+
},
|
|
244
|
+
},
|
|
245
|
+
},
|
|
246
|
+
{
|
|
247
|
+
toolName: "f5xc-api-users-get-cloud-init-config-list",
|
|
248
|
+
method: "GET",
|
|
249
|
+
path: "/api/register/namespaces/system/get-cloud-init-config",
|
|
250
|
+
operation: "list",
|
|
251
|
+
domain: "users",
|
|
252
|
+
resource: "get-cloud-init-config",
|
|
253
|
+
summary: "GET Cloud Init Config.",
|
|
254
|
+
description: "Returns cloud-init counfig for kvm provider with JWT token.",
|
|
255
|
+
pathParameters: [],
|
|
256
|
+
queryParameters: [
|
|
257
|
+
{
|
|
258
|
+
description: "Provider for that cloud-init config.",
|
|
259
|
+
in: "query",
|
|
260
|
+
name: "provider",
|
|
261
|
+
required: false,
|
|
262
|
+
schema: {
|
|
263
|
+
type: "string",
|
|
264
|
+
},
|
|
265
|
+
"x-displayname": "Provider",
|
|
266
|
+
"x-ves-example": "Kvm",
|
|
267
|
+
},
|
|
268
|
+
{
|
|
269
|
+
description: "Site name for this cloud-init config.",
|
|
270
|
+
in: "query",
|
|
271
|
+
name: "site_name",
|
|
272
|
+
required: false,
|
|
273
|
+
schema: {
|
|
274
|
+
type: "string",
|
|
275
|
+
},
|
|
276
|
+
"x-displayname": "Site Name",
|
|
277
|
+
},
|
|
278
|
+
],
|
|
279
|
+
requestBodySchema: null,
|
|
280
|
+
responseSchema: {
|
|
281
|
+
$ref: "#/components/schemas/tokenGetCloudInitConfigResp",
|
|
282
|
+
},
|
|
283
|
+
requiredParams: [],
|
|
284
|
+
operationId: "ves.io.schema.token.CustomAPI.GetCloudInitConfig",
|
|
285
|
+
tags: ["Other"],
|
|
286
|
+
sourceFile: "domains/users.json",
|
|
287
|
+
displayName: null,
|
|
288
|
+
dangerLevel: "low",
|
|
289
|
+
sideEffects: null,
|
|
290
|
+
requiredFields: [],
|
|
291
|
+
cliExamples: [
|
|
292
|
+
{
|
|
293
|
+
command: "f5xcctl register get-cloud-init-config list --namespace {namespace}",
|
|
294
|
+
description: "List all get-cloud-init-configs",
|
|
295
|
+
use_case: "list_all",
|
|
296
|
+
},
|
|
297
|
+
],
|
|
298
|
+
confirmationRequired: false,
|
|
299
|
+
parameterExamples: {
|
|
300
|
+
provider: "Kvm",
|
|
301
|
+
},
|
|
302
|
+
validationRules: {},
|
|
303
|
+
operationMetadata: {
|
|
304
|
+
common_errors: [
|
|
305
|
+
{
|
|
306
|
+
code: 401,
|
|
307
|
+
message: "Authentication required",
|
|
308
|
+
solution: "Provide valid API credentials",
|
|
309
|
+
},
|
|
310
|
+
{
|
|
311
|
+
code: 403,
|
|
312
|
+
message: "Permission denied",
|
|
313
|
+
solution: "Check access permissions for this operation",
|
|
314
|
+
},
|
|
315
|
+
{
|
|
316
|
+
code: 404,
|
|
317
|
+
message: "Resource not found",
|
|
318
|
+
solution: "Verify resource name, namespace, and path",
|
|
319
|
+
},
|
|
320
|
+
{
|
|
321
|
+
code: 409,
|
|
322
|
+
message: "Resource already exists",
|
|
323
|
+
solution: "Use different name or update existing resource",
|
|
324
|
+
},
|
|
325
|
+
{
|
|
326
|
+
code: 429,
|
|
327
|
+
message: "Rate limit exceeded",
|
|
328
|
+
solution: "Wait before retrying the operation",
|
|
329
|
+
},
|
|
330
|
+
{
|
|
331
|
+
code: 500,
|
|
332
|
+
message: "Server error",
|
|
333
|
+
solution: "Retry operation or contact support",
|
|
334
|
+
},
|
|
335
|
+
],
|
|
336
|
+
conditions: {
|
|
337
|
+
postconditions: [],
|
|
338
|
+
prerequisites: ["Active namespace"],
|
|
339
|
+
},
|
|
340
|
+
confirmation_required: false,
|
|
341
|
+
danger_level: "low",
|
|
342
|
+
examples: [
|
|
343
|
+
{
|
|
344
|
+
command: "f5xcctl register get-cloud-init-config list --namespace {namespace}",
|
|
345
|
+
description: "List all get-cloud-init-configs",
|
|
346
|
+
use_case: "list_all",
|
|
347
|
+
},
|
|
348
|
+
],
|
|
349
|
+
field_docs: {},
|
|
350
|
+
optional_fields: [],
|
|
351
|
+
performance_impact: {
|
|
352
|
+
latency: "moderate",
|
|
353
|
+
resource_usage: "moderate",
|
|
354
|
+
},
|
|
355
|
+
purpose: "List all get-cloud-init-configs",
|
|
356
|
+
required_fields: [],
|
|
357
|
+
side_effects: {},
|
|
358
|
+
},
|
|
359
|
+
},
|
|
360
|
+
{
|
|
361
|
+
toolName: "f5xc-api-users-implicit-label-list",
|
|
362
|
+
method: "GET",
|
|
363
|
+
path: "/api/config/namespaces/system/implicit_labels",
|
|
364
|
+
operation: "list",
|
|
365
|
+
domain: "users",
|
|
366
|
+
resource: "implicit-label",
|
|
367
|
+
summary: "GET Implicit Labels.",
|
|
368
|
+
description: "GET is generic label query. Two types of queries are supported\n* Return label with exact matching entry label key = label value.\n* Return list of labels that have prefix of label key = label value.\nReturns list of labels. Query will look into current tenants shared namespace and VES-I/O shared.",
|
|
369
|
+
pathParameters: [],
|
|
370
|
+
queryParameters: [
|
|
371
|
+
{
|
|
372
|
+
description: "Key string in Query parameters.",
|
|
373
|
+
in: "query",
|
|
374
|
+
name: "key",
|
|
375
|
+
required: false,
|
|
376
|
+
schema: {
|
|
377
|
+
type: "string",
|
|
378
|
+
},
|
|
379
|
+
"x-displayname": "Key",
|
|
380
|
+
"x-ves-example": "Value",
|
|
381
|
+
},
|
|
382
|
+
{
|
|
383
|
+
description: 'Key classes\n\nIncludes label keys with generic names such as "example-key", "foobar-key" etc.\nKeys that are obtained using GET on /API/config/configconfigconfigconfigconfigconfigconfigconfigconfigconfigconfigconfigconfigconfigconfigconfigconfigconfigconfigconfigconfigconfigconfigconfigconfigconfigconfigconfignamespaces/shared/known_label_keys\nIncludes F5 Distributed Cloud-defined known label keys such as "F5 XC/app_type", "F5 XC/app" and "F5 XC/siteType" as well as tenant-defined known keys such as\n"example-key", "acme-key-foo" and "acme-key-bar". Note that tenant-defined known keys don\'t have any standard name format - they are known keys because they\nhave been explicitly created as known keys by the tenant and are stored in the configuration as known_label_keys.\nIncludes implicit geoip label keys "geoip.F5 XC/city", "geoip.F5 XC/region" and "geoip.F5 XC/country"\nIncludes implicit label keys associated with packets/requests by the infrastructure e.g. "implicit.F5 XC/namespace"\nInclude IP reputation label keys "ipreputation.F5 XC/threattype", "ipreputation.F5 XC/threatlevel"\nInclude URL reputation label keys "urlreputation.F5 XC/category", "urlreputation.F5 XC/reputationlevel"\nIncludes implicit geoip label keys "geoip.F5 XC/continent"\nIncludes implicit geoip label keys "geoip.F5 XC/region", "geoip.F5 XC/country" and "geoip.F5 XC/continent"\nImplicit AWS resource labels (dynamically queried). This may be VPC level tags and/or subnet level tags.',
|
|
384
|
+
in: "query",
|
|
385
|
+
name: "key_classes",
|
|
386
|
+
required: false,
|
|
387
|
+
schema: {
|
|
388
|
+
items: {
|
|
389
|
+
enum: [
|
|
390
|
+
"KEY_CLASS_GENERIC",
|
|
391
|
+
"KEY_CLASS_KNOWN",
|
|
392
|
+
"KEY_CLASS_GEOIP",
|
|
393
|
+
"KEY_CLASS_IMPLICIT",
|
|
394
|
+
"KEY_CLASS_IP_REPUTATION",
|
|
395
|
+
"KEY_CLASS_URL_REPUTATION",
|
|
396
|
+
"KEY_CLASS_GEOIP_EXTENDED",
|
|
397
|
+
"KEY_CLASS_DNS_GEOIP",
|
|
398
|
+
"KEY_CLASS_AWS",
|
|
399
|
+
],
|
|
400
|
+
type: "string",
|
|
401
|
+
},
|
|
402
|
+
type: "array",
|
|
403
|
+
},
|
|
404
|
+
"x-displayname": "Key Class AWS.",
|
|
405
|
+
"x-ves-example": "Key classes.",
|
|
406
|
+
},
|
|
407
|
+
{
|
|
408
|
+
description: "Type of Query\n\nGET all available implicit labels\nGET exact match of label.key = label.value Or label.key(label.value)\nGET prefix match of label.key = label.value\nGET list of all keys\nGET list of all labels that exactly match the given key and substring match either 'value' or description provided in 'value' field\nGET list of all keys matching a substring.",
|
|
409
|
+
in: "query",
|
|
410
|
+
name: "query",
|
|
411
|
+
required: false,
|
|
412
|
+
schema: {
|
|
413
|
+
default: "QUERY_ALL_LABELS",
|
|
414
|
+
enum: [
|
|
415
|
+
"QUERY_ALL_LABELS",
|
|
416
|
+
"QUERY_EXACT_LABEL",
|
|
417
|
+
"QUERY_VALUE_PREFIX_LABELS",
|
|
418
|
+
"QUERY_KEYS_ONLY",
|
|
419
|
+
"QUERY_VALUE_OR_DESCRIPTION_SUBSTRING",
|
|
420
|
+
"QUERY_KEY_SUBSTRING",
|
|
421
|
+
],
|
|
422
|
+
type: "string",
|
|
423
|
+
},
|
|
424
|
+
"x-displayname": "Key Substring.",
|
|
425
|
+
},
|
|
426
|
+
{
|
|
427
|
+
description: "Value string in Query parameters.",
|
|
428
|
+
in: "query",
|
|
429
|
+
name: "value",
|
|
430
|
+
required: false,
|
|
431
|
+
schema: {
|
|
432
|
+
type: "string",
|
|
433
|
+
},
|
|
434
|
+
"x-displayname": "Value",
|
|
435
|
+
"x-ves-example": "Value",
|
|
436
|
+
},
|
|
437
|
+
],
|
|
438
|
+
requestBodySchema: null,
|
|
439
|
+
responseSchema: {
|
|
440
|
+
$ref: "#/components/schemas/implicit_labelGetResponse",
|
|
441
|
+
},
|
|
442
|
+
requiredParams: [],
|
|
443
|
+
operationId: "ves.io.schema.implicit_label.CustomAPI.Get",
|
|
444
|
+
tags: ["Other"],
|
|
445
|
+
sourceFile: "domains/users.json",
|
|
446
|
+
displayName: null,
|
|
447
|
+
dangerLevel: "low",
|
|
448
|
+
sideEffects: null,
|
|
449
|
+
requiredFields: [],
|
|
450
|
+
cliExamples: [
|
|
451
|
+
{
|
|
452
|
+
command: "f5xcctl config implicit-label list --namespace {namespace}",
|
|
453
|
+
description: "List all implicit-labels",
|
|
454
|
+
use_case: "list_all",
|
|
455
|
+
},
|
|
456
|
+
],
|
|
457
|
+
confirmationRequired: false,
|
|
458
|
+
parameterExamples: {
|
|
459
|
+
key: "Value",
|
|
460
|
+
key_classes: "Key classes.",
|
|
461
|
+
value: "Value",
|
|
462
|
+
},
|
|
463
|
+
validationRules: {},
|
|
464
|
+
operationMetadata: {
|
|
465
|
+
common_errors: [
|
|
466
|
+
{
|
|
467
|
+
code: 401,
|
|
468
|
+
message: "Authentication required",
|
|
469
|
+
solution: "Provide valid API credentials",
|
|
470
|
+
},
|
|
471
|
+
{
|
|
472
|
+
code: 403,
|
|
473
|
+
message: "Permission denied",
|
|
474
|
+
solution: "Check access permissions for this operation",
|
|
475
|
+
},
|
|
476
|
+
{
|
|
477
|
+
code: 404,
|
|
478
|
+
message: "Resource not found",
|
|
479
|
+
solution: "Verify resource name, namespace, and path",
|
|
480
|
+
},
|
|
481
|
+
{
|
|
482
|
+
code: 409,
|
|
483
|
+
message: "Resource already exists",
|
|
484
|
+
solution: "Use different name or update existing resource",
|
|
485
|
+
},
|
|
486
|
+
{
|
|
487
|
+
code: 429,
|
|
488
|
+
message: "Rate limit exceeded",
|
|
489
|
+
solution: "Wait before retrying the operation",
|
|
490
|
+
},
|
|
491
|
+
{
|
|
492
|
+
code: 500,
|
|
493
|
+
message: "Server error",
|
|
494
|
+
solution: "Retry operation or contact support",
|
|
495
|
+
},
|
|
496
|
+
],
|
|
497
|
+
conditions: {
|
|
498
|
+
postconditions: [],
|
|
499
|
+
prerequisites: ["Active namespace"],
|
|
500
|
+
},
|
|
501
|
+
confirmation_required: false,
|
|
502
|
+
danger_level: "low",
|
|
503
|
+
examples: [
|
|
504
|
+
{
|
|
505
|
+
command: "f5xcctl config implicit-label list --namespace {namespace}",
|
|
506
|
+
description: "List all implicit-labels",
|
|
507
|
+
use_case: "list_all",
|
|
508
|
+
},
|
|
509
|
+
],
|
|
510
|
+
field_docs: {},
|
|
511
|
+
optional_fields: [],
|
|
512
|
+
performance_impact: {
|
|
513
|
+
latency: "moderate",
|
|
514
|
+
resource_usage: "moderate",
|
|
515
|
+
},
|
|
516
|
+
purpose: "List all implicit-labels",
|
|
517
|
+
required_fields: [],
|
|
518
|
+
side_effects: {},
|
|
519
|
+
},
|
|
520
|
+
},
|
|
521
|
+
{
|
|
522
|
+
toolName: "f5xc-api-users-known-label-key-list",
|
|
523
|
+
method: "GET",
|
|
524
|
+
path: "/api/config/namespaces/{namespace}/known_label_keys",
|
|
525
|
+
operation: "list",
|
|
526
|
+
domain: "users",
|
|
527
|
+
resource: "known-label-key",
|
|
528
|
+
summary: "GET",
|
|
529
|
+
description: "GET is generic label key query. Two types of queries are supported\nReturn label with exact matching entry label key.\nReturn list of labels that have prefix of label key .\nReturns list of label keys. Query will look into current tenants shared namespace and VES-I/O shared.",
|
|
530
|
+
pathParameters: [
|
|
531
|
+
{
|
|
532
|
+
description: "Namespace\nNamespace in which to retrieve the label key.",
|
|
533
|
+
in: "path",
|
|
534
|
+
name: "namespace",
|
|
535
|
+
required: true,
|
|
536
|
+
schema: {
|
|
537
|
+
type: "string",
|
|
538
|
+
},
|
|
539
|
+
"x-displayname": "Namespace",
|
|
540
|
+
"x-ves-example": "Value",
|
|
541
|
+
},
|
|
542
|
+
],
|
|
543
|
+
queryParameters: [
|
|
544
|
+
{
|
|
545
|
+
description: "Key to retrieve.",
|
|
546
|
+
in: "query",
|
|
547
|
+
name: "key",
|
|
548
|
+
required: false,
|
|
549
|
+
schema: {
|
|
550
|
+
type: "string",
|
|
551
|
+
},
|
|
552
|
+
"x-displayname": "Key",
|
|
553
|
+
"x-ves-example": "Value",
|
|
554
|
+
},
|
|
555
|
+
{
|
|
556
|
+
description: "Query Type\n\nGeneric GET of all available labels for a given tenant\nGET exact match of label.key = label.value Or label.key(label.value)\nGET prefix match of label.key.",
|
|
557
|
+
in: "query",
|
|
558
|
+
name: "query",
|
|
559
|
+
required: false,
|
|
560
|
+
schema: {
|
|
561
|
+
default: "QUERY_ALL_LABEL_KEYS",
|
|
562
|
+
enum: ["QUERY_ALL_LABEL_KEYS", "QUERY_EXACT_LABEL_KEY", "QUERY_PREFIX_LABEL_KEYS"],
|
|
563
|
+
type: "string",
|
|
564
|
+
},
|
|
565
|
+
"x-displayname": "Label Key Prefix.",
|
|
566
|
+
},
|
|
567
|
+
],
|
|
568
|
+
requestBodySchema: null,
|
|
569
|
+
responseSchema: {
|
|
570
|
+
$ref: "#/components/schemas/known_label_keyGetResponse",
|
|
571
|
+
},
|
|
572
|
+
requiredParams: ["namespace"],
|
|
573
|
+
operationId: "ves.io.schema.known_label_key.CustomAPI.Get",
|
|
574
|
+
tags: ["Other"],
|
|
575
|
+
sourceFile: "domains/users.json",
|
|
576
|
+
displayName: null,
|
|
577
|
+
dangerLevel: "low",
|
|
578
|
+
sideEffects: null,
|
|
579
|
+
requiredFields: ["path.namespace"],
|
|
580
|
+
cliExamples: [
|
|
581
|
+
{
|
|
582
|
+
command: "f5xcctl config known-label-key list --namespace {namespace}",
|
|
583
|
+
description: "List all known-label-keys",
|
|
584
|
+
use_case: "list_all",
|
|
585
|
+
},
|
|
586
|
+
],
|
|
587
|
+
confirmationRequired: false,
|
|
588
|
+
parameterExamples: {
|
|
589
|
+
key: "Value",
|
|
590
|
+
namespace: "Value",
|
|
591
|
+
},
|
|
592
|
+
validationRules: {},
|
|
593
|
+
operationMetadata: {
|
|
594
|
+
common_errors: [
|
|
595
|
+
{
|
|
596
|
+
code: 401,
|
|
597
|
+
message: "Authentication required",
|
|
598
|
+
solution: "Provide valid API credentials",
|
|
599
|
+
},
|
|
600
|
+
{
|
|
601
|
+
code: 403,
|
|
602
|
+
message: "Permission denied",
|
|
603
|
+
solution: "Check access permissions for this operation",
|
|
604
|
+
},
|
|
605
|
+
{
|
|
606
|
+
code: 404,
|
|
607
|
+
message: "Resource not found",
|
|
608
|
+
solution: "Verify resource name, namespace, and path",
|
|
609
|
+
},
|
|
610
|
+
{
|
|
611
|
+
code: 409,
|
|
612
|
+
message: "Resource already exists",
|
|
613
|
+
solution: "Use different name or update existing resource",
|
|
614
|
+
},
|
|
615
|
+
{
|
|
616
|
+
code: 429,
|
|
617
|
+
message: "Rate limit exceeded",
|
|
618
|
+
solution: "Wait before retrying the operation",
|
|
619
|
+
},
|
|
620
|
+
{
|
|
621
|
+
code: 500,
|
|
622
|
+
message: "Server error",
|
|
623
|
+
solution: "Retry operation or contact support",
|
|
624
|
+
},
|
|
625
|
+
],
|
|
626
|
+
conditions: {
|
|
627
|
+
postconditions: [],
|
|
628
|
+
prerequisites: ["Active namespace"],
|
|
629
|
+
},
|
|
630
|
+
confirmation_required: false,
|
|
631
|
+
danger_level: "low",
|
|
632
|
+
examples: [
|
|
633
|
+
{
|
|
634
|
+
command: "f5xcctl config known-label-key list --namespace {namespace}",
|
|
635
|
+
description: "List all known-label-keys",
|
|
636
|
+
use_case: "list_all",
|
|
637
|
+
},
|
|
638
|
+
],
|
|
639
|
+
field_docs: {},
|
|
640
|
+
optional_fields: [],
|
|
641
|
+
performance_impact: {
|
|
642
|
+
latency: "moderate",
|
|
643
|
+
resource_usage: "moderate",
|
|
644
|
+
},
|
|
645
|
+
purpose: "List all known-label-keys",
|
|
646
|
+
required_fields: ["path.namespace"],
|
|
647
|
+
side_effects: {},
|
|
648
|
+
},
|
|
649
|
+
},
|
|
650
|
+
{
|
|
651
|
+
toolName: "f5xc-api-users-known-label-list",
|
|
652
|
+
method: "GET",
|
|
653
|
+
path: "/api/config/namespaces/{namespace}/known_labels",
|
|
654
|
+
operation: "list",
|
|
655
|
+
domain: "users",
|
|
656
|
+
resource: "known-label",
|
|
657
|
+
summary: "GET",
|
|
658
|
+
description: "GET is generic label query. Two types of queries are supported\nReturn label with exact matching entry label key = label value.\nReturn list of labels that have prefix of label key = label value.\nReturns list of labels. Query will look into current tenants shared namespace and VES-I/O shared.",
|
|
659
|
+
pathParameters: [
|
|
660
|
+
{
|
|
661
|
+
description: "Namespace\nNamespace for the label to be retrieved.",
|
|
662
|
+
in: "path",
|
|
663
|
+
name: "namespace",
|
|
664
|
+
required: true,
|
|
665
|
+
schema: {
|
|
666
|
+
type: "string",
|
|
667
|
+
},
|
|
668
|
+
"x-displayname": "Namespace",
|
|
669
|
+
"x-ves-example": "Value",
|
|
670
|
+
},
|
|
671
|
+
],
|
|
672
|
+
queryParameters: [
|
|
673
|
+
{
|
|
674
|
+
description: "Key of the label to be retrieved.",
|
|
675
|
+
in: "query",
|
|
676
|
+
name: "key",
|
|
677
|
+
required: false,
|
|
678
|
+
schema: {
|
|
679
|
+
type: "string",
|
|
680
|
+
},
|
|
681
|
+
"x-displayname": "Key",
|
|
682
|
+
"x-ves-example": "F5 XC/region.",
|
|
683
|
+
},
|
|
684
|
+
{
|
|
685
|
+
description: "Query type\n\nGeneric GET of all available labels for a given tenant\nGET exact match of label.key = label.value Or label.key(label.value)\nGET prefix match of label.key = label.value\nGET prefix match of label.key.",
|
|
686
|
+
in: "query",
|
|
687
|
+
name: "query",
|
|
688
|
+
required: false,
|
|
689
|
+
schema: {
|
|
690
|
+
default: "QUERY_ALL_LABELS",
|
|
691
|
+
enum: [
|
|
692
|
+
"QUERY_ALL_LABELS",
|
|
693
|
+
"QUERY_EXACT_LABEL",
|
|
694
|
+
"QUERY_VALUE_PREFIX_LABELS",
|
|
695
|
+
"QUERY_KEY_PREFIX_LABELS",
|
|
696
|
+
],
|
|
697
|
+
type: "string",
|
|
698
|
+
},
|
|
699
|
+
"x-displayname": "Label Key Prefix.",
|
|
700
|
+
},
|
|
701
|
+
{
|
|
702
|
+
description: "Value of the label to be retrieved.",
|
|
703
|
+
in: "query",
|
|
704
|
+
name: "value",
|
|
705
|
+
required: false,
|
|
706
|
+
schema: {
|
|
707
|
+
type: "string",
|
|
708
|
+
},
|
|
709
|
+
"x-displayname": "Value",
|
|
710
|
+
"x-ves-example": "VES-I/O-par.",
|
|
711
|
+
},
|
|
712
|
+
],
|
|
713
|
+
requestBodySchema: null,
|
|
714
|
+
responseSchema: {
|
|
715
|
+
$ref: "#/components/schemas/known_labelGetResponse",
|
|
716
|
+
},
|
|
717
|
+
requiredParams: ["namespace"],
|
|
718
|
+
operationId: "ves.io.schema.known_label.CustomAPI.Get",
|
|
719
|
+
tags: ["Other"],
|
|
720
|
+
sourceFile: "domains/users.json",
|
|
721
|
+
displayName: null,
|
|
722
|
+
dangerLevel: "low",
|
|
723
|
+
sideEffects: null,
|
|
724
|
+
requiredFields: ["path.namespace"],
|
|
725
|
+
cliExamples: [
|
|
726
|
+
{
|
|
727
|
+
command: "f5xcctl config known-label list --namespace {namespace}",
|
|
728
|
+
description: "List all known-labels",
|
|
729
|
+
use_case: "list_all",
|
|
730
|
+
},
|
|
731
|
+
],
|
|
732
|
+
confirmationRequired: false,
|
|
733
|
+
parameterExamples: {
|
|
734
|
+
key: "F5 XC/region.",
|
|
735
|
+
namespace: "Value",
|
|
736
|
+
value: "VES-I/O-par.",
|
|
737
|
+
},
|
|
738
|
+
validationRules: {},
|
|
739
|
+
operationMetadata: {
|
|
740
|
+
common_errors: [
|
|
741
|
+
{
|
|
742
|
+
code: 401,
|
|
743
|
+
message: "Authentication required",
|
|
744
|
+
solution: "Provide valid API credentials",
|
|
745
|
+
},
|
|
746
|
+
{
|
|
747
|
+
code: 403,
|
|
748
|
+
message: "Permission denied",
|
|
749
|
+
solution: "Check access permissions for this operation",
|
|
750
|
+
},
|
|
751
|
+
{
|
|
752
|
+
code: 404,
|
|
753
|
+
message: "Resource not found",
|
|
754
|
+
solution: "Verify resource name, namespace, and path",
|
|
755
|
+
},
|
|
756
|
+
{
|
|
757
|
+
code: 409,
|
|
758
|
+
message: "Resource already exists",
|
|
759
|
+
solution: "Use different name or update existing resource",
|
|
760
|
+
},
|
|
761
|
+
{
|
|
762
|
+
code: 429,
|
|
763
|
+
message: "Rate limit exceeded",
|
|
764
|
+
solution: "Wait before retrying the operation",
|
|
765
|
+
},
|
|
766
|
+
{
|
|
767
|
+
code: 500,
|
|
768
|
+
message: "Server error",
|
|
769
|
+
solution: "Retry operation or contact support",
|
|
770
|
+
},
|
|
771
|
+
],
|
|
772
|
+
conditions: {
|
|
773
|
+
postconditions: [],
|
|
774
|
+
prerequisites: ["Active namespace"],
|
|
775
|
+
},
|
|
776
|
+
confirmation_required: false,
|
|
777
|
+
danger_level: "low",
|
|
778
|
+
examples: [
|
|
779
|
+
{
|
|
780
|
+
command: "f5xcctl config known-label list --namespace {namespace}",
|
|
781
|
+
description: "List all known-labels",
|
|
782
|
+
use_case: "list_all",
|
|
783
|
+
},
|
|
784
|
+
],
|
|
785
|
+
field_docs: {},
|
|
786
|
+
optional_fields: [],
|
|
787
|
+
performance_impact: {
|
|
788
|
+
latency: "moderate",
|
|
789
|
+
resource_usage: "moderate",
|
|
790
|
+
},
|
|
791
|
+
purpose: "List all known-labels",
|
|
792
|
+
required_fields: ["path.namespace"],
|
|
793
|
+
side_effects: {},
|
|
794
|
+
},
|
|
795
|
+
},
|
|
796
|
+
{
|
|
797
|
+
toolName: "f5xc-api-users-state-create",
|
|
798
|
+
method: "POST",
|
|
799
|
+
path: "/api/register/namespaces/{namespace}/tokens/{name}/state",
|
|
800
|
+
operation: "create",
|
|
801
|
+
domain: "users",
|
|
802
|
+
resource: "state",
|
|
803
|
+
summary: "Set Token State.",
|
|
804
|
+
description: "TokenState changes token status, it can be used to disable token.",
|
|
805
|
+
pathParameters: [
|
|
806
|
+
{
|
|
807
|
+
description: "Token name\nToken object name to change, it's usually same as metadata.uid.",
|
|
808
|
+
in: "path",
|
|
809
|
+
name: "name",
|
|
810
|
+
required: true,
|
|
811
|
+
schema: {
|
|
812
|
+
type: "string",
|
|
813
|
+
},
|
|
814
|
+
"x-displayname": "Name",
|
|
815
|
+
"x-ves-example": "Value",
|
|
816
|
+
},
|
|
817
|
+
{
|
|
818
|
+
description: "Token namespace\nNamespace where token is residing.",
|
|
819
|
+
in: "path",
|
|
820
|
+
name: "namespace",
|
|
821
|
+
required: true,
|
|
822
|
+
schema: {
|
|
823
|
+
type: "string",
|
|
824
|
+
},
|
|
825
|
+
"x-displayname": "Namespace",
|
|
826
|
+
"x-ves-example": "Value",
|
|
827
|
+
},
|
|
828
|
+
],
|
|
829
|
+
queryParameters: [],
|
|
830
|
+
requestBodySchema: {
|
|
831
|
+
$ref: "#/components/schemas/tokenStateReq",
|
|
832
|
+
},
|
|
833
|
+
responseSchema: {
|
|
834
|
+
$ref: "#/components/schemas/tokenObjectChangeResp",
|
|
835
|
+
},
|
|
836
|
+
requiredParams: ["body", "name", "namespace"],
|
|
837
|
+
operationId: "ves.io.schema.token.CustomAPI.TokenState",
|
|
838
|
+
tags: ["Other"],
|
|
839
|
+
sourceFile: "domains/users.json",
|
|
840
|
+
displayName: null,
|
|
841
|
+
dangerLevel: "medium",
|
|
842
|
+
sideEffects: {
|
|
843
|
+
creates: ["state"],
|
|
844
|
+
},
|
|
845
|
+
requiredFields: ["metadata.name", "metadata.namespace", "path.name", "path.namespace"],
|
|
846
|
+
cliExamples: [
|
|
847
|
+
{
|
|
848
|
+
command: "f5xcctl register state create -f {file}.yaml",
|
|
849
|
+
description: "Create from YAML file",
|
|
850
|
+
use_case: "file_based",
|
|
851
|
+
},
|
|
852
|
+
{
|
|
853
|
+
command: "f5xcctl register state create {name} --namespace {namespace}",
|
|
854
|
+
description: "Create state",
|
|
855
|
+
use_case: "basic_create",
|
|
856
|
+
},
|
|
857
|
+
],
|
|
858
|
+
confirmationRequired: false,
|
|
859
|
+
parameterExamples: {
|
|
860
|
+
name: "Value",
|
|
861
|
+
namespace: "Value",
|
|
862
|
+
},
|
|
863
|
+
validationRules: {},
|
|
864
|
+
operationMetadata: {
|
|
865
|
+
common_errors: [
|
|
866
|
+
{
|
|
867
|
+
code: 401,
|
|
868
|
+
message: "Authentication required",
|
|
869
|
+
solution: "Provide valid API credentials",
|
|
870
|
+
},
|
|
871
|
+
{
|
|
872
|
+
code: 403,
|
|
873
|
+
message: "Permission denied",
|
|
874
|
+
solution: "Check access permissions for this operation",
|
|
875
|
+
},
|
|
876
|
+
{
|
|
877
|
+
code: 404,
|
|
878
|
+
message: "Resource not found",
|
|
879
|
+
solution: "Verify resource name, namespace, and path",
|
|
880
|
+
},
|
|
881
|
+
{
|
|
882
|
+
code: 409,
|
|
883
|
+
message: "Resource already exists",
|
|
884
|
+
solution: "Use different name or update existing resource",
|
|
885
|
+
},
|
|
886
|
+
{
|
|
887
|
+
code: 429,
|
|
888
|
+
message: "Rate limit exceeded",
|
|
889
|
+
solution: "Wait before retrying the operation",
|
|
890
|
+
},
|
|
891
|
+
{
|
|
892
|
+
code: 500,
|
|
893
|
+
message: "Server error",
|
|
894
|
+
solution: "Retry operation or contact support",
|
|
895
|
+
},
|
|
896
|
+
],
|
|
897
|
+
conditions: {
|
|
898
|
+
postconditions: ["State resource created", "Resource assigned unique identifier"],
|
|
899
|
+
prerequisites: ["Active namespace"],
|
|
900
|
+
},
|
|
901
|
+
confirmation_required: false,
|
|
902
|
+
danger_level: "medium",
|
|
903
|
+
examples: [
|
|
904
|
+
{
|
|
905
|
+
command: "f5xcctl register state create {name} --namespace {namespace}",
|
|
906
|
+
description: "Create state",
|
|
907
|
+
use_case: "basic_create",
|
|
908
|
+
},
|
|
909
|
+
{
|
|
910
|
+
command: "f5xcctl register state create -f {file}.yaml",
|
|
911
|
+
description: "Create from YAML file",
|
|
912
|
+
use_case: "file_based",
|
|
913
|
+
},
|
|
914
|
+
],
|
|
915
|
+
field_docs: {},
|
|
916
|
+
optional_fields: [],
|
|
917
|
+
performance_impact: {
|
|
918
|
+
latency: "low",
|
|
919
|
+
resource_usage: "low",
|
|
920
|
+
},
|
|
921
|
+
purpose: "Create new state",
|
|
922
|
+
required_fields: ["metadata.name", "metadata.namespace", "path.name", "path.namespace"],
|
|
923
|
+
side_effects: {
|
|
924
|
+
creates: ["state"],
|
|
925
|
+
},
|
|
926
|
+
},
|
|
927
|
+
},
|
|
928
|
+
{
|
|
929
|
+
toolName: "f5xc-api-users-token-create",
|
|
930
|
+
method: "POST",
|
|
931
|
+
path: "/api/register/namespaces/{metadata.namespace}/tokens",
|
|
932
|
+
operation: "create",
|
|
933
|
+
domain: "users",
|
|
934
|
+
resource: "token",
|
|
935
|
+
summary: "Create Token.",
|
|
936
|
+
description: "Creates new token. Token object is used to manage site admission. User must generate token before provisioning and pass this\ntoken to site during it's registration.",
|
|
937
|
+
pathParameters: [
|
|
938
|
+
{
|
|
939
|
+
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 ""',
|
|
940
|
+
in: "path",
|
|
941
|
+
name: "metadata.namespace",
|
|
942
|
+
required: true,
|
|
943
|
+
schema: {
|
|
944
|
+
type: "string",
|
|
945
|
+
},
|
|
946
|
+
"x-displayname": "Namespace",
|
|
947
|
+
"x-ves-example": "Staging",
|
|
948
|
+
},
|
|
949
|
+
],
|
|
950
|
+
queryParameters: [],
|
|
951
|
+
requestBodySchema: {
|
|
952
|
+
$ref: "#/components/schemas/tokenCreateRequest",
|
|
953
|
+
},
|
|
954
|
+
responseSchema: {
|
|
955
|
+
$ref: "#/components/schemas/tokenCreateResponse",
|
|
956
|
+
},
|
|
957
|
+
requiredParams: ["body", "metadata.namespace"],
|
|
958
|
+
operationId: "ves.io.schema.token.API.Create",
|
|
959
|
+
tags: ["Other"],
|
|
960
|
+
sourceFile: "domains/users.json",
|
|
961
|
+
displayName: null,
|
|
962
|
+
dangerLevel: "medium",
|
|
963
|
+
sideEffects: {
|
|
964
|
+
creates: ["token"],
|
|
965
|
+
},
|
|
966
|
+
requiredFields: ["metadata.name", "metadata.namespace", "path.metadata.namespace"],
|
|
967
|
+
cliExamples: [
|
|
968
|
+
{
|
|
969
|
+
command: "f5xcctl register token create -f {file}.yaml",
|
|
970
|
+
description: "Create from YAML file",
|
|
971
|
+
use_case: "file_based",
|
|
972
|
+
},
|
|
973
|
+
{
|
|
974
|
+
command: "f5xcctl register token create {name} --namespace {namespace}",
|
|
975
|
+
description: "Create token",
|
|
976
|
+
use_case: "basic_create",
|
|
977
|
+
},
|
|
978
|
+
],
|
|
979
|
+
confirmationRequired: false,
|
|
980
|
+
parameterExamples: {
|
|
981
|
+
"metadata.namespace": "Staging",
|
|
982
|
+
},
|
|
983
|
+
validationRules: {},
|
|
984
|
+
operationMetadata: {
|
|
985
|
+
common_errors: [
|
|
986
|
+
{
|
|
987
|
+
code: 401,
|
|
988
|
+
message: "Authentication required",
|
|
989
|
+
solution: "Provide valid API credentials",
|
|
990
|
+
},
|
|
991
|
+
{
|
|
992
|
+
code: 403,
|
|
993
|
+
message: "Permission denied",
|
|
994
|
+
solution: "Check access permissions for this operation",
|
|
995
|
+
},
|
|
996
|
+
{
|
|
997
|
+
code: 404,
|
|
998
|
+
message: "Resource not found",
|
|
999
|
+
solution: "Verify resource name, namespace, and path",
|
|
1000
|
+
},
|
|
1001
|
+
{
|
|
1002
|
+
code: 409,
|
|
1003
|
+
message: "Resource already exists",
|
|
1004
|
+
solution: "Use different name or update existing resource",
|
|
1005
|
+
},
|
|
1006
|
+
{
|
|
1007
|
+
code: 429,
|
|
1008
|
+
message: "Rate limit exceeded",
|
|
1009
|
+
solution: "Wait before retrying the operation",
|
|
1010
|
+
},
|
|
1011
|
+
{
|
|
1012
|
+
code: 500,
|
|
1013
|
+
message: "Server error",
|
|
1014
|
+
solution: "Retry operation or contact support",
|
|
1015
|
+
},
|
|
1016
|
+
],
|
|
1017
|
+
conditions: {
|
|
1018
|
+
postconditions: ["Token resource created", "Resource assigned unique identifier"],
|
|
1019
|
+
prerequisites: ["Active namespace"],
|
|
1020
|
+
},
|
|
1021
|
+
confirmation_required: false,
|
|
1022
|
+
danger_level: "medium",
|
|
1023
|
+
examples: [
|
|
1024
|
+
{
|
|
1025
|
+
command: "f5xcctl register token create {name} --namespace {namespace}",
|
|
1026
|
+
description: "Create token",
|
|
1027
|
+
use_case: "basic_create",
|
|
1028
|
+
},
|
|
1029
|
+
{
|
|
1030
|
+
command: "f5xcctl register token create -f {file}.yaml",
|
|
1031
|
+
description: "Create from YAML file",
|
|
1032
|
+
use_case: "file_based",
|
|
1033
|
+
},
|
|
1034
|
+
],
|
|
1035
|
+
field_docs: {},
|
|
1036
|
+
optional_fields: [],
|
|
1037
|
+
performance_impact: {
|
|
1038
|
+
latency: "low",
|
|
1039
|
+
resource_usage: "low",
|
|
1040
|
+
},
|
|
1041
|
+
purpose: "Create new token",
|
|
1042
|
+
required_fields: ["metadata.name", "metadata.namespace", "path.metadata.namespace"],
|
|
1043
|
+
side_effects: {
|
|
1044
|
+
creates: ["token"],
|
|
1045
|
+
},
|
|
1046
|
+
},
|
|
1047
|
+
},
|
|
1048
|
+
{
|
|
1049
|
+
toolName: "f5xc-api-users-token-delete",
|
|
1050
|
+
method: "DELETE",
|
|
1051
|
+
path: "/api/register/namespaces/{namespace}/tokens/{name}",
|
|
1052
|
+
operation: "delete",
|
|
1053
|
+
domain: "users",
|
|
1054
|
+
resource: "token",
|
|
1055
|
+
summary: "DELETE Token.",
|
|
1056
|
+
description: "DELETE the specified token.",
|
|
1057
|
+
pathParameters: [
|
|
1058
|
+
{
|
|
1059
|
+
description: "Name\nName of the configuration object.",
|
|
1060
|
+
in: "path",
|
|
1061
|
+
name: "name",
|
|
1062
|
+
required: true,
|
|
1063
|
+
schema: {
|
|
1064
|
+
type: "string",
|
|
1065
|
+
},
|
|
1066
|
+
"x-displayname": "Name",
|
|
1067
|
+
"x-ves-example": "Name",
|
|
1068
|
+
},
|
|
1069
|
+
{
|
|
1070
|
+
description: "Namespace\nNamespace in which the configuration object is present.",
|
|
1071
|
+
in: "path",
|
|
1072
|
+
name: "namespace",
|
|
1073
|
+
required: true,
|
|
1074
|
+
schema: {
|
|
1075
|
+
type: "string",
|
|
1076
|
+
},
|
|
1077
|
+
"x-displayname": "Namespace",
|
|
1078
|
+
"x-ves-example": "Ns1",
|
|
1079
|
+
},
|
|
1080
|
+
],
|
|
1081
|
+
queryParameters: [],
|
|
1082
|
+
requestBodySchema: {
|
|
1083
|
+
$ref: "#/components/schemas/tokenDeleteRequest",
|
|
1084
|
+
},
|
|
1085
|
+
responseSchema: {},
|
|
1086
|
+
requiredParams: ["body", "name", "namespace"],
|
|
1087
|
+
operationId: "ves.io.schema.token.API.Delete",
|
|
1088
|
+
tags: ["Other"],
|
|
1089
|
+
sourceFile: "domains/users.json",
|
|
1090
|
+
displayName: null,
|
|
1091
|
+
dangerLevel: "high",
|
|
1092
|
+
sideEffects: {
|
|
1093
|
+
deletes: ["token", "contained_resources"],
|
|
1094
|
+
},
|
|
1095
|
+
requiredFields: ["path.name", "path.namespace"],
|
|
1096
|
+
cliExamples: [
|
|
1097
|
+
{
|
|
1098
|
+
command: "f5xcctl register token delete {name} --namespace {namespace}",
|
|
1099
|
+
description: "Delete token",
|
|
1100
|
+
use_case: "delete",
|
|
1101
|
+
},
|
|
1102
|
+
],
|
|
1103
|
+
confirmationRequired: true,
|
|
1104
|
+
parameterExamples: {
|
|
1105
|
+
name: "Name",
|
|
1106
|
+
namespace: "Ns1",
|
|
1107
|
+
},
|
|
1108
|
+
validationRules: {},
|
|
1109
|
+
operationMetadata: {
|
|
1110
|
+
common_errors: [
|
|
1111
|
+
{
|
|
1112
|
+
code: 401,
|
|
1113
|
+
message: "Authentication required",
|
|
1114
|
+
solution: "Provide valid API credentials",
|
|
1115
|
+
},
|
|
1116
|
+
{
|
|
1117
|
+
code: 403,
|
|
1118
|
+
message: "Permission denied",
|
|
1119
|
+
solution: "Check access permissions for this operation",
|
|
1120
|
+
},
|
|
1121
|
+
{
|
|
1122
|
+
code: 404,
|
|
1123
|
+
message: "Resource not found",
|
|
1124
|
+
solution: "Verify resource name, namespace, and path",
|
|
1125
|
+
},
|
|
1126
|
+
{
|
|
1127
|
+
code: 409,
|
|
1128
|
+
message: "Resource already exists",
|
|
1129
|
+
solution: "Use different name or update existing resource",
|
|
1130
|
+
},
|
|
1131
|
+
{
|
|
1132
|
+
code: 429,
|
|
1133
|
+
message: "Rate limit exceeded",
|
|
1134
|
+
solution: "Wait before retrying the operation",
|
|
1135
|
+
},
|
|
1136
|
+
{
|
|
1137
|
+
code: 500,
|
|
1138
|
+
message: "Server error",
|
|
1139
|
+
solution: "Retry operation or contact support",
|
|
1140
|
+
},
|
|
1141
|
+
],
|
|
1142
|
+
conditions: {
|
|
1143
|
+
postconditions: ["Resource removed from system", "Associated resources may be affected"],
|
|
1144
|
+
prerequisites: ["Active namespace"],
|
|
1145
|
+
},
|
|
1146
|
+
confirmation_required: true,
|
|
1147
|
+
danger_level: "high",
|
|
1148
|
+
examples: [
|
|
1149
|
+
{
|
|
1150
|
+
command: "f5xcctl register token delete {name} --namespace {namespace}",
|
|
1151
|
+
description: "Delete token",
|
|
1152
|
+
use_case: "delete",
|
|
1153
|
+
},
|
|
1154
|
+
],
|
|
1155
|
+
field_docs: {},
|
|
1156
|
+
optional_fields: [],
|
|
1157
|
+
performance_impact: {
|
|
1158
|
+
latency: "high",
|
|
1159
|
+
resource_usage: "moderate",
|
|
1160
|
+
},
|
|
1161
|
+
purpose: "Delete token",
|
|
1162
|
+
required_fields: ["path.name", "path.namespace"],
|
|
1163
|
+
side_effects: {
|
|
1164
|
+
deletes: ["token", "contained_resources"],
|
|
1165
|
+
},
|
|
1166
|
+
},
|
|
1167
|
+
},
|
|
1168
|
+
{
|
|
1169
|
+
toolName: "f5xc-api-users-token-get",
|
|
1170
|
+
method: "GET",
|
|
1171
|
+
path: "/api/register/namespaces/{namespace}/tokens/{name}",
|
|
1172
|
+
operation: "get",
|
|
1173
|
+
domain: "users",
|
|
1174
|
+
resource: "token",
|
|
1175
|
+
summary: "GET Token",
|
|
1176
|
+
description: "GET token. Token object is used to manage site admission. User must generate token before provisioning and pass this\ntoken to site during it's registration.",
|
|
1177
|
+
pathParameters: [
|
|
1178
|
+
{
|
|
1179
|
+
description: "Name\nThe name of the configuration object to be fetched.",
|
|
1180
|
+
in: "path",
|
|
1181
|
+
name: "name",
|
|
1182
|
+
required: true,
|
|
1183
|
+
schema: {
|
|
1184
|
+
type: "string",
|
|
1185
|
+
},
|
|
1186
|
+
"x-displayname": "Name",
|
|
1187
|
+
"x-ves-example": "Name",
|
|
1188
|
+
},
|
|
1189
|
+
{
|
|
1190
|
+
description: "Namespace\nThe namespace in which the configuration object is present.",
|
|
1191
|
+
in: "path",
|
|
1192
|
+
name: "namespace",
|
|
1193
|
+
required: true,
|
|
1194
|
+
schema: {
|
|
1195
|
+
type: "string",
|
|
1196
|
+
},
|
|
1197
|
+
"x-displayname": "Namespace",
|
|
1198
|
+
"x-ves-example": "Ns1",
|
|
1199
|
+
},
|
|
1200
|
+
],
|
|
1201
|
+
queryParameters: [
|
|
1202
|
+
{
|
|
1203
|
+
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.",
|
|
1204
|
+
in: "query",
|
|
1205
|
+
name: "response_format",
|
|
1206
|
+
required: false,
|
|
1207
|
+
schema: {
|
|
1208
|
+
default: "GET_RSP_FORMAT_DEFAULT",
|
|
1209
|
+
enum: [
|
|
1210
|
+
"GET_RSP_FORMAT_DEFAULT",
|
|
1211
|
+
"GET_RSP_FORMAT_FOR_CREATE",
|
|
1212
|
+
"GET_RSP_FORMAT_FOR_REPLACE",
|
|
1213
|
+
"GET_RSP_FORMAT_STATUS",
|
|
1214
|
+
"GET_RSP_FORMAT_READ",
|
|
1215
|
+
"GET_RSP_FORMAT_REFERRING_OBJECTS",
|
|
1216
|
+
"GET_RSP_FORMAT_BROKEN_REFERENCES",
|
|
1217
|
+
],
|
|
1218
|
+
type: "string",
|
|
1219
|
+
},
|
|
1220
|
+
"x-displayname": "Broken Referred Objects.",
|
|
1221
|
+
},
|
|
1222
|
+
],
|
|
1223
|
+
requestBodySchema: null,
|
|
1224
|
+
responseSchema: {
|
|
1225
|
+
$ref: "#/components/schemas/tokenGetResponse",
|
|
1226
|
+
},
|
|
1227
|
+
requiredParams: ["name", "namespace"],
|
|
1228
|
+
operationId: "ves.io.schema.token.API.Get",
|
|
1229
|
+
tags: ["Other"],
|
|
1230
|
+
sourceFile: "domains/users.json",
|
|
1231
|
+
displayName: null,
|
|
1232
|
+
dangerLevel: "low",
|
|
1233
|
+
sideEffects: null,
|
|
1234
|
+
requiredFields: ["path.name", "path.namespace"],
|
|
1235
|
+
cliExamples: [
|
|
1236
|
+
{
|
|
1237
|
+
command: "f5xcctl register token get {name} --namespace {namespace}",
|
|
1238
|
+
description: "Get specific token",
|
|
1239
|
+
use_case: "get_specific",
|
|
1240
|
+
},
|
|
1241
|
+
],
|
|
1242
|
+
confirmationRequired: false,
|
|
1243
|
+
parameterExamples: {
|
|
1244
|
+
name: "Name",
|
|
1245
|
+
namespace: "Ns1",
|
|
1246
|
+
},
|
|
1247
|
+
validationRules: {},
|
|
1248
|
+
operationMetadata: {
|
|
1249
|
+
common_errors: [
|
|
1250
|
+
{
|
|
1251
|
+
code: 401,
|
|
1252
|
+
message: "Authentication required",
|
|
1253
|
+
solution: "Provide valid API credentials",
|
|
1254
|
+
},
|
|
1255
|
+
{
|
|
1256
|
+
code: 403,
|
|
1257
|
+
message: "Permission denied",
|
|
1258
|
+
solution: "Check access permissions for this operation",
|
|
1259
|
+
},
|
|
1260
|
+
{
|
|
1261
|
+
code: 404,
|
|
1262
|
+
message: "Resource not found",
|
|
1263
|
+
solution: "Verify resource name, namespace, and path",
|
|
1264
|
+
},
|
|
1265
|
+
{
|
|
1266
|
+
code: 409,
|
|
1267
|
+
message: "Resource already exists",
|
|
1268
|
+
solution: "Use different name or update existing resource",
|
|
1269
|
+
},
|
|
1270
|
+
{
|
|
1271
|
+
code: 429,
|
|
1272
|
+
message: "Rate limit exceeded",
|
|
1273
|
+
solution: "Wait before retrying the operation",
|
|
1274
|
+
},
|
|
1275
|
+
{
|
|
1276
|
+
code: 500,
|
|
1277
|
+
message: "Server error",
|
|
1278
|
+
solution: "Retry operation or contact support",
|
|
1279
|
+
},
|
|
1280
|
+
],
|
|
1281
|
+
conditions: {
|
|
1282
|
+
postconditions: [],
|
|
1283
|
+
prerequisites: ["Active namespace"],
|
|
1284
|
+
},
|
|
1285
|
+
confirmation_required: false,
|
|
1286
|
+
danger_level: "low",
|
|
1287
|
+
examples: [
|
|
1288
|
+
{
|
|
1289
|
+
command: "f5xcctl register token get {name} --namespace {namespace}",
|
|
1290
|
+
description: "Get specific token",
|
|
1291
|
+
use_case: "get_specific",
|
|
1292
|
+
},
|
|
1293
|
+
],
|
|
1294
|
+
field_docs: {},
|
|
1295
|
+
optional_fields: [],
|
|
1296
|
+
performance_impact: {
|
|
1297
|
+
latency: "low",
|
|
1298
|
+
resource_usage: "low",
|
|
1299
|
+
},
|
|
1300
|
+
purpose: "Retrieve specific token",
|
|
1301
|
+
required_fields: ["path.name", "path.namespace"],
|
|
1302
|
+
side_effects: {},
|
|
1303
|
+
},
|
|
1304
|
+
},
|
|
1305
|
+
{
|
|
1306
|
+
toolName: "f5xc-api-users-token-list",
|
|
1307
|
+
method: "GET",
|
|
1308
|
+
path: "/api/register/namespaces/{namespace}/tokens",
|
|
1309
|
+
operation: "list",
|
|
1310
|
+
domain: "users",
|
|
1311
|
+
resource: "token",
|
|
1312
|
+
summary: "List Token.",
|
|
1313
|
+
description: "List the set of token in a namespace.",
|
|
1314
|
+
pathParameters: [
|
|
1315
|
+
{
|
|
1316
|
+
description: "Namespace\nNamespace to scope the listing of token.",
|
|
1317
|
+
in: "path",
|
|
1318
|
+
name: "namespace",
|
|
1319
|
+
required: true,
|
|
1320
|
+
schema: {
|
|
1321
|
+
type: "string",
|
|
1322
|
+
},
|
|
1323
|
+
"x-displayname": "Namespace",
|
|
1324
|
+
"x-ves-example": "Ns1",
|
|
1325
|
+
},
|
|
1326
|
+
],
|
|
1327
|
+
queryParameters: [
|
|
1328
|
+
{
|
|
1329
|
+
description: "A LabelSelectorType expression that every item in list response will satisfy.",
|
|
1330
|
+
in: "query",
|
|
1331
|
+
name: "label_filter",
|
|
1332
|
+
required: false,
|
|
1333
|
+
schema: {
|
|
1334
|
+
type: "string",
|
|
1335
|
+
},
|
|
1336
|
+
"x-displayname": "Label Filter.",
|
|
1337
|
+
"x-ves-example": "Env in (staging, testing), tier in (web, db)",
|
|
1338
|
+
},
|
|
1339
|
+
{
|
|
1340
|
+
description: 'X-example: ""\nExtra fields to return along with summary fields.',
|
|
1341
|
+
in: "query",
|
|
1342
|
+
name: "report_fields",
|
|
1343
|
+
required: false,
|
|
1344
|
+
schema: {
|
|
1345
|
+
items: {
|
|
1346
|
+
type: "string",
|
|
1347
|
+
},
|
|
1348
|
+
type: "array",
|
|
1349
|
+
},
|
|
1350
|
+
"x-displayname": "Report Fields.",
|
|
1351
|
+
},
|
|
1352
|
+
{
|
|
1353
|
+
description: 'X-example: ""\nExtra status fields to return along with summary fields.',
|
|
1354
|
+
in: "query",
|
|
1355
|
+
name: "report_status_fields",
|
|
1356
|
+
required: false,
|
|
1357
|
+
schema: {
|
|
1358
|
+
items: {
|
|
1359
|
+
type: "string",
|
|
1360
|
+
},
|
|
1361
|
+
type: "array",
|
|
1362
|
+
},
|
|
1363
|
+
"x-displayname": "Report Status Fields.",
|
|
1364
|
+
},
|
|
1365
|
+
],
|
|
1366
|
+
requestBodySchema: null,
|
|
1367
|
+
responseSchema: {
|
|
1368
|
+
$ref: "#/components/schemas/tokenListResponse",
|
|
1369
|
+
},
|
|
1370
|
+
requiredParams: ["namespace"],
|
|
1371
|
+
operationId: "ves.io.schema.token.API.List",
|
|
1372
|
+
tags: ["Other"],
|
|
1373
|
+
sourceFile: "domains/users.json",
|
|
1374
|
+
displayName: null,
|
|
1375
|
+
dangerLevel: "low",
|
|
1376
|
+
sideEffects: null,
|
|
1377
|
+
requiredFields: ["path.namespace"],
|
|
1378
|
+
cliExamples: [
|
|
1379
|
+
{
|
|
1380
|
+
command: "f5xcctl register token list --namespace {namespace}",
|
|
1381
|
+
description: "List all tokens",
|
|
1382
|
+
use_case: "list_all",
|
|
1383
|
+
},
|
|
1384
|
+
],
|
|
1385
|
+
confirmationRequired: false,
|
|
1386
|
+
parameterExamples: {
|
|
1387
|
+
label_filter: "Env in (staging, testing), tier in (web, db)",
|
|
1388
|
+
namespace: "Ns1",
|
|
1389
|
+
},
|
|
1390
|
+
validationRules: {},
|
|
1391
|
+
operationMetadata: {
|
|
1392
|
+
common_errors: [
|
|
1393
|
+
{
|
|
1394
|
+
code: 401,
|
|
1395
|
+
message: "Authentication required",
|
|
1396
|
+
solution: "Provide valid API credentials",
|
|
1397
|
+
},
|
|
1398
|
+
{
|
|
1399
|
+
code: 403,
|
|
1400
|
+
message: "Permission denied",
|
|
1401
|
+
solution: "Check access permissions for this operation",
|
|
1402
|
+
},
|
|
1403
|
+
{
|
|
1404
|
+
code: 404,
|
|
1405
|
+
message: "Resource not found",
|
|
1406
|
+
solution: "Verify resource name, namespace, and path",
|
|
1407
|
+
},
|
|
1408
|
+
{
|
|
1409
|
+
code: 409,
|
|
1410
|
+
message: "Resource already exists",
|
|
1411
|
+
solution: "Use different name or update existing resource",
|
|
1412
|
+
},
|
|
1413
|
+
{
|
|
1414
|
+
code: 429,
|
|
1415
|
+
message: "Rate limit exceeded",
|
|
1416
|
+
solution: "Wait before retrying the operation",
|
|
1417
|
+
},
|
|
1418
|
+
{
|
|
1419
|
+
code: 500,
|
|
1420
|
+
message: "Server error",
|
|
1421
|
+
solution: "Retry operation or contact support",
|
|
1422
|
+
},
|
|
1423
|
+
],
|
|
1424
|
+
conditions: {
|
|
1425
|
+
postconditions: [],
|
|
1426
|
+
prerequisites: ["Active namespace"],
|
|
1427
|
+
},
|
|
1428
|
+
confirmation_required: false,
|
|
1429
|
+
danger_level: "low",
|
|
1430
|
+
examples: [
|
|
1431
|
+
{
|
|
1432
|
+
command: "f5xcctl register token list --namespace {namespace}",
|
|
1433
|
+
description: "List all tokens",
|
|
1434
|
+
use_case: "list_all",
|
|
1435
|
+
},
|
|
1436
|
+
],
|
|
1437
|
+
field_docs: {},
|
|
1438
|
+
optional_fields: [],
|
|
1439
|
+
performance_impact: {
|
|
1440
|
+
latency: "moderate",
|
|
1441
|
+
resource_usage: "moderate",
|
|
1442
|
+
},
|
|
1443
|
+
purpose: "List all tokens",
|
|
1444
|
+
required_fields: ["path.namespace"],
|
|
1445
|
+
side_effects: {},
|
|
1446
|
+
},
|
|
1447
|
+
},
|
|
1448
|
+
{
|
|
1449
|
+
toolName: "f5xc-api-users-token-update",
|
|
1450
|
+
method: "PUT",
|
|
1451
|
+
path: "/api/register/namespaces/{metadata.namespace}/tokens/{metadata.name}",
|
|
1452
|
+
operation: "update",
|
|
1453
|
+
domain: "users",
|
|
1454
|
+
resource: "token",
|
|
1455
|
+
summary: "Replace Token.",
|
|
1456
|
+
description: "Replaces token. Token object is used to manage site admission. User must generate token before provisioning and pass this\ntoken to site during it's registration.",
|
|
1457
|
+
pathParameters: [
|
|
1458
|
+
{
|
|
1459
|
+
description: "Name\nThe configuration object to be replaced will be looked up by name.",
|
|
1460
|
+
in: "path",
|
|
1461
|
+
name: "metadata.name",
|
|
1462
|
+
required: true,
|
|
1463
|
+
schema: {
|
|
1464
|
+
type: "string",
|
|
1465
|
+
},
|
|
1466
|
+
"x-displayname": "Name",
|
|
1467
|
+
"x-ves-example": "Example-corp-web.",
|
|
1468
|
+
},
|
|
1469
|
+
{
|
|
1470
|
+
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 ""',
|
|
1471
|
+
in: "path",
|
|
1472
|
+
name: "metadata.namespace",
|
|
1473
|
+
required: true,
|
|
1474
|
+
schema: {
|
|
1475
|
+
type: "string",
|
|
1476
|
+
},
|
|
1477
|
+
"x-displayname": "Namespace",
|
|
1478
|
+
"x-ves-example": "Staging",
|
|
1479
|
+
},
|
|
1480
|
+
],
|
|
1481
|
+
queryParameters: [],
|
|
1482
|
+
requestBodySchema: {
|
|
1483
|
+
$ref: "#/components/schemas/tokenReplaceRequest",
|
|
1484
|
+
},
|
|
1485
|
+
responseSchema: {
|
|
1486
|
+
$ref: "#/components/schemas/tokenReplaceResponse",
|
|
1487
|
+
},
|
|
1488
|
+
requiredParams: ["body", "metadata.name", "metadata.namespace"],
|
|
1489
|
+
operationId: "ves.io.schema.token.API.Replace",
|
|
1490
|
+
tags: ["Other"],
|
|
1491
|
+
sourceFile: "domains/users.json",
|
|
1492
|
+
displayName: null,
|
|
1493
|
+
dangerLevel: "medium",
|
|
1494
|
+
sideEffects: {
|
|
1495
|
+
modifies: ["token"],
|
|
1496
|
+
},
|
|
1497
|
+
requiredFields: ["path.metadata.name", "path.metadata.namespace"],
|
|
1498
|
+
cliExamples: [
|
|
1499
|
+
{
|
|
1500
|
+
command: "f5xcctl register token update {name} --namespace {namespace} -f {file}.yaml",
|
|
1501
|
+
description: "Update token",
|
|
1502
|
+
use_case: "update",
|
|
1503
|
+
},
|
|
1504
|
+
],
|
|
1505
|
+
confirmationRequired: false,
|
|
1506
|
+
parameterExamples: {
|
|
1507
|
+
"metadata.name": "Example-corp-web.",
|
|
1508
|
+
"metadata.namespace": "Staging",
|
|
1509
|
+
},
|
|
1510
|
+
validationRules: {},
|
|
1511
|
+
operationMetadata: {
|
|
1512
|
+
common_errors: [
|
|
1513
|
+
{
|
|
1514
|
+
code: 401,
|
|
1515
|
+
message: "Authentication required",
|
|
1516
|
+
solution: "Provide valid API credentials",
|
|
1517
|
+
},
|
|
1518
|
+
{
|
|
1519
|
+
code: 403,
|
|
1520
|
+
message: "Permission denied",
|
|
1521
|
+
solution: "Check access permissions for this operation",
|
|
1522
|
+
},
|
|
1523
|
+
{
|
|
1524
|
+
code: 404,
|
|
1525
|
+
message: "Resource not found",
|
|
1526
|
+
solution: "Verify resource name, namespace, and path",
|
|
1527
|
+
},
|
|
1528
|
+
{
|
|
1529
|
+
code: 409,
|
|
1530
|
+
message: "Resource already exists",
|
|
1531
|
+
solution: "Use different name or update existing resource",
|
|
1532
|
+
},
|
|
1533
|
+
{
|
|
1534
|
+
code: 429,
|
|
1535
|
+
message: "Rate limit exceeded",
|
|
1536
|
+
solution: "Wait before retrying the operation",
|
|
1537
|
+
},
|
|
1538
|
+
{
|
|
1539
|
+
code: 500,
|
|
1540
|
+
message: "Server error",
|
|
1541
|
+
solution: "Retry operation or contact support",
|
|
1542
|
+
},
|
|
1543
|
+
],
|
|
1544
|
+
conditions: {
|
|
1545
|
+
postconditions: ["Resource updated with new values"],
|
|
1546
|
+
prerequisites: ["Active namespace"],
|
|
1547
|
+
},
|
|
1548
|
+
confirmation_required: false,
|
|
1549
|
+
danger_level: "medium",
|
|
1550
|
+
examples: [
|
|
1551
|
+
{
|
|
1552
|
+
command: "f5xcctl register token update {name} --namespace {namespace} -f {file}.yaml",
|
|
1553
|
+
description: "Update token",
|
|
1554
|
+
use_case: "update",
|
|
1555
|
+
},
|
|
1556
|
+
],
|
|
1557
|
+
field_docs: {},
|
|
1558
|
+
optional_fields: [],
|
|
1559
|
+
performance_impact: {
|
|
1560
|
+
latency: "low",
|
|
1561
|
+
resource_usage: "low",
|
|
1562
|
+
},
|
|
1563
|
+
purpose: "Replace existing token",
|
|
1564
|
+
required_fields: ["path.metadata.name", "path.metadata.namespace"],
|
|
1565
|
+
side_effects: {
|
|
1566
|
+
modifies: ["token"],
|
|
1567
|
+
},
|
|
1568
|
+
},
|
|
1569
|
+
},
|
|
1570
|
+
];
|
|
1571
|
+
export default usersTools;
|
|
1572
|
+
//# sourceMappingURL=index.js.map
|