@hostinger/mcp 1.52.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/.env.example +14 -0
- package/.github/ISSUE_TEMPLATE/bug_report.md +36 -0
- package/.github/workflows/build-release.yaml +163 -0
- package/CODEOWNERS +1 -0
- package/Dockerfile +15 -0
- package/LICENSE +21 -0
- package/README.md +4343 -0
- package/build.js +60 -0
- package/gemini-extension.json +25 -0
- package/glama.json +7 -0
- package/package.json +59 -0
- package/server.json +29 -0
- package/skills/headless/SKILL.md +55 -0
- package/skills/headless/entry/bootstrap.mjs +109 -0
- package/skills/headless/entry/skill.md +79 -0
- package/skills/headless/references/DEPLOYMENT.md +34 -0
- package/skills/headless/references/SETUP.md +34 -0
- package/skills/headless/references/STORE.md +52 -0
- package/skills/headless/references/WORDPRESS.md +51 -0
- package/src/core/oauth-error.html +90 -0
- package/src/core/oauth-success.html +77 -0
- package/src/core/oauth.js +406 -0
- package/src/core/oauth.ts +374 -0
- package/src/core/runtime.js +2673 -0
- package/src/core/runtime.ts +2724 -0
- package/src/core/tools/agency-hosting.js +1535 -0
- package/src/core/tools/agency-hosting.ts +1550 -0
- package/src/core/tools/all.js +15361 -0
- package/src/core/tools/all.ts +15376 -0
- package/src/core/tools/billing.js +310 -0
- package/src/core/tools/billing.ts +325 -0
- package/src/core/tools/dns.js +393 -0
- package/src/core/tools/dns.ts +408 -0
- package/src/core/tools/domains.js +1435 -0
- package/src/core/tools/domains.ts +1450 -0
- package/src/core/tools/ecommerce.js +1426 -0
- package/src/core/tools/ecommerce.ts +1441 -0
- package/src/core/tools/horizons.js +84 -0
- package/src/core/tools/horizons.ts +99 -0
- package/src/core/tools/hosting.js +2479 -0
- package/src/core/tools/hosting.ts +2494 -0
- package/src/core/tools/mail.js +1641 -0
- package/src/core/tools/mail.ts +1656 -0
- package/src/core/tools/reach.js +2270 -0
- package/src/core/tools/reach.ts +2285 -0
- package/src/core/tools/vps.js +2248 -0
- package/src/core/tools/vps.ts +2263 -0
- package/src/core/tools/wordpress.js +1570 -0
- package/src/core/tools/wordpress.ts +1585 -0
- package/src/servers/agency-hosting.js +6 -0
- package/src/servers/agency-hosting.ts +6 -0
- package/src/servers/all.js +6 -0
- package/src/servers/all.ts +6 -0
- package/src/servers/billing.js +6 -0
- package/src/servers/billing.ts +6 -0
- package/src/servers/dns.js +6 -0
- package/src/servers/dns.ts +6 -0
- package/src/servers/domains.js +6 -0
- package/src/servers/domains.ts +6 -0
- package/src/servers/ecommerce.js +6 -0
- package/src/servers/ecommerce.ts +6 -0
- package/src/servers/horizons.js +6 -0
- package/src/servers/horizons.ts +6 -0
- package/src/servers/hosting.js +6 -0
- package/src/servers/hosting.ts +6 -0
- package/src/servers/mail.js +6 -0
- package/src/servers/mail.ts +6 -0
- package/src/servers/reach.js +6 -0
- package/src/servers/reach.ts +6 -0
- package/src/servers/vps.js +6 -0
- package/src/servers/vps.ts +6 -0
- package/src/servers/wordpress.js +6 -0
- package/src/servers/wordpress.ts +6 -0
- package/tsconfig.json +15 -0
- package/types.d.ts +8836 -0
|
@@ -0,0 +1,2263 @@
|
|
|
1
|
+
// Auto-generated tool list for group: vps
|
|
2
|
+
import type { Tool } from "@modelcontextprotocol/sdk/types.js";
|
|
3
|
+
|
|
4
|
+
export interface OpenApiTool extends Tool {
|
|
5
|
+
method: string;
|
|
6
|
+
path: string;
|
|
7
|
+
security: unknown[];
|
|
8
|
+
custom?: boolean;
|
|
9
|
+
group?: string;
|
|
10
|
+
topic?: string;
|
|
11
|
+
handlerMethod?: string;
|
|
12
|
+
templateFile?: string;
|
|
13
|
+
templateFileTS?: string;
|
|
14
|
+
}
|
|
15
|
+
|
|
16
|
+
const tools: OpenApiTool[] = [
|
|
17
|
+
{
|
|
18
|
+
"name": "VPS_getDataCenterListV1",
|
|
19
|
+
"title": "Get data center list",
|
|
20
|
+
"annotations": {
|
|
21
|
+
"title": "Get data center list",
|
|
22
|
+
"readOnlyHint": true,
|
|
23
|
+
"destructiveHint": false
|
|
24
|
+
},
|
|
25
|
+
"description": "Retrieve all available data centers.\n\nUse this endpoint to view location options before deploying VPS instances.",
|
|
26
|
+
"method": "GET",
|
|
27
|
+
"path": "/api/vps/v1/data-centers",
|
|
28
|
+
"inputSchema": {
|
|
29
|
+
"type": "object",
|
|
30
|
+
"properties": {},
|
|
31
|
+
"required": []
|
|
32
|
+
},
|
|
33
|
+
"security": [
|
|
34
|
+
{
|
|
35
|
+
"apiToken": []
|
|
36
|
+
}
|
|
37
|
+
],
|
|
38
|
+
"group": "vps"
|
|
39
|
+
},
|
|
40
|
+
{
|
|
41
|
+
"name": "VPS_getProjectContainersV1",
|
|
42
|
+
"title": "Get project containers",
|
|
43
|
+
"annotations": {
|
|
44
|
+
"title": "Get project containers",
|
|
45
|
+
"readOnlyHint": true,
|
|
46
|
+
"destructiveHint": false
|
|
47
|
+
},
|
|
48
|
+
"description": "Retrieves a list of all containers belonging to a specific Docker Compose project on the virtual machine. \n\nThis endpoint returns detailed information about each container including\ntheir current status, port mappings, and runtime configuration.\n\nUse this to monitor the health and state of all services within your Docker Compose project.",
|
|
49
|
+
"method": "GET",
|
|
50
|
+
"path": "/api/vps/v1/virtual-machines/{virtualMachineId}/docker/{projectName}/containers",
|
|
51
|
+
"inputSchema": {
|
|
52
|
+
"type": "object",
|
|
53
|
+
"properties": {
|
|
54
|
+
"virtualMachineId": {
|
|
55
|
+
"type": "integer",
|
|
56
|
+
"description": "Virtual Machine ID"
|
|
57
|
+
},
|
|
58
|
+
"projectName": {
|
|
59
|
+
"type": "string",
|
|
60
|
+
"description": "Docker Compose project name using alphanumeric characters, dashes, and underscores only"
|
|
61
|
+
}
|
|
62
|
+
},
|
|
63
|
+
"required": [
|
|
64
|
+
"virtualMachineId",
|
|
65
|
+
"projectName"
|
|
66
|
+
]
|
|
67
|
+
},
|
|
68
|
+
"security": [
|
|
69
|
+
{
|
|
70
|
+
"apiToken": []
|
|
71
|
+
}
|
|
72
|
+
],
|
|
73
|
+
"group": "vps"
|
|
74
|
+
},
|
|
75
|
+
{
|
|
76
|
+
"name": "VPS_getProjectContentsV1",
|
|
77
|
+
"title": "Get project contents",
|
|
78
|
+
"annotations": {
|
|
79
|
+
"title": "Get project contents",
|
|
80
|
+
"readOnlyHint": true,
|
|
81
|
+
"destructiveHint": false
|
|
82
|
+
},
|
|
83
|
+
"description": "Retrieves the complete project information including the docker-compose.yml\nfile contents, project metadata, and current deployment status.\n\nThis endpoint provides the full configuration and state details of a specific Docker Compose project. \n\nUse this to inspect project settings, review the compose file, or check the overall project health.",
|
|
84
|
+
"method": "GET",
|
|
85
|
+
"path": "/api/vps/v1/virtual-machines/{virtualMachineId}/docker/{projectName}",
|
|
86
|
+
"inputSchema": {
|
|
87
|
+
"type": "object",
|
|
88
|
+
"properties": {
|
|
89
|
+
"virtualMachineId": {
|
|
90
|
+
"type": "integer",
|
|
91
|
+
"description": "Virtual Machine ID"
|
|
92
|
+
},
|
|
93
|
+
"projectName": {
|
|
94
|
+
"type": "string",
|
|
95
|
+
"description": "Docker Compose project name using alphanumeric characters, dashes, and underscores only"
|
|
96
|
+
}
|
|
97
|
+
},
|
|
98
|
+
"required": [
|
|
99
|
+
"virtualMachineId",
|
|
100
|
+
"projectName"
|
|
101
|
+
]
|
|
102
|
+
},
|
|
103
|
+
"security": [
|
|
104
|
+
{
|
|
105
|
+
"apiToken": []
|
|
106
|
+
}
|
|
107
|
+
],
|
|
108
|
+
"group": "vps"
|
|
109
|
+
},
|
|
110
|
+
{
|
|
111
|
+
"name": "VPS_deleteProjectV1",
|
|
112
|
+
"title": "Delete project",
|
|
113
|
+
"annotations": {
|
|
114
|
+
"title": "Delete project",
|
|
115
|
+
"readOnlyHint": false,
|
|
116
|
+
"destructiveHint": true,
|
|
117
|
+
"idempotentHint": true
|
|
118
|
+
},
|
|
119
|
+
"description": "Completely removes a Docker Compose project from the virtual machine, stopping all containers and cleaning up \nassociated resources including networks, volumes, and images. \n\nThis operation is irreversible and will delete all project data. \n\nUse this when you want to permanently remove a project and free up system resources.",
|
|
120
|
+
"method": "DELETE",
|
|
121
|
+
"path": "/api/vps/v1/virtual-machines/{virtualMachineId}/docker/{projectName}/down",
|
|
122
|
+
"inputSchema": {
|
|
123
|
+
"type": "object",
|
|
124
|
+
"properties": {
|
|
125
|
+
"virtualMachineId": {
|
|
126
|
+
"type": "integer",
|
|
127
|
+
"description": "Virtual Machine ID"
|
|
128
|
+
},
|
|
129
|
+
"projectName": {
|
|
130
|
+
"type": "string",
|
|
131
|
+
"description": "Docker Compose project name using alphanumeric characters, dashes, and underscores only"
|
|
132
|
+
}
|
|
133
|
+
},
|
|
134
|
+
"required": [
|
|
135
|
+
"virtualMachineId",
|
|
136
|
+
"projectName"
|
|
137
|
+
]
|
|
138
|
+
},
|
|
139
|
+
"security": [
|
|
140
|
+
{
|
|
141
|
+
"apiToken": []
|
|
142
|
+
}
|
|
143
|
+
],
|
|
144
|
+
"group": "vps"
|
|
145
|
+
},
|
|
146
|
+
{
|
|
147
|
+
"name": "VPS_getProjectListV1",
|
|
148
|
+
"title": "Get project list",
|
|
149
|
+
"annotations": {
|
|
150
|
+
"title": "Get project list",
|
|
151
|
+
"readOnlyHint": true,
|
|
152
|
+
"destructiveHint": false
|
|
153
|
+
},
|
|
154
|
+
"description": "Retrieves a list of all Docker Compose projects currently deployed on the virtual machine. \n\nThis endpoint returns basic information about each project including name,\nstatus, file path and list of containers with details about their names,\nimage, status, health and ports. Container stats are omitted in this\nendpoint. If you need to get detailed information about container with\nstats included, use the `Get project containers` endpoint.\n\nUse this to get an overview of all Docker projects on your VPS instance.",
|
|
155
|
+
"method": "GET",
|
|
156
|
+
"path": "/api/vps/v1/virtual-machines/{virtualMachineId}/docker",
|
|
157
|
+
"inputSchema": {
|
|
158
|
+
"type": "object",
|
|
159
|
+
"properties": {
|
|
160
|
+
"virtualMachineId": {
|
|
161
|
+
"type": "integer",
|
|
162
|
+
"description": "Virtual Machine ID"
|
|
163
|
+
}
|
|
164
|
+
},
|
|
165
|
+
"required": [
|
|
166
|
+
"virtualMachineId"
|
|
167
|
+
]
|
|
168
|
+
},
|
|
169
|
+
"security": [
|
|
170
|
+
{
|
|
171
|
+
"apiToken": []
|
|
172
|
+
}
|
|
173
|
+
],
|
|
174
|
+
"group": "vps"
|
|
175
|
+
},
|
|
176
|
+
{
|
|
177
|
+
"name": "VPS_createNewProjectV1",
|
|
178
|
+
"title": "Create new project",
|
|
179
|
+
"annotations": {
|
|
180
|
+
"title": "Create new project",
|
|
181
|
+
"readOnlyHint": false,
|
|
182
|
+
"destructiveHint": false
|
|
183
|
+
},
|
|
184
|
+
"description": "Deploy new project from docker-compose.yaml contents or download contents from URL. \n\nURL can be Github repository url in format https://github.com/[user]/[repo]\nand it will be automatically resolved to docker-compose.yaml file in\nmaster branch. Any other URL provided must return docker-compose.yaml\nfile contents.\n\nIf project with the same name already exists, existing project will be replaced.",
|
|
185
|
+
"method": "POST",
|
|
186
|
+
"path": "/api/vps/v1/virtual-machines/{virtualMachineId}/docker",
|
|
187
|
+
"inputSchema": {
|
|
188
|
+
"type": "object",
|
|
189
|
+
"properties": {
|
|
190
|
+
"virtualMachineId": {
|
|
191
|
+
"type": "integer",
|
|
192
|
+
"description": "Virtual Machine ID"
|
|
193
|
+
},
|
|
194
|
+
"project_name": {
|
|
195
|
+
"type": "string",
|
|
196
|
+
"description": "Docker Compose project name using alphanumeric characters, dashes, and underscores only"
|
|
197
|
+
},
|
|
198
|
+
"content": {
|
|
199
|
+
"type": "string",
|
|
200
|
+
"description": "URL pointing to docker-compose.yaml file, Github repository or raw YAML content of the compose file"
|
|
201
|
+
},
|
|
202
|
+
"environment": {
|
|
203
|
+
"type": "string",
|
|
204
|
+
"description": "Project environment variables"
|
|
205
|
+
}
|
|
206
|
+
},
|
|
207
|
+
"required": [
|
|
208
|
+
"virtualMachineId",
|
|
209
|
+
"project_name",
|
|
210
|
+
"content"
|
|
211
|
+
]
|
|
212
|
+
},
|
|
213
|
+
"security": [
|
|
214
|
+
{
|
|
215
|
+
"apiToken": []
|
|
216
|
+
}
|
|
217
|
+
],
|
|
218
|
+
"group": "vps"
|
|
219
|
+
},
|
|
220
|
+
{
|
|
221
|
+
"name": "VPS_getProjectLogsV1",
|
|
222
|
+
"title": "Get project logs",
|
|
223
|
+
"annotations": {
|
|
224
|
+
"title": "Get project logs",
|
|
225
|
+
"readOnlyHint": true,
|
|
226
|
+
"destructiveHint": false
|
|
227
|
+
},
|
|
228
|
+
"description": "Retrieves aggregated log entries from all services within a Docker Compose project. \n\nThis endpoint returns recent log output from each container, organized by service name with timestamps. \nThe response contains the last 300 log entries across all services. \n\nUse this for debugging, monitoring application behavior, and\ntroubleshooting issues across your entire project stack.",
|
|
229
|
+
"method": "GET",
|
|
230
|
+
"path": "/api/vps/v1/virtual-machines/{virtualMachineId}/docker/{projectName}/logs",
|
|
231
|
+
"inputSchema": {
|
|
232
|
+
"type": "object",
|
|
233
|
+
"properties": {
|
|
234
|
+
"virtualMachineId": {
|
|
235
|
+
"type": "integer",
|
|
236
|
+
"description": "Virtual Machine ID"
|
|
237
|
+
},
|
|
238
|
+
"projectName": {
|
|
239
|
+
"type": "string",
|
|
240
|
+
"description": "Docker Compose project name using alphanumeric characters, dashes, and underscores only"
|
|
241
|
+
}
|
|
242
|
+
},
|
|
243
|
+
"required": [
|
|
244
|
+
"virtualMachineId",
|
|
245
|
+
"projectName"
|
|
246
|
+
]
|
|
247
|
+
},
|
|
248
|
+
"security": [
|
|
249
|
+
{
|
|
250
|
+
"apiToken": []
|
|
251
|
+
}
|
|
252
|
+
],
|
|
253
|
+
"group": "vps"
|
|
254
|
+
},
|
|
255
|
+
{
|
|
256
|
+
"name": "VPS_restartProjectV1",
|
|
257
|
+
"title": "Restart project",
|
|
258
|
+
"annotations": {
|
|
259
|
+
"title": "Restart project",
|
|
260
|
+
"readOnlyHint": false,
|
|
261
|
+
"destructiveHint": false
|
|
262
|
+
},
|
|
263
|
+
"description": "Restarts all services in a Docker Compose project by stopping and starting\ncontainers in the correct dependency order.\n\nThis operation preserves data volumes and network configurations while refreshing the running containers. \n\nUse this to apply configuration changes or recover from service failures.",
|
|
264
|
+
"method": "POST",
|
|
265
|
+
"path": "/api/vps/v1/virtual-machines/{virtualMachineId}/docker/{projectName}/restart",
|
|
266
|
+
"inputSchema": {
|
|
267
|
+
"type": "object",
|
|
268
|
+
"properties": {
|
|
269
|
+
"virtualMachineId": {
|
|
270
|
+
"type": "integer",
|
|
271
|
+
"description": "Virtual Machine ID"
|
|
272
|
+
},
|
|
273
|
+
"projectName": {
|
|
274
|
+
"type": "string",
|
|
275
|
+
"description": "Docker Compose project name using alphanumeric characters, dashes, and underscores only"
|
|
276
|
+
}
|
|
277
|
+
},
|
|
278
|
+
"required": [
|
|
279
|
+
"virtualMachineId",
|
|
280
|
+
"projectName"
|
|
281
|
+
]
|
|
282
|
+
},
|
|
283
|
+
"security": [
|
|
284
|
+
{
|
|
285
|
+
"apiToken": []
|
|
286
|
+
}
|
|
287
|
+
],
|
|
288
|
+
"group": "vps"
|
|
289
|
+
},
|
|
290
|
+
{
|
|
291
|
+
"name": "VPS_startProjectV1",
|
|
292
|
+
"title": "Start project",
|
|
293
|
+
"annotations": {
|
|
294
|
+
"title": "Start project",
|
|
295
|
+
"readOnlyHint": false,
|
|
296
|
+
"destructiveHint": false
|
|
297
|
+
},
|
|
298
|
+
"description": "Starts all services in a Docker Compose project that are currently stopped. \n\nThis operation brings up containers in the correct dependency order as defined in the compose file. \n\nUse this to resume a project that was previously stopped or to start services after a system reboot.",
|
|
299
|
+
"method": "POST",
|
|
300
|
+
"path": "/api/vps/v1/virtual-machines/{virtualMachineId}/docker/{projectName}/start",
|
|
301
|
+
"inputSchema": {
|
|
302
|
+
"type": "object",
|
|
303
|
+
"properties": {
|
|
304
|
+
"virtualMachineId": {
|
|
305
|
+
"type": "integer",
|
|
306
|
+
"description": "Virtual Machine ID"
|
|
307
|
+
},
|
|
308
|
+
"projectName": {
|
|
309
|
+
"type": "string",
|
|
310
|
+
"description": "Docker Compose project name using alphanumeric characters, dashes, and underscores only"
|
|
311
|
+
}
|
|
312
|
+
},
|
|
313
|
+
"required": [
|
|
314
|
+
"virtualMachineId",
|
|
315
|
+
"projectName"
|
|
316
|
+
]
|
|
317
|
+
},
|
|
318
|
+
"security": [
|
|
319
|
+
{
|
|
320
|
+
"apiToken": []
|
|
321
|
+
}
|
|
322
|
+
],
|
|
323
|
+
"group": "vps"
|
|
324
|
+
},
|
|
325
|
+
{
|
|
326
|
+
"name": "VPS_stopProjectV1",
|
|
327
|
+
"title": "Stop project",
|
|
328
|
+
"annotations": {
|
|
329
|
+
"title": "Stop project",
|
|
330
|
+
"readOnlyHint": false,
|
|
331
|
+
"destructiveHint": true
|
|
332
|
+
},
|
|
333
|
+
"description": "Stops all running services in a Docker Compose project while preserving\ncontainer configurations and data volumes.\n\nThis operation gracefully shuts down containers in reverse dependency order. \n\nUse this to temporarily halt a project without removing data or configurations.",
|
|
334
|
+
"method": "POST",
|
|
335
|
+
"path": "/api/vps/v1/virtual-machines/{virtualMachineId}/docker/{projectName}/stop",
|
|
336
|
+
"inputSchema": {
|
|
337
|
+
"type": "object",
|
|
338
|
+
"properties": {
|
|
339
|
+
"virtualMachineId": {
|
|
340
|
+
"type": "integer",
|
|
341
|
+
"description": "Virtual Machine ID"
|
|
342
|
+
},
|
|
343
|
+
"projectName": {
|
|
344
|
+
"type": "string",
|
|
345
|
+
"description": "Docker Compose project name using alphanumeric characters, dashes, and underscores only"
|
|
346
|
+
}
|
|
347
|
+
},
|
|
348
|
+
"required": [
|
|
349
|
+
"virtualMachineId",
|
|
350
|
+
"projectName"
|
|
351
|
+
]
|
|
352
|
+
},
|
|
353
|
+
"security": [
|
|
354
|
+
{
|
|
355
|
+
"apiToken": []
|
|
356
|
+
}
|
|
357
|
+
],
|
|
358
|
+
"group": "vps"
|
|
359
|
+
},
|
|
360
|
+
{
|
|
361
|
+
"name": "VPS_updateProjectV1",
|
|
362
|
+
"title": "Update project",
|
|
363
|
+
"annotations": {
|
|
364
|
+
"title": "Update project",
|
|
365
|
+
"readOnlyHint": false,
|
|
366
|
+
"destructiveHint": false
|
|
367
|
+
},
|
|
368
|
+
"description": "Updates a Docker Compose project by pulling the latest image versions and\nrecreating containers with new configurations.\n\nThis operation preserves data volumes while applying changes from the compose file. \n\nUse this to deploy application updates, apply configuration changes, or\nrefresh container images to their latest versions.",
|
|
369
|
+
"method": "POST",
|
|
370
|
+
"path": "/api/vps/v1/virtual-machines/{virtualMachineId}/docker/{projectName}/update",
|
|
371
|
+
"inputSchema": {
|
|
372
|
+
"type": "object",
|
|
373
|
+
"properties": {
|
|
374
|
+
"virtualMachineId": {
|
|
375
|
+
"type": "integer",
|
|
376
|
+
"description": "Virtual Machine ID"
|
|
377
|
+
},
|
|
378
|
+
"projectName": {
|
|
379
|
+
"type": "string",
|
|
380
|
+
"description": "Docker Compose project name using alphanumeric characters, dashes, and underscores only"
|
|
381
|
+
}
|
|
382
|
+
},
|
|
383
|
+
"required": [
|
|
384
|
+
"virtualMachineId",
|
|
385
|
+
"projectName"
|
|
386
|
+
]
|
|
387
|
+
},
|
|
388
|
+
"security": [
|
|
389
|
+
{
|
|
390
|
+
"apiToken": []
|
|
391
|
+
}
|
|
392
|
+
],
|
|
393
|
+
"group": "vps"
|
|
394
|
+
},
|
|
395
|
+
{
|
|
396
|
+
"name": "VPS_activateFirewallV1",
|
|
397
|
+
"title": "Activate firewall",
|
|
398
|
+
"annotations": {
|
|
399
|
+
"title": "Activate firewall",
|
|
400
|
+
"readOnlyHint": false,
|
|
401
|
+
"destructiveHint": false
|
|
402
|
+
},
|
|
403
|
+
"description": "Activate a firewall for a specified virtual machine.\n\nOnly one firewall can be active for a virtual machine at a time.\n\nUse this endpoint to apply firewall rules to VPS instances.",
|
|
404
|
+
"method": "POST",
|
|
405
|
+
"path": "/api/vps/v1/firewall/{firewallId}/activate/{virtualMachineId}",
|
|
406
|
+
"inputSchema": {
|
|
407
|
+
"type": "object",
|
|
408
|
+
"properties": {
|
|
409
|
+
"firewallId": {
|
|
410
|
+
"type": "integer",
|
|
411
|
+
"description": "Firewall ID"
|
|
412
|
+
},
|
|
413
|
+
"virtualMachineId": {
|
|
414
|
+
"type": "integer",
|
|
415
|
+
"description": "Virtual Machine ID"
|
|
416
|
+
}
|
|
417
|
+
},
|
|
418
|
+
"required": [
|
|
419
|
+
"firewallId",
|
|
420
|
+
"virtualMachineId"
|
|
421
|
+
]
|
|
422
|
+
},
|
|
423
|
+
"security": [
|
|
424
|
+
{
|
|
425
|
+
"apiToken": []
|
|
426
|
+
}
|
|
427
|
+
],
|
|
428
|
+
"group": "vps"
|
|
429
|
+
},
|
|
430
|
+
{
|
|
431
|
+
"name": "VPS_deactivateFirewallV1",
|
|
432
|
+
"title": "Deactivate firewall",
|
|
433
|
+
"annotations": {
|
|
434
|
+
"title": "Deactivate firewall",
|
|
435
|
+
"readOnlyHint": false,
|
|
436
|
+
"destructiveHint": false
|
|
437
|
+
},
|
|
438
|
+
"description": "Deactivate a firewall for a specified virtual machine.\n\nUse this endpoint to remove firewall protection from VPS instances.",
|
|
439
|
+
"method": "POST",
|
|
440
|
+
"path": "/api/vps/v1/firewall/{firewallId}/deactivate/{virtualMachineId}",
|
|
441
|
+
"inputSchema": {
|
|
442
|
+
"type": "object",
|
|
443
|
+
"properties": {
|
|
444
|
+
"firewallId": {
|
|
445
|
+
"type": "integer",
|
|
446
|
+
"description": "Firewall ID"
|
|
447
|
+
},
|
|
448
|
+
"virtualMachineId": {
|
|
449
|
+
"type": "integer",
|
|
450
|
+
"description": "Virtual Machine ID"
|
|
451
|
+
}
|
|
452
|
+
},
|
|
453
|
+
"required": [
|
|
454
|
+
"firewallId",
|
|
455
|
+
"virtualMachineId"
|
|
456
|
+
]
|
|
457
|
+
},
|
|
458
|
+
"security": [
|
|
459
|
+
{
|
|
460
|
+
"apiToken": []
|
|
461
|
+
}
|
|
462
|
+
],
|
|
463
|
+
"group": "vps"
|
|
464
|
+
},
|
|
465
|
+
{
|
|
466
|
+
"name": "VPS_getFirewallDetailsV1",
|
|
467
|
+
"title": "Get firewall details",
|
|
468
|
+
"annotations": {
|
|
469
|
+
"title": "Get firewall details",
|
|
470
|
+
"readOnlyHint": true,
|
|
471
|
+
"destructiveHint": false
|
|
472
|
+
},
|
|
473
|
+
"description": "Retrieve firewall by its ID and rules associated with it.\n\nUse this endpoint to view specific firewall configuration and rules.",
|
|
474
|
+
"method": "GET",
|
|
475
|
+
"path": "/api/vps/v1/firewall/{firewallId}",
|
|
476
|
+
"inputSchema": {
|
|
477
|
+
"type": "object",
|
|
478
|
+
"properties": {
|
|
479
|
+
"firewallId": {
|
|
480
|
+
"type": "integer",
|
|
481
|
+
"description": "Firewall ID"
|
|
482
|
+
}
|
|
483
|
+
},
|
|
484
|
+
"required": [
|
|
485
|
+
"firewallId"
|
|
486
|
+
]
|
|
487
|
+
},
|
|
488
|
+
"security": [
|
|
489
|
+
{
|
|
490
|
+
"apiToken": []
|
|
491
|
+
}
|
|
492
|
+
],
|
|
493
|
+
"group": "vps"
|
|
494
|
+
},
|
|
495
|
+
{
|
|
496
|
+
"name": "VPS_deleteFirewallV1",
|
|
497
|
+
"title": "Delete firewall",
|
|
498
|
+
"annotations": {
|
|
499
|
+
"title": "Delete firewall",
|
|
500
|
+
"readOnlyHint": false,
|
|
501
|
+
"destructiveHint": true,
|
|
502
|
+
"idempotentHint": true
|
|
503
|
+
},
|
|
504
|
+
"description": "Delete a specified firewall.\n\nAny virtual machine that has this firewall activated will automatically have it deactivated.\n\nUse this endpoint to remove unused firewall configurations.",
|
|
505
|
+
"method": "DELETE",
|
|
506
|
+
"path": "/api/vps/v1/firewall/{firewallId}",
|
|
507
|
+
"inputSchema": {
|
|
508
|
+
"type": "object",
|
|
509
|
+
"properties": {
|
|
510
|
+
"firewallId": {
|
|
511
|
+
"type": "integer",
|
|
512
|
+
"description": "Firewall ID"
|
|
513
|
+
}
|
|
514
|
+
},
|
|
515
|
+
"required": [
|
|
516
|
+
"firewallId"
|
|
517
|
+
]
|
|
518
|
+
},
|
|
519
|
+
"security": [
|
|
520
|
+
{
|
|
521
|
+
"apiToken": []
|
|
522
|
+
}
|
|
523
|
+
],
|
|
524
|
+
"group": "vps"
|
|
525
|
+
},
|
|
526
|
+
{
|
|
527
|
+
"name": "VPS_getFirewallListV1",
|
|
528
|
+
"title": "Get firewall list",
|
|
529
|
+
"annotations": {
|
|
530
|
+
"title": "Get firewall list",
|
|
531
|
+
"readOnlyHint": true,
|
|
532
|
+
"destructiveHint": false
|
|
533
|
+
},
|
|
534
|
+
"description": "Retrieve all available firewalls.\n\nUse this endpoint to view existing firewall configurations.",
|
|
535
|
+
"method": "GET",
|
|
536
|
+
"path": "/api/vps/v1/firewall",
|
|
537
|
+
"inputSchema": {
|
|
538
|
+
"type": "object",
|
|
539
|
+
"properties": {
|
|
540
|
+
"page": {
|
|
541
|
+
"type": "integer",
|
|
542
|
+
"description": "Page number"
|
|
543
|
+
}
|
|
544
|
+
},
|
|
545
|
+
"required": []
|
|
546
|
+
},
|
|
547
|
+
"security": [
|
|
548
|
+
{
|
|
549
|
+
"apiToken": []
|
|
550
|
+
}
|
|
551
|
+
],
|
|
552
|
+
"group": "vps"
|
|
553
|
+
},
|
|
554
|
+
{
|
|
555
|
+
"name": "VPS_createNewFirewallV1",
|
|
556
|
+
"title": "Create new firewall",
|
|
557
|
+
"annotations": {
|
|
558
|
+
"title": "Create new firewall",
|
|
559
|
+
"readOnlyHint": false,
|
|
560
|
+
"destructiveHint": false
|
|
561
|
+
},
|
|
562
|
+
"description": "Create a new firewall.\n\nUse this endpoint to set up new firewall configurations for VPS security.",
|
|
563
|
+
"method": "POST",
|
|
564
|
+
"path": "/api/vps/v1/firewall",
|
|
565
|
+
"inputSchema": {
|
|
566
|
+
"type": "object",
|
|
567
|
+
"properties": {
|
|
568
|
+
"name": {
|
|
569
|
+
"type": "string",
|
|
570
|
+
"description": "name parameter"
|
|
571
|
+
}
|
|
572
|
+
},
|
|
573
|
+
"required": [
|
|
574
|
+
"name"
|
|
575
|
+
]
|
|
576
|
+
},
|
|
577
|
+
"security": [
|
|
578
|
+
{
|
|
579
|
+
"apiToken": []
|
|
580
|
+
}
|
|
581
|
+
],
|
|
582
|
+
"group": "vps"
|
|
583
|
+
},
|
|
584
|
+
{
|
|
585
|
+
"name": "VPS_updateFirewallRuleV1",
|
|
586
|
+
"title": "Update firewall rule",
|
|
587
|
+
"annotations": {
|
|
588
|
+
"title": "Update firewall rule",
|
|
589
|
+
"readOnlyHint": false,
|
|
590
|
+
"destructiveHint": true,
|
|
591
|
+
"idempotentHint": true
|
|
592
|
+
},
|
|
593
|
+
"description": "Update a specific firewall rule from a specified firewall.\n\nAny virtual machine that has this firewall activated will lose sync with the firewall\nand will have to be synced again manually.\n\nUse this endpoint to modify existing firewall rules.",
|
|
594
|
+
"method": "PUT",
|
|
595
|
+
"path": "/api/vps/v1/firewall/{firewallId}/rules/{ruleId}",
|
|
596
|
+
"inputSchema": {
|
|
597
|
+
"type": "object",
|
|
598
|
+
"properties": {
|
|
599
|
+
"firewallId": {
|
|
600
|
+
"type": "integer",
|
|
601
|
+
"description": "Firewall ID"
|
|
602
|
+
},
|
|
603
|
+
"ruleId": {
|
|
604
|
+
"type": "integer",
|
|
605
|
+
"description": "Firewall Rule ID"
|
|
606
|
+
},
|
|
607
|
+
"protocol": {
|
|
608
|
+
"type": "string",
|
|
609
|
+
"description": "protocol parameter",
|
|
610
|
+
"enum": [
|
|
611
|
+
"TCP",
|
|
612
|
+
"UDP",
|
|
613
|
+
"ICMP",
|
|
614
|
+
"GRE",
|
|
615
|
+
"any",
|
|
616
|
+
"ESP",
|
|
617
|
+
"AH",
|
|
618
|
+
"ICMPv6",
|
|
619
|
+
"SSH",
|
|
620
|
+
"HTTP",
|
|
621
|
+
"HTTPS",
|
|
622
|
+
"MySQL",
|
|
623
|
+
"PostgreSQL"
|
|
624
|
+
]
|
|
625
|
+
},
|
|
626
|
+
"port": {
|
|
627
|
+
"type": "string",
|
|
628
|
+
"description": "Port or port range, ex: 1024:2048"
|
|
629
|
+
},
|
|
630
|
+
"source": {
|
|
631
|
+
"type": "string",
|
|
632
|
+
"description": "source parameter",
|
|
633
|
+
"enum": [
|
|
634
|
+
"any",
|
|
635
|
+
"custom"
|
|
636
|
+
]
|
|
637
|
+
},
|
|
638
|
+
"source_detail": {
|
|
639
|
+
"type": "string",
|
|
640
|
+
"description": "IP range, CIDR, single IP or `any`"
|
|
641
|
+
}
|
|
642
|
+
},
|
|
643
|
+
"required": [
|
|
644
|
+
"firewallId",
|
|
645
|
+
"ruleId",
|
|
646
|
+
"protocol",
|
|
647
|
+
"port",
|
|
648
|
+
"source",
|
|
649
|
+
"source_detail"
|
|
650
|
+
]
|
|
651
|
+
},
|
|
652
|
+
"security": [
|
|
653
|
+
{
|
|
654
|
+
"apiToken": []
|
|
655
|
+
}
|
|
656
|
+
],
|
|
657
|
+
"group": "vps"
|
|
658
|
+
},
|
|
659
|
+
{
|
|
660
|
+
"name": "VPS_deleteFirewallRuleV1",
|
|
661
|
+
"title": "Delete firewall rule",
|
|
662
|
+
"annotations": {
|
|
663
|
+
"title": "Delete firewall rule",
|
|
664
|
+
"readOnlyHint": false,
|
|
665
|
+
"destructiveHint": true,
|
|
666
|
+
"idempotentHint": true
|
|
667
|
+
},
|
|
668
|
+
"description": "Delete a specific firewall rule from a specified firewall.\n\nAny virtual machine that has this firewall activated will lose sync with the firewall\nand will have to be synced again manually.\n\nUse this endpoint to remove specific firewall rules.",
|
|
669
|
+
"method": "DELETE",
|
|
670
|
+
"path": "/api/vps/v1/firewall/{firewallId}/rules/{ruleId}",
|
|
671
|
+
"inputSchema": {
|
|
672
|
+
"type": "object",
|
|
673
|
+
"properties": {
|
|
674
|
+
"firewallId": {
|
|
675
|
+
"type": "integer",
|
|
676
|
+
"description": "Firewall ID"
|
|
677
|
+
},
|
|
678
|
+
"ruleId": {
|
|
679
|
+
"type": "integer",
|
|
680
|
+
"description": "Firewall Rule ID"
|
|
681
|
+
}
|
|
682
|
+
},
|
|
683
|
+
"required": [
|
|
684
|
+
"firewallId",
|
|
685
|
+
"ruleId"
|
|
686
|
+
]
|
|
687
|
+
},
|
|
688
|
+
"security": [
|
|
689
|
+
{
|
|
690
|
+
"apiToken": []
|
|
691
|
+
}
|
|
692
|
+
],
|
|
693
|
+
"group": "vps"
|
|
694
|
+
},
|
|
695
|
+
{
|
|
696
|
+
"name": "VPS_replaceAllFirewallRulesInGroupV1",
|
|
697
|
+
"title": "Replace all firewall rules in group",
|
|
698
|
+
"annotations": {
|
|
699
|
+
"title": "Replace all firewall rules in group",
|
|
700
|
+
"readOnlyHint": false,
|
|
701
|
+
"destructiveHint": true,
|
|
702
|
+
"idempotentHint": true
|
|
703
|
+
},
|
|
704
|
+
"description": "Replaces all firewall rules within a specified firewall group with the provided set of rules\nin a single atomic operation, instead of creating or deleting rules one by one.\n\nAny virtual machine using this firewall group will need to be synchronized after replacing rules;\npass the \"sync\" parameter to trigger synchronization immediately.",
|
|
705
|
+
"method": "PUT",
|
|
706
|
+
"path": "/api/vps/v1/firewall/{firewallId}/rules",
|
|
707
|
+
"inputSchema": {
|
|
708
|
+
"type": "object",
|
|
709
|
+
"properties": {
|
|
710
|
+
"firewallId": {
|
|
711
|
+
"type": "integer",
|
|
712
|
+
"description": "Firewall ID"
|
|
713
|
+
},
|
|
714
|
+
"rules": {
|
|
715
|
+
"type": "array",
|
|
716
|
+
"description": "The complete set of firewall rules that atomically replaces all existing rules in the group",
|
|
717
|
+
"items": {
|
|
718
|
+
"type": "string",
|
|
719
|
+
"description": "rules parameter"
|
|
720
|
+
}
|
|
721
|
+
},
|
|
722
|
+
"sync": {
|
|
723
|
+
"type": "boolean",
|
|
724
|
+
"description": "Synchronize the firewall group to all its virtual machines after replacing the rules"
|
|
725
|
+
}
|
|
726
|
+
},
|
|
727
|
+
"required": [
|
|
728
|
+
"firewallId",
|
|
729
|
+
"rules"
|
|
730
|
+
]
|
|
731
|
+
},
|
|
732
|
+
"security": [
|
|
733
|
+
{
|
|
734
|
+
"apiToken": []
|
|
735
|
+
}
|
|
736
|
+
],
|
|
737
|
+
"group": "vps"
|
|
738
|
+
},
|
|
739
|
+
{
|
|
740
|
+
"name": "VPS_createFirewallRuleV1",
|
|
741
|
+
"title": "Create firewall rule",
|
|
742
|
+
"annotations": {
|
|
743
|
+
"title": "Create firewall rule",
|
|
744
|
+
"readOnlyHint": false,
|
|
745
|
+
"destructiveHint": false
|
|
746
|
+
},
|
|
747
|
+
"description": "Create new firewall rule for a specified firewall.\n\nBy default, the firewall drops all incoming traffic,\nwhich means you must add accept rules for all ports you want to use.\n\nAny virtual machine that has this firewall activated will lose sync with the firewall\nand will have to be synced again manually.\n\nUse this endpoint to add new security rules to firewalls.",
|
|
748
|
+
"method": "POST",
|
|
749
|
+
"path": "/api/vps/v1/firewall/{firewallId}/rules",
|
|
750
|
+
"inputSchema": {
|
|
751
|
+
"type": "object",
|
|
752
|
+
"properties": {
|
|
753
|
+
"firewallId": {
|
|
754
|
+
"type": "integer",
|
|
755
|
+
"description": "Firewall ID"
|
|
756
|
+
},
|
|
757
|
+
"protocol": {
|
|
758
|
+
"type": "string",
|
|
759
|
+
"description": "protocol parameter",
|
|
760
|
+
"enum": [
|
|
761
|
+
"TCP",
|
|
762
|
+
"UDP",
|
|
763
|
+
"ICMP",
|
|
764
|
+
"GRE",
|
|
765
|
+
"any",
|
|
766
|
+
"ESP",
|
|
767
|
+
"AH",
|
|
768
|
+
"ICMPv6",
|
|
769
|
+
"SSH",
|
|
770
|
+
"HTTP",
|
|
771
|
+
"HTTPS",
|
|
772
|
+
"MySQL",
|
|
773
|
+
"PostgreSQL"
|
|
774
|
+
]
|
|
775
|
+
},
|
|
776
|
+
"port": {
|
|
777
|
+
"type": "string",
|
|
778
|
+
"description": "Port or port range, ex: 1024:2048"
|
|
779
|
+
},
|
|
780
|
+
"source": {
|
|
781
|
+
"type": "string",
|
|
782
|
+
"description": "source parameter",
|
|
783
|
+
"enum": [
|
|
784
|
+
"any",
|
|
785
|
+
"custom"
|
|
786
|
+
]
|
|
787
|
+
},
|
|
788
|
+
"source_detail": {
|
|
789
|
+
"type": "string",
|
|
790
|
+
"description": "IP range, CIDR, single IP or `any`"
|
|
791
|
+
}
|
|
792
|
+
},
|
|
793
|
+
"required": [
|
|
794
|
+
"firewallId",
|
|
795
|
+
"protocol",
|
|
796
|
+
"port",
|
|
797
|
+
"source",
|
|
798
|
+
"source_detail"
|
|
799
|
+
]
|
|
800
|
+
},
|
|
801
|
+
"security": [
|
|
802
|
+
{
|
|
803
|
+
"apiToken": []
|
|
804
|
+
}
|
|
805
|
+
],
|
|
806
|
+
"group": "vps"
|
|
807
|
+
},
|
|
808
|
+
{
|
|
809
|
+
"name": "VPS_syncFirewallV1",
|
|
810
|
+
"title": "Sync firewall",
|
|
811
|
+
"annotations": {
|
|
812
|
+
"title": "Sync firewall",
|
|
813
|
+
"readOnlyHint": false,
|
|
814
|
+
"destructiveHint": false
|
|
815
|
+
},
|
|
816
|
+
"description": "Sync a firewall for a specified virtual machine.\n\nFirewall can lose sync with virtual machine if the firewall has new rules added, removed or updated.\n\nUse this endpoint to apply updated firewall rules to VPS instances.",
|
|
817
|
+
"method": "POST",
|
|
818
|
+
"path": "/api/vps/v1/firewall/{firewallId}/sync/{virtualMachineId}",
|
|
819
|
+
"inputSchema": {
|
|
820
|
+
"type": "object",
|
|
821
|
+
"properties": {
|
|
822
|
+
"firewallId": {
|
|
823
|
+
"type": "integer",
|
|
824
|
+
"description": "Firewall ID"
|
|
825
|
+
},
|
|
826
|
+
"virtualMachineId": {
|
|
827
|
+
"type": "integer",
|
|
828
|
+
"description": "Virtual Machine ID"
|
|
829
|
+
}
|
|
830
|
+
},
|
|
831
|
+
"required": [
|
|
832
|
+
"firewallId",
|
|
833
|
+
"virtualMachineId"
|
|
834
|
+
]
|
|
835
|
+
},
|
|
836
|
+
"security": [
|
|
837
|
+
{
|
|
838
|
+
"apiToken": []
|
|
839
|
+
}
|
|
840
|
+
],
|
|
841
|
+
"group": "vps"
|
|
842
|
+
},
|
|
843
|
+
{
|
|
844
|
+
"name": "VPS_getPostInstallScriptV1",
|
|
845
|
+
"title": "Get post-install script",
|
|
846
|
+
"annotations": {
|
|
847
|
+
"title": "Get post-install script",
|
|
848
|
+
"readOnlyHint": true,
|
|
849
|
+
"destructiveHint": false
|
|
850
|
+
},
|
|
851
|
+
"description": "Retrieve post-install script by its ID.\n\nUse this endpoint to view specific automation script details.",
|
|
852
|
+
"method": "GET",
|
|
853
|
+
"path": "/api/vps/v1/post-install-scripts/{postInstallScriptId}",
|
|
854
|
+
"inputSchema": {
|
|
855
|
+
"type": "object",
|
|
856
|
+
"properties": {
|
|
857
|
+
"postInstallScriptId": {
|
|
858
|
+
"type": "integer",
|
|
859
|
+
"description": "Post-install script ID"
|
|
860
|
+
}
|
|
861
|
+
},
|
|
862
|
+
"required": [
|
|
863
|
+
"postInstallScriptId"
|
|
864
|
+
]
|
|
865
|
+
},
|
|
866
|
+
"security": [
|
|
867
|
+
{
|
|
868
|
+
"apiToken": []
|
|
869
|
+
}
|
|
870
|
+
],
|
|
871
|
+
"group": "vps"
|
|
872
|
+
},
|
|
873
|
+
{
|
|
874
|
+
"name": "VPS_updatePostInstallScriptV1",
|
|
875
|
+
"title": "Update post-install script",
|
|
876
|
+
"annotations": {
|
|
877
|
+
"title": "Update post-install script",
|
|
878
|
+
"readOnlyHint": false,
|
|
879
|
+
"destructiveHint": true,
|
|
880
|
+
"idempotentHint": true
|
|
881
|
+
},
|
|
882
|
+
"description": "Update a specific post-install script.\n\nUse this endpoint to modify existing automation scripts.",
|
|
883
|
+
"method": "PUT",
|
|
884
|
+
"path": "/api/vps/v1/post-install-scripts/{postInstallScriptId}",
|
|
885
|
+
"inputSchema": {
|
|
886
|
+
"type": "object",
|
|
887
|
+
"properties": {
|
|
888
|
+
"postInstallScriptId": {
|
|
889
|
+
"type": "integer",
|
|
890
|
+
"description": "Post-install script ID"
|
|
891
|
+
},
|
|
892
|
+
"name": {
|
|
893
|
+
"type": "string",
|
|
894
|
+
"description": "Name of the script"
|
|
895
|
+
},
|
|
896
|
+
"content": {
|
|
897
|
+
"type": "string",
|
|
898
|
+
"description": "Content of the script"
|
|
899
|
+
}
|
|
900
|
+
},
|
|
901
|
+
"required": [
|
|
902
|
+
"postInstallScriptId",
|
|
903
|
+
"name",
|
|
904
|
+
"content"
|
|
905
|
+
]
|
|
906
|
+
},
|
|
907
|
+
"security": [
|
|
908
|
+
{
|
|
909
|
+
"apiToken": []
|
|
910
|
+
}
|
|
911
|
+
],
|
|
912
|
+
"group": "vps"
|
|
913
|
+
},
|
|
914
|
+
{
|
|
915
|
+
"name": "VPS_deletePostInstallScriptV1",
|
|
916
|
+
"title": "Delete post-install script",
|
|
917
|
+
"annotations": {
|
|
918
|
+
"title": "Delete post-install script",
|
|
919
|
+
"readOnlyHint": false,
|
|
920
|
+
"destructiveHint": true,
|
|
921
|
+
"idempotentHint": true
|
|
922
|
+
},
|
|
923
|
+
"description": "Delete a post-install script from your account.\n \nUse this endpoint to remove unused automation scripts.",
|
|
924
|
+
"method": "DELETE",
|
|
925
|
+
"path": "/api/vps/v1/post-install-scripts/{postInstallScriptId}",
|
|
926
|
+
"inputSchema": {
|
|
927
|
+
"type": "object",
|
|
928
|
+
"properties": {
|
|
929
|
+
"postInstallScriptId": {
|
|
930
|
+
"type": "integer",
|
|
931
|
+
"description": "Post-install script ID"
|
|
932
|
+
}
|
|
933
|
+
},
|
|
934
|
+
"required": [
|
|
935
|
+
"postInstallScriptId"
|
|
936
|
+
]
|
|
937
|
+
},
|
|
938
|
+
"security": [
|
|
939
|
+
{
|
|
940
|
+
"apiToken": []
|
|
941
|
+
}
|
|
942
|
+
],
|
|
943
|
+
"group": "vps"
|
|
944
|
+
},
|
|
945
|
+
{
|
|
946
|
+
"name": "VPS_getPostInstallScriptsV1",
|
|
947
|
+
"title": "Get post-install scripts",
|
|
948
|
+
"annotations": {
|
|
949
|
+
"title": "Get post-install scripts",
|
|
950
|
+
"readOnlyHint": true,
|
|
951
|
+
"destructiveHint": false
|
|
952
|
+
},
|
|
953
|
+
"description": "Retrieve post-install scripts associated with your account.\n\nUse this endpoint to view available automation scripts for VPS deployment.",
|
|
954
|
+
"method": "GET",
|
|
955
|
+
"path": "/api/vps/v1/post-install-scripts",
|
|
956
|
+
"inputSchema": {
|
|
957
|
+
"type": "object",
|
|
958
|
+
"properties": {
|
|
959
|
+
"page": {
|
|
960
|
+
"type": "integer",
|
|
961
|
+
"description": "Page number"
|
|
962
|
+
}
|
|
963
|
+
},
|
|
964
|
+
"required": []
|
|
965
|
+
},
|
|
966
|
+
"security": [
|
|
967
|
+
{
|
|
968
|
+
"apiToken": []
|
|
969
|
+
}
|
|
970
|
+
],
|
|
971
|
+
"group": "vps"
|
|
972
|
+
},
|
|
973
|
+
{
|
|
974
|
+
"name": "VPS_createPostInstallScriptV1",
|
|
975
|
+
"title": "Create post-install script",
|
|
976
|
+
"annotations": {
|
|
977
|
+
"title": "Create post-install script",
|
|
978
|
+
"readOnlyHint": false,
|
|
979
|
+
"destructiveHint": false
|
|
980
|
+
},
|
|
981
|
+
"description": "Add a new post-install script to your account, which can then be used after virtual machine installation.\n\nThe script contents will be saved to the file `/post_install` with executable attribute set\nand will be executed once virtual machine is installed.\nThe output of the script will be redirected to `/post_install.log`. Maximum script size is 48KB.\n\nUse this endpoint to create automation scripts for VPS setup tasks.",
|
|
982
|
+
"method": "POST",
|
|
983
|
+
"path": "/api/vps/v1/post-install-scripts",
|
|
984
|
+
"inputSchema": {
|
|
985
|
+
"type": "object",
|
|
986
|
+
"properties": {
|
|
987
|
+
"name": {
|
|
988
|
+
"type": "string",
|
|
989
|
+
"description": "Name of the script"
|
|
990
|
+
},
|
|
991
|
+
"content": {
|
|
992
|
+
"type": "string",
|
|
993
|
+
"description": "Content of the script"
|
|
994
|
+
}
|
|
995
|
+
},
|
|
996
|
+
"required": [
|
|
997
|
+
"name",
|
|
998
|
+
"content"
|
|
999
|
+
]
|
|
1000
|
+
},
|
|
1001
|
+
"security": [
|
|
1002
|
+
{
|
|
1003
|
+
"apiToken": []
|
|
1004
|
+
}
|
|
1005
|
+
],
|
|
1006
|
+
"group": "vps"
|
|
1007
|
+
},
|
|
1008
|
+
{
|
|
1009
|
+
"name": "VPS_attachPublicKeyV1",
|
|
1010
|
+
"title": "Attach public key",
|
|
1011
|
+
"annotations": {
|
|
1012
|
+
"title": "Attach public key",
|
|
1013
|
+
"readOnlyHint": false,
|
|
1014
|
+
"destructiveHint": false
|
|
1015
|
+
},
|
|
1016
|
+
"description": "Attach existing public keys from your account to a specified virtual machine.\n\nMultiple keys can be attached to a single virtual machine.\n\nUse this endpoint to enable SSH key authentication for VPS instances.",
|
|
1017
|
+
"method": "POST",
|
|
1018
|
+
"path": "/api/vps/v1/public-keys/attach/{virtualMachineId}",
|
|
1019
|
+
"inputSchema": {
|
|
1020
|
+
"type": "object",
|
|
1021
|
+
"properties": {
|
|
1022
|
+
"virtualMachineId": {
|
|
1023
|
+
"type": "integer",
|
|
1024
|
+
"description": "Virtual Machine ID"
|
|
1025
|
+
},
|
|
1026
|
+
"ids": {
|
|
1027
|
+
"type": "array",
|
|
1028
|
+
"description": "Public Key IDs to attach",
|
|
1029
|
+
"items": {
|
|
1030
|
+
"type": "integer",
|
|
1031
|
+
"description": "ids parameter"
|
|
1032
|
+
}
|
|
1033
|
+
}
|
|
1034
|
+
},
|
|
1035
|
+
"required": [
|
|
1036
|
+
"virtualMachineId",
|
|
1037
|
+
"ids"
|
|
1038
|
+
]
|
|
1039
|
+
},
|
|
1040
|
+
"security": [
|
|
1041
|
+
{
|
|
1042
|
+
"apiToken": []
|
|
1043
|
+
}
|
|
1044
|
+
],
|
|
1045
|
+
"group": "vps"
|
|
1046
|
+
},
|
|
1047
|
+
{
|
|
1048
|
+
"name": "VPS_deletePublicKeyV1",
|
|
1049
|
+
"title": "Delete public key",
|
|
1050
|
+
"annotations": {
|
|
1051
|
+
"title": "Delete public key",
|
|
1052
|
+
"readOnlyHint": false,
|
|
1053
|
+
"destructiveHint": true,
|
|
1054
|
+
"idempotentHint": true
|
|
1055
|
+
},
|
|
1056
|
+
"description": "Delete a public key from your account. \n\n**Deleting public key from account does not remove it from virtual machine** \n \nUse this endpoint to remove unused SSH keys from account.",
|
|
1057
|
+
"method": "DELETE",
|
|
1058
|
+
"path": "/api/vps/v1/public-keys/{publicKeyId}",
|
|
1059
|
+
"inputSchema": {
|
|
1060
|
+
"type": "object",
|
|
1061
|
+
"properties": {
|
|
1062
|
+
"publicKeyId": {
|
|
1063
|
+
"type": "integer",
|
|
1064
|
+
"description": "Public Key ID"
|
|
1065
|
+
}
|
|
1066
|
+
},
|
|
1067
|
+
"required": [
|
|
1068
|
+
"publicKeyId"
|
|
1069
|
+
]
|
|
1070
|
+
},
|
|
1071
|
+
"security": [
|
|
1072
|
+
{
|
|
1073
|
+
"apiToken": []
|
|
1074
|
+
}
|
|
1075
|
+
],
|
|
1076
|
+
"group": "vps"
|
|
1077
|
+
},
|
|
1078
|
+
{
|
|
1079
|
+
"name": "VPS_getPublicKeysV1",
|
|
1080
|
+
"title": "Get public keys",
|
|
1081
|
+
"annotations": {
|
|
1082
|
+
"title": "Get public keys",
|
|
1083
|
+
"readOnlyHint": true,
|
|
1084
|
+
"destructiveHint": false
|
|
1085
|
+
},
|
|
1086
|
+
"description": "Retrieve public keys associated with your account.\n\nUse this endpoint to view available SSH keys for VPS authentication.",
|
|
1087
|
+
"method": "GET",
|
|
1088
|
+
"path": "/api/vps/v1/public-keys",
|
|
1089
|
+
"inputSchema": {
|
|
1090
|
+
"type": "object",
|
|
1091
|
+
"properties": {
|
|
1092
|
+
"page": {
|
|
1093
|
+
"type": "integer",
|
|
1094
|
+
"description": "Page number"
|
|
1095
|
+
}
|
|
1096
|
+
},
|
|
1097
|
+
"required": []
|
|
1098
|
+
},
|
|
1099
|
+
"security": [
|
|
1100
|
+
{
|
|
1101
|
+
"apiToken": []
|
|
1102
|
+
}
|
|
1103
|
+
],
|
|
1104
|
+
"group": "vps"
|
|
1105
|
+
},
|
|
1106
|
+
{
|
|
1107
|
+
"name": "VPS_createPublicKeyV1",
|
|
1108
|
+
"title": "Create public key",
|
|
1109
|
+
"annotations": {
|
|
1110
|
+
"title": "Create public key",
|
|
1111
|
+
"readOnlyHint": false,
|
|
1112
|
+
"destructiveHint": false
|
|
1113
|
+
},
|
|
1114
|
+
"description": "Add a new public key to your account.\n\nUse this endpoint to register SSH keys for VPS authentication.",
|
|
1115
|
+
"method": "POST",
|
|
1116
|
+
"path": "/api/vps/v1/public-keys",
|
|
1117
|
+
"inputSchema": {
|
|
1118
|
+
"type": "object",
|
|
1119
|
+
"properties": {
|
|
1120
|
+
"name": {
|
|
1121
|
+
"type": "string",
|
|
1122
|
+
"description": "name parameter"
|
|
1123
|
+
},
|
|
1124
|
+
"key": {
|
|
1125
|
+
"type": "string",
|
|
1126
|
+
"description": "key parameter"
|
|
1127
|
+
}
|
|
1128
|
+
},
|
|
1129
|
+
"required": [
|
|
1130
|
+
"name",
|
|
1131
|
+
"key"
|
|
1132
|
+
]
|
|
1133
|
+
},
|
|
1134
|
+
"security": [
|
|
1135
|
+
{
|
|
1136
|
+
"apiToken": []
|
|
1137
|
+
}
|
|
1138
|
+
],
|
|
1139
|
+
"group": "vps"
|
|
1140
|
+
},
|
|
1141
|
+
{
|
|
1142
|
+
"name": "VPS_getTemplateDetailsV1",
|
|
1143
|
+
"title": "Get template details",
|
|
1144
|
+
"annotations": {
|
|
1145
|
+
"title": "Get template details",
|
|
1146
|
+
"readOnlyHint": true,
|
|
1147
|
+
"destructiveHint": false
|
|
1148
|
+
},
|
|
1149
|
+
"description": "Retrieve detailed information about a specific OS template for virtual machines.\n\nUse this endpoint to view specific template specifications before deployment.",
|
|
1150
|
+
"method": "GET",
|
|
1151
|
+
"path": "/api/vps/v1/templates/{templateId}",
|
|
1152
|
+
"inputSchema": {
|
|
1153
|
+
"type": "object",
|
|
1154
|
+
"properties": {
|
|
1155
|
+
"templateId": {
|
|
1156
|
+
"type": "integer",
|
|
1157
|
+
"description": "Template ID"
|
|
1158
|
+
}
|
|
1159
|
+
},
|
|
1160
|
+
"required": [
|
|
1161
|
+
"templateId"
|
|
1162
|
+
]
|
|
1163
|
+
},
|
|
1164
|
+
"security": [
|
|
1165
|
+
{
|
|
1166
|
+
"apiToken": []
|
|
1167
|
+
}
|
|
1168
|
+
],
|
|
1169
|
+
"group": "vps"
|
|
1170
|
+
},
|
|
1171
|
+
{
|
|
1172
|
+
"name": "VPS_getTemplatesV1",
|
|
1173
|
+
"title": "Get templates",
|
|
1174
|
+
"annotations": {
|
|
1175
|
+
"title": "Get templates",
|
|
1176
|
+
"readOnlyHint": true,
|
|
1177
|
+
"destructiveHint": false
|
|
1178
|
+
},
|
|
1179
|
+
"description": "Retrieve available OS templates for virtual machines.\n\nUse this endpoint to view operating system options before creating or recreating VPS instances.",
|
|
1180
|
+
"method": "GET",
|
|
1181
|
+
"path": "/api/vps/v1/templates",
|
|
1182
|
+
"inputSchema": {
|
|
1183
|
+
"type": "object",
|
|
1184
|
+
"properties": {},
|
|
1185
|
+
"required": []
|
|
1186
|
+
},
|
|
1187
|
+
"security": [
|
|
1188
|
+
{
|
|
1189
|
+
"apiToken": []
|
|
1190
|
+
}
|
|
1191
|
+
],
|
|
1192
|
+
"group": "vps"
|
|
1193
|
+
},
|
|
1194
|
+
{
|
|
1195
|
+
"name": "VPS_getActionDetailsV1",
|
|
1196
|
+
"title": "Get action details",
|
|
1197
|
+
"annotations": {
|
|
1198
|
+
"title": "Get action details",
|
|
1199
|
+
"readOnlyHint": true,
|
|
1200
|
+
"destructiveHint": false
|
|
1201
|
+
},
|
|
1202
|
+
"description": "Retrieve detailed information about a specific action performed on a specified virtual machine.\n\nUse this endpoint to monitor specific VPS operation status and details.",
|
|
1203
|
+
"method": "GET",
|
|
1204
|
+
"path": "/api/vps/v1/virtual-machines/{virtualMachineId}/actions/{actionId}",
|
|
1205
|
+
"inputSchema": {
|
|
1206
|
+
"type": "object",
|
|
1207
|
+
"properties": {
|
|
1208
|
+
"virtualMachineId": {
|
|
1209
|
+
"type": "integer",
|
|
1210
|
+
"description": "Virtual Machine ID"
|
|
1211
|
+
},
|
|
1212
|
+
"actionId": {
|
|
1213
|
+
"type": "integer",
|
|
1214
|
+
"description": "Action ID"
|
|
1215
|
+
}
|
|
1216
|
+
},
|
|
1217
|
+
"required": [
|
|
1218
|
+
"virtualMachineId",
|
|
1219
|
+
"actionId"
|
|
1220
|
+
]
|
|
1221
|
+
},
|
|
1222
|
+
"security": [
|
|
1223
|
+
{
|
|
1224
|
+
"apiToken": []
|
|
1225
|
+
}
|
|
1226
|
+
],
|
|
1227
|
+
"group": "vps"
|
|
1228
|
+
},
|
|
1229
|
+
{
|
|
1230
|
+
"name": "VPS_getActionsV1",
|
|
1231
|
+
"title": "Get actions",
|
|
1232
|
+
"annotations": {
|
|
1233
|
+
"title": "Get actions",
|
|
1234
|
+
"readOnlyHint": true,
|
|
1235
|
+
"destructiveHint": false
|
|
1236
|
+
},
|
|
1237
|
+
"description": "Retrieve actions performed on a specified virtual machine.\n\nActions are operations or events that have been executed on the virtual\nmachine, such as starting, stopping, or modifying the machine. This endpoint\nallows you to view the history of these actions, providing details about\neach action, such as the action name, timestamp, and status.\n\nUse this endpoint to view VPS operation history and troubleshoot issues.",
|
|
1238
|
+
"method": "GET",
|
|
1239
|
+
"path": "/api/vps/v1/virtual-machines/{virtualMachineId}/actions",
|
|
1240
|
+
"inputSchema": {
|
|
1241
|
+
"type": "object",
|
|
1242
|
+
"properties": {
|
|
1243
|
+
"virtualMachineId": {
|
|
1244
|
+
"type": "integer",
|
|
1245
|
+
"description": "Virtual Machine ID"
|
|
1246
|
+
},
|
|
1247
|
+
"page": {
|
|
1248
|
+
"type": "integer",
|
|
1249
|
+
"description": "Page number"
|
|
1250
|
+
}
|
|
1251
|
+
},
|
|
1252
|
+
"required": [
|
|
1253
|
+
"virtualMachineId"
|
|
1254
|
+
]
|
|
1255
|
+
},
|
|
1256
|
+
"security": [
|
|
1257
|
+
{
|
|
1258
|
+
"apiToken": []
|
|
1259
|
+
}
|
|
1260
|
+
],
|
|
1261
|
+
"group": "vps"
|
|
1262
|
+
},
|
|
1263
|
+
{
|
|
1264
|
+
"name": "VPS_getAttachedPublicKeysV1",
|
|
1265
|
+
"title": "Get attached public keys",
|
|
1266
|
+
"annotations": {
|
|
1267
|
+
"title": "Get attached public keys",
|
|
1268
|
+
"readOnlyHint": true,
|
|
1269
|
+
"destructiveHint": false
|
|
1270
|
+
},
|
|
1271
|
+
"description": "Retrieve public keys attached to a specified virtual machine.\n\nUse this endpoint to view SSH keys configured for specific VPS instances.",
|
|
1272
|
+
"method": "GET",
|
|
1273
|
+
"path": "/api/vps/v1/virtual-machines/{virtualMachineId}/public-keys",
|
|
1274
|
+
"inputSchema": {
|
|
1275
|
+
"type": "object",
|
|
1276
|
+
"properties": {
|
|
1277
|
+
"virtualMachineId": {
|
|
1278
|
+
"type": "integer",
|
|
1279
|
+
"description": "Virtual Machine ID"
|
|
1280
|
+
},
|
|
1281
|
+
"page": {
|
|
1282
|
+
"type": "integer",
|
|
1283
|
+
"description": "Page number"
|
|
1284
|
+
}
|
|
1285
|
+
},
|
|
1286
|
+
"required": [
|
|
1287
|
+
"virtualMachineId"
|
|
1288
|
+
]
|
|
1289
|
+
},
|
|
1290
|
+
"security": [
|
|
1291
|
+
{
|
|
1292
|
+
"apiToken": []
|
|
1293
|
+
}
|
|
1294
|
+
],
|
|
1295
|
+
"group": "vps"
|
|
1296
|
+
},
|
|
1297
|
+
{
|
|
1298
|
+
"name": "VPS_getBackupsV1",
|
|
1299
|
+
"title": "Get backups",
|
|
1300
|
+
"annotations": {
|
|
1301
|
+
"title": "Get backups",
|
|
1302
|
+
"readOnlyHint": true,
|
|
1303
|
+
"destructiveHint": false
|
|
1304
|
+
},
|
|
1305
|
+
"description": "Retrieve backups for a specified virtual machine.\n\nUse this endpoint to view available backup points for VPS data recovery.",
|
|
1306
|
+
"method": "GET",
|
|
1307
|
+
"path": "/api/vps/v1/virtual-machines/{virtualMachineId}/backups",
|
|
1308
|
+
"inputSchema": {
|
|
1309
|
+
"type": "object",
|
|
1310
|
+
"properties": {
|
|
1311
|
+
"virtualMachineId": {
|
|
1312
|
+
"type": "integer",
|
|
1313
|
+
"description": "Virtual Machine ID"
|
|
1314
|
+
},
|
|
1315
|
+
"page": {
|
|
1316
|
+
"type": "integer",
|
|
1317
|
+
"description": "Page number"
|
|
1318
|
+
}
|
|
1319
|
+
},
|
|
1320
|
+
"required": [
|
|
1321
|
+
"virtualMachineId"
|
|
1322
|
+
]
|
|
1323
|
+
},
|
|
1324
|
+
"security": [
|
|
1325
|
+
{
|
|
1326
|
+
"apiToken": []
|
|
1327
|
+
}
|
|
1328
|
+
],
|
|
1329
|
+
"group": "vps"
|
|
1330
|
+
},
|
|
1331
|
+
{
|
|
1332
|
+
"name": "VPS_restoreBackupV1",
|
|
1333
|
+
"title": "Restore backup",
|
|
1334
|
+
"annotations": {
|
|
1335
|
+
"title": "Restore backup",
|
|
1336
|
+
"readOnlyHint": false,
|
|
1337
|
+
"destructiveHint": true
|
|
1338
|
+
},
|
|
1339
|
+
"description": "Restore a backup for a specified virtual machine.\n\nThe system will then initiate the restore process, which may take some time depending on the size of the backup.\n\n**All data on the virtual machine will be overwritten with the data from the backup.**\n\nUse this endpoint to recover VPS data from backup points.",
|
|
1340
|
+
"method": "POST",
|
|
1341
|
+
"path": "/api/vps/v1/virtual-machines/{virtualMachineId}/backups/{backupId}/restore",
|
|
1342
|
+
"inputSchema": {
|
|
1343
|
+
"type": "object",
|
|
1344
|
+
"properties": {
|
|
1345
|
+
"virtualMachineId": {
|
|
1346
|
+
"type": "integer",
|
|
1347
|
+
"description": "Virtual Machine ID"
|
|
1348
|
+
},
|
|
1349
|
+
"backupId": {
|
|
1350
|
+
"type": "integer",
|
|
1351
|
+
"description": "Backup ID"
|
|
1352
|
+
}
|
|
1353
|
+
},
|
|
1354
|
+
"required": [
|
|
1355
|
+
"virtualMachineId",
|
|
1356
|
+
"backupId"
|
|
1357
|
+
]
|
|
1358
|
+
},
|
|
1359
|
+
"security": [
|
|
1360
|
+
{
|
|
1361
|
+
"apiToken": []
|
|
1362
|
+
}
|
|
1363
|
+
],
|
|
1364
|
+
"group": "vps"
|
|
1365
|
+
},
|
|
1366
|
+
{
|
|
1367
|
+
"name": "VPS_setHostnameV1",
|
|
1368
|
+
"title": "Set hostname",
|
|
1369
|
+
"annotations": {
|
|
1370
|
+
"title": "Set hostname",
|
|
1371
|
+
"readOnlyHint": false,
|
|
1372
|
+
"destructiveHint": true,
|
|
1373
|
+
"idempotentHint": true
|
|
1374
|
+
},
|
|
1375
|
+
"description": "Set hostname for a specified virtual machine.\n\nChanging hostname does not update PTR record automatically.\nIf you want your virtual machine to be reachable by a hostname, \nyou need to point your domain A/AAAA records to virtual machine IP as well.\n\nUse this endpoint to configure custom hostnames for VPS instances.",
|
|
1376
|
+
"method": "PUT",
|
|
1377
|
+
"path": "/api/vps/v1/virtual-machines/{virtualMachineId}/hostname",
|
|
1378
|
+
"inputSchema": {
|
|
1379
|
+
"type": "object",
|
|
1380
|
+
"properties": {
|
|
1381
|
+
"virtualMachineId": {
|
|
1382
|
+
"type": "integer",
|
|
1383
|
+
"description": "Virtual Machine ID"
|
|
1384
|
+
},
|
|
1385
|
+
"hostname": {
|
|
1386
|
+
"type": "string",
|
|
1387
|
+
"description": "hostname parameter"
|
|
1388
|
+
}
|
|
1389
|
+
},
|
|
1390
|
+
"required": [
|
|
1391
|
+
"virtualMachineId",
|
|
1392
|
+
"hostname"
|
|
1393
|
+
]
|
|
1394
|
+
},
|
|
1395
|
+
"security": [
|
|
1396
|
+
{
|
|
1397
|
+
"apiToken": []
|
|
1398
|
+
}
|
|
1399
|
+
],
|
|
1400
|
+
"group": "vps"
|
|
1401
|
+
},
|
|
1402
|
+
{
|
|
1403
|
+
"name": "VPS_resetHostnameV1",
|
|
1404
|
+
"title": "Reset hostname",
|
|
1405
|
+
"annotations": {
|
|
1406
|
+
"title": "Reset hostname",
|
|
1407
|
+
"readOnlyHint": false,
|
|
1408
|
+
"destructiveHint": true,
|
|
1409
|
+
"idempotentHint": true
|
|
1410
|
+
},
|
|
1411
|
+
"description": "Reset hostname and PTR record of a specified virtual machine to default value.\n\nUse this endpoint to restore default hostname configuration for VPS instances.",
|
|
1412
|
+
"method": "DELETE",
|
|
1413
|
+
"path": "/api/vps/v1/virtual-machines/{virtualMachineId}/hostname",
|
|
1414
|
+
"inputSchema": {
|
|
1415
|
+
"type": "object",
|
|
1416
|
+
"properties": {
|
|
1417
|
+
"virtualMachineId": {
|
|
1418
|
+
"type": "integer",
|
|
1419
|
+
"description": "Virtual Machine ID"
|
|
1420
|
+
}
|
|
1421
|
+
},
|
|
1422
|
+
"required": [
|
|
1423
|
+
"virtualMachineId"
|
|
1424
|
+
]
|
|
1425
|
+
},
|
|
1426
|
+
"security": [
|
|
1427
|
+
{
|
|
1428
|
+
"apiToken": []
|
|
1429
|
+
}
|
|
1430
|
+
],
|
|
1431
|
+
"group": "vps"
|
|
1432
|
+
},
|
|
1433
|
+
{
|
|
1434
|
+
"name": "VPS_getVirtualMachineDetailsV1",
|
|
1435
|
+
"title": "Get virtual machine details",
|
|
1436
|
+
"annotations": {
|
|
1437
|
+
"title": "Get virtual machine details",
|
|
1438
|
+
"readOnlyHint": true,
|
|
1439
|
+
"destructiveHint": false
|
|
1440
|
+
},
|
|
1441
|
+
"description": "Retrieve detailed information about a specified virtual machine.\n\nUse this endpoint to view comprehensive VPS configuration and status.",
|
|
1442
|
+
"method": "GET",
|
|
1443
|
+
"path": "/api/vps/v1/virtual-machines/{virtualMachineId}",
|
|
1444
|
+
"inputSchema": {
|
|
1445
|
+
"type": "object",
|
|
1446
|
+
"properties": {
|
|
1447
|
+
"virtualMachineId": {
|
|
1448
|
+
"type": "integer",
|
|
1449
|
+
"description": "Virtual Machine ID"
|
|
1450
|
+
}
|
|
1451
|
+
},
|
|
1452
|
+
"required": [
|
|
1453
|
+
"virtualMachineId"
|
|
1454
|
+
]
|
|
1455
|
+
},
|
|
1456
|
+
"security": [
|
|
1457
|
+
{
|
|
1458
|
+
"apiToken": []
|
|
1459
|
+
}
|
|
1460
|
+
],
|
|
1461
|
+
"group": "vps"
|
|
1462
|
+
},
|
|
1463
|
+
{
|
|
1464
|
+
"name": "VPS_getVirtualMachinesV1",
|
|
1465
|
+
"title": "Get virtual machines",
|
|
1466
|
+
"annotations": {
|
|
1467
|
+
"title": "Get virtual machines",
|
|
1468
|
+
"readOnlyHint": true,
|
|
1469
|
+
"destructiveHint": false
|
|
1470
|
+
},
|
|
1471
|
+
"description": "Retrieve all available virtual machines.\n\nUse this endpoint to view available VPS instances.",
|
|
1472
|
+
"method": "GET",
|
|
1473
|
+
"path": "/api/vps/v1/virtual-machines",
|
|
1474
|
+
"inputSchema": {
|
|
1475
|
+
"type": "object",
|
|
1476
|
+
"properties": {},
|
|
1477
|
+
"required": []
|
|
1478
|
+
},
|
|
1479
|
+
"security": [
|
|
1480
|
+
{
|
|
1481
|
+
"apiToken": []
|
|
1482
|
+
}
|
|
1483
|
+
],
|
|
1484
|
+
"group": "vps"
|
|
1485
|
+
},
|
|
1486
|
+
{
|
|
1487
|
+
"name": "VPS_purchaseNewVirtualMachineV1",
|
|
1488
|
+
"title": "Purchase new virtual machine",
|
|
1489
|
+
"annotations": {
|
|
1490
|
+
"title": "Purchase new virtual machine",
|
|
1491
|
+
"readOnlyHint": false,
|
|
1492
|
+
"destructiveHint": false
|
|
1493
|
+
},
|
|
1494
|
+
"description": "Purchase and setup a new virtual machine.\n\nIf virtual machine setup fails for any reason, login to\n[hPanel](https://hpanel.hostinger.com/) and complete the setup manually.\n\nIf no payment method is provided, your default payment method will be used automatically.\n\nUse this endpoint to create new VPS instances.",
|
|
1495
|
+
"method": "POST",
|
|
1496
|
+
"path": "/api/vps/v1/virtual-machines",
|
|
1497
|
+
"inputSchema": {
|
|
1498
|
+
"type": "object",
|
|
1499
|
+
"properties": {
|
|
1500
|
+
"item_id": {
|
|
1501
|
+
"type": "string",
|
|
1502
|
+
"description": "Catalog price item ID"
|
|
1503
|
+
},
|
|
1504
|
+
"payment_method_id": {
|
|
1505
|
+
"type": "integer",
|
|
1506
|
+
"description": "Payment method ID, default will be used if not provided"
|
|
1507
|
+
},
|
|
1508
|
+
"setup": {
|
|
1509
|
+
"type": "string",
|
|
1510
|
+
"description": "setup parameter"
|
|
1511
|
+
},
|
|
1512
|
+
"coupons": {
|
|
1513
|
+
"type": "array",
|
|
1514
|
+
"description": "Discount coupon codes",
|
|
1515
|
+
"items": {
|
|
1516
|
+
"type": "string",
|
|
1517
|
+
"description": "coupons parameter"
|
|
1518
|
+
}
|
|
1519
|
+
}
|
|
1520
|
+
},
|
|
1521
|
+
"required": [
|
|
1522
|
+
"item_id",
|
|
1523
|
+
"setup"
|
|
1524
|
+
]
|
|
1525
|
+
},
|
|
1526
|
+
"security": [
|
|
1527
|
+
{
|
|
1528
|
+
"apiToken": []
|
|
1529
|
+
}
|
|
1530
|
+
],
|
|
1531
|
+
"group": "vps"
|
|
1532
|
+
},
|
|
1533
|
+
{
|
|
1534
|
+
"name": "VPS_getScanMetricsV1",
|
|
1535
|
+
"title": "Get scan metrics",
|
|
1536
|
+
"annotations": {
|
|
1537
|
+
"title": "Get scan metrics",
|
|
1538
|
+
"readOnlyHint": true,
|
|
1539
|
+
"destructiveHint": false
|
|
1540
|
+
},
|
|
1541
|
+
"description": "Retrieve scan metrics for the [Monarx](https://www.monarx.com/) malware scanner\ninstalled on a specified virtual machine.\n\nThe scan metrics provide detailed information about malware scans performed\nby Monarx, including number of scans, detected threats, and other relevant\nstatistics. This information is useful for monitoring security status of the\nvirtual machine and assessing effectiveness of the malware scanner.\n\nUse this endpoint to monitor VPS security scan results and threat detection.",
|
|
1542
|
+
"method": "GET",
|
|
1543
|
+
"path": "/api/vps/v1/virtual-machines/{virtualMachineId}/monarx",
|
|
1544
|
+
"inputSchema": {
|
|
1545
|
+
"type": "object",
|
|
1546
|
+
"properties": {
|
|
1547
|
+
"virtualMachineId": {
|
|
1548
|
+
"type": "integer",
|
|
1549
|
+
"description": "Virtual Machine ID"
|
|
1550
|
+
}
|
|
1551
|
+
},
|
|
1552
|
+
"required": [
|
|
1553
|
+
"virtualMachineId"
|
|
1554
|
+
]
|
|
1555
|
+
},
|
|
1556
|
+
"security": [
|
|
1557
|
+
{
|
|
1558
|
+
"apiToken": []
|
|
1559
|
+
}
|
|
1560
|
+
],
|
|
1561
|
+
"group": "vps"
|
|
1562
|
+
},
|
|
1563
|
+
{
|
|
1564
|
+
"name": "VPS_installMonarxV1",
|
|
1565
|
+
"title": "Install Monarx",
|
|
1566
|
+
"annotations": {
|
|
1567
|
+
"title": "Install Monarx",
|
|
1568
|
+
"readOnlyHint": false,
|
|
1569
|
+
"destructiveHint": false
|
|
1570
|
+
},
|
|
1571
|
+
"description": "Install the Monarx malware scanner on a specified virtual machine.\n\n[Monarx](https://www.monarx.com/) is a security tool designed to detect and\nprevent malware infections on virtual machines. By installing Monarx, users\ncan enhance the security of their virtual machines, ensuring that they are\nprotected against malicious software.\n\nUse this endpoint to enable malware protection on VPS instances.",
|
|
1572
|
+
"method": "POST",
|
|
1573
|
+
"path": "/api/vps/v1/virtual-machines/{virtualMachineId}/monarx",
|
|
1574
|
+
"inputSchema": {
|
|
1575
|
+
"type": "object",
|
|
1576
|
+
"properties": {
|
|
1577
|
+
"virtualMachineId": {
|
|
1578
|
+
"type": "integer",
|
|
1579
|
+
"description": "Virtual Machine ID"
|
|
1580
|
+
}
|
|
1581
|
+
},
|
|
1582
|
+
"required": [
|
|
1583
|
+
"virtualMachineId"
|
|
1584
|
+
]
|
|
1585
|
+
},
|
|
1586
|
+
"security": [
|
|
1587
|
+
{
|
|
1588
|
+
"apiToken": []
|
|
1589
|
+
}
|
|
1590
|
+
],
|
|
1591
|
+
"group": "vps"
|
|
1592
|
+
},
|
|
1593
|
+
{
|
|
1594
|
+
"name": "VPS_uninstallMonarxV1",
|
|
1595
|
+
"title": "Uninstall Monarx",
|
|
1596
|
+
"annotations": {
|
|
1597
|
+
"title": "Uninstall Monarx",
|
|
1598
|
+
"readOnlyHint": false,
|
|
1599
|
+
"destructiveHint": true,
|
|
1600
|
+
"idempotentHint": true
|
|
1601
|
+
},
|
|
1602
|
+
"description": "Uninstall the Monarx malware scanner on a specified virtual machine.\n\nIf Monarx is not installed, the request will still be processed without any effect.\n\nUse this endpoint to remove malware scanner from VPS instances.",
|
|
1603
|
+
"method": "DELETE",
|
|
1604
|
+
"path": "/api/vps/v1/virtual-machines/{virtualMachineId}/monarx",
|
|
1605
|
+
"inputSchema": {
|
|
1606
|
+
"type": "object",
|
|
1607
|
+
"properties": {
|
|
1608
|
+
"virtualMachineId": {
|
|
1609
|
+
"type": "integer",
|
|
1610
|
+
"description": "Virtual Machine ID"
|
|
1611
|
+
}
|
|
1612
|
+
},
|
|
1613
|
+
"required": [
|
|
1614
|
+
"virtualMachineId"
|
|
1615
|
+
]
|
|
1616
|
+
},
|
|
1617
|
+
"security": [
|
|
1618
|
+
{
|
|
1619
|
+
"apiToken": []
|
|
1620
|
+
}
|
|
1621
|
+
],
|
|
1622
|
+
"group": "vps"
|
|
1623
|
+
},
|
|
1624
|
+
{
|
|
1625
|
+
"name": "VPS_getMetricsV1",
|
|
1626
|
+
"title": "Get metrics",
|
|
1627
|
+
"annotations": {
|
|
1628
|
+
"title": "Get metrics",
|
|
1629
|
+
"readOnlyHint": true,
|
|
1630
|
+
"destructiveHint": false
|
|
1631
|
+
},
|
|
1632
|
+
"description": "Retrieve historical metrics for a specified virtual machine.\n\nIt includes the following metrics: \n- CPU usage\n- Memory usage\n- Disk usage\n- Network usage\n- Uptime\n\nUse this endpoint to monitor VPS performance and resource utilization over time.",
|
|
1633
|
+
"method": "GET",
|
|
1634
|
+
"path": "/api/vps/v1/virtual-machines/{virtualMachineId}/metrics",
|
|
1635
|
+
"inputSchema": {
|
|
1636
|
+
"type": "object",
|
|
1637
|
+
"properties": {
|
|
1638
|
+
"virtualMachineId": {
|
|
1639
|
+
"type": "integer",
|
|
1640
|
+
"description": "Virtual Machine ID"
|
|
1641
|
+
},
|
|
1642
|
+
"date_from": {
|
|
1643
|
+
"type": "string",
|
|
1644
|
+
"description": "date_from parameter"
|
|
1645
|
+
},
|
|
1646
|
+
"date_to": {
|
|
1647
|
+
"type": "string",
|
|
1648
|
+
"description": "date_to parameter"
|
|
1649
|
+
}
|
|
1650
|
+
},
|
|
1651
|
+
"required": [
|
|
1652
|
+
"virtualMachineId",
|
|
1653
|
+
"date_from",
|
|
1654
|
+
"date_to"
|
|
1655
|
+
]
|
|
1656
|
+
},
|
|
1657
|
+
"security": [
|
|
1658
|
+
{
|
|
1659
|
+
"apiToken": []
|
|
1660
|
+
}
|
|
1661
|
+
],
|
|
1662
|
+
"group": "vps"
|
|
1663
|
+
},
|
|
1664
|
+
{
|
|
1665
|
+
"name": "VPS_setNameserversV1",
|
|
1666
|
+
"title": "Set nameservers",
|
|
1667
|
+
"annotations": {
|
|
1668
|
+
"title": "Set nameservers",
|
|
1669
|
+
"readOnlyHint": false,
|
|
1670
|
+
"destructiveHint": true,
|
|
1671
|
+
"idempotentHint": true
|
|
1672
|
+
},
|
|
1673
|
+
"description": "Set nameservers for a specified virtual machine.\n\nBe aware, that improper nameserver configuration can lead to the virtual\nmachine being unable to resolve domain names.\n\nUse this endpoint to configure custom DNS resolvers for VPS instances.",
|
|
1674
|
+
"method": "PUT",
|
|
1675
|
+
"path": "/api/vps/v1/virtual-machines/{virtualMachineId}/nameservers",
|
|
1676
|
+
"inputSchema": {
|
|
1677
|
+
"type": "object",
|
|
1678
|
+
"properties": {
|
|
1679
|
+
"virtualMachineId": {
|
|
1680
|
+
"type": "integer",
|
|
1681
|
+
"description": "Virtual Machine ID"
|
|
1682
|
+
},
|
|
1683
|
+
"ns1": {
|
|
1684
|
+
"type": "string",
|
|
1685
|
+
"description": "ns1 parameter"
|
|
1686
|
+
},
|
|
1687
|
+
"ns2": {
|
|
1688
|
+
"type": "string",
|
|
1689
|
+
"description": "ns2 parameter"
|
|
1690
|
+
},
|
|
1691
|
+
"ns3": {
|
|
1692
|
+
"type": "string",
|
|
1693
|
+
"description": "ns3 parameter"
|
|
1694
|
+
}
|
|
1695
|
+
},
|
|
1696
|
+
"required": [
|
|
1697
|
+
"virtualMachineId",
|
|
1698
|
+
"ns1"
|
|
1699
|
+
]
|
|
1700
|
+
},
|
|
1701
|
+
"security": [
|
|
1702
|
+
{
|
|
1703
|
+
"apiToken": []
|
|
1704
|
+
}
|
|
1705
|
+
],
|
|
1706
|
+
"group": "vps"
|
|
1707
|
+
},
|
|
1708
|
+
{
|
|
1709
|
+
"name": "VPS_createPTRRecordV1",
|
|
1710
|
+
"title": "Create PTR record",
|
|
1711
|
+
"annotations": {
|
|
1712
|
+
"title": "Create PTR record",
|
|
1713
|
+
"readOnlyHint": false,
|
|
1714
|
+
"destructiveHint": false
|
|
1715
|
+
},
|
|
1716
|
+
"description": "Create or update a PTR (Pointer) record for a specified virtual machine.\n\nUse this endpoint to configure reverse DNS lookup for VPS IP addresses.",
|
|
1717
|
+
"method": "POST",
|
|
1718
|
+
"path": "/api/vps/v1/virtual-machines/{virtualMachineId}/ptr/{ipAddressId}",
|
|
1719
|
+
"inputSchema": {
|
|
1720
|
+
"type": "object",
|
|
1721
|
+
"properties": {
|
|
1722
|
+
"virtualMachineId": {
|
|
1723
|
+
"type": "integer",
|
|
1724
|
+
"description": "Virtual Machine ID"
|
|
1725
|
+
},
|
|
1726
|
+
"ipAddressId": {
|
|
1727
|
+
"type": "integer",
|
|
1728
|
+
"description": "IP Address ID"
|
|
1729
|
+
},
|
|
1730
|
+
"domain": {
|
|
1731
|
+
"type": "string",
|
|
1732
|
+
"description": "Pointer record domain"
|
|
1733
|
+
}
|
|
1734
|
+
},
|
|
1735
|
+
"required": [
|
|
1736
|
+
"virtualMachineId",
|
|
1737
|
+
"ipAddressId",
|
|
1738
|
+
"domain"
|
|
1739
|
+
]
|
|
1740
|
+
},
|
|
1741
|
+
"security": [
|
|
1742
|
+
{
|
|
1743
|
+
"apiToken": []
|
|
1744
|
+
}
|
|
1745
|
+
],
|
|
1746
|
+
"group": "vps"
|
|
1747
|
+
},
|
|
1748
|
+
{
|
|
1749
|
+
"name": "VPS_deletePTRRecordV1",
|
|
1750
|
+
"title": "Delete PTR record",
|
|
1751
|
+
"annotations": {
|
|
1752
|
+
"title": "Delete PTR record",
|
|
1753
|
+
"readOnlyHint": false,
|
|
1754
|
+
"destructiveHint": true,
|
|
1755
|
+
"idempotentHint": true
|
|
1756
|
+
},
|
|
1757
|
+
"description": "Delete a PTR (Pointer) record for a specified virtual machine.\n\nOnce deleted, reverse DNS lookups to the virtual machine's IP address will\nno longer return the previously configured hostname.\n\nUse this endpoint to remove reverse DNS configuration from VPS instances.",
|
|
1758
|
+
"method": "DELETE",
|
|
1759
|
+
"path": "/api/vps/v1/virtual-machines/{virtualMachineId}/ptr/{ipAddressId}",
|
|
1760
|
+
"inputSchema": {
|
|
1761
|
+
"type": "object",
|
|
1762
|
+
"properties": {
|
|
1763
|
+
"virtualMachineId": {
|
|
1764
|
+
"type": "integer",
|
|
1765
|
+
"description": "Virtual Machine ID"
|
|
1766
|
+
},
|
|
1767
|
+
"ipAddressId": {
|
|
1768
|
+
"type": "integer",
|
|
1769
|
+
"description": "IP Address ID"
|
|
1770
|
+
}
|
|
1771
|
+
},
|
|
1772
|
+
"required": [
|
|
1773
|
+
"virtualMachineId",
|
|
1774
|
+
"ipAddressId"
|
|
1775
|
+
]
|
|
1776
|
+
},
|
|
1777
|
+
"security": [
|
|
1778
|
+
{
|
|
1779
|
+
"apiToken": []
|
|
1780
|
+
}
|
|
1781
|
+
],
|
|
1782
|
+
"group": "vps"
|
|
1783
|
+
},
|
|
1784
|
+
{
|
|
1785
|
+
"name": "VPS_setPanelPasswordV1",
|
|
1786
|
+
"title": "Set panel password",
|
|
1787
|
+
"annotations": {
|
|
1788
|
+
"title": "Set panel password",
|
|
1789
|
+
"readOnlyHint": false,
|
|
1790
|
+
"destructiveHint": true,
|
|
1791
|
+
"idempotentHint": true
|
|
1792
|
+
},
|
|
1793
|
+
"description": "Set panel password for a specified virtual machine.\n\nIf virtual machine does not use panel OS, the request will still be processed without any effect.\nRequirements for password are same as in the [recreate virtual machine\nendpoint](/#tag/vps-virtual-machine/POST/api/vps/v1/virtual-machines/{virtualMachineId}/recreate).\n\nUse this endpoint to configure control panel access credentials for VPS instances.",
|
|
1794
|
+
"method": "PUT",
|
|
1795
|
+
"path": "/api/vps/v1/virtual-machines/{virtualMachineId}/panel-password",
|
|
1796
|
+
"inputSchema": {
|
|
1797
|
+
"type": "object",
|
|
1798
|
+
"properties": {
|
|
1799
|
+
"virtualMachineId": {
|
|
1800
|
+
"type": "integer",
|
|
1801
|
+
"description": "Virtual Machine ID"
|
|
1802
|
+
},
|
|
1803
|
+
"password": {
|
|
1804
|
+
"type": "string",
|
|
1805
|
+
"description": "Panel password for the virtual machine"
|
|
1806
|
+
}
|
|
1807
|
+
},
|
|
1808
|
+
"required": [
|
|
1809
|
+
"virtualMachineId",
|
|
1810
|
+
"password"
|
|
1811
|
+
]
|
|
1812
|
+
},
|
|
1813
|
+
"security": [
|
|
1814
|
+
{
|
|
1815
|
+
"apiToken": []
|
|
1816
|
+
}
|
|
1817
|
+
],
|
|
1818
|
+
"group": "vps"
|
|
1819
|
+
},
|
|
1820
|
+
{
|
|
1821
|
+
"name": "VPS_startRecoveryModeV1",
|
|
1822
|
+
"title": "Start recovery mode",
|
|
1823
|
+
"annotations": {
|
|
1824
|
+
"title": "Start recovery mode",
|
|
1825
|
+
"readOnlyHint": false,
|
|
1826
|
+
"destructiveHint": false
|
|
1827
|
+
},
|
|
1828
|
+
"description": "Initiate recovery mode for a specified virtual machine.\n\nRecovery mode is a special state that allows users to perform system rescue operations, \nsuch as repairing file systems, recovering data, or troubleshooting issues that prevent the virtual machine \nfrom booting normally. \n\nVirtual machine will boot recovery disk image and original disk image will be mounted in `/mnt` directory.\n\nUse this endpoint to enable system rescue operations on VPS instances.",
|
|
1829
|
+
"method": "POST",
|
|
1830
|
+
"path": "/api/vps/v1/virtual-machines/{virtualMachineId}/recovery",
|
|
1831
|
+
"inputSchema": {
|
|
1832
|
+
"type": "object",
|
|
1833
|
+
"properties": {
|
|
1834
|
+
"virtualMachineId": {
|
|
1835
|
+
"type": "integer",
|
|
1836
|
+
"description": "Virtual Machine ID"
|
|
1837
|
+
},
|
|
1838
|
+
"root_password": {
|
|
1839
|
+
"type": "string",
|
|
1840
|
+
"description": "Temporary root password for recovery mode"
|
|
1841
|
+
}
|
|
1842
|
+
},
|
|
1843
|
+
"required": [
|
|
1844
|
+
"virtualMachineId",
|
|
1845
|
+
"root_password"
|
|
1846
|
+
]
|
|
1847
|
+
},
|
|
1848
|
+
"security": [
|
|
1849
|
+
{
|
|
1850
|
+
"apiToken": []
|
|
1851
|
+
}
|
|
1852
|
+
],
|
|
1853
|
+
"group": "vps"
|
|
1854
|
+
},
|
|
1855
|
+
{
|
|
1856
|
+
"name": "VPS_stopRecoveryModeV1",
|
|
1857
|
+
"title": "Stop recovery mode",
|
|
1858
|
+
"annotations": {
|
|
1859
|
+
"title": "Stop recovery mode",
|
|
1860
|
+
"readOnlyHint": false,
|
|
1861
|
+
"destructiveHint": true,
|
|
1862
|
+
"idempotentHint": true
|
|
1863
|
+
},
|
|
1864
|
+
"description": "Stop recovery mode for a specified virtual machine.\n\nIf virtual machine is not in recovery mode, this operation will fail.\n\nUse this endpoint to exit system rescue mode and return VPS to normal operation.",
|
|
1865
|
+
"method": "DELETE",
|
|
1866
|
+
"path": "/api/vps/v1/virtual-machines/{virtualMachineId}/recovery",
|
|
1867
|
+
"inputSchema": {
|
|
1868
|
+
"type": "object",
|
|
1869
|
+
"properties": {
|
|
1870
|
+
"virtualMachineId": {
|
|
1871
|
+
"type": "integer",
|
|
1872
|
+
"description": "Virtual Machine ID"
|
|
1873
|
+
}
|
|
1874
|
+
},
|
|
1875
|
+
"required": [
|
|
1876
|
+
"virtualMachineId"
|
|
1877
|
+
]
|
|
1878
|
+
},
|
|
1879
|
+
"security": [
|
|
1880
|
+
{
|
|
1881
|
+
"apiToken": []
|
|
1882
|
+
}
|
|
1883
|
+
],
|
|
1884
|
+
"group": "vps"
|
|
1885
|
+
},
|
|
1886
|
+
{
|
|
1887
|
+
"name": "VPS_recreateVirtualMachineV1",
|
|
1888
|
+
"title": "Recreate virtual machine",
|
|
1889
|
+
"annotations": {
|
|
1890
|
+
"title": "Recreate virtual machine",
|
|
1891
|
+
"readOnlyHint": false,
|
|
1892
|
+
"destructiveHint": true
|
|
1893
|
+
},
|
|
1894
|
+
"description": "Recreate a virtual machine from scratch.\n\nThe recreation process involves reinstalling the operating system and\nresetting the virtual machine to its initial state.\nSnapshots, if there are any, will be deleted.\n\n## Password Requirements\nPassword will be checked against leaked password databases. \nRequirements for the password are:\n- At least 12 characters long\n- At least one uppercase letter\n- At least one lowercase letter\n- At least one number\n- Is not leaked publicly\n\n**This operation is irreversible and will result in the loss of all data stored on the virtual machine!**\n\nUse this endpoint to completely rebuild VPS instances with fresh OS installation.",
|
|
1895
|
+
"method": "POST",
|
|
1896
|
+
"path": "/api/vps/v1/virtual-machines/{virtualMachineId}/recreate",
|
|
1897
|
+
"inputSchema": {
|
|
1898
|
+
"type": "object",
|
|
1899
|
+
"properties": {
|
|
1900
|
+
"virtualMachineId": {
|
|
1901
|
+
"type": "integer",
|
|
1902
|
+
"description": "Virtual Machine ID"
|
|
1903
|
+
},
|
|
1904
|
+
"template_id": {
|
|
1905
|
+
"type": "integer",
|
|
1906
|
+
"description": "Template ID"
|
|
1907
|
+
},
|
|
1908
|
+
"password": {
|
|
1909
|
+
"type": "string",
|
|
1910
|
+
"description": "Root password for the virtual machine. If not provided, random password will be generated.\nPassword will not be shown in the response."
|
|
1911
|
+
},
|
|
1912
|
+
"panel_password": {
|
|
1913
|
+
"type": "string",
|
|
1914
|
+
"description": "Panel password for the panel-based OS template. If not provided, random password will be generated.\nIf OS does not support panel_password this field will be ignored.\nPassword will not be shown in the response."
|
|
1915
|
+
},
|
|
1916
|
+
"post_install_script_id": {
|
|
1917
|
+
"type": "integer",
|
|
1918
|
+
"description": "Post-install script to execute after virtual machine was recreated"
|
|
1919
|
+
}
|
|
1920
|
+
},
|
|
1921
|
+
"required": [
|
|
1922
|
+
"virtualMachineId",
|
|
1923
|
+
"template_id"
|
|
1924
|
+
]
|
|
1925
|
+
},
|
|
1926
|
+
"security": [
|
|
1927
|
+
{
|
|
1928
|
+
"apiToken": []
|
|
1929
|
+
}
|
|
1930
|
+
],
|
|
1931
|
+
"group": "vps"
|
|
1932
|
+
},
|
|
1933
|
+
{
|
|
1934
|
+
"name": "VPS_restartVirtualMachineV1",
|
|
1935
|
+
"title": "Restart virtual machine",
|
|
1936
|
+
"annotations": {
|
|
1937
|
+
"title": "Restart virtual machine",
|
|
1938
|
+
"readOnlyHint": false,
|
|
1939
|
+
"destructiveHint": false
|
|
1940
|
+
},
|
|
1941
|
+
"description": "Restart a specified virtual machine by fully stopping and starting it.\n\nIf the virtual machine was stopped, it will be started.\n\nUse this endpoint to reboot VPS instances.",
|
|
1942
|
+
"method": "POST",
|
|
1943
|
+
"path": "/api/vps/v1/virtual-machines/{virtualMachineId}/restart",
|
|
1944
|
+
"inputSchema": {
|
|
1945
|
+
"type": "object",
|
|
1946
|
+
"properties": {
|
|
1947
|
+
"virtualMachineId": {
|
|
1948
|
+
"type": "integer",
|
|
1949
|
+
"description": "Virtual Machine ID"
|
|
1950
|
+
}
|
|
1951
|
+
},
|
|
1952
|
+
"required": [
|
|
1953
|
+
"virtualMachineId"
|
|
1954
|
+
]
|
|
1955
|
+
},
|
|
1956
|
+
"security": [
|
|
1957
|
+
{
|
|
1958
|
+
"apiToken": []
|
|
1959
|
+
}
|
|
1960
|
+
],
|
|
1961
|
+
"group": "vps"
|
|
1962
|
+
},
|
|
1963
|
+
{
|
|
1964
|
+
"name": "VPS_setRootPasswordV1",
|
|
1965
|
+
"title": "Set root password",
|
|
1966
|
+
"annotations": {
|
|
1967
|
+
"title": "Set root password",
|
|
1968
|
+
"readOnlyHint": false,
|
|
1969
|
+
"destructiveHint": true,
|
|
1970
|
+
"idempotentHint": true
|
|
1971
|
+
},
|
|
1972
|
+
"description": "Set root password for a specified virtual machine.\n\nRequirements for password are same as in the [recreate virtual machine\nendpoint](/#tag/vps-virtual-machine/POST/api/vps/v1/virtual-machines/{virtualMachineId}/recreate).\n\nUse this endpoint to update administrator credentials for VPS instances.",
|
|
1973
|
+
"method": "PUT",
|
|
1974
|
+
"path": "/api/vps/v1/virtual-machines/{virtualMachineId}/root-password",
|
|
1975
|
+
"inputSchema": {
|
|
1976
|
+
"type": "object",
|
|
1977
|
+
"properties": {
|
|
1978
|
+
"virtualMachineId": {
|
|
1979
|
+
"type": "integer",
|
|
1980
|
+
"description": "Virtual Machine ID"
|
|
1981
|
+
},
|
|
1982
|
+
"password": {
|
|
1983
|
+
"type": "string",
|
|
1984
|
+
"description": "Root password for the virtual machine"
|
|
1985
|
+
}
|
|
1986
|
+
},
|
|
1987
|
+
"required": [
|
|
1988
|
+
"virtualMachineId",
|
|
1989
|
+
"password"
|
|
1990
|
+
]
|
|
1991
|
+
},
|
|
1992
|
+
"security": [
|
|
1993
|
+
{
|
|
1994
|
+
"apiToken": []
|
|
1995
|
+
}
|
|
1996
|
+
],
|
|
1997
|
+
"group": "vps"
|
|
1998
|
+
},
|
|
1999
|
+
{
|
|
2000
|
+
"name": "VPS_setupPurchasedVirtualMachineV1",
|
|
2001
|
+
"title": "Setup purchased virtual machine",
|
|
2002
|
+
"annotations": {
|
|
2003
|
+
"title": "Setup purchased virtual machine",
|
|
2004
|
+
"readOnlyHint": false,
|
|
2005
|
+
"destructiveHint": false
|
|
2006
|
+
},
|
|
2007
|
+
"description": "Setup newly purchased virtual machine with `initial` state.\n\nUse this endpoint to configure and initialize purchased VPS instances.",
|
|
2008
|
+
"method": "POST",
|
|
2009
|
+
"path": "/api/vps/v1/virtual-machines/{virtualMachineId}/setup",
|
|
2010
|
+
"inputSchema": {
|
|
2011
|
+
"type": "object",
|
|
2012
|
+
"properties": {
|
|
2013
|
+
"virtualMachineId": {
|
|
2014
|
+
"type": "integer",
|
|
2015
|
+
"description": "Virtual Machine ID"
|
|
2016
|
+
},
|
|
2017
|
+
"template_id": {
|
|
2018
|
+
"type": "integer",
|
|
2019
|
+
"description": "Template ID"
|
|
2020
|
+
},
|
|
2021
|
+
"data_center_id": {
|
|
2022
|
+
"type": "integer",
|
|
2023
|
+
"description": "Data center ID"
|
|
2024
|
+
},
|
|
2025
|
+
"post_install_script_id": {
|
|
2026
|
+
"type": "integer",
|
|
2027
|
+
"description": "Post-install script ID"
|
|
2028
|
+
},
|
|
2029
|
+
"password": {
|
|
2030
|
+
"type": "string",
|
|
2031
|
+
"description": "Password for the virtual machine. If not provided, random password will be generated.\nPassword will not be shown in the response."
|
|
2032
|
+
},
|
|
2033
|
+
"hostname": {
|
|
2034
|
+
"type": "string",
|
|
2035
|
+
"description": "Override default hostname of the virtual machine"
|
|
2036
|
+
},
|
|
2037
|
+
"install_monarx": {
|
|
2038
|
+
"type": "boolean",
|
|
2039
|
+
"description": "Install Monarx malware scanner (if supported)"
|
|
2040
|
+
},
|
|
2041
|
+
"enable_backups": {
|
|
2042
|
+
"type": "boolean",
|
|
2043
|
+
"description": "Enable weekly backup schedule"
|
|
2044
|
+
},
|
|
2045
|
+
"ns1": {
|
|
2046
|
+
"type": "string",
|
|
2047
|
+
"description": "Name server 1"
|
|
2048
|
+
},
|
|
2049
|
+
"ns2": {
|
|
2050
|
+
"type": "string",
|
|
2051
|
+
"description": "Name server 2"
|
|
2052
|
+
},
|
|
2053
|
+
"public_key": {
|
|
2054
|
+
"type": "object",
|
|
2055
|
+
"description": "Use SSH key",
|
|
2056
|
+
"properties": {
|
|
2057
|
+
"name": {
|
|
2058
|
+
"type": "string",
|
|
2059
|
+
"description": "Name of the SSH key"
|
|
2060
|
+
},
|
|
2061
|
+
"key": {
|
|
2062
|
+
"type": "string",
|
|
2063
|
+
"description": "Contents of the SSH key"
|
|
2064
|
+
}
|
|
2065
|
+
}
|
|
2066
|
+
}
|
|
2067
|
+
},
|
|
2068
|
+
"required": [
|
|
2069
|
+
"virtualMachineId",
|
|
2070
|
+
"data_center_id",
|
|
2071
|
+
"template_id"
|
|
2072
|
+
]
|
|
2073
|
+
},
|
|
2074
|
+
"security": [
|
|
2075
|
+
{
|
|
2076
|
+
"apiToken": []
|
|
2077
|
+
}
|
|
2078
|
+
],
|
|
2079
|
+
"group": "vps"
|
|
2080
|
+
},
|
|
2081
|
+
{
|
|
2082
|
+
"name": "VPS_getSnapshotV1",
|
|
2083
|
+
"title": "Get snapshot",
|
|
2084
|
+
"annotations": {
|
|
2085
|
+
"title": "Get snapshot",
|
|
2086
|
+
"readOnlyHint": true,
|
|
2087
|
+
"destructiveHint": false
|
|
2088
|
+
},
|
|
2089
|
+
"description": "Retrieve snapshot for a specified virtual machine.\n\nUse this endpoint to view current VPS snapshot information.",
|
|
2090
|
+
"method": "GET",
|
|
2091
|
+
"path": "/api/vps/v1/virtual-machines/{virtualMachineId}/snapshot",
|
|
2092
|
+
"inputSchema": {
|
|
2093
|
+
"type": "object",
|
|
2094
|
+
"properties": {
|
|
2095
|
+
"virtualMachineId": {
|
|
2096
|
+
"type": "integer",
|
|
2097
|
+
"description": "Virtual Machine ID"
|
|
2098
|
+
}
|
|
2099
|
+
},
|
|
2100
|
+
"required": [
|
|
2101
|
+
"virtualMachineId"
|
|
2102
|
+
]
|
|
2103
|
+
},
|
|
2104
|
+
"security": [
|
|
2105
|
+
{
|
|
2106
|
+
"apiToken": []
|
|
2107
|
+
}
|
|
2108
|
+
],
|
|
2109
|
+
"group": "vps"
|
|
2110
|
+
},
|
|
2111
|
+
{
|
|
2112
|
+
"name": "VPS_createSnapshotV1",
|
|
2113
|
+
"title": "Create snapshot",
|
|
2114
|
+
"annotations": {
|
|
2115
|
+
"title": "Create snapshot",
|
|
2116
|
+
"readOnlyHint": false,
|
|
2117
|
+
"destructiveHint": false
|
|
2118
|
+
},
|
|
2119
|
+
"description": "Create a snapshot of a specified virtual machine.\n\nA snapshot captures the state and data of the virtual machine at a specific point in time, \nallowing users to restore the virtual machine to that state if needed. \nThis operation is useful for backup purposes, system recovery, \nand testing changes without affecting the current state of the virtual machine.\n\n**Creating new snapshot will overwrite the existing snapshot!**\n\nUse this endpoint to capture VPS state for backup and recovery purposes.",
|
|
2120
|
+
"method": "POST",
|
|
2121
|
+
"path": "/api/vps/v1/virtual-machines/{virtualMachineId}/snapshot",
|
|
2122
|
+
"inputSchema": {
|
|
2123
|
+
"type": "object",
|
|
2124
|
+
"properties": {
|
|
2125
|
+
"virtualMachineId": {
|
|
2126
|
+
"type": "integer",
|
|
2127
|
+
"description": "Virtual Machine ID"
|
|
2128
|
+
}
|
|
2129
|
+
},
|
|
2130
|
+
"required": [
|
|
2131
|
+
"virtualMachineId"
|
|
2132
|
+
]
|
|
2133
|
+
},
|
|
2134
|
+
"security": [
|
|
2135
|
+
{
|
|
2136
|
+
"apiToken": []
|
|
2137
|
+
}
|
|
2138
|
+
],
|
|
2139
|
+
"group": "vps"
|
|
2140
|
+
},
|
|
2141
|
+
{
|
|
2142
|
+
"name": "VPS_deleteSnapshotV1",
|
|
2143
|
+
"title": "Delete snapshot",
|
|
2144
|
+
"annotations": {
|
|
2145
|
+
"title": "Delete snapshot",
|
|
2146
|
+
"readOnlyHint": false,
|
|
2147
|
+
"destructiveHint": true,
|
|
2148
|
+
"idempotentHint": true
|
|
2149
|
+
},
|
|
2150
|
+
"description": "Delete a snapshot of a specified virtual machine.\n\nUse this endpoint to remove VPS snapshots.",
|
|
2151
|
+
"method": "DELETE",
|
|
2152
|
+
"path": "/api/vps/v1/virtual-machines/{virtualMachineId}/snapshot",
|
|
2153
|
+
"inputSchema": {
|
|
2154
|
+
"type": "object",
|
|
2155
|
+
"properties": {
|
|
2156
|
+
"virtualMachineId": {
|
|
2157
|
+
"type": "integer",
|
|
2158
|
+
"description": "Virtual Machine ID"
|
|
2159
|
+
}
|
|
2160
|
+
},
|
|
2161
|
+
"required": [
|
|
2162
|
+
"virtualMachineId"
|
|
2163
|
+
]
|
|
2164
|
+
},
|
|
2165
|
+
"security": [
|
|
2166
|
+
{
|
|
2167
|
+
"apiToken": []
|
|
2168
|
+
}
|
|
2169
|
+
],
|
|
2170
|
+
"group": "vps"
|
|
2171
|
+
},
|
|
2172
|
+
{
|
|
2173
|
+
"name": "VPS_restoreSnapshotV1",
|
|
2174
|
+
"title": "Restore snapshot",
|
|
2175
|
+
"annotations": {
|
|
2176
|
+
"title": "Restore snapshot",
|
|
2177
|
+
"readOnlyHint": false,
|
|
2178
|
+
"destructiveHint": true
|
|
2179
|
+
},
|
|
2180
|
+
"description": "Restore a specified virtual machine to a previous state using a snapshot.\n\nRestoring from a snapshot allows users to revert the virtual machine to that state,\nwhich is useful for system recovery, undoing changes, or testing.\n\nUse this endpoint to revert VPS instances to previous saved states.",
|
|
2181
|
+
"method": "POST",
|
|
2182
|
+
"path": "/api/vps/v1/virtual-machines/{virtualMachineId}/snapshot/restore",
|
|
2183
|
+
"inputSchema": {
|
|
2184
|
+
"type": "object",
|
|
2185
|
+
"properties": {
|
|
2186
|
+
"virtualMachineId": {
|
|
2187
|
+
"type": "integer",
|
|
2188
|
+
"description": "Virtual Machine ID"
|
|
2189
|
+
}
|
|
2190
|
+
},
|
|
2191
|
+
"required": [
|
|
2192
|
+
"virtualMachineId"
|
|
2193
|
+
]
|
|
2194
|
+
},
|
|
2195
|
+
"security": [
|
|
2196
|
+
{
|
|
2197
|
+
"apiToken": []
|
|
2198
|
+
}
|
|
2199
|
+
],
|
|
2200
|
+
"group": "vps"
|
|
2201
|
+
},
|
|
2202
|
+
{
|
|
2203
|
+
"name": "VPS_startVirtualMachineV1",
|
|
2204
|
+
"title": "Start virtual machine",
|
|
2205
|
+
"annotations": {
|
|
2206
|
+
"title": "Start virtual machine",
|
|
2207
|
+
"readOnlyHint": false,
|
|
2208
|
+
"destructiveHint": false
|
|
2209
|
+
},
|
|
2210
|
+
"description": "Start a specified virtual machine.\n\nIf the virtual machine is already running, the request will still be processed without any effect.\n\nUse this endpoint to power on stopped VPS instances.",
|
|
2211
|
+
"method": "POST",
|
|
2212
|
+
"path": "/api/vps/v1/virtual-machines/{virtualMachineId}/start",
|
|
2213
|
+
"inputSchema": {
|
|
2214
|
+
"type": "object",
|
|
2215
|
+
"properties": {
|
|
2216
|
+
"virtualMachineId": {
|
|
2217
|
+
"type": "integer",
|
|
2218
|
+
"description": "Virtual Machine ID"
|
|
2219
|
+
}
|
|
2220
|
+
},
|
|
2221
|
+
"required": [
|
|
2222
|
+
"virtualMachineId"
|
|
2223
|
+
]
|
|
2224
|
+
},
|
|
2225
|
+
"security": [
|
|
2226
|
+
{
|
|
2227
|
+
"apiToken": []
|
|
2228
|
+
}
|
|
2229
|
+
],
|
|
2230
|
+
"group": "vps"
|
|
2231
|
+
},
|
|
2232
|
+
{
|
|
2233
|
+
"name": "VPS_stopVirtualMachineV1",
|
|
2234
|
+
"title": "Stop virtual machine",
|
|
2235
|
+
"annotations": {
|
|
2236
|
+
"title": "Stop virtual machine",
|
|
2237
|
+
"readOnlyHint": false,
|
|
2238
|
+
"destructiveHint": true
|
|
2239
|
+
},
|
|
2240
|
+
"description": "Stop a specified virtual machine.\n\nIf the virtual machine is already stopped, the request will still be processed without any effect.\n\nThis is a compute-only power state change and does not affect billing. To stop future charges,\ndisable auto-renewal on the owning subscription.\n\nUse this endpoint to power off running VPS instances.",
|
|
2241
|
+
"method": "POST",
|
|
2242
|
+
"path": "/api/vps/v1/virtual-machines/{virtualMachineId}/stop",
|
|
2243
|
+
"inputSchema": {
|
|
2244
|
+
"type": "object",
|
|
2245
|
+
"properties": {
|
|
2246
|
+
"virtualMachineId": {
|
|
2247
|
+
"type": "integer",
|
|
2248
|
+
"description": "Virtual Machine ID"
|
|
2249
|
+
}
|
|
2250
|
+
},
|
|
2251
|
+
"required": [
|
|
2252
|
+
"virtualMachineId"
|
|
2253
|
+
]
|
|
2254
|
+
},
|
|
2255
|
+
"security": [
|
|
2256
|
+
{
|
|
2257
|
+
"apiToken": []
|
|
2258
|
+
}
|
|
2259
|
+
],
|
|
2260
|
+
"group": "vps"
|
|
2261
|
+
}
|
|
2262
|
+
];
|
|
2263
|
+
export default tools;
|