Администратору DCImanager

DCImanager BE

{ "openapi": "3.0.0", "info": { "title": "DCImanager 6 API", "description": "DCImanager 6 API", "version": "3.0.0" }, "servers": [ { "url": "https://127.0.0.1/api/dci/v3" } ], "tags": [ { "name": "common", "description": "General" }, { "name": "ip", "description": "IP addresses" }, { "name": "ipmgr", "description": "IPmgr6" }, { "name": "ipmi", "description": "IPMI" }, { "name": "iso", "description": "ISO image" }, { "name": "license", "description": "Licensing" }, { "name": "location", "description": "Locations" }, { "name": "operation", "description": "Operations" }, { "name": "os_template", "description": "OS templates" }, { "name": "pdu", "description": "PDU" }, { "name": "pdu_connection", "description": "PDU connections" }, { "name": "rack", "description": "Racks" }, { "name": "server", "description": "Servers" }, { "name": "switch", "description": "Switches" }, { "name": "power", "description": "Server power management" }, { "name": "switch_connection", "description": "Switch connections" }, { "name": "user", "description": "Users" }, { "name": "platform", "description": "Platforms" }, { "name": "cpu_socket", "description": "CPU socket" }, { "name": "update", "description": "Panel updates" }, { "name": "chassis", "description": "Blade Server Chassis" }, { "name": "vlan", "description": "VLAN" }, { "name": "recipe", "description": "Recipe" }, { "name": "journal", "description": "Journal" }, { "name": "user_vlans_module", "description": "User VLANs module" } ], "components": { "securitySchemes": { "cookieAuth": { "type": "apiKey", "in": "cookie", "name": "ses6" }, "headerHost": { "type": "apiKey", "in": "header", "name": "host" } }, "requestBodies": { "OsTemplateSetupPostParams": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OsTemplateSetupPostParams" } } } }, "EmptyRequest": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EmptySchema" } } } } }, "schemas": { "OsTemplateGetResponse": { "properties": { "datetime": { "type": "string" }, "filename": { "type": "string" }, "id": { "type": "integer" }, "locations": { "items": { "properties": { "datetime": { "type": "string" }, "location": { "type": "integer" }, "status": { "enum": [ "ok", "fail", "installing", "deleting", "need_update" ], "type": "string" }, "status_info": { "type": "object" }, "macro": { "type": "object", "example": "{\"($NAMESERVERv4)\": \"8.8.8.8\"}" } }, "type": "object" }, "type": "array" }, "name": { "type": "string" }, "status": { "enum": [ "none", "installed" ], "type": "string" }, "status_info": { "type": "object" }, "tags": { "items": { "type": "string" }, "type": "array" }, "type": { "enum": [ "ostemplate", "diag", "rescue", "serversearch", "isotemplate" ], "type": "string" }, "version": { "type": "string" }, "owner": { "type": "object", "properties": { "id": { "type": "integer" }, "email": { "type": "string" } } }, "access": { "enum": [ "admin", "all" ], "type": "string" }, "macro": { "description": "OS template macros redefinition", "type": "object" }, "efi": { "type": "boolean", "description": "Does the OS template support EFI" }, "autoupdate": { "type": "boolean", "description": "Does auto update is enabled for the OS template on the location" }, "supported_raids": { "type": "array", "items": { "type": "string" }, "description": "Raids supported by the template" } }, "type": "object" }, "OsTemplateListResponse": { "properties": { "list": { "items": { "$ref": "#/components/schemas/OsTemplateGetResponse" }, "type": "array" } }, "type": "object" }, "OsTemplateSetupPostParams": { "properties": { "os_templates": { "items": { "type": "integer" }, "type": "array" } }, "type": "object" }, "OsTemplateEditParams": { "additionalProperties": false, "required": [ "macro" ], "type": "object", "properties": { "macro": { "description": "OS template macros redefinition", "example": "{\"($NAMESERVER)\": \"1.1.1.1\"}", "type": "object" } } }, "OsTemplateCopyParams": { "additionalProperties": false, "required": [ "name", "access" ], "type": "object", "properties": { "name": { "type": "string", "description": "The name of the OS template", "pattern": "^[\\w .-]+$" }, "access": { "enum": [ "admin", "all" ], "type": "string", "description": "The access level for OS template" }, "efi": { "type": "boolean", "description": "Does the OS template support EFI" }, "tags": { "description": "Tags", "items": { "type": "string" }, "type": "array" }, "macro": { "description": "OS template macros redefinition", "example": "{\"($NAMESERVER)\": \"1.1.1.1\"}", "type": "object" }, "hdd_raid": { "enum": [ "no_raid", "raid_0", "raid_1", "raid_5", "raid_10" ], "type": "string" } } }, "OsTemplatePartition": { "type": "object", "properties": { "mountpoint": { "type": "string" }, "size": { "type": "string" }, "type": { "type": "string", "enum": [ "swap", "ext2", "ext3", "ext4", "xfs", "ufs", "zfs" ] } } }, "OsTemplateRaid": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "no_raid", "raid_0", "raid_1", "raid_5", "raid_10" ] }, "partition": { "type": "array", "items": { "$ref": "#/components/schemas/OsTemplatePartition" } } } }, "OsTemplateRaidList": { "type": "object", "properties": { "raid": { "type": "array", "items": { "$ref": "#/components/schemas/OsTemplateRaid" } } } }, "OsTemplatePresetLayout": { "properties": { "CentOS-6-amd64": { "$ref": "#/components/schemas/OsTemplateRaidList" }, "CentOS-6-amd64-netinstall": { "$ref": "#/components/schemas/OsTemplateRaidList" }, "CentOS-7-amd64": { "$ref": "#/components/schemas/OsTemplateRaidList" }, "CentOS-7-amd64-netinstall": { "$ref": "#/components/schemas/OsTemplateRaidList" }, "CentOS-8-amd64": { "$ref": "#/components/schemas/OsTemplateRaidList" }, "Debian-10-x86_64": { "$ref": "#/components/schemas/OsTemplateRaidList" }, "Debian-10-x86_64-netinstall": { "$ref": "#/components/schemas/OsTemplateRaidList" }, "Debian-7-amd64": { "$ref": "#/components/schemas/OsTemplateRaidList" }, "Debian-7-amd64-netinstall": { "$ref": "#/components/schemas/OsTemplateRaidList" }, "Debian-8-x86_64": { "$ref": "#/components/schemas/OsTemplateRaidList" }, "Debian-8-x86_64-netinstall": { "$ref": "#/components/schemas/OsTemplateRaidList" }, "Debian-9-x86_64": { "$ref": "#/components/schemas/OsTemplateRaidList" }, "Debian-9-x86_64-netinstall": { "$ref": "#/components/schemas/OsTemplateRaidList" }, "FreeBSD-10-amd64": { "$ref": "#/components/schemas/OsTemplateRaidList" }, "FreeBSD-10-amd64-netinstall": { "$ref": "#/components/schemas/OsTemplateRaidList" }, "FreeBSD-11-amd64": { "$ref": "#/components/schemas/OsTemplateRaidList" }, "FreeBSD-11-amd64-netinstall": { "$ref": "#/components/schemas/OsTemplateRaidList" }, "FreeBSD-12-amd64": { "$ref": "#/components/schemas/OsTemplateRaidList" }, "FreeBSD-12-amd64-netinstall": { "$ref": "#/components/schemas/OsTemplateRaidList" }, "FreeBSD-9-amd64": { "$ref": "#/components/schemas/OsTemplateRaidList" }, "Ubuntu-14.04-amd64": { "$ref": "#/components/schemas/OsTemplateRaidList" }, "Ubuntu-14.04-amd64-netinstall": { "$ref": "#/components/schemas/OsTemplateRaidList" }, "Ubuntu-16.04-amd64": { "$ref": "#/components/schemas/OsTemplateRaidList" }, "Ubuntu-16.04-amd64-netinstall": { "$ref": "#/components/schemas/OsTemplateRaidList" }, "Ubuntu-18.04-amd64": { "$ref": "#/components/schemas/OsTemplateRaidList" }, "Ubuntu-18.04-amd64-netinstall": { "$ref": "#/components/schemas/OsTemplateRaidList" }, "Ubuntu-20.04-amd64": { "$ref": "#/components/schemas/OsTemplateRaidList" }, "Ubuntu-20.04-amd64-netinstall": { "$ref": "#/components/schemas/OsTemplateRaidList" } } }, "ServerToPduPostParams": { "additionalProperties": false, "type": "object", "required": [ "server_id", "pdu_port_id" ], "properties": { "server_id": { "description": "The server identifier", "example": 13, "type": "integer" }, "pdu_port_id": { "description": "PDU port identifier", "example": 2, "type": "integer" } } }, "PduConnectionGetResponse": { "type": "object", "properties": { "server": { "type": "integer", "description": "The server identifier", "example": 25 }, "id": { "type": "integer", "description": "The connection identifier", "example": 42 }, "pdu": { "type": "integer", "description": "The PDU identifier", "example": 33 }, "pdu_port": { "type": "integer", "description": "The PDU port identifier", "example": 15 } } }, "ServerOperationFinishPostParams": { "type": "object", "properties": { "hardware_info": { "description": "Server configuration information", "type": "object" } } }, "ServerOperationCancelPostParams": { "type": "object", "additionalProperties": false, "properties": { "reason": { "type": "object", "description": "The operation cancel reason", "example": "{\"reason\": \"timeout\"}" } } }, "ServerOperationFailPostParams": { "type": "object", "properties": { "reason": { "description": "Server configuration information", "type": "string" } } }, "ServerOperationOsPostParams": { "additionalProperties": false, "properties": { "hdd_raid": { "enum": [ "no_raid", "raid_0", "raid_1", "raid_5", "raid_10" ], "type": "string" }, "os_template_id": { "description": "Template identifier", "type": "integer" }, "password": { "example": "password", "pattern": "^[^ ]", "type": "string" }, "ssh_pub_keys": { "type": "array", "description": "Public ssh keys", "items": { "type": "string", "format": "sshkey" } }, "recipe_id": { "description": "The unique recipe identifier. This recipe will be run on the server after OS installation", "type": "integer" }, "disk_layout": { "type": "array", "description": "List of disk layouts", "items": { "type": "object", "properties": { "os_install": { "type": "boolean", "description": "Indicates that layout uses for OS installation" }, "type": { "type": "string", "description": "Type of layout", "enum": [ "no_raid", "hw_raid", "raid_0", "raid_1", "raid_5", "raid_10" ] }, "disk": { "description": "Disk list of current layout", "type": "array", "items": { "type": "string" } }, "partition": { "type": "array", "description": "List of partition in current layout", "items": { "type": "object", "properties": { "mountpoint": { "description": "Partition mountpoint", "type": "string" }, "type": { "description": "Type of partition", "type": "string", "enum": [ "swap", "ext2", "ext3", "ext4", "ufs", "zfs", "xfs" ] }, "size": { "type": "integer", "description": "Size of partition in megabytes" } } } } } } } }, "required": [ "os_template_id", "password" ], "type": "object" }, "ServerOperationDiagPostParams": { "type": "object", "additionalProperties": false, "required": [ "os_template_id", "clear_hdd" ], "properties": { "setup_ipmi": { "type": "boolean", "description": "Option allows to configure IPMI" }, "os_template_id": { "type": "integer", "description": "Diagnostics template identifier" }, "clear_hdd": { "type": "string", "description": "Disk cleanup type: * none - without cleanup * simple - quick cleanup * full - full cleanup\n", "enum": [ "none", "simple", "full" ] } } }, "ServerOperationRescuePostParams": { "type": "object", "additionalProperties": false, "required": [ "os_template_id", "password" ], "properties": { "os_template_id": { "type": "integer", "description": "Rescue template identifier" }, "password": { "type": "string" } } }, "ServerOperationIsoPostParams": { "type": "object", "additionalProperties": false, "required": [ "iso_id" ], "properties": { "iso_id": { "type": "integer", "description": "ISO image unique identifier" } } }, "ServerOperationClearHddPostParams": { "type": "object", "additionalProperties": false, "required": [ "clear_hdd" ], "properties": { "clear_hdd": { "type": "string", "description": "Disk cleanup type: * none - without cleanup * simple - quick cleanup * full - full cleanup\n", "enum": [ "none", "simple", "full" ] } } }, "OperationListResponse": { "type": "object", "properties": { "list": { "type": "array", "items": { "$ref": "#/components/schemas/OperationGetResponse" } } } }, "UserVlanCreatePostParams": { "additionalProperties": false, "properties": { "name": { "description": "The vlan name", "example": "vlan512", "type": "string" }, "note": { "description": "The user note for vlan", "example": "Vlan for testing", "type": "string" } }, "required": [ "name" ], "type": "object" }, "UserVlansLocationGetResponse": { "properties": { "has_available_vlans": { "description": "Does the location have free vlans", "example": true, "type": "boolean" } } }, "IsoCreatePostParams": { "additionalProperties": false, "required": [ "name", "access", "type", "tags", "url" ], "type": "object", "properties": { "name": { "description": "Name of ISO image", "type": "string" }, "access": { "description": "Access to ISO image", "enum": [ "owner", "admin", "all" ], "type": "string" }, "type": { "description": "Type of ISO image", "enum": [ "os", "diag", "rescue" ], "type": "string" }, "note": { "description": "Note for ISO image", "type": "string" }, "tags": { "description": "Tags for ISO image", "items": { "type": "string" }, "type": "array" }, "url": { "description": "Download url for ISO image", "type": "string" } } }, "IsoEditPostParams": { "additionalProperties": false, "type": "object", "properties": { "name": { "description": "Name of ISO image", "type": "string" }, "access": { "description": "Access to ISO image", "enum": [ "owner", "admin", "all" ], "type": "string" }, "type": { "description": "Type of ISO image", "enum": [ "os", "diag", "rescue" ], "type": "string" }, "note": { "description": "Note for ISO image", "type": "string" }, "tags": { "description": "Tags for ISO image", "items": { "type": "string" }, "type": "array" }, "url": { "description": "Download url for ISO image", "type": "string" } } }, "IsoGetResponse": { "type": "object", "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "size": { "type": "integer" }, "type": { "type": "string", "enum": [ "os", "diag", "rescue" ] }, "tags": { "type": "array", "items": { "type": "string" } }, "datetime": { "type": "string" }, "access": { "type": "string", "enum": [ "admin", "owner", "all" ] }, "owner": { "type": "integer" }, "location": { "type": "integer" }, "note": { "type": "string" }, "status": { "enum": [ "ok", "fail", "deleting", "downloading" ], "type": "string" }, "status_info": { "type": "object" } } }, "IsoListResponse": { "properties": { "list": { "items": { "$ref": "#/components/schemas/IsoGetResponse" }, "type": "array" } }, "type": "object" }, "LocationCreatePostParams": { "additionalProperties": false, "properties": { "geolocation": { "description": "Location address", "example": "1st Street, 25", "type": "string" }, "name": { "description": "Location name", "example": "DataCenter2", "pattern": "^[^ ]", "type": "string" }, "password": { "description": "Password", "type": "string" }, "ssh_address": { "description": "SSH access IP address", "example": "127.0.0.1", "format": "ipv4", "type": "string" }, "ssh_port": { "description": "SSH access port", "example": 22, "maximum": 65535, "minimum": 1, "type": "integer" }, "ssh_user": { "description": "Username for SSH access", "example": "root", "minLength": 1, "pattern": "^[^ ]", "type": "string" } }, "required": [ "name", "ssh_address", "ssh_port", "ssh_user" ], "type": "object" }, "LocationEditPostParams": { "additionalProperties": false, "properties": { "geolocation": { "description": "Location address", "example": "1st Street, 25", "type": "string" }, "name": { "description": "Location name", "example": "my key name", "pattern": "^[^ ]", "type": "string" }, "password": { "description": "SSH access password", "type": "string" }, "ssh_address": { "description": "SSH access IP address", "example": "127.0.0.1", "format": "ipv4", "type": "string" }, "ssh_port": { "description": "SSH access port", "example": 22, "maximum": 65535, "minimum": 1, "type": "integer" }, "ssh_user": { "description": "SSH access username", "example": "root", "minLength": 1, "pattern": "^[^ ]", "type": "string" }, "settings": { "description": "Location settings", "additionalProperties": false, "properties": { "public_pool": { "description": "IP pool for server dedicating", "example": 13, "minimum": 1, "type": "integer" }, "free_pool": { "description": "IP Pool for server free", "example": 69, "minimum": 1, "type": "integer" }, "allowed_vlans_range": { "description": "Allowed VLANs range for user VLANs module", "example": "1-15, 29, 50, 333-400", "type": "string" } }, "type": "object" } }, "type": "object" }, "LocationGetResponse": { "properties": { "geolocation": { "description": "Location address", "example": "1st Street, 25", "type": "string" }, "id": { "type": "integer" }, "name": { "type": "string" }, "params_dhcp": { "description": "dhcp parameters", "properties": { "interfaces_4": { "description": "dhcp v4 interfaces", "items": { "type": "string" }, "type": "array" } }, "type": "object" }, "params_nginx": { "description": "Nginx parameters", "properties": { "addresses": { "description": "List of nginx addresses", "items": { "type": "string" }, "type": "array" }, "port": { "description": "Port", "type": "integer" } }, "type": "object" }, "params_redis": { "description": "Redis parameters", "properties": { "password": { "description": "Password", "type": "string" }, "port": { "description": "Port", "type": "integer" } }, "type": "object" }, "params_netflow": { "description": "Netflow parameters", "properties": { "collect_netflow": { "description": "Flag that allows collect NetFlow data on the location", "type": "boolean", "default": false, "example": false }, "addresses": { "description": "IP addresses on which NetFlow Colloctor will listen", "items": { "example": "127.0.0.1", "format": "ipv4", "type": "string" }, "type": "array" }, "port": { "description": "Port on which NetFlow Collector will listen", "type": "integer", "maximum": 65535, "minimum": 1, "example": 2055 } }, "type": "object" }, "setup_info": { "description": "Parameters for location configuration", "properties": { "addresses": { "description": "Addresses list", "items": { "type": "string" }, "type": "array" }, "interfaces": { "description": "Interfaces for dhcp configuration", "items": { "type": "string" }, "type": "array" } }, "type": "object" }, "ssh_address": { "description": "SSH access IP address", "type": "string" }, "ssh_port": { "description": "SSH access port", "type": "integer" }, "ssh_user": { "description": "SSH access username", "type": "string" }, "status": { "description": "Status", "enum": [ "created", "check_failed", "need_setup", "setup", "ok", "setup_failed" ], "type": "string" }, "userspace": { "description": "Userspace ID in IPmgr6 for pools and networks of this location", "type": "integer" }, "dhcp4_conf": { "type": "object", "description": "kea-dhcp4 configuration file" }, "docker_compose": { "description": "Compose file that was used for location configuration (internal only)", "type": "string" }, "settings": { "description": "Location settings", "properties": { "public_pool": { "description": "IP pool for server dedicating", "type": "integer" }, "free_pool": { "description": "IP Pool for server free", "type": "integer" }, "allowed_vlans_range": { "description": "Allowed VLANs range for user VLANs module", "example": "1-15, 29, 50, 333-400", "type": "string" } }, "type": "object" } }, "type": "object" }, "LocationListResponse": { "properties": { "list": { "items": { "$ref": "#/components/schemas/LocationGetResponse" }, "type": "array" } }, "type": "object" }, "LocationSetupPostParams": { "additionalProperties": false, "properties": { "dhcp": { "type": "object", "description": "Dhcp configuration parameters", "properties": { "interfaces_4": { "description": "Dhcp v4 configuration interfaces", "items": { "type": "string" }, "type": "array" } } }, "nginx": { "description": "Nginx configuration parameters", "properties": { "addresses": { "description": "IP addresses on which nginx will listen", "items": { "example": "127.0.0.1", "format": "ipv4", "type": "string" }, "type": "array" } }, "type": "object" }, "netflow": { "description": "NetFlow configuration parameters", "properties": { "collect_netflow": { "description": "Flag that allows collect NetFlow data on the location", "type": "boolean", "default": false, "example": false }, "addresses": { "description": "IP addresses on which NetFlow Colloctor will listen", "items": { "example": "127.0.0.1", "format": "ipv4", "type": "string" }, "type": "array" }, "port": { "description": "Port on which NetFlow Collector will listen", "type": "integer", "maximum": 65535, "minimum": 1, "example": 2055 } }, "type": "object", "additionalProperties": false, "required": [ "collect_netflow", "addresses", "port" ] } }, "type": "object" }, "LocationMessagePostParams": { "additionalProperties": true, "properties": { "stream": { "type": "string", "description": "Thread where the message was published" }, "message": { "description": "Message", "type": "object" } }, "required": [ "stream", "message" ], "type": "object" }, "RackCreatePostParams": { "additionalProperties": false, "properties": { "name": { "description": "Rack name", "example": "my key name", "pattern": "^[^ ]", "type": "string" }, "note": { "description": "Comment", "type": "string" }, "size": { "description": "Rack size", "maximum": 99, "minimum": 1, "type": "integer" }, "public_pool": { "description": "IP pool for server dedicating", "oneOf": [ { "type": "integer" }, { "type": "null" } ] } }, "required": [ "name", "size" ], "type": "object" }, "RackEditPostParams": { "additionalProperties": false, "properties": { "name": { "description": "Rack name", "example": "my key name", "pattern": "^[^ ]", "type": "string" }, "note": { "description": "Comment", "type": "string" }, "public_pool": { "description": "IP pool for server dedicating", "oneOf": [ { "type": "integer" }, { "type": "null" } ] }, "size": { "description": "The rack size in units", "maximum": 99, "minimum": 1, "type": "integer" } }, "type": "object" }, "RackGetResponse": { "properties": { "device_server": { "description": "Servers installed into the rack", "items": { "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "unit": { "type": "integer" }, "size": { "type": "number" } }, "type": "object" }, "type": "array" }, "id": { "type": "integer" }, "location": { "$ref": "#/components/schemas/LocationSubquery" }, "name": { "type": "string" }, "reserved": { "description": "Number of reserved units", "type": "integer" }, "size": { "type": "integer" }, "used": { "description": "Number of units in use", "format": "float", "type": "number" }, "free": { "description": "Number of free units", "format": "float", "type": "number" }, "device_switch": { "description": "List of switches", "type": "array", "items": { "properties": { "id": { "type": "integer", "description": "Switch identifier" }, "name": { "type": "string", "description": "Switch name" }, "unit": { "type": "integer", "description": "Unit" }, "size": { "type": "string", "description": "Size" } } } }, "device_pdu": { "description": "List of PDU", "type": "array", "items": { "properties": { "id": { "type": "integer", "description": "PDU identifier" }, "name": { "type": "string", "description": "PDU name" }, "unit": { "type": "integer", "nullable": true, "description": "Unit where device is located. Return null, if it is a 0-unit device" }, "size": { "type": "string", "description": "Size" } } } }, "device_chassis": { "description": "List of Chassis", "type": "array", "items": { "properties": { "id": { "type": "integer", "description": "Chassis identifier" }, "name": { "type": "string", "description": "Chassis name" }, "unit": { "type": "integer", "description": "Unit" }, "size": { "type": "string", "description": "Size" } } } }, "public_pool": { "description": "IP pool for server dedicating", "oneOf": [ { "type": "integer" }, { "type": "null" } ] } }, "type": "object" }, "RackListResponse": { "properties": { "list": { "items": { "$ref": "#/components/schemas/RackGetResponse" }, "type": "array" } }, "type": "object" }, "RackGetUnitsResponse": { "type": "object", "properties": { "list": { "type": "array", "description": "List of rack units with devices and sizes", "items": { "type": "object", "properties": { "unit": { "type": "integer", "nullable": true, "description": "Unit number" }, "busy_space": { "format": "float", "type": "number", "description": "How much space is occupied in unit, 0.0 - unit available, 1.0 - unit is in use\n" }, "devices": { "type": "array", "items": { "type": "object", "description": "Device that occupies the unit", "properties": { "id": { "type": "integer", "description": "Device id that occupies the unit" }, "name": { "type": "string", "description": "Device name", "example": "Server 2568" }, "size": { "format": "float", "type": "number", "description": "Device size. Return zero, if it is a 0-unit device", "example": 1.5 }, "unit": { "type": "integer", "nullable": true, "description": "Unit where device is located. Return null, if it is a 0-unit device" }, "type": { "type": "string", "description": "Device type that occupies the unit", "example": "dci_server" } } } } } } } } }, "ChassisCreatePostParams": { "additionalProperties": false, "required": [ "name", "size", "server_slot_count", "unit" ], "type": "object", "properties": { "name": { "description": "Chassis name", "type": "string", "minLength": 1, "maxLength": 49, "pattern": "^([\\w]+)([\\w\\- ]+)$", "example": "Multix4DE5" }, "size": { "description": "Chassis size", "type": "number", "minimum": 0, "maximum": 99, "multipleOf": 0.5, "example": 4 }, "server_slot_count": { "description": "Number of slots in chassis for blade servers", "type": "integer", "minimum": 2, "maximum": 32, "example": 16 }, "note": { "description": "Comment", "type": "string" }, "unit": { "description": "Starting unit where device is located", "maximum": 99, "minimum": 1, "example": "1", "type": "integer" } } }, "ChassisEditPostParams": { "additionalProperties": false, "type": "object", "properties": { "name": { "description": "Chassis name", "type": "string", "minLength": 1, "maxLength": 49, "pattern": "^([\\w]+)([\\w\\- ]+)$", "example": "Multix4DE5" }, "rack": { "description": "Rack unique identifier", "example": "1", "type": "integer" }, "unit": { "description": "Starting unit where the chassis is located", "maximum": 99, "minimum": 1, "example": "1", "type": "integer" }, "note": { "description": "Comment", "type": "string" } } }, "ChassisGetResponse": { "properties": { "id": { "type": "integer", "description": "Chassis identifier" }, "name": { "description": "Chassis name", "type": "string" }, "rack": { "description": "Rack", "type": "integer" }, "size": { "description": "Chassis size", "type": "number" }, "server_slot_count": { "description": "Number of slots in chassis for blade servers", "type": "integer" }, "note": { "description": "Comment", "type": "string" }, "unit": { "description": "Starting unit where chassis is located", "maximum": 99, "minimum": 1, "example": 1, "type": "integer" }, "used": { "description": "Number of slots in use", "type": "integer" }, "free": { "description": "Number of free slots", "type": "integer" }, "device_server": { "description": "Servers installed into the chassis", "items": { "properties": { "id": { "description": "Server identifier", "type": "integer" }, "name": { "description": "Server name", "type": "string" }, "slot": { "description": "Slot number", "type": "integer" }, "size": { "description": "Server size", "type": "number" } }, "type": "object" }, "type": "array" } }, "type": "object" }, "ChassisListResponse": { "properties": { "list": { "items": { "$ref": "#/components/schemas/ChassisGetResponse" }, "type": "array" } }, "type": "object" }, "ChassisGetSlotsResponse": { "type": "object", "properties": { "list": { "type": "array", "description": "List of chassis slots with devices and sizes", "items": { "type": "object", "properties": { "slot": { "type": "integer", "description": "Slot number" }, "devices": { "type": "array", "nullable": true, "items": { "type": "object", "description": "Device that occupies the slot", "properties": { "id": { "type": "integer", "description": "Server id that occupies the slot" }, "name": { "type": "string", "description": "Server name", "example": "Server 2568" }, "size": { "type": "integer", "description": "Server size", "example": 1 }, "slot": { "type": "integer", "description": "Slot where Server is located" } } } } } } } } }, "GetLicenseResponse": { "type": "object", "properties": { "device_limit_exceeded": { "description": "Device limit has been exceeded", "example": true, "type": "boolean" }, "device_limit": { "description": "Maximum number of devices", "example": 250, "type": "integer" }, "total_devices": { "description": "Current number of devices", "example": 117, "type": "integer" }, "limits": { "type": "object", "properties": { "used": { "type": "object", "properties": { "device": { "type": "integer", "description": "Current number of devices (4 Auth)" } } } } }, "license": { "description": "License information", "type": "object", "properties": { "time_to_end": { "description": "time to license expiration date", "example": 1568739759, "type": "integer" }, "expiration_date": { "description": "license expiration date", "example": 1780725966, "type": "integer" }, "user_id": { "description": "User ID", "example": 42, "type": "integer" }, "metric_id": { "description": "User ID hash(md5) of the license token", "type": "string" } } } } }, "SwitchCreatePostParams": { "additionalProperties": false, "properties": { "device": { "description": "Device", "type": "string" }, "ip": { "description": "Switch IP address", "example": "127.0.0.1", "format": "ipv4", "type": "string" }, "name": { "description": "Switch name", "example": "my key name", "pattern": "^[^ ]", "minLength": 1, "maxLength": 49, "type": "string" }, "note": { "description": "Comment", "maxLength": 1500, "type": "string" }, "rack": { "description": "Rack unique identifier", "example": "1", "type": "integer" }, "unit": { "description": "Starting unit where the switch is located", "maximum": 99, "minimum": 1, "example": "1", "type": "integer" }, "size": { "description": "Switch size in units", "maximum": 99, "minimum": 0, "multipleOf": 0.5, "example": "1", "type": "number" }, "dependent": { "description": "Dependent switches identifiers for autocreate VLANs", "type": "array", "items": { "type": "integer", "description": "The unique identifier of the switch" } }, "snmp_params": { "$ref": "#/components/schemas/DeviceSnmpParams" }, "ssh_params": { "$ref": "#/components/schemas/DeviceSshParams" }, "netconf_params": { "$ref": "#/components/schemas/DeviceNetconfParams" }, "nxapi_params": { "$ref": "#/components/schemas/DeviceNxApiParams" }, "eapi_params": { "$ref": "#/components/schemas/DeviceEApiParams" }, "aggregation_allowed": { "description": "Allows search for aggregation ports", "type": "boolean" } }, "required": [ "name", "ip", "device", "rack", "unit", "size" ], "type": "object" }, "SwitchEditPostParams": { "additionalProperties": false, "properties": { "ip": { "description": "Switch IP address", "example": "127.0.0.1", "format": "ipv4", "type": "string" }, "name": { "description": "Switch name", "example": "my key name", "pattern": "^[^ ]", "minLength": 1, "maxLength": 49, "type": "string" }, "note": { "description": "Comment", "maxLength": 1500, "type": "string" }, "unit": { "description": "Starting unit where switch is located", "maximum": 99, "minimum": 1, "example": "1", "type": "integer" }, "size": { "description": "Switch size in units", "maximum": 99, "minimum": 1, "example": "1", "type": "integer" }, "rack": { "description": "Rack unique identifier", "example": "1", "type": "integer" }, "dependent": { "description": "Dependent switches identifiers for autocreate VLANs", "type": "array", "items": { "type": "integer", "description": "The unique identifier of the switch" } }, "snmp_params": { "$ref": "#/components/schemas/DeviceSnmpParams" }, "ssh_params": { "$ref": "#/components/schemas/DeviceSshParams" }, "netconf_params": { "$ref": "#/components/schemas/DeviceNetconfParams" }, "nxapi_params": { "$ref": "#/components/schemas/DeviceNxApiParams" }, "eapi_params": { "$ref": "#/components/schemas/DeviceEApiParams" }, "aggregation_allowed": { "description": "Allows search for aggregation ports", "type": "boolean" } }, "type": "object" }, "SwitchInfoEditPostParams": { "properties": { "switch_port_info": { "type": "array", "items": { "type": "object", "properties": { "ip": { "description": "Switch IP address", "example": "127.0.0.1", "format": "ipv4", "type": "string" }, "name": { "description": "Switch name", "example": "my key name", "pattern": "^[^ ]", "type": "string" }, "note": { "description": "Comment", "type": "string" }, "unit": { "description": "Starting unit where the switch is located", "maximum": 99, "minimum": 1, "example": "1", "type": "integer" }, "size": { "description": "Switch size in units", "maximum": 99, "minimum": 1, "example": "1", "type": "integer" }, "vlan_id": { "type": "integer", "description": "The VLAN identifier (if is_trunk is true, then it is native VLAN)", "example": 571, "minimum": 1, "maximum": 4094 }, "is_trunk": { "type": "boolean", "description": "If equal true, then port work in trunk mode, else access mode" }, "trunk_members": { "description": "The VLAN identifiers", "type": "array", "items": { "type": "integer" } }, "snmp_params": { "$ref": "#/components/schemas/DeviceSnmpParams" }, "ssh_params": { "$ref": "#/components/schemas/DeviceSshParams" }, "netconf_params": { "$ref": "#/components/schemas/DeviceNetconfParams" }, "nxapi_params": { "$ref": "#/components/schemas/DeviceNxApiParams" }, "eapi_params": { "$ref": "#/components/schemas/DeviceEApiParams" }, "aggregation_allowed": { "description": "Allows search for aggregation ports", "type": "boolean" } } } }, "switch_error": { "type": "object", "description": "The switch error description", "properties": { "code": { "type": "integer" }, "msg": { "type": "string" }, "value": { "type": "string" } } } }, "type": "object" }, "SwitchEditPortsInfoPostParams": { "additionalProperties": false, "type": "object", "properties": { "duplex": { "type": "string", "description": "Port duplex", "enum": [ "unknown", "half", "full", "disagree", "auto" ] }, "speed": { "type": "string", "description": "Port speed", "enum": [ "unknown", "auto", "auto_10_100M", "10M", "100M", "1G", "10G", "16G", "40G" ] }, "admin_status": { "type": "string", "description": "Port status", "enum": [ "up", "down", "testing", "unknown" ] }, "oper_status": { "type": "string", "description": "Port Link", "enum": [ "up", "down", "testing", "unknown" ] }, "description": { "type": "string", "description": "Description" } } }, "SwitchGetResponse": { "type": "object", "properties": { "device": { "enum": [ "cisco_snmp", "snmp_common" ], "type": "string" }, "hostname": { "type": "string" }, "id": { "type": "integer" }, "ip": { "type": "string" }, "status": { "type": "string", "enum": [ "ok", "fail", "in_progress" ] }, "name": { "type": "string" }, "note": { "type": "string" }, "rack": { "$ref": "#/components/schemas/RackSubquery" }, "location": { "$ref": "#/components/schemas/LocationSubquery" }, "location_id": { "type": "integer", "description": "Location identifier" }, "size": { "description": "Device size", "type": "integer" }, "last_update": { "description": "Date of the last device poll", "type": "string" }, "last_success_update": { "description": "Date of the last successful device poll", "type": "string" }, "unit": { "description": "Unit where device is located", "type": "integer" }, "total_port": { "description": "Total number of switch ports", "type": "integer" }, "using_port": { "description": "Number of ports in use", "type": "integer" }, "server_connection": { "description": "List of switch ports connected to server", "type": "array", "items": { "type": "object", "properties": { "connection_id": { "type": "integer", "description": "Connection identifier" }, "server_id": { "type": "integer", "description": "Server identifier" }, "port_id": { "type": "integer", "description": "Port identifier" }, "port_if_index": { "type": "string", "description": "Port If-index" } } } }, "dependent": { "description": "Dependent switches identifiers for autocreate VLANs", "type": "array", "items": { "type": "integer", "description": "The unique identifier of the switch" } }, "snmp_params": { "$ref": "#/components/schemas/DeviceSnmpParams" }, "ssh_params": { "$ref": "#/components/schemas/DeviceSshParams" }, "netconf_params": { "$ref": "#/components/schemas/DeviceNetconfParams" }, "nxapi_params": { "$ref": "#/components/schemas/DeviceNxApiParams" }, "eapi_params": { "$ref": "#/components/schemas/DeviceEApiParams" }, "additional_info": { "description": "Additional switch info", "type": "object" }, "aggregation_allowed": { "description": "Allows search for aggregation ports", "type": "boolean" } } }, "SwitchListResponse": { "properties": { "list": { "items": { "$ref": "#/components/schemas/SwitchGetResponse" }, "type": "array" } }, "type": "object" }, "SwitchPortEditPostParams": { "additionalProperties": false, "type": "object", "properties": { "duplex": { "enum": [ "unknown", "half", "full", "disagree", "auto" ], "type": "string" }, "speed": { "enum": [ "unknown", "auto", "auto_10_100M", "10M", "100M", "1G", "10G", "16G", "40G" ], "type": "string" }, "note": { "type": "string", "description": "Notes with information", "example": "Don't use 10G!" }, "vlan_id": { "type": "integer", "description": "The VLAN identifier (if is_trunk is true, then it is native VLAN)", "example": 571, "minimum": 1, "maximum": 4094 }, "is_trunk": { "type": "boolean", "description": "If equal true, then port work in trunk mode, else access mode" }, "trunk_members": { "description": "The VLAN identifiers", "type": "array", "items": { "type": "integer" } }, "is_uplink": { "type": "boolean", "description": "Does port work in uplink mode. If the port is in uplink mode, it cannot be edited and connected to other devices" }, "is_service": { "type": "boolean", "description": "Does port work in service mode. If the port is service, it cannot be connected to other devices" } } }, "SwitchPortGetResponse": { "properties": { "duplex": { "enum": [ "unknown", "half", "full", "disagree", "auto" ], "type": "string" }, "id": { "type": "integer" }, "if_index": { "type": "string" }, "speed": { "enum": [ "unknown", "auto", "auto_10_100M", "10M", "100M", "1G", "10G", "16G", "40G" ], "type": "string" }, "speed_type": { "enum": [ "unknown", "10M", "100M", "1G", "10G" ], "type": "string" }, "switch": { "type": "integer" }, "admin_status": { "enum": [ "up", "down", "testing", "unknown" ], "type": "string" }, "oper_status": { "enum": [ "up", "down", "testing", "unknown", "dormant", "notpresent", "lowerlayerdown" ], "type": "string" }, "connection_type": { "enum": [ "free", "connected", "other" ], "type": "string" }, "connection_type_info": { "type": "string" }, "description": { "type": "string", "description": "Port description on switch", "example": "GigabitEthernet3/0/10" }, "connection_id": { "type": "string", "description": "Connection identifier" }, "note": { "type": "string", "description": "Notes with information", "example": "Don't use 10G!" }, "server": { "type": "object", "properties": { "id": { "type": "integer" }, "rack": { "type": "integer" }, "domain": { "type": "string" }, "name": { "type": "string" } } }, "vlan_id": { "type": "integer", "description": "The VLAN identifier (if is_trunk is true, then it is native VLAN)", "example": 571, "minimum": 1, "maximum": 4094 }, "is_trunk": { "type": "boolean", "description": "If equal true, then port work in trunk mode, else access mode" }, "trunk_members": { "description": "The VLAN identifiers and names", "type": "array", "items": { "type": "integer" } }, "do_not_collect_traffic": { "description": "Do not collect traffic passing through the switch port", "type": "boolean" }, "is_uplink": { "type": "boolean", "description": "Does port work in uplink mode. If the port is in uplink mode, it cannot be edited and connected to other devices" }, "is_service": { "type": "boolean", "description": "Does port work in service mode. If the port is service, it cannot be connected to other devices" }, "mac_list": { "description": "List of MAC addresses on the switch port", "type": "array", "items": { "type": "string" } }, "is_ipmi_connection": { "type": "boolean", "description": "Is this connection to IPMI device" }, "is_aggregation": { "type": "boolean", "description": "Is aggregation interface" }, "aggregation_port_id": { "type": "integer", "description": "Identifier of parent aggregation port (Reference to switch port)" } }, "type": "object" }, "SwitchPortListResponse": { "properties": { "list": { "items": { "$ref": "#/components/schemas/SwitchPortGetResponse" }, "type": "array" } }, "type": "object" }, "SwitchPortConnectPostParams": { "additionalProperties": false, "required": [ "connection_type" ], "type": "object", "properties": { "connection_type": { "enum": [ "free", "connected", "other" ], "type": "string", "description": "Type of connection" }, "do_not_collect_traffic": { "description": "Do not collect traffic passing through the switch port", "type": "boolean" }, "server_id": { "type": "integer", "description": "Server identifier" }, "connection_type_info": { "type": "string", "description": "Information of connection" }, "is_ipmi_connection": { "type": "boolean", "description": "Mark as an IPMI connection" } } }, "SwitchPortUserEditPostParams": { "additionalProperties": false, "properties": { "vlan_id": { "type": "integer", "description": "The VLAN identifier", "example": 571, "minimum": 1, "maximum": 4094 }, "note": { "type": "string", "description": "The user notes with information", "example": "Don't use 10G!" } }, "type": "object" }, "SwitchPortUserGetResponse": { "properties": { "id": { "description": "The switch port unique identifier", "type": "integer" }, "admin_status": { "enum": [ "up", "down", "testing", "unknown" ], "type": "string" }, "oper_status": { "enum": [ "up", "down", "testing", "unknown", "dormant", "notpresent", "lowerlayerdown" ], "type": "string" }, "note": { "type": "string", "description": "Notes with information", "example": "Don't use 10G!" }, "vlan_id": { "type": "string", "description": "The VLAN name" } } }, "SetupPostParams": { "properties": { "ip": { "description": "SSH IP address", "example": "127.0.0.1", "format": "ipv4", "type": "string" }, "ssh_port": { "description": "SSH access port", "example": 22, "maximum": 65535, "minimum": 1, "type": "integer" }, "user_email": { "description": "User email", "example": "admin@example.com", "format": "email", "type": "string" }, "user_id": { "description": "User identifier", "example": 2, "type": "integer" }, "username": { "description": "SSH access username", "example": "root", "minLength": 1, "type": "string" } }, "required": [ "ip", "ssh_port", "username", "user_id", "user_email" ], "type": "object" }, "BoxSetupPostParams": { "properties": { "is_box": { "description": "Checkbox that indicates setting up of the box-instance", "example": true, "type": "boolean" }, "user_id": { "description": "User identifier", "example": 2, "type": "integer" }, "user_email": { "description": "User email", "example": "admin@example.com", "format": "email", "type": "string" } }, "required": [ "is_box", "user_id", "user_email" ], "type": "object" }, "InfoGetResponse": { "properties": { "location": { "description": "Information about the main location", "properties": { "id": { "description": " Location ID (admin only)", "type": "integer" }, "ssh_address": { "description": "Location SSH-address (admin only)", "type": "string" }, "ssh_port": { "description": "Location SSH-port (admin only)", "type": "integer" }, "ssh_user": { "description": "Location SSH-user (admin only)", "type": "string" }, "status": { "description": "Location status", "enum": [ "created", "check_failed", "need_setup", "setup", "ok", "setup_failed" ], "type": "string" } }, "type": "object" } }, "type": "object" }, "UserSettingsParams": { "type": "object", "additionalProperties": true, "properties": {} }, "UserCreatePostParams": { "additionalProperties": false, "properties": { "email": { "description": "User email", "example": "admin@example.com", "type": "string", "format": "email" }, "full_name": { "type": "string" }, "password": { "type": "string" }, "phone_number": { "type": "string" }, "role": { "type": "string", "enum": [ "@admin", "@user" ] } }, "required": [ "email", "password", "role" ], "type": "object" }, "UserGetResponse": { "properties": { "id": { "type": "integer" }, "email": { "type": "string" }, "server_count": { "type": "integer" }, "roles": { "description": "User roles array", "example": "[@user]", "type": "array", "items": { "type": "string", "example": "@user" } }, "vlans_per_user": { "description": "The count of vlans per user", "example": 5, "type": "integer" } }, "type": "object" }, "UserListResponse": { "properties": { "list": { "items": { "$ref": "#/components/schemas/UserGetResponse" }, "type": "array" } }, "type": "object" }, "UserEditPostParams": { "additionalProperties": false, "properties": { "vlans_per_user": { "description": "The count of vlans per user", "example": 5, "type": "integer", "minimum": 0 } }, "type": "object" }, "SettingGetResponse": { "type": "object", "description": "The result is a key-value pair where the key is the setting name and the value is the setting value", "properties": {} }, "SettingParams": { "type": "object", "additionalProperties": true, "properties": { "value": { "type": "string", "description": "New value for the setting" } } }, "PlatformCreatePostParams": { "additionalProperties": false, "required": [ "name", "type", "server_size", "cpu_socket", "cpu_socket_count", "ram_slot_count", "max_ram", "hdd_slot_count", "pci_slot_count" ], "type": "object", "properties": { "name": { "description": "Platform name", "type": "string", "minLength": 1, "maxLength": 49, "pattern": "^([\\w]+)([\\w\\- ]+)$", "example": "Platform 1" }, "type": { "description": "Server type", "type": "string", "enum": [ "server", "blade" ] }, "server_size": { "description": "Server size", "type": "number", "multipleOf": 0.5, "minimum": 0, "maximum": 99 }, "cpu_socket": { "description": "CPU socket ID", "type": "integer" }, "cpu_socket_count": { "description": "Number of sockets for cpu", "enum": [ 1, 2, 4, 8 ], "type": "integer" }, "ram_slot_count": { "description": "Number of slots for RAM", "type": "integer", "minimum": 1, "maximum": 64 }, "max_ram": { "description": "Maximum RAM size", "type": "integer", "minimum": 1, "maximum": 2147483647 }, "hdd_slot_count": { "description": "Number of slots for hdd_slot_count", "type": "integer", "minimum": 1, "maximum": 90 }, "pci_slot_count": { "description": "Number of slots for PCI-devices", "type": "integer", "minimum": 1, "maximum": 30 } } }, "PlatformEditPostParams": { "additionalProperties": false, "type": "object", "properties": { "name": { "description": "Platform name", "type": "string", "minLength": 1, "maxLength": 49, "pattern": "^([\\w]+)([\\w\\- ]+)$" }, "cpu_socket": { "description": "CPU socket ID", "type": "integer" }, "cpu_socket_count": { "description": "Number of sockets for cpu", "enum": [ 1, 2, 4, 8 ], "type": "integer" }, "ram_slot_count": { "description": "Number of slots for RAM", "type": "integer", "minimum": 1, "maximum": 64 }, "max_ram": { "description": "Maximum RAM size", "type": "integer", "minimum": 1, "maximum": 2147483647 }, "hdd_slot_count": { "description": "Number of slots for hdd_slot_count", "type": "integer", "minimum": 1, "maximum": 90 }, "pci_slot_count": { "description": "Number of slots for PCI-devices", "type": "integer", "minimum": 1, "maximum": 30 } } }, "PlatformGetResponse": { "properties": { "id": { "type": "integer", "description": "Platform identifier" }, "name": { "description": "Platform name", "type": "string" }, "type": { "description": "Server type", "type": "string" }, "server_size": { "description": "Server size", "type": "number" }, "cpu_socket": { "description": "CPU socket ID", "type": "integer" }, "cpu_socket_count": { "description": "Number of sockets for cpu", "type": "integer" }, "ram_slot_count": { "description": "Number of slots for RAM", "type": "integer" }, "max_ram": { "description": "Maximum RAM size", "type": "integer" }, "hdd_slot_count": { "description": "Number of slots for hdd_slot_count", "type": "integer" }, "pci_slot_count": { "description": "Number of slots for PCI-devices", "type": "integer" }, "server_count": { "description": "Number of servers with this platform by the locations", "type": "array", "items": { "type": "object", "properties": { "location_id": { "description": "The location identifier", "type": "integer" }, "location_name": { "description": "The location name", "type": "string" }, "server_count": { "description": "The number of servers that used this platform on the location", "type": "integer" } } } }, "server_count_total": { "description": "The total number of server with such platform", "type": "integer" } }, "type": "object" }, "PlatformListResponse": { "properties": { "list": { "items": { "$ref": "#/components/schemas/PlatformGetResponse" }, "type": "array" } }, "type": "object" }, "IpCreatePostParams": { "additionalProperties": false, "properties": { "domain": { "description": "Hostname", "format": "hostname", "minLength": 1, "type": "string" }, "family": { "description": "Address type", "enum": [ "ipv4", "ipv6" ], "type": "string" }, "ip_name": { "format": "ipnet", "description": "IP address or subnet that will be allocated", "type": "string" }, "ip_net": { "description": "Network ID in IPmanager 6", "type": "integer" }, "ip_pool": { "description": "IP pool in IPmanager 6", "type": "integer" }, "prefix": { "description": "The allocated subnet prefix", "type": "integer", "example": 32, "minimum": 25, "maximum": 128 }, "set_as_main_ip": { "description": "Set IP as the primary IP address of the server", "type": "boolean" }, "set_as_main_ipv4": { "description": "Set IP as the primary IP address of the server", "type": "boolean", "deprecated": true }, "userspace": { "description": "Userspace ID in IPmanager 6", "type": "integer" } }, "required": [ "domain", "family" ], "type": "object" }, "IpEditPostParams": { "additionalProperties": false, "properties": { "domain": { "description": "Hostname", "format": "hostname", "minLength": 1, "type": "string" } }, "type": "object" }, "IpGetResponse": { "properties": { "domain": { "type": "string" }, "family": { "enum": [ "ipv4", "ipv6" ], "type": "string" }, "gateway": { "type": "string" }, "id": { "type": "integer" }, "name": { "type": "string" }, "network": { "type": "string" }, "server": { "type": "string" }, "status": { "enum": [ "allocating", "ok", "fail", "allocation_fail", "in_progress", "deleting" ], "type": "string" }, "status_info": { "type": "object" } }, "type": "object" }, "IpListResponse": { "properties": { "list": { "items": { "$ref": "#/components/schemas/IpGetResponse" }, "type": "array" } }, "type": "object" }, "JournalDetailedEntityParams": { "type": "object", "properties": { "id": { "type": "integer", "description": "Unique identifier of the entity" }, "name": { "type": "string", "description": "Name of the entity" }, "status": { "type": "string", "description": "Status of the entity" }, "size": { "type": "double", "description": "Size of entity" }, "type": { "type": "string", "description": "Type of entity" } } }, "JournalServerDataParams": { "type": "object", "properties": { "name": { "type": "string", "description": "Name of the server" }, "mac": { "type": "string", "description": "Mac of the server" }, "os_template": { "type": "object", "description": "The OS template information the operation was started with" }, "platform": { "$ref": "#/components/schemas/JournalDetailedEntityParams", "description": "Entity of platform" }, "chassis": { "$ref": "#/components/schemas/JournalDetailedEntityParams", "description": "Entity of chassis" }, "rack": { "$ref": "#/components/schemas/JournalDetailedEntityParams", "description": "Entity of rack" }, "slot": { "type": "integer", "description": "Slot ID of the server" }, "unit": { "type": "integer", "description": "Unit ID of the server" }, "main_ipv4": { "$ref": "#/components/schemas/JournalDetailedEntityParams", "description": "Entity of main IPv4" }, "main_ipv6": { "$ref": "#/components/schemas/JournalDetailedEntityParams", "description": "Entity of main IPv6" }, "owner": { "$ref": "#/components/schemas/JournalDetailedEntityParams", "description": "Entity of owner" }, "state": { "type": "string", "description": "Server status: * suspending - Server operation has been suspended (all switch ports connected to the server were powered off) * suspended - Suspended(all switch ports connected to the server were powered off) * suspend_error - Error suspending sever (failed to power off all switch ports connected to the server) * resuming - Enable server operation (all switch ports connected to the server were powered on) * ok - Ready to work * resume_error - Error powering on the server(failed to power on all switch ports connected to the server)\n", "enum": [ "suspending", "suspended", "suspend_error", "resuming", "ok", "resume_error" ] } } }, "JournalServerPowerParams": { "type": "object", "properties": { "pdu_entity": { "$ref": "#/components/schemas/JournalDetailedEntityParams", "description": "Entity of PDU" }, "pdu_port_entity": { "$ref": "#/components/schemas/JournalDetailedEntityParams", "description": "Entity of PDU port" }, "ipmi": { "$ref": "#/components/schemas/JournalDetailedEntityParams", "description": "Entity of IPMI" } } }, "JournalServerOperationParams": { "type": "object", "properties": { "operation_id": { "type": "integer", "description": "Unique identifier of operation" }, "owner": { "$ref": "#/components/schemas/JournalDetailedEntityParams", "description": "Entity of owner of the operation" }, "operation_status": { "type": "string" }, "os_template_info": { "type": "object", "description": "The OS template information the operation was started with" }, "type": { "type": "string", "enum": [ "os_install", "diag", "rescue" ], "description": "Operation type" }, "template_type": { "type": "string", "enum": [ "iso", "os_template" ], "description": "Template type" } } }, "JournalServerIpParams": { "type": "object", "properties": { "ip_id": { "description": "Unique IP address identifier", "type": "integer" }, "ip_net": { "description": "Unique IP net identifier", "type": "integer" }, "ip_pool": { "description": "Unique IP pool identifier", "type": "integer" }, "name": { "description": "Name of IP address", "type": "string" }, "domain": { "description": "Domain of IP address", "type": "string" }, "network": { "description": "Network of IP address", "type": "string" }, "gateway": { "description": "Gateway of IP address", "type": "string" }, "family": { "description": "Family of IP address", "enum": [ "ipv4", "ipv6" ], "type": "string" } } }, "JournalServerConnectionParams": { "type": "object", "properties": { "pdu": { "description": "Entity of PDU", "$ref": "#/components/schemas/JournalDetailedEntityParams" }, "pdu_port": { "description": "Entity of PDU port", "$ref": "#/components/schemas/JournalDetailedEntityParams" }, "switch": { "description": "Entity of switch", "$ref": "#/components/schemas/JournalDetailedEntityParams" }, "switch_port": { "description": "Entuty of switch port", "$ref": "#/components/schemas/JournalDetailedEntityParams" }, "ipmi": { "description": "Entuty of IPMI", "$ref": "#/components/schemas/JournalDetailedEntityParams" } } }, "JournalGetResponse": { "type": "object", "properties": { "id": { "description": "Journal record unique identifier", "type": "integer" }, "date_time": { "description": "Journal record date time", "type": "string" }, "instance_id": { "description": "Instance unique indentifier", "type": "integer" }, "type": { "description": "Journal operation type", "enum": [ "create", "edit", "delete", "server_power_on", "server_power_off", "server_power_reset", "server_power_ipmi", "server_power_pdu", "server_operation_start", "server_operation_finish", "server_operation_cancel", "server_state", "server_connection_create", "server_connection_edit", "server_connection_delete", "server_ip_create", "server_ip_edit", "server_ip_delete" ], "type": "string" }, "ip": { "description": "User IP address", "type": "string" }, "account": { "type": "object", "properties": { "id": { "description": "User unique identifier", "type": "integer" }, "trustee": { "description": "Session identity of trusted user", "type": "integer" }, "roles": { "description": "User roles", "type": "array", "items": { "type": "string", "example": "@user" } }, "email": { "description": "User email", "type": "string" } } }, "entity": { "type": "object", "properties": { "id": { "description": "Entity unique identifier", "type": "integer" }, "name": { "description": "Entity name", "type": "string" }, "type": { "description": "Entity type", "type": "string", "enum": [ "server" ] }, "owner": { "description": "Entity owner", "type": "interger" } } }, "data": { "type": "object", "description": "Journal data fields", "properties": { "old": { "oneOf": [ { "$ref": "#/components/schemas/JournalServerDataParams" }, { "$ref": "#/components/schemas/JournalServerPowerParams" }, { "$ref": "#/components/schemas/JournalServerOperationParams" }, { "$ref": "#/components/schemas/JournalServerIpParams" }, { "$ref": "#/components/schemas/JournalServerConnectionParams" } ] }, "new": { "oneOf": [ { "$ref": "#/components/schemas/JournalServerDataParams" }, { "$ref": "#/components/schemas/JournalServerPowerParams" }, { "$ref": "#/components/schemas/JournalServerOperationParams" }, { "$ref": "#/components/schemas/JournalServerIpParams" }, { "$ref": "#/components/schemas/JournalServerConnectionParams" } ] } } } } }, "JournalListResponse": { "properties": { "list": { "items": { "$ref": "#/components/schemas/JournalGetResponse" }, "type": "array" } }, "type": "object" }, "LocationVlansListResponse": { "properties": { "list": { "items": { "$ref": "#/components/schemas/VlanGetResponse" }, "type": "array" } }, "type": "object" }, "VlanCreatePostParams": { "additionalProperties": false, "properties": { "id": { "description": "The VLAN unique identifier", "type": "integer", "minimum": 1, "maximum": 4094 }, "name": { "description": "The VLAN name", "type": "string", "minLength": 1, "maxLength": 49, "pattern": "^[\\w\\-]+$", "example": "vlan-1" }, "note": { "description": "The VLAN comment", "maxLength": 1500, "type": "string" }, "owner": { "description": "The VLAN owner identifier", "type": "integer" } }, "required": [ "id", "name" ], "type": "object" }, "VlanEditPostParams": { "additionalProperties": false, "properties": { "name": { "description": "The VLAN name", "type": "string", "minLength": 1, "maxLength": 49, "pattern": "^[\\w\\-]+$", "example": "vlan 1" }, "note": { "description": "The VLAN comment", "maxLength": 1500, "type": "string" }, "owner": { "description": "The VLAN owner identifier", "oneOf": [ { "type": "integer" }, { "type": "null" } ] } }, "type": "object" }, "VlanGetResponse": { "type": "object", "properties": { "id": { "description": "The VLAN unique identifier", "type": "integer" }, "location_id": { "description": "The VLAN unique identifier", "type": "integer" }, "name": { "description": "The VLAN name", "type": "string" }, "note": { "description": "The VLAN comment", "type": "string" }, "members_count": { "description": "The VLAN members count", "type": "integer" }, "owner": { "description": "The VLAN owner identifier", "type": "integer" } } }, "VlanMembersGetResponse": { "type": "object", "properties": { "id": { "description": "The VLAN member port id", "type": "integer" }, "connection_type": { "enum": [ "free", "connected", "other" ], "type": "string", "description": "The connection type" }, "connection_type_info": { "type": "string", "description": "The connection type information" }, "connection_id": { "type": "string", "description": "The connection identifier" }, "admin_status": { "enum": [ "up", "down", "testing", "unknown" ], "type": "string", "description": "The port administrative status" }, "oper_status": { "enum": [ "up", "down", "testing", "unknown", "dormant", "notpresent", "lowerlayerdown" ], "type": "string", "description": "The port operation status" }, "speed": { "enum": [ "unknown", "auto", "auto_10_100M", "10M", "100M", "1G", "10G", "16G", "40G" ], "type": "string", "description": "The port speed" }, "duplex": { "enum": [ "unknown", "half", "full", "disagree", "auto" ], "type": "string", "description": "The port duplex" }, "note": { "type": "string", "description": "The port notes with additional information" }, "description": { "type": "string", "description": "The port description on switch" }, "is_trunk": { "type": "boolean", "description": "Is port work in trunk mode" }, "trunk_members": { "description": "The VLAN identifiers and names", "type": "array", "items": { "type": "integer" } }, "is_uplink": { "type": "boolean", "description": "Does port work in uplink mode. If the port is in uplink mode, it cannot be edited and connected to other devices." }, "is_service": { "type": "boolean", "description": "Does port work in service mode. If the port is service, it cannot be connected to other devices" }, "do_not_collect_traffic": { "description": "Do not collect traffic passing through the switch port", "type": "boolean" }, "vlan": { "type": "object", "properties": { "vlan_id": { "type": "integer", "description": "The VLAN unique identifier" }, "vlan_name": { "type": "string", "description": "The unique name of a VLAN" } }, "description": "The port VLAN information (If the port is trunk - it is native VLAN)" }, "server": { "type": "object", "properties": { "id": { "type": "integer", "description": "The server unique identifier" }, "name": { "type": "string", "description": "The server name" } }, "description": "The server information" }, "switch": { "type": "object", "properties": { "id": { "type": "integer", "description": "The switch unique identifier" }, "name": { "type": "string", "description": "The switch name" } }, "description": "The switch information" } } }, "CpuSocketCreatePostParams": { "additionalProperties": false, "properties": { "name": { "description": "CPU socket name", "example": "Socket SP3", "minLength": 1, "maxLength": 49, "pattern": "^([\\w]+)([\\w\\- ]+)$", "type": "string" }, "note": { "description": "Comment", "type": "string" } }, "required": [ "name" ], "type": "object" }, "CpuSocketGetResponse": { "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "note": { "type": "string" } }, "type": "object" }, "CpuSocketListResponse": { "properties": { "list": { "items": { "$ref": "#/components/schemas/CpuSocketGetResponse" }, "type": "array" } }, "type": "object" }, "RecipeCreatePostParams": { "additionalProperties": false, "required": [ "name", "access", "content", "tags" ], "properties": { "name": { "type": "string", "description": "The recipe unique name" }, "access": { "type": "string", "enum": [ "owner", "all" ], "description": "The access rights to recipe" }, "content": { "type": "string", "description": "The recipe script" }, "description": { "type": "string", "description": "The recipe description" }, "tags": { "type": "array", "items": { "type": "string" }, "description": "Tags determine that recipe will be available on the OS" } } }, "RecipeEditPostParams": { "additionalProperties": false, "properties": { "name": { "type": "string", "description": "The recipe unique name" }, "access": { "type": "string", "enum": [ "owner", "all" ], "description": "The access rights to recipe" }, "content": { "type": "string", "description": "The recipe script" }, "description": { "type": "string", "description": "The recipe description" }, "tags": { "type": "array", "items": { "type": "string" }, "description": "Tags determine that recipe will be available on the OS" } } }, "RecipeListResponse": { "properties": { "list": { "items": { "$ref": "#/components/schemas/RecipeGetResponse" }, "type": "array" } }, "type": "object" }, "RecipeGetResponse": { "type": "object", "properties": { "id": { "type": "integer", "description": "The recipe unique identifier" }, "name": { "type": "string", "description": "The recipe unique name" }, "owner": { "type": "object", "description": "The recipe owner", "properties": { "id": { "type": "integer", "description": "The user unique identifier" }, "emain": { "type": "string", "description": "The user unique email" } } }, "last_update": { "type": "string", "description": "When the recipe was updated" }, "access": { "type": "string", "enum": [ "owner", "all" ], "description": "The access rights to recipe" }, "content": { "type": "string", "description": "The recipe script" }, "description": { "type": "string", "description": "The recipe description" }, "tags": { "type": "array", "items": { "type": "string" }, "description": "Tags determine that recipe will be available on the OS" } } }, "IntelAmtCreatePostParams": { "additionalProperties": false, "properties": { "hostname": { "description": "IntelAMT IPv4 address", "type": "string", "format": "ipv4" }, "password": { "description": "Password", "type": "string" }, "protocol": { "description": "IntelAMT connection protocol", "enum": [ "http", "https" ], "type": "string" }, "username": { "description": "Username", "maxLength": 15, "type": "string" } }, "required": [ "hostname", "username", "password", "protocol" ], "type": "object" }, "IntelAmtEditPostParams": { "additionalProperties": false, "properties": { "hostname": { "description": "IntelAMT IPv4 address", "type": "string" }, "password": { "description": "Password", "type": "string" }, "protocol": { "description": "IntelAMT connection protocol", "enum": [ "http", "https" ], "type": "string" }, "username": { "description": "Username", "maxLength": 15, "type": "string" } }, "type": "object" }, "IntelAmtGetResponse": { "properties": { "hostname": { "type": "string" }, "port": { "type": "integer" }, "id": { "type": "integer" }, "password": { "type": "string" }, "server": { "type": "string" }, "server_id": { "type": "integer" }, "status": { "enum": [ "on", "off", "unknown", "in_progress" ], "type": "string" }, "last_update": { "description": "Date of the last device poll", "type": "string" }, "last_success_update": { "description": "Date of the last successful device poll", "type": "string" }, "status_info": { "type": "object" }, "protocol": { "enum": [ "http", "https" ], "type": "string" }, "username": { "type": "string" }, "location_info": { "description": "Location info(Internal only)", "properties": { "id": { "type": "integer", "description": "The location unique identifier" }, "ssh_address": { "description": "SSH access IP address", "type": "string" }, "ssh_port": { "description": "SSH access port", "type": "integer" }, "ssh_user": { "description": "SSH access username", "type": "string" } }, "type": "object" } }, "type": "object" }, "IntelAmtListResponse": { "properties": { "list": { "items": { "$ref": "#/components/schemas/IntelAmtGetResponse" }, "type": "array" } }, "type": "object" }, "IntelAmtInfoEditPostParams": { "properties": { "intel_amt_info": { "type": "object", "description": "New Intel AMT data", "properties": { "status": { "enum": [ "on", "off", "unknown", "in_progress" ], "type": "string" } } }, "intel_amt_error": { "type": "object", "description": "The Intel AMT error description", "properties": { "code": { "type": "integer" }, "msg": { "type": "string" }, "value": { "type": "string" } } } }, "type": "object" }, "ServerOwnerPostParams": { "additionalProperties": false, "properties": { "owner": { "description": "Server owner user ID", "example": 42, "type": "integer" } }, "type": "object" }, "IpmiCreatePostParams": { "additionalProperties": false, "properties": { "address": { "description": "IPMI address", "type": "string", "format": "ipv4" }, "password": { "description": "Password", "type": "string" }, "type": { "description": "IPMI type", "enum": [ "IPMI v1.5/v2", "IPMI v2(lanplus)" ], "type": "string" }, "user": { "description": "Username", "maxLength": 15, "type": "string" }, "web_url": { "description": "IPMI web-interface URL", "format": "uri", "type": "string" } }, "required": [ "address", "user", "password", "type" ], "type": "object" }, "IpmiEditPostParams": { "additionalProperties": false, "properties": { "address": { "description": "IPMI address", "type": "string" }, "password": { "description": "Password", "type": "string" }, "type": { "description": "IPMI type", "enum": [ "IPMI v1.5/v2", "IPMI v2(lanplus)" ], "type": "string" }, "user": { "description": "Username", "maxLength": 15, "type": "string" }, "web_url": { "description": "IPMI web-interface URL", "format": "uri", "type": "string" } }, "type": "object" }, "IpmiGetResponse": { "properties": { "address": { "type": "string" }, "id": { "type": "integer" }, "password": { "type": "string" }, "server": { "type": "string" }, "server_id": { "type": "integer" }, "status": { "enum": [ "on", "off", "unknown", "in_progress" ], "type": "string" }, "last_update": { "description": "Date of the last device poll", "type": "string" }, "last_success_update": { "description": "Date of the last successful device poll", "type": "string" }, "status_info": { "type": "object" }, "type": { "enum": [ "IPMI v1.5/v2", "IPMI v2(lanplus)" ], "type": "string" }, "user": { "type": "string" }, "web_url": { "description": "IPMI web-interface URL", "type": "string" }, "mc_info": { "description": "The IPMI manufacture information", "type": "string" } }, "type": "object" }, "IpmiListResponse": { "properties": { "list": { "items": { "$ref": "#/components/schemas/IpmiGetResponse" }, "type": "array" } }, "type": "object" }, "IpmiBootOrderParams": { "additionalProperties": false, "type": "object", "properties": { "bootdev": { "description": "The boot device the server will be booted from", "type": "string", "enum": [ "pxe", "disk", "cdrom", "floppy" ] } } }, "EmptySchema": { "additionalProperties": false, "properties": {}, "type": "object" }, "ErrorSchema": { "properties": { "error": { "properties": { "code": { "type": "integer" }, "msg": { "type": "string" }, "value": { "type": "string" } }, "type": "object" } }, "type": "object" }, "Id": { "properties": { "id": { "type": "integer" } }, "type": "object" }, "SuccessSchema": { "$ref": "#/components/schemas/Id" }, "SuccessTaskArraySchema": { "properties": { "task": { "items": { "type": "integer" }, "type": "array" } }, "type": "object" }, "SuccessTaskOnlySchema": { "properties": { "task": { "type": "integer" } }, "type": "object" }, "SuccessTaskSchema": { "properties": { "id": { "type": "integer" }, "task": { "type": "integer" } }, "type": "object" }, "SuccessTasksIdSchema": { "properties": { "id": { "type": "integer" }, "task": { "type": "array", "items": { "type": "integer" } } }, "type": "object" }, "StatusSchema": { "properties": { "status": { "type": "string" }, "status_info": { "type": "object" } }, "type": "object" }, "LocationSubquery": { "properties": { "geolocation": { "description": "Location address", "example": "1st Street, 25", "type": "string" }, "id": { "type": "integer" }, "name": { "type": "string" }, "userspace": { "description": "Userspace ID in IPmgr6 for pools and networks of this location", "type": "integer" } }, "type": "object" }, "RackSubquery": { "properties": { "id": { "description": "Rack identifier", "type": "integer" }, "name": { "description": "Rack name", "type": "string" }, "size": { "description": "Rack size", "type": "integer" } }, "type": "object" }, "ChassisSubquery": { "properties": { "id": { "description": "Chassis identifier", "type": "integer" }, "name": { "description": "Chassis name", "type": "string" }, "size": { "description": "Chassis size", "type": "integer" }, "server_slot_count": { "description": "Number of slots in chassis for blade servers", "type": "integer" } }, "type": "object" }, "eAdminStatus": { "type": "string", "description": "Status of the switch port managed by administrator * `up` - port enabled * `down` - port disabled * `testing` - port status is test * `unknown` - unknown port status\n", "enum": [ "up", "down", "testing", "unknown" ] }, "eOperStatus": { "type": "string", "description": "Link status of switch port * `up` - Link ON * `down` - Link OFF * `testing` - port status is test * `unknown` - unknown link status\n", "enum": [ "up", "down", "testing", "unknown" ] }, "SupportedDevicesListResponse": { "type": "object", "properties": { "list": { "type": "array", "items": { "type": "object", "properties": { "name": { "description": "Device type", "type": "string", "example": "cisco_snmp" }, "protocol": { "description": "Protocols for device management", "type": "array", "items": { "type": "string" } }, "features": { "description": "Features is provided by the device", "type": "array", "items": { "type": "string", "enum": [ "port_aggregation" ] } } } } } } }, "DeviceSnmpParams": { "description": "SNMP connection parameters", "type": "object", "properties": { "hostname": { "description": "Equipment address", "type": "string", "format": "ipv4", "example": "127.0.0.1" }, "security_username": { "description": "Username for SNMP access", "type": "string", "minLength": 1, "example": "root", "pattern": "^[^ ]" }, "version": { "description": "SNMP version", "type": "string", "enum": [ "snmp_v1", "snmp_v2c", "snmp_v3" ] }, "community": { "description": "Community", "type": "string" }, "security_level": { "description": "Authentication level", "type": "string", "enum": [ "no_auth_or_privacy", "auth_without_privacy", "auth_with_privacy" ] }, "auth_protocol": { "description": "Authentication protocol", "type": "string", "enum": [ "MD5", "SHA" ] }, "auth_password": { "description": "Authentication protocol pass phrase", "type": "string" }, "privacy_protocol": { "description": "Privacy protocol", "type": "string", "enum": [ "DES", "AES" ] }, "privacy_password": { "description": "Privacy protocol pass phrase", "type": "string" } } }, "DeviceSshParams": { "description": "SSH connection parameters", "type": "object", "properties": { "password": { "description": "Password", "type": "string" }, "port": { "description": "SSH access ports", "example": 22, "maximum": 65535, "minimum": 1, "type": "integer" }, "user": { "description": "SSH access username", "example": "root", "minLength": 1, "pattern": "^[^ ]", "type": "string" } } }, "DeviceNetconfParams": { "description": "NETCONF connection parameters", "type": "object", "properties": { "hostname": { "description": "Equipment address", "type": "string", "format": "ipv4", "example": "127.0.0.1" }, "username": { "description": "Username", "type": "string" }, "password": { "description": "Password", "type": "string" }, "port": { "description": "NETCONF access ports", "example": 830, "maximum": 65535, "minimum": 1, "type": "integer" }, "device_params": { "description": "NETCONF device parameters", "type": "object", "properties": { "name": { "description": "OS name", "type": "string", "enum": [ "junos" ], "default": "junos" } } } } }, "DeviceEApiParams": { "description": "Arista Command eAPI connection parameters", "type": "object", "properties": { "username": { "description": "Username", "type": "string" }, "password": { "description": "Password", "type": "string" } } }, "DeviceNxApiParams": { "description": "NXAPI connection parameters", "type": "object", "properties": { "username": { "description": "Username", "type": "string", "example": "root" }, "password": { "description": "Password", "type": "string", "example": "pirozhok" }, "port": { "description": "Port to connect via API", "type": "integer", "example": 8080 }, "protocol": { "description": "Data transfer protocol", "enum": [ "http", "https" ], "default": "http", "example": "http" } } }, "ServerToSwitchPostParams": { "additionalProperties": false, "properties": { "server_id": { "description": "Server ID", "example": 13, "type": "integer" }, "switch_port_id": { "description": "Switch port ID", "example": 2, "type": "integer" }, "do_not_collect_traffic": { "description": "Do not collect traffic passing through the switch port", "type": "boolean" } }, "required": [ "server_id", "switch_port_id" ], "type": "object" }, "SwitchConnectionGetResponse": { "type": "object", "properties": { "server": { "type": "integer", "description": "Server ID", "example": 25 }, "id": { "type": "integer", "description": "Connection ID", "example": 42 }, "switch": { "type": "integer", "description": "Switch ID", "example": 33 }, "switch_port": { "type": "integer", "description": "Switch port ID", "example": 15 }, "if_index": { "type": "string", "description": "Interface index", "example": 10105 }, "speed": { "type": "string", "description": "Port speed", "enum": [ "unknown", "auto", "auto_10_100M", "10M", "100M", "1G", "10G", "16G", "40G" ] }, "duplex": { "type": "string", "description": "Duplex", "enum": [ "unknown", "half", "full", "disagree", "auto" ] }, "admin_status": { "type": "string", "description": "Admin status", "enum": [ "up", "down", "testing", "unknown" ] }, "oper_status": { "type": "string", "description": "Operating status", "enum": [ "up", "down", "testing", "unknown", "dormant", "notpresent", "lowerlayerdown" ] }, "description": { "type": "string", "description": "Port description", "example": "GigabitEthernet1/0/5" }, "do_not_collect_traffic": { "description": "Do not collect traffic passing through the switch port", "type": "boolean" }, "is_ipmi_connection": { "type": "boolean", "description": "Mark as an IPMI connection" } } }, "SwitchConnectionListResponse": { "type": "object", "properties": { "list": { "type": "array", "items": { "$ref": "#/components/schemas/SwitchConnectionGetResponse" } } } }, "IppoolGetResponse": { "properties": { "id": { "type": "integer" }, "is_public": { "description": "Userspace where the pool is located, is public", "type": "boolean" }, "location": { "properties": { "id": { "type": "integer" }, "name": { "type": "string" } }, "type": "object" }, "name": { "type": "string" }, "note": { "type": "string" }, "total_ip": { "description": "Number of all addresses in the pool that can be allocated", "type": "string" }, "userspace": { "type": "integer" }, "using_ip": { "description": "Number of allocated IP addresses in the pool", "type": "string" }, "is_location_public_pool": { "description": "IP pool for server dedicating", "type": "boolean" }, "is_location_free_pool": { "description": "IP Pool for server free", "type": "boolean" }, "rack": { "description": "Information about racks", "items": { "properties": { "id": { "description": "Rack unique identifier", "type": "integer" }, "name": { "description": "Rack name", "type": "string" } }, "type": "object" }, "type": "array" } }, "type": "object" }, "IppoolListResponse": { "properties": { "list": { "items": { "$ref": "#/components/schemas/IppoolGetResponse" }, "type": "array" } }, "type": "object" }, "IpnetGetResponse": { "properties": { "family": { "description": "Values 2 and 10 are used for indication IPv4 and IPv6 correspondingly", "enum": [ 2, 10 ], "type": "integer" }, "gateway": { "type": "string" }, "id": { "type": "integer" }, "is_public": { "description": "Userspace where the pool is located, is public", "type": "boolean" }, "location": { "properties": { "id": { "type": "integer" }, "name": { "type": "string" } }, "type": "object" }, "mask": { "type": "integer" }, "name": { "type": "string" }, "note": { "type": "string" }, "size": { "type": "string" }, "total_ip": { "description": "Number of all network IP addresses that can be allocated", "type": "string" }, "userspace": { "type": "integer" }, "using_ip": { "description": "Number of allocated addresses", "type": "string" }, "vlan": { "type": "string" } }, "type": "object" }, "IpnetListResponse": { "properties": { "list": { "items": { "$ref": "#/components/schemas/IpnetGetResponse" }, "type": "array" } }, "type": "object" }, "PduCreatePostParams": { "additionalProperties": false, "required": [ "name", "ip", "device", "rack" ], "type": "object", "properties": { "device": { "description": "Device handler", "type": "string" }, "ip": { "description": "PDU IP address", "example": "127.0.0.1", "format": "ipv4", "type": "string" }, "name": { "description": "PDU name", "example": "my key name", "pattern": "^[^ ]", "type": "string" }, "note": { "description": "Comment", "type": "string" }, "rack": { "description": "Rack unique identifier", "example": "1", "type": "integer" }, "unit": { "description": "Starting unit where device is located", "maximum": 99, "minimum": 1, "example": "1", "type": "integer" }, "size": { "description": "PDU size in units", "maximum": 99, "minimum": 1, "multipleOf": 0.5, "example": 1, "type": "number" }, "snmp_params": { "$ref": "#/components/schemas/DeviceSnmpParams" } } }, "PduEditPostParams": { "additionalProperties": false, "type": "object", "properties": { "ip": { "description": "PDU IP address", "example": "127.0.0.1", "format": "ipv4", "type": "string" }, "name": { "description": "PDU name", "example": "my key name", "pattern": "^[^ ]", "type": "string" }, "note": { "description": "Comment", "type": "string" }, "unit": { "description": "Starting unit where device is located. Null, if it is a 0-unit device", "maximum": 99, "minimum": 1, "example": "1", "oneOf": [ { "type": "integer" }, { "type": "null" } ] }, "size": { "description": "PDU size in units", "maximum": 99, "minimum": 0, "example": "1", "type": "integer" }, "rack": { "description": "Rack unique identifier", "example": "1", "type": "integer" }, "snmp_params": { "$ref": "#/components/schemas/DeviceSnmpParams" } } }, "PduPortEditPostParams": { "additionalProperties": false, "type": "object", "properties": { "note": { "description": "Comment", "type": "string" } } }, "PduGetResponse": { "type": "object", "properties": { "id": { "description": "PDU device identifier", "type": "integer" }, "device": { "description": "PDU handler type", "type": "string" }, "ip": { "description": "PDU IP address", "type": "string" }, "status": { "type": "string", "description": "Device status: * ok - device is ok * fail - lost connection with device * process_status - device poll in progress\n", "enum": [ "ok", "fail", "process_status" ] }, "status_info": { "type": "object", "description": "Detailed description of issues with device" }, "name": { "description": "Device name", "type": "string" }, "note": { "description": "Comment", "type": "string" }, "rack": { "$ref": "#/components/schemas/RackSubquery" }, "location": { "$ref": "#/components/schemas/LocationSubquery" }, "location_id": { "type": "integer", "description": "Location identifier" }, "size": { "description": "Device size", "type": "integer" }, "unit": { "description": "Unit where device is located. Return null, if it is a 0-unit device", "type": "integer", "nullable": true }, "last_update": { "description": "Date of the last device poll", "type": "string" }, "last_success_update": { "description": "Date of the last successful device poll", "type": "string" }, "total_port": { "description": "Total number of device ports", "type": "integer" }, "using_port": { "description": "Ports in use", "type": "integer" }, "snmp_params": { "$ref": "#/components/schemas/DeviceSnmpParams" } } }, "PduListResponse": { "type": "object", "properties": { "list": { "type": "array", "items": { "$ref": "#/components/schemas/PduGetResponse" } } } }, "PduPortGetResponse": { "properties": { "id": { "description": "Port identifier", "type": "integer" }, "identity": { "description": "Port identifier in PDU", "type": "integer" }, "pdu": { "description": "PDU identifier", "type": "integer" }, "power_status": { "description": "PDU port status: * up - port enabled * down - port disabled * unknown - unknown port status (does not correspond to up/down)\n", "enum": [ "unknown", "up", "down" ], "type": "string" }, "connection_type": { "description": "Port connection status * free - available * connected - connected to server * service - service port\n", "enum": [ "free", "connected", "service" ], "type": "string" }, "connection_type_info": { "description": "Additional information about service connections", "type": "string" }, "note": { "description": "Comment to port", "type": "string" }, "server": { "type": "object", "description": "Server connected to port", "properties": { "id": { "description": "Server identifier", "type": "integer" }, "name": { "description": "Server name", "type": "string" }, "rack": { "description": "Rack where server is located", "type": "integer" }, "connection_id": { "description": "Connection identifier", "type": "integer" } } } }, "type": "object" }, "PduPortListResponse": { "type": "object", "properties": { "list": { "type": "array", "items": { "$ref": "#/components/schemas/PduPortGetResponse" } } } }, "OperationGetResponse": { "additionalProperties": true, "properties": { "id": { "type": "integer" }, "status": { "type": "string" }, "status_info": { "type": "object" }, "server": { "type": "integer", "description": "The server unique identifier" }, "auth_id": { "type": "string" }, "os_template": { "type": "object", "description": "The OS template information the operation was started with" }, "progress_info": { "type": "object", "description": "The operation progress information" }, "type": { "type": "string", "enum": [ "os_install", "diag", "rescue" ], "description": "Operation type" }, "template_type": { "type": "string", "enum": [ "iso", "os_template" ], "description": "Template type" }, "start_time": { "type": "string", "description": "The operation start time" } }, "type": "object" }, "ServerCreatePostParams": { "additionalProperties": false, "required": [ "name", "mac", "rack", "unit", "platform" ], "type": "object", "properties": { "mac": { "description": "MAC address", "example": "AA:BB:CC:DD:EE:FF", "pattern": "^(([A-F0-9a-f]){2}(:|-)){5}([A-F0-9a-f]){2}$", "type": "string" }, "name": { "description": "Server name", "example": "Server 1", "minLength": 1, "maxLength": 49, "type": "string" }, "note": { "description": "Comment", "type": "string" }, "rack": { "description": "Rack unique identifier", "example": "1", "type": "integer" }, "unit": { "description": "Starting unit where server is located", "maximum": 99, "minimum": 1, "type": "integer" }, "os_template": { "type": "object", "description": "OS installed on server", "properties": { "id": { "type": "integer", "description": "OS template ID in DCI6 (if any)" }, "name": { "type": "string", "description": "OS name" }, "tags": { "type": "array", "description": "List of template tags", "example": [ "centos", "linux", "unix", "centos6" ], "items": { "type": "string" } } } }, "platform": { "description": "Server platforms ID", "minimum": 1, "type": "integer" }, "settings": { "description": "The server settings", "type": "object", "properties": { "efi": { "description": "Run operations with EFI feature for this server", "type": "boolean" } } } } }, "BladeServerCreatePostParams": { "additionalProperties": false, "required": [ "name", "mac", "chassis", "slot", "platform" ], "type": "object", "properties": { "mac": { "description": "MAC address", "example": "AA:BB:CC:DD:EE:FF", "pattern": "^(([A-F0-9a-f]){2}(:|-)){5}([A-F0-9a-f]){2}$", "type": "string" }, "name": { "description": "Server name", "example": "my key name", "pattern": "^[^ ]", "type": "string" }, "note": { "description": "Comment", "type": "string" }, "chassis": { "description": "Chassis", "example": 1, "type": "integer" }, "slot": { "description": "Starting slot where blade server is located", "maximum": 99, "minimum": 1, "type": "integer" }, "os_template": { "type": "object", "description": "OS installed on server", "properties": { "id": { "type": "integer", "description": "OS template ID in DCI6 (if any)" }, "name": { "type": "string", "description": "OS name" }, "tags": { "type": "array", "description": "List of template tags", "example": [ "centos", "linux", "unix", "centos6" ], "items": { "type": "string" } } } }, "platform": { "description": "Server platforms ID", "minimum": 1, "type": "integer" }, "settings": { "description": "The server settings", "type": "object", "properties": { "efi": { "description": "Run operations with EFI feature for this server", "type": "boolean" } } } } }, "ServerEditPostParams": { "additionalProperties": false, "properties": { "domain": { "description": "Hostname", "example": "my.server", "format": "hostname", "minLength": 1, "type": "string" }, "mac": { "description": "MAC address", "example": "AA:BB:CC:DD:EE:FF", "pattern": "^(([A-F0-9a-f]){2}(:|-)){5}([A-F0-9a-f]){2}$", "type": "string" }, "name": { "description": "Server name", "example": "my key name", "pattern": "^[^ ]", "type": "string" }, "note": { "description": "Comment", "type": "string" }, "user_note": { "description": "User comments", "type": "string" }, "unit": { "description": "Starting unit where the server is located", "maximum": 99, "minimum": 1, "type": "integer" }, "slot": { "description": "Starting slot where blade server is located", "maximum": 99, "minimum": 1, "type": "integer" }, "main_ipv4": { "description": "Primary IPv4 address of the server", "minimum": 1, "type": "integer" }, "main_ipv6": { "description": "Primary IPv6 address of the server", "minimum": 1, "type": "integer" }, "platform": { "type": "integer", "description": "The platform identifier" }, "rack": { "description": "Rack unique identifier", "example": "1", "type": "integer" }, "settings": { "description": "The server settings", "type": "object", "properties": { "efi": { "description": "Run operations with EFI feature for this server", "type": "boolean" } } } }, "type": "object" }, "DiagErrorDetail": { "additionalProperties": false, "type": "object", "properties": { "type": { "type": "string" }, "info": { "type": "string" } } }, "ServerGetResponse": { "properties": { "operation": { "type": "object", "properties": { "id": { "type": "integer" }, "status": { "type": "string" }, "status_info": { "type": "object" }, "progress_info": { "description": "Operation progress information", "type": "array", "items": { "type": "object" } } } }, "domain": { "type": "string" }, "id": { "type": "integer" }, "os_template": { "type": "object", "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "tags": { "type": "array", "items": { "type": "string" } } } }, "hardware_info": { "type": "object", "description": "Information about server equipment received during diagnostics" }, "perform_info": { "type": "object", "description": "Information about server performance received during diagnostics" }, "configuration": { "type": "string", "description": "Automatically generated server configuration" }, "settings": { "description": "The server settings", "type": "object", "properties": { "efi": { "description": "Run operations with EFI feature for this server", "type": "boolean" } } }, "state": { "type": "string", "description": "Server status: * suspending - Server operation has been suspended (all switch ports connected to the server were powered off) * suspended - Suspended(all switch ports connected to the server were powered off) * suspend_error - Error suspending sever (failed to power off all switch ports connected to the server) * resuming - Enable server operation (all switch ports connected to the server were powered on) * ok - Ready to work * resume_error - Error powering on the server(failed to power on all switch ports connected to the server)\n", "enum": [ "suspending", "suspended", "suspend_error", "resuming", "ok", "resume_error" ] }, "state_info": { "type": "string", "description": "Information about server status" }, "ip": { "items": { "properties": { "domain": { "type": "string" }, "family": { "enum": [ "ipv4", "ipv6" ], "type": "string" }, "gateway": { "type": "string" }, "id": { "type": "integer" }, "name": { "type": "string" }, "network": { "type": "string" }, "status": { "enum": [ "allocating", "ok", "fail", "allocation_fail", "in_progress", "deleting" ], "type": "string" }, "status_info": { "type": "object" } }, "type": "object" }, "type": "array" }, "switch_connection": { "description": "List of switch ports connected to the server", "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "description": "Port identifier" }, "switch": { "type": "integer", "description": "Switch identifier" }, "connection_id": { "type": "integer", "description": "Connection identifier" }, "description": { "type": "string", "description": "Port description" }, "admin_status": { "$ref": "#/components/schemas/eAdminStatus" }, "oper_status": { "$ref": "#/components/schemas/eOperStatus" }, "do_not_collect_traffic": { "type": "boolean", "description": "Do not collect traffic passing through the switch port" }, "is_ipmi_connection": { "type": "boolean", "description": "Is this connection to IPMI device" } } } }, "pdu_connection": { "description": "PDU port identifier connected to the server", "type": "object", "properties": { "port_id": { "type": "integer", "description": "Port identifier" }, "port_identity": { "type": "string", "description": "Port identifier in PDU" }, "pdu_id": { "type": "integer", "description": "PDU identifier" }, "pdu_name": { "type": "string", "description": "PDU name" }, "connection_id": { "type": "integer", "description": "Connection identifier" }, "power_status": { "type": "string", "description": "Port power status * up - port enabled * down - port disabled * unknown - unknown port status (does not correspond to up/down)\n", "enum": [ "up", "down", "unknown" ] } } }, "ipmi": { "type": "object", "properties": { "address": { "description": "IPMI IP address", "type": "string" }, "id": { "type": "integer" }, "status": { "enum": [ "on", "off", "unknown", "in_progress" ], "type": "string" }, "status_info": { "type": "object" }, "type": { "description": "IPMI type", "enum": [ "IPMI v1.5/v2", "IPMI v2(lanplus)" ], "type": "string" }, "web_url": { "description": "IPMI web-interface URL", "format": "uri", "type": "string" } } }, "intel_amt": { "type": "object", "properties": { "address": { "description": "The Intel AMT IP address", "type": "string" }, "id": { "type": "integer", "description": "The IntelAMT unique identifier" }, "status": { "enum": [ "on", "off", "unknown", "in_progress" ], "type": "string" }, "status_info": { "type": "object" }, "protocol": { "description": "The Intel AMT connection protocol", "enum": [ "http", "https" ], "type": "string" } } }, "location": { "$ref": "#/components/schemas/LocationSubquery" }, "location_id": { "type": "integer", "description": "Location identifier" }, "mac": { "type": "string" }, "main_ipv4": { "description": "Primary IPv4 address (ID). This IP will be used for OS deployment", "type": "integer" }, "main_ipv6": { "description": "Primary IPv6 address (ID). This IP will be used for OS deployment", "type": "integer" }, "name": { "type": "string" }, "platform": { "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "size": { "type": "integer" }, "type": { "type": "string" } }, "type": "object" }, "rack": { "$ref": "#/components/schemas/RackSubquery" }, "unit": { "description": "Starting unit where server is located", "type": "integer" }, "chassis": { "$ref": "#/components/schemas/ChassisSubquery" }, "slot": { "description": "Starting slot where blade server is located", "type": "integer" }, "owner": { "type": "object", "description": "Information about the server owner", "properties": { "id": { "type": "integer", "description": "Server owner identifier" }, "email": { "type": "string", "description": "Server owner email" } } }, "owner_email": { "type": "string", "description": "Server owner email" }, "diag_error": { "type": "array", "items": { "$ref": "#/components/schemas/DiagErrorDetail" } } }, "type": "object" }, "ServerListResponse": { "properties": { "list": { "items": { "$ref": "#/components/schemas/ServerGetResponse" }, "type": "array" } }, "type": "object" }, "ServersConfigurationGetResponse": { "additionalProperties": false, "properties": { "list": { "items": { "properties": { "configuration": { "type": "string", "description": "Server configuration", "example": "i9-9900K-64Gb-2x1024NVMe" }, "free_server_count": { "type": "integer", "description": "Number of available servers with corresponding configuration", "example": 42 } } }, "type": "array" } }, "type": "object" } }, "parameters": { "SettingName": { "in": "path", "name": "name", "required": true, "description": "The setting name:\n * `speed_threshold` - Minimal allowed local connection speed for diagnostics (default 80 Mbps).\n * `operation_change_boot_order` - Automatically change server boot order via IPMI before operation started (true/false)\n", "schema": { "type": "string", "enum": [ "speed_threshold", "operation_change_boot_order", "os_templates_path" ] } } } }, "security": [ { "cookieAuth": [], "headerHost": [] } ], "paths": { "/location/{location_id}/os_template/download": { "post": { "operationId": "location_id_os_template_download_post", "parameters": [ { "description": "Location unique identifier", "in": "path", "name": "location_id", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "$ref": "#/components/requestBodies/OsTemplateSetupPostParams" }, "responses": { "200": { "description": "OS templates have been uploaded to location", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessTaskOnlySchema" } } } }, "default": { "description": "Error uploading OS templates to location", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Uploading OS templates to location", "tags": [ "os_template" ] } }, "/location/{location_id}/os_template/remove": { "post": { "operationId": "location_id_os_template_remove_post", "parameters": [ { "description": "Location unique identifier", "in": "path", "name": "location_id", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "$ref": "#/components/requestBodies/OsTemplateSetupPostParams" }, "responses": { "200": { "description": "OS templates have been deleted from location", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessTaskOnlySchema" } } } }, "default": { "description": "Error deleting OS template from location", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Delete OS templates from location", "tags": [ "os_template" ] } }, "/os_template": { "get": { "operationId": "os_template_get", "responses": { "200": { "description": "List of OS templates has been received", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OsTemplateListResponse" } } } }, "default": { "description": "Error receiving a list of OS templates", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Receive list of OS templates", "tags": [ "os_template" ] } }, "/os_template/check": { "post": { "operationId": "os_template_check_post", "requestBody": { "$ref": "#/components/requestBodies/EmptyRequest" }, "responses": { "200": { "description": "List of OS templates has been updated successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessTaskOnlySchema" } } } }, "default": { "description": "Error updating list of OS templates", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Check list of OS templates", "tags": [ "os_template" ] } }, "/os_template/{os_template_id}": { "get": { "operationId": "os_template_id_get", "parameters": [ { "description": "The OS template unique identifier", "in": "path", "name": "os_template_id", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "OS template information has been received", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OsTemplateGetResponse" } } } }, "default": { "description": "Error receiving OS template information", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Receive OS template information", "tags": [ "os_template" ] }, "post": { "operationId": "os_template_id_post", "parameters": [ { "description": "The OS template unique identifier", "in": "path", "name": "os_template_id", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OsTemplateEditParams" } } } }, "responses": { "200": { "description": "The OS template settings has been changed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessSchema" } } } }, "default": { "description": "The error changing OS template settings", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "The OS template settings changing", "tags": [ "os_template" ] } }, "/location/{location_id}/os_template/{os_template_id}": { "post": { "operationId": "location_id_os_template_id_post", "parameters": [ { "description": "The OS template unique identifier", "in": "path", "name": "os_template_id", "required": true, "schema": { "type": "integer" } }, { "description": "Location unique identifier", "in": "path", "name": "location_id", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OsTemplateEditParams" } } } }, "responses": { "200": { "description": "The OS template settings on location has been changed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessSchema" } } } }, "default": { "description": "The error changing OS template settings on location", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "The OS template settings on location changing", "tags": [ "os_template" ] } }, "/location/{location_id}/os_template/{os_template_id}/copy": { "post": { "operationId": "location_id_os_template_id_copy_post", "parameters": [ { "description": "The OS template unique identifier", "in": "path", "name": "os_template_id", "required": true, "schema": { "type": "integer" } }, { "description": "Location unique identifier", "in": "path", "name": "location_id", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OsTemplateCopyParams" } } } }, "responses": { "200": { "description": "The OS template on location has been copied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessSchema" } } } }, "default": { "description": "The error of copying OS template on location", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "The OS template copying on location", "tags": [ "os_template" ] } }, "/os_template/preset_layout/{disk_size}": { "get": { "operationId": "os_template_preset_layout_get", "parameters": [ { "description": "Total selected disk size (in gigabytes) by user for partitioning", "in": "path", "name": "disk_size", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "The OS template preset layouts received", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OsTemplatePresetLayout" } } } }, "default": { "description": "The error while getting OS template preset layouts", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "The OS template preset layouts", "tags": [ "os_template" ] } }, "/pdu_connection": { "post": { "operationId": "pdu_connection_post", "summary": "Server connection to PDU", "tags": [ "pdu_connection" ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ServerToPduPostParams" } } } }, "responses": { "200": { "description": "Server has been successfully connected to PDU", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessSchema" } } } }, "default": { "description": "Error connecting server to PDU", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } } } }, "/pdu_connection/{pdu_connection_id}": { "get": { "tags": [ "pdu_connection" ], "summary": "Receive information about the server connection to pdu", "operationId": "pdu_connection_id_get", "parameters": [ { "name": "pdu_connection_id", "in": "path", "required": true, "description": "The unique identifier of server connection to pdu", "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Information about server connection to pdu has been received", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PduConnectionGetResponse" } } } }, "default": { "description": "Error receiving information about server connection to pdu", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } } }, "delete": { "operationId": "pdu_connection_id_delete", "summary": "Delete connection of server to PDU", "tags": [ "pdu_connection" ], "parameters": [ { "name": "pdu_connection_id", "description": "Unique identifier of server connection to PDU", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Server connection to PDU has been deleted successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Id" } } } }, "default": { "description": "Error deleting server connection to PDU", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } } } }, "/server/{server_id}/operation_cancel": { "post": { "operationId": "server_id_operation_cancel", "parameters": [ { "description": "Server unique identifier", "in": "path", "name": "server_id", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ServerOperationCancelPostParams" } } } }, "responses": { "200": { "description": "Operation has been cancelled successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessTaskSchema" } } } }, "default": { "description": "Error cancelling operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Cancel operation", "tags": [ "server", "operation" ] } }, "/server/{server_id}/operation_finish": { "post": { "operationId": "server_id_operation_finish", "parameters": [ { "description": "Server unique identifier", "in": "path", "name": "server_id", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ServerOperationFinishPostParams" } } } }, "responses": { "200": { "description": "Operation has been completed successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessTaskSchema" } } } }, "default": { "description": "Error completing operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Complete operation", "tags": [ "server", "operation" ] } }, "/server/{server_id}/operation_fail": { "post": { "operationId": "server_id_operation_fail", "parameters": [ { "description": "Server unique identifier", "in": "path", "name": "server_id", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ServerOperationFailPostParams" } } } }, "responses": { "200": { "description": "Operation failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessTaskSchema" } } } }, "default": { "description": "Error failing operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Fail operation", "tags": [ "server", "operation" ] } }, "/server/{server_id}/operation_os": { "post": { "operationId": "server_id_operation_os", "parameters": [ { "description": "Server unique identifier", "in": "path", "name": "server_id", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ServerOperationOsPostParams" } } } }, "responses": { "200": { "description": "Operation has been started successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessTaskSchema" } } } }, "default": { "description": "Error starting operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Start operation", "tags": [ "server", "operation" ] } }, "/server/{server_id}/operation_diag": { "post": { "operationId": "server_id_operation_diag", "parameters": [ { "description": "Server unique identifier", "in": "path", "name": "server_id", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ServerOperationDiagPostParams" } } } }, "responses": { "200": { "description": "Diagnostics has been started successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessTaskSchema" } } } }, "default": { "description": "Error starting diagnostics", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Start diagnostics", "tags": [ "server", "operation" ] } }, "/server/{server_id}/operation_rescue": { "post": { "operationId": "server_id_operation_rescue", "parameters": [ { "description": "Server unique identifier", "in": "path", "name": "server_id", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ServerOperationRescuePostParams" } } } }, "responses": { "200": { "description": "Rescue has been started successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessTaskSchema" } } } }, "default": { "description": "Error starting rescue", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Start rescue", "tags": [ "server", "operation" ] } }, "/server/{server_id}/operation_rescue_ready": { "post": { "operationId": "server_id_operation_rescue_ready", "parameters": [ { "description": "Server unique identifier", "in": "path", "name": "server_id", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "$ref": "#/components/requestBodies/EmptyRequest" }, "responses": { "200": { "description": "Operation rescue has been ready", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessTaskSchema" } } } }, "default": { "description": "Error rescue ready operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Handler does the last restore operation to the ready status", "tags": [ "server", "operation" ] } }, "/server/{server_id}/operation_iso": { "post": { "operationId": "server_id_operation_iso", "parameters": [ { "description": "Server unique identifier", "in": "path", "name": "server_id", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ServerOperationIsoPostParams" } } } }, "responses": { "200": { "description": "ISO operation has been started successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessTaskSchema" } } } }, "default": { "description": "Error starting ISO operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Start ISO operation", "tags": [ "server", "operation", "iso" ] } }, "/operation": { "get": { "operationId": "operation_get", "summary": "Recieving operations list", "tags": [ "operation" ], "responses": { "200": { "description": "Operations list has been received", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OperationListResponse" } } } }, "default": { "description": "Error getting operations list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } } } }, "/operation/{operation_id}": { "get": { "operationId": "operation_id_get", "parameters": [ { "description": "Operation unique identifier", "in": "path", "name": "operation_id", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Operation has been received", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OperationGetResponse" } } } }, "default": { "description": "Operation not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Receive operation information", "tags": [ "operation" ] } }, "/server/{server_id}/operation_clear_hdd": { "post": { "operationId": "server_id_operation_clear_hdd", "parameters": [ { "description": "Server unique identifier", "in": "path", "name": "server_id", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ServerOperationClearHddPostParams" } } } }, "responses": { "200": { "description": "Server disk cleanup has been started", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessTaskSchema" } } } }, "default": { "description": "Error starting server disk cleanup", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Start server disk cleanup", "tags": [ "server", "operation" ] } }, "/module/user_vlans/enable": { "post": { "operationId": "user_vlans_module_enable", "summary": "Enable user vlans module", "tags": [ "user_vlans_module" ], "requestBody": { "$ref": "#/components/requestBodies/EmptyRequest" }, "responses": { "200": { "description": "User VLANs module enabled successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/StatusSchema" } } } }, "default": { "description": "User VLANs module enable error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } } } }, "/module/user_vlans/disable": { "post": { "operationId": "user_vlans_module_disable", "summary": "Disable user vlans module", "tags": [ "user_vlans_module" ], "requestBody": { "$ref": "#/components/requestBodies/EmptyRequest" }, "responses": { "200": { "description": "User VLANs module disabled successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/StatusSchema" } } } }, "default": { "description": "User VLANs module disabled error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } } } }, "/module/user_vlans/status": { "get": { "operationId": "user_vlans_module_status", "responses": { "200": { "description": "User VLANs module status has been received", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/StatusSchema" } } } }, "default": { "description": "Error receiving user VLANs module status", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "User VLANs module status", "tags": [ "user_vlans_module" ] } }, "/module/user_vlans/location/{location_id}/vlan": { "post": { "operationId": "user_vlans_module_location_id_vlan_post", "summary": "Create vlan on location", "tags": [ "user_vlans_module" ], "parameters": [ { "description": "Location unique identifier", "in": "path", "name": "location_id", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UserVlanCreatePostParams" } } } }, "responses": { "200": { "description": "Vlan has been created successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessTasksIdSchema" } } } }, "default": { "description": "Error creating the vlan", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } } } }, "/module/user_vlans/location/{location_id}": { "get": { "operationId": "user_vlans_module_location_id_get", "summary": "Get information about module on location", "parameters": [ { "description": "Location unique identifier", "in": "path", "name": "location_id", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Module settings on location has been received", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UserVlansLocationGetResponse" } } } }, "default": { "description": "Location not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "tags": [ "user_vlans_module" ] } }, "/location/{location_id}/iso": { "post": { "operationId": "location_id_iso_post", "parameters": [ { "description": "The unique identifier of a location", "in": "path", "name": "location_id", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/IsoCreatePostParams" } } } }, "responses": { "200": { "description": "The ISO image has been downloaded to location", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessTaskSchema" } } } }, "default": { "description": "The error of downloading ISO image to location", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Downloading ISO image to location", "tags": [ "iso" ] } }, "/iso/{iso_id}": { "get": { "operationId": "iso_id_get", "parameters": [ { "description": "The ISO image unique identifier", "in": "path", "name": "iso_id", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "The ISO image information has been received", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/IsoGetResponse" } } } }, "default": { "description": "Error receiving ISO image information", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Receive ISO image information", "tags": [ "iso" ] }, "post": { "parameters": [ { "description": "The unique identifier of an ISO", "in": "path", "name": "iso_id", "required": true, "schema": { "type": "integer" } } ], "operationId": "iso_id_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/IsoEditPostParams" } } } }, "responses": { "200": { "description": "The ISO image has been edited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessTaskSchema" } } } }, "default": { "description": "The error of editing ISO image", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Editing ISO image", "tags": [ "iso" ] }, "delete": { "operationId": "iso_id_delete", "parameters": [ { "description": "The unique identifier of an ISO", "in": "path", "name": "iso_id", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "ISO image has been deleted successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessTaskSchema" } } } }, "default": { "description": "The error of deleting ISO image", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Delete ISO image", "tags": [ "iso" ] } }, "/iso": { "get": { "operationId": "iso", "responses": { "200": { "description": "List of ISO images has been received", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/IsoListResponse" } } } }, "default": { "description": "Error receiving a list of ISO images", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Receive list of ISO images", "tags": [ "iso" ] } }, "/update": { "post": { "operationId": "update", "requestBody": { "$ref": "#/components/requestBodies/EmptyRequest" }, "responses": { "200": { "description": "Panel update has been started", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessTaskSchema" } } } }, "default": { "description": "Failed to start panel update", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Panel update", "tags": [ "update" ] } }, "/location": { "get": { "operationId": "location_get", "responses": { "200": { "description": "Locations have been received", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LocationListResponse" } } } }, "default": { "description": "Error receiving list of locations", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Receiving all locations", "tags": [ "location" ] }, "post": { "operationId": "location_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LocationCreatePostParams" } } } }, "responses": { "200": { "description": "Location has been created successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessTasksIdSchema" } } } }, "default": { "description": "Error creating location", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Creating location", "tags": [ "location" ] } }, "/location/{location_id}": { "delete": { "operationId": "location_id_delete", "parameters": [ { "description": "Location unique identifier", "in": "path", "name": "location_id", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Location has been deleted successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Id" } } } }, "default": { "description": "Error deleting location", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Deleting location", "tags": [ "location" ] }, "get": { "operationId": "location_id_get", "parameters": [ { "description": "Location unique identifier", "in": "path", "name": "location_id", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Location has been received", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LocationGetResponse" } } } }, "default": { "description": "Location not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Receive location information", "tags": [ "location" ] }, "post": { "operationId": "location_id_post", "parameters": [ { "description": "Location unique identifier", "in": "path", "name": "location_id", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LocationEditPostParams" } } } }, "responses": { "200": { "description": "Location has been edited successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessTasksIdSchema" } } } }, "default": { "description": "Error saving location", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Edit location", "tags": [ "location" ] } }, "/location/{location_id}/setup": { "post": { "operationId": "location_id_setup_post", "parameters": [ { "description": "Location unique identifier", "in": "path", "name": "location_id", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LocationSetupPostParams" } } } }, "responses": { "200": { "description": "Location has been configured successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessTaskSchema" } } } }, "default": { "description": "Error configuring location", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Configure location", "tags": [ "location" ] } }, "/location/{location_id}/update_info": { "post": { "operationId": "location_id_update_info_post", "parameters": [ { "description": "Location unique identifier", "in": "path", "name": "location_id", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EmptySchema" } } } }, "responses": { "200": { "description": "Location info has been updated successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessTaskSchema" } } } }, "default": { "description": "Error updating location info", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Update location info", "tags": [ "location" ] } }, "/location/{location_id}/message": { "post": { "operationId": "location_id_message_post", "parameters": [ { "description": "Location unique identifier", "in": "path", "name": "location_id", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LocationMessagePostParams" } } } }, "responses": { "200": { "description": "Message has been received successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessTaskSchema" } } } }, "default": { "description": "Error receiving message", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Receive messages about operation status", "tags": [ "location" ] } }, "/location/{location_id}/rack": { "post": { "operationId": "location_id_rack_post", "parameters": [ { "description": "Location unique identifier", "in": "path", "name": "location_id", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RackCreatePostParams" } } } }, "responses": { "200": { "description": "Rack has been created successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessSchema" } } } }, "default": { "description": "Error saving rack", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Create rack", "tags": [ "rack" ] } }, "/rack": { "get": { "operationId": "rack_get", "responses": { "200": { "description": "Racks have been received", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RackListResponse" } } } }, "default": { "description": "Error receiving list of racks", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Receive all racks", "tags": [ "rack" ] } }, "/rack/{rack_id}": { "delete": { "operationId": "rack_id_delete", "parameters": [ { "description": "Rack unique identifier", "in": "path", "name": "rack_id", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Rack has been deleted successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Id" } } } }, "default": { "description": "Error deleting rack", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Delete rack", "tags": [ "rack" ] }, "get": { "operationId": "rack_id_get", "parameters": [ { "description": "Rack unique identifier", "in": "path", "name": "rack_id", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Rack has been received", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RackGetResponse" } } } }, "default": { "description": "Rack not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Receive rack", "tags": [ "rack" ] }, "post": { "operationId": "rack_id_post", "parameters": [ { "description": "Rack unique identifier", "in": "path", "name": "rack_id", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RackEditPostParams" } } } }, "responses": { "200": { "description": "Rack has been edited successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessSchema" } } } }, "default": { "description": "Error saving rack", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Edit rack", "tags": [ "rack" ] } }, "/rack/{rack_id}/unit": { "get": { "operationId": "rack_id_get_units", "parameters": [ { "description": "Rack unique identifier", "in": "path", "name": "rack_id", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "List of rack units has been received", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RackGetUnitsResponse" } } } }, "default": { "description": "Error receiving a list of rack units", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Receive a list of rack units", "tags": [ "rack" ] } }, "/rack/{rack_id}/chassis": { "post": { "operationId": "rack_id_chassis_post", "parameters": [ { "description": "Location unique identifier", "in": "path", "name": "rack_id", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ChassisCreatePostParams" } } } }, "responses": { "200": { "description": "Chassis has been created successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessSchema" } } } }, "default": { "description": "Error creating chassis", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Create chassis", "tags": [ "chassis" ] } }, "/chassis": { "get": { "operationId": "chassis_get", "responses": { "200": { "description": "Chassis list has been received", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ChassisListResponse" } } } }, "default": { "description": "Error receiving list of chassis", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Receive chassis list", "tags": [ "chassis" ] } }, "/chassis/{chassis_id}": { "get": { "operationId": "chassis_id_get", "parameters": [ { "description": "Chassis unique identifier", "in": "path", "name": "chassis_id", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Chassis has received", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ChassisGetResponse" } } } }, "default": { "description": "Chassis not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Receive chassis", "tags": [ "chassis" ] }, "post": { "operationId": "chassis_id_post", "parameters": [ { "description": "Chassis unique identifier", "in": "path", "name": "chassis_id", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ChassisEditPostParams" } } } }, "responses": { "200": { "description": "Chassis has been edited successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessSchema" } } } }, "default": { "description": "Error saving chassis", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Edit chassis", "tags": [ "chassis" ] } }, "/chassis/{chassis_id}/slot": { "get": { "operationId": "chassis_id_get_slots", "parameters": [ { "description": "Chassis unique identifier", "in": "path", "name": "chassis_id", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "List of chassis slots has been received", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ChassisGetSlotsResponse" } } } }, "default": { "description": "Error receiving a list of chassis slots", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Receive a list of chassis slots", "tags": [ "chassis" ] } }, "/set_license": { "post": { "operationId": "set_license", "summary": "Saving the license", "tags": [ "license" ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "properties": {} } } } }, "responses": { "200": { "description": "License has been saved successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EmptySchema" } } } }, "default": { "description": "Error saving license", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } } } }, "/get_license": { "get": { "operationId": "get_license", "summary": "Receiving license", "tags": [ "license" ], "responses": { "200": { "description": "License has been received successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetLicenseResponse" } } } }, "default": { "description": "Error receiving license", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } } } }, "/update_license": { "post": { "operationId": "update_license", "summary": "The license update", "tags": [ "license" ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EmptySchema" } } } }, "responses": { "200": { "description": "License has been updated successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EmptySchema" } } } }, "default": { "description": "Error updating license", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } } } }, "/supported_switch": { "get": { "operationId": "supported_switch_get", "responses": { "200": { "description": "List of supported switches has been received", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SupportedDevicesListResponse" } } } }, "default": { "description": "Error receiving list of supported switches", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "List of supported switches", "tags": [ "switch" ] } }, "/switch": { "get": { "operationId": "switch_get", "responses": { "200": { "description": "Switches have been received", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SwitchListResponse" } } } }, "default": { "description": "Error receiving list of switches", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Receive information about switches", "tags": [ "switch" ] }, "post": { "operationId": "switch_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SwitchCreatePostParams" } } } }, "responses": { "200": { "description": "Switch has been created successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessTaskSchema" } } } }, "default": { "description": "Error saving switch", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Create switch", "tags": [ "switch" ] } }, "/switch/{switch_id}": { "delete": { "operationId": "switch_id_delete", "parameters": [ { "description": "The switch unique identifier", "in": "path", "name": "switch_id", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Switch has been deleted successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Id" } } } }, "default": { "description": "Error deleting switch", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Delete switch", "tags": [ "switch" ] }, "get": { "operationId": "switch_id_get", "parameters": [ { "description": "The switch unique identifier", "in": "path", "name": "switch_id", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Switch has been received", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SwitchGetResponse" } } } }, "default": { "description": "Switch not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Receive information about switch", "tags": [ "switch" ] }, "post": { "operationId": "switch_id_post", "parameters": [ { "description": "The switch unique identifier", "in": "path", "name": "switch_id", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SwitchEditPostParams" } } } }, "responses": { "200": { "description": "Switch has been edited successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessTaskSchema" } } } }, "default": { "description": "Error saving switch", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Edit switch", "tags": [ "switch" ] } }, "/switch/{switch_id}/info": { "post": { "operationId": "switch_id_info_post", "parameters": [ { "description": "The switch unique identifier", "in": "path", "name": "switch_id", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SwitchInfoEditPostParams" } } } }, "responses": { "200": { "description": "Switch port data have been edited successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Id" } } } }, "default": { "description": "Error saving switch port data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Edit switch port information (internal only)", "tags": [ "switch" ] } }, "/switch/{switch_id}/port": { "get": { "operationId": "switch_port_get", "parameters": [ { "description": "The switch unique identifier", "in": "path", "name": "switch_id", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Switch ports have been received", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SwitchPortListResponse" } } } }, "default": { "description": "Error receiving a list of switch ports", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Receive switch ports information", "tags": [ "switch" ] } }, "/switch/{switch_id}/port/{port_id}": { "get": { "operationId": "switch_port_id_get", "parameters": [ { "description": "The switch unique identifier", "in": "path", "name": "switch_id", "required": true, "schema": { "type": "integer" } }, { "description": "Switch port unique identifier", "in": "path", "name": "port_id", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Switch port has been received", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SwitchPortGetResponse" } } } }, "default": { "description": "Switch port not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Receive information about switch port", "tags": [ "switch" ] }, "post": { "operationId": "switch_port_id_post", "parameters": [ { "description": "The switch unique identifier", "in": "path", "name": "switch_id", "required": true, "schema": { "type": "integer" } }, { "description": "Switch port unique identifier", "in": "path", "name": "port_id", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SwitchPortEditPostParams" } } } }, "responses": { "200": { "description": "Switch port has been changed successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessTaskSchema" } } } }, "default": { "description": "Error saving switch port", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Edit switch port", "tags": [ "switch" ] } }, "/switch/{switch_id}/port/{port_id}/down": { "post": { "operationId": "switch_port_down_post", "parameters": [ { "description": "The switch unique identifier", "in": "path", "name": "switch_id", "required": true, "schema": { "type": "integer" } }, { "description": "Switch port ID", "in": "path", "name": "port_id", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "$ref": "#/components/requestBodies/EmptyRequest" }, "responses": { "200": { "description": "Switch port has been powered off successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessTaskSchema" } } } }, "default": { "description": "Error powering off switch port", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Power off switch port", "tags": [ "switch" ] } }, "/switch/{switch_id}/port/{port_id}/up": { "post": { "operationId": "switch_port_up_post", "parameters": [ { "description": "The switch unique identifier", "in": "path", "name": "switch_id", "required": true, "schema": { "type": "integer" } }, { "description": "Switch port ID", "in": "path", "name": "port_id", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "$ref": "#/components/requestBodies/EmptyRequest" }, "responses": { "200": { "description": "Switch port has been powered on successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessTaskSchema" } } } }, "default": { "description": "Error powering on switch port", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Power on switch port", "tags": [ "switch" ] } }, "/switch/{switch_id}/refresh": { "post": { "operationId": "switch_id_refresh", "parameters": [ { "description": "The switch unique identifier", "in": "path", "name": "switch_id", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "$ref": "#/components/requestBodies/EmptyRequest" }, "responses": { "200": { "description": "Switch has been polled successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessTaskSchema" } } } }, "default": { "description": "Error polling switch", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Switch poll", "tags": [ "switch" ] } }, "/switch/{switch_id}/status": { "post": { "operationId": "switch_id_status", "parameters": [ { "description": "The switch unique identifier", "in": "path", "name": "switch_id", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "$ref": "#/components/requestBodies/EmptyRequest" }, "responses": { "200": { "description": "Switch has been polled successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessTaskSchema" } } } }, "default": { "description": "Error polling switch", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Switch poll", "tags": [ "switch" ] } }, "/switch/{switch_id}/port/{port_id}/connect": { "post": { "operationId": "switch_id_port_id_connect", "parameters": [ { "description": "The switch unique identifier", "in": "path", "name": "switch_id", "required": true, "schema": { "type": "integer" } }, { "description": "Switch port ID", "in": "path", "name": "port_id", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SwitchPortConnectPostParams" } } } }, "responses": { "200": { "description": "Swtich port connection has been updated successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Id" } } } }, "default": { "description": "Error connect switch port", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Connect switch port", "tags": [ "switch" ] } }, "/switch_port/{port_id}": { "post": { "operationId": "switch_port_port_id_post", "parameters": [ { "description": "The port unique identifier", "in": "path", "name": "port_id", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SwitchPortUserEditPostParams" } } } }, "responses": { "200": { "description": "Switch port connection has been changed successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessTaskSchema" } } } }, "default": { "description": "Error while editing switch port connection", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Edit switch port connection", "tags": [ "switch" ] }, "get": { "operationId": "switch_port_port_id_get", "parameters": [ { "description": "The port unique identifier", "in": "path", "name": "port_id", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Switch port has been received", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SwitchPortUserGetResponse" } } } }, "default": { "description": "Switch port not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Receive information about switch port", "tags": [ "switch" ] } }, "/setup": { "post": { "operationId": "setup_post", "requestBody": { "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/SetupPostParams" }, { "$ref": "#/components/schemas/BoxSetupPostParams" } ] } } } }, "responses": { "200": { "description": "Location has been created successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessTasksIdSchema" } } } }, "default": { "description": "Error creating location", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Create first location", "tags": [ "location", "common" ] } }, "/info": { "get": { "operationId": "info_get", "responses": { "200": { "description": "DCI6 information and status have been received", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InfoGetResponse" } } } }, "default": { "description": "Error receiving information", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Receive the panel status information with user permissions", "tags": [ "location", "common" ] } }, "/current_user/auth_setting/{name}": { "post": { "operationId": "user_auth_setting_post", "summary": "Edit description of the configuration by its name for the current user", "tags": [ "common" ], "parameters": [ { "description": "Parameter name", "in": "path", "name": "name", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UserSettingsParams" } } } }, "responses": { "200": { "description": "Configuration description has been edited successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessTaskSchema" } } } }, "default": { "description": "Error editing configuration description", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } } }, "get": { "operationId": "user_auth_setting_get", "summary": "Receive configuration description by its name for the current user", "tags": [ "common" ], "parameters": [ { "description": "Parameter name", "in": "path", "name": "name", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Configuration description has been received successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UserSettingsParams" } } } }, "default": { "description": "Error receiving configuration description", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } } } }, "/data_extractor": { "get": { "operationId": "data_extractor_get", "responses": { "200": { "description": "Statistics has been collected and sent successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EmptySchema" } } } }, "default": { "description": "Error collecting and sending statistics", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Collect and send statistics", "tags": [ "common" ] } }, "/user": { "post": { "operationId": "user_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UserCreatePostParams" } } } }, "responses": { "200": { "description": "User has been created successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessSchema" } } } }, "default": { "description": "Error creating user", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Create user", "tags": [ "user" ] }, "get": { "operationId": "user_get", "responses": { "200": { "description": "Users list has been received", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UserListResponse" } } } }, "default": { "description": "Error receiving users list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Receive a list if all users", "tags": [ "user" ] } }, "/user/{user_id}": { "delete": { "operationId": "user_id_delete", "parameters": [ { "description": "User unique identifier", "in": "path", "name": "user_id", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "User has been deleted successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Id" } } } }, "default": { "description": "Error deleting user", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Delete user", "tags": [ "user" ] }, "post": { "operationId": "user_id_post", "parameters": [ { "description": "User unique identifier", "in": "path", "name": "user_id", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UserEditPostParams" } } } }, "responses": { "200": { "description": "User has been edited successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessTasksIdSchema" } } } }, "default": { "description": "Error saving user data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Edit user", "tags": [ "user" ] }, "get": { "operationId": "user_id_get", "parameters": [ { "description": "User unique identifier", "in": "path", "name": "user_id", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Users data has been received", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UserGetResponse" } } } }, "default": { "description": "Error receiving user information", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Receive a information about users", "tags": [ "user" ] } }, "/setting/{name}": { "post": { "operationId": "setting_name_post", "summary": "Modify the setting value", "tags": [ "common" ], "parameters": [ { "$ref": "#/components/parameters/SettingName" } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SettingParams" } } } }, "responses": { "200": { "description": "The setting value has been succesfully changed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SettingGetResponse" } } } }, "default": { "description": "Error changing the setting value", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } } }, "get": { "operationId": "setting_name_get", "summary": "Getting the setting value", "tags": [ "common" ], "parameters": [ { "$ref": "#/components/parameters/SettingName" } ], "responses": { "200": { "description": "Got the setting value", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SettingGetResponse" } } } }, "default": { "description": "Error getting the setting value", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } } } }, "/platform": { "get": { "operationId": "platform_get", "responses": { "200": { "description": "Platforms have been received", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PlatformListResponse" } } } }, "default": { "description": "Error receiving list of platforms", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Receive all platforms", "tags": [ "platform" ] }, "post": { "operationId": "platform_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PlatformCreatePostParams" } } } }, "responses": { "200": { "description": "Platform has been created successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessSchema" } } } }, "default": { "description": "Error creating platform", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Create platform", "tags": [ "platform" ] } }, "/platform/{platform_id}": { "get": { "operationId": "platform_id_get", "parameters": [ { "description": "Platform unique identifier", "in": "path", "name": "platform_id", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Platform has been received", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PlatformGetResponse" } } } }, "default": { "description": "Platform not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Receive platform", "tags": [ "platform" ] }, "post": { "operationId": "platform_id_post", "parameters": [ { "description": "Platform unique identifier", "in": "path", "name": "platform_id", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PlatformEditPostParams" } } } }, "responses": { "200": { "description": "Platform has been edited successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessSchema" } } } }, "default": { "description": "Error saving platform", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Edit platform", "tags": [ "platform" ] }, "delete": { "operationId": "platform_id_delete", "parameters": [ { "description": "Platform unique identifier", "in": "path", "name": "platform_id", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Platform has been deleted successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Id" } } } }, "default": { "description": "Error deleting platform", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Delete platform", "tags": [ "platform" ] } }, "/server/{server_id}/ip": { "get": { "operationId": "server_id_ip_get", "parameters": [ { "description": "Server unique identifier", "in": "path", "name": "server_id", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "List of server IP addresses has been received", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/IpListResponse" } } } }, "default": { "description": "Error receiving a list of server IP addresses", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Receive a list of server IP addresses", "tags": [ "ip" ] }, "post": { "operationId": "server_id_ip_post", "parameters": [ { "description": "Server unique identifier", "in": "path", "name": "server_id", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/IpCreatePostParams" } } } }, "responses": { "200": { "description": "IP has been created successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessTaskSchema" } } } }, "default": { "description": "Error saving IP", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Create IP", "tags": [ "ip" ] } }, "/server/{server_id}/ip/{ip_id}": { "delete": { "operationId": "server_id_ip_id_delete", "parameters": [ { "description": "Ip address unique identifier", "in": "path", "name": "ip_id", "required": true, "schema": { "type": "integer" } }, { "description": "Server unique identifier", "in": "path", "name": "server_id", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "IP address has been deleted successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessTaskSchema" } } } }, "default": { "description": "Error deleting IP address", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Delete IP address", "tags": [ "ip" ] } }, "/ip": { "get": { "operationId": "ip_get", "responses": { "200": { "description": "List of IP addresses has been received", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/IpListResponse" } } } }, "default": { "description": "Error receiving a list of IP addresses", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Receive a list of IP addresses", "tags": [ "ip" ] } }, "/ip/{ip_id}": { "delete": { "operationId": "ip_id_delete", "parameters": [ { "description": "IP address unique identifier", "in": "path", "name": "ip_id", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Ip address has been deleted successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessTaskSchema" } } } }, "default": { "description": "Error deleting IP address", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Delete IP address", "tags": [ "ip" ] }, "get": { "operationId": "ip_id_get", "parameters": [ { "description": "IP address unique identifier", "in": "path", "name": "ip_id", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "IP has been received", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/IpGetResponse" } } } }, "default": { "description": "Error receiving IP address", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Receive IP address", "tags": [ "ip" ] }, "post": { "operationId": "ip_id_post", "parameters": [ { "description": "IP address unique identifier", "in": "path", "name": "ip_id", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/IpEditPostParams" } } } }, "responses": { "200": { "description": "IP has been saved successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessTaskSchema" } } } }, "default": { "description": "Error saving IP address", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Edit IP", "tags": [ "ip" ] } }, "/journal": { "get": { "operationId": "journal_get", "responses": { "200": { "description": "Journal have been received", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JournalListResponse" } } } }, "default": { "description": "Error receiving journal list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Receive journal information", "tags": [ "journal" ] } }, "/server/server_id/journal": { "get": { "operationId": "server_id_journal_get", "parameters": [ { "description": "Server unique identifier", "in": "path", "name": "server_id", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Journal have been received", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JournalListResponse" } } } }, "default": { "description": "Error receiving journal list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Receive journal information", "tags": [ "journal" ] } }, "/location/{location_id}/vlan/{vlan_id}": { "delete": { "operationId": "location_id_vlan_id_delete", "parameters": [ { "description": "The location unique identifier", "in": "path", "name": "location_id", "required": true, "schema": { "type": "integer" } }, { "description": "The VLAN unique identifier", "in": "path", "name": "vlan_id", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "The VLAN has been deleted successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Id" } } } }, "default": { "description": "Error deleting the VLAN", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "The VLAN deletion", "tags": [ "vlan" ] }, "post": { "operationId": "location_id_vlan_id_post", "parameters": [ { "description": "The location unique identifier", "in": "path", "name": "location_id", "required": true, "schema": { "type": "integer" } }, { "description": "The VLAN unique identifier", "in": "path", "name": "vlan_id", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/VlanEditPostParams" } } } }, "responses": { "200": { "description": "The VLAN has been edited successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessSchema" } } } }, "default": { "description": "Error saving the VLAN", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "The VLAN edit", "tags": [ "vlan" ] }, "get": { "operationId": "location_id_vlan_id_get", "parameters": [ { "description": "The location unique identifier", "in": "path", "name": "location_id", "required": true, "schema": { "type": "integer" } }, { "description": "The VLAN unique identifier", "in": "path", "name": "vlan_id", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "The VLAN has been received", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/VlanGetResponse" } } } }, "default": { "description": "The VLAN not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Receive information about VLAN", "tags": [ "vlan" ] } }, "/location/{location_id}/vlan": { "post": { "operationId": "vlan_post", "parameters": [ { "description": "The location unique identifier", "in": "path", "name": "location_id", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/VlanCreatePostParams" } } } }, "responses": { "200": { "description": "The VLAN has been created successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessSchema" } } } }, "default": { "description": "Error saving vlan", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Create vlan", "tags": [ "vlan" ] }, "get": { "operationId": "location_vlan_get", "parameters": [ { "description": "The location unique identifier", "in": "path", "name": "location_id", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "The location vlans have been received", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LocationVlansListResponse" } } } }, "default": { "description": "Error receiving a list of location vlans", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Receive location vlans information", "tags": [ "vlan" ] } }, "/location/{location_id}/vlan/{vlan_id}/members": { "get": { "operationId": "location_id_vlan_id_members_get", "parameters": [ { "description": "The location unique identifier", "in": "path", "name": "location_id", "required": true, "schema": { "type": "integer" } }, { "description": "The VLAN unique identifier", "in": "path", "name": "vlan_id", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "The VLAN members has been received", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/VlanMembersGetResponse" } } } }, "default": { "description": "The VLAN not found" } }, "summary": "The VLAN members list", "tags": [ "vlan" ] } }, "/cpu_socket": { "post": { "operationId": "cpu_socket_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CpuSocketCreatePostParams" } } } }, "responses": { "200": { "description": "CPU socket has been created successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessSchema" } } } }, "default": { "description": "Error creating CPU socket", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Creating CPU socket", "tags": [ "cpu_socket" ] }, "get": { "operationId": "cpu_socket_get", "responses": { "200": { "description": "CPU sockets have been received", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CpuSocketListResponse" } } } }, "default": { "description": "Error receiving CPU sockets", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Receiving all CPU sockets", "tags": [ "cpu_socket" ] } }, "/recipe": { "post": { "operationId": "recipe_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RecipeCreatePostParams" } } } }, "responses": { "200": { "description": "The recipe has been created successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessSchema" } } } }, "default": { "description": "Error saving the recipe", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Create recipe", "tags": [ "recipe" ] }, "get": { "operationId": "recipe_get", "responses": { "200": { "description": "The recipes have been received", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RecipeListResponse" } } } }, "default": { "description": "Error receiving a list of recipes", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Receive recipes information", "tags": [ "recipe" ] } }, "/recipe/check": { "post": { "operationId": "recipe_check_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EmptySchema" } } } }, "responses": { "200": { "description": "Recipes have been updated successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessSchema" } } } }, "default": { "description": "Error while updating list of recipes", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Check recipes", "tags": [ "recipe" ] } }, "/recipe/{recipe_id}": { "get": { "operationId": "recipe_id_get", "parameters": [ { "description": "The recipe unique identifier", "in": "path", "name": "recipe_id", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "The recipe has been received", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RecipeGetResponse" } } } }, "default": { "description": "The recipe not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Receive information about recipe", "tags": [ "recipe" ] }, "post": { "operationId": "recipe_id_post", "parameters": [ { "description": "The recipe unique identifier", "in": "path", "name": "recipe_id", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RecipeEditPostParams" } } } }, "responses": { "200": { "description": "The recipe has been edited successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessSchema" } } } }, "default": { "description": "Error saving the recipe information", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "The recipe edit", "tags": [ "recipe" ] }, "delete": { "operationId": "recipe_id_delete", "parameters": [ { "description": "The recipe unique identifier", "in": "path", "name": "recipe_id", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "The recipe has been deleted successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Id" } } } }, "default": { "description": "Error deleting the recipe", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "The recipe deletion", "tags": [ "recipe" ] } }, "/intel_amt": { "get": { "operationId": "intel_amt_get", "responses": { "200": { "description": "List of IntelAMT connections has been received", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/IntelAmtListResponse" } } } }, "default": { "description": "Error receiving a list of IntelAMT connections", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Receiving list of IntelAMT connections", "tags": [ "intel_amt" ] } }, "/intel_amt/{intel_amt_id}": { "delete": { "operationId": "intel_amt_id_delete", "parameters": [ { "description": "IntelAMT connection unique identifier", "in": "path", "name": "intel_amt_id", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "IntelAMT connection has been deleted successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Id" } } } }, "default": { "description": "Error deleting IntelAMT connections", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Deleting IntelAMT connections", "tags": [ "intel_amt" ] }, "get": { "operationId": "intel_amt_id_get", "parameters": [ { "description": "IntelAMT unique identifier", "in": "path", "name": "intel_amt_id", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Information about IntelAMT connection has been received", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/IntelAmtGetResponse" } } } }, "default": { "description": "IntelAMT connection not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Getting information about IntelAMT connection", "tags": [ "intel_amt" ] }, "post": { "operationId": "intel_amt_id_post", "parameters": [ { "description": "IntelAMT connection unique identifier", "in": "path", "name": "intel_amt_id", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/IntelAmtEditPostParams" } } } }, "responses": { "200": { "description": "IntelAMT connection has been edited successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessTaskSchema" } } } }, "default": { "description": "Error saving IntelAMT connection", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Editing IntelAMT connection", "tags": [ "intel_amt" ] } }, "/server/{server_id}/intel_amt": { "post": { "operationId": "server_id_intel_amt_post", "parameters": [ { "description": "Server unique identifier", "in": "path", "name": "server_id", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/IntelAmtCreatePostParams" } } } }, "responses": { "200": { "description": "IntelAMT has been created successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessTaskSchema" } } } }, "default": { "description": "Error saving IntelAMT", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Creating IntelAMT", "tags": [ "intel_amt" ] } }, "/intel_amt/{intel_amt_id}/status": { "post": { "operationId": "intel_amt_id_status_post", "parameters": [ { "description": "IntelAMT connection unique identifier", "in": "path", "name": "intel_amt_id", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "$ref": "#/components/requestBodies/EmptyRequest" }, "responses": { "200": { "description": "IntelAMT status has been received successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessTaskSchema" } } } }, "default": { "description": "Error receiving IntelAMT status", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Receiving IntelAMT status", "tags": [ "intel_amt" ] } }, "/intel_amt/{intel_amt_id}/power_on": { "post": { "operationId": "intel_amt_id_power_on", "summary": "Turn IntelAMT on", "tags": [ "intel_amt" ], "parameters": [ { "description": "The IntelAMT unique identifier", "in": "path", "name": "intel_amt_id", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "$ref": "#/components/requestBodies/EmptyRequest" }, "responses": { "200": { "description": "IntelAMT power has been successfully turned on", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessTaskSchema" } } } }, "default": { "description": "Error turning IntelAMT on", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } } } }, "/intel_amt/{intel_amt_id}/power_off": { "post": { "operationId": "intel_amt_id_power_off", "summary": "Turn IntelAMT off", "tags": [ "intel_amt" ], "parameters": [ { "description": "The IntelAMT unique identifier", "in": "path", "name": "intel_amt_id", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "$ref": "#/components/requestBodies/EmptyRequest" }, "responses": { "200": { "description": "IntelAMT power has been successfully turned off", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessTaskSchema" } } } }, "default": { "description": "Error turning IntelAMT off", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } } } }, "/intel_amt/{intel_amt_id}/power_reset": { "post": { "operationId": "intel_amt_id_power_reset", "summary": "Reset IntelAMT power", "tags": [ "intel_amt" ], "parameters": [ { "description": "The IntelAMT unique identifier", "in": "path", "name": "intel_amt_id", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "$ref": "#/components/requestBodies/EmptyRequest" }, "responses": { "200": { "description": "IntelAMT power has been successfully reseted", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessTaskSchema" } } } }, "default": { "description": "Error resetting IntelAMT power", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } } } }, "/intel_amt/{intel_amt_id}/pxe_boot": { "post": { "operationId": "intel_amt_id_pxe_boot", "summary": "Change IntelAMT boot order", "tags": [ "intel_amt" ], "parameters": [ { "description": "The IntelAMT unique identifier", "in": "path", "name": "intel_amt_id", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "$ref": "#/components/requestBodies/EmptyRequest" }, "responses": { "200": { "description": "IntelAMT boot order has been successfully changed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessTaskSchema" } } } }, "default": { "description": "Error changing IntelAMT boot order", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } } } }, "/intel_amt/{intel_amt_id}/info": { "post": { "operationId": "intel_amt_id_info_post", "parameters": [ { "description": "The Intel AMT unique identifier", "in": "path", "name": "intel_amt_id", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/IntelAmtInfoEditPostParams" } } } }, "responses": { "200": { "description": "Intel AMT data have been edited successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Id" } } } }, "default": { "description": "Error saving Intel AMT data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Edit Intel AMT information (internal only)", "tags": [ "intel_amt" ] } }, "/server/{server_id}/power_off": { "post": { "operationId": "server_id_power_off_post", "parameters": [ { "description": "Server unique identifier", "in": "path", "name": "server_id", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "$ref": "#/components/requestBodies/EmptyRequest" }, "responses": { "200": { "description": "Server has been powered off successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessTaskSchema" } } } }, "default": { "description": "Error powering off server", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Server power on", "tags": [ "server", "power" ] } }, "/server/{server_id}/power_on": { "post": { "operationId": "server_id_power_on_post", "parameters": [ { "description": "Server unique identifier", "in": "path", "name": "server_id", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "$ref": "#/components/requestBodies/EmptyRequest" }, "responses": { "200": { "description": "Server has been powered on successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessTaskSchema" } } } }, "default": { "description": "Error powering on server", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Server power on", "tags": [ "server", "power" ] } }, "/server/{server_id}/power_reset": { "post": { "operationId": "server_id_power_reset_post", "parameters": [ { "description": "Server unique identifier", "in": "path", "name": "server_id", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "$ref": "#/components/requestBodies/EmptyRequest" }, "responses": { "200": { "description": "Server has been restarted successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessTaskSchema" } } } }, "default": { "description": "Error restarting server", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Server restart", "tags": [ "server", "power" ] } }, "/server/{server_id}/owner": { "post": { "operationId": "server_id_owner_post", "parameters": [ { "description": "Server unique identifier", "in": "path", "name": "server_id", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ServerOwnerPostParams" } } } }, "responses": { "200": { "description": "Server owner has been changed successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessSchema" } } } }, "default": { "description": "Error changing server owner", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Server owner change", "tags": [ "server" ] }, "delete": { "operationId": "server_id_owner_delete", "parameters": [ { "description": "Server unique identifier", "in": "path", "name": "server_id", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Server release", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Id" } } } }, "default": { "description": "Error releasing server", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Server release", "tags": [ "server" ] } }, "/ipmi": { "get": { "operationId": "ipmi_get", "responses": { "200": { "description": "List of IPMI connections has been received", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/IpmiListResponse" } } } }, "default": { "description": "Error receiving a list of IPMI connections", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Receiving list of IPMI connections", "tags": [ "ipmi" ] } }, "/ipmi/{ipmi_id}": { "delete": { "operationId": "ipmi_id_delete", "parameters": [ { "description": "IPMI connection unique identifier", "in": "path", "name": "ipmi_id", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "IPMI connection has been deleted successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Id" } } } }, "default": { "description": "Error deleting IPMI connections", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Deleting IPMI connections", "tags": [ "ipmi" ] }, "get": { "operationId": "ipmi_id_get", "parameters": [ { "description": "IPMI unique identifier", "in": "path", "name": "ipmi_id", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Information about IPMI connection has been received", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/IpmiGetResponse" } } } }, "default": { "description": "IPMI connection not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Getting information about IPMI connection", "tags": [ "ipmi" ] }, "post": { "operationId": "ipmi_id_post", "parameters": [ { "description": "IPMI connection unique identifier", "in": "path", "name": "ipmi_id", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/IpmiEditPostParams" } } } }, "responses": { "200": { "description": "IPMI connection has been edited successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessTaskSchema" } } } }, "default": { "description": "Error saving IPMI connection", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Editing IPMI connection", "tags": [ "ipmi" ] } }, "/ipmi/{ipmi_id}/status": { "post": { "operationId": "ipmi_id_status_post", "parameters": [ { "description": "IPMI connection unique identifier", "in": "path", "name": "ipmi_id", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "$ref": "#/components/requestBodies/EmptyRequest" }, "responses": { "200": { "description": "IPMI status has been received successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessTaskSchema" } } } }, "default": { "description": "Error receiving IPMI status", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Receiving IPMI status", "tags": [ "ipmi" ] } }, "/ipmi/{ipmi_id}/power_on": { "post": { "operationId": "ipmi_id_power_on", "summary": "Turn IPMI on", "tags": [ "ipmi" ], "parameters": [ { "description": "The IPMI unique identifier", "in": "path", "name": "ipmi_id", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "$ref": "#/components/requestBodies/EmptyRequest" }, "responses": { "200": { "description": "IPMI power has been successfully turned on", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessTaskSchema" } } } }, "default": { "description": "Error turning IPMI on", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } } } }, "/ipmi/{ipmi_id}/power_off": { "post": { "operationId": "ipmi_id_power_off", "summary": "Turn IPMI off", "tags": [ "ipmi" ], "parameters": [ { "description": "The IPMI unique identifier", "in": "path", "name": "ipmi_id", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "$ref": "#/components/requestBodies/EmptyRequest" }, "responses": { "200": { "description": "IPMI power has been successfully turned off", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessTaskSchema" } } } }, "default": { "description": "Error turning IPMI off", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } } } }, "/ipmi/{ipmi_id}/power_reset": { "post": { "operationId": "ipmi_id_power_reset", "summary": "Reset IPMI power", "tags": [ "ipmi" ], "parameters": [ { "description": "The IPMI unique identifier", "in": "path", "name": "ipmi_id", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "$ref": "#/components/requestBodies/EmptyRequest" }, "responses": { "200": { "description": "IPMI power has been successfully reseted", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessTaskSchema" } } } }, "default": { "description": "Error resetting IPMI power", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } } } }, "/ipmi/{ipmi_id}/boot_order": { "post": { "operationId": "ipmi_id_boot_order", "summary": "Change IPMI boot order", "tags": [ "ipmi" ], "parameters": [ { "description": "The IPMI unique identifier", "in": "path", "name": "ipmi_id", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/IpmiBootOrderParams" } } } }, "responses": { "200": { "description": "IPMI boot order has been successfully changed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessTaskSchema" } } } }, "default": { "description": "Error changing IPMI boot order", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } } } }, "/server/{server_id}/ipmi": { "post": { "operationId": "server_id_ipmi_post", "parameters": [ { "description": "Server unique identifier", "in": "path", "name": "server_id", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/IpmiCreatePostParams" } } } }, "responses": { "200": { "description": "IPMI has been created successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessTaskSchema" } } } }, "default": { "description": "Error saving IPMI", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Creating IPMI", "tags": [ "ipmi" ] } }, "/server/{server_id}/switch_connection": { "get": { "operationId": "server_id_switch_connection_get", "parameters": [ { "description": "Server unique identifier", "in": "path", "name": "server_id", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "List of server connections to switches has been received", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SwitchConnectionListResponse" } } } }, "default": { "description": "Error receiving a list of server connections to switches", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Receive a list of server connections to switches", "tags": [ "server", "switch_connection" ] } }, "/switch_connection": { "post": { "deprecated": true, "operationId": "switch_connection_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ServerToSwitchPostParams" } } } }, "responses": { "200": { "description": "Server has been connected to switch successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessSchema" } } } }, "default": { "description": "Error connecting server to switch", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Method is deprecated. Use \"/switch/{switch_id}/port/{port_id}/connect\"", "tags": [ "switch_connection" ] } }, "/switch_connection/{switch_connection_id}": { "get": { "deprecated": true, "tags": [ "switch_connection" ], "summary": "Method is deprecated. Use \"/switch/{switch_id}/port/{port_id}/connect\"", "operationId": "switch_connection_id_get", "parameters": [ { "name": "switch_connection_id", "in": "path", "required": true, "description": "Unique identifier of server connection to switch", "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Information about server connection to switch has been received", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SwitchConnectionGetResponse" } } } }, "default": { "description": "Error receiving information about server connection to switch", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } } }, "delete": { "deprecated": true, "operationId": "switch_connection_id_delete", "parameters": [ { "name": "switch_connection_id", "description": "Unique identifier of server connection to switch", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Server connection to switch has been deleted successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Id" } } } }, "default": { "description": "Error deleting server connection", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Method is deprecated. Use \"/switch/{switch_id}/port/{port_id}/connect\"", "tags": [ "switch_connection" ] }, "post": { "deprecated": true, "operationId": "switch_connection_id_post", "parameters": [ { "name": "switch_connection_id", "description": "Unique identifier of server connection to switch", "in": "path", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "$ref": "#/components/requestBodies/EmptyRequest" }, "responses": { "200": { "description": "Server connection to switch has been edited successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessSchema" } } } }, "default": { "description": "Error editing server connection to switch", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Method is deprecated. Use \"/switch/{switch_id}/port/{port_id}/connect\"", "tags": [ "switch_connection" ] } }, "/ippool": { "get": { "operationId": "ippool_get", "parameters": [ { "description": "The list of pools will be filtered by this location ID. If it is not specified, a full list will be displayed. Otherwise, the list will display the pools only from this location and public pools.\n", "in": "query", "name": "location", "schema": { "type": "integer" } } ], "responses": { "200": { "description": "List of pools has been received", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/IppoolListResponse" } } } }, "default": { "description": "Error receiving a list of pools", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Error receiving a list of pools from IPmgr6 with the location field", "tags": [ "ipmgr" ] } }, "/ipnet": { "get": { "operationId": "ipnet_get", "parameters": [ { "description": "The list of networks will be filtered by this location ID. If it is not specified, a full list will be displayed. Otherwise, the list will display the networks only from this location and public networks.\n", "in": "query", "name": "location", "schema": { "type": "integer" } } ], "responses": { "200": { "description": "List of networks has been received", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/IpnetListResponse" } } } }, "default": { "description": "Error receiving a list of networks", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Receiving a list of networks from IPmgr6 with the location field", "tags": [ "ipmgr" ] } }, "/supported_pdu": { "get": { "operationId": "supported_pdu_get", "summary": "List of supported PDU", "tags": [ "pdu" ], "responses": { "200": { "description": "List of supported PDU has been received", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SupportedDevicesListResponse" } } } }, "default": { "description": "Error receiving a list of supported PDU", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } } } }, "/pdu": { "post": { "operationId": "pdu_post", "summary": "Create PDU", "tags": [ "pdu" ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PduCreatePostParams" } } } }, "responses": { "200": { "description": "PDU has been created successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessTaskSchema" } } } }, "default": { "description": "Error creating PDU", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } } }, "get": { "operationId": "pdu_get", "summary": "PDU list", "tags": [ "pdu" ], "responses": { "200": { "description": "PDU list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PduListResponse" } } } }, "default": { "description": "Error receiving PDU list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } } } }, "/pdu/{pdu_id}": { "get": { "operationId": "pdu_id_get", "summary": "PDU", "parameters": [ { "description": "PDU unique identifier", "in": "path", "name": "pdu_id", "required": true, "schema": { "type": "integer" } } ], "tags": [ "pdu" ], "responses": { "200": { "description": "PDU", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PduGetResponse" } } } }, "default": { "description": "Error receiving PDU", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } } }, "delete": { "operationId": "pdu_id_delete", "summary": "Delete PDU", "tags": [ "pdu" ], "parameters": [ { "description": "PDU unique identifier", "in": "path", "name": "pdu_id", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "PDU has been deleted successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Id" } } } }, "default": { "description": "Error deleting PDU", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } } }, "post": { "operationId": "pdu_id_post", "summary": "Edit PDU", "tags": [ "pdu" ], "parameters": [ { "description": "PDU unique identifier", "in": "path", "name": "pdu_id", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PduEditPostParams" } } } }, "responses": { "200": { "description": "PDU has been edited successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessTaskSchema" } } } }, "default": { "description": "Error editing PDU", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } } } }, "/pdu/{pdu_id}/status": { "post": { "operationId": "pdu_id_status", "summary": "Poll PDU", "tags": [ "pdu" ], "parameters": [ { "description": "PDU unique identifier", "in": "path", "name": "pdu_id", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "$ref": "#/components/requestBodies/EmptyRequest" }, "responses": { "200": { "description": "PDU poll task has been registered", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessTaskSchema" } } } }, "default": { "description": "Error creating PDU poll task", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } } } }, "/pdu/{pdu_id}/port": { "get": { "operationId": "pdu_port_get", "parameters": [ { "description": "PDU unique identifier", "in": "path", "name": "pdu_id", "required": true, "schema": { "type": "integer" } } ], "summary": "List of PDU ports", "tags": [ "pdu" ], "responses": { "200": { "description": "Ports list has been received", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PduPortListResponse" } } } }, "default": { "description": "Error receiving list of ports", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } } } }, "/pdu/{pdu_id}/port/{port_id}": { "get": { "operationId": "pdu_port_get_id", "parameters": [ { "description": "PDU unique identifier", "in": "path", "name": "pdu_id", "required": true, "schema": { "type": "integer" } }, { "description": "PDU port unique identifier", "in": "path", "name": "port_id", "required": true, "schema": { "type": "integer" } } ], "summary": "Information about PDU port", "tags": [ "pdu" ], "responses": { "200": { "description": "Port information has been received", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PduPortGetResponse" } } } }, "default": { "description": "Error receiving port information", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } } }, "post": { "operationId": "pdu_port_id_post", "parameters": [ { "description": "PDU unique identifier", "in": "path", "name": "pdu_id", "required": true, "schema": { "type": "integer" } }, { "description": "PDU port unique identifier", "in": "path", "name": "port_id", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PduPortEditPostParams" } } } }, "responses": { "200": { "description": "PDU port information has been edited successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Id" } } } }, "default": { "description": "Error saving PDU port information", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Edit PDU port information", "tags": [ "pdu" ] } }, "/pdu/{pdu_id}/port/{port_id}/down": { "post": { "operationId": "pdu_port_down_post", "summary": "PDU port power off", "tags": [ "pdu" ], "parameters": [ { "description": "PDU unique identifier", "in": "path", "name": "pdu_id", "required": true, "schema": { "type": "integer" } }, { "description": "PDU port unique identifier", "in": "path", "name": "port_id", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "$ref": "#/components/requestBodies/EmptyRequest" }, "responses": { "200": { "description": "Task for PDU port power off has been registered", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessTaskSchema" } } } }, "default": { "description": "Error creating a task for PDU port power off", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } } } }, "/pdu/{pdu_id}/port/{port_id}/up": { "post": { "operationId": "pdu_port_up_post", "summary": "PDU port power off", "tags": [ "pdu" ], "parameters": [ { "description": "PDU unique identifier", "in": "path", "name": "pdu_id", "required": true, "schema": { "type": "integer" } }, { "description": "PDU port unique identifier", "in": "path", "name": "port_id", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "$ref": "#/components/requestBodies/EmptyRequest" }, "responses": { "200": { "description": "Task for PDU port power on has been registered", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessTaskSchema" } } } }, "default": { "description": "Error creating a task for PDU port power on", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } } } }, "/server": { "get": { "operationId": "server_get", "responses": { "200": { "description": "Servers have been received", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ServerListResponse" } } } }, "default": { "description": "Error receiving servers list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Receive information about servers", "tags": [ "server" ] }, "post": { "operationId": "server_post", "requestBody": { "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ServerCreatePostParams" }, { "$ref": "#/components/schemas/BladeServerCreatePostParams" } ] } } } }, "responses": { "200": { "description": "Server has been created successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessTaskSchema" } } } }, "default": { "description": "Error saving server", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Create server", "tags": [ "server" ] } }, "/server/{server_id}": { "delete": { "operationId": "server_id_delete", "parameters": [ { "description": "Server unique identifier", "in": "path", "name": "server_id", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Server has been deleted successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Id" } } } }, "default": { "description": "Error deleting server", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Delete server", "tags": [ "server" ] }, "get": { "operationId": "server_id_get", "parameters": [ { "description": "Server unique identifier", "in": "path", "name": "server_id", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Server has been received", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ServerGetResponse" } } } }, "default": { "description": "Server not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Receive server information", "tags": [ "server" ] }, "post": { "operationId": "server_id_post", "parameters": [ { "description": "Server unique identifier", "in": "path", "name": "server_id", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ServerEditPostParams" } } } }, "responses": { "200": { "description": "Server has been edited successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessTasksIdSchema" } } } }, "default": { "description": "Error saving server", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Edit server", "tags": [ "server" ] } }, "/server/{server_id}/last_operation": { "get": { "operationId": "server_id_last_operation_get", "parameters": [ { "description": "Server unique identifier", "in": "path", "name": "server_id", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Operation has been received", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OperationGetResponse" } } } }, "default": { "description": "Operation not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Receive information about operation", "tags": [ "server" ] } }, "/server/{server_id}/suspend": { "post": { "operationId": "server_id_suspend", "parameters": [ { "description": "Server unique identifier", "in": "path", "name": "server_id", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "$ref": "#/components/requestBodies/EmptyRequest" }, "responses": { "200": { "description": "Switch ports connected to server have been powered off successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessTaskSchema" } } } }, "default": { "description": "Error powering off switch ports connected to server", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Power off switch ports connected to server.", "tags": [ "server" ] } }, "/server/{server_id}/resume": { "post": { "operationId": "server_id_resume", "parameters": [ { "description": "Server unique identifier", "in": "path", "name": "server_id", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "$ref": "#/components/requestBodies/EmptyRequest" }, "responses": { "200": { "description": "Switch ports connected to server have been powered on successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessTaskSchema" } } } }, "default": { "description": "Error powering on switch ports connected to server", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Power on switch ports connected to server.", "tags": [ "server" ] } }, "/server/configuration": { "get": { "operationId": "servers_configuration_get", "responses": { "200": { "description": "List of servers configurations has been received", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ServersConfigurationGetResponse" } } } }, "default": { "description": "Cannot receive a list of servers configurations", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Receive a list of all unique servers configurations and number of available servers corresponding to these configurations. Integration with billing system is required\n", "tags": [ "server" ] } }, "/server/free": { "get": { "operationId": "server_free_get", "responses": { "200": { "description": "Free servers have been received", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ServerListResponse" } } } }, "default": { "description": "Failed to receive free servers list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorSchema" } } } } }, "summary": "Receive information about servers that are able to be dedicated to client. These servers meet the following conditions: - server has no owner - server diagnostics completed and its configuration has been received - server last operation completed successfully or canceled\n", "tags": [ "server" ] } } }}