{ "swagger": "2.0", "info": { "description": "Network Insight API Reference", "version": "1.1.6", "title": "Network Insight API Reference" }, "host": "www.mgmt.cloud.vmware.com", "basePath": "/ni/api/ni/", "tags": [ { "name": "Data Sources", "description": "Data source APIs" }, { "name": "Entities", "description": "Entities APIs" }, { "name": "Search", "description": "Search APIs" }, { "name": "Infrastructure", "description": "Infra APIs" }, { "name": "Applications", "description": "Applications APIs" }, { "name": "Microsegmentation", "description": "Micro-segmentation APIs" }, { "name": "Info", "description": "Info APIs" }, { "name": "Settings", "description": "Settings APIs" }, { "name": "Schema", "description": "Schema APIs" }, { "name": "Metrics", "description": "Metrics APIs" }, { "name": "Path", "description": "Path related APIs" }, { "name": "Logs", "description": "Logs APIs" } ], "schemes": [ "https" ], "securityDefinitions": { "ApiKeyAuth": { "description": "CSP Auth Token", "in": "header", "name": "csp-auth-token", "type": "apiKey" } }, "produces": [ "application/json" ], "parameters": { "Identifier": { "name": "id", "in": "path", "description": "entity id", "required": true, "type": "string" }, "Time": { "name": "time", "in": "query", "description": "time in epoch seconds", "required": false, "type": "integer", "format": "int64" }, "Size": { "name": "size", "in": "query", "description": "page size of results", "required": false, "type": "number", "default": 10 }, "Cursor": { "name": "cursor", "in": "query", "description": "cursor from previous response", "required": false, "type": "string" }, "StartTime": { "name": "start_time", "in": "query", "description": "start time for query in epoch seconds", "required": false, "type": "number" }, "EndTime": { "name": "end_time", "in": "query", "description": "end time for query in epoch seconds", "required": false, "type": "number" }, "UserType": { "name": "type", "in": "query", "description": "type of user", "required": true, "type": "string" }, "UserGroupType": { "name": "type", "in": "query", "description": "type of user-group", "required": true, "type": "string" }, "EventTags": { "name": "event_tags", "in": "query", "description": "event tags", "required": false, "type": "array", "items": { "type": "string" } }, "EventStatus": { "name": "event_status", "in": "query", "description": "status of event open or closed", "required": false, "type": "string", "default": "all", "enum": [ "open", "closed", "all" ] }, "EventType": { "name": "event_type", "in": "query", "description": "type of event, e.g UserDefinedProblemEvent", "required": false, "type": "string" }, "UpdateTimeFrom": { "name": "update_time_from", "in": "query", "description": "Events that were created or updated or closed between this time and update_time_to, in seconds", "required": false, "type": "number" }, "UpdateTimeTo": { "name": "update_time_to", "in": "query", "description": "Events that were created or updated or closed between update_time_from and this time, in seconds", "required": false, "type": "number" } }, "paths": { "/infra/nodes": { "get": { "tags": [ "Infrastructure" ], "summary": "List nodes", "description": "Get list of infrastructure nodes. Only admin users can retrieve this information.", "operationId": "listNodes", "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/NodeListResult" }, "examples": { "results": [ { "id": "18230:901:1585583463", "entity_type": "NODE" }, { "id": "18230:901:1706494033", "entity_type": "NODE" } ], "total_count": 2 } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } } }, "/infra/nodes/{id}": { "get": { "tags": [ "Infrastructure" ], "summary": "Show node details", "description": "Get details of infrastructure nodes. Only admin users can get this information. The proxy id is\nrequired for adding a data source for selecting appropriate proxy node to add the data source.", "operationId": "getNode", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/Node" }, "examples": { "id": "18230:901:1585583463", "entity_type": "NODE", "node_type": "PROXY_VM", "node_id": "IOYHU2J", "ip_address": "10.126.103.156" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/info/version": { "get": { "tags": [ "Info" ], "summary": "Show version info", "description": "Show version info", "operationId": "getVersion", "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/VersionResponse" } }, "401": { "description": "Unauthorized" } } } }, "/data-sources/vcenters": { "post": { "tags": [ "Data Sources" ], "summary": "Create a vCenter data source", "description": "Add a vcenter data source. User must provide one of ip or fqdn field in the request body.\nAppropriate proxy id is retrieved from infra/nodes URL to select the proxy node.", "operationId": "addVcenterDatasource", "parameters": [ { "in": "body", "name": "body", "description": "VCenter Credentials", "required": true, "schema": { "$ref": "#/definitions/VCenterDataSourceRequest" } } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "201": { "description": "Created", "schema": { "$ref": "#/definitions/VCenterDataSource" }, "examples": { "entity_id": "18230:902:993642895", "entity_type": "VCenterDataSource", "ip": "10.197.17.68", "fqdn": null, "proxy_id": "18230:901:1585583463", "nickname": "aa", "enabled": true, "notes": "ecmp lab aa", "credentials": { "username": "administrator@vsphere.local", "password": "" } } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } }, "get": { "tags": [ "Data Sources" ], "summary": "List vCenter data sources", "description": "List vCenter data sources", "operationId": "listVcenters", "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/DataSourceListResponse" }, "examples": { "results": [ { "entity_id": "18230:902:993642895", "entity_type": "VCenterDataSource" }, { "entity_id": "18230:902:627340998", "entity_type": "VCenterDataSource" } ], "total_count": 2 } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } } }, "/data-sources/vcenters/{id}": { "get": { "tags": [ "Data Sources" ], "summary": "Show vCenter data source details", "description": "Show vCenter data source details", "operationId": "getVcenter", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "schema": { "$ref": "#/definitions/VCenterDataSource" }, "examples": { "entity_id": "18230:902:993642895", "entity_type": "VCenterDataSource", "ip": "10.197.17.68", "fqdn": null, "proxy_id": "18230:901:1585583463", "nickname": "aa", "enabled": true, "notes": "ecmp lab", "credentials": { "username": "administrator@vsphere.local", "password": "" } }, "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } }, "put": { "tags": [ "Data Sources" ], "summary": "Update a vCenter data source.", "description": "Update a vcenter data source. Only nickname, notes and credentials can be updated.", "operationId": "updateVcenter", "parameters": [ { "in": "body", "name": "body", "schema": { "$ref": "#/definitions/VCenterDataSource" } }, { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "schema": { "$ref": "#/definitions/VCenterDataSource" }, "description": "OK" }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } }, "delete": { "tags": [ "Data Sources" ], "summary": "Delete a vCenter data source", "description": "Delete a data source", "operationId": "deleteVcenter", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "204": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } } }, "/data-sources/vcenters/{id}/enable": { "post": { "tags": [ "Data Sources" ], "summary": "Enable a vCenter data source", "description": "Enable a vCenter data source", "operationId": "enableVcenter", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/data-sources/vcenters/{id}/disable": { "post": { "tags": [ "Data Sources" ], "summary": "Disable a vCenter data source", "description": "Disable a vCenter data source", "operationId": "disableVcenter", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/data-sources/f5-bigip": { "post": { "tags": [ "Data Sources" ], "summary": "Add a F5 BIG-IP as data source", "description": "Add switch Datasource", "operationId": "addF5BIGIP", "parameters": [ { "in": "body", "name": "body", "description": "Add a F5 BIG-IP as datasource", "schema": { "$ref": "#/definitions/F5BIGIPDataSourceRequest" } } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "201": { "schema": { "$ref": "#/definitions/F5BIGIPDataSource" }, "description": "Created" }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } }, "get": { "tags": [ "Data Sources" ], "summary": "List F5 BIG-IP data sources", "description": "List F5 BIG-IP data sources", "operationId": "listF5BIGIP", "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/DataSourceListResponse" }, "examples": { "results": [ { "entity_id": "18230:952:993642895", "entity_type": "F5BIGIPDataSource" } ], "total_count": 1 } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } } }, "/data-sources/f5-bigip/{id}": { "get": { "tags": [ "Data Sources" ], "summary": "Show F5 BIG-IP data source details", "description": "Show F5 BIG-IP data source details", "operationId": "getF5BIGIP", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/F5BIGIPDataSource" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Unauthorized" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } }, "put": { "tags": [ "Data Sources" ], "summary": "Update a F5 BIG-IP data source", "description": "Update a F5 BIG-IP data source", "operationId": "updateF5BIGIP", "parameters": [ { "in": "body", "name": "body", "schema": { "$ref": "#/definitions/F5BIGIPDataSource" } }, { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/F5BIGIPDataSource" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } }, "delete": { "tags": [ "Data Sources" ], "summary": "Delete a F5 BIG-IP data source", "description": "Delete a F5 BIG-IP data source", "operationId": "deleteF5BIGIP", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } } }, "/data-sources/f5-bigip/{id}/enable": { "post": { "tags": [ "Data Sources" ], "summary": "Enable a F5 BIG-IP data source", "description": "Enable a F5 BIG-IP data source", "operationId": "enableF5BIGIP", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/data-sources/f5-bigip/{id}/disable": { "post": { "tags": [ "Data Sources" ], "summary": "Disable a F5 BIG-IP data source", "description": "Disable a F5 BIG-IP data source", "operationId": "disableF5BIGIP", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/data-sources/f5-bigip/{id}/snmp-config": { "get": { "tags": [ "Data Sources" ], "summary": "Show snmp config for F5 BIG-IP data source", "description": "Show snmp config for v data source", "operationId": "getF5BIGIPSnmpConfig", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/SNMPConfig" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } }, "put": { "tags": [ "Data Sources" ], "summary": "Update snmp config for a F5 BIG-IP data source", "description": "Update snmp config for a F5 BIG-IP data source", "operationId": "updateF5BIGIPSnmpConfig", "parameters": [ { "in": "body", "name": "body", "schema": { "$ref": "#/definitions/SNMPConfig" } }, { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/SNMPConfig" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/data-sources/huawei": { "post": { "tags": [ "Data Sources" ], "summary": "Add a Huawei as data source", "description": "Add switch Datasource", "operationId": "addHuawei", "parameters": [ { "in": "body", "name": "body", "description": "Add a Huawei as datasource", "schema": { "$ref": "#/definitions/HuaweiSwitchDataSourceRequest" } } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "201": { "schema": { "$ref": "#/definitions/HuaweiSwitchDataSource" }, "description": "Created" }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } }, "get": { "tags": [ "Data Sources" ], "summary": "List Huawei data sources", "description": "List Huawei data sources", "operationId": "listHuawei", "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/DataSourceListResponse" }, "examples": { "results": [ { "entity_id": "18230:960:993642895", "entity_type": "HuaweiSwitchDataSource" } ], "total_count": 1 } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } } }, "/data-sources/huawei/{id}": { "get": { "tags": [ "Data Sources" ], "summary": "Show Huawei data source details", "description": "Show Huawei data source details", "operationId": "getHuawei", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/HuaweiSwitchDataSource" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Unauthorized" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } }, "put": { "tags": [ "Data Sources" ], "summary": "Update a Huawei data source", "description": "Update a Huawei data source", "operationId": "updateHuawei", "parameters": [ { "in": "body", "name": "body", "schema": { "$ref": "#/definitions/HuaweiSwitchDataSource" } }, { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/HuaweiSwitchDataSource" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } }, "delete": { "tags": [ "Data Sources" ], "summary": "Delete a Huawei data source", "description": "Delete a Huawei data source", "operationId": "deleteHuawei", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } } }, "/data-sources/huawei/{id}/enable": { "post": { "tags": [ "Data Sources" ], "summary": "Enable a Huawei data source", "description": "Enable a Huawei data source", "operationId": "enableHuawei", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/data-sources/huawei/{id}/disable": { "post": { "tags": [ "Data Sources" ], "summary": "Disable a Huawei data source", "description": "Disable a Huawei data source", "operationId": "disableHuawei", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/data-sources/huawei/{id}/snmp-config": { "get": { "tags": [ "Data Sources" ], "summary": "Show snmp config for Huawei data source", "description": "Show snmp config for v data source", "operationId": "getHuaweiSnmpConfig", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/SNMPConfig" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } }, "put": { "tags": [ "Data Sources" ], "summary": "Update snmp config for a Huawei data source", "description": "Update snmp config for a Huawei data source", "operationId": "updateHuaweiSnmpConfig", "parameters": [ { "in": "body", "name": "body", "schema": { "$ref": "#/definitions/SNMPConfig" } }, { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/SNMPConfig" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/data-sources/generic-switches": { "post": { "tags": [ "Data Sources" ], "summary": "Create generic switch as data source", "description": "Add generic switch as data source.", "operationId": "addGenericSwitch", "parameters": [ { "in": "body", "name": "body", "schema": { "$ref": "#/definitions/GenericSwitchDataSourceRequest" } } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "201": { "schema": { "$ref": "#/definitions/GenericSwitchDataSource" }, "description": "Created" }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } }, "get": { "tags": [ "Data Sources" ], "summary": "List generic switch data sources", "description": "List generic switch data sources", "operationId": "listGenericSwitch", "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/DataSourceListResponse" }, "examples": { "results": [ { "entity_id": "18230:963:993642895", "entity_type": "GenericSwitchDataSource" } ], "total_count": 1 } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } } }, "/data-sources/generic-switches/{id}": { "get": { "tags": [ "Data Sources" ], "summary": "Show generic switch data source details", "description": "Show generic switch data source details", "operationId": "getGenericSwitch", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/GenericSwitchDataSource" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Unauthorized" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } }, "put": { "tags": [ "Data Sources" ], "summary": "Update generic switch data source", "description": "Update generic switch data source", "operationId": "updateGenericSwitch", "parameters": [ { "in": "body", "name": "body", "schema": { "$ref": "#/definitions/GenericSwitchDataSource" } }, { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/GenericSwitchDataSource" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } }, "delete": { "tags": [ "Data Sources" ], "summary": "Delete generic switch data source", "description": "Delete generic switch data source", "operationId": "deleteGenericSwitch", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } } }, "/data-sources/generic-switches/{id}/data": { "put": { "consumes": [ "multipart/form-data" ], "tags": [ "Data Sources" ], "summary": "File Upload", "description": "File Upload", "operationId": "fileUpload", "parameters": [ { "in": "formData", "name": "file", "type": "file", "required": true, "description": "The file to upload." }, { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/data-sources/generic-switches/{id}/enable": { "post": { "tags": [ "Data Sources" ], "summary": "Enable generic switch data source", "description": "Enable generic switch data source", "operationId": "enableGenericSwitch", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/data-sources/generic-switches/{id}/disable": { "post": { "tags": [ "Data Sources" ], "summary": "Disable generic switch data source", "description": "Disable generic switch data source", "operationId": "disableGenericSwitch", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/data-sources/hpe-switches": { "post": { "tags": [ "Data Sources" ], "summary": "Create a HPE switch as data source", "description": "Add a HPE switch as data source", "operationId": "addHPESwitch", "parameters": [ { "in": "body", "name": "body", "schema": { "$ref": "#/definitions/HPESwitchDataSourceRequest" } } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "201": { "schema": { "$ref": "#/definitions/HPESwitchDataSource" }, "description": "Created" }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } }, "get": { "tags": [ "Data Sources" ], "summary": "List HPE switch data sources", "description": "List HPE switch data sources", "operationId": "listHPESwitches", "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/DataSourceListResponse" }, "examples": { "results": [ { "entity_id": "18230:1960:993642895", "entity_type": "HPESwitchDataSource" } ], "total_count": 1 } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } } }, "/data-sources/hpe-switches/{id}": { "get": { "tags": [ "Data Sources" ], "summary": "Show HPE switch data source details", "description": "Show HPE switch data source details", "operationId": "getHPESwitch", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/HPESwitchDataSource" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } }, "put": { "tags": [ "Data Sources" ], "summary": "Update a HPE switch data source", "description": "Update a HPE switch data source", "operationId": "updateHPESwitchManager", "parameters": [ { "in": "body", "name": "body", "schema": { "$ref": "#/definitions/HPESwitchDataSource" } }, { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/HPESwitchDataSource" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } }, "delete": { "tags": [ "Data Sources" ], "summary": "Delete a HPE switch data source", "description": "Delete a HPE switch data source", "operationId": "deleteHPESwitch", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } } }, "/data-sources/hpe-switches/{id}/enable": { "post": { "tags": [ "Data Sources" ], "summary": "Enable a HPE switch data source", "description": "Enable a HPE switch data source", "operationId": "enableHPESwitch", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/data-sources/hpe-switches/{id}/disable": { "post": { "tags": [ "Data Sources" ], "summary": "Disable a HPE switch data source", "description": "Disable a HPE switch data source", "operationId": "disableHPESwitch", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/data-sources/hpe-switches/{id}/snmp-config": { "get": { "tags": [ "Data Sources" ], "summary": "Show snmp config for HPE switch data source", "description": "Show snmp config for HPE switch data source", "operationId": "getHPESwitchSnmpConfig", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/SNMPConfig" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } }, "put": { "tags": [ "Data Sources" ], "summary": "Update snmp config for HPE switch data source", "description": "Update snmp config for HPE switch data source", "operationId": "updateHPESwitchSnmpConfig", "parameters": [ { "in": "body", "name": "body", "schema": { "$ref": "#/definitions/SNMPConfig" } }, { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/SNMPConfig" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/data-sources/mellanox-switches": { "post": { "tags": [ "Data Sources" ], "summary": "Create a Mellanox switch as data source", "description": "Add a Mellanox switch as data source", "operationId": "addMellanoxSwitch", "parameters": [ { "in": "body", "name": "body", "schema": { "$ref": "#/definitions/MellanoxSwitchDataSourceRequest" } } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "201": { "schema": { "$ref": "#/definitions/MellanoxSwitchDataSource" }, "description": "Created" }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } }, "get": { "tags": [ "Data Sources" ], "summary": "List Mellanox switch data sources", "description": "List Mellanox switch data sources", "operationId": "listMellanoxSwitches", "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/DataSourceListResponse" }, "examples": { "results": [ { "entity_id": "18230:985:993642895", "entity_type": "MellanoxSwitchDataSource" } ], "total_count": 1 } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } } }, "/data-sources/mellanox-switches/{id}": { "get": { "tags": [ "Data Sources" ], "summary": "Show Mellanox switch data source details", "description": "Show Mellanox switch data source details", "operationId": "getMellanoxSwitch", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/HPESwitchDataSource" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } }, "put": { "tags": [ "Data Sources" ], "summary": "Update a Mellanox switch data source", "description": "Update a Mellanox switch data source", "operationId": "updateMellanoxSwitchManager", "parameters": [ { "in": "body", "name": "body", "schema": { "$ref": "#/definitions/MellanoxSwitchDataSource" } }, { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/MellanoxSwitchDataSource" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } }, "delete": { "tags": [ "Data Sources" ], "summary": "Delete a Mellanox switch data source", "description": "Delete a Mellanox switch data source", "operationId": "deleteMellanoxSwitch", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } } }, "/data-sources/mellanox-switches/{id}/enable": { "post": { "tags": [ "Data Sources" ], "summary": "Enable a Mellanox switch data source", "description": "Enable a Mellanox switch data source", "operationId": "enableMellanoxSwitch", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/data-sources/mellanox-switches/{id}/disable": { "post": { "tags": [ "Data Sources" ], "summary": "Disable a Mellanox switch data source", "description": "Disable a Mellanox switch data source", "operationId": "disableMellanoxSwitch", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/data-sources/mellanox-switches/{id}/snmp-config": { "get": { "tags": [ "Data Sources" ], "summary": "Show snmp config for Mellanox switch data source", "description": "Show snmp config for Mellanox switch data source", "operationId": "getMellanoxSwitchSnmpConfig", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/SNMPConfig" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } }, "put": { "tags": [ "Data Sources" ], "summary": "Update snmp config for Mellanox switch data source", "description": "Update snmp config for Mellanox switch data source", "operationId": "updateMellanoxSwitchSnmpConfig", "parameters": [ { "in": "body", "name": "body", "schema": { "$ref": "#/definitions/SNMPConfig" } }, { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/SNMPConfig" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/data-sources/cisco-switches": { "post": { "tags": [ "Data Sources" ], "summary": "Create a cisco switch data source", "description": "Add cisco switch as data source. User must provide one of ip or fqdn field in the request body.\nAppropriate proxy id is retrieved from infra/nodes URL to select the proxy node.", "operationId": "addCiscoSwitch", "parameters": [ { "in": "body", "name": "body", "description": "Add a cisco switch as datasource.", "schema": { "$ref": "#/definitions/CiscoSwitchDataSourceRequest" } } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "201": { "schema": { "$ref": "#/definitions/CiscoSwitchDataSource" }, "description": "Created" }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "412": { "description": "Precondition Failed", "schema": { "$ref": "#/definitions/ApiError" } }, "500": { "description": "Internal Error" } } }, "get": { "tags": [ "Data Sources" ], "summary": "List cisco switch data sources", "description": "List cisco switch data sources", "operationId": "listCiscoSwitches", "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/DataSourceListResponse" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } } }, "/data-sources/cisco-switches/{id}": { "get": { "tags": [ "Data Sources" ], "summary": "Show cisco switch data source details", "description": "Show cisco switch data source details", "operationId": "getCiscoSwitch", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/CiscoSwitchDataSource" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } }, "put": { "tags": [ "Data Sources" ], "summary": "Update a cisco switch data source", "description": "Update a cisco switch data source. Only credentials, nickname and notes can be updated.", "operationId": "updateCiscoSwitch", "parameters": [ { "in": "body", "name": "body", "schema": { "$ref": "#/definitions/CiscoSwitchDataSource" } }, { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/CiscoSwitchDataSource" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } }, "delete": { "tags": [ "Data Sources" ], "summary": "Delete a cisco switch data source", "description": "Delete a cisco switch data source", "operationId": "deleteCiscoSwitch", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } } }, "/data-sources/cisco-switches/{id}/enable": { "post": { "tags": [ "Data Sources" ], "summary": "Enable a cisco switch data source", "description": "Enable a cisco switch data source", "operationId": "enableCiscoSwitch", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/data-sources/cisco-switches/{id}/disable": { "post": { "tags": [ "Data Sources" ], "summary": "Disable a cisco switch data source", "description": "Disable a cisco switch data source", "operationId": "disableCiscoSwitch", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/data-sources/cisco-switches/{id}/snmp-config": { "get": { "tags": [ "Data Sources" ], "summary": "Show snmp config for cisco switch data source", "description": "Show snmp config for cisco switch data source", "operationId": "getCiscoSwitchSnmpConfig", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/SNMPConfig" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } }, "put": { "tags": [ "Data Sources" ], "summary": "Update snmp config for cisco switch data source", "description": "Update snmp config for cisco switch data source", "operationId": "updateCiscoSwitchSnmpConfig", "parameters": [ { "in": "body", "name": "body", "schema": { "$ref": "#/definitions/SNMPConfig" } }, { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/SNMPConfig" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/data-sources/cisco-switches/{id}/wan-config": { "get": { "tags": [ "Data Sources" ], "summary": "Show WAN config for cisco switch data source", "description": "Show WAN config for cisco switch data source", "operationId": "getCiscoSwitchWANConfig", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/WANConfig" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } }, "put": { "tags": [ "Data Sources" ], "summary": "Update WAN config for cisco switch data source", "description": "Update WAN config for cisco switch data source", "operationId": "updateCiscoSwitchWANConfig", "parameters": [ { "in": "body", "name": "body", "schema": { "$ref": "#/definitions/WANConfig" } }, { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/WANConfig" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/data-sources/dell-switches": { "post": { "tags": [ "Data Sources" ], "summary": "Create a dell switch data source", "description": "Add a dell switch as data source", "operationId": "addDellSwitch", "parameters": [ { "in": "body", "name": "body", "schema": { "$ref": "#/definitions/DellSwitchDataSourceRequest" } } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "201": { "schema": { "$ref": "#/definitions/DellSwitchDataSource" }, "description": "Created" }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } }, "get": { "tags": [ "Data Sources" ], "summary": "List dell switch data sources", "description": "List dell switch data sources", "operationId": "listDellSwitches", "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/DataSourceListResponse" }, "examples": { "results": [ { "entity_id": "18230:902:993642895", "entity_type": "DellSwitchDataSource" } ], "total_count": 1 } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } } }, "/data-sources/dell-switches/{id}": { "get": { "tags": [ "Data Sources" ], "summary": "Show dell switch data source details", "description": "Get a dell switch data source details", "operationId": "getDellSwitch", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/DellSwitchDataSource" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } }, "put": { "tags": [ "Data Sources" ], "summary": "Update a dell switch data source", "description": "Update a dell switch data source. Only credentials, nickname and notes can be updated", "operationId": "updateDellSwitch", "parameters": [ { "in": "body", "name": "body", "schema": { "$ref": "#/definitions/DellSwitchDataSource" } }, { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/DellSwitchDataSource" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } }, "delete": { "tags": [ "Data Sources" ], "summary": "Delete a dell switch data source", "description": "Delete a data source", "operationId": "deleteDellSwitch", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } } }, "/data-sources/dell-switches/{id}/enable": { "post": { "tags": [ "Data Sources" ], "summary": "Enable a dell switch data source", "description": "Enable a dell switch data source", "operationId": "enableDellSwitch", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/data-sources/dell-switches/{id}/disable": { "post": { "tags": [ "Data Sources" ], "summary": "Disable a dell switch data source", "description": "Disable a dell switch data source", "operationId": "disableDellSwitch", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/data-sources/dell-switches/{id}/snmp-config": { "get": { "tags": [ "Data Sources" ], "summary": "Show snmp config for dell switch data source", "description": "Show snmp config for dell switch data source", "operationId": "getDellSwitchSnmpConfig", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/SNMPConfig" } }, "401": { "description": "Unauthorized" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } }, "put": { "tags": [ "Data Sources" ], "summary": "Update snmp config for dell switch data source", "description": "Update snmp config for dell switch data source", "operationId": "updateDellSwitchSnmpConfig", "parameters": [ { "in": "body", "name": "body", "schema": { "$ref": "#/definitions/SNMPConfig" } }, { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/SNMPConfig" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/data-sources/dell-os10-switches": { "post": { "tags": [ "Data Sources" ], "summary": "Create a dell OS10 switch data source", "description": "Add a dell OS10 switch as data source", "operationId": "addDellOs10Switch", "parameters": [ { "in": "body", "name": "body", "schema": { "$ref": "#/definitions/DellOs10SwitchDataSourceRequest" } } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "201": { "schema": { "$ref": "#/definitions/DellSwitchDataSource" }, "description": "Created" }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } }, "get": { "tags": [ "Data Sources" ], "summary": "List dell os10 switch data sources", "description": "List dell os10 switch data sources", "operationId": "listDellOs10Switches", "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/DataSourceListResponse" }, "examples": { "results": [ { "entity_id": "18230:902:993642895", "entity_type": "DellSwitchDataSource" } ], "total_count": 1 } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } } }, "/data-sources/dell-os10-switches/{id}": { "get": { "tags": [ "Data Sources" ], "summary": "Show dell os10 switch data source details", "description": "Get a dell os10 switch data source details", "operationId": "getDellOs10Switch", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/DellSwitchDataSource" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } }, "put": { "tags": [ "Data Sources" ], "summary": "Update a dell os10 switch data source", "description": "Update a dell os10 switch data source. Only credentials, nickname and notes can be updated", "operationId": "updateDellOs10Switch", "parameters": [ { "in": "body", "name": "body", "schema": { "$ref": "#/definitions/DellSwitchDataSource" } }, { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/DellSwitchDataSource" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } }, "delete": { "tags": [ "Data Sources" ], "summary": "Delete a dell os10 switch data source", "description": "Delete a data source", "operationId": "deleteDellOs10Switch", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } } }, "/data-sources/dell-os10-switches/{id}/enable": { "post": { "tags": [ "Data Sources" ], "summary": "Enable a dell os10 switch data source", "description": "Enable a dell os10 switch data source", "operationId": "enableDellOs10Switch", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/data-sources/dell-os10-switches/{id}/disable": { "post": { "tags": [ "Data Sources" ], "summary": "Disable a dell os10 switch data source", "description": "Disable a dell os10 switch data source", "operationId": "disableDellOs10Switch", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/data-sources/dell-os10-switches/{id}/snmp-config": { "get": { "tags": [ "Data Sources" ], "summary": "Show snmp config for dell os10 switch data source", "description": "Show snmp config for dell os10 switch data source", "operationId": "getDellOs10SwitchSnmpConfig", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/SNMPConfig" } }, "401": { "description": "Unauthorized" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } }, "put": { "tags": [ "Data Sources" ], "summary": "Update snmp config for dell os10 switch data source", "description": "Update snmp config for dell os10 switch data source", "operationId": "updateDellOs10SwitchSnmpConfig", "parameters": [ { "in": "body", "name": "body", "schema": { "$ref": "#/definitions/SNMPConfig" } }, { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/SNMPConfig" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/data-sources/brocade-switches": { "post": { "tags": [ "Data Sources" ], "summary": "Create a brocade switch data source", "description": "Add brocade switch as a data source", "operationId": "addBrocadeSwitch", "parameters": [ { "in": "body", "name": "body", "schema": { "$ref": "#/definitions/BrocadeSwitchDataSourceRequest" } } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "201": { "schema": { "$ref": "#/definitions/BrocadeSwitchDataSource" }, "description": "Created" }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } }, "get": { "tags": [ "Data Sources" ], "summary": "List brocade switch data sources", "description": "List brocade switch data sources", "operationId": "listBrocadeSwitches", "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/DataSourceListResponse" }, "examples": { "results": [ { "entity_id": "18230:908:993642895", "entity_type": "BrocadeSwitchDataSource" } ], "total_count": 1 } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } } }, "/data-sources/brocade-switches/{id}": { "get": { "tags": [ "Data Sources" ], "summary": "Show brocade switch data source details", "description": "Show brocade switch data source details", "operationId": "getBrocadeSwitch", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/BrocadeSwitchDataSource" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } }, "put": { "tags": [ "Data Sources" ], "summary": "Update a brocade switch data source", "description": "Update a brocade switch data source. Only credentials, nickname and notes can be updated.", "operationId": "updateBrocadeSwitch", "parameters": [ { "in": "body", "name": "body", "schema": { "$ref": "#/definitions/BrocadeSwitchDataSource" } }, { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/BrocadeSwitchDataSource" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } }, "delete": { "tags": [ "Data Sources" ], "summary": "Delete a brocade switch data source", "description": "Delete a brocade switch data source", "operationId": "deleteBrocadeSwitch", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } } }, "/data-sources/brocade-switches/{id}/enable": { "post": { "tags": [ "Data Sources" ], "summary": "Enable a brocade switch data source", "operationId": "enableBrocadeSwitch", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/data-sources/brocade-switches/{id}/disable": { "post": { "tags": [ "Data Sources" ], "summary": "Disable a brocade switch data source", "operationId": "disableBrocadeSwitch", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/data-sources/brocade-switches/{id}/snmp-config": { "get": { "tags": [ "Data Sources" ], "summary": "Show snmp config for brocade switch data source", "description": "Show snmp config for brocade switch data source", "operationId": "getBrocadeSwitchSnmpConfig", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/SNMPConfig" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } }, "put": { "tags": [ "Data Sources" ], "summary": "Update snmp config for brocade switch data source", "description": "Update snmp config for brocade switch data source", "operationId": "updateBrocadeSwitchSnmpConfig", "parameters": [ { "in": "body", "name": "body", "schema": { "$ref": "#/definitions/SNMPConfig" } }, { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/SNMPConfig" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/data-sources/juniper-switches": { "post": { "tags": [ "Data Sources" ], "summary": "Add a juniper switch as data source", "description": "Add switch Datasource", "operationId": "addJuniperSwitch", "parameters": [ { "in": "body", "name": "body", "description": "Add a cisco switch as datasource", "schema": { "$ref": "#/definitions/JuniperSwitchDataSourceRequest" } } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "201": { "schema": { "$ref": "#/definitions/JuniperSwitchDataSource" }, "description": "Created" }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } }, "get": { "tags": [ "Data Sources" ], "summary": "List juniper switch data sources", "description": "List juniper switch data sources", "operationId": "listJuniperSwitches", "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/DataSourceListResponse" }, "examples": { "results": [ { "entity_id": "18230:909:993642895", "entity_type": "JuniperSwitchDataSource" } ], "total_count": 1 } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } } }, "/data-sources/juniper-switches/{id}": { "get": { "tags": [ "Data Sources" ], "summary": "Show juniper switch data source details", "description": "Show juniper switch data source details", "operationId": "getJuniperSwitch", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/JuniperSwitchDataSource" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Unauthorized" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } }, "put": { "tags": [ "Data Sources" ], "summary": "Update a juniper switch data source", "description": "Update a juniper switch data source", "operationId": "updateJuniperSwitch", "parameters": [ { "in": "body", "name": "body", "schema": { "$ref": "#/definitions/JuniperSwitchDataSource" } }, { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/JuniperSwitchDataSource" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } }, "delete": { "tags": [ "Data Sources" ], "summary": "Delete a juniper switch data source", "description": "Delete a juniper switch data source", "operationId": "deleteJuniperSwitch", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } } }, "/data-sources/juniper-switches/{id}/enable": { "post": { "tags": [ "Data Sources" ], "summary": "Enable a juniper switch data source", "description": "Enable a juniper switch data source", "operationId": "enableJuniperSwitch", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/data-sources/juniper-switches/{id}/disable": { "post": { "tags": [ "Data Sources" ], "summary": "Disable a juniper switch data source", "description": "Disable a juniper switch data source", "operationId": "disableJuniperSwitch", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/data-sources/juniper-switches/{id}/snmp-config": { "get": { "tags": [ "Data Sources" ], "summary": "Show snmp config for juniper switch data source", "description": "Show snmp config for juniper switch data source", "operationId": "getJuniperSwitchSnmpConfig", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/SNMPConfig" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } }, "put": { "tags": [ "Data Sources" ], "summary": "Update snmp config for a juniper switch data source", "description": "Update snmp config for a juniper switch data source", "operationId": "updateJuniperSwitchSnmpConfig", "parameters": [ { "in": "body", "name": "body", "schema": { "$ref": "#/definitions/SNMPConfig" } }, { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/SNMPConfig" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/data-sources/arista-switches": { "post": { "tags": [ "Data Sources" ], "summary": "Create an arista switch data source", "description": "Add arista switch data source", "operationId": "addAristaSwitch", "parameters": [ { "in": "body", "name": "body", "description": "Add a cisco switch as datasource", "schema": { "$ref": "#/definitions/AristaSwitchDataSourceRequest" } } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "201": { "schema": { "$ref": "#/definitions/AristaSwitchDataSource" }, "description": "Created" }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } }, "get": { "tags": [ "Data Sources" ], "summary": "List arista switch data sources", "description": "List arista switch data sources", "operationId": "listAristaSwitches", "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/DataSourceListResponse" }, "examples": { "results": [ { "entity_id": "18230:906:993642895", "entity_type": "AristaSwitchDataSource" } ], "total_count": 1 } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } } }, "/data-sources/arista-switches/{id}": { "get": { "tags": [ "Data Sources" ], "summary": "Show arista switch data source details", "description": "Show arista switch data source details", "operationId": "getAristaSwitch", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/AristaSwitchDataSource" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } }, "put": { "tags": [ "Data Sources" ], "summary": "Update an arista switch data source", "description": "Update an switch data source", "operationId": "updateAristaSwitch", "parameters": [ { "in": "body", "name": "body", "schema": { "$ref": "#/definitions/AristaSwitchDataSource" } }, { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/AristaSwitchDataSource" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } }, "delete": { "tags": [ "Data Sources" ], "summary": "Delete an arista switch data source", "description": "Delete an arista switch data source", "operationId": "deleteAristaSwitch", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } } }, "/data-sources/arista-switches/{id}/enable": { "post": { "tags": [ "Data Sources" ], "summary": "Enable an arista switch data source", "description": "Enable an arista switch data source", "operationId": "enableAristaSwitch", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/data-sources/arista-switches/{id}/disable": { "post": { "tags": [ "Data Sources" ], "summary": "Disable an arista switch data source", "description": "Disable an arista switch data source", "operationId": "disableAristaSwitch", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/data-sources/arista-switches/{id}/snmp-config": { "get": { "tags": [ "Data Sources" ], "summary": "Show snmp config for arista switch data source", "description": "Show snmp config for arista switch data source", "operationId": "getAristaSwitchSnmpConfig", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/SNMPConfig" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } }, "put": { "tags": [ "Data Sources" ], "summary": "Update snmp config for arista switch data source", "description": "Update snmp config for arista switch data source", "operationId": "updateAristaSwitchSnmpConfig", "parameters": [ { "in": "body", "name": "body", "schema": { "$ref": "#/definitions/SNMPConfig" } }, { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/SNMPConfig" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/data-sources/checkpoint-firewalls": { "post": { "tags": [ "Data Sources" ], "summary": "Create a checkpoint firewall", "description": "Add checkpoint firewall as data source", "operationId": "addCheckpointFirewall", "parameters": [ { "in": "body", "name": "body", "description": "Add a vSec Checkpoint firewall as data source", "schema": { "$ref": "#/definitions/CheckpointFirewallDataSourceRequest" } } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "201": { "schema": { "$ref": "#/definitions/CheckpointFirewallDataSource" }, "description": "Created" }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } }, "get": { "tags": [ "Data Sources" ], "summary": "List checkpoint firewall data sources", "description": "List checkpoint firewall data sources", "operationId": "listCheckpointFirewalls", "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/DataSourceListResponse" }, "examples": { "results": [ { "entity_id": "18230:910:993642895", "entity_type": "CheckpointFirewallDataSource" } ], "total_count": 1 } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } } }, "/data-sources/checkpoint-firewalls/{id}": { "get": { "tags": [ "Data Sources" ], "summary": "Show checkpoint firewall data source details", "description": "Show checkpoint firewall data source details", "operationId": "getCheckpointFirewall", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/CheckpointFirewallDataSource" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } }, "put": { "tags": [ "Data Sources" ], "summary": "Update a checkpoint firewall data source", "description": "Update a checkpoint firewall data source", "operationId": "updateCheckpointFirewall", "parameters": [ { "in": "body", "name": "body", "schema": { "$ref": "#/definitions/CheckpointFirewallDataSource" } }, { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/CheckpointFirewallDataSource" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } }, "delete": { "tags": [ "Data Sources" ], "summary": "Delete a checkpoint firewall data source", "description": "Delete a checkpoint firewall data source", "operationId": "deleteCheckpointFirewall", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } } }, "/data-sources/checkpoint-firewalls/{id}/enable": { "post": { "tags": [ "Data Sources" ], "summary": "Enable a checkpoint firewall data source", "description": "Enable a checkpoint firewall data source", "operationId": "enableCheckpointFirewall", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/data-sources/checkpoint-firewalls/{id}/disable": { "post": { "tags": [ "Data Sources" ], "summary": "Disable a checkpoint firewall data source", "description": "Disable a checkpoint firewall data source", "operationId": "disableCheckpointFirewall", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/data-sources/panorama-firewalls": { "post": { "tags": [ "Data Sources" ], "summary": "Create panorama firewall data source", "description": "Add panorama firewall as data source", "operationId": "addPanoramaFirewall", "parameters": [ { "in": "body", "name": "body", "description": "Add a panorama firewall as datasource", "schema": { "$ref": "#/definitions/PanFirewallDataSourceRequest" } } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "201": { "schema": { "$ref": "#/definitions/PanFirewallDataSource" }, "description": "Created" }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } }, "get": { "tags": [ "Data Sources" ], "summary": "List panorama firewall data sources", "description": "List panorama firewall data sources", "operationId": "listPanoramaFirewalls", "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/DataSourceListResponse" }, "examples": { "results": [ { "entity_id": "18230:911:993642895", "entity_type": "PanFirewallDataSource" } ], "total_count": 1 } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } } }, "/data-sources/panorama-firewalls/{id}": { "get": { "tags": [ "Data Sources" ], "summary": "Show panorama firewall data source details", "description": "Show panorama firewall data source details", "operationId": "getPanoramaFirewall", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/PanFirewallDataSource" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } }, "put": { "tags": [ "Data Sources" ], "summary": "Update a panorama firewall data source", "description": "Update a panorama firewall data source", "operationId": "updatePanoramaFirewall", "parameters": [ { "in": "body", "name": "body", "schema": { "$ref": "#/definitions/PanFirewallDataSource" } }, { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/PanFirewallDataSource" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } }, "delete": { "tags": [ "Data Sources" ], "summary": "Delete a panorama firewall data source", "description": "Delete a panorama firewall data source", "operationId": "deletePanoramaFirewall", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } } }, "/data-sources/panorama-firewalls/{id}/enable": { "post": { "tags": [ "Data Sources" ], "summary": "Enable a panorama firewall data source", "description": "Enable a panorama firewall data source", "operationId": "enablePanoramaFirewall", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/data-sources/panorama-firewalls/{id}/disable": { "post": { "tags": [ "Data Sources" ], "summary": "Disable a panorama firewall data source", "description": "Disable a panorama firewall data source", "operationId": "disablePanoramaFirewall", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/data-sources/fortinet-firewalls": { "post": { "tags": [ "Data Sources" ], "summary": "Add Fortinet firewall as data source", "description": "Add Fortinet firewall as data source", "operationId": "addFortinetFirewall", "parameters": [ { "in": "body", "name": "body", "description": "Add a Fortinet firewall as data source", "schema": { "$ref": "#/definitions/FortinetFirewallDataSourceRequest" } } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "201": { "schema": { "$ref": "#/definitions/FortinetFirewallDataSource" }, "description": "Created" }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } }, "get": { "tags": [ "Data Sources" ], "summary": "List Fortinet firewall data sources", "description": "List Fortinet firewall data sources", "operationId": "listFortinetFirewalls", "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/DataSourceListResponse" }, "examples": { "results": [ { "entity_id": "18230:910:993642895", "entity_type": "FortinetFirewallDataSource" } ], "total_count": 1 } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } } }, "/data-sources/fortinet-firewalls/{id}": { "get": { "tags": [ "Data Sources" ], "summary": "Show Fortinet firewall data source details", "description": "Show Fortinet firewall data source details", "operationId": "getFortinetFirewall", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/FortinetFirewallDataSource" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } }, "put": { "tags": [ "Data Sources" ], "summary": "Update a Fortinet firewall data source", "description": "Update a Fortinet firewall data source", "operationId": "updateFortinetFirewall", "parameters": [ { "in": "body", "name": "body", "schema": { "$ref": "#/definitions/FortinetFirewallDataSource" } }, { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/FortinetFirewallDataSource" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } }, "delete": { "tags": [ "Data Sources" ], "summary": "Delete a Fortinet firewall data source", "description": "Delete a Fortinet firewall data source", "operationId": "deleteFortinetFirewall", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } } }, "/data-sources/fortinet-firewalls/{id}/enable": { "post": { "tags": [ "Data Sources" ], "summary": "Enable a Fortinet firewall data source", "description": "Enable a Fortinet firewall data source", "operationId": "enableFortinetFirewall", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/data-sources/fortinet-firewalls/{id}/disable": { "post": { "tags": [ "Data Sources" ], "summary": "Disable a Fortinet firewall data source", "description": "Disable a Fortinet firewall data source", "operationId": "disableFortinetFirewall", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/data-sources/ucs-managers": { "post": { "tags": [ "Data Sources" ], "summary": "Create a ucs manager data source", "description": "Add a ucs manager as data source", "operationId": "addUcsManager", "parameters": [ { "in": "body", "name": "body", "schema": { "$ref": "#/definitions/UCSManagerDataSourceRequest" } } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "201": { "schema": { "$ref": "#/definitions/UCSManagerDataSource" }, "description": "Created" }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } }, "get": { "tags": [ "Data Sources" ], "summary": "List ucs manager data sources", "description": "List ucs manager data sources", "operationId": "listUcsManagers", "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/DataSourceListResponse" }, "examples": { "results": [ { "entity_id": "18230:912:993642895", "entity_type": "UCSManagerDataSource" } ], "total_count": 1 } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } } }, "/data-sources/ucs-managers/{id}": { "get": { "tags": [ "Data Sources" ], "summary": "Show ucs manager data source details", "description": "Show ucs manager data source details", "operationId": "getUcsManager", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/UCSManagerDataSource" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } }, "put": { "tags": [ "Data Sources" ], "summary": "Update a ucs manager data source", "description": "Update a ucs manager data source", "operationId": "updateUcsManager", "parameters": [ { "in": "body", "name": "body", "schema": { "$ref": "#/definitions/UCSManagerDataSource" } }, { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/UCSManagerDataSource" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } }, "delete": { "tags": [ "Data Sources" ], "summary": "Delete a ucs manager data source", "description": "Delete a ucs manager data source", "operationId": "deleteUcsManager", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } } }, "/data-sources/ucs-managers/{id}/enable": { "post": { "tags": [ "Data Sources" ], "summary": "Enable a ucs manager data source", "description": "Enable a ucs manager data source", "operationId": "enableUcsManager", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/data-sources/ucs-managers/{id}/disable": { "post": { "tags": [ "Data Sources" ], "summary": "Disable a ucs manager data source", "description": "Disable a ucs manager data source", "operationId": "disableUcsManager", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/data-sources/ucs-managers/{id}/snmp-config": { "get": { "tags": [ "Data Sources" ], "summary": "Show snmp config for ucs fabric interconnects", "description": "Show snmp config for ucs fabric interconnects", "operationId": "getUcsSnmpConfig", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/SNMPConfig" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } }, "put": { "tags": [ "Data Sources" ], "summary": "Update snmp config for ucs fabric interconnects", "description": "Update snmp config for ucs fabric interconnects", "operationId": "updateUcsSnmpConfig", "parameters": [ { "in": "body", "name": "body", "schema": { "$ref": "#/definitions/SNMPConfig" } }, { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/SNMPConfig" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/data-sources/cisco-aci": { "post": { "tags": [ "Data Sources" ], "summary": "Create a Cisco ACI data source", "description": "Add a Cisco ACI as data source", "operationId": "addCiscoACI", "parameters": [ { "in": "body", "name": "body", "schema": { "$ref": "#/definitions/CiscoACIDataSourceRequest" } } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "201": { "schema": { "$ref": "#/definitions/CiscoACIDataSource" }, "description": "Created" }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } }, "get": { "tags": [ "Data Sources" ], "summary": "List Cisco ACI data sources", "description": "List Cisco ACI data sources", "operationId": "listCiscoACI", "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/DataSourceListResponse" }, "examples": { "results": [ { "entity_id": "18230:912:993642895", "entity_type": "CiscoACIDataSource" } ], "total_count": 1 } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } } }, "/data-sources/cisco-aci/{id}": { "get": { "tags": [ "Data Sources" ], "summary": "Show Cisco ACI data source details", "description": "Show Cisco ACI data source details", "operationId": "getCiscoACI", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/CiscoACIDataSource" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } }, "put": { "tags": [ "Data Sources" ], "summary": "Update a cisco aci data source", "description": "Update a Cisco ACI data source", "operationId": "updateCiscoACIManager", "parameters": [ { "in": "body", "name": "body", "schema": { "$ref": "#/definitions/CiscoACIDataSource" } }, { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/CiscoACIDataSource" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } }, "delete": { "tags": [ "Data Sources" ], "summary": "Delete a Cisco ACI data source", "description": "Delete a Cisco ACI data source", "operationId": "deleteCiscoACI", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } } }, "/data-sources/cisco-aci/{id}/enable": { "post": { "tags": [ "Data Sources" ], "summary": "Enable a Cisco ACI data source", "description": "Enable a Cisco ACI data source", "operationId": "enableCiscoACI", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/data-sources/cisco-aci/{id}/disable": { "post": { "tags": [ "Data Sources" ], "summary": "Disable a Cisco ACI data source", "description": "Disable a Cisco ACI data source", "operationId": "disableCiscoACI", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/data-sources/cisco-aci/{id}/snmp-config": { "get": { "tags": [ "Data Sources" ], "summary": "Show snmp config for Cisco ACI", "description": "Show snmp config for Cisco ACI", "operationId": "getCiscoACISnmpConfig", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/SNMPConfig" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } }, "put": { "tags": [ "Data Sources" ], "summary": "Update snmp config for Cisco ACI", "description": "Update snmp config for Cisco ACI", "operationId": "updateCiscoACISnmpConfig", "parameters": [ { "in": "body", "name": "body", "schema": { "$ref": "#/definitions/SNMPConfig" } }, { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/SNMPConfig" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/data-sources/hpvc-managers": { "post": { "tags": [ "Data Sources" ], "summary": "Create a hpvc manager data source", "description": "Add hpvc manager data source", "operationId": "addHpvcManager", "parameters": [ { "in": "body", "name": "body", "description": "Add a switch as datasource", "schema": { "$ref": "#/definitions/HPVCManagerDataSourceRequest" } } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "201": { "schema": { "$ref": "#/definitions/HPVCManagerDataSource" }, "description": "Created" }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } }, "get": { "tags": [ "Data Sources" ], "summary": "List hpvc manager data sources", "description": "List hpvc manager data sources", "operationId": "listHpvcManagers", "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/DataSourceListResponse" }, "examples": { "results": [ { "entity_id": "18230:914:993642895", "entity_type": "HPVCManagerDataSource" } ], "total_count": 1 } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } } }, "/data-sources/hpvc-managers/{id}": { "get": { "tags": [ "Data Sources" ], "summary": "Show hpvc data source details", "description": "Show hpvc data source details", "operationId": "getHpvcManager", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/HPVCManagerDataSource" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } }, "put": { "tags": [ "Data Sources" ], "summary": "Update a hpvc manager data source", "description": "Update a hpvc manager data source", "operationId": "updateHpvcManager", "parameters": [ { "in": "body", "name": "body", "schema": { "$ref": "#/definitions/HPVCManagerDataSource" } }, { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/HPVCManagerDataSource" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } }, "delete": { "tags": [ "Data Sources" ], "summary": "Delete a hpvc manager data source", "description": "Delete a hpvc manager data source", "operationId": "deleteHpvcManager", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } } }, "/data-sources/hpvc-managers/{id}/enable": { "post": { "tags": [ "Data Sources" ], "summary": "Enable a hpvc manager data source", "description": "Enable a hpvc manager data source", "operationId": "enableHpvcManager", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/data-sources/hpvc-managers/{id}/disable": { "post": { "tags": [ "Data Sources" ], "summary": "Disable a hpvc manager data source", "description": "Disable a hpvc manager data source", "operationId": "disableHpvcManager", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/data-sources/hpov-managers": { "post": { "tags": [ "Data Sources" ], "summary": "Create a hp oneview manager data source", "description": "Add a hp oneview manager data source", "operationId": "addHpovManager", "parameters": [ { "in": "body", "name": "body", "schema": { "$ref": "#/definitions/HPOneViewManagerDataSourceRequest" } } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "201": { "schema": { "$ref": "#/definitions/HPOneViewManagerDataSource" }, "description": "Created" }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } }, "get": { "tags": [ "Data Sources" ], "summary": "List hp oneview manager data sources", "description": "List hp oneview manager data sources", "operationId": "listHpovManagers", "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/DataSourceListResponse" }, "examples": { "results": [ { "entity_id": "18230:915:993642895", "entity_type": "HPOneViewManagerDataSource" } ], "total_count": 1 } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } } }, "/data-sources/hpov-managers/{id}": { "get": { "tags": [ "Data Sources" ], "summary": "Show hp oneview data source details", "description": "Show hp oneview data source details", "operationId": "getHpovManager", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/HPOneViewManagerDataSource" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } }, "put": { "tags": [ "Data Sources" ], "summary": "Update a hp oneview data source", "description": "Update a hp oneview data source", "operationId": "updateHpovManager", "parameters": [ { "in": "body", "name": "body", "schema": { "$ref": "#/definitions/HPOneViewManagerDataSource" } }, { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/HPOneViewManagerDataSource" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } }, "delete": { "tags": [ "Data Sources" ], "summary": "Delete a hp oneview data source", "description": "Delete a hp oneview data source", "operationId": "deleteHpovManager", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } } }, "/data-sources/hpov-managers/{id}/enable": { "post": { "tags": [ "Data Sources" ], "summary": "Enable a hp oneview data source", "description": "Enable a hp oneview data source", "operationId": "enableHpovManager", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/data-sources/hpov-managers/{id}/disable": { "post": { "tags": [ "Data Sources" ], "summary": "Disable a hp oneview data source", "description": "Disable a hp oneview data source", "operationId": "disableHpovManager", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/data-sources/nsxt-managers": { "post": { "tags": [ "Data Sources" ], "summary": "Create an nsx-t manager data source", "description": "Add an nsx-t manager data source", "operationId": "addNsxtManagerDatasource", "parameters": [ { "in": "body", "name": "body", "schema": { "$ref": "#/definitions/NSXTManagerDataSourceRequest" } } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "201": { "description": "Created", "schema": { "$ref": "#/definitions/NSXTManagerDataSource" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } }, "get": { "tags": [ "Data Sources" ], "summary": "List nsx-t manager data sources", "description": "List nsx-t manager data sources", "operationId": "listNsxtManagers", "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/DataSourceListResponse" }, "examples": { "results": [ { "entity_id": "18230:903:993642895", "entity_type": "NSXTManagerDataSource" } ], "total_count": 1 } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } } }, "/data-sources/nsxt-managers/{id}": { "get": { "tags": [ "Data Sources" ], "summary": "Show nsx-t manager data source details", "description": "Show nsx-t manager data source details", "operationId": "getNsxtManager", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/NSXTManagerDataSource" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } }, "put": { "tags": [ "Data Sources" ], "summary": "Update an nsx-t manager data source", "description": "Update an nsx-t manager data source", "operationId": "updateNsxtManager", "parameters": [ { "in": "body", "name": "body", "schema": { "$ref": "#/definitions/NSXTManagerDataSource" } }, { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/NSXTManagerDataSource" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } }, "delete": { "tags": [ "Data Sources" ], "summary": "Delete an nsx-t manager data source", "description": "Delete an nsx-t manager data source", "operationId": "deleteNsxtManager", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } } }, "/data-sources/nsxt-managers/{id}/enable": { "post": { "tags": [ "Data Sources" ], "summary": "Enable an nsx-t manager data source", "description": "Enable an nsx-t manager data source", "operationId": "enableNsxtManager", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/data-sources/nsxt-managers/{id}/disable": { "post": { "tags": [ "Data Sources" ], "summary": "Disable an nsx-t manager data source", "description": "Disable an nsx-t manager data source", "operationId": "disableNsxtManager", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/data-sources/pks": { "post": { "tags": [ "Data Sources" ], "summary": "Create an pks data source", "description": "Add an pks data source", "operationId": "addPKSDatasource", "parameters": [ { "in": "body", "name": "body", "schema": { "$ref": "#/definitions/PKSDataSourceRequest" } } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "201": { "description": "Created", "schema": { "$ref": "#/definitions/PKSDataSource" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } }, "get": { "tags": [ "Data Sources" ], "summary": "List pks data sources", "description": "List pks data sources", "operationId": "listPKS", "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/DataSourceListResponse" }, "examples": { "results": [ { "entity_id": "18230:903:993642895", "entity_type": "PKSDataSource" } ], "total_count": 1 } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } } }, "/data-sources/pks/{id}": { "get": { "tags": [ "Data Sources" ], "summary": "Show pks data source details", "description": "Show pks data source details", "operationId": "getPKS", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/PKSDataSource" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } }, "put": { "tags": [ "Data Sources" ], "summary": "Update an pks data source", "description": "Update an pks data source", "operationId": "updatePKS", "parameters": [ { "in": "body", "name": "body", "schema": { "$ref": "#/definitions/PKSDataSource" } }, { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/PKSDataSource" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } }, "delete": { "tags": [ "Data Sources" ], "summary": "Delete an pks data source", "description": "Delete an pks data source", "operationId": "deletePKS", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } } }, "/data-sources/pks/{id}/enable": { "post": { "tags": [ "Data Sources" ], "summary": "Enable an pks data source", "description": "Enable an pks data source", "operationId": "enablePKS", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/data-sources/pks/{id}/disable": { "post": { "tags": [ "Data Sources" ], "summary": "Disable an pks data source", "description": "Disable an pks data source", "operationId": "disablePKS", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/data-sources/nsxv-managers": { "post": { "tags": [ "Data Sources" ], "summary": "Create an nsx-v manager data source", "description": "Add an nsx-v manager data source", "operationId": "addNsxvManagerDatasource", "parameters": [ { "in": "body", "name": "body", "schema": { "$ref": "#/definitions/NSXVManagerDataSourceRequest" } } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "201": { "description": "Created", "schema": { "$ref": "#/definitions/NSXVManagerDataSource" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } }, "get": { "tags": [ "Data Sources" ], "summary": "List nsx-v manager data sources", "description": "List nsx-v manager data sources", "operationId": "listNsxvManagers", "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/DataSourceListResponse" }, "examples": { "results": [ { "entity_id": "18230:903:993642895", "entity_type": "NSXVManagerDataSource" } ], "total_count": 1 } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } } }, "/data-sources/nsxv-managers/{id}": { "get": { "tags": [ "Data Sources" ], "summary": "Show nsx-v manager data source details", "description": "Show nsx-v manager data source details", "operationId": "getNsxvManager", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/NSXVManagerDataSource" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } }, "put": { "tags": [ "Data Sources" ], "summary": "Update an nsx-v manager data source", "description": "Update an nsx-v manager data source", "operationId": "updateNsxvManager", "parameters": [ { "in": "body", "name": "body", "schema": { "$ref": "#/definitions/NSXVManagerDataSource" } }, { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/NSXVManagerDataSource" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } }, "delete": { "tags": [ "Data Sources" ], "summary": "Delete an nsx-v manager data source", "description": "Delete an nsx-v manager data source", "operationId": "deleteNsxvManager", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } } }, "/data-sources/nsxv-managers/{id}/enable": { "post": { "tags": [ "Data Sources" ], "summary": "Enable an nsx-v manager data source", "description": "Enable an nsx-v manager data source", "operationId": "enableNsxvManager", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/data-sources/nsxv-managers/{id}/disable": { "post": { "tags": [ "Data Sources" ], "summary": "Disable an nsx-v manager data source", "description": "Disable an nsx-v manager data source", "operationId": "disableNsxvManager", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/data-sources/nsxv-managers/{id}/controller-cluster": { "get": { "tags": [ "Data Sources" ], "summary": "Show nsx controller-cluster details", "description": "Show nsx controller-cluster details", "operationId": "getNsxvControllerCluster", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/NSXControllerDataCollection" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } }, "put": { "tags": [ "Data Sources" ], "summary": "Update nsx controller-cluster details", "description": "Update nsx controller-cluster details", "operationId": "updateNsxvControllerCluster", "parameters": [ { "in": "body", "name": "body", "schema": { "$ref": "#/definitions/NSXControllerDataCollection" } }, { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/NSXControllerDataCollection" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/data-sources/kubernetes-clusters": { "post": { "tags": [ "Data Sources" ], "summary": "Create an kubernetes cluster data source", "description": "Add an kubernetes cluster data source", "operationId": "addKubernetesDatasource", "parameters": [ { "in": "body", "name": "body", "schema": { "$ref": "#/definitions/KubernetesDataSourceRequest" } } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "201": { "description": "Created", "schema": { "$ref": "#/definitions/KubernetesDataSource" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } }, "get": { "tags": [ "Data Sources" ], "summary": "List kubernetes cluster data sources", "description": "List kubernetes cluster data sources", "operationId": "listKubernetesClusters", "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/DataSourceListResponse" }, "examples": { "results": [ { "entity_id": "18230:903:993642895", "entity_type": "KubernetesDataSource" } ], "total_count": 1 } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } } }, "/data-sources/kubernetes-clusters/{id}": { "get": { "tags": [ "Data Sources" ], "summary": "Show kubernetes cluster data source details", "description": "Show kubernetes cluster data source details", "operationId": "getKubernetesCluster", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/KubernetesDataSource" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } }, "put": { "tags": [ "Data Sources" ], "summary": "Update an kubernetes cluster data source", "description": "Update an kubernetes cluster data source", "operationId": "updateKubernetesCluster", "parameters": [ { "in": "body", "name": "body", "schema": { "$ref": "#/definitions/KubernetesDataSource" } }, { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/KubernetesDataSource" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } }, "delete": { "tags": [ "Data Sources" ], "summary": "Delete an kubernetes cluster data source", "description": "Delete an kubernetes cluster data source", "operationId": "deleteKubernetesCluster", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } } }, "/data-sources/kubernetes-clusters/{id}/enable": { "post": { "tags": [ "Data Sources" ], "summary": "Enable an kubernetes cluster data source", "description": "Enable an kubernetes cluster data source", "operationId": "enableKubernetesCluster", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/data-sources/kubernetes-clusters/{id}/disable": { "post": { "tags": [ "Data Sources" ], "summary": "Disable an kubernetes cluster data source", "description": "Disable an kubernetes cluster data source", "operationId": "disableKubernetesCluster", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/data-sources/openshift-clusters": { "post": { "tags": [ "Data Sources" ], "summary": "Create an Openshift data source", "description": "Add an openshift data source", "operationId": "addOpenshiftDatasource", "parameters": [ { "in": "body", "name": "body", "schema": { "$ref": "#/definitions/KubernetesDataSourceRequest" } } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "201": { "description": "Created", "schema": { "$ref": "#/definitions/KubernetesDataSource" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } }, "get": { "tags": [ "Data Sources" ], "summary": "List openshift data sources", "description": "List openshift data sources", "operationId": "listOpenshiftClusters", "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/DataSourceListResponse" }, "examples": { "results": [ { "entity_id": "18230:903:993642895", "entity_type": "KubernetesDataSource" } ], "total_count": 1 } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } } }, "/data-sources/openshift-clusters/{id}": { "get": { "tags": [ "Data Sources" ], "summary": "Show Openshift cluster data source details", "description": "Show openshift data source details", "operationId": "getOpenshiftCluster", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/KubernetesDataSource" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } }, "put": { "tags": [ "Data Sources" ], "summary": "Update an openshift data source", "description": "Update an openshift data source", "operationId": "updateOpenshiftCluster", "parameters": [ { "in": "body", "name": "body", "schema": { "$ref": "#/definitions/KubernetesDataSource" } }, { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/KubernetesDataSource" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } }, "delete": { "tags": [ "Data Sources" ], "summary": "Delete an openshift data source", "description": "Delete an openshift data source", "operationId": "deleteOpenshiftCluster", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } } }, "/data-sources/openshift-clusters/{id}/enable": { "post": { "tags": [ "Data Sources" ], "summary": "Enable an openshift data source", "description": "Enable an openshift data source", "operationId": "enableOpenshiftCluster", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/data-sources/openshift-clusters/{id}/disable": { "post": { "tags": [ "Data Sources" ], "summary": "Disable an openshift data source", "description": "Disable an openshift data source", "operationId": "disableOpenshiftCluster", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/data-sources/servicenow-instances": { "post": { "tags": [ "Data Sources" ], "summary": "Create an ServiceNow instance data source", "description": "Add an ServiceNow instance data source", "operationId": "addServiceNowDatasource", "parameters": [ { "in": "body", "name": "body", "schema": { "$ref": "#/definitions/ServiceNowDataSourceRequest" } } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "201": { "description": "Created", "schema": { "$ref": "#/definitions/ServiceNowDataSource" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } }, "get": { "tags": [ "Data Sources" ], "summary": "List ServiceNow instance data sources", "description": "List ServiceNow instance data sources", "operationId": "listServiceNowInstances", "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/DataSourceListResponse" }, "examples": { "results": [ { "entity_id": "18230:903:993642895", "entity_type": "ServiceNowDataSource" } ], "total_count": 1 } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } } }, "/data-sources/servicenow-instances/{id}": { "get": { "tags": [ "Data Sources" ], "summary": "Show ServiceNow instance data source details", "description": "Show ServiceNow instance data source details", "operationId": "getServiceNowInstance", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/ServiceNowDataSource" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } }, "put": { "tags": [ "Data Sources" ], "summary": "Update an ServiceNow instance data source", "description": "Update an ServiceNow instance data source", "operationId": "updateServiceNowInstance", "parameters": [ { "in": "body", "name": "body", "schema": { "$ref": "#/definitions/ServiceNowDataSource" } }, { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/ServiceNowDataSource" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } }, "delete": { "tags": [ "Data Sources" ], "summary": "Delete an ServiceNow instance data source", "description": "Delete an ServiceNow instance data source", "operationId": "deleteServiceNowInstance", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } } }, "/data-sources/servicenow-instances/{id}/enable": { "post": { "tags": [ "Data Sources" ], "summary": "Enable an ServiceNow instance data source", "description": "Enable an ServiceNow instance data source", "operationId": "enableServiceNowInstance", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/data-sources/servicenow-instances/{id}/disable": { "post": { "tags": [ "Data Sources" ], "summary": "Disable an ServiceNow instance data source", "description": "Disable an ServiceNow instance data source", "operationId": "disableServiceNowInstance", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/data-sources/infoblox-managers": { "post": { "tags": [ "Data Sources" ], "summary": "Create an infoblox manager data source", "description": "Add an infoblox manager data source", "operationId": "addInfobloxManagerDatasource", "parameters": [ { "in": "body", "name": "body", "schema": { "$ref": "#/definitions/InfobloxManagerDataSourceRequest" } } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "201": { "description": "Created", "schema": { "$ref": "#/definitions/InfobloxManagerDataSource" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } }, "get": { "tags": [ "Data Sources" ], "summary": "List infoblox manager data sources", "description": "List infoblox manager data sources", "operationId": "listInfobloxManagers", "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/DataSourceListResponse" }, "examples": { "results": [ { "entity_id": "18230:903:993642895", "entity_type": "InfobloxManagerDataSource" } ], "total_count": 1 } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } } }, "/data-sources/infoblox-managers/{id}": { "get": { "tags": [ "Data Sources" ], "summary": "Show infoblox manager data source details", "description": "Show infoblox manager data source details", "operationId": "getInfobloxManager", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/InfobloxManagerDataSource" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } }, "put": { "tags": [ "Data Sources" ], "summary": "Update an infoblox manager data source", "description": "Update an infoblox manager data source", "operationId": "updateInfobloxManager", "parameters": [ { "in": "body", "name": "body", "schema": { "$ref": "#/definitions/InfobloxManagerDataSource" } }, { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/InfobloxManagerDataSource" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } }, "delete": { "tags": [ "Data Sources" ], "summary": "Delete an infoblox manager data source", "description": "Delete an infoblox manager data source", "operationId": "deleteInfobloxManager", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } } }, "/data-sources/infoblox-managers/{id}/enable": { "post": { "tags": [ "Data Sources" ], "summary": "Enable an infoblox manager data source", "description": "Enable an infoblox manager data source", "operationId": "enableInfobloxManager", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/data-sources/infoblox-managers/{id}/disable": { "post": { "tags": [ "Data Sources" ], "summary": "Disable an infoblox manager data source", "description": "Disable an infoblox manager data source", "operationId": "disableInfobloxManager", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/data-sources/vmc-nsxmanagers": { "post": { "tags": [ "Data Sources" ], "summary": "Create a vmc nsx manager data source", "description": "Add a vmc nsx manager data source", "operationId": "addPolicyManagerDatasource", "parameters": [ { "in": "body", "name": "body", "schema": { "$ref": "#/definitions/PolicyManagerDataSourceRequest" } } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "201": { "description": "Created", "schema": { "$ref": "#/definitions/PolicyManagerDataSource" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } }, "get": { "tags": [ "Data Sources" ], "summary": "List vmc nsx manager data sources", "description": "List vmc nsx manager data sources", "operationId": "listPolicyManagers", "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/DataSourceListResponse" }, "examples": { "results": [ { "entity_id": "18230:928:993642895", "entity_type": "PolicyManagerDataSource" } ], "total_count": 1 } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } } }, "/data-sources/vmc-nsxmanagers/{id}": { "get": { "tags": [ "Data Sources" ], "summary": "Show vmc nsx manager data source details", "description": "Show vmc nsx manager data source details", "operationId": "getPolicyManager", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/PolicyManagerDataSource" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } }, "put": { "tags": [ "Data Sources" ], "summary": "Update a vmc nsx manager data source", "description": "Update a vmc nsx manager data source", "operationId": "updatePolicyManager", "parameters": [ { "in": "body", "name": "body", "schema": { "$ref": "#/definitions/PolicyManagerDataSource" } }, { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/PolicyManagerDataSource" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } }, "delete": { "tags": [ "Data Sources" ], "summary": "Delete a vmc nsx manager data source", "description": "Delete a vmc nsx manager data source", "operationId": "deletePolicyManager", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } } }, "/data-sources/vmc-nsxmanagers/{id}/enable": { "post": { "tags": [ "Data Sources" ], "summary": "Enable a vmc nsx manager data source", "description": "Enable a vmc nsx manager data source", "operationId": "enablePolicyManager", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/data-sources/vmc-nsxmanagers/{id}/disable": { "post": { "tags": [ "Data Sources" ], "summary": "Disable a vmc nsx manager data source", "description": "Disable a vmc nsx manager data source", "operationId": "disablePolicyManager", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/data-sources/azure-subscriptions": { "post": { "tags": [ "Data Sources" ], "summary": "Create an azure data source", "description": "Add an azure data source", "operationId": "addAzureDatasource", "parameters": [ { "in": "body", "name": "body", "schema": { "$ref": "#/definitions/AzureDataSourceRequest" } } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "201": { "description": "Created", "schema": { "$ref": "#/definitions/AzureDataSource" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } }, "get": { "tags": [ "Data Sources" ], "summary": "List azure data sources", "description": "List azure data sources", "operationId": "listAzureSubscriptions", "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/DataSourceListResponse" }, "examples": { "results": [ { "entity_id": "18230:966:993642895", "entity_type": "AzureDataSource" } ], "total_count": 1 } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } } }, "/data-sources/azure-subscriptions/{id}": { "get": { "tags": [ "Data Sources" ], "summary": "Show azure data source details", "description": "Show azure data source details", "operationId": "getAzureSubscriptions", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/AzureDataSource" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } }, "put": { "tags": [ "Data Sources" ], "summary": "Update an azure data source", "description": "Update an azure data source", "operationId": "updateAzureSubscription", "parameters": [ { "in": "body", "name": "body", "schema": { "$ref": "#/definitions/AzureDataSource" } }, { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/AzureDataSource" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } }, "delete": { "tags": [ "Data Sources" ], "summary": "Delete an azure data source", "description": "Delete an azure data source", "operationId": "deleteAzureSubscription", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } } }, "/data-sources/azure-subscriptions/{id}/enable": { "post": { "tags": [ "Data Sources" ], "summary": "Enable an azure data source", "description": "Enable an azure data source", "operationId": "enableAzureSubscription", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/data-sources/azure-subscriptions/{id}/disable": { "post": { "tags": [ "Data Sources" ], "summary": "Disable an azure data source", "description": "Disable an azure data source", "operationId": "disableAzureSubscription", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/data-sources/velocloud": { "post": { "tags": [ "Data Sources" ], "summary": "Create a velocloud data source", "description": "Add a velocloud data source", "operationId": "addVeloCloudDatasource", "parameters": [ { "in": "body", "name": "body", "schema": { "$ref": "#/definitions/VeloCloudDataSourceRequest" } } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "201": { "description": "Created", "schema": { "$ref": "#/definitions/VeloCloudDataSource" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } }, "get": { "tags": [ "Data Sources" ], "summary": "List velocloud data sources", "description": "List velocloud data sources", "operationId": "listVeloCloud", "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/DataSourceListResponse" }, "examples": { "results": [ { "entity_id": "18230:962:993642895", "entity_type": "VeloCloudDataSource" } ], "total_count": 1 } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } } }, "/data-sources/velocloud/{id}": { "get": { "tags": [ "Data Sources" ], "summary": "Show velocloud data source details", "description": "Show velocloud data source details", "operationId": "getVeloCloud", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/VeloCloudDataSource" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } }, "put": { "tags": [ "Data Sources" ], "summary": "Update a velocloud data source", "description": "Update a velocloud data source", "operationId": "updateVeloCloud", "parameters": [ { "in": "body", "name": "body", "schema": { "$ref": "#/definitions/VeloCloudDataSource" } }, { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/VeloCloudDataSource" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } }, "delete": { "tags": [ "Data Sources" ], "summary": "Delete a velocloud data source", "description": "Delete a velocloud data source", "operationId": "deleteVeloCloud", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } } }, "/data-sources/velocloud/{id}/enable": { "post": { "tags": [ "Data Sources" ], "summary": "Enable a velocloud data source", "description": "Enable a velocloud data source", "operationId": "enableVeloCloud", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/data-sources/velocloud/{id}/disable": { "post": { "tags": [ "Data Sources" ], "summary": "Disable a velocloud data source", "description": "Disable a velocloud data source", "operationId": "disableVeloCloud", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/entities/problems": { "get": { "tags": [ "Entities" ], "summary": "List problems", "description": "List problem events.", "operationId": "listProblemEvents", "parameters": [ { "$ref": "#/parameters/Size" }, { "$ref": "#/parameters/Cursor" }, { "$ref": "#/parameters/StartTime" }, { "$ref": "#/parameters/EndTime" }, { "$ref": "#/parameters/EventType" }, { "$ref": "#/parameters/EventTags" }, { "$ref": "#/parameters/EventStatus" }, { "$ref": "#/parameters/UpdateTimeFrom" }, { "$ref": "#/parameters/UpdateTimeTo" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/PagedListResponseWithTime" }, "examples": { "results": [ { "entity_id": "18230:35230:1233393386", "entity_type": "ProblemEvent", "time": 1509283820 }, { "entity_id": "18230:35228:1832167524", "entity_type": "ProblemEvent", "time": 1509285022 } ], "cursor": "MTA=", "total_count": 15, "start_time": 1509231996, "end_time": 1509318396 } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "500": { "description": "Internal Error" } } } }, "/entities/problems/fetch": { "post": { "tags": [ "Entities" ], "summary": "Get details of problem events", "description": "Bulk fetch of problems. Max batch size is 1000.", "operationId": "bulkFetchProblemEvents", "parameters": [ { "in": "body", "name": "body", "schema": { "$ref": "#/definitions/FetchRequest" } } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/BulkProblemFetchResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "500": { "description": "Internal Error" } } } }, "/entities/problems/{id}": { "get": { "tags": [ "Entities" ], "summary": "Show problem details", "description": "Show problem event details.", "operationId": "getProblemEvent", "parameters": [ { "$ref": "#/parameters/Identifier" }, { "$ref": "#/parameters/Time" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/ProblemEvent" }, "examples": { "entity_id": "18230:36050:1583312594", "name": "NSXFirewallDefaultAllowAllRulesEvent", "entity_type": "ProblemEvent", "anchor_entities": [ { "entity_id": "18230:39:660899929", "entity_type": "NSXDistributedFirewall" } ], "related_entities": [ { "entity_id": "18230:7:824494449", "entity_type": "NSXVManager" }, { "entity_id": "18230:87:367271162", "entity_type": "NSXFirewallRule" }, { "entity_id": "18230:39:660899929", "entity_type": "NSXDistributedFirewall" } ], "message": "The distributed firewall is configured to allow all traffic by default, which increases the potential attack surface of the network", "event_tags": [ "Best Practices", "Firewall" ], "admin_state": "ENABLED", "archived": false, "event_time_epoch_ms": 1509283819834, "severity": "INFO" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/entities/vms": { "get": { "tags": [ "Entities" ], "summary": "List vms", "description": "List vms", "operationId": "listVms", "parameters": [ { "$ref": "#/parameters/Size" }, { "$ref": "#/parameters/Cursor" }, { "$ref": "#/parameters/StartTime" }, { "$ref": "#/parameters/EndTime" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/PagedListResponseWithTime" }, "examples": { "results": [ { "entity_id": "18230:1:1158969162", "entity_type": "VirtualMachine", "time": 1509283414 }, { "entity_id": "18230:1:875338851", "entity_type": "VirtualMachine", "time": 1509283476 } ], "cursor": "MTA=", "total_count": 39, "start_time": 1509335034, "end_time": 1509335034 } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "500": { "description": "Internal Error" } } } }, "/entities/vms/{id}": { "get": { "tags": [ "Entities" ], "summary": "Show vm details", "description": "Show vm details", "operationId": "getVm", "parameters": [ { "$ref": "#/parameters/Identifier" }, { "$ref": "#/parameters/Time" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/BaseVirtualMachine" }, "examples": { "entity_id": "18230:1:1158969162", "name": "NSX_Controller_9e80ec74-57ce-4671-8fd7-b5884a997535", "entity_type": "VirtualMachine", "ip_addresses": [ { "ip_address": "10.197.17.74", "netmask": "255.255.255.0", "network_address": "10.197.17.0/24" } ], "default_gateway": "", "vnics": [ { "entity_id": "18230:18:863301374", "entity_type": "Vnic" } ], "security_groups": [ ], "source_firewall_rules": [ ], "destination_firewall_rules": [ ], "ip_sets": [ ], "cluster": { "entity_id": "18230:66:1293137396", "entity_type": "Cluster" }, "resource_pool": { "entity_id": "18230:79:313158344", "entity_type": "ResourcePool" }, "security_tags": [ ], "layer2_networks": [ ], "host": { "entity_id": "18230:4:652218965", "entity_type": "Host" }, "vlans": [ ], "vendor_id": "vm-181", "vcenter_manager": { "entity_id": "18230:8:2048038620", "entity_type": "VCenterManager" }, "folders": [ { "entity_id": "18230:81:520432789", "entity_type": "Folder" } ], "datastores": [ { "entity_id": "18230:80:682061552", "entity_type": "Datastore" } ], "datacenter": { "entity_id": "18230:105:1663983066", "entity_type": "VCDatacenter" }, "nsx_manager": null, "source_inversion_rules": [ ], "destination_inversion_rules": [ ] } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/entities/fetch": { "post": { "tags": [ "Entities" ], "summary": "Get details of entities", "description": "Bulk fetch of entities. Max batch size is 1000.", "parameters": [ { "in": "body", "name": "body", "schema": { "$ref": "#/definitions/FetchRequest" } } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/BulkFetchResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "500": { "description": "Internal Error" } } } }, "/entities/vnics": { "get": { "tags": [ "Entities" ], "summary": "List vnics", "description": "List vnics", "operationId": "listVnics", "parameters": [ { "$ref": "#/parameters/Size" }, { "$ref": "#/parameters/Cursor" }, { "$ref": "#/parameters/StartTime" }, { "$ref": "#/parameters/EndTime" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/PagedListResponseWithTime" }, "examples": { "results": [ { "entity_id": "18230:18:1158969162", "entity_type": "Vnic", "time": 1509283414 }, { "entity_id": "18230:18:875338851", "entity_type": "Vnic", "time": 1509283476 } ], "cursor": "MTA=", "total_count": 39, "start_time": 1509335034, "end_time": 1509335034 } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "500": { "description": "Internal Error" } } } }, "/entities/vnics/{id}": { "get": { "tags": [ "Entities" ], "summary": "Show vnic details", "description": "Show vnic details", "operationId": "getVnic", "parameters": [ { "$ref": "#/parameters/Identifier" }, { "$ref": "#/parameters/Time" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/BaseVnic" }, "examples": { "entity_id": "18230:18:1285494944", "name": "[USA Edge-0]-[Network adapter 8]", "entity_type": "Vnic", "ip_addresses": [ ], "layer2_network": null, "vlan": { "begin": 0, "end": 0 }, "vm": { "entity_id": "18230:1:1158972882", "entity_type": "VirtualMachine" } } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/entities/hosts": { "get": { "tags": [ "Entities" ], "summary": "List hosts", "description": "List hosts", "operationId": "listHosts", "parameters": [ { "$ref": "#/parameters/Size" }, { "$ref": "#/parameters/Cursor" }, { "$ref": "#/parameters/StartTime" }, { "$ref": "#/parameters/EndTime" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/PagedListResponseWithTime" }, "examples": { "results": [ { "entity_id": "18230:4:652218965", "entity_type": "Host", "time": 1509283414 }, { "entity_id": "18230:4:1256074202", "entity_type": "Host", "time": 1509283414 } ], "cursor": null, "total_count": 6, "start_time": 1509336095, "end_time": 1509336095 } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "500": { "description": "Internal Error" } } } }, "/entities/hosts/{id}": { "get": { "tags": [ "Entities" ], "summary": "Show host details", "description": "Show host details", "operationId": "getHost", "parameters": [ { "$ref": "#/parameters/Time" }, { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/Host" }, "examples": { "entity_id": "18230:4:1256074202", "name": "10.197.17.228", "entity_type": "Host", "vmknics": [ { "entity_id": "18230:17:1776349286", "entity_type": "Vmknic" } ], "cluster": { "entity_id": "18230:66:1293137396", "entity_type": "Cluster" }, "vcenter_manager": { "entity_id": "18230:8:2048038620", "entity_type": "VCenterManager" }, "vm_count": 0, "datastores": [ { "entity_id": "18230:80:330903629", "entity_type": "Datastore" } ], "service_tag": "VMware-42 14 cd 9f f0 c8 0f 77-6a 53 71 8c 6d d6 e3 ff", "vendor_id": "host-202", "nsx_manager": null, "maintenance_mode": "NOTINMAINTENANCEMODE", "connection_state": "CONNECTED" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/entities/clusters": { "get": { "tags": [ "Entities" ], "summary": "List clusters", "description": "List clusters", "operationId": "listClusters", "parameters": [ { "$ref": "#/parameters/Size" }, { "$ref": "#/parameters/Cursor" }, { "$ref": "#/parameters/StartTime" }, { "$ref": "#/parameters/EndTime" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/PagedListResponseWithTime" }, "examples": { "results": [ { "entity_id": "18230:66:1293137396", "entity_type": "Cluster", "time": 1509282803 }, { "entity_id": "18230:66:670818039", "entity_type": "Cluster", "time": 1509284911 } ], "cursor": null, "total_count": 4, "start_time": 1509337200, "end_time": 1509337200 } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "500": { "description": "Internal Error" } } } }, "/entities/clusters/{id}": { "get": { "tags": [ "Entities" ], "summary": "Show cluster details", "description": "Show cluster details", "operationId": "getCluster", "parameters": [ { "$ref": "#/parameters/Time" }, { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/Cluster" }, "examples": { "entity_id": "18230:66:1293137396", "name": "Cluster1", "entity_type": "Cluster", "total_cpus": 88400, "total_memory": 68717867008, "num_cpu_cores": 34, "vendor_id": "domain-c7", "num_hosts": 3, "num_datastores": 3, "nsx_manager": null, "vcenter_manager": { "entity_id": "18230:8:2048038620", "entity_type": "VCenterManager" } } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/entities/vc-datacenters": { "get": { "tags": [ "Entities" ], "summary": "List vCenter datacenters", "description": "List vCenter datacenters", "operationId": "listDatacenters", "parameters": [ { "$ref": "#/parameters/Size" }, { "$ref": "#/parameters/Cursor" }, { "$ref": "#/parameters/StartTime" }, { "$ref": "#/parameters/EndTime" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/PagedListResponseWithTime" }, "examples": { "results": [ { "entity_id": "18230:105:192022336", "entity_type": "VCDatacenter", "time": 1509282871 }, { "entity_id": "18230:105:1663983066", "entity_type": "VCDatacenter", "time": 1509282803 } ], "cursor": null, "total_count": 2, "start_time": 1509337402, "end_time": 1509337402 } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "500": { "description": "Internal Error" } } } }, "/entities/vc-datacenters/{id}": { "get": { "tags": [ "Entities" ], "summary": "Show vCenter datacenter details", "description": "Show vCenter datacenter details", "operationId": "getDatacenter", "parameters": [ { "$ref": "#/parameters/Time" }, { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/VCDatacenter" }, "examples": { "entity_id": "18230:105:192022336", "name": "DataCenter", "entity_type": "VCDatacenter", "vendor_id": "datacenter-2", "vcenter_manager": { "entity_id": "18230:8:824494514", "entity_type": "VCenterManager" } } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/entities/folders": { "get": { "tags": [ "Entities" ], "summary": "List folders", "description": "List folders", "operationId": "listFolders", "parameters": [ { "$ref": "#/parameters/Size" }, { "$ref": "#/parameters/Cursor" }, { "$ref": "#/parameters/StartTime" }, { "$ref": "#/parameters/EndTime" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/PagedListResponseWithTime" }, "examples": { "results": [ { "entity_id": "18230:81:591055243", "entity_type": "Folder", "time": 1509282871 }, { "entity_id": "18230:81:520432789", "entity_type": "Folder", "time": 1509282804 } ], "cursor": "MTA=", "total_count": 14, "start_time": 1509337459, "end_time": 1509337459 } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "500": { "description": "Internal Error" } } } }, "/entities/folders/{id}": { "get": { "tags": [ "Entities" ], "summary": "Show folder details", "description": "Show folder details", "operationId": "getFolder", "parameters": [ { "$ref": "#/parameters/Time" }, { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/Folder" }, "examples": { "entity_id": "18230:81:591055243", "name": "datastore", "entity_type": "Folder", "vendor_id": "group-s5", "vcenter_manager": { "entity_id": "18230:8:824494514", "entity_type": "VCenterManager" } } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/entities/datastores": { "get": { "tags": [ "Entities" ], "summary": "List datastores", "description": "List datastores", "operationId": "listDatastores", "parameters": [ { "$ref": "#/parameters/Size" }, { "$ref": "#/parameters/Cursor" }, { "$ref": "#/parameters/StartTime" }, { "$ref": "#/parameters/EndTime" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/PagedListResponseWithTime" }, "examples": { "results": [ { "entity_id": "18230:80:1756900216", "entity_type": "Datastore", "time": 1509282874 }, { "entity_id": "18230:80:682061552", "entity_type": "Datastore", "time": 1509282819 } ], "cursor": null, "total_count": 6, "start_time": 1509337523, "end_time": 1509337523 } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "500": { "description": "Internal Error" } } } }, "/entities/datastores/{id}": { "get": { "tags": [ "Entities" ], "summary": "Show datastore details", "description": "Show datastore details", "operationId": "getDatastore", "parameters": [ { "$ref": "#/parameters/Time" }, { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/Datastore" }, "examples": { "entity_id": "18230:80:1756898449", "name": "datastore1 (2)", "entity_type": "Datastore", "vendor_id": "datastore-33", "vcenter_manager": { "entity_id": "18230:8:824494514", "entity_type": "VCenterManager" } } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/entities/vmknics": { "get": { "tags": [ "Entities" ], "summary": "List vmknics", "description": "List vmknics", "operationId": "listVmknics", "parameters": [ { "$ref": "#/parameters/Size" }, { "$ref": "#/parameters/Cursor" }, { "$ref": "#/parameters/StartTime" }, { "$ref": "#/parameters/EndTime" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/PagedListResponseWithTime" }, "examples": { "results": [ { "entity_id": "18230:17:1928372608", "entity_type": "Vmknic", "time": 1509283321 }, { "entity_id": "18230:17:695819318", "entity_type": "Vmknic", "time": 1509282819 } ], "cursor": "MTA=", "total_count": 11, "start_time": 1509337586, "end_time": 1509337586 } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "500": { "description": "Internal Error" } } } }, "/entities/vmknics/{id}": { "get": { "tags": [ "Entities" ], "summary": "Show vmknic details", "description": "Show vmknic details", "operationId": "getVmknic", "parameters": [ { "$ref": "#/parameters/Identifier" }, { "$ref": "#/parameters/Time" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/Vmknic" }, "examples": { "entity_id": "18230:17:695819318", "name": "[10.197.17.64]-[vmk0]", "entity_type": "Vmknic", "ip_addresses": [ { "ip_address": "10.197.17.64", "netmask": "255.255.252.0", "network_address": "10.197.16.0/22" } ], "vlan": { "begin": 0, "end": 0 }, "host": { "entity_id": "18230:4:652218965", "entity_type": "Host" }, "layer2_network": null } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/entities/layer2-networks": { "get": { "tags": [ "Entities" ], "summary": "List layer2 networks", "description": "List layer2 networks", "operationId": "listLayer2Networks", "parameters": [ { "$ref": "#/parameters/Size" }, { "$ref": "#/parameters/Cursor" }, { "$ref": "#/parameters/StartTime" }, { "$ref": "#/parameters/EndTime" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/PagedListResponseWithTime" }, "examples": { "results": [ { "entity_id": "18230:11:2095237606", "entity_type": "VxlanLayer2Network", "time": 1509284850 }, { "entity_id": "18230:11:2095237668", "entity_type": "VxlanLayer2Network", "time": 1509284850 } ], "cursor": "MTA=", "total_count": 38, "start_time": 1509339711, "end_time": 1509339711 } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "500": { "description": "Internal Error" } } } }, "/entities/layer2-networks/{id}": { "get": { "tags": [ "Entities" ], "summary": "Show layer2 network details", "description": "Show layer2 network details", "operationId": "getLayer2Network", "parameters": [ { "$ref": "#/parameters/Identifier" }, { "$ref": "#/parameters/Time" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/BaseL2Network" }, "examples": { "entity_id": "18230:11:2095237606", "name": "Deccan-uplink-vxlan", "entity_type": "VxlanLayer2Network", "network_addresses": [ "192.168.13.0/24" ], "gateways": [ ], "segment_id": 5004, "vteps": [ { "entity_id": "18230:17:695819287", "entity_type": "Vmknic" }, { "entity_id": "18230:17:431576805", "entity_type": "Vmknic" } ], "scope": "GLOBAL", "nsx_managers": [ ] } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/entities/ip-sets": { "get": { "tags": [ "Entities" ], "summary": "List ip sets", "description": "List ip sets", "operationId": "listIPSets", "parameters": [ { "$ref": "#/parameters/Size" }, { "$ref": "#/parameters/Cursor" }, { "$ref": "#/parameters/StartTime" }, { "$ref": "#/parameters/EndTime" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/PagedListResponseWithTime" }, "examples": { "results": [ { "entity_id": "18230:84:347816011", "entity_type": "NSXIPSet", "time": 1509283320 } ], "cursor": null, "total_count": 3, "start_time": 1509339942, "end_time": 1509339942 } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "500": { "description": "Internal Error" } } } }, "/entities/ip-sets/{id}": { "get": { "tags": [ "Entities" ], "summary": "Show ip set details", "description": "Show ip set details", "operationId": "getIPSet", "parameters": [ { "$ref": "#/parameters/Identifier" }, { "$ref": "#/parameters/Time" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/BaseIPSet" }, "examples": { "entity_id": "18230:84:347816011", "name": "IPSET_ford", "entity_type": "NSXIPSet", "ip_addresses": [ ], "ip_ranges": [ { "start_ip": "192.168.78.21", "end_ip": "192.168.78.30" } ], "ip_numeric_ranges": [ { "start": 3232255509, "end": 3232255518 } ], "parent_security_groups": [ ], "direct_source_rules": [ ], "direct_destination_rules": [ ], "indirect_source_rules": [ ], "indirect_destination_rules": [ ], "vendor_id": "ipset-3", "vendor": "", "nsx_managers": [ { "entity_id": "18230:7:824494449", "entity_type": "NSXVManager" } ], "scope": "GLOBAL" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/entities/flows": { "get": { "tags": [ "Entities" ], "summary": "List flows", "description": "List flows", "operationId": "getFlows", "parameters": [ { "$ref": "#/parameters/Size" }, { "$ref": "#/parameters/Cursor" }, { "$ref": "#/parameters/StartTime" }, { "$ref": "#/parameters/EndTime" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/PagedListResponseWithTime" }, "examples": { "results": [ { "entity_id": "10000:515:1491521924", "entity_type": "Flow", "time": 1509283320 } ], "cursor": null, "total_count": 3, "start_time": 1509339942, "end_time": 1509339942 } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "500": { "description": "Internal Error" } } } }, "/entities/flows/{id}": { "get": { "tags": [ "Entities" ], "summary": "Show flow details", "description": "Show flow details", "operationId": "getFlow", "parameters": [ { "$ref": "#/parameters/Identifier" }, { "$ref": "#/parameters/Time" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/Flow" }, "examples": { "entity_id": "10000:515:1491521924", "name": "10.197.53.40 -> 10.197.53.38 [port:500]", "entity_type": "Flow", "source_ip": { "ip_address": "10.197.53.40", "netmask": "255.255.255.255", "network_address": "10.197.53.40" }, "destination_ip": { "ip_address": "10.197.53.38", "netmask": "255.255.255.255", "network_address": "10.197.53.38" }, "port": { "start": 500, "end": 500, "display": "500", "iana_name": "isakmp", "iana_port_display": "500 [isakmp]" }, "source_folders": [ ], "destination_folders": [ ], "protocol": "UDP", "source_ip_sets": [ ], "destination_ip_sets": [ ], "source_security_groups": [ ], "destination_security_groups": [ ], "traffic_type": "EAST_WEST_TRAFFIC", "source_security_tags": [ ], "destination_security_tags": [ ], "source_vm_tags": [ ], "destination_vm_tags": [ ], "within_host": false, "firewall_action": "ALLOW", "firewall_rule_id": [ ], "flow_tag": [ "EAST_WEST_TRAFFIC", "PHY_PHY_TRAFFIC", "SRC_IP_PHYSICAL" ] } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/entities/security-groups": { "get": { "tags": [ "Entities" ], "summary": "List security groups", "description": "List security groups", "operationId": "listSecurityGroups", "parameters": [ { "$ref": "#/parameters/Size" }, { "$ref": "#/parameters/Cursor" }, { "$ref": "#/parameters/StartTime" }, { "$ref": "#/parameters/EndTime" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/PagedListResponseWithTime" }, "examples": { "results": [ { "entity_id": "18230:82:1504518253", "entity_type": "NSXSecurityGroup", "time": 1509283316 }, { "entity_id": "18230:82:604574196", "entity_type": "NSXSecurityGroup", "time": 1509284912 } ], "cursor": null, "total_count": 9, "start_time": 1509340012, "end_time": 1509340012 } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "500": { "description": "Internal Error" } } } }, "/entities/security-groups/{id}": { "get": { "tags": [ "Entities" ], "summary": "Show security group details", "description": "Show security group details", "operationId": "getSecurityGroup", "parameters": [ { "$ref": "#/parameters/Identifier" }, { "$ref": "#/parameters/Time" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/BaseSecurityGroup" }, "examples": { "entity_id": "18230:82:604574196", "name": "SG-TestApp-Web", "entity_type": "NSXSecurityGroup", "members": [ { "entity_id": "18230:99:922343691", "entity_type": "SecurityTag" } ], "direct_source_rules": [ ], "direct_destination_rules": [ ], "indirect_source_rules": [ ], "indirect_destination_rules": [ ], "parents": [ ], "direct_members": [ { "entity_id": "18230:99:922343691", "entity_type": "SecurityTag" } ], "vendor_id": "securitygroup-25", "excluded_members": [ ], "nsx_managers": [ { "entity_id": "18230:7:824494449", "entity_type": "NSXVManager" } ], "scope": "GLOBAL", "ip_sets": [ ], "security_tags": [ { "entity_id": "18230:99:922343691", "entity_type": "SecurityTag" } ] } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/entities/security-tags": { "get": { "tags": [ "Entities" ], "summary": "List security tags", "description": "List security tags", "operationId": "listSecurityTags", "parameters": [ { "$ref": "#/parameters/Size" }, { "$ref": "#/parameters/Cursor" }, { "$ref": "#/parameters/StartTime" }, { "$ref": "#/parameters/EndTime" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/PagedListResponseWithTime" }, "examples": { "results": [ { "entity_id": "18230:99:922344652", "entity_type": "SecurityTag", "time": 1509283319 }, { "entity_id": "18230:99:1830868297", "entity_type": "SecurityTag", "time": 1509283318 } ], "cursor": "MTA=", "total_count": 14, "start_time": 1509340096, "end_time": 1509340096 } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "500": { "description": "Internal Error" } } } }, "/entities/security-tags/{id}": { "get": { "tags": [ "Entities" ], "summary": "Show security tag details", "description": "Show security tag details", "operationId": "getSecurityTag", "parameters": [ { "$ref": "#/parameters/Identifier" }, { "$ref": "#/parameters/Time" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/SecurityTag" }, "examples": { "entity_id": "18230:99:922344652", "name": "IDS_IPS.threat=medium", "entity_type": "SecurityTag", "description": "Tag indicates that the data violation detected has a medium threat level", "direct_security_groups": [ ], "security_groups": [ ], "vendor_id": "securitytag-10", "nsx_manager": { "entity_id": "18230:7:824494449", "entity_type": "NSXVManager" } } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/entities/firewall-rules": { "get": { "tags": [ "Entities" ], "summary": "List firewall rules", "description": "List firewall rules", "operationId": "listFirewallRules", "parameters": [ { "$ref": "#/parameters/Size" }, { "$ref": "#/parameters/Cursor" }, { "$ref": "#/parameters/StartTime" }, { "$ref": "#/parameters/EndTime" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/PagedListResponseWithTime" }, "examples": { "results": [ { "entity_id": "18230:87:367271162", "entity_type": "NSXFirewallRule", "time": 1509283319 }, { "entity_id": "18230:87:367270232", "entity_type": "NSXFirewallRule", "time": 1509283319 } ], "cursor": null, "total_count": 7, "start_time": 1509344618, "end_time": 1509344618 } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "500": { "description": "Internal Error" } } } }, "/entities/firewall-rules/{id}": { "get": { "tags": [ "Entities" ], "summary": "Show firewall rule details", "description": "Show firewall rule details", "operationId": "getFirewallRule", "parameters": [ { "$ref": "#/parameters/Identifier" }, { "$ref": "#/parameters/Time" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/BaseFirewallRule" }, "examples": { "entity_id": "18230:87:367271162", "name": "Default Rule", "entity_type": "NSXFirewallRule", "rule_id": "1001", "section_id": "1003", "section_name": "Default Section Layer3", "sequence_number": 6, "source_any": true, "destination_any": true, "service_any": true, "sources": [ ], "destinations": [ ], "services": [ ], "action": "ALLOW", "disabled": false, "source_inversion": false, "destination_inversion": false, "port_ranges": [ { "start": 0, "end": 65535, "display": "0-65535 (ANY)", "iana_name": "", "iana_port_display": "" } ], "logging_enabled": false, "direction": "INOUT", "scope": "GLOBAL", "nsx_managers": [ { "entity_id": "18230:7:824494449", "entity_type": "NSXVManager" } ] } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/entities/firewalls": { "get": { "tags": [ "Entities" ], "summary": "List firewalls", "description": "List firewalls", "operationId": "listFirewalls", "parameters": [ { "$ref": "#/parameters/Size" }, { "$ref": "#/parameters/Cursor" }, { "$ref": "#/parameters/StartTime" }, { "$ref": "#/parameters/EndTime" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/PagedListResponseWithTime" }, "examples": { "results": [ { "entity_id": "18230:39:660899929", "entity_type": "NSXDistributedFirewall", "time": 1509283319 } ], "cursor": null, "total_count": 1, "start_time": 1509344618, "end_time": 1509344618 } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "500": { "description": "Internal Error" } } } }, "/entities/firewalls/{id}": { "get": { "tags": [ "Entities" ], "summary": "Show firewall details", "description": "Show firewall details", "operationId": "getFirewall", "parameters": [ { "$ref": "#/parameters/Identifier" }, { "$ref": "#/parameters/Time" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/BaseFirewallRule" }, "examples": { "entity_id": "18230:39:660899929", "name": "NSX Firewall", "entity_type": "NSXDistributedFirewall", "firewall_rules": [ { "rules": [ ], "rule_set_type": "NSX_STANDARD" }, { "rules": [ ] } ], "exclusions": [ { "entity_id": "18230:1:875338882", "entity_type": "VirtualMachine" } ] } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/entities/services": { "get": { "tags": [ "Entities" ], "summary": "List services", "description": "List services", "operationId": "listServices", "parameters": [ { "$ref": "#/parameters/Size" }, { "$ref": "#/parameters/Cursor" }, { "$ref": "#/parameters/StartTime" }, { "$ref": "#/parameters/EndTime" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/PagedListResponseWithTime" }, "examples": { "results": [ { "entity_id": "18230:85:503995168", "entity_type": "NSXService", "time": 1509283319 } ], "cursor": null, "total_count": 1, "start_time": 1509344618, "end_time": 1509344618 } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "500": { "description": "Internal Error" } } } }, "/entities/services/{id}": { "get": { "tags": [ "Entities" ], "summary": "Show service details", "description": "Show service details", "operationId": "getService", "parameters": [ { "$ref": "#/parameters/Identifier" }, { "$ref": "#/parameters/Time" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/BaseService" }, "examples": { "entity_id": "18230:85:503995168", "name": "PostgresSQL", "entity_type": "NSXService", "protocol": "TCP", "port_ranges": [ { "start": 5432, "end": 5432, "display": "5432", "iana_name": "", "iana_port_display": "" } ], "nsx_managers": [ { "entity_id": "18230:7:824494449", "entity_type": "NSXVManager" } ], "scope": "GLOBAL", "vendor_id": "application-211" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/entities/service-groups": { "get": { "tags": [ "Entities" ], "summary": "List service groups", "description": "List service groups", "operationId": "listServiceGroups", "parameters": [ { "$ref": "#/parameters/Size" }, { "$ref": "#/parameters/Cursor" }, { "$ref": "#/parameters/StartTime" }, { "$ref": "#/parameters/EndTime" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/PagedListResponseWithTime" }, "examples": { "results": [ { "entity_id": "18230:86:1504518253", "entity_type": "NSXServiceGroup", "time": 1509283319 } ], "cursor": null, "total_count": 1, "start_time": 1509344618, "end_time": 1509344618 } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "500": { "description": "Internal Error" } } } }, "/entities/service-groups/{id}": { "get": { "tags": [ "Entities" ], "summary": "Show service group details", "description": "Show service group details", "operationId": "getServiceGroup", "parameters": [ { "$ref": "#/parameters/Identifier" }, { "$ref": "#/parameters/Time" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/BaseServiceGroup" }, "examples": { "entity_id": "18230:86:505347433", "name": "Oracle Enterprise Manager", "entity_type": "NSXServiceGroup", "members": [ { "entity_id": "18230:85:676477656", "entity_type": "NSXService" }, { "entity_id": "18230:85:503998082", "entity_type": "NSXService" }, { "entity_id": "18230:85:504027904", "entity_type": "NSXService" }, { "entity_id": "18230:85:676474897", "entity_type": "NSXService" } ], "scope": "GLOBAL", "nsx_managers": [ { "entity_id": "18230:7:824494449", "entity_type": "NSXVManager" } ], "vendor_id": "applicationgroup-23" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/entities/vcenter-managers": { "get": { "tags": [ "Entities" ], "summary": "List vCenter managers", "description": "List vCenter managers", "operationId": "listVcenterManagers", "parameters": [ { "$ref": "#/parameters/Size" }, { "$ref": "#/parameters/Cursor" }, { "$ref": "#/parameters/StartTime" }, { "$ref": "#/parameters/EndTime" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/PagedListResponseWithTime" }, "examples": { "results": [ { "entity_id": "18230:8:2048038620", "entity_type": "VCenterManager", "time": 1509282805 }, { "entity_id": "18230:8:824494514", "entity_type": "VCenterManager", "time": 1509283017 } ], "cursor": null, "total_count": 2, "start_time": 1509344794, "end_time": 1509344794 } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "500": { "description": "Internal Error" } } } }, "/entities/vcenter-managers/{id}": { "get": { "tags": [ "Entities" ], "summary": "Show vCenter manager details", "description": "Show vCenter manager details", "operationId": "getVcenterManager", "parameters": [ { "$ref": "#/parameters/Identifier" }, { "$ref": "#/parameters/Time" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/VCenterManager" }, "examples": { "entity_id": "18230:8:2048038620", "name": "10.197.17.68", "entity_type": "VCenterManager", "ip_address": { "ip_address": "10.197.17.68", "netmask": "255.255.255.255", "network_address": "10.197.17.68/32" } } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/entities/nsx-managers": { "get": { "tags": [ "Entities" ], "summary": "List nsx managers", "description": "List nsx managers", "operationId": "listNSXManagers", "parameters": [ { "$ref": "#/parameters/Size" }, { "$ref": "#/parameters/Cursor" }, { "$ref": "#/parameters/StartTime" }, { "$ref": "#/parameters/EndTime" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/PagedListResponseWithTime" }, "examples": { "results": [ { "entity_id": "18230:7:824494449", "entity_type": "NSXVManager", "time": 1509339744 } ], "cursor": null, "total_count": 1, "start_time": 1509345346, "end_time": 1509345346 } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "500": { "description": "Internal Error" } } } }, "/entities/nsx-managers/{id}": { "get": { "tags": [ "Entities" ], "summary": "Show nsx manager details", "description": "Show nsx manager details", "operationId": "getNSXManager", "parameters": [ { "$ref": "#/parameters/Identifier" }, { "$ref": "#/parameters/Time" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/BaseNSXManager" }, "examples": { "entity_id": "18230:7:824494449", "name": "10.197.53.187", "entity_type": "NSXVManager", "ip_address": { "ip_address": "10.197.53.187", "netmask": "255.255.255.255", "network_address": "10.197.53.187/32" }, "version": "6.2.8", "role": "STANDALONE" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/entities/firewall-managers": { "get": { "tags": [ "Entities" ], "summary": "List firewall managers", "description": "List firewall managers", "operationId": "listFirewallManagers", "parameters": [ { "$ref": "#/parameters/Size" }, { "$ref": "#/parameters/Cursor" }, { "$ref": "#/parameters/StartTime" }, { "$ref": "#/parameters/EndTime" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/PagedListResponseWithTime" }, "examples": { "results": [ { "entity_id": "18230:313:173836586", "entity_type": "CheckpointManager", "time": 1509339744 } ], "cursor": null, "total_count": 1, "start_time": 1509345346, "end_time": 1509345346 } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "500": { "description": "Internal Error" } } } }, "/entities/firewall-managers/{id}": { "get": { "tags": [ "Entities" ], "summary": "Show firewall manager details", "description": "Show firewall manager details", "operationId": "getFirewallManager", "parameters": [ { "$ref": "#/parameters/Identifier" }, { "$ref": "#/parameters/Time" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/BaseFirewallManager" }, "examples": { "entity_id": "18230:313:824494449", "name": "10.197.53.187", "entity_type": "CheckpointManager", "ip_address": { "ip_address": "10.197.53.187", "netmask": "255.255.255.255", "network_address": "10.197.53.187/32" } } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/entities/distributed-virtual-switches": { "get": { "tags": [ "Entities" ], "summary": "List distributed virtual switches", "description": "List distributed virtual switches", "operationId": "listDistributedVirtualSwitches", "parameters": [ { "$ref": "#/parameters/Size" }, { "$ref": "#/parameters/Cursor" }, { "$ref": "#/parameters/StartTime" }, { "$ref": "#/parameters/EndTime" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/PagedListResponseWithTime" }, "examples": { "results": [ { "entity_id": "18230:2:161257049", "entity_type": "DistributedVirtualSwitch", "time": 1509282885 }, { "entity_id": "18230:2:368016825", "entity_type": "DistributedVirtualSwitch", "time": 1509282854 } ], "cursor": null, "total_count": 2, "start_time": 1509345426, "end_time": 1509345426 } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "500": { "description": "Internal Error" } } } }, "/entities/distributed-virtual-switches/{id}": { "get": { "tags": [ "Entities" ], "summary": "Show distributed virtual switch details", "description": "Show distributed virtual switch details", "operationId": "getDistributedVirtualSwitch", "parameters": [ { "$ref": "#/parameters/Identifier" }, { "$ref": "#/parameters/Time" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/DistributedVirtualSwitch" }, "examples": { "entity_id": "18230:2:161257049", "name": "dvSwitch", "entity_type": "DistributedVirtualSwitch", "vendor_id": "dvs-21", "vcenter_manager": { "entity_id": "18230:8:824494514", "entity_type": "VCenterManager" }, "hosts": [ { "entity_id": "18230:4:1528136654", "entity_type": "Host" }, { "entity_id": "18230:4:1528138514", "entity_type": "Host" }, { "entity_id": "18230:4:1528136747", "entity_type": "Host" } ] } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/entities/distributed-virtual-portgroups": { "get": { "tags": [ "Entities" ], "summary": "List distributed virtual portgroups", "description": "List distributed virtual portgroups", "operationId": "listDistributedVirtualPortgroups", "parameters": [ { "$ref": "#/parameters/Size" }, { "$ref": "#/parameters/Cursor" }, { "$ref": "#/parameters/StartTime" }, { "$ref": "#/parameters/EndTime" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/PagedListResponseWithTime" }, "examples": { "results": [ { "entity_id": "18230:3:187309184", "entity_type": "DistributedVirtualPortgroup", "time": 1509282847 }, { "entity_id": "18230:3:1603334983", "entity_type": "DistributedVirtualPortgroup", "time": 1509282885 } ], "cursor": "MTA=", "total_count": 46, "start_time": 1509345514, "end_time": 1509345514 } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "500": { "description": "Internal Error" } } } }, "/entities/distributed-virtual-portgroups/{id}": { "get": { "tags": [ "Entities" ], "summary": "Show distributed virtual portgroup details", "description": "Show distributed virtual portgroup details", "operationId": "getDistributedVirtualPortgroup", "parameters": [ { "$ref": "#/parameters/Identifier" }, { "$ref": "#/parameters/Time" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/DistributedVirtualPortgroup" }, "examples": { "entity_id": "18230:3:187309184", "name": "vxw-dvs-15-virtualwire-18-sid-5017-swargate end vm vxlan", "entity_type": "DistributedVirtualPortgroup", "vendor_id": "dvportgroup-92", "vcenter_manager": { "entity_id": "18230:8:2048038620", "entity_type": "VCenterManager" }, "distributed_virtual_switch": { "entity_id": "18230:2:368016825", "entity_type": "DistributedVirtualSwitch" } } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/entities/names": { "post": { "tags": [ "Entities" ], "summary": "Get names for entities", "description": "Get names for entities.Limit of 1000 entities in a single request.", "operationId": "getNames", "parameters": [ { "in": "body", "name": "body", "description": "Names Request", "required": true, "schema": { "$ref": "#/definitions/NamesRequest" } } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/NamesResponse" } }, "401": { "description": "Unauthorized" }, "500": { "description": "Internal Error" } } } }, "/entities/names/{id}": { "get": { "tags": [ "Entities" ], "summary": "Get name of an entity", "description": "Get name of an entity", "operationId": "getName", "parameters": [ { "$ref": "#/parameters/Identifier" }, { "$ref": "#/parameters/Time" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/EntityName" } }, "401": { "description": "Unauthorized" }, "500": { "description": "Internal Error" } } } }, "/metrics": { "get": { "tags": [ "Metrics" ], "summary": "Get metric points for an entity", "description": "Get metric points for an entity for an entity id and metric for a given time interval. Maximum number of metrics point returned by API is 300. In case the interval and time period combination have more than 300 metrics points, client should break the time period to multiple batches to get all the metrics points.", "operationId": "getMetrics", "parameters": [ { "name": "entity_id", "in": "query", "description": "entity type", "required": true, "type": "string" }, { "name": "metric", "in": "query", "description": "metric name", "required": true, "type": "string" }, { "name": "interval", "in": "query", "description": "metric points interval", "required": true, "type": "integer" }, { "name": "start", "in": "query", "description": "start time for query in epoch seconds", "required": true, "type": "integer", "format": "int64" }, { "name": "end", "in": "query", "description": "end time for query in epoch seconds", "required": true, "type": "integer", "format": "int64" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/MetricResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "500": { "description": "Internal Error" } } } }, "/schema/{entity-type}/metrics": { "get": { "tags": [ "Schema" ], "summary": "Get metrics schema for an entity type", "description": "Get details of metrics available for entity type", "operationId": "getMetricsSchema", "parameters": [ { "name": "entity-type", "in": "path", "description": "entity type", "required": true, "type": "string" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/EntityMetricsSchema" } }, "401": { "description": "Unauthorized" }, "500": { "description": "Internal Error" } } } }, "/groups/applications": { "post": { "tags": [ "Applications" ], "summary": "Create an application", "description": "Application is a group of tiers. A tier is a group of virtual machines based on membership criteria. Tiers are bound to single\napplication. An application name is unique and should not conflict with another application name.", "operationId": "addApplication", "parameters": [ { "name": "body", "in": "body", "required": true, "schema": { "$ref": "#/definitions/ApplicationRequest" } } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "201": { "description": "Created", "schema": { "$ref": "#/definitions/Application" }, "examples": { "entity_id": "18230:561:271275765", "name": "App-1", "entity_type": "Application", "create_time": 1509410056733, "created_by": "admin@local", "last_modified_time": 0, "last_modified_by": "" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "500": { "description": "Internal Error" } } }, "get": { "tags": [ "Applications" ], "summary": "List applications", "description": "List applications", "operationId": "listApplications", "parameters": [ { "$ref": "#/parameters/Size" }, { "$ref": "#/parameters/Cursor" }, { "$ref": "#/parameters/StartTime" }, { "$ref": "#/parameters/EndTime" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/PagedListResponse" }, "examples": { "results": [ { "entity_id": "18230:561:271275765", "entity_type": "Application" } ], "total_count": 1 } }, "401": { "description": "Unauthorized" }, "500": { "description": "Internal Error" } } } }, "/groups/applications/{id}": { "get": { "tags": [ "Applications" ], "summary": "Show application details", "description": "Show application details", "operationId": "getApplication", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/Application" }, "examples": { "entity_id": "18230:561:271275765", "name": "App-1", "entity_type": "Application", "create_time": 1509410056733, "created_by": "admin@local", "last_modified_time": 0, "last_modified_by": "" } }, "401": { "description": "Unauthorized" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } }, "delete": { "tags": [ "Applications" ], "summary": "Delete an application", "description": "Deleting an application deletes all the tiers of the application along with the application", "operationId": "deleteApplication", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "204": { "description": "Success" }, "401": { "description": "Unauthorized" }, "500": { "description": "Internal Error" } } } }, "/groups/applications/{id}/members/vms": { "get": { "tags": [ "Applications" ], "summary": "Show application members", "description": "Show application members", "operationId": "getApplicationVms", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/ApplicationMembers" } }, "401": { "description": "Unauthorized" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/groups/applications/members": { "post": { "tags": [ "Applications" ], "summary": "Get member details of applications", "description": "Get member details of applications", "operationId": "getApplicationsMembers", "parameters": [ { "name": "body", "in": "body", "required": true, "schema": { "$ref": "#/definitions/GroupsMembersRequest" } } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/ApplicationsMembersResponse" } }, "401": { "description": "Unauthorized" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/groups/tiers/members": { "post": { "tags": [ "Applications" ], "summary": "Get member details of tiers", "description": "Get member details of tiers", "operationId": "getTiersMembers", "parameters": [ { "name": "body", "in": "body", "required": true, "schema": { "$ref": "#/definitions/GroupsMembersRequest" } } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/TiersMembersResponse" } }, "401": { "description": "Unauthorized" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/groups/applications/{id}/flow-summary": { "get": { "tags": [ "Applications" ], "summary": "Show application flow summary", "description": "Show application details", "operationId": "getApplicationFlowSummary", "parameters": [ { "$ref": "#/parameters/Identifier" }, { "$ref": "#/parameters/StartTime" }, { "$ref": "#/parameters/EndTime" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/ApplicationFlowSummary" } }, "401": { "description": "Unauthorized" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/groups/applications/fetch": { "get": { "tags": [ "Applications" ], "summary": "Get application details bulk", "description": "Get application details bulk", "operationId": "listApplicationsDetails", "parameters": [ { "$ref": "#/parameters/Size" }, { "$ref": "#/parameters/Cursor" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/PagedApplicationListResponse" } }, "401": { "description": "Unauthorized" }, "500": { "description": "Internal Error" } } } }, "/groups/applications/{id}/tiers": { "post": { "tags": [ "Applications" ], "summary": "Create tier in application", "description": "Create a tier of an application by with specified membership criteria. The membership criteria id defined in terms of\nvirtual machines or ip addresses/subnet. Please refer to API Guide on how to construct membership criteria.", "operationId": "addTier", "parameters": [ { "$ref": "#/parameters/Identifier" }, { "name": "body", "in": "body", "required": true, "schema": { "$ref": "#/definitions/TierRequest" } } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "201": { "description": "Created", "schema": { "$ref": "#/definitions/Tier" }, "examples": { "entity_id": "18230:562:1266458745", "name": "tier-1", "entity_type": "Tier", "group_membership_criteria": [ { "membership_type": "SearchMembershipCriteria", "search_membership_criteria": { "entity_type": "VirtualMachine", "filter": "security_groups.entity_id = '18230:82:604573173'" } } ], "application": { "entity_id": "18230:561:271275765", "entity_type": "Application" } } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } }, "get": { "tags": [ "Applications" ], "summary": "List tiers of an application", "description": "List tiers of an application", "operationId": "listApplicationTiers", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/TierListResponse" }, "examples": { "results": [ { "entity_id": "18230:562:1266458745", "name": "tier-1", "entity_type": "Tier", "group_membership_criteria": [ { "membership_type": "SearchMembershipCriteria", "search_membership_criteria": { "entity_type": "VirtualMachine", "filter": "security_groups.entity_id = '18230:82:604573173'" } } ], "application": { "entity_id": "18230:561:271275765", "entity_type": "Application" } } ] } }, "401": { "description": "Unauthorized" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/groups/applications/{id}/tiers/{tier-id}": { "get": { "tags": [ "Applications" ], "summary": "Show tier details", "description": "Show tier details", "operationId": "getApplicationTier", "parameters": [ { "$ref": "#/parameters/Identifier" }, { "name": "tier-id", "in": "path", "required": true, "type": "string" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/Tier" }, "examples": { "entity_id": "18230:562:1266458745", "name": "tier-1", "entity_type": "Tier", "group_membership_criteria": [ { "membership_type": "SearchMembershipCriteria", "search_membership_criteria": { "entity_type": "VirtualMachine", "filter": "security_groups.entity_id = '18230:82:604573173'" } } ], "application": { "entity_id": "18230:561:271275765", "entity_type": "Application" } } }, "401": { "description": "Unauthorized" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } }, "delete": { "tags": [ "Applications" ], "summary": "Delete tier", "description": "Delete tier of an application", "operationId": "deleteTier", "parameters": [ { "$ref": "#/parameters/Identifier" }, { "name": "tier-id", "in": "path", "required": true, "type": "string" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "204": { "description": "OK" }, "401": { "description": "Unauthorized" }, "500": { "description": "Internal Error" } } }, "put": { "tags": [ "Applications" ], "summary": "Edit tier in application", "description": "Edit a tier of an application with specified membership criteria. The membership criteria id defined in terms of\nvirtual machines or ip addresses/subnet. Please refer to API Guide on how to construct membership criteria.", "operationId": "editApplicationTier", "parameters": [ { "$ref": "#/parameters/Identifier" }, { "name": "tier-id", "in": "path", "required": true, "type": "string" }, { "name": "body", "in": "body", "required": true, "schema": { "$ref": "#/definitions/TierRequest" } } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "201": { "description": "Created", "schema": { "$ref": "#/definitions/Tier" }, "examples": { "entity_id": "18230:562:1266458745", "name": "tier-1", "entity_type": "Tier", "group_membership_criteria": [ { "membership_type": "SearchMembershipCriteria", "search_membership_criteria": { "entity_type": "VirtualMachine", "filter": "security_groups.entity_id = '18230:82:604573173'" } } ], "application": { "entity_id": "18230:561:271275765", "entity_type": "Application" } } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/groups/tiers/{tier-id}": { "get": { "tags": [ "Applications" ], "summary": "Show tier details", "description": "Show tier details", "operationId": "getTier", "parameters": [ { "name": "tier-id", "in": "path", "required": true, "type": "string" }, { "name": "Authorization", "in": "header", "description": "Authorization Header", "required": true, "type": "string", "format": "NetworkInsight " } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/Tier" }, "examples": { "entity_id": "18230:562:1266458745", "name": "tier-1", "entity_type": "Tier", "group_membership_criteria": [ { "membership_type": "SearchMembershipCriteria", "search_membership_criteria": { "entity_type": "VirtualMachine", "filter": "security_groups.entity_id = '18230:82:604573173'" } } ], "application": { "entity_id": "18230:561:271275765", "entity_type": "Application" } } }, "401": { "description": "Unauthorized" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/entities/kubernetes-services": { "get": { "tags": [ "Entities" ], "summary": "List Kubernetes Services", "description": "List kubernetes services", "operationId": "getKubernetesServices", "parameters": [ { "$ref": "#/parameters/Size" }, { "$ref": "#/parameters/Cursor" }, { "$ref": "#/parameters/StartTime" }, { "$ref": "#/parameters/EndTime" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/PagedListResponseWithTime" }, "examples": { "results": [ { "entity_id": "18230:1504:115896", "entity_type": "KubernetesService", "time": 1509283414 }, { "entity_id": "18230:1504:87533", "entity_type": "KubernetesService", "time": 1509283476 } ], "cursor": "MTA=", "total_count": 39, "start_time": 1509335034, "end_time": 1509335034 } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "500": { "description": "Internal Error" } } } }, "/entities/kubernetes-services/{id}": { "get": { "tags": [ "Entities" ], "summary": "Show kubernetes service details", "description": "Show kubernetes service details", "operationId": "getKubernetesServiceById", "parameters": [ { "$ref": "#/parameters/Identifier" }, { "$ref": "#/parameters/Time" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/KubernetesService" }, "examples": { "entity_id": "1234:1504:13522", "vendorId": "9902d9fa-c563-11e8-aa7a-005056869748", "name": "carts", "entity_type": "KubernetesService", "type": "ClusterIP", "clusterip": [ { "ip_address": "10.197.17.74", "netmask": "255.255.255.0", "network_address": "10.197.17.0/24" } ] } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/micro-seg/recommended-rules": { "post": { "tags": [ "Microsegmentation" ], "summary": "Get logical recommended rules", "description": "Get recommended firewall rules based on the flow data gathered by vRealize Network Insight.\nThis API provides service to retrieve recommended rules based on flow traffic that is observed between\ntwo groups OR for a single group based on all the inbound and outboud traffic for that group.\nIn case two groups are provided, both the groups should be of same type.\nCurrently supported groups are Application, Tier, NSXSecurityGroup, EC2SecurityGroup.", "operationId": "listRecommendedRules", "parameters": [ { "in": "body", "name": "body", "description": "Recommended Rules Request", "required": false, "schema": { "$ref": "#/definitions/RecommendedRulesRequest" } } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "Success", "schema": { "$ref": "#/definitions/RecommendedRules" }, "examples": { "results": [ { "sources": [ { "entity_id": "10000:562:1904698621", "entity_type": "Tier" } ], "destinations": [ { "entity_id": "10000:562:1780351215", "entity_type": "Tier" } ], "protocols": [ "UDP" ], "port_ranges": [ { "start": 53, "end": 53 }, { "start": 1025, "end": 1025 } ], "action": "ALLOW" } ], "time_range": { "start_time_epoch": 1508996919391, "end_time_epoch": 1509083319391 } } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "500": { "description": "Internal Error" } } } }, "/micro-seg/recommended-rules/nsx": { "post": { "tags": [ "Microsegmentation" ], "summary": "Export recommended rules for NSX-V", "description": "Export recommended firewall rules based on the flow data gathered by vRealize Network Insight in NSX-V compatible\nformat", "operationId": "exportNsxRecommendedRules", "produces": [ "application/octet-stream" ], "parameters": [ { "in": "body", "name": "body", "description": "NSX Recommended Rules Request", "required": false, "schema": { "$ref": "#/definitions/RecommendedRulesRequest" } } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "Success", "schema": { "type": "file" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "500": { "description": "Internal Error" } } } }, "/search": { "post": { "tags": [ "Search" ], "summary": "Search entities", "description": "Using search API you can search vRealize Network Insight entities by specifying entity type and filter expression.\nA filter expression is a predicate expression (similar to SQL where clause) used to define the search criteria.\nPlease refer to API Guide on details of how to construct filter expression. A successful search request will return a\nlist of entity ids that matches the search criteria.", "operationId": "searchEntities", "parameters": [ { "in": "body", "name": "body", "description": "Search Request", "required": false, "schema": { "$ref": "#/definitions/SearchRequest" } } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "Success", "schema": { "$ref": "#/definitions/PagedListResponseWithTime" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "500": { "description": "Internal Error" } } } }, "/search/aggregation": { "post": { "tags": [ "Search" ], "summary": "Aggregation API", "description": "Using aggregate API you can aggregate search results for vRealize Network Insight entities by specifying\nentity type, filter expression and aggregate clause. Please refer to API Guide on details of how to construct\nfilter expression and aggregate clause. A successful search request will return a list of aggregations.", "operationId": "aggregateSearchResults", "parameters": [ { "in": "body", "name": "body", "description": "Aggregation Request", "required": false, "schema": { "$ref": "#/definitions/AggregationRequest" } } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "Success", "schema": { "$ref": "#/definitions/AggregationResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "500": { "description": "Internal Error" } } } }, "/search/groupby": { "post": { "tags": [ "Search" ], "summary": "Groupby Search API", "description": "Using groupby search API you can group search results for vRealize Network Insight entities by specifying\nentity type, filter expression, aggregate clause and groupby clause. Please refer to API Guide on details\nof how to construct filter expression, aggregate clause and groupby clause. A successful search request will\nreturn a list of groups.", "operationId": "groupSearchResults", "parameters": [ { "in": "body", "name": "body", "description": "GroupBy Request", "required": false, "schema": { "$ref": "#/definitions/SearchGroupByRequest" } } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "Success", "schema": { "$ref": "#/definitions/SearchGroupByResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "500": { "description": "Internal Error" } } } }, "/settings/ip-tags/tag-ids": { "get": { "tags": [ "Settings" ], "summary": "Show ip tag ids", "description": "Get all tag ids e.g. EAST_WEST, INTERNET etc.", "operationId": "getIpTagIds", "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/IpTagIdList" } }, "401": { "description": "Unauthorized" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/settings/ip-tags/{tag-id}": { "get": { "tags": [ "Settings" ], "summary": "Show ip tag details", "description": "Show ip tag details with member ip addresses and subnets", "operationId": "getIpTag", "parameters": [ { "name": "tag-id", "in": "path", "required": true, "type": "string" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/IpTag" } }, "401": { "description": "Unauthorized" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/settings/ip-tags/{tag-id}/add": { "post": { "tags": [ "Settings" ], "summary": "Tag ip addresses with tag-id", "description": "Tag ip addresses with tag-id", "operationId": "addIpTag", "parameters": [ { "name": "tag-id", "in": "path", "required": true, "type": "string" }, { "in": "body", "name": "body", "description": "Ip Tag", "required": true, "schema": { "$ref": "#/definitions/IpTag" } } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/settings/ip-tags/{tag-id}/remove": { "post": { "tags": [ "Settings" ], "summary": "Remove tag from ip addresses", "description": "Remove tag from ip addresses", "operationId": "removeIpTag", "parameters": [ { "name": "tag-id", "in": "path", "required": true, "type": "string" }, { "in": "body", "name": "body", "description": "Ip Tag", "required": true, "schema": { "$ref": "#/definitions/IpTag" } } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK" }, "401": { "description": "Unauthorized" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/settings/subnet-mappings": { "post": { "tags": [ "Settings" ], "summary": "Create subnet mapping", "description": "Create a new subnet mapping (CIDR to VLAN ID).", "operationId": "createSubnetMapping", "parameters": [ { "in": "body", "name": "body", "required": true, "schema": { "$ref": "#/definitions/SubnetMappingRequest" } } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "201": { "description": "Created", "schema": { "$ref": "#/definitions/SubnetMapping" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "500": { "description": "Internal Error" } } }, "get": { "tags": [ "Settings" ], "summary": "Get all subnet mappings", "description": "Get all subnet mappings (CIDR to VLAN ID).", "operationId": "getSubnetMappings", "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/SubnetMappingList" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/settings/subnet-mappings/{id}": { "put": { "tags": [ "Settings" ], "summary": "Update subnet mapping", "description": "Update an existing subnet mapping (VLAN ID for the given CIDR).", "operationId": "updateSubnetMapping", "parameters": [ { "$ref": "#/parameters/Identifier" }, { "in": "body", "name": "body", "required": true, "schema": { "$ref": "#/definitions/SubnetMappingRequest" } } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/SubnetMapping" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } }, "delete": { "tags": [ "Settings" ], "summary": "Delete subnet mapping", "description": "Delete an existing subnet mapping (CIDR to VLAN ID).", "operationId": "deleteSubnetMapping", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "204": { "description": "OK" }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/settings/users/password": { "put": { "tags": [ "Settings" ], "summary": "Update user password", "description": "Update password of a local user. Any user can change his own password. Admin has permission to change any user\npassword.", "security": [ { "ApiKeyAuth": [ ] } ], "parameters": [ { "in": "body", "name": "body", "description": "User details", "required": true, "schema": { "$ref": "#/definitions/UserUpdateRequest" } } ], "responses": { "200": { "description": "Success" }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized", "schema": { "$ref": "#/definitions/ApiError" } }, "403": { "description": "Forbidden", "schema": { "$ref": "#/definitions/ApiError" } }, "404": { "description": "Not Found", "schema": { "$ref": "#/definitions/ApiError" } }, "500": { "description": "Internal Error", "schema": { "$ref": "#/definitions/ApiError" } } } } }, "/settings/snmp/profiles": { "post": { "tags": [ "Settings" ], "summary": "Add new SNMP destination profile", "description": "Add a new SNMP destination profile. By Default, maximum of 4 SNMP profiles can be configured. Only admin users can perform this action.", "security": [ { "ApiKeyAuth": [ ] } ], "parameters": [ { "in": "body", "name": "body", "description": "SNMP destination profile", "required": true, "schema": { "$ref": "#/definitions/SnmpProfileRequest" } } ], "responses": { "201": { "description": "Success", "schema": { "$ref": "#/definitions/SnmpProfileResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized", "schema": { "$ref": "#/definitions/ApiError" } }, "403": { "description": "Forbidden", "schema": { "$ref": "#/definitions/ApiError" } }, "500": { "description": "Internal Error", "schema": { "$ref": "#/definitions/ApiError" } } } }, "get": { "tags": [ "Settings" ], "summary": "List the configured SNMP destination profiles", "description": "List the configured SNMP destination profiles. Only admin users can retrieve this information.", "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "Success", "schema": { "$ref": "#/definitions/SnmpProfileListResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized", "schema": { "$ref": "#/definitions/ApiError" } }, "403": { "description": "Forbidden", "schema": { "$ref": "#/definitions/ApiError" } }, "404": { "description": "Not Found", "schema": { "$ref": "#/definitions/ApiError" } }, "500": { "description": "Internal Error" } } } }, "/settings/snmp/profiles/send-test-trap": { "post": { "tags": [ "Settings" ], "summary": "Send Test trap to SNMP destination profile", "description": "Send Test trap to SNMP destination profile. Only admin users can perform this action.", "security": [ { "ApiKeyAuth": [ ] } ], "parameters": [ { "in": "body", "name": "body", "description": "SNMP destination profile", "required": true, "schema": { "$ref": "#/definitions/SnmpProfileRequest" } } ], "responses": { "200": { "description": "Success", "schema": { "$ref": "#/definitions/TestSnmpProfileResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized", "schema": { "$ref": "#/definitions/ApiError" } }, "403": { "description": "Forbidden", "schema": { "$ref": "#/definitions/ApiError" } }, "500": { "description": "Internal Error", "schema": { "$ref": "#/definitions/ApiError" } } } } }, "/settings/snmp/profiles/{id}": { "get": { "tags": [ "Settings" ], "summary": "Get details of an existing SNMP destination profile", "description": "Get details of an existing SNMP destination profile. Only admin users can perform this action.", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/SnmpProfileResponse" } }, "401": { "description": "Unauthorized", "schema": { "$ref": "#/definitions/ApiError" } }, "404": { "description": "Not Found", "schema": { "$ref": "#/definitions/ApiError" } }, "500": { "description": "Internal Error" } } }, "put": { "tags": [ "Settings" ], "summary": "Update an existing SNMP destination profile", "description": "Update an existing SNMP destination profile. Only admin users can perform this action.", "security": [ { "ApiKeyAuth": [ ] } ], "parameters": [ { "$ref": "#/parameters/Identifier" }, { "in": "body", "name": "body", "description": "SNMP destination profile", "required": true, "schema": { "$ref": "#/definitions/SnmpProfileRequest" } } ], "responses": { "200": { "description": "Success", "schema": { "$ref": "#/definitions/SnmpProfileResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized", "schema": { "$ref": "#/definitions/ApiError" } }, "403": { "description": "Forbidden", "schema": { "$ref": "#/definitions/ApiError" } }, "404": { "description": "Not Found", "schema": { "$ref": "#/definitions/ApiError" } }, "500": { "description": "Internal Error", "schema": { "$ref": "#/definitions/ApiError" } } } }, "delete": { "tags": [ "Settings" ], "summary": "Delete an existing SNMP destination profile", "description": "Delete an existing SNMP destination profile. Only admin users can perform this action.", "security": [ { "ApiKeyAuth": [ ] } ], "parameters": [ { "$ref": "#/parameters/Identifier" } ], "responses": { "204": { "description": "Success" }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized", "schema": { "$ref": "#/definitions/ApiError" } }, "403": { "description": "Forbidden", "schema": { "$ref": "#/definitions/ApiError" } }, "404": { "description": "Not Found", "schema": { "$ref": "#/definitions/ApiError" } }, "500": { "description": "Internal Error", "schema": { "$ref": "#/definitions/ApiError" } } } } }, "/settings/snmp/profiles/{id}/migrate-events": { "post": { "tags": [ "Settings" ], "summary": "Migrate event subscriptions to other SNMP destination profiles", "description": "Migrate event subscriptions from given SNMP profile to multiple other SNMP destination profiles.", "security": [ { "ApiKeyAuth": [ ] } ], "parameters": [ { "$ref": "#/parameters/Identifier" }, { "in": "body", "name": "body", "description": "SNMP destination profiles list", "required": true, "schema": { "$ref": "#/definitions/SnmpProfileIds" } } ], "responses": { "204": { "description": "Success" }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized", "schema": { "$ref": "#/definitions/ApiError" } }, "403": { "description": "Forbidden", "schema": { "$ref": "#/definitions/ApiError" } }, "404": { "description": "Not Found", "schema": { "$ref": "#/definitions/ApiError" } }, "500": { "description": "Internal Error", "schema": { "$ref": "#/definitions/ApiError" } } } } }, "/settings/events/user-defined-events": { "post": { "tags": [ "Settings" ], "summary": "Add new User defined event", "description": "Add new User defined event.", "operationId": "createUserDefinedEvent", "security": [ { "ApiKeyAuth": [ ] } ], "parameters": [ { "in": "body", "name": "body", "description": "Add new User defined events", "required": true, "schema": { "$ref": "#/definitions/SubscriptionRequest" } } ], "responses": { "201": { "description": "Success", "schema": { "$ref": "#/definitions/SubscriptionResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized", "schema": { "$ref": "#/definitions/ApiError" } }, "403": { "description": "Forbidden", "schema": { "$ref": "#/definitions/ApiError" } }, "500": { "description": "Internal Error", "schema": { "$ref": "#/definitions/ApiError" } } } }, "get": { "tags": [ "Settings" ], "summary": "List the created User Defined Event defintions.", "description": "List the created User Defined Event defintions.", "operationId": "getAllUserDefinedEvents", "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "Success", "schema": { "$ref": "#/definitions/SubscriptionListResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized", "schema": { "$ref": "#/definitions/ApiError" } }, "403": { "description": "Forbidden", "schema": { "$ref": "#/definitions/ApiError" } }, "404": { "description": "Not Found", "schema": { "$ref": "#/definitions/ApiError" } }, "500": { "description": "Internal Error" } } } }, "/settings/events/user-defined-events/{id}/enable": { "post": { "tags": [ "Settings" ], "summary": "Enable an existing User defined event", "description": "Enable an existing User defined event.", "operationId": "enableUserDefinedEvent", "security": [ { "ApiKeyAuth": [ ] } ], "parameters": [ { "$ref": "#/parameters/Identifier" } ], "responses": { "200": { "description": "Success", "schema": { "$ref": "#/definitions/SubscriptionResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized", "schema": { "$ref": "#/definitions/ApiError" } }, "403": { "description": "Forbidden", "schema": { "$ref": "#/definitions/ApiError" } }, "404": { "description": "Not Found", "schema": { "$ref": "#/definitions/ApiError" } }, "500": { "description": "Internal Error" } } } }, "/settings/events/user-defined-events/{id}/disable": { "post": { "tags": [ "Settings" ], "summary": "Disable an existing User defined event", "description": "Disable an existing User defined event.", "operationId": "disableUserDefinedEvent", "security": [ { "ApiKeyAuth": [ ] } ], "parameters": [ { "$ref": "#/parameters/Identifier" } ], "responses": { "200": { "description": "Success", "schema": { "$ref": "#/definitions/SubscriptionResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized", "schema": { "$ref": "#/definitions/ApiError" } }, "403": { "description": "Forbidden", "schema": { "$ref": "#/definitions/ApiError" } }, "404": { "description": "Not Found", "schema": { "$ref": "#/definitions/ApiError" } }, "500": { "description": "Internal Error" } } } }, "/settings/events/user-defined-events/{id}": { "get": { "tags": [ "Settings" ], "summary": "Get details of an existing User defined event.", "description": "Get details of an existing User defined event.", "operationId": "getUserDefinedEvent", "parameters": [ { "$ref": "#/parameters/Identifier" } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/SubscriptionResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized", "schema": { "$ref": "#/definitions/ApiError" } }, "404": { "description": "Not Found", "schema": { "$ref": "#/definitions/ApiError" } }, "500": { "description": "Internal Error" } } }, "put": { "tags": [ "Settings" ], "summary": "Update an existing User defined event.", "description": "Update an existing User defined event.", "operationId": "updateUserDefinedEvent", "security": [ { "ApiKeyAuth": [ ] } ], "parameters": [ { "$ref": "#/parameters/Identifier" }, { "in": "body", "name": "body", "description": "Update an existing User defined event.", "required": true, "schema": { "$ref": "#/definitions/SubscriptionRequest" } } ], "responses": { "200": { "description": "Success", "schema": { "$ref": "#/definitions/SubscriptionResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized", "schema": { "$ref": "#/definitions/ApiError" } }, "403": { "description": "Forbidden", "schema": { "$ref": "#/definitions/ApiError" } }, "404": { "description": "Not Found", "schema": { "$ref": "#/definitions/ApiError" } }, "500": { "description": "Internal Error" } } }, "delete": { "tags": [ "Settings" ], "summary": "Delete an existing User defined event", "description": "Delete an existing User defined event.", "operationId": "deleteUserDefinedEvent", "security": [ { "ApiKeyAuth": [ ] } ], "parameters": [ { "$ref": "#/parameters/Identifier" } ], "responses": { "204": { "description": "OK" }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/settings/backup": { "post": { "tags": [ "Settings" ], "summary": "Configure backup of setup data", "description": "Configure backup of setup data", "operationId": "addBackupConfig", "security": [ { "ApiKeyAuth": [ ] } ], "parameters": [ { "in": "body", "name": "body", "description": "Backup configuration", "required": true, "schema": { "$ref": "#/definitions/BackupRestoreRequest" } } ], "responses": { "201": { "description": "Success", "schema": { "$ref": "#/definitions/BackupRestoreRequest" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized", "schema": { "$ref": "#/definitions/ApiError" } }, "403": { "description": "Forbidden", "schema": { "$ref": "#/definitions/ApiError" } }, "500": { "description": "Internal Error", "schema": { "$ref": "#/definitions/ApiError" } } } }, "put": { "tags": [ "Settings" ], "summary": "Update Backup configuration", "description": "Update Backup configuration", "operationId": "updateBackupConfig", "security": [ { "ApiKeyAuth": [ ] } ], "parameters": [ { "in": "body", "name": "body", "description": "Updated Backup configuration", "required": true, "schema": { "$ref": "#/definitions/BackupRestoreRequest" } } ], "responses": { "201": { "description": "Success", "schema": { "$ref": "#/definitions/BackupRestoreRequest" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized", "schema": { "$ref": "#/definitions/ApiError" } }, "403": { "description": "Forbidden", "schema": { "$ref": "#/definitions/ApiError" } }, "500": { "description": "Internal Error", "schema": { "$ref": "#/definitions/ApiError" } } } }, "get": { "tags": [ "Settings" ], "summary": "Get Backup configuration", "description": "Get Backup configuration", "operationId": "getBackupConfig", "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/BackupRestoreRequest" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized", "schema": { "$ref": "#/definitions/ApiError" } }, "404": { "description": "Not Found", "schema": { "$ref": "#/definitions/ApiError" } }, "500": { "description": "Internal Error" } } }, "delete": { "tags": [ "Settings" ], "summary": "Delete existing Backup configuration", "description": "Delete existing Backup configuration.", "operationId": "deleteBackupConfig", "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "204": { "description": "OK" }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/settings/backup/status": { "get": { "tags": [ "Settings" ], "summary": "Get currently running or last Backup job status", "description": "Get currently running or last Backup job status", "operationId": "getBackupStatusReport", "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/BackupRestoreStatusResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized", "schema": { "$ref": "#/definitions/ApiError" } }, "404": { "description": "Not Found", "schema": { "$ref": "#/definitions/ApiError" } }, "500": { "description": "Internal Error" } } } }, "/settings/backup/enable": { "post": { "tags": [ "Settings" ], "summary": "Enable Backup", "description": "Enable Backup of config data", "operationId": "enableBackup", "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "204": { "description": "Success" }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized", "schema": { "$ref": "#/definitions/ApiError" } }, "404": { "description": "Not Found", "schema": { "$ref": "#/definitions/ApiError" } }, "500": { "description": "Internal Error" } } } }, "/settings/backup/disable": { "post": { "tags": [ "Settings" ], "summary": "Disable Backup", "description": "Disable Backup of config data", "operationId": "disableBackup", "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "204": { "description": "Success" }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized", "schema": { "$ref": "#/definitions/ApiError" } }, "404": { "description": "Not Found", "schema": { "$ref": "#/definitions/ApiError" } }, "500": { "description": "Internal Error" } } } }, "/settings/restore": { "post": { "tags": [ "Settings" ], "summary": "Configure restore of setup data, and triggers restore operation", "description": "Configure restore of setup data, and triggers restore operation", "operationId": "addRestoreConfig", "security": [ { "ApiKeyAuth": [ ] } ], "parameters": [ { "in": "body", "name": "body", "description": "Restore configuration", "required": true, "schema": { "$ref": "#/definitions/BackupRestoreRequest" } } ], "responses": { "201": { "description": "Success", "schema": { "$ref": "#/definitions/BackupRestoreRequest" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized", "schema": { "$ref": "#/definitions/ApiError" } }, "403": { "description": "Forbidden", "schema": { "$ref": "#/definitions/ApiError" } }, "500": { "description": "Internal Error", "schema": { "$ref": "#/definitions/ApiError" } } } }, "get": { "tags": [ "Settings" ], "summary": "Get Restore configuration", "description": "Get Restore configuration", "operationId": "getRestoreConfig", "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/BackupRestoreRequest" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized", "schema": { "$ref": "#/definitions/ApiError" } }, "404": { "description": "Not Found", "schema": { "$ref": "#/definitions/ApiError" } }, "500": { "description": "Internal Error" } } }, "delete": { "tags": [ "Settings" ], "summary": "Delete existing restore configuration", "description": "Delete existing restore configuration.", "operationId": "deleteRestoreConfig", "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "204": { "description": "OK" }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" }, "500": { "description": "Internal Error" } } } }, "/settings/restore/status": { "get": { "tags": [ "Settings" ], "summary": "Get currently running or last Restore job status", "description": "Get currently running or last Restore job status", "operationId": "getRestoreStatusReport", "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/BackupRestoreStatusResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized", "schema": { "$ref": "#/definitions/ApiError" } }, "404": { "description": "Not Found", "schema": { "$ref": "#/definitions/ApiError" } }, "500": { "description": "Internal Error" } } } }, "/path/firewall-rules": { "post": { "tags": [ "Path" ], "summary": "Get firewall rules for specified client server ips and port/protocol", "description": "Get firewall rules applicable in path for a client ip and server ip for specified port/protocol.", "operationId": "pathFirewallRules", "parameters": [ { "in": "body", "name": "body", "description": "VMware Identity Manager configuration details", "required": true, "schema": { "$ref": "#/definitions/PathFirewallRulesRequest" } } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "Success", "schema": { "$ref": "#/definitions/PathFirewallRules" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "500": { "description": "Internal Error" } } } }, "/logs/audit": { "post": { "tags": [ "Logs" ], "summary": "Get Audit logs", "description": "get audit logs based on filters specified in query", "operationId": "getAuditLogs", "parameters": [ { "in": "body", "name": "body", "description": "Query Filters", "required": true, "schema": { "$ref": "#/definitions/AuditRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/AuditListResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "500": { "description": "Internal Error" } } } }, "/schema/problems": { "get": { "tags": [ "Schema" ], "summary": "Get Event meta Information", "description": "Bulk fetch of event meta info. Max batch size is 1000.", "operationId": "bulkFetchEventMetaInfo", "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/EventMetaInfoResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "500": { "description": "Internal Error" } } } }, "/entities/vendor-infos/fetch": { "post": { "tags": [ "Entities" ], "summary": "Get Vendor Information of entities", "description": "Bulk fetch of vendor info. Max batch size is 1000.", "operationId": "bulkFetchVendorInfo", "parameters": [ { "in": "body", "name": "body", "schema": { "$ref": "#/definitions/FetchRequest" } } ], "security": [ { "ApiKeyAuth": [ ] } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/DetailedVendorInfoResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/ApiError" } }, "401": { "description": "Unauthorized" }, "500": { "description": "Internal Error" } } } } }, "definitions": { "UserCredential": { "type": "object", "properties": { "username": { "type": "string", "example": "admin@vrni.com" }, "password": { "type": "string", "example": "password" }, "domain": { "$ref": "#/definitions/Domain" } } }, "Domain": { "type": "object", "properties": { "domain_type": { "type": "string", "enum": [ "LDAP", "LOCAL" ], "example": "LDAP" }, "value": { "type": "string", "description": "domain value, not required for LOCAL domain", "example": "example.com" } } }, "Token": { "type": "object", "properties": { "token": { "type": "string" }, "expiry": { "description": "expiry epoch time in secs.", "type": "integer", "format": "int64" } } }, "VidmToken": { "type": "object", "properties": { "vidm_token": { "description": "User access token provided by VMware Identity Manager.", "type": "string" } } }, "VidmConfiguration": { "type": "object", "properties": { "vidm_appliance": { "type": "string", "description": "Provide fully quallified domain name of VMware Identity Manager", "example": "identity.domain.com" }, "client_id": { "type": "string", "description": "Register VMware vRealize Network Insight as an OAuth client to VMware Identity Manager and provide client-id" }, "client_secret": { "type": "string", "description": "Provide the registered OAuth client secret" }, "sha_thumbprint": { "type": "string", "description": "Optionally, provide SHA thumbprint to validate VMware Identity Manager appliance that is being configured" }, "enable": { "type": "boolean", "description": "True, to enable the VMware Identity Manager integration in vRealize Network Insight" } } }, "VidmConfigResponse": { "type": "object", "properties": { "vidm_appliance": { "type": "string", "description": "Fully quallified domain name of VMware Identity Manager", "example": "identity.domain.com" }, "client_id": { "description": "Client-id of the configured OAuth client", "type": "string" }, "enable": { "type": "boolean", "description": "True, if VMware Identity Manager integration is enabled" } } }, "VidmOauthClientResponse": { "type": "object", "properties": { "vidm_appliance": { "type": "string", "description": "Fully quallified domain name of VMware Identity Manager configured in vRealize Network Insight", "example": "identity.domain.com" }, "client_id": { "type": "string", "description": "Client-id of the password grant OAuth client" } } }, "UserType": { "type": "string", "description": "The type of user.", "enum": [ "LDAP", "LOCAL", "VIDM" ], "example": "VIDM" }, "UserGroupType": { "type": "string", "description": "The type of user-group.", "enum": [ "LDAP", "LOCAL", "VIDM" ], "example": "VIDM" }, "Role": { "type": "string", "description": "Role assigned the user/group.", "enum": [ "MEMBER", "ADMIN", "AUDITOR" ], "example": "ADMIN" }, "VidmUserRequest": { "type": "object", "properties": { "username": { "type": "string", "description": "Provide username (domain should not be part of username).", "example": "alleyMartin123" }, "domain": { "type": "string", "description": "Provide domain name to which user belongs to.", "example": "vidmlabs.com" }, "display_name": { "type": "string", "description": "Provide user's display name (could be \"givenName familyName\")", "example": "alley martin" }, "role": { "$ref": "#/definitions/Role" } }, "example": { "username": "alleymartin123", "domain": "vidmlabs.com", "display_name": "alley martin", "role": "ADMIN" } }, "UserResponse": { "type": "object", "properties": { "user_type": { "$ref": "#/definitions/UserType" }, "id": { "type": "string", "description": "Unique identifier assigned to user.", "example": "alleymartin123@vidmlabs.com" }, "role": { "$ref": "#/definitions/Role" }, "username": { "type": "string", "description": "Username of the user", "example": "alleyMartin123" }, "domain": { "type": "string", "description": "Domain name to which group belongs to.", "example": "vidmlabs.com" }, "display_name": { "type": "string", "description": "User's display name", "example": "alley martin" } }, "example": { "id": "alleymartin123@vidmlabs.com", "user_type": "VIDM", "username": "alleymartin123", "domain": "vidmlabs.com", "display_name": "alley martin", "role": "ADMIN" } }, "PagedUserListResponse": { "type": "object", "properties": { "results": { "type": "array", "items": { "$ref": "#/definitions/UserResponse" } }, "cursor": { "type": "string" }, "total_count": { "type": "integer" } } }, "VidmUserGroupRequest": { "type": "object", "properties": { "group_name": { "type": "string", "description": "Specify group name (domain should not be part of group name).", "example": "superAdmins" }, "domain": { "type": "string", "description": "Provide domain name to which user-group belongs to.", "example": "vidmlabs.com" }, "role": { "$ref": "#/definitions/Role" } }, "example": { "group_name": "testgroup", "domain": "vidmlabs.com", "role": "ADMIN" } }, "UserGroupResponse": { "type": "object", "properties": { "group_type": { "$ref": "#/definitions/UserGroupType" }, "id": { "type": "string", "description": "Unique identifier assigned to user-group.", "example": "testgroup@vidmlabs.com" }, "group_name": { "type": "string", "description": "Group-name of the user-group.", "example": "vrniAdmins" }, "domain": { "type": "string", "description": "Domain name to which user-group belongs to.", "example": "vidmlabs.com" }, "role": { "$ref": "#/definitions/Role" } }, "example": { "id": "testgroup@vidmlabs.com", "group_type": "VIDM", "group_name": "testgroup", "domain": "vidmlabs.com", "role": "ADMIN" } }, "PagedUserGroupListResponse": { "type": "object", "properties": { "results": { "type": "array", "items": { "$ref": "#/definitions/UserGroupResponse" } }, "cursor": { "type": "string" }, "total_count": { "type": "integer" } } }, "FileServerType": { "type": "string", "description": "File Server type.", "enum": [ "LOCAL", "SSH", "FTP" ], "example": "SSH" }, "LocalFileServer": { "type": "object", "properties": { "backup_directory": { "type": "string", "description": "Directory on file server to store/fetch backups", "example": "/home/testuser" }, "backup_file_name": { "type": "string", "description": "filename of the backup to be restored (used during restore only)", "example": "vrni-backup-12-4-5.tar" } } }, "SshFileServer": { "type": "object", "properties": { "server_address": { "type": "string", "description": "IP address or hostname of destination SSH file server", "example": "10.234.12.134" }, "port": { "type": "integer", "description": "File transfer port", "example": 22 }, "username": { "type": "string", "description": "username to login ssh server", "example": "testuser" }, "password": { "type": "string", "description": "password for the user to login ssh server", "example": "password" }, "backup_directory": { "type": "string", "description": "directory on file server to store/fetch backups", "example": "/home/testuser" }, "backup_file_name": { "type": "string", "description": "filename of the backup to be restored (used during restore only)", "example": "vrni-backup-12-4-5.tar" } } }, "FtpFileServer": { "type": "object", "properties": { "server_address": { "type": "string", "description": "IP address or hostname of destination FTP file server", "example": "10.234.12.134" }, "port": { "type": "integer", "description": "File transfer port", "example": 21 }, "username": { "type": "string", "description": "username to login FTP server", "example": "testuser" }, "password": { "type": "string", "description": "password for the user to login FTP server", "example": "password" }, "backup_directory": { "type": "string", "description": "directory on file server to store/fetch backups", "example": "/home/testuser" }, "backup_file_name": { "type": "string", "description": "filename of the backup to be restored (used during restore only)", "example": "vrni-backup-12-4-5.tar" } } }, "BackupSchedulePeriod": { "type": "string", "description": "Backup Schedule period.", "enum": [ "DAILY", "WEEKLY" ], "example": "DAILY" }, "BackupSchedule": { "type": "object", "properties": { "enable": { "type": "boolean", "default": true, "description": "True, to enable scheduled backup" }, "schedule_period": { "$ref": "#/definitions/BackupSchedulePeriod" }, "minute": { "type": "integer", "description": "The minute at which backup needs to run (permitted values 0 - 59)", "example": 30 }, "hour": { "type": "integer", "description": "The hour at which backup needs to run (permitted values 0 - 23)", "example": 12 }, "day_of_week": { "type": "integer", "description": "The day of the week when backup to be scheduled (permitted values 1 - 7)", "example": 1 } } }, "ConfigDataFilter": { "type": "object", "properties": { "applications": { "type": "boolean", "default": true }, "snmp": { "type": "boolean", "default": true }, "smtp": { "type": "boolean", "default": true }, "data_sources": { "type": "boolean", "default": true }, "analytics_thresholds": { "type": "boolean", "default": true }, "analytics_outliers": { "type": "boolean", "default": true }, "events": { "type": "boolean", "default": true }, "syslog": { "type": "boolean", "default": true }, "pinboards": { "type": "boolean", "default": true }, "ldap": { "type": "boolean", "default": true }, "vidm": { "type": "boolean", "default": true }, "user_data": { "type": "boolean", "default": true }, "user_preferences": { "type": "boolean", "default": true }, "physical_subnet_vlan": { "type": "boolean", "default": true }, "saved_searches": { "type": "boolean", "default": true }, "physical_ip_dns_mapping": { "type": "boolean", "default": true }, "east_west_ip": { "type": "boolean", "default": true }, "north_south_ip": { "type": "boolean", "default": true } } }, "BackupRestoreRequest": { "type": "object", "properties": { "config_filter": { "$ref": "#/definitions/ConfigDataFilter" }, "backup_schedule": { "$ref": "#/definitions/BackupSchedule" }, "backup_file_server_type": { "$ref": "#/definitions/FileServerType" }, "local_file_server": { "$ref": "#/definitions/LocalFileServer" }, "ssh_file_server": { "$ref": "#/definitions/SshFileServer" }, "ftp_file_server": { "$ref": "#/definitions/FtpFileServer" }, "schedule_now": { "type": "boolean", "default": false, "description": "True, to run backup now (on demand)" } } }, "BackupRestoreStatusResponse": { "type": "object", "properties": { "status": { "type": "string", "description": "Status of currently executing or last backup-restore job", "example": "IN_PROGRESS" }, "backup_file_name": { "type": "string", "description": "File name of backup tar file", "example": "vrni_backup-10000-2020-12-15-13-00-40.tar" }, "status_updated_timestamp": { "type": "string", "description": "TimeStamp of the last status update", "example": 1589908165162 } } }, "SnmpProfileRequest": { "type": "object", "properties": { "nick_name": { "type": "string", "description": "Descriptor or identifier for particular snmp profile.", "example": "Aws collector profile" }, "target_ip": { "type": "string", "description": "IP address of SNMP target destination", "example": "10.11.11.102" }, "target_port": { "type": "integer", "description": "Receiving port number of SNMP target destination", "example": 161 }, "snmp_version": { "type": "string", "enum": [ "v2c", "v3" ] }, "snmp_v2c": { "$ref": "#/definitions/SNMP2cConfig" }, "snmp_v3": { "$ref": "#/definitions/SNMP3Config" } } }, "TestSnmpProfileResponse": { "type": "object", "properties": { "status": { "type": "boolean", "description": "Test trap sent successfully or not", "example": true }, "message": { "type": "string", "description": "Test snmp trap status message", "example": "Failed sending SNMP trap" } } }, "SnmpProfileResponse": { "type": "object", "properties": { "entity_id": { "type": "string", "description": "Entity Identifier for snmp profile.", "example": "snmp-er67ght8kn67" }, "nick_name": { "type": "string", "description": "User defined descriptor or identifier for particular snmp profile.", "example": "Aws collector profile" }, "target_ip": { "type": "string", "description": "IP address of SNMP target destination", "example": "10.11.11.102" }, "target_port": { "type": "integer", "description": "Receiving port number of SNMP target destination", "example": 161 }, "snmp_version": { "type": "string", "enum": [ "v2c", "v3" ] }, "snmp_v2c": { "$ref": "#/definitions/SNMP2cConfig" }, "snmp_v3": { "$ref": "#/definitions/SNMP3Config" } } }, "SnmpProfileListResponse": { "type": "object", "properties": { "results": { "type": "array", "items": { "$ref": "#/definitions/SnmpProfileResponse" } }, "total_count": { "type": "integer" } } }, "SnmpProfileIds": { "type": "object", "properties": { "snmp_profiles": { "type": "array", "items": { "type": "string" } } } }, "VCenterDataSource": { "allOf": [ { "$ref": "#/definitions/BaseDataSource" }, { "properties": { "credentials": { "$ref": "#/definitions/PasswordCredentials" }, "is_vmc": { "type": "boolean", "default": false } } } ], "example": { "entity_type": "VCenterDataSource", "entity_id": "1000:902:12890123", "ip": "192.168.10.1", "fqdn": "go.vc.org", "proxy_id": "1000:104:12313412", "credentials": { "username": "admin@vsphere.local", "password": "thePassword" }, "nickname": "vc1", "enabled": true, "notes": "VC 1" } }, "BaseDataSource": { "type": "object", "discriminator": "entity_type", "properties": { "entity_id": { "type": "string" }, "entity_type": { "$ref": "#/definitions/DataSourceType" }, "ip": { "type": "string", "example": "192.168.10.1" }, "fqdn": { "type": "string", "example": "your.domain.com" }, "proxy_id": { "type": "string", "description": "proxy vm which should register this vcenter", "example": "1000:104:12313412" }, "nickname": { "type": "string", "example": "vc1" }, "enabled": { "type": "boolean", "default": true }, "notes": { "type": "string" } } }, "ContainerBaseDataSource": { "type": "object", "discriminator": "entity_type", "allOf": [ { "$ref": "#/definitions/BaseDataSource" }, { "properties": { "manager_id": { "type": "string", "example": "192.168.10.1", "description": "Associated nsxt data source entity Id" }, "credentials": { "$ref": "#/definitions/K8SCredentials" } } } ] }, "BaseDataSourceRequest": { "type": "object", "required": [ "proxy_id", "nickname" ], "properties": { "ip": { "type": "string", "example": "192.168.10.1" }, "fqdn": { "type": "string", "example": "your.domain.com" }, "proxy_id": { "type": "string", "description": "proxy vm which should register this vcenter", "example": "1000:104:12313412" }, "nickname": { "type": "string", "example": "vc1" }, "enabled": { "type": "boolean", "default": true }, "notes": { "type": "string" } } }, "PKSSourceRequest": { "type": "object", "required": [ "proxy_id", "nickname" ], "properties": { "ip": { "type": "string", "example": "192.168.10.1" }, "fqdn": { "type": "string", "example": "your.domain.com" }, "proxy_id": { "type": "string", "description": "proxy vm which should register this pks", "example": "1000:104:12313412" }, "nickname": { "type": "string", "example": "vc1" }, "enabled": { "type": "boolean", "default": true }, "notes": { "type": "string" }, "manager_id": { "type": "string" } } }, "KubernetesSourceRequest": { "type": "object", "required": [ "proxy_id", "nickname" ], "properties": { "proxy_id": { "type": "string", "description": "proxy vm which should register this vcenter", "example": "1000:104:12313412" }, "nickname": { "type": "string", "example": "vc1" }, "enabled": { "type": "boolean", "default": true }, "notes": { "type": "string" } } }, "ServiceNowSourceRequest": { "type": "object", "required": [ "proxy_id", "nickname" ], "properties": { "proxy_id": { "type": "string", "description": "proxy vm which should register this vcenter", "example": "1000:104:12313412" }, "nickname": { "type": "string", "example": "snow1" }, "enabled": { "type": "boolean", "default": true }, "notes": { "type": "string" } } }, "VCenterDataSourceRequest": { "allOf": [ { "$ref": "#/definitions/BaseDataSourceRequest" }, { "properties": { "credentials": { "$ref": "#/definitions/PasswordCredentials" }, "is_vmc": { "type": "boolean", "default": false } } } ] }, "PasswordCredentials": { "type": "object", "required": [ "username" ], "properties": { "username": { "type": "string" }, "password": { "type": "string" } } }, "AzureCredentials": { "type": "object", "required": [ "azure_client", "azure_key", "azure_tenant", "azure_subscription" ], "properties": { "azure_client": { "type": "string" }, "azure_key": { "type": "string" }, "azure_tenant": { "type": "string" }, "azure_subscription": { "type": "string" } } }, "K8SCredentials": { "type": "object", "required": [ "kubeconfig" ], "properties": { "kubeconfig": { "type": "string" } } }, "AristaSwitchDataSource": { "allOf": [ { "$ref": "#/definitions/SwitchDataSource" } ], "example": { "entity_type": "AristaSwitchDataSource", "entity_id": "1000:906:12890123", "ip": "192.168.10.1", "fqdn": "go.vc.org", "proxy_id": "1000:104:12313412", "credentials": { "username": "readonly", "password": "thePassword" }, "nickname": "my nickname", "enabled": true, "notes": "my notes" } }, "JuniperSwitchDataSource": { "allOf": [ { "$ref": "#/definitions/SwitchDataSource" } ], "example": { "entity_type": "JuniperSwitchDataSource", "entity_id": "1000:909:12890123", "ip": "192.168.10.1", "fqdn": "go.vc.org", "proxy_id": "1000:104:12313412", "credentials": { "username": "readonly", "password": "thePassword" }, "nickname": "my nickname", "enabled": true, "notes": "my notes" } }, "GDDataSource": { "allOf": [ { "$ref": "#/definitions/SwitchDataSource" } ], "example": { "entity_type": "GDDataSource", "entity_id": "1000:XXX:12890124", "ip": "192.168.10.1", "fqdn": "example.fqdn.com", "proxy_id": "1000:104:12313412", "credentials": { "username": "readonly", "password": "thePassword" }, "nickname": "my nickname", "enabled": true, "notes": "my notes" } }, "F5BIGIPDataSource": { "allOf": [ { "$ref": "#/definitions/GDDataSource" } ], "example": { "entity_type": "F5BIGIPDataSource", "entity_id": "10000:952:12890124", "ip": "192.168.10.1", "fqdn": "example.fqdn.com", "proxy_id": "10000:104:12313412", "credentials": { "username": "readonly", "password": "thePassword" }, "nickname": "my nickname", "enabled": true, "notes": "my notes" } }, "HuaweiSwitchDataSource": { "allOf": [ { "$ref": "#/definitions/GDDataSource" } ], "example": { "entity_type": "HuaweiSwitchDataSource", "entity_id": "10000:960:12890124", "ip": "192.168.10.1", "fqdn": "example.fqdn.com", "proxy_id": "10000:104:12313412", "credentials": { "username": "readonly", "password": "thePassword" }, "nickname": "my nickname", "enabled": true, "notes": "my notes" } }, "HPESwitchDataSource": { "allOf": [ { "$ref": "#/definitions/GDDataSource" } ], "example": { "entity_type": "HPESwitchDataSource", "entity_id": "10000:1960:12890124", "ip": "192.168.10.1", "fqdn": "example.fqdn.com", "proxy_id": "10000:104:12313412", "credentials": { "username": "readonly", "password": "thePassword" }, "nickname": "my nickname", "enabled": true, "notes": "my notes" } }, "MellanoxSwitchDataSource": { "allOf": [ { "$ref": "#/definitions/GDDataSource" } ], "example": { "entity_type": "MellanoxSwitchDataSource", "entity_id": "10000:985:12890124", "ip": "192.168.10.1", "fqdn": "example.fqdn.com", "proxy_id": "10000:104:12313412", "credentials": { "username": "readonly", "password": "thePassword" }, "nickname": "my nickname", "enabled": true, "notes": "my notes" } }, "GenericSwitchDataSource": { "allOf": [ { "$ref": "#/definitions/BaseDataSource" } ], "example": { "entity_type": "GenericSwitchDataSource", "entity_id": "10000:963:12890124", "ip": "192.168.10.1", "fqdn": "example.fqdn.com", "proxy_id": "10000:104:12313412", "nickname": "my nickname", "enabled": true, "notes": "my notes" } }, "CiscoSwitchDataSource": { "allOf": [ { "$ref": "#/definitions/SwitchDataSource" }, { "properties": { "switch_type": { "$ref": "#/definitions/CiscoSwitchType" } } } ], "example": { "entity_type": "CiscoSwitchDataSource", "entity_id": "1000:905:12890123", "ip": "192.168.10.1", "fqdn": "go.vc.org", "proxy_id": "1000:104:12313412", "credentials": { "username": "readonly", "password": "thePassword" }, "nickname": "my nickname", "enabled": true, "notes": "my notes", "switch_type": "NEXUS_5K" } }, "DellSwitchDataSource": { "allOf": [ { "$ref": "#/definitions/SwitchDataSource" }, { "properties": { "switch_type": { "$ref": "#/definitions/DellSwitchType" } } } ], "example": { "entity_type": "DellSwitchDataSource", "entity_id": "1000:907:12890123", "ip": "192.168.10.1", "fqdn": "go.vc.org", "proxy_id": "1000:104:12313412", "credentials": { "username": "readonly", "password": "thePassword" }, "nickname": "my nickname", "enabled": true, "notes": "my notes", "switch_type": "S6000" } }, "BrocadeSwitchDataSource": { "allOf": [ { "$ref": "#/definitions/SwitchDataSource" } ], "example": { "entity_type": "BrocadeSwitchDataSource", "entity_id": "1000:908:12890123", "ip": "192.168.10.1", "fqdn": "go.vc.org", "proxy_id": "1000:104:12313412", "credentials": { "username": "readonly", "password": "thePassword" }, "nickname": "my nickname", "enabled": true, "notes": "my notes" } }, "UCSManagerDataSourceRequest": { "allOf": [ { "$ref": "#/definitions/SwitchDataSource" } ] }, "CiscoACIDataSourceRequest": { "allOf": [ { "$ref": "#/definitions/SwitchDataSource" } ] }, "HPVCManagerDataSourceRequest": { "allOf": [ { "$ref": "#/definitions/SwitchDataSource" } ] }, "HPOneViewManagerDataSourceRequest": { "allOf": [ { "$ref": "#/definitions/SwitchDataSource" } ] }, "UCSManagerDataSource": { "allOf": [ { "$ref": "#/definitions/SwitchDataSource" } ], "example": { "entity_type": "UCSManagerDataSource", "entity_id": "1000:912:12890123", "ip": "192.168.10.1", "fqdn": "go.vc.org", "proxy_id": "1000:104:12313412", "credentials": { "username": "readonly", "password": "thePassword" }, "nickname": "my nickname", "enabled": true, "notes": "my notes" } }, "CiscoACIDataSource": { "allOf": [ { "$ref": "#/definitions/SwitchDataSource" } ], "example": { "entity_type": "CiscoACIDataSource", "entity_id": "1000:912:12890123", "ip": "192.168.10.1", "fqdn": "go.vc.org", "proxy_id": "1000:104:12313412", "credentials": { "username": "readonly", "password": "thePassword" }, "nickname": "my nickname", "enabled": true, "notes": "my notes" } }, "HPVCManagerDataSource": { "allOf": [ { "$ref": "#/definitions/SwitchDataSource" } ], "example": { "entity_type": "HPVCManagerDataSource", "entity_id": "1000:914:12890123", "ip": "192.168.10.1", "fqdn": "go.vc.org", "proxy_id": "1000:104:12313412", "credentials": { "username": "readonly", "password": "thePassword" }, "nickname": "my nickname", "enabled": true, "notes": "my notes" } }, "HPOneViewManagerDataSource": { "allOf": [ { "$ref": "#/definitions/SwitchDataSource" } ], "example": { "entity_type": "HPOneViewManagerDataSource", "entity_id": "1000:915:12890123", "ip": "192.168.10.1", "fqdn": "go.vc.org", "proxy_id": "1000:104:12313412", "credentials": { "username": "readonly", "password": "thePassword" }, "nickname": "my nickname", "enabled": true, "notes": "my notes" } }, "SwitchDataSourceRequest": { "allOf": [ { "$ref": "#/definitions/BaseDataSourceRequest" }, { "properties": { "credentials": { "$ref": "#/definitions/PasswordCredentials" } } } ] }, "SwitchDataSource": { "allOf": [ { "$ref": "#/definitions/BaseDataSource" }, { "properties": { "credentials": { "$ref": "#/definitions/PasswordCredentials" } } } ] }, "CiscoSwitchDataSourceRequest": { "allOf": [ { "$ref": "#/definitions/SwitchDataSourceRequest" }, { "properties": { "switch_type": { "$ref": "#/definitions/CiscoSwitchType" } } } ] }, "JuniperSwitchDataSourceRequest": { "allOf": [ { "$ref": "#/definitions/SwitchDataSourceRequest" } ] }, "GDDataSourceRequest": { "allOf": [ { "$ref": "#/definitions/SwitchDataSourceRequest" } ] }, "F5BIGIPDataSourceRequest": { "allOf": [ { "$ref": "#/definitions/GDDataSourceRequest" } ] }, "HuaweiSwitchDataSourceRequest": { "allOf": [ { "$ref": "#/definitions/GDDataSourceRequest" } ] }, "HPESwitchDataSourceRequest": { "allOf": [ { "$ref": "#/definitions/GDDataSourceRequest" } ] }, "MellanoxSwitchDataSourceRequest": { "allOf": [ { "$ref": "#/definitions/GDDataSourceRequest" } ] }, "GenericSwitchDataSourceRequest": { "allOf": [ { "$ref": "#/definitions/BaseDataSourceRequest" } ] }, "AristaSwitchDataSourceRequest": { "allOf": [ { "$ref": "#/definitions/SwitchDataSourceRequest" } ] }, "BrocadeSwitchDataSourceRequest": { "allOf": [ { "$ref": "#/definitions/SwitchDataSourceRequest" } ] }, "DellSwitchDataSourceRequest": { "allOf": [ { "$ref": "#/definitions/SwitchDataSourceRequest" }, { "properties": { "switch_type": { "$ref": "#/definitions/DellSwitchType" } } } ] }, "DellOs10SwitchDataSourceRequest": { "allOf": [ { "$ref": "#/definitions/SwitchDataSourceRequest" } ] }, "CiscoSwitchType": { "type": "string", "enum": [ "CATALYST_3000", "CATALYST_4500", "CATALYST_6500", "NEXUS_5K", "NEXUS_7K", "NEXUS_9K", "CISCOASRISR" ] }, "DellSwitchType": { "type": "string", "enum": [ "FORCE_10_MXL_10", "POWERCONNECT_8024", "S4048", "Z9100", "S6000" ] }, "CheckpointFirewallDataSource": { "allOf": [ { "$ref": "#/definitions/SwitchDataSource" } ], "example": { "entity_type": "CheckpointFirewallDataSource", "entity_id": "1000:910:12890123", "ip": "192.168.10.1", "fqdn": "go.vc.org", "proxy_id": "1000:104:12313412", "credentials": { "username": "readonly", "password": "thePassword" }, "nickname": "my nickname", "enabled": true, "notes": "my notes" } }, "PanFirewallDataSource": { "allOf": [ { "$ref": "#/definitions/SwitchDataSource" } ], "example": { "entity_type": "PanFirewallDataSource", "entity_id": "1000:911:12890123", "ip": "192.168.10.1", "fqdn": "go.vc.org", "proxy_id": "1000:104:12313412", "credentials": { "username": "readonly", "password": "thePassword" }, "nickname": "my nickname", "enabled": true, "notes": "my notes" } }, "CheckpointFirewallDataSourceRequest": { "allOf": [ { "$ref": "#/definitions/SwitchDataSourceRequest" } ] }, "PanFirewallDataSourceRequest": { "allOf": [ { "$ref": "#/definitions/SwitchDataSourceRequest" } ] }, "NSXVManagerDataSource": { "allOf": [ { "$ref": "#/definitions/BaseDataSource" }, { "properties": { "credentials": { "$ref": "#/definitions/PasswordCredentials" }, "vcenter_id": { "type": "string", "description": "Associated vcenter data source entity Id" }, "ipfix_enabled": { "type": "boolean", "default": false }, "central_cli_enabled": { "type": "boolean", "default": false }, "latency_enabled": { "type": "boolean", "default": false } } } ], "example": { "entity_type": "NSXVManagerDataSource", "entity_id": "1000:903:12890123", "ip": "192.168.10.1", "fqdn": "go.vc.org", "proxy_id": "1000:104:12313412", "credentials": { "username": "admin@vsphere.local", "password": "thePassword" }, "nickname": "my nickname", "enabled": true, "notes": "my notes", "vcenter_id": "1000:902:738163608", "ipfix_enabled": false, "central_cli_enabled": true, "latency_enabled": true } }, "FortinetFirewallDataSource": { "allOf": [ { "$ref": "#/definitions/SwitchDataSource" } ], "example": { "entity_type": "FortinetFirewallDataSource", "entity_id": "1000:744:12890123", "ip": "192.168.10.1", "fqdn": "go.vc.org", "proxy_id": "1000:104:12313412", "credentials": { "username": "readonly", "password": "thePassword" }, "nickname": "my nickname", "enabled": true, "notes": "my notes" } }, "FortinetFirewallDataSourceRequest": { "allOf": [ { "$ref": "#/definitions/SwitchDataSourceRequest" } ] }, "NSXTManagerDataSource": { "allOf": [ { "$ref": "#/definitions/SwitchDataSource" }, { "properties": { "ipfix_enabled": { "type": "boolean", "default": false }, "latency_enabled": { "type": "boolean", "default": false } } } ], "example": { "entity_type": "NSXTManagerDataSource", "entity_id": "1000:904:12890123", "ip": "192.168.10.1", "fqdn": "go.nsxt.org", "proxy_id": "1000:104:12313412", "credentials": { "username": "admin@vsphere.local", "password": "thePassword" }, "nickname": "my nickname", "enabled": true, "notes": "my notes", "ipfix_enabled": false, "latency_enabled": false } }, "PKSDataSource": { "allOf": [ { "$ref": "#/definitions/BaseDataSource" }, { "properties": { "credentials": { "$ref": "#/definitions/PasswordCredentials" }, "manager_id": { "type": "string", "description": "Associated nsx-t manager entity Id" } } } ], "example": { "entity_type": "PKSDataSource", "entity_id": "1000:904:12890123", "ip": "192.168.10.1", "fqdn": "go.pks.org", "proxy_id": "1000:104:12313412", "credentials": { "username": "admin@vsphere.local", "password": "thePassword" }, "nickname": "my nickname", "enabled": true, "notes": "my notes" } }, "KubernetesDataSource": { "allOf": [ { "$ref": "#/definitions/ContainerBaseDataSource" } ], "example": { "entity_type": "KubernetesDataSource", "entity_id": "1000:904:12890123", "manager_id": "192.168.10.1", "proxy_id": "1000:104:12313412", "credentials": { "username": "admin@vsphere.local", "password": "thePassword" }, "nickname": "my nickname", "enabled": true, "notes": "my notes" } }, "AzureDataSource": { "allOf": [ { "$ref": "#/definitions/BaseDataSource" }, { "properties": { "credentials": { "$ref": "#/definitions/AzureCredentials" }, "flows_enabled": { "type": "boolean", "default": false } } } ], "example": { "entity_type": "AzureDataSource", "entity_id": "1000:966:12890123", "proxy_id": "1000:104:12313412", "nickname": "my nickname", "enabled": true, "notes": "my notes", "flows_enabled": false } }, "ServiceNowDataSource": { "allOf": [ { "$ref": "#/definitions/SwitchDataSource" }, { "properties": { "instance_id": { "type": "string", "example": "dev36113.service-now.com", "description": "Associated nsxt data source entity Id" }, "graph_configuration": { "type": "string", "description": "CMDB configuration for CIs, relationships and graph traversal rules" }, "is_graph_config_customized": { "type": "boolean", "description": "Has graph configuration been modified from the default configuration" } } } ], "example": { "entity_type": "ServiceNowDataSource", "entity_id": "1000:863:12890123", "instance_id": "dev1337.service-now.com", "proxy_id": "1000:104:12313412", "credentials": { "username": "admin", "password": "my password" }, "nickname": "my nickname", "enabled": true, "notes": "my notes" } }, "InfobloxManagerDataSource": { "allOf": [ { "$ref": "#/definitions/SwitchDataSource" } ], "example": { "entity_type": "InfobloxManagerDataSource", "entity_id": "1000:905:12890123", "ip": "192.168.10.1", "fqdn": "go.nsxt.org", "proxy_id": "1000:104:12313412", "credentials": { "username": "admin@vsphere.local", "password": "thePassword" }, "nickname": "my nickname", "enabled": true, "notes": "my notes" } }, "PolicyManagerDataSource": { "allOf": [ { "$ref": "#/definitions/BaseDataSource" }, { "properties": { "csp_refresh_token": { "type": "string" }, "vcenter_id": { "type": "string", "description": "Associated vcenter data source entity Id" }, "ipfix_enabled": { "type": "boolean", "default": false } } } ], "example": { "entity_type": "PolicyManagerDataSource", "entity_id": "1000:928:12890123", "ip": "192.168.10.1", "fqdn": "go.nsxt.org", "proxy_id": "1000:104:12313412", "nickname": "my nickname", "enabled": true, "notes": "my notes", "vcenter_id": "1000:902:738163608", "csp_refresh_token": "e9fb6352-03cb-4d98-8f03-b82226c17507", "ipfix_enabled": false } }, "VeloCloudDataSource": { "allOf": [ { "$ref": "#/definitions/BaseDataSource" }, { "properties": { "credentials": { "$ref": "#/definitions/PasswordCredentials" } } } ], "example": { "entity_type": "VeloCloudDataSource", "entity_id": "1000:962:12890123", "ip": "192.168.10.1", "fqdn": "vco.velocloud.net", "proxy_id": "1000:5200:12313412", "credentials": { "username": "admin@velocloud", "password": "thePassword" }, "nickname": "my nickname", "enabled": true, "notes": "my notes" } }, "NSXControllerDataCollection": { "type": "object", "properties": { "enabled": { "type": "boolean", "default": false }, "controller_password": { "type": "string" } } }, "NSXVManagerDataSourceRequest": { "allOf": [ { "$ref": "#/definitions/BaseDataSourceRequest" }, { "properties": { "credentials": { "$ref": "#/definitions/PasswordCredentials" }, "vcenter_id": { "type": "string", "description": "Associated vcenter data source entity Id" }, "ipfix_enabled": { "type": "boolean", "default": false }, "central_cli_enabled": { "type": "boolean", "default": false }, "latency_enabled": { "type": "boolean", "default": false } }, "required": [ "vcenter_id", "credentials" ] } ] }, "PKSDataSourceRequest": { "allOf": [ { "$ref": "#/definitions/BaseDataSourceRequest" }, { "properties": { "credentials": { "$ref": "#/definitions/PasswordCredentials" }, "manager_id": { "type": "string", "description": "Associated nsxt data source entity Id" } }, "required": [ "credentials", "manager_id" ] } ] }, "NSXTManagerDataSourceRequest": { "allOf": [ { "$ref": "#/definitions/BaseDataSourceRequest" }, { "properties": { "credentials": { "$ref": "#/definitions/PasswordCredentials" }, "ipfix_enabled": { "type": "boolean", "default": false }, "latency_enabled": { "type": "boolean", "default": false } }, "required": [ "credentials" ] } ] }, "KubernetesDataSourceRequest": { "allOf": [ { "$ref": "#/definitions/KubernetesSourceRequest" }, { "properties": { "credentials": { "$ref": "#/definitions/K8SCredentials" }, "manager_id": { "type": "string", "example": "192.168.10.1", "description": "Associated nsxt data source entity Id" } }, "required": [ "credentials", "manager_id" ] } ] }, "AzureDataSourceRequest": { "allOf": [ { "$ref": "#/definitions/BaseDataSourceRequest" }, { "properties": { "credentials": { "$ref": "#/definitions/AzureCredentials" }, "flows_enabled": { "type": "boolean", "default": false } }, "required": [ "credentials" ] } ] }, "VeloCloudDataSourceRequest": { "allOf": [ { "$ref": "#/definitions/BaseDataSourceRequest" }, { "properties": { "credentials": { "$ref": "#/definitions/PasswordCredentials" } }, "required": [ "credentials" ] } ] }, "ServiceNowDataSourceRequest": { "allOf": [ { "$ref": "#/definitions/ServiceNowSourceRequest" }, { "properties": { "credentials": { "$ref": "#/definitions/PasswordCredentials" }, "instance_id": { "type": "string", "example": "dev36113.service-now.com", "description": "Associated service now instance" }, "graph_configuration": { "type": "string", "description": "CMDB configuration for CIs, relationships and graph traversal rules" }, "is_graph_config_customized": { "type": "boolean", "description": "Has graph configuration been modified from the default configuration" } }, "required": [ "credentials", "instance_id", "is_graph_config_customized" ] } ] }, "InfobloxManagerDataSourceRequest": { "allOf": [ { "$ref": "#/definitions/BaseDataSourceRequest" }, { "properties": { "credentials": { "$ref": "#/definitions/PasswordCredentials" } }, "required": [ "credentials" ] } ] }, "PolicyManagerDataSourceRequest": { "allOf": [ { "$ref": "#/definitions/BaseDataSourceRequest" }, { "properties": { "csp_refresh_token": { "type": "string" }, "vcenter_id": { "type": "string", "description": "Associated vcenter data source entity Id" }, "ipfix_enabled": { "type": "boolean", "default": false } }, "required": [ "vcenter_id", "csp_refresh_oken" ] } ] }, "DatasourceHealth": { "type": "object", "description": "Datasource Health state", "properties": { "health_status": { "type": "string", "enum": [ "HEALTHY", "HEALTHY_WITH_WARNINGS", "UNHEALTHY" ] }, "health_message": { "type": "string" }, "health_error_code": { "type": "string" } } }, "SNMPConfig": { "type": "object", "properties": { "snmp_enabled": { "type": "boolean", "default": false }, "snmp_version": { "type": "string", "enum": [ "v2c", "v3" ] }, "config_snmp_2c": { "$ref": "#/definitions/SNMP2cConfig" }, "config_snmp_3": { "$ref": "#/definitions/SNMP3Config" } } }, "SNMP3Config": { "type": "object", "properties": { "username": { "type": "string" }, "context_name": { "type": "string" }, "authentication_type": { "type": "string", "enum": [ "NO_AUTH", "MD5", "SHA" ] }, "authentication_password": { "type": "string" }, "privacy_type": { "type": "string", "enum": [ "AES", "DES", "AES128", "AES192", "AES256", "3DES", "NO_PRIV" ] }, "privacy_password": { "type": "string" } } }, "SNMP2cConfig": { "type": "object", "properties": { "community_string": { "type": "string" } } }, "EntityId": { "type": "object", "properties": { "entity_id": { "type": "string", "description": "Entity Identifier", "example": "1000:104:12213212" }, "entity_type": { "$ref": "#/definitions/EntityType" } } }, "DataSourceEntityId": { "type": "object", "properties": { "entity_id": { "type": "string", "description": "Entity Identifier", "example": "1000:104:12213212" }, "entity_type": { "$ref": "#/definitions/DataSourceType" } } }, "FetchRequest": { "type": "object", "properties": { "entity_ids": { "type": "array", "items": { "type": "object", "properties": { "entity_id": { "type": "string", "description": "Entity Identifier" }, "entity_type": { "$ref": "#/definitions/EntityType" }, "time": { "type": "integer", "format": "int64" } } } } } }, "EntityIdWithTime": { "type": "object", "properties": { "entity_id": { "type": "string", "description": "Entity Identifier" }, "entity_type": { "$ref": "#/definitions/EntityType" }, "time": { "type": "integer", "format": "int64" } } }, "EC2Instance": { "allOf": [ { "$ref": "#/definitions/BaseVirtualMachine" }, { "properties": { "vpc": { "$ref": "#/definitions/Reference" }, "region": { "type": "string" } } } ] }, "AzureVM": { "allOf": [ { "$ref": "#/definitions/BaseVirtualMachine" }, { "properties": { "vnet": { "$ref": "#/definitions/Reference" }, "region": { "type": "string" } } } ] }, "VirtualMachine": { "allOf": [ { "$ref": "#/definitions/BaseVirtualMachine" }, { "properties": { "cluster": { "$ref": "#/definitions/Reference" }, "resource_pool": { "$ref": "#/definitions/Reference" }, "security_tags": { "type": "array", "items": { "$ref": "#/definitions/Reference" } }, "layer2_networks": { "type": "array", "items": { "$ref": "#/definitions/Reference" } }, "host": { "$ref": "#/definitions/Reference" }, "vlans": { "type": "array", "items": { "$ref": "#/definitions/Vlan" } }, "vendor_id": { "type": "string" }, "vcenter_manager": { "$ref": "#/definitions/Reference" }, "folders": { "type": "array", "items": { "$ref": "#/definitions/Reference" } }, "datastores": { "type": "array", "items": { "$ref": "#/definitions/Reference" } }, "datacenter": { "$ref": "#/definitions/Reference" }, "nsx_manager": { "$ref": "#/definitions/Reference" }, "source_inversion_rules": { "type": "array", "items": { "$ref": "#/definitions/RuleSet" } }, "destination_inversion_rules": { "type": "array", "items": { "$ref": "#/definitions/RuleSet" } }, "cpu_count": { "type": "integer", "format": "int32" }, "memory": { "type": "integer", "format": "int32" } } } ] }, "BaseVirtualMachine": { "type": "object", "allOf": [ { "$ref": "#/definitions/BaseEntity" }, { "properties": { "ip_addresses": { "type": "array", "items": { "$ref": "#/definitions/IpV4Address" } }, "default_gateway": { "type": "string" }, "vnics": { "type": "array", "items": { "$ref": "#/definitions/Reference" } }, "security_groups": { "type": "array", "items": { "$ref": "#/definitions/Reference" } }, "source_firewall_rules": { "type": "array", "items": { "$ref": "#/definitions/RuleSet" } }, "destination_firewall_rules": { "type": "array", "items": { "$ref": "#/definitions/RuleSet" } }, "ip_sets": { "type": "array", "items": { "$ref": "#/definitions/Reference" } } } } ] }, "Cluster": { "type": "object", "allOf": [ { "$ref": "#/definitions/BaseEntity" }, { "properties": { "total_cpus": { "type": "integer", "format": "int32" }, "total_memory": { "type": "integer", "format": "int64" }, "num_cpu_cores": { "type": "integer", "format": "int32" }, "vendor_id": { "type": "string" }, "num_hosts": { "type": "integer", "format": "int32" }, "num_datastores": { "type": "integer", "format": "int32" }, "nsx_manager": { "$ref": "#/definitions/Reference" }, "vcenter_manager": { "$ref": "#/definitions/Reference" } } } ] }, "SecurityTag": { "allOf": [ { "$ref": "#/definitions/BaseEntity" }, { "properties": { "description": { "type": "string" }, "direct_security_groups": { "type": "array", "items": { "$ref": "#/definitions/Reference" } }, "security_groups": { "type": "array", "items": { "$ref": "#/definitions/Reference" } }, "vendor_id": { "type": "string" }, "nsx_manager": { "$ref": "#/definitions/Reference" } } } ] }, "ResourcePool": { "allOf": [ { "$ref": "#/definitions/BaseEntity" }, { "properties": { "vcenter_manager": { "$ref": "#/definitions/Reference" }, "vendor_id": { "type": "string" } } } ] }, "Host": { "allOf": [ { "$ref": "#/definitions/BaseEntity" }, { "properties": { "vmknics": { "type": "array", "items": { "$ref": "#/definitions/Reference" } }, "cluster": { "$ref": "#/definitions/Reference" }, "vcenter_manager": { "$ref": "#/definitions/Reference" }, "vm_count": { "type": "integer", "format": "int32" }, "datastores": { "type": "array", "items": { "$ref": "#/definitions/Reference" } }, "service_tag": { "type": "string" }, "vendor_id": { "type": "string" }, "nsx_manager": { "$ref": "#/definitions/Reference" }, "maintenance_mode": { "type": "string" }, "connection_state": { "type": "string" } } } ] }, "DistributedVirtualPortgroup": { "type": "object", "allOf": [ { "$ref": "#/definitions/BaseEntity" }, { "properties": { "vendor_id": { "type": "string" }, "vcenter_manager": { "$ref": "#/definitions/Reference" }, "distributed_virtual_switch": { "$ref": "#/definitions/Reference" } } } ] }, "DistributedVirtualSwitch": { "type": "object", "allOf": [ { "$ref": "#/definitions/BaseEntity" }, { "properties": { "vendor_id": { "type": "string" }, "vcenter_manager": { "$ref": "#/definitions/Reference" }, "hosts": { "type": "array", "items": { "$ref": "#/definitions/Reference" } } } } ] }, "VCDatacenter": { "type": "object", "allOf": [ { "$ref": "#/definitions/BaseEntity" }, { "properties": { "vendor_id": { "type": "string" }, "vcenter_manager": { "$ref": "#/definitions/Reference" } } } ] }, "Datastore": { "type": "object", "allOf": [ { "$ref": "#/definitions/BaseEntity" }, { "properties": { "vendor_id": { "type": "string" }, "vcenter_manager": { "$ref": "#/definitions/Reference" } } } ] }, "KubernetesService": { "type": "object", "allOf": [ { "$ref": "#/definitions/BaseEntity" }, { "properties": { "vendor_id": { "type": "string" }, "kubernetes_cluster": { "$ref": "#/definitions/Reference" }, "manager": { "$ref": "#/definitions/Reference" }, "annotations": { "type": "array", "items": { "type": "string" } }, "labels": { "type": "array", "items": { "type": "string" } }, "creation_timestamp": { "type": "string" }, "namespace": { "$ref": "#/definitions/Reference" }, "cluster_ip": { "$ref": "#/definitions/IpV4Address" }, "loadbalancer_ip": { "$ref": "#/definitions/IpV4Address" }, "type": { "type": "string" }, "external_ips": { "type": "array", "items": { "$ref": "#/definitions/IpV4Address" } }, "selectors": { "type": "array", "items": { "type": "string" } } } } ] }, "Folder": { "type": "object", "allOf": [ { "$ref": "#/definitions/BaseEntity" }, { "properties": { "vendor_id": { "type": "string" }, "vcenter_manager": { "$ref": "#/definitions/Reference" } } } ] }, "Reference": { "type": "object", "properties": { "entity_id": { "type": "string" }, "entity_type": { "$ref": "#/definitions/EntityType" } } }, "IpV4Address": { "type": "object", "properties": { "ip_address": { "type": "string" }, "netmask": { "type": "string" }, "network_address": { "type": "string" } } }, "Vmknic": { "allOf": [ { "$ref": "#/definitions/BaseEntity" }, { "properties": { "ip_addresses": { "type": "array", "items": { "$ref": "#/definitions/IpV4Address" } }, "vlan": { "$ref": "#/definitions/Vlan" }, "host": { "$ref": "#/definitions/Reference" }, "layer2_network": { "$ref": "#/definitions/Reference" } } } ] }, "EC2NetworkInterface": { "allOf": [ { "$ref": "#/definitions/BaseVnic" } ] }, "Vnic": { "allOf": [ { "$ref": "#/definitions/BaseVnic" } ] }, "BaseVnic": { "allOf": [ { "$ref": "#/definitions/BaseEntity" }, { "properties": { "ip_addresses": { "type": "array", "items": { "$ref": "#/definitions/IpV4Address" } }, "layer2_network": { "$ref": "#/definitions/Reference" }, "vlan": { "$ref": "#/definitions/Vlan" }, "vm": { "$ref": "#/definitions/Reference" } } } ] }, "VxlanLayer2Network": { "allOf": [ { "$ref": "#/definitions/BaseL2Network" }, { "properties": { "segment_id": { "type": "integer", "format": "int32" }, "vteps": { "type": "array", "items": { "$ref": "#/definitions/Reference" } }, "scope": { "$ref": "#/definitions/ScopeEnum" }, "nsx_managers": { "type": "array", "items": { "$ref": "#/definitions/Reference" } } } } ] }, "VlanL2Network": { "allOf": [ { "$ref": "#/definitions/BaseL2Network" }, { "properties": { "vlan_id": { "type": "string" }, "distributed_virtual_switches": { "type": "array", "items": { "$ref": "#/definitions/Reference" } }, "distributed_virtual_portgroups": { "type": "array", "items": { "$ref": "#/definitions/Reference" } } } } ] }, "BaseL2Network": { "allOf": [ { "$ref": "#/definitions/BaseEntity" }, { "properties": { "network_addresses": { "type": "array", "items": { "type": "string" } }, "gateways": { "type": "array", "items": { "type": "string" } } } } ] }, "Vlan": { "type": "object", "properties": { "begin": { "type": "integer", "x-searchable": true }, "end": { "type": "integer" } } }, "NSXTIPSet": { "allOf": [ { "$ref": "#/definitions/BaseIPSet" }, { "properties": { "nsxt_managers": { "type": "array", "items": { "$ref": "#/definitions/Reference" } } } } ] }, "NSXIPSet": { "allOf": [ { "$ref": "#/definitions/BaseIPSet" }, { "properties": { "nsx_managers": { "type": "array", "items": { "$ref": "#/definitions/Reference" } }, "scope": { "$ref": "#/definitions/ScopeEnum" } } } ] }, "EC2IPSet": { "allOf": [ { "$ref": "#/definitions/BaseIPSet" } ] }, "BaseIPSet": { "allOf": [ { "$ref": "#/definitions/BaseEntity" }, { "properties": { "ip_addresses": { "type": "array", "items": { "$ref": "#/definitions/IpV4Address" } }, "ip_ranges": { "type": "array", "items": { "$ref": "#/definitions/IpAddressRange" } }, "ip_numeric_ranges": { "type": "array", "items": { "$ref": "#/definitions/IpNumericRange" } }, "parent_security_groups": { "type": "array", "items": { "$ref": "#/definitions/Reference" } }, "direct_source_rules": { "type": "array", "items": { "$ref": "#/definitions/RuleSet" } }, "direct_destination_rules": { "type": "array", "items": { "$ref": "#/definitions/RuleSet" } }, "indirect_source_rules": { "type": "array", "items": { "$ref": "#/definitions/RuleSet" } }, "indirect_destination_rules": { "type": "array", "items": { "$ref": "#/definitions/RuleSet" } }, "vendor_id": { "type": "string" }, "vendor": { "type": "string" } } } ] }, "IpAddressRange": { "properties": { "start_ip": { "type": "string" }, "end_ip": { "type": "string" } } }, "IpNumericRange": { "properties": { "start": { "type": "integer", "format": "int64" }, "end": { "type": "integer", "format": "int64" } } }, "SddcType": { "type": "string", "enum": [ "ONPREM", "VMC" ] }, "NSXPolicyGroup": { "allOf": [ { "$ref": "#/definitions/BaseSecurityGroup" }, { "properties": { "realized_entities": { "type": "array", "items": { "$ref": "#/definitions/Reference" } }, "sddc_type": { "$ref": "#/definitions/SddcType" } } } ] }, "NSGroup": { "allOf": [ { "$ref": "#/definitions/BaseSecurityGroup" }, { "properties": { "nsxt_managers": { "type": "array", "items": { "$ref": "#/definitions/Reference" } }, "ip_sets": { "type": "array", "items": { "$ref": "#/definitions/Reference" } }, "security_tags": { "type": "array", "items": { "$ref": "#/definitions/Reference" } } } } ] }, "NSXSecurityGroup": { "allOf": [ { "$ref": "#/definitions/BaseSecurityGroup" }, { "properties": { "nsx_managers": { "type": "array", "items": { "$ref": "#/definitions/Reference" } }, "scope": { "$ref": "#/definitions/ScopeEnum" }, "ip_sets": { "type": "array", "items": { "$ref": "#/definitions/Reference" } }, "security_tags": { "type": "array", "items": { "$ref": "#/definitions/Reference" } } } } ] }, "EC2SecurityGroup": { "allOf": [ { "$ref": "#/definitions/BaseSecurityGroup" }, { "properties": { "vpc": { "$ref": "#/definitions/Reference" }, "region": { "type": "string" } } } ] }, "AzureASG": { "allOf": [ { "$ref": "#/definitions/BaseSecurityGroup" }, { "properties": { "vnet": { "$ref": "#/definitions/Reference" }, "region": { "type": "string" }, "security_tags": { "type": "array", "items": { "$ref": "#/definitions/Reference" } } } } ] }, "BaseSecurityGroup": { "allOf": [ { "$ref": "#/definitions/Group" }, { "properties": { "direct_source_rules": { "type": "array", "items": { "$ref": "#/definitions/RuleSet" } }, "direct_destination_rules": { "type": "array", "items": { "$ref": "#/definitions/RuleSet" } }, "indirect_source_rules": { "type": "array", "items": { "$ref": "#/definitions/RuleSet" } }, "indirect_destination_rules": { "type": "array", "items": { "$ref": "#/definitions/RuleSet" } }, "parents": { "type": "array", "items": { "$ref": "#/definitions/Reference" } }, "members": { "type": "array", "items": { "$ref": "#/definitions/Reference" } }, "direct_members": { "type": "array", "items": { "$ref": "#/definitions/Reference" } }, "vendor_id": { "type": "string" }, "excluded_members": { "type": "array", "items": { "$ref": "#/definitions/Reference" } } } } ] }, "RuleSet": { "type": "object", "properties": { "rules": { "type": "array", "items": { "$ref": "#/definitions/Reference" } }, "firewall": { "$ref": "#/definitions/Reference" }, "rule_set_type": { "type": "string", "enum": [ "NSX_STANDARD", "NSX_REDIRECT", "AWS_STANDARD", "NSXT_EDGE_FIREWALL", "ACCESS_RULE", "POLICYMANAGER_EMERGENCY_TYPE", "POLICYMANAGER_INFRASTRUCTURE_TYPE", "POLICYMANAGER_ENVIRONMENT_TYPE", "POLICYMANAGER_APPLICATION_TYPE", "POLICYMANAGER_ETHERNET_TYPE" ] } } }, "AppliedTo": { "type": "object", "properties": { "referred_entity": { "$ref": "#/definitions/EntityId" }, "name": { "type": "string" }, "value": { "type": "string" }, "vendor_type": { "type": "string" } } }, "BaseFirewallRule": { "allOf": [ { "$ref": "#/definitions/BaseEntity" }, { "properties": { "rule_id": { "type": "string" }, "section_id": { "type": "string" }, "section_name": { "type": "string" }, "sequence_number": { "type": "integer" }, "source_any": { "type": "boolean" }, "destination_any": { "type": "boolean" }, "service_any": { "type": "boolean" }, "sources": { "type": "array", "items": { "$ref": "#/definitions/Reference" } }, "destinations": { "type": "array", "items": { "$ref": "#/definitions/Reference" } }, "services": { "type": "array", "items": { "$ref": "#/definitions/Reference" } }, "action": { "$ref": "#/definitions/FirewallAction" }, "disabled": { "type": "boolean" }, "source_inversion": { "type": "boolean" }, "destination_inversion": { "type": "boolean" }, "port_ranges": { "type": "array", "items": { "$ref": "#/definitions/PortRange" } } } } ] }, "NSXFirewallRule": { "allOf": [ { "$ref": "#/definitions/BaseFirewallRule" }, { "properties": { "logging_enabled": { "type": "boolean" }, "direction": { "$ref": "#/definitions/FirewallDirection" }, "scope": { "$ref": "#/definitions/ScopeEnum" }, "nsx_managers": { "type": "array", "items": { "$ref": "#/definitions/Reference" } } } } ] }, "NSXTFirewallRule": { "allOf": [ { "$ref": "#/definitions/NSXFirewallRule" }, { "properties": { "applied_tos": { "type": "array", "items": { "$ref": "#/definitions/AppliedTo" } } } } ] }, "PolicyManagerFirewallRule": { "allOf": [ { "$ref": "#/definitions/BaseFirewallRule" }, { "properties": { "realized_entities": { "type": "array", "items": { "$ref": "#/definitions/Reference" } }, "sddc_type": { "$ref": "#/definitions/SddcType" } } } ] }, "NSXRedirectRule": { "allOf": [ { "$ref": "#/definitions/BaseFirewallRule" }, { "properties": { "logging_enabled": { "type": "boolean" }, "direction": { "$ref": "#/definitions/FirewallDirection" }, "service_profile": { "type": "string" } } } ] }, "CheckpointFirewallRule": { "allOf": [ { "$ref": "#/definitions/BaseGenericFirewallRule" } ] }, "BaseGenericFirewallRule": { "allOf": [ { "$ref": "#/definitions/BaseFirewallRule" }, { "properties": { "direction": { "$ref": "#/definitions/FirewallDirection" } } } ] }, "EC2SGFirewallRule": { "allOf": [ { "$ref": "#/definitions/BaseFirewallRule" }, { "properties": { "vpc": { "$ref": "#/definitions/Reference" }, "direction": { "$ref": "#/definitions/EC2FirewallDirection" }, "owner_security_group": { "$ref": "#/definitions/Reference" } } } ] }, "AzureNSGRule": { "allOf": [ { "$ref": "#/definitions/BaseFirewallRule" }, { "properties": { "direction": { "$ref": "#/definitions/EC2FirewallDirection" } } } ] }, "EC2FirewallDirection": { "type": "string", "enum": [ "INBOUND", "OUTBOUND" ] }, "FirewallDirection": { "type": "string", "enum": [ "IN", "OUT", "INOUT" ] }, "FirewallAction": { "type": "string", "enum": [ "ALLOW", "ACCEPT", "DENY", "DROP", "REJECT", "REDIRECT", "DO_NOT_REDIRECT" ] }, "Group": { "allOf": [ { "$ref": "#/definitions/BaseEntity" }, { "properties": { "members": { "type": "array", "items": { "$ref": "#/definitions/Reference" } } } } ] }, "VCenterManager": { "allOf": [ { "$ref": "#/definitions/BaseManager" }, { "properties": { "ip_address": { "$ref": "#/definitions/IpV4Address" }, "fqdn": { "type": "string" }, "vm": { "$ref": "#/definitions/Reference" }, "nsx_manager": { "$ref": "#/definitions/Reference" }, "vc_uuid": { "type": "string" } } } ] }, "NSXPolicyManager": { "allOf": [ { "$ref": "#/definitions/BaseNSXManager" }, { "properties": { "ip_address": { "$ref": "#/definitions/IpV4Address" }, "data_source": { "$ref": "#/definitions/Reference" }, "fqdn": { "type": "string" }, "enforcement_points": { "type": "array", "items": { "$ref": "#/definitions/Reference" } }, "sddc_type": { "$ref": "#/definitions/SddcType" }, "sddc": { "$ref": "#/definitions/Reference" } } } ] }, "NSXTManager": { "allOf": [ { "$ref": "#/definitions/BaseNSXManager" }, { "properties": { "fqdn": { "type": "string" }, "ip_address": { "$ref": "#/definitions/IpV4Address" }, "version": { "type": "string" } } } ] }, "NSXVManager": { "allOf": [ { "$ref": "#/definitions/BaseNSXManager" }, { "properties": { "fqdn": { "type": "string" }, "ip_address": { "$ref": "#/definitions/IpV4Address" }, "version": { "type": "string" }, "primary_nsx_manager": { "$ref": "#/definitions/Reference" }, "vm": { "$ref": "#/definitions/Reference" }, "role": { "type": "string" } } } ] }, "BaseNSXManager": { "allOf": [ { "$ref": "#/definitions/BaseManager" } ] }, "CheckpointMDSManager": { "allOf": [ { "$ref": "#/definitions/BaseFirewallManager" } ] }, "CheckpointManager": { "allOf": [ { "$ref": "#/definitions/BaseFirewallManager" } ] }, "BaseFirewallManager": { "allOf": [ { "$ref": "#/definitions/BaseManager" }, { "properties": { "nsx_manager": { "$ref": "#/definitions/Reference" }, "version": { "type": "string" }, "ip_address": { "$ref": "#/definitions/IpV4Address" } } } ] }, "BaseManager": { "allOf": [ { "$ref": "#/definitions/BaseEntity" } ] }, "Flow": { "allOf": [ { "$ref": "#/definitions/BaseEntity" }, { "properties": { "source_vm": { "$ref": "#/definitions/Reference" }, "destination_vm": { "$ref": "#/definitions/Reference" }, "source_vnic": { "$ref": "#/definitions/Reference" }, "destination_vnic": { "$ref": "#/definitions/Reference" }, "source_vpc": { "$ref": "#/definitions/Reference" }, "destination_vpc": { "$ref": "#/definitions/Reference" }, "source_cloud_network": { "$ref": "#/definitions/Reference" }, "destination_cloud_network": { "$ref": "#/definitions/Reference" }, "source_azure_nsg": { "$ref": "#/definitions/Reference" }, "destination_azure_nsg": { "$ref": "#/definitions/Reference" }, "source_datacenter": { "$ref": "#/definitions/Reference" }, "destination_datacenter": { "$ref": "#/definitions/Reference" }, "source_ip": { "$ref": "#/definitions/IpV4Address" }, "destination_ip": { "$ref": "#/definitions/IpV4Address" }, "source_l2_network": { "$ref": "#/definitions/Reference" }, "destination_l2_network": { "$ref": "#/definitions/Reference" }, "port": { "$ref": "#/definitions/PortRange" }, "source_folders": { "type": "array", "items": { "$ref": "#/definitions/Reference" } }, "destination_folders": { "type": "array", "items": { "$ref": "#/definitions/Reference" } }, "source_resource_pool": { "$ref": "#/definitions/Reference" }, "destination_resource_pool": { "$ref": "#/definitions/Reference" }, "source_cluster": { "$ref": "#/definitions/Reference" }, "destination_cluster": { "$ref": "#/definitions/Reference" }, "protocol": { "$ref": "#/definitions/Protocol" }, "source_ip_sets": { "type": "array", "items": { "$ref": "#/definitions/Reference" } }, "destination_ip_sets": { "type": "array", "items": { "$ref": "#/definitions/Reference" } }, "source_security_groups": { "type": "array", "items": { "$ref": "#/definitions/Reference" } }, "destination_security_groups": { "type": "array", "items": { "$ref": "#/definitions/Reference" } }, "traffic_type": { "$ref": "#/definitions/FlowTrafficType" }, "source_security_tags": { "type": "array", "items": { "$ref": "#/definitions/Reference" } }, "destination_security_tags": { "type": "array", "items": { "$ref": "#/definitions/Reference" } }, "source_host": { "$ref": "#/definitions/Reference" }, "destination_host": { "$ref": "#/definitions/Reference" }, "source_vm_tags": { "type": "array", "items": { "type": "string" } }, "destination_vm_tags": { "type": "array", "items": { "type": "string" } }, "within_host": { "type": "boolean" }, "firewall_action": { "$ref": "#/definitions/FirewallAction" }, "firewall_rule_id": { "type": "string" }, "flow_tag": { "type": "array", "items": { "$ref": "#/definitions/FlowTag" } } } } ] }, "FlowTag": { "type": "string", "enum": [ "TAG_TRAFFIC_TYPE_UNKNOWN", "TAG_INTERNET_TRAFFIC", "TAG_EAST_WEST_TRAFFIC", "TAG_VM_VM_TRAFFIC", "TAG_VM_PHY_TRAFFIC", "TAG_PHY_PHY_TRAFFIC", "TAG_SRC_IP_VMKNIC", "TAG_DST_IP_VMKNIC", "TAG_SRC_IP_VM", "TAG_DST_IP_VM", "TAG_SRC_IP_INTERNET", "TAG_DST_IP_INTERNET", "TAG_SRC_IP_PHYSICAL", "TAG_DST_IP_PHYSICAL", "TAG_SAME_HOST", "TAG_DIFF_HOST", "TAG_SHARED_SERVICE", "TAG_NOT_SHARED_SERVICE", "TAG_NETWORK_SWITCHED", "TAG_NETWORK_ROUTED", "TAG_NETWORK_UNKNOWN", "TAG_SRC_IP_VTEP", "TAG_DST_IP_VTEP", "TAG_UNICAST", "TAG_BROADCAST", "TAG_MULTICAST", "TAG_SRC_IP_LINK_LOCAL", "TAG_DST_IP_LINK_LOCAL", "TAG_SRC_IP_CLASS_E", "TAG_DST_IP_CLASS_E", "TAG_SRC_IP_CLASS_A_RESERVED", "TAG_DST_IP_CLASS_A_RESERVED", "TAG_INVALID_IP_PACKETS", "TAG_NOT_ANALYZED", "TAG_GENERIC_INTERNET_SRC_IP", "TAG_SNAT_DNAT_FLOW", "TAG_MULTINICS", "TAG_SRC_VC", "TAG_DST_VC", "TAG_SRC_AWS", "TAG_DST_AWS", "TAG_WITHIN_DC", "TAG_DIFF_DC", "TAG_WITHIN_VPC", "TAG_DIFF_VPC", "TAG_WITHIN_VNET", "TAG_DIFF_VNET", "TAG_SRC_AZURE", "TAG_DST_AZURE" ] }, "Protocol": { "type": "string", "enum": [ "TCP", "UDP", "OTHER" ] }, "FlowTrafficType": { "type": "string", "enum": [ "INTERNET_TRAFFIC", "EAST_WEST_TRAFFIC" ] }, "ScopeEnum": { "type": "string", "enum": [ "UNIVERSAL", "GLOBAL" ] }, "PortRange": { "type": "object", "properties": { "start": { "type": "integer", "format": "int32" }, "end": { "type": "integer", "format": "int32" }, "display": { "type": "string" }, "iana_name": { "type": "string" }, "iana_port_display": { "type": "string" } } }, "SimplePortRange": { "type": "object", "properties": { "start": { "type": "integer", "format": "int32" }, "end": { "type": "integer", "format": "int32" } } }, "NSService": { "allOf": [ { "$ref": "#/definitions/BaseService" }, { "properties": { "nsxt_managers": { "type": "array", "items": { "$ref": "#/definitions/Reference" } }, "vendor_id": { "type": "string" } } } ] }, "NSXService": { "allOf": [ { "$ref": "#/definitions/BaseService" }, { "properties": { "nsx_managers": { "type": "array", "items": { "$ref": "#/definitions/Reference" } }, "scope": { "$ref": "#/definitions/ScopeEnum" }, "vendor_id": { "type": "string" } } } ] }, "BaseService": { "allOf": [ { "$ref": "#/definitions/BaseEntity" }, { "properties": { "protocol": { "type": "string" }, "port_ranges": { "type": "array", "items": { "$ref": "#/definitions/PortRange" } } } } ] }, "EC2Service": { "allOf": [ { "$ref": "#/definitions/BaseService" } ] }, "NSServiceGroup": { "allOf": [ { "$ref": "#/definitions/BaseServiceGroup" }, { "properties": { "nsxt_managers": { "type": "array", "items": { "$ref": "#/definitions/Reference" } }, "vendor_id": { "type": "string" } } } ] }, "NSXServiceGroup": { "allOf": [ { "$ref": "#/definitions/BaseServiceGroup" }, { "properties": { "scope": { "$ref": "#/definitions/ScopeEnum" }, "nsx_managers": { "type": "array", "items": { "$ref": "#/definitions/Reference" } }, "vendor_id": { "type": "string" } } } ] }, "BaseServiceGroup": { "allOf": [ { "$ref": "#/definitions/Group" } ] }, "VPC": { "allOf": [ { "$ref": "#/definitions/BaseEntity" }, { "properties": { "cidr_block": { "$ref": "#/definitions/IpV4Address" }, "state": { "type": "string" }, "region": { "type": "string" }, "default_vpc": { "type": "boolean" }, "vendor_id": { "type": "string" }, "last_synched_time": { "type": "integer", "format": "int64" } } } ] }, "CloudNetwork": { "allOf": [ { "$ref": "#/definitions/BaseEntity" }, { "properties": { "peer_cloud_networks": { "type": "array", "items": { "$ref": "#/definitions/Reference" } }, "address_spaces": { "type": "array", "items": { "$ref": "#/definitions/IpV4Address" } }, "provisioned_state": { "type": "string" }, "regions": { "type": "array", "items": { "type": "string" } }, "vendor_id": { "type": "string" } } } ] }, "NSXDistributedFirewall": { "allOf": [ { "$ref": "#/definitions/BaseFirewall" }, { "properties": { "vendor_id": { "type": "string" } } } ] }, "EC2Firewall": { "allOf": [ { "$ref": "#/definitions/BaseFirewall" } ] }, "AzureNSG": { "allOf": [ { "$ref": "#/definitions/BaseFirewall" }, { "properties": { "vendor_id": { "type": "string" } } } ] }, "NSXTFirewall": { "allOf": [ { "$ref": "#/definitions/BaseFirewall" }, { "properties": { "vendor_id": { "type": "string" } } } ] }, "PolicyManagerFirewall": { "allOf": [ { "$ref": "#/definitions/BaseFirewall" }, { "properties": { "firewall_sections": { "type": "array", "items": { "$ref": "#/definitions/Reference" } }, "sddc_type": { "$ref": "#/definitions/SddcType" } } } ] }, "CheckpointFirewall": { "allOf": [ { "$ref": "#/definitions/BaseGenericFirewall" } ] }, "BaseGenericFirewall": { "allOf": [ { "$ref": "#/definitions/BaseFirewall" } ] }, "BaseFirewall": { "allOf": [ { "$ref": "#/definitions/BaseEntity" }, { "properties": { "firewall_rules": { "type": "array", "items": { "$ref": "#/definitions/RuleSet" } }, "exclusions": { "type": "array", "items": { "$ref": "#/definitions/Reference" } } } } ] }, "SearchRequest": { "type": "object", "properties": { "entity_type": { "$ref": "#/definitions/AllEntityType" }, "filter": { "type": "string", "description": "query filter" }, "sort_by": { "$ref": "#/definitions/SortByClause" }, "size": { "type": "integer", "format": "int32" }, "cursor": { "type": "string" }, "time_range": { "$ref": "#/definitions/TimeRange" } } }, "SortByClause": { "type": "object", "properties": { "field": { "type": "string" }, "order": { "type": "string", "enum": [ "ASC", "DESC" ] } } }, "TimeRange": { "type": "object", "properties": { "start_time": { "type": "integer", "format": "int64" }, "end_time": { "type": "integer", "format": "int64" } } }, "IncludeExternal": { "type": "boolean", "default": false }, "AggregateOrderByClause": { "type": "object", "properties": { "field": { "type": "string" }, "aggregation_type": { "type": "string", "enum": [ "SUM", "MIN", "MAX", "AVG" ] }, "order": { "type": "string", "enum": [ "ASC", "DESC" ] } } }, "SearchGroupByRequest": { "type": "object", "properties": { "entity_type": { "$ref": "#/definitions/AllEntityType" }, "filter": { "type": "string", "description": "query filter" }, "aggregations": { "type": "array", "items": { "$ref": "#/definitions/Aggregation" } }, "group_by": { "type": "array", "items": { "type": "string" } }, "sort_by": { "type": "array", "items": { "$ref": "#/definitions/AggregateOrderByClause" } }, "time_range": { "$ref": "#/definitions/TimeRange" }, "size": { "type": "integer", "format": "int32" }, "cursor": { "type": "string" } }, "example": { "entity_type": "Flow", "filter": "destination_ip.ip_address = '1.1.1.1'", "aggregations": [ { "field": "flow.totalBytes.delta.summation.bytes", "aggregation_type": "SUM" } ], "time_range": { "start_time": 1534410000, "end_time": 1534410559 }, "group_by": [ "source_ip", "destination_ip" ], "size": 2, "sort_by": [ { "field": "flow.totalBytes.delta.summation.bytes", "aggregation_type": "SUM", "order": "DESC" } ] } }, "AggregationRequest": { "type": "object", "properties": { "entity_type": { "$ref": "#/definitions/AllEntityType" }, "filter": { "type": "string", "description": "query filter" }, "aggregations": { "type": "array", "items": { "$ref": "#/definitions/Aggregation" } }, "time_range": { "$ref": "#/definitions/TimeRange" } }, "example": { "entity_type": "Flow", "filter": "destination_ip.ip_address = '1.1.1.1'", "aggregations": [ { "field": "flow.totalBytes.delta.summation.bytes", "aggregation_type": "SUM" } ], "time_range": { "start_time": 1534410000, "end_time": 1534410559 } } }, "Aggregation": { "type": "object", "properties": { "field": { "type": "string", "example": "flow.totalBytes.delta.summation.bytes" }, "aggregation_type": { "type": "string", "enum": [ "SUM", "MIN", "MAX", "AVG" ] } } }, "AggregationWithValue": { "type": "object", "properties": { "field": { "type": "string" }, "aggregation_type": { "type": "string", "enum": [ "SUM", "MIN", "MAX", "AVG" ] }, "value": { "type": "number", "format": "double" } } }, "AggregationResponse": { "type": "object", "properties": { "aggregations": { "type": "array", "items": { "$ref": "#/definitions/AggregationWithValue" } }, "total_count": { "type": "integer", "format": "int32" }, "start_time": { "type": "integer", "format": "int64" }, "end_time": { "type": "integer", "format": "int64" } } }, "Cardinality": { "type": "object", "properties": { "value": { "type": "integer", "format": "int64" }, "is_approx": { "type": "boolean" } } }, "SearchGroupByResponse": { "type": "object", "properties": { "results": { "type": "array", "items": { "$ref": "#/definitions/GroupWithValue" } }, "size": { "type": "integer", "format": "int32" }, "total_bucket": { "$ref": "#/definitions/Cardinality" }, "total_count": { "type": "integer", "format": "int32", "description": "total count of entity" }, "time_range": { "$ref": "#/definitions/TimeRange" }, "cursor": { "type": "string" } } }, "GroupWithValue": { "type": "object", "properties": { "bucket": { "type": "array", "items": { "$ref": "#/definitions/BucketValue" } }, "count": { "type": "integer", "format": "int64", "description": "count of entity in group" }, "aggregations": { "type": "array", "items": { "$ref": "#/definitions/AggregationWithValue" } } } }, "BucketValue": { "type": "object", "properties": { "field": { "type": "string" }, "value": { "type": "string" } } }, "ProblemEvent": { "allOf": [ { "$ref": "#/definitions/BaseEvent" }, { "properties": { "severity": { "type": "string", "enum": [ "CRITICAL", "MODERATE", "WARNING", "INFO" ] }, "event_close_time_epoch_ms": { "type": "integer", "format": "int64" } } } ] }, "FirewallRuleMaskEvent": { "allOf": [ { "$ref": "#/definitions/ProblemEvent" }, { "properties": { "maskedRule": { "$ref": "#/definitions/Reference" }, "maskingRule": { "$ref": "#/definitions/Reference" } } } ] }, "BaseEvent": { "allOf": [ { "$ref": "#/definitions/BaseEntity" }, { "properties": { "anchor_entities": { "type": "array", "items": { "$ref": "#/definitions/Reference" } }, "related_entities": { "type": "array", "items": { "$ref": "#/definitions/Reference" } }, "message": { "type": "string" }, "event_tags": { "type": "array", "items": { "type": "string" } }, "admin_state": { "type": "string", "enum": [ "ENABLED", "DISABLED" ] }, "archived": { "type": "boolean" }, "event_time_epoch_ms": { "type": "integer", "format": "int64" }, "event_type": { "type": "string" }, "recommendations": { "type": "array", "items": { "type": "string" } } } } ] }, "PagedListResponse": { "type": "object", "properties": { "results": { "type": "array", "items": { "$ref": "#/definitions/EntityId" } }, "cursor": { "type": "string" }, "total_count": { "type": "integer" }, "start_time": { "type": "integer", "format": "int64" }, "end_time": { "type": "integer", "format": "int64" } } }, "PagedApplicationListResponse": { "type": "object", "properties": { "results": { "type": "array", "items": { "$ref": "#/definitions/Application" } }, "cursor": { "type": "string" }, "total_count": { "type": "integer" } } }, "SimpleListResponse": { "type": "object", "properties": { "results": { "type": "array", "items": { "$ref": "#/definitions/EntityId" } }, "total_count": { "type": "integer" } } }, "TierListResponse": { "type": "object", "properties": { "results": { "type": "array", "items": { "$ref": "#/definitions/Tier" } } } }, "DataSourceListResponse": { "type": "object", "properties": { "results": { "type": "array", "items": { "$ref": "#/definitions/DataSourceEntityId" } }, "total_count": { "type": "integer", "example": 1 } } }, "NodeListResult": { "type": "object", "properties": { "results": { "type": "array", "items": { "$ref": "#/definitions/NodeId" } }, "total_count": { "type": "integer", "example": 1 } } }, "PagedListResponseWithTime": { "type": "object", "properties": { "results": { "type": "array", "items": { "$ref": "#/definitions/EntityIdWithTime" } }, "cursor": { "type": "string", "example": "ML12eu02==" }, "total_count": { "type": "integer", "example": 100 }, "start_time": { "type": "integer", "format": "int64", "example": 1504739809 }, "end_time": { "type": "integer", "format": "int64", "example": 1504739809 } } }, "BaseEntity": { "type": "object", "discriminator": "entity_type", "properties": { "entity_id": { "type": "string" }, "name": { "type": "string" }, "entity_type": { "$ref": "#/definitions/EntityType" } } }, "DataSourceType": { "type": "string", "enum": [ "CiscoSwitchDataSource", "DellSwitchDataSource", "AristaSwitchDataSource", "BrocadeSwitchDataSource", "JuniperSwitchDataSource", "GDDataSource", "F5BIGIPDataSource", "HuaweiSwitchDataSource", "MellanoxSwitchDataSource", "HPESwitchDataSource", "UANIDataSource", "VCenterDataSource", "NSXVManagerDataSource", "UCSManagerDataSource", "HPVCManagerDataSource", "HPOneViewDataSource", "PanFirewallDataSource", "CheckpointFirewallDataSource", "FortinetFirewallDataSource", "NSXTManagerDataSource", "KubernetesDataSource", "PKSDataSource", "InfobloxManagerDataSource", "CiscoACIDataSource", "ServiceNowDataSource", "PolicyManagerDataSource", "AzureDataSource", "VeloCloudDataSource" ] }, "NodeId": { "type": "object", "properties": { "id": { "type": "string", "description": "Entity Identifier", "example": "1000:104:12213212" }, "entity_type": { "$ref": "#/definitions/NodeType" } } }, "NodeType": { "type": "string", "enum": [ "Node" ] }, "EntityType": { "type": "string", "enum": [ "VirtualMachine", "EC2Instance", "Host", "Vnic", "Vmknic", "VxlanLayer2Network", "VlanL2Network", "Cluster", "SecurityTag", "ResourcePool", "NSXIPSet", "NSXTIPSet", "EC2IPSet", "NSXSecurityGroup", "NSGroup", "NSXPolicyGroup", "EC2SecurityGroup", "Flow", "ProblemEvent", "Application", "Tier", "IPEndpoint", "NSXFirewallRule", "EC2SGFirewallRule", "NSXRedirectRule", "VCenterManager", "NSXVManager", "NSXTManager", "NSXPolicyManager", "CheckpointManager", "CheckpointMDSManager", "NSXService", "EC2Service", "NSService", "VPC", "CloudNetwork", "AzureVM", "AzureNSG", "AzureASG", "AzureNSGRule", "NSXDistributedFirewall", "EC2Firewall", "NSXServiceGroup", "NSServiceGroup", "DistributedVirtualSwitch", "DistributedVirtualPortgroup", "VCDatacenter", "Datastore", "Folder", "NSXTFirewallRule", "NSXTFirewall", "PolicyManagerFirewallRule", "PolicyManagerFirewall", "KubernetesService", "CheckpointFirewall", "CheckpointFirewallRule", "UserDefinedSubnet", "UserDefinedProblemEvent", "FirewallRuleMaskEvent", "EdgeDevice", "RouterDevice", "NSXController", "LogicalRouter", "NSXTManagementNode", "NSXTController", "NSXTTransportNode", "NSXTTransportZone", "NSXTLoadBalancer", "NSXTVirtualServer", "NSXTServerPool", "NSXTLogicalSwitch", "NSXTRouterDevice", "NSXTEdgeCluster", "NSXControllerCluster" ] }, "MetaEntityType": { "type": "string", "enum": [ "Group", "BaseSecurityGroup", "BaseEvent", "BaseVirtualMachine", "BaseFirewallRule", "BaseIPSet", "BaseL2Network", "BaseManager", "BaseFirewallManager", "BaseGenericFirewall", "BaseGenericFirewallRule", "BaseNSXManager", "BaseFirewall", "BaseService", "BaseServiceGroup", "BaseVnic" ] }, "AllEntityType": { "type": "string", "enum": [ "Group", "BaseSecurityGroup", "BaseEvent", "BaseVirtualMachine", "BaseFirewallRule", "BaseIPSet", "BaseL2Network", "BaseFirewall", "BaseService", "BaseServiceGroup", "BaseVnic", "VirtualMachine", "EC2Instance", "Host", "Vnic", "Vmknic", "VxlanLayer2Network", "VlanL2Network", "Cluster", "SecurityTag", "ResourcePool", "NSXIPSet", "NSXTIPSet", "EC2IPSet", "NSXSecurityGroup", "NSGroup", "NSXPolicyGroup", "EC2SecurityGroup", "Flow", "ProblemEvent", "Application", "Tier", "IPEndpoint", "NSXFirewallRule", "EC2SGFirewallRule", "NSXRedirectRule", "VCenterManager", "NSXVManager", "NSXTManager", "NSXPolicyManager", "CheckpointManager", "CheckpointMDSManager", "BaseManager", "BaseFirewallManager", "BaseNSXManager", "NSXService", "EC2Service", "NSService", "VPC", "CloudNetwork", "AzureVM", "AzureNSG", "AzureASG", "AzureNSGRule", "NSXDistributedFirewall", "EC2Firewall", "NSXServiceGroup", "NSServiceGroup", "DistributedVirtualSwitch", "DistributedVirtualPortgroup", "VCDatacenter", "Datastore", "Folder", "NSXTFirewallRule", "NSXTFirewall", "PolicyManagerFirewallRule", "PolicyManagerFirewall", "BaseGenericFirewall", "BaseGenericFirewallRule", "CheckpointFirewall", "CheckpointFirewallRule", "UserDefinedSubnet", "KubernetesService", "UserDefinedProblemEvent", "FirewallRuleMaskEvent", "EdgeDevice", "RouterDevice", "NSXController", "LogicalRouter", "NSXTManagementNode", "NSXTController", "NSXTTransportNode", "NSXTTransportZone", "NSXTLoadBalancer", "NSXTVirtualServer", "NSXTServerPool", "NSXTLogicalSwitch", "NSXTRouterDevice", "NSXTEdgeCluster", "NSXControllerCluster" ] }, "Node": { "type": "object", "properties": { "id": { "type": "string" }, "entity_type": { "$ref": "#/definitions/NodeType" }, "node_type": { "type": "string", "enum": [ "PROXY_VM", "PLATFORM_VM" ] }, "node_id": { "type": "string" }, "ip_address": { "type": "string" }, "name": { "type": "string" } } }, "Application": { "allOf": [ { "$ref": "#/definitions/BaseEntity" }, { "properties": { "create_time": { "type": "integer", "format": "int64" }, "created_by": { "type": "string" }, "last_modified_time": { "type": "integer", "format": "int64" }, "last_modified_by": { "type": "string" } } } ] }, "ApplicationRequest": { "type": "object", "properties": { "name": { "type": "string" } } }, "GroupsMembersRequest": { "type": "object", "properties": { "entity_ids": { "type": "array", "items": { "type": "string" } }, "cursor": { "type": "string" } }, "example": { "entity_ids": [ "10000:561:123456789", "10000:561:987654321" ], "cursor": "CKWP==" } }, "TierRequest": { "type": "object", "properties": { "name": { "type": "string" }, "group_membership_criteria": { "type": "array", "items": { "$ref": "#/definitions/GroupMembershipCriteria" } } }, "example": { "name": "tier-1", "group_membership_criteria": [ { "membership_type": "SearchMembershipCriteria", "search_membership_criteria": { "entity_type": "VirtualMachine", "filter": "security_groups.entity_id = '18230:82:604573173'" } } ] } }, "Tier": { "allOf": [ { "$ref": "#/definitions/BaseEntity" }, { "properties": { "group_membership_criteria": { "type": "array", "items": { "$ref": "#/definitions/GroupMembershipCriteria" } }, "application": { "$ref": "#/definitions/Reference" } } } ] }, "GroupMembershipCriteria": { "type": "object", "description": "EntityType currently restricted to VirtualMachine", "properties": { "membership_type": { "type": "string", "enum": [ "SearchMembershipCriteria", "IPAddressMembershipCriteria" ] }, "ip_address_membership_criteria": { "$ref": "#/definitions/IpAddressMembershipCriteria" }, "search_membership_criteria": { "$ref": "#/definitions/SearchMembershipCriteria" } } }, "SearchMembershipCriteria": { "type": "object", "properties": { "entity_type": { "$ref": "#/definitions/AllEntityType" }, "filter": { "type": "string", "description": "As defined in search end point" } } }, "IpAddressMembershipCriteria": { "type": "object", "description": "Ip Address membership definition", "properties": { "ip_addresses": { "type": "array", "items": { "type": "string" } } } }, "IPEndpoint": { "allOf": [ { "$ref": "#/definitions/BaseEntity" }, { "properties": { "ip_address": { "$ref": "#/definitions/IpV4Address" }, "fqdns": { "type": "array", "items": { "type": "string" } } } } ] }, "RecommendedRules": { "type": "object", "properties": { "results": { "type": "array", "items": { "$ref": "#/definitions/RecommendedRule" } }, "time_range": { "$ref": "#/definitions/TimeRange" } } }, "RecommendedRule": { "type": "object", "properties": { "sources": { "type": "array", "items": { "$ref": "#/definitions/Reference" } }, "destinations": { "type": "array", "items": { "$ref": "#/definitions/Reference" } }, "protocols": { "type": "array", "items": { "type": "string" } }, "port_ranges": { "type": "array", "items": { "$ref": "#/definitions/SimplePortRange" } }, "action": { "type": "string", "enum": [ "ALLOW", "DROP" ] } } }, "RecommendedRulesRequest": { "type": "object", "properties": { "group_1": { "$ref": "#/definitions/MicroSecGroup" }, "group_2": { "$ref": "#/definitions/MicroSecGroup" }, "time_range": { "$ref": "#/definitions/TimeRange" }, "include_external": { "type": "boolean", "description": "When True, includes ungrouped endpoints outside defined scope", "default": false } }, "example": { "group_1": { "entity": { "entity_type": "Tier", "entity_id": "10000:562:1904698621" } }, "group_2": { "entity": { "entity_type": "Tier", "entity_id": "10000:562:1780351215" } } } }, "MicroSecGroup": { "type": "object", "properties": { "entity": { "$ref": "#/definitions/Reference" } } }, "NamesRequest": { "type": "object", "properties": { "entities": { "type": "array", "items": { "$ref": "#/definitions/NameRequestParam" } } } }, "NameRequestParam": { "type": "object", "properties": { "entity_id": { "type": "string" }, "time": { "type": "integer", "format": "int64" } } }, "NamesResponse": { "type": "object", "properties": { "entities": { "type": "array", "items": { "$ref": "#/definitions/EntityName" } } } }, "EntityName": { "allOf": [ { "$ref": "#/definitions/EntityIdWithTime" }, { "properties": { "name": { "type": "string" } } } ] }, "ApiError": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "details": { "type": "array", "items": { "$ref": "#/definitions/ErrorDetail" } } } }, "ErrorDetail": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "target": { "type": "array", "items": { "type": "string" } } } }, "VersionResponse": { "type": "object", "properties": { "api_version": { "type": "string" } } }, "IpTag": { "type": "object", "properties": { "tag_id": { "type": "string" }, "subnets": { "type": "array", "items": { "type": "string" } }, "ip_address_ranges": { "type": "array", "items": { "$ref": "#/definitions/IpAddressRange" } } } }, "IpTagIdList": { "type": "object", "properties": { "tag_ids": { "type": "array", "items": { "type": "string" } } } }, "SubnetMappingRequest": { "type": "object", "properties": { "cidr": { "type": "string" }, "vlan_id": { "type": "integer", "format": "int32" } } }, "SubnetMapping": { "allOf": [ { "$ref": "#/definitions/BaseEntity" }, { "properties": { "cidr": { "type": "string" }, "vlan_id": { "type": "integer", "format": "int32" } } } ] }, "SubnetMappingList": { "type": "object", "properties": { "results": { "type": "array", "items": { "$ref": "#/definitions/SubnetMapping" } } } }, "ApplicationsMembersResponse": { "type": "object", "properties": { "results": { "type": "array", "items": { "$ref": "#/definitions/ApplicationMembersResponse" } }, "cursor": { "type": "string" }, "total_count": { "type": "integer", "format": "int32" } } }, "TiersMembersResponse": { "type": "object", "properties": { "results": { "type": "array", "items": { "$ref": "#/definitions/TierMembersResponse" } }, "cursor": { "type": "string" }, "total_count": { "type": "integer", "format": "int32" } } }, "ApplicationMembersResponse": { "type": "object", "properties": { "entity_id": { "type": "string" }, "entity_type": { "type": "string" }, "name": { "type": "string" }, "created_by": { "type": "string" }, "creation_time": { "type": "integer", "format": "int64" }, "last_modified_by": { "type": "string" }, "last_modified_time": { "type": "integer", "format": "int64" }, "source": { "type": "string", "enum": [ "MANUAL", "PATTERN_BASED", "SERVICE_NOW", "FLOW_BASED_DISCOVERY" ] }, "tiers": { "type": "array", "items": { "$ref": "#/definitions/TierMembersResponse" } } } }, "TierMembersResponse": { "type": "object", "properties": { "entity_id": { "type": "string" }, "entity_type": { "type": "string" }, "name": { "type": "string" }, "members": { "type": "array", "items": { "$ref": "#/definitions/ApplicationMember" } } } }, "ApplicationMembers": { "type": "object", "properties": { "results": { "type": "array", "items": { "$ref": "#/definitions/ApplicationMember" } }, "cursor": { "type": "string" } } }, "ApplicationMember": { "type": "object", "properties": { "entity_id": { "type": "string" }, "entity_type": { "type": "string" }, "vendor_infos": { "type": "array", "items": { "$ref": "#/definitions/VendorInfo" } } } }, "VendorInfo": { "type": "object", "properties": { "vendor_ids": { "type": "array", "items": { "$ref": "#/definitions/VendorId" } }, "manager": { "$ref": "#/definitions/Reference" } } }, "VendorId": { "type": "object", "properties": { "id_type": { "type": "string" }, "id_value": { "type": "string" } } }, "Manager": { "type": "object", "properties": { "entity_id": { "type": "string" }, "entity_type": { "type": "string" } } }, "ApplicationFlowSummary": { "type": "object", "properties": { "service_endpoint_count": { "type": "integer", "default": 0 }, "groups": { "type": "array", "items": { "$ref": "#/definitions/GroupEntry" } }, "start_time": { "type": "integer", "format": "int64" }, "end_time": { "type": "integer", "format": "int64" } } }, "GroupEntry": { "type": "object", "properties": { "group_id": { "type": "string" }, "entity_id": { "type": "string" }, "entity_type": { "type": "string" }, "flow_summary": { "$ref": "#/definitions/FlowSummary" } } }, "FlowSummary": { "type": "object", "properties": { "ingress_bytes": { "type": "integer", "format": "int64", "default": 0 }, "egress_bytes": { "type": "integer", "format": "int64", "default": 0 } } }, "EntityWithTime": { "type": "object", "properties": { "entity_id": { "type": "string", "description": "Entity Identifier" }, "entity_type": { "$ref": "#/definitions/EntityType" }, "entity": { "$ref": "#/definitions/BaseEntity" }, "time": { "type": "integer", "format": "int64" } } }, "BulkFetchResponse": { "type": "object", "properties": { "results": { "type": "array", "items": { "$ref": "#/definitions/EntityWithTime" } } } }, "EntityMetricsSchema": { "type": "object", "properties": { "results": { "type": "array", "items": { "$ref": "#/definitions/MetricSchema" } } } }, "MetricSchema": { "type": "object", "properties": { "metric": { "type": "string" }, "display_name": { "type": "string" }, "intervals": { "type": "array", "items": { "type": "integer" } }, "description": { "type": "string" }, "unit": { "type": "string" } } }, "MetricResponse": { "type": "object", "properties": { "metric": { "type": "string" }, "display_name": { "type": "string" }, "interval": { "type": "integer" }, "unit": { "type": "string" }, "pointlist": { "type": "array", "items": { "type": "array", "items": { "type": "number", "format": "double" } } }, "start": { "type": "integer", "format": "int64" }, "end": { "type": "integer", "format": "int64" } } }, "PathFirewallRules": { "type": "object", "properties": { "firewalls": { "type": "array", "items": { "$ref": "#/definitions/FirewallRuleSet" } } } }, "FirewallRuleSet": { "type": "object", "properties": { "firewall_entity_id": { "$ref": "#/definitions/Reference" }, "vendor_info": { "$ref": "#/definitions/VendorInfo" }, "manager": { "$ref": "#/definitions/Reference" }, "rules": { "type": "array", "items": { "$ref": "#/definitions/BaseFirewallRule" } } } }, "PathFirewallRulesRequest": { "type": "object", "properties": { "source_ip_address": { "type": "string" }, "destination_ip_address": { "type": "string" }, "port": { "type": "integer", "format": "int32" }, "protocol": { "type": "string" }, "time": { "type": "integer", "format": "int64" } } }, "AuditRequest": { "type": "object", "properties": { "user_name": { "type": "string" }, "ip_address": { "type": "string" }, "entity_type": { "type": "string" }, "entity_id": { "type": "string" }, "operation": { "type": "string" }, "response": { "type": "string" }, "size": { "type": "integer", "format": "int32" }, "cursor": { "type": "string" }, "time_range": { "$ref": "#/definitions/TimeRange" } }, "example": { "username": "admin@local", "operation": "LOGIN", "time_range": { "start_time": 1534410000, "end_time": 1534410559 }, "size": 10, "cursor": "string" } }, "AuditListResponse": { "type": "object", "properties": { "results": { "type": "array", "items": { "$ref": "#/definitions/AuditResponse" } }, "cursor": { "type": "string", "example": "ML12eu02==" }, "start_time": { "type": "integer", "format": "int64", "example": 1504739809 }, "end_time": { "type": "integer", "format": "int64", "example": 1504739809 } } }, "AuditResponse": { "type": "object", "properties": { "ip_address": { "type": "string" }, "user_name": { "type": "string" }, "entity_type": { "type": "string" }, "entity_id": { "type": "string" }, "operation": { "type": "string" }, "response": { "type": "string" }, "value": { "type": "string" }, "timestamp": { "type": "integer", "format": "int64" } } }, "UserUpdateRequest": { "type": "object", "properties": { "username": { "type": "string", "example": "admin@local" }, "new_password": { "type": "string", "example": "password" } } }, "InterfaceWANConfig": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "type": { "type": "string", "enum": [ "MPLS", "INTERNET", "OTHER" ] } } }, "WANConfig": { "type": "object", "properties": { "site": { "type": "string", "example": "Washington DC" }, "region": { "type": "string", "example": "US East" }, "interfaces": { "type": "array", "items": { "$ref": "#/definitions/InterfaceWANConfig" } } } }, "SubscriptionRequest": { "type": "object", "properties": { "event_name": { "type": "string" }, "is_problem": { "type": "boolean" }, "severity": { "type": "string" }, "search_criteria": { "type": "string" }, "generate_event_criteria": { "$ref": "#/definitions/GenerateEventCritera" }, "email_frequency": { "$ref": "#/definitions/EmailFrequency" }, "daily_at_utc": { "type": "string" }, "email_ids": { "type": "array", "items": { "type": "string" } }, "snmp_trap_entity_ids": { "type": "array", "items": { "type": "string" } } } }, "Severity": { "type": "string", "enum": [ "Critical", "Moderate", "Warning", "Info" ] }, "GenerateEventCritera": { "type": "string", "enum": [ "SEARCH_RESULT_CHANGE", "ZERO_SEARCH_RESULTS" ] }, "EmailFrequency": { "type": "string", "enum": [ "IMMEDIATELY", "DAILY_DIGEST" ] }, "SubscriptionResponse": { "type": "object", "properties": { "entity_id": { "type": "string" }, "active": { "type": "boolean" }, "event_name": { "type": "string" }, "is_problem": { "type": "boolean" }, "severity": { "$ref": "#/definitions/Severity" }, "search_criteria": { "type": "string" }, "generate_event_criteria": { "$ref": "#/definitions/GenerateEventCritera" }, "email_frequency": { "$ref": "#/definitions/EmailFrequency" }, "daily_at_utc": { "type": "string" }, "email_ids": { "type": "array", "items": { "type": "string" } }, "snmp_trap_entity_ids": { "type": "array", "items": { "type": "string" } } } }, "SubscriptionListResponse": { "type": "object", "properties": { "results": { "type": "array", "items": { "$ref": "#/definitions/SubscriptionResponse" } }, "total_count": { "type": "integer" } } }, "EventMetaInfoResponse": { "type": "object", "properties": { "results": { "type": "array", "items": { "$ref": "#/definitions/EventMetaInfo" } } } }, "EventMetaInfo": { "type": "object", "properties": { "entity_type": { "type": "string" }, "name": { "type": "string" }, "help_text": { "type": "string" }, "severity": { "type": "string", "enum": [ "Critical", "Warning", "Moderate", "Info" ] }, "tags": { "type": "array", "items": { "type": "string" } }, "supported_entity_types": { "type": "array", "items": { "type": "string" } }, "supported_manager_types": { "type": "array", "items": { "type": "string" } }, "impact": { "type": "string", "enum": [ "Network Disruption Risk", "Availability Risk", "Operations", "Optimization", "Performance", "Security Risk", "Health", "Wastage", "Communication Failure", "Sync", "NA" ] }, "recommendations": { "type": "array", "items": { "type": "string" } } } }, "BulkUserDefinedProblemFetchResponse": { "type": "object", "properties": { "results": { "type": "array", "items": { "$ref": "#/definitions/UserDefinedProblemWithTime" } } } }, "UserDefinedProblemWithTime": { "type": "object", "properties": { "entity_id": { "type": "string", "description": "Entity Identifier" }, "entity_type": { "$ref": "#/definitions/EntityType" }, "entity": { "$ref": "#/definitions/UserDefinedProblemEvent" }, "time": { "type": "integer", "format": "int64" } } }, "UserDefinedProblemEvent": { "allOf": [ { "$ref": "#/definitions/ProblemEvent" }, { "properties": { "total_count": { "type": "integer", "format": "int64" }, "refs_added_count": { "type": "integer", "format": "int64" }, "refs_deleted_count": { "type": "integer", "format": "int64" }, "subscriptions": { "type": "array", "items": { "$ref": "#/definitions/Reference" } } } } ] }, "VendorInfoWithMk": { "type": "object", "properties": { "entity_id": { "type": "string" }, "entity_type": { "type": "string" }, "entity_name": { "type": "string" }, "vendor_ids": { "type": "array", "items": { "$ref": "#/definitions/VendorId" } } } }, "DetailedVendorInfo": { "type": "object", "allOf": [ { "$ref": "#/definitions/VendorInfoWithMk" }, { "properties": { "manager": { "$ref": "#/definitions/VendorInfoWithMk" } } } ] }, "DetailedVendorInfoResponse": { "type": "object", "properties": { "results": { "type": "array", "items": { "$ref": "#/definitions/DetailedVendorInfo" } } } }, "BulkProblemFetchResponse": { "type": "object", "properties": { "results": { "type": "array", "items": { "$ref": "#/definitions/ProblemWithTime" } } } }, "ProblemWithTime": { "type": "object", "properties": { "entity_id": { "type": "string", "description": "Entity Identifier" }, "entity_type": { "$ref": "#/definitions/EntityType" }, "entity": { "$ref": "#/definitions/ProblemEvent" }, "time": { "type": "integer", "format": "int64" } } }, "EdgeDevice": { "type": "object", "allOf": [ { "$ref": "#/definitions/BaseEntity" }, { "properties": { "vendor_id": { "type": "string" }, "manager": { "$ref": "#/definitions/Reference" } } } ] }, "RouterDevice": { "type": "object", "allOf": [ { "$ref": "#/definitions/BaseEntity" }, { "properties": { "manager": { "$ref": "#/definitions/Reference" } } } ] }, "NSXController": { "type": "object", "allOf": [ { "$ref": "#/definitions/BaseEntity" }, { "properties": { "vendor_id": { "type": "string" }, "manager": { "$ref": "#/definitions/Reference" } } } ] }, "LogicalRouter": { "type": "object", "allOf": [ { "$ref": "#/definitions/BaseEntity" }, { "properties": { "sub_types": { "type": "array", "items": { "type": "integer", "format": "int32" } }, "manager": { "$ref": "#/definitions/Reference" } } } ] }, "NSXTManagementNode": { "type": "object", "allOf": [ { "$ref": "#/definitions/BaseEntity" }, { "properties": { "vendor_id": { "type": "string" }, "manager": { "$ref": "#/definitions/Reference" } } } ] }, "NSXTController": { "type": "object", "allOf": [ { "$ref": "#/definitions/BaseEntity" }, { "properties": { "vendor_id": { "type": "string" }, "manager": { "$ref": "#/definitions/Reference" } } } ] }, "NSXTTransportNode": { "type": "object", "allOf": [ { "$ref": "#/definitions/BaseEntity" }, { "properties": { "vendor_id": { "type": "string" }, "manager": { "$ref": "#/definitions/Reference" } } } ] }, "NSXTTransportZone": { "type": "object", "allOf": [ { "$ref": "#/definitions/BaseEntity" }, { "properties": { "vendor_id": { "type": "string" }, "manager": { "$ref": "#/definitions/Reference" } } } ] }, "NSXTLoadBalancer": { "type": "object", "allOf": [ { "$ref": "#/definitions/BaseEntity" }, { "properties": { "vendor_id": { "type": "string" }, "manager": { "$ref": "#/definitions/Reference" } } } ] }, "NSXTVirtualServer": { "type": "object", "allOf": [ { "$ref": "#/definitions/BaseEntity" }, { "properties": { "vendor_id": { "type": "string" }, "manager": { "$ref": "#/definitions/Reference" } } } ] }, "NSXTServerPool": { "type": "object", "allOf": [ { "$ref": "#/definitions/BaseEntity" }, { "properties": { "vendor_id": { "type": "string" }, "manager": { "$ref": "#/definitions/Reference" } } } ] }, "NSXTLogicalSwitch": { "type": "object", "allOf": [ { "$ref": "#/definitions/BaseEntity" }, { "properties": { "vendor_id": { "type": "string" }, "manager": { "$ref": "#/definitions/Reference" } } } ] }, "NSXTRouterDevice": { "type": "object", "allOf": [ { "$ref": "#/definitions/BaseEntity" }, { "properties": { "vendor_id": { "type": "string" }, "manager": { "$ref": "#/definitions/Reference" } } } ] }, "NSXTEdgeCluster": { "type": "object", "allOf": [ { "$ref": "#/definitions/BaseEntity" }, { "properties": { "vendor_id": { "type": "string" }, "manager": { "$ref": "#/definitions/Reference" } } } ] }, "NSXControllerCluster": { "type": "object", "allOf": [ { "$ref": "#/definitions/BaseEntity" }, { "properties": { "manager": { "$ref": "#/definitions/Reference" }, "controllers": { "type": "array", "items": { "$ref": "#/definitions/Reference" } } } } ] } } }