{ "openapi": "3.0.0", "info": { "title": "Skylight Analytics API documentation", "description": "Here is Skylight Analytics's API documentation.\n# Introduction\nThis API is documented in **Open API format v2**. You can download the full API spec above, and use it with\ncompatible code generators to generate the client stubs.\n# Quick setup\n(Almost) every endpoint require a [valid user authentication](/#tag/AuthService), so this is probably where you should start.\nDepending on the access rights associated with your account, some endpoints may not be authorized. When such restriction exists,\nthe API documentation will outline which acess rights are required to access or modify a given resource.\n## Authenticate to obtain an Authorized Token\nYou must optain an `Authorization Bearer` (for subsequent API calls) or a set-cookie, for browser related calls. Both \nof these can be obtained by the [auth/login](/#tag/AuthService) endpoint.\n```bash\ncurl -X POST \\\n https://tenant-url.npav.accedian.net/api/v1/auth/login \\\n -H 'Cache-Control: no-cache' \\\n -H 'Content-Type: application/x-www-form-urlencoded' \\\n -d 'username=tenantUsername&password=tenantUserPassword'\n```\n> Pro-tip: Replace \"tenant-url\" by your tenant name\nThe response will contained an authorized header and a set-cookie header\n```bash\nHTTP/2 200\ncontent-type: application/vnd.api+json\ncontent-length: 208\nauthorization: Bearer MTUzNTAyNDg[...]\nset-cookie: skylight-aaa=MTUzNTAyNDg[...]\n{\n \"data\": {\n \"attributes\":{\n \"emailAddress\":\"tenantUsername\",\n \"isPasswordSet\":true,\n \"isRegisteredForEmail\":false,\n \"name\":\"tenantName\",\n \"roles\":[\"tenant-role\"],\n \"tenants\":[\"tenantName\"]},\n \"id\":\"1\",\n \"type\":\"users\"\n }\n}\n```\n## Making an authorized API request - (RAW metrics API query)\nOnce you have optained an `Authorization bearer` token, you can make a query to retrieve [RAW metrics](/#operation/GetRawMetrics). \n```bash\ncurl -X POST https://accedian-dh2.npav.accedian.net/api/v2/raw-metrics \\\n -d \"\\\n {'tenantId':'tenant12345',\\\n 'interval':'2018-08-08T11%3A12%3A53-04%3A00%2F2018-08-09T11%3A12%3A53-04%3A00',\\\n 'granularity':'PT78.545S',\\\n 'meta':{'colors':['orange']},\\\n 'timeout':30000,\\\n 'metrics':['jitterP95'],\\\n 'directions':['0','1','2'],\\\n 'objectType':'twamp-sf'\\\n }\" -H 'Cache-Control: no-cache' -H 'Authorization: MTUzNTAyNDg[...]'\n``` \n", "contact": { "email": "the.team@accedian.com" }, "version": "2021.03.0" }, "servers": [ { "url": "https://api.analytics.accedian.io/api", "variables": {} } ], "paths": { "/openid-configuration/{clientName}": { "get": { "tags": [ "OpenID" ], "summary": "OpenIDConfiguration", "operationId": "OpenIDConfiguration", "parameters": [ { "name": "clientName", "in": "path", "description": "The name of the openID provider we're trying to access", "required": true, "style": "simple", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Returns the proxy configuration for the external OP", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OIDConfig" } }, "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/OIDConfig" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/json": { "schema": { "type": "string" } }, "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/openid-token/{clientName}": { "post": { "tags": [ "OpenID" ], "summary": "OpenIDToken", "operationId": "OpenIDToken", "parameters": [ { "name": "clientName", "in": "path", "description": "The name of the openID provider we're trying to access", "required": true, "style": "simple", "schema": { "type": "string" } }, { "name": "Content-Type", "in": "header", "description": "", "required": true, "style": "simple", "schema": { "enum": [ "application/x-www-form-urlencoded" ], "type": "string", "example": "application/x-www-form-urlencoded" } } ], "requestBody": { "content": { "application/x-www-form-urlencoded": { "encoding": {}, "schema": { "required": [ "grant_type", "code", "client_id", "client_secret" ], "type": "object", "properties": { "grant_type": { "enum": [ "authorization_code" ], "type": "string", "example": "authorization_code" }, "code": { "type": "string" }, "client_id": { "type": "string" }, "client_secret": { "type": "string" } } } } }, "required": false }, "responses": { "200": { "description": "Returns the oidc token", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OIDToken" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/openid-auth": { "get": { "tags": [ "OpenID" ], "summary": "OpenIDAuth", "operationId": "OpenIDAuth", "parameters": [ { "name": "client_id", "in": "query", "description": "Our client ID which is registered in the OP", "required": true, "style": "form", "explode": true, "schema": { "type": "string" } }, { "name": "redirect_uri", "in": "query", "description": "URI of where the OP will redirect upon successful authentication", "required": true, "style": "form", "explode": true, "schema": { "type": "string" } }, { "name": "response_type", "in": "query", "description": "What we are requesting from the OP", "required": true, "style": "form", "explode": true, "schema": { "type": "string", "example": "code" } }, { "name": "state", "in": "query", "description": "Value that has to match between OIDC requests", "required": true, "style": "form", "explode": true, "schema": { "type": "string" } }, { "name": "delegatedclientid", "in": "query", "description": "", "style": "form", "explode": true, "schema": { "type": "string" } }, { "name": "scope", "in": "query", "description": "scope of the OIDC request", "required": true, "style": "form", "explode": true, "schema": { "type": "string", "example": "openid" } } ], "responses": { "302": { "description": "Redirects", "headers": { "Location": { "content": { "text/plain": { "schema": { "type": "string" } } } } }, "content": {} } }, "deprecated": false } }, "/saml-redirect": { "get": { "tags": [ "SAML" ], "summary": "SamlRedirect", "operationId": "SamlRedirect", "parameters": [ { "name": "clientName", "in": "query", "description": "The name of the SAML client we'll be delegating auth to", "required": true, "style": "form", "explode": true, "schema": { "type": "string" } } ], "responses": { "302": { "description": "Redirects", "headers": { "Location": { "content": { "text/plain": { "schema": { "type": "string" } } } } }, "content": {} }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/json": { "schema": { "type": "string" } }, "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/saml-callback": { "post": { "tags": [ "SAML" ], "summary": "SamlCallback", "operationId": "SamlCallback", "parameters": [ { "name": "Content-Type", "in": "header", "description": "", "required": true, "style": "simple", "schema": { "enum": [ "application/x-www-form-urlencoded" ], "type": "string", "example": "application/x-www-form-urlencoded" } } ], "requestBody": { "content": { "application/x-www-form-urlencoded": { "encoding": {}, "schema": { "required": [ "SAMLResponse", "RelayState" ], "type": "object", "properties": { "SAMLResponse": { "type": "string" }, "RelayState": { "type": "string" } } } } }, "required": false }, "responses": { "302": { "description": "Redirects to login page", "headers": { "Location": { "content": { "text/plain": { "schema": { "type": "string" } } } } }, "content": {} }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/saml-metadata/{clientName}": { "get": { "tags": [ "SAML" ], "summary": "SamlSpMetadata", "operationId": "SamlSpMetadata", "parameters": [ { "name": "clientName", "in": "path", "description": "The name of the SAML provider we're trying to access", "required": true, "style": "simple", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Returns the SAML service provider metadata", "headers": {}, "content": { "text/plain": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "text/plain": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v1/grant": { "post": { "tags": [ "TicketService" ], "summary": "CreateGrantingTicket", "description": "Create a Granting Ticket used to obtain Service Tickets", "operationId": "CreateGrantingTicket", "parameters": [ { "name": "Content-Type", "in": "header", "description": "", "required": true, "style": "simple", "schema": { "enum": [ "application/x-www-form-urlencoded" ], "type": "string", "example": "application/x-www-form-urlencoded" } } ], "requestBody": { "content": { "application/x-www-form-urlencoded": { "encoding": {}, "schema": { "required": [ "username", "password", "service" ], "type": "object", "properties": { "username": { "type": "string", "description": "Unique identifier of the User requesting access" }, "password": { "type": "string", "description": "Password for the username of the User requesting access" }, "service": { "enum": [ "https://cas.local/aastubs/" ], "type": "string", "description": "URL of the granting service.", "example": "https://cas.local/aastubs/" } } } } }, "required": false }, "responses": { "201": { "description": "Returns the Granting Ticket URL", "headers": {}, "content": { "text/plain": { "schema": { "type": "string" } } } }, "401": { "description": "Unauthorized access attempt", "headers": {}, "content": { "text/plain": { "schema": { "type": "string" } } } }, "404": { "description": "User not found", "headers": {}, "content": { "text/plain": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "text/plain": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v1/service": { "post": { "tags": [ "TicketService" ], "summary": "CreateServiceTicket", "description": "Obtain a Service Ticket used to access a particular resource", "operationId": "CreateServiceTicket", "parameters": [ { "name": "Content-Type", "in": "header", "description": "", "required": true, "style": "simple", "schema": { "enum": [ "application/x-www-form-urlencoded" ], "type": "string", "example": "application/x-www-form-urlencoded" } } ], "requestBody": { "content": { "application/x-www-form-urlencoded": { "encoding": {}, "schema": { "required": [ "grantingTicket", "service" ], "type": "object", "properties": { "grantingTicket": { "type": "string", "description": "The URL Granting ticket used to obtain the Service Ticket" }, "service": { "enum": [ "https://cas.local/aastubs/" ], "type": "string", "description": "URL of the granting service.", "example": "https://cas.local/aastubs/" } } } } }, "required": false }, "responses": { "200": { "description": "Returns the Service Ticket value", "headers": {}, "content": { "text/plain": { "schema": { "type": "string" } } } }, "404": { "description": "The Granting ticket was not found/is no longer valid", "headers": {}, "content": { "text/plain": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "text/plain": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v1/validate": { "post": { "tags": [ "TicketService" ], "summary": "ValidateServiceTicket", "description": "Validate a Service Ticket used to access a particular resource", "operationId": "ValidateServiceTicket", "parameters": [ { "name": "ticket", "in": "query", "description": "The Service Ticket to be validated.", "required": true, "style": "form", "explode": true, "schema": { "type": "string" } }, { "name": "service", "in": "query", "description": "URL of the granting service.", "required": true, "style": "form", "explode": true, "schema": { "enum": [ "https://cas.local/aastubs/" ], "type": "string", "example": "https://cas.local/aastubs/" } }, { "name": "format", "in": "query", "description": "The format of the validation response body.", "required": true, "style": "form", "explode": true, "schema": { "enum": [ "JSON" ], "type": "string", "example": "JSON" } }, { "name": "Content-Type", "in": "header", "description": "", "required": true, "style": "simple", "schema": { "enum": [ "application/x-www-form-urlencoded" ], "type": "string", "example": "application/x-www-form-urlencoded" } } ], "responses": { "200": { "description": "Returns the result of the Service Ticket validation", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ValidationResponse" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v1/auth/users": { "post": { "tags": [ "AuthService" ], "summary": "CreateUser", "description": "Create a new User in Skylight AAA", "operationId": "CreateUser", "parameters": [], "requestBody": { "description": "", "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/JsonApiAAAUser" } } }, "required": true }, "responses": { "201": { "description": "User was successfully created in Skylight AAA", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/JsonApiAAAUser" } } } }, "400": { "description": "Bad request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have permission to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "Tenat, user group or role not found", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "409": { "description": "Attempt to provision a User that is already provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "get": { "tags": [ "AuthService" ], "summary": "GetAllUsers", "description": "Retrieve a list of Users known to Skylight AAA", "operationId": "GetAllUsers", "parameters": [ { "name": "Content-Type", "in": "header", "description": "", "required": true, "style": "simple", "schema": { "enum": [ "application/json" ], "type": "string", "example": "application/json" } } ], "responses": { "200": { "description": "Returns a list of known Users to Skylight AAA", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/JsonApiAAAUserList" } } } }, "403": { "description": "Requestor does not have permission to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "No Users provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v1/auth/users/{userId}": { "put": { "tags": [ "AuthService" ], "summary": "UpdateUser", "description": "Update an existing User in Skylight AAA. Does not update User email or Password.", "operationId": "UpdateUser", "parameters": [ { "name": "userId", "in": "path", "description": "The unique identifier of the User to be updated.", "required": true, "style": "simple", "schema": { "type": "integer", "format": "int64" } } ], "requestBody": { "description": "", "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/JsonApiAAAUser" } } }, "required": true }, "responses": { "200": { "description": "User was successfully updated in Skylight AAA", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/JsonApiAAAUser" } } } }, "403": { "description": "Requestor does not have permission to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "Attempt to update user but the user does not exist", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "patch": { "tags": [ "AuthService" ], "summary": "UpdateUserProperties", "description": "Update properties of an existing User in Skylight AAA. Does not update User email or Password.", "operationId": "UpdateUserProperties", "parameters": [ { "name": "userId", "in": "path", "description": "The unique identifier of the User to be updated.", "required": true, "style": "simple", "schema": { "type": "integer", "format": "int64" } } ], "requestBody": { "description": "", "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/JsonApiAAAUser" } } }, "required": true }, "responses": { "200": { "description": "User was successfully updated in Skylight AAA", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/JsonApiAAAUser" } } } }, "400": { "description": "Attempt to update user but there is something wrong with the request data", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have permission to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "Attempt to update user but the user does not exist", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "get": { "tags": [ "AuthService" ], "summary": "GetUser", "description": "Retrieve a single User by its known Id.", "operationId": "GetUser", "parameters": [ { "name": "userId", "in": "path", "description": "The unique identifier of the User to be returned.", "required": true, "style": "simple", "schema": { "type": "integer", "format": "int64" } }, { "name": "Content-Type", "in": "header", "description": "", "required": true, "style": "simple", "schema": { "enum": [ "application/json" ], "type": "string", "example": "application/json" } } ], "responses": { "200": { "description": "Returns a known User to Skylight AAA", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/JsonApiAAAUser" } } } }, "403": { "description": "Requestor does not have permission to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "User not found", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "delete": { "tags": [ "AuthService" ], "summary": "DeleteUser", "description": "Delete a single User by its known Id.", "operationId": "DeleteUser", "parameters": [ { "name": "userId", "in": "path", "description": "The unique identifier of the User to be deleted.", "required": true, "style": "simple", "schema": { "type": "integer", "format": "int64" } }, { "name": "Content-Type", "in": "header", "description": "", "required": true, "style": "simple", "schema": { "enum": [ "application/json" ], "type": "string", "example": "application/json" } } ], "responses": { "200": { "description": "Returns the now deleted User from Skylight AAA", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/JsonApiAAAUser" } } } }, "403": { "description": "Requestor does not have permission to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "User not found", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v1/auth/users/{userId}/password": { "patch": { "tags": [ "AuthService" ], "summary": "ResetPassword", "description": "Reset a pasword for a User provisioned in Skylight AAA.", "operationId": "ResetPassword", "parameters": [ { "name": "userId", "in": "path", "description": "The unique identifier of the User to reset the password.", "required": true, "style": "simple", "schema": { "type": "integer", "format": "int64" } }, { "name": "Content-Type", "in": "header", "description": "", "required": true, "style": "simple", "schema": { "enum": [ "application/json" ], "type": "string", "example": "application/json" } } ], "responses": { "200": { "description": "Returns the onboarding URL for the user", "headers": {}, "content": { "text/plain": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have permission to perform this action", "headers": {}, "content": { "text/plain": { "schema": { "type": "string" } } } }, "404": { "description": "User not found", "headers": {}, "content": { "text/plain": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "text/plain": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v1/auth/users/{userId}/email": { "patch": { "tags": [ "AuthService" ], "summary": "ChangeEmailAddress", "description": "Change the email address of a User provisioned in Skylight AAA.", "operationId": "ChangeEmailAddress", "parameters": [ { "name": "userId", "in": "path", "description": "The unique identifier of the User which is changing email address", "required": true, "style": "simple", "schema": { "type": "integer", "format": "int64" } } ], "requestBody": { "description": "", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EmailChangeRequest" } } }, "required": true }, "responses": { "200": { "description": "The email address of the user has been changed", "headers": {}, "content": { "text/plain": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have permission to perform this action", "headers": {}, "content": { "text/plain": { "schema": { "type": "string" } } } }, "404": { "description": "User not found", "headers": {}, "content": { "text/plain": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "text/plain": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v1/auth/me": { "patch": { "tags": [ "AuthService" ], "summary": "UpdateAuthenticatedUserProperties", "description": "Update properties of the currently authenticated User in Skylight AAA. Does not update User email or Password.", "operationId": "UpdateAuthenticatedUserProperties", "parameters": [], "requestBody": { "description": "", "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/JsonApiAAAUser" } } }, "required": true }, "responses": { "200": { "description": "User was successfully updated in Skylight AAA", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/JsonApiAAAUser" } } } }, "400": { "description": "Attempt to update user but there is something wrong with the request data", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "401": { "description": "Attempt to update user but there is something wrong with the authentication parameters", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Attempt to update user but operation is not allowed on resource", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "Attempt to update user but the user does not exist", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "get": { "tags": [ "AuthService" ], "summary": "GetAuthenticatedUser", "description": "Retrieve the currently Authenticated User.", "operationId": "GetAuthenticatedUser", "parameters": [ { "name": "Content-Type", "in": "header", "description": "", "required": true, "style": "simple", "schema": { "enum": [ "application/json" ], "type": "string", "example": "application/json" } } ], "responses": { "200": { "description": "Returns the currently Authenticated User", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/JsonApiAAAUser" } } } }, "401": { "description": "Attempt to fetch a user but there is something wrong with the authentication parameters", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "User not found", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "delete": { "tags": [ "AuthService" ], "summary": "DeleteAuthenticatedUser", "description": "Delete the currently Authenticated User.", "operationId": "DeleteAuthenticatedUser", "parameters": [ { "name": "Content-Type", "in": "header", "description": "", "required": true, "style": "simple", "schema": { "enum": [ "application/json" ], "type": "string", "example": "application/json" } } ], "responses": { "200": { "description": "Returns the now deleted User from Skylight AAA", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/JsonApiAAAUser" } } } }, "401": { "description": "Attempt to delete a user but there is something wrong with the authentication parameters", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "User not found", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v1/auth/me/password": { "patch": { "tags": [ "AuthService" ], "summary": "UpdateAuthenticatedUserPassword", "description": "Updates the password of the currently Authenticated User.", "operationId": "UpdateAuthenticatedUserPassword", "parameters": [], "requestBody": { "description": "", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PasswordChangeRequest" } } }, "required": true }, "responses": { "200": { "description": "Password was successfully updated", "headers": {}, "content": { "text/plain": { "schema": { "type": "string" } } } }, "400": { "description": "Attempt to update user but there is something wrong with the request data", "headers": {}, "content": { "text/plain": { "schema": { "type": "string" } } } }, "401": { "description": "Attempt to update user password but there is an error evaluating the authentication token", "headers": {}, "content": { "text/plain": { "schema": { "type": "string" } } } }, "404": { "description": "Attempt to update user but the user does not exist", "headers": {}, "content": { "text/plain": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "text/plain": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v1/auth/me/email": { "patch": { "tags": [ "AuthService" ], "summary": "ChangeAuthenticatedUserEmailAddress", "description": "Change the email address of the currently Authenticated User.", "operationId": "ChangeAuthenticatedUserEmailAddress", "parameters": [], "requestBody": { "description": "", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EmailChangeRequest" } } }, "required": true }, "responses": { "200": { "description": "The email address of the Authenticated User has been changed", "headers": {}, "content": { "text/plain": { "schema": { "type": "string" } } } }, "400": { "description": "Attempt to update user email address but there is something wrong with the request data", "headers": {}, "content": { "text/plain": { "schema": { "type": "string" } } } }, "401": { "description": "Attempt to update user email address but there is an error evaluating the authentication token", "headers": {}, "content": { "text/plain": { "schema": { "type": "string" } } } }, "404": { "description": "User not found", "headers": {}, "content": { "text/plain": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "text/plain": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v1/onboarding/{onboardingToken}": { "get": { "tags": [ "AuthService" ], "summary": "GetUserByToken", "description": "Retrieve the User mapped to the onboarding token.", "operationId": "GetUserByToken", "parameters": [ { "name": "onboardingToken", "in": "path", "description": "The one-time use token provided to access the password set operation", "required": true, "style": "simple", "schema": { "type": "string" } }, { "name": "Content-Type", "in": "header", "description": "", "required": true, "style": "simple", "schema": { "enum": [ "application/json" ], "type": "string", "example": "application/json" } } ], "responses": { "200": { "description": "Returns the User mapped to the onboarding token", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/JsonApiAAAUser" } } } }, "404": { "description": "User not found", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v1/onboarding/password": { "post": { "tags": [ "AuthService" ], "summary": "SetUserPassword", "description": "Sets the password of a User that has had their password reset.", "operationId": "SetUserPassword", "parameters": [], "requestBody": { "description": "", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SetPasswordRequest" } } }, "required": true }, "responses": { "200": { "description": "The password has been set", "headers": {}, "content": { "text/plain": { "schema": { "type": "string" } } } }, "400": { "description": "Attempt to update password, but the request has bad data", "headers": {}, "content": { "text/plain": { "schema": { "type": "string" } } } }, "404": { "description": "Attempt to update password, but the user no longer exists", "headers": {}, "content": { "text/plain": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "text/plain": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v1/auth/login": { "post": { "tags": [ "AuthService" ], "summary": "Login", "description": "Login a Skylight User", "operationId": "Login", "parameters": [ { "name": "Content-Type", "in": "header", "description": "", "required": true, "style": "simple", "schema": { "enum": [ "application/x-www-form-urlencoded" ], "type": "string", "example": "application/x-www-form-urlencoded" } } ], "requestBody": { "content": { "application/x-www-form-urlencoded": { "encoding": {}, "schema": { "type": "object", "properties": { "username": { "type": "string", "description": "Unique identifier of the User requesting access" }, "password": { "type": "string", "description": "Password for the username of the User requesting access" }, "token": { "type": "string", "description": "Signed JWT issues by Accedian. Can be used instead of username/password" } } } } }, "required": false }, "responses": { "200": { "description": "Returns the Authenticated User", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/JsonApiAAAUser" } } } }, "401": { "description": "Unauthorized access attempt", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "User not found", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v1/auth/logout": { "post": { "tags": [ "AuthService" ], "summary": "Logout", "description": "Logout a Skylight User", "operationId": "Logout", "parameters": [ { "name": "Content-Type", "in": "header", "description": "", "required": true, "style": "simple", "schema": { "enum": [ "application/x-www-form-urlencoded" ], "type": "string", "example": "application/x-www-form-urlencoded" } } ], "responses": { "200": { "description": "Successfully logged out a Skylight User", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "Session not found", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v1/auth/session": { "get": { "tags": [ "AuthService" ], "summary": "Validate", "description": "Validate an active Skylight Session and return User data", "operationId": "Validate", "parameters": [ { "name": "Content-Type", "in": "header", "description": "", "required": true, "style": "simple", "schema": { "enum": [ "application/x-www-form-urlencoded" ], "type": "string", "example": "application/x-www-form-urlencoded" } } ], "responses": { "200": { "description": "Returns the Authenticated User", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/JsonApiAAAUser" } } } }, "401": { "description": "Session not Authorized", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Session not Valid", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v1/auth/validate": { "get": { "tags": [ "AuthService" ], "summary": "ValidateSessionForProxy", "description": "Validate an active Skylight Session. Sets headers for proxy requests to have access to user data.", "operationId": "ValidateSessionForProxy", "parameters": [ { "name": "Content-Type", "in": "header", "description": "", "required": true, "style": "simple", "schema": { "enum": [ "application/x-www-form-urlencoded" ], "type": "string", "example": "application/x-www-form-urlencoded" } } ], "responses": { "200": { "description": "Sets Headers X-Forwarded-User-Id, X-Forwarded-User-Username, X-Forwarded-Usergroups, and X-Forwarded-User-Roles which contain the Id, Username, and Role respectively of the User for the valid session", "headers": { "X-Forwarded-User-Id": { "description": "Unique identifier of the User in Skylight AAA.", "content": { "text/plain": { "schema": { "type": "string", "description": "Unique identifier of the User in Skylight AAA." } } } }, "X-Forwarded-User-Username": { "description": "The Username of the User in Skylight-AAA.", "content": { "text/plain": { "schema": { "type": "string", "description": "The Username of the User in Skylight-AAA." } } } }, "X-Forwarded-User-Roles": { "description": "The Roles associated with this User in Skylight-AAA.", "content": { "text/plain": { "schema": { "type": "string", "description": "The Roles associated with this User in Skylight-AAA." } } } }, "X-Forwarded-Usergroups": { "description": "The Usergroups associated with this User in Skylight-AAA.", "content": { "text/plain": { "schema": { "type": "string", "description": "The Usergroups associated with this User in Skylight-AAA." } } } }, "X-Forwarded-Tenant-Id": { "description": "The TenantId associated with this request in Skylight-AAA.", "content": { "text/plain": { "schema": { "type": "string", "description": "The TenantId associated with this request in Skylight-AAA." } } } }, "X-Forwarded-JWT": { "description": "The JWT associated with the user session", "content": { "text/plain": { "schema": { "type": "string", "description": "The JWT associated with the user session" } } } } }, "content": { "text/plain": { "schema": { "type": "string" } } } }, "401": { "description": "Session not Authorized", "headers": {}, "content": { "text/plain": { "schema": { "type": "string" } } } }, "403": { "description": "Session not Valid", "headers": {}, "content": { "text/plain": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "text/plain": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v1/auth/service": { "post": { "tags": [ "AuthService" ], "summary": "CreateService", "description": "Create a new Service in Skylight AAA. This function is only available to Skylight Admin users.", "operationId": "CreateService", "parameters": [ { "name": "Content-Type", "in": "header", "description": "", "required": true, "style": "simple", "schema": { "enum": [ "application/x-www-form-urlencoded" ], "type": "string", "example": "application/x-www-form-urlencoded" } } ], "requestBody": { "content": { "application/x-www-form-urlencoded": { "encoding": {}, "schema": { "required": [ "serviceName", "username", "password" ], "type": "object", "properties": { "serviceName": { "type": "string", "description": "Unique identifier of the Service to be added" }, "username": { "type": "string", "description": "Username" }, "password": { "type": "string", "description": "Password" } } } } }, "required": false }, "responses": { "201": { "description": "Service was successfully created in Skylight AAA", "headers": {}, "content": { "text/plain": { "schema": { "type": "string" } } } }, "401": { "description": "User creating the Service is not Authorized to do so", "headers": {}, "content": { "text/plain": { "schema": { "type": "string" } } } }, "403": { "description": "User does not have authorization to perform this operation", "headers": {}, "content": { "text/plain": { "schema": { "type": "string" } } } }, "409": { "description": "Attempt to provision a Service that is already provisioned", "headers": {}, "content": { "text/plain": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "text/plain": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v1/onboarding/tenant-info": { "get": { "tags": [ "AuthService" ], "summary": "GetTenantInfo", "description": "Retrieves the generic identifyiong information for a customer.", "operationId": "GetTenantInfo", "parameters": [ { "name": "Content-Type", "in": "header", "description": "", "required": true, "style": "simple", "schema": { "enum": [ "application/x-www-form-urlencoded" ], "type": "string", "example": "application/x-www-form-urlencoded" } } ], "responses": { "200": { "description": "Successfully retrieved tenant info", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/JsonApiTenantInfo" } } } }, "404": { "description": "No branding found for this tenant", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v1/onboarding/tenant-identity": { "put": { "tags": [ "AuthService" ], "summary": "SetTenantIdentity", "description": "Adds tenant identifying information which is retreived in the 'onboarding/tenant-info' call. Operation is only available to Skylight Administrators.", "operationId": "SetTenantIdentity", "parameters": [], "requestBody": { "description": "", "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/JsonApiTenantInfo" } } }, "required": true }, "responses": { "201": { "description": "Successfully updated tenant identifying information", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/JsonApiTenantInfo" } } } }, "400": { "description": "The request data is not in the proper format", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "401": { "description": "User is not authorized to perform this operation", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have permission to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v1/onboarding/tenant-identity/{subdomain}": { "delete": { "tags": [ "AuthService" ], "summary": "DeleteTenantIdentity", "description": "Deletes tenant identifying information. Operation is only available to Skylight Administrators.", "operationId": "DeleteTenantIdentity", "parameters": [ { "name": "subdomain", "in": "path", "description": "Unique identifier of the Subdomain to delete the tenant mapping", "required": true, "style": "simple", "schema": { "type": "string" } }, { "name": "Content-Type", "in": "header", "description": "", "required": true, "style": "simple", "schema": { "enum": [ "text/plain" ], "type": "string", "example": "text/plain" } } ], "responses": { "200": { "description": "Successfully deleted tenant identifying information", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/JsonApiTenantInfo" } } } }, "400": { "description": "The request data is not in the proper format", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "401": { "description": "User is not authorized to perform this operation", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have permission to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "Tenant identity record not found", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v1/auth/tokens": { "post": { "tags": [ "AuthService" ], "summary": "CreateToken", "description": "Create a new web token for authentication/authorization", "operationId": "CreateToken", "parameters": [], "requestBody": { "description": "", "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/JsonApiJWT" } } }, "required": true }, "responses": { "201": { "description": "Token was successfully created in Skylight AAA", "headers": {}, "content": { "text/plain": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have permission to perform this action", "headers": {}, "content": { "text/plain": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "text/plain": { "schema": { "type": "string" } } } } }, "deprecated": false }, "get": { "tags": [ "AuthService" ], "summary": "GetAllTokens", "description": "Retrieve a list of Tokens known to Skylight AAA", "operationId": "GetAllTokens", "parameters": [ { "name": "Content-Type", "in": "header", "description": "", "required": true, "style": "simple", "schema": { "enum": [ "application/vnd.api+json" ], "type": "string", "example": "application/vnd.api+json" } } ], "responses": { "200": { "description": "Returns a list of tokens known to Skylight AAA", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/JsonApiJWTList" } } } }, "403": { "description": "Requestor does not have permission to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "No Tokens provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v1/auth/tokens/{tokenId}": { "get": { "tags": [ "AuthService" ], "summary": "GetToken", "description": "Retrieve a single Token by its known Id.", "operationId": "GetToken", "parameters": [ { "name": "tokenId", "in": "path", "description": "The unique identifier of the Token to be returned.", "required": true, "style": "simple", "schema": { "type": "integer", "format": "int64" } }, { "name": "Content-Type", "in": "header", "description": "", "required": true, "style": "simple", "schema": { "enum": [ "application/vnd.api+json" ], "type": "string", "example": "application/vnd.api+json" } } ], "responses": { "200": { "description": "Returns a known Token to Skylight AAA", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/JsonApiJWT" } } } }, "403": { "description": "Requestor does not have permission to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "Token not found", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "patch": { "tags": [ "AuthService" ], "summary": "UpdateToken", "description": "Update an existing Token in Skylight AAA.", "operationId": "UpdateToken", "parameters": [ { "name": "tokenId", "in": "path", "description": "The unique identifier of the Token to be updated.", "required": true, "style": "simple", "schema": { "type": "integer", "format": "int64" } } ], "requestBody": { "description": "", "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/JsonApiJWT" } } }, "required": true }, "responses": { "200": { "description": "Token was successfully updated in Skylight AAA", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/JsonApiJWT" } } } }, "403": { "description": "Requestor does not have permission to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "Attempt to update token but it does not exist", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "delete": { "tags": [ "AuthService" ], "summary": "DeleteToken", "description": "Delete a single Token by its known Id.", "operationId": "DeleteToken", "parameters": [ { "name": "tokenId", "in": "path", "description": "The unique identifier of the Token to be deleted.", "required": true, "style": "simple", "schema": { "type": "integer", "format": "int64" } }, { "name": "Content-Type", "in": "header", "description": "", "required": true, "style": "simple", "schema": { "enum": [ "application/vnd.api+json" ], "type": "string", "example": "application/vnd.api+json" } } ], "responses": { "200": { "description": "Returns the now deleted Token from Skylight AAA", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have permission to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "Token not found", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v1/auth/method/{emailAddress}": { "get": { "tags": [ "AuthService" ], "summary": "GetAuthenticationMethod", "description": "Returns a method for authentication given an email address", "operationId": "GetAuthenticationMethod", "parameters": [ { "name": "emailAddress", "in": "path", "description": "Email address of the user trying to authenticate", "required": true, "style": "simple", "schema": { "type": "string" } }, { "name": "Content-Type", "in": "header", "description": "", "required": true, "style": "simple", "schema": { "enum": [ "application/vnd.api+json" ], "type": "string", "example": "application/vnd.api+json" } } ], "responses": { "200": { "description": "Returns authentication method for existing user", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/AuthMethod" } } } }, "204": { "description": "Returns an empty response to indicate that no openID has been provisioned for this tenant", "headers": {}, "content": {} }, "404": { "description": "User with provided email does not exist", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v1/auth/usergroups": { "post": { "tags": [ "AuthService" ], "summary": "CreateUsergroup", "description": "Create a new Usergroup in Skylight AAA", "operationId": "CreateUsergroup", "parameters": [], "requestBody": { "description": "", "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/JsonApiUsergroup" } } }, "required": true }, "responses": { "201": { "description": "Usergroup was successfully created in Skylight AAA", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/JsonApiUsergroup" } } } }, "400": { "description": "Attempt to update usergroup but there is something wrong with the request data", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have permission to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "409": { "description": "Attempt to provision a Usergroup that is already provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "get": { "tags": [ "AuthService" ], "summary": "GetAllUsergroups", "description": "Retrieve a list of Usergroups known to Skylight AAA", "operationId": "GetAllUsergroups", "parameters": [ { "name": "Content-Type", "in": "header", "description": "", "required": true, "style": "simple", "schema": { "enum": [ "application/json" ], "type": "string", "example": "application/json" } } ], "responses": { "200": { "description": "Returns a list of known Usergroups to Skylight AAA", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/JsonApiUsergroupList" } } } }, "403": { "description": "Requestor does not have permission to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "No Usergroups provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v1/auth/usergroups/{usergroupId}": { "get": { "tags": [ "AuthService" ], "summary": "GetUsergroup", "description": "Retrieve a single Usergroup by its known Id.", "operationId": "GetUsergroup", "parameters": [ { "name": "usergroupId", "in": "path", "description": "The unique identifier of the Usergroup to be returned.", "required": true, "style": "simple", "schema": { "type": "integer", "format": "int64" } }, { "name": "Content-Type", "in": "header", "description": "", "required": true, "style": "simple", "schema": { "enum": [ "application/json" ], "type": "string", "example": "application/json" } } ], "responses": { "200": { "description": "Returns a known Usergroup to Skylight AAA", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/JsonApiUsergroup" } } } }, "403": { "description": "Requestor does not have permission to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "Usergroup not found", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "patch": { "tags": [ "AuthService" ], "summary": "UpdateUsergroup", "description": "Update an existing Usergroup in Skylight AAA.", "operationId": "UpdateUsergroup", "parameters": [ { "name": "usergroupId", "in": "path", "description": "The unique identifier of the Usergroup to be updated.", "required": true, "style": "simple", "schema": { "type": "integer", "format": "int64" } } ], "requestBody": { "description": "", "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/JsonApiUsergroupUpdate" } } }, "required": true }, "responses": { "200": { "description": "Usergroup was successfully updated in Skylight AAA", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/JsonApiUsergroup" } } } }, "400": { "description": "Attempt to update usergroup but there is something wrong with the request data", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have permission to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "Attempt to update usergroup but the user does not exist", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "409": { "description": "Attempt to update usergroup but there is a conflict", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "delete": { "tags": [ "AuthService" ], "summary": "DeleteUsergroup", "description": "Delete a single Usergroup by its known Id.", "operationId": "DeleteUsergroup", "parameters": [ { "name": "usergroupId", "in": "path", "description": "The unique identifier of the Usergroup to be deleted.", "required": true, "style": "simple", "schema": { "type": "integer", "format": "int64" } }, { "name": "Content-Type", "in": "header", "description": "", "required": true, "style": "simple", "schema": { "enum": [ "application/json" ], "type": "string", "example": "application/json" } } ], "responses": { "200": { "description": "Returns the now deleted Usergroup from Skylight AAA", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/JsonApiUsergroup" } } } }, "403": { "description": "Requestor does not have permission to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "Usergroup not found", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v1/auth/roles": { "post": { "tags": [ "AuthService" ], "summary": "CreateRole", "description": "Create a new Role in Skylight AAA", "operationId": "CreateRole", "parameters": [], "requestBody": { "description": "", "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/JsonApiRole" } } }, "required": true }, "responses": { "201": { "description": "Role was successfully created in Skylight AAA", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/JsonApiRole" } } } }, "400": { "description": "Bad request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have permission to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "409": { "description": "Attempt to provision a Role that is already provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "get": { "tags": [ "AuthService" ], "summary": "GetAllRoles", "description": "Retrieve a list of Roles known to Skylight AAA in the context of the active tenant", "operationId": "GetAllRoles", "parameters": [ { "name": "Content-Type", "in": "header", "description": "", "required": true, "style": "simple", "schema": { "enum": [ "application/json" ], "type": "string", "example": "application/json" } } ], "responses": { "200": { "description": "Returns a list of known Roles to Skylight AAA", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/JsonApiRoleList" } } } }, "403": { "description": "Requestor does not have permission to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v1/auth/roles/{roleId}": { "get": { "tags": [ "AuthService" ], "summary": "GetRole", "description": "Retrieve a single Role by its known Id", "operationId": "GetRole", "parameters": [ { "name": "roleId", "in": "path", "description": "The unique identifier of the Role to be returned", "required": true, "style": "simple", "schema": { "type": "integer", "format": "int64" } }, { "name": "Content-Type", "in": "header", "description": "", "required": true, "style": "simple", "schema": { "enum": [ "application/json" ], "type": "string", "example": "application/json" } } ], "responses": { "200": { "description": "Returns a known Role to Skylight AAA", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/JsonApiRole" } } } }, "403": { "description": "Requestor does not have permission to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "Role not found", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "patch": { "tags": [ "AuthService" ], "summary": "UpdateRole", "description": "Update an existing Role in Skylight AAA", "operationId": "UpdateRole", "parameters": [ { "name": "roleId", "in": "path", "description": "The unique identifier of the Role to be updated.", "required": true, "style": "simple", "schema": { "type": "integer", "format": "int64" } } ], "requestBody": { "description": "", "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/JsonApiRoleUpdate" } } }, "required": true }, "responses": { "200": { "description": "Role was successfully updated in Skylight AAA", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/JsonApiRole" } } } }, "400": { "description": "Bad Request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have permission to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "Attempt to update Role that does not exist", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "409": { "description": "Attempt to provision a Role that is already provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "delete": { "tags": [ "AuthService" ], "summary": "DeleteRole", "description": "Delete a single Role by its known Id", "operationId": "DeleteRole", "parameters": [ { "name": "roleId", "in": "path", "description": "The unique identifier of the Role to be deleted.", "required": true, "style": "simple", "schema": { "type": "integer", "format": "int64" } }, { "name": "Content-Type", "in": "header", "description": "", "required": true, "style": "simple", "schema": { "enum": [ "application/json" ], "type": "string", "example": "application/json" } } ], "responses": { "200": { "description": "Returns the now deleted Role from Skylight AAA", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/JsonApiRole" } } } }, "403": { "description": "Requestor does not have permission to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "Role not found", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v1/auth/permissions": { "post": { "tags": [ "AuthService" ], "summary": "CreatePermission", "description": "Create a new Permission in Skylight AAA", "operationId": "CreatePermission", "parameters": [], "requestBody": { "description": "", "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/JsonApiPermission" } } }, "required": true }, "responses": { "200": { "description": "Permission already exists", "headers": {}, "content": {} }, "201": { "description": "Permission was successfully created in Skylight AAA", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/JsonApiPermission" } } } }, "400": { "description": "Bad request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have permission to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "409": { "description": "Attempt to provision a Permission that is already provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "get": { "tags": [ "AuthService" ], "summary": "GetAllPermissions", "description": "Retrieve a list of Permissions known to Skylight AAA in the context of the active tenant", "operationId": "GetAllPermissions", "parameters": [ { "name": "domains", "in": "query", "description": "Filter permissions by comma separated list of domains", "style": "form", "explode": true, "schema": { "type": "string" } }, { "name": "app", "in": "query", "description": "Filter permissions by app", "style": "form", "explode": true, "schema": { "type": "string" } }, { "name": "Content-Type", "in": "header", "description": "", "required": true, "style": "simple", "schema": { "enum": [ "application/json" ], "type": "string", "example": "application/json" } } ], "responses": { "200": { "description": "Returns a list of known Permissions to Skylight AAA", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/JsonApiPermissionList" } } } }, "403": { "description": "Requestor does not have permission to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v1/auth/permissions/{permissionId}": { "get": { "tags": [ "AuthService" ], "summary": "GetPermission", "description": "Retrieve a single Permission by its known Id", "operationId": "GetPermission", "parameters": [ { "name": "permissionId", "in": "path", "description": "The unique identifier of the Permission to be returned", "required": true, "style": "simple", "schema": { "type": "integer", "format": "int64" } }, { "name": "Content-Type", "in": "header", "description": "", "required": true, "style": "simple", "schema": { "enum": [ "application/json" ], "type": "string", "example": "application/json" } } ], "responses": { "200": { "description": "Returns a known Permission to Skylight AAA", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/JsonApiPermission" } } } }, "403": { "description": "Requestor does not have permission to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "Permission not found", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "patch": { "tags": [ "AuthService" ], "summary": "UpdatePermission", "description": "Update an existing Permission in Skylight AAA", "operationId": "UpdatePermission", "parameters": [ { "name": "permissionId", "in": "path", "description": "The unique identifier of the Permission to be updated.", "required": true, "style": "simple", "schema": { "type": "integer", "format": "int64" } } ], "requestBody": { "description": "", "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/JsonApiUpdatePermission" } } }, "required": true }, "responses": { "200": { "description": "Role was successfully updated in Skylight AAA", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/JsonApiUpdatePermissionResponse" } } } }, "400": { "description": "Bad Request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have permission to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "Attempt to update Permission that does not exist", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "delete": { "tags": [ "AuthService" ], "summary": "DeletePermission", "description": "Delete a single Permission by its known Id", "operationId": "DeletePermission", "parameters": [ { "name": "permissionId", "in": "path", "description": "The unique identifier of the Permission to be deleted.", "required": true, "style": "simple", "schema": { "type": "integer", "format": "int64" } }, { "name": "Content-Type", "in": "header", "description": "", "required": true, "style": "simple", "schema": { "enum": [ "application/json" ], "type": "string", "example": "application/json" } } ], "responses": { "200": { "description": "Returns the now deleted Permission from Skylight AAA", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/JsonApiPermission" } } } }, "403": { "description": "Requestor does not have permission to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "Permission not found", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v1/export/configurations": { "post": { "tags": [ "ExportService" ], "summary": "CreateScheduledExport", "description": "Creates an export configuration", "operationId": "CreateScheduledExport", "parameters": [], "requestBody": { "description": "", "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/ExportReportsConfigurationModel" } } }, "required": true }, "responses": { "202": { "description": "Report request successfully Created", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/ExportReportsConfigurationModel" } } } }, "400": { "description": "Request data does not pass validation", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": {} }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": {} } }, "deprecated": false }, "get": { "tags": [ "ExportService" ], "summary": "GetAllExportConfigurations", "description": "Gets a list of export report", "operationId": "GetAllExportConfigurations", "parameters": [ { "name": "include_doc", "in": "query", "description": "If true, then the reports themselves will be returned, otherwise, only the document IDs", "style": "form", "explode": true, "schema": { "type": "boolean", "default": false } }, { "name": "raw_metadata_key", "in": "query", "description": "Metadata are mapped internally for speed and this flag exposes the actual key", "style": "form", "explode": true, "schema": { "type": "boolean", "default": false } }, { "name": "enabled", "in": "query", "description": "Only return enabled configs", "style": "form", "explode": true, "schema": { "type": "boolean", "default": true } }, { "name": "Content-Type", "in": "header", "description": "", "required": true, "style": "simple", "schema": { "enum": [ "application/vnd.api+json" ], "type": "string", "example": "application/vnd.api+json" } } ], "responses": { "200": { "description": "Report request successfully queued", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/ExportReportsConfigurationModel" }, "description": "" } } } }, "400": { "description": "Request data does not pass validation", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": {} }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": {} } }, "deprecated": false } }, "/v1/export/configurations/{conf_id}": { "get": { "tags": [ "ExportService" ], "summary": "GetExportConfiguration", "description": "Gets an export configuration", "operationId": "GetExportConfiguration", "parameters": [ { "name": "conf_id", "in": "path", "description": "", "required": true, "style": "simple", "schema": { "type": "string" } }, { "name": "raw_metadata_key", "in": "query", "description": "Metadata are mapped internally for speed and this flag exposes the actual key", "style": "form", "explode": true, "schema": { "type": "boolean", "default": false } }, { "name": "Content-Type", "in": "header", "description": "", "required": true, "style": "simple", "schema": { "enum": [ "application/vnd.api+json" ], "type": "string", "example": "application/vnd.api+json" } } ], "responses": { "200": { "description": "Report request successfully queued", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/ExportReportsConfigurationModel" } } } }, "400": { "description": "Request was invalid", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": {} }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": {} } }, "deprecated": false }, "patch": { "tags": [ "ExportService" ], "summary": "PatchExportConfiguration", "description": "Patch an export Configuration", "operationId": "PatchExportConfiguration", "parameters": [ { "name": "conf_id", "in": "path", "description": "", "required": true, "style": "simple", "schema": { "type": "string" } } ], "requestBody": { "description": "", "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/ExportReportsConfigurationModel" } } }, "required": true }, "responses": { "202": { "description": "Report request successfully queued", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/ExportReportsConfigurationModel" } } } }, "400": { "description": "Request data does not pass validation", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": {} }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": {} } }, "deprecated": false }, "delete": { "tags": [ "ExportService" ], "summary": "DisableExportConfiguration", "description": "Disables an export Configuration", "operationId": "DisableExportConfiguration", "parameters": [ { "name": "conf_id", "in": "path", "description": "", "required": true, "style": "simple", "schema": { "type": "string" } }, { "name": "Content-Type", "in": "header", "description": "", "required": true, "style": "simple", "schema": { "enum": [ "application/vnd.api+json" ], "type": "string", "example": "application/vnd.api+json" } } ], "responses": { "202": { "description": "Report request successfully queued", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/ExportReportsConfigurationModel" } } } }, "400": { "description": "Request data does not pass validation", "headers": {}, "content": {} }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": {} }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": {} } }, "deprecated": false } }, "/v1/export/{conf_id}/reports": { "get": { "tags": [ "ExportService" ], "summary": "GetAllExportReport", "description": "Gets a list of export report", "operationId": "GetAllExportReport", "parameters": [ { "name": "conf_id", "in": "path", "description": "", "required": true, "style": "simple", "schema": { "type": "string" } }, { "name": "Content-Type", "in": "header", "description": "", "required": true, "style": "simple", "schema": { "enum": [ "application/vnd.api+json" ], "type": "string", "example": "application/vnd.api+json" } } ], "responses": { "200": { "description": "Report request successfully queued", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/ExportReportModel" }, "description": "" } } } }, "400": { "description": "Request was invalid", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": {} }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": {} } }, "deprecated": false } }, "/v1/export/{conf_id}/report/{fileName}": { "get": { "tags": [ "ExportService" ], "summary": "GetExportReport", "description": "Download a report csv", "operationId": "GetExportReport", "parameters": [ { "name": "conf_id", "in": "path", "description": "", "required": true, "style": "simple", "schema": { "type": "string" } }, { "name": "fileName", "in": "path", "description": "", "required": true, "style": "simple", "schema": { "type": "string" } } ], "responses": { "200": { "description": "download a report csv", "headers": { "Content-Disposition": { "content": { "text/plain": { "schema": { "type": "string", "example": "attachment; filename=dataset.csv.gz;" }, "example": "attachment; filename=dataset.csv.gz;" } } } }, "content": { "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } }, "400": { "description": "Request data does not pass validation", "headers": {}, "content": { "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } }, "403": { "description": "Client does not have authorization to perform this action", "headers": {}, "content": { "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "deprecated": false } }, "/v1/solution-version-manifest": { "get": { "tags": [ "AdminGetSolutionManifest" ], "summary": "GetSolutionManifest", "description": "Retrieves the Skyligth Analytics release and solution versions as well as the manifest of all services. If the local manifest has been manually modified, the isDirty flag is set to indicate that the currently running version differs from the original version", "operationId": "GetSolutionManifest", "parameters": [], "responses": { "200": { "description": "A manifest containing the solution version as well as the version for all running components", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonApiSolutionManifestResponse" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v3/twe": { "post": { "tags": [ "Time Window Exclusions" ], "summary": "CreateTimeExclusion", "description": "Provisions a time exclusion for the current tenant", "operationId": "CreateTimeExclusion", "parameters": [], "requestBody": { "description": "", "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/TimeExclusionRequestSpec" } } }, "required": true }, "responses": { "201": { "description": "Created", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/TimeExclusionResponseSpec" } } } }, "400": { "description": "Bad Request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Access to resource forbidden for user", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Unexpected error", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "deprecated": false }, "get": { "tags": [ "Time Window Exclusions" ], "summary": "GetAllTimeExclusion", "description": "Retrieves all provisioned time exclusion for the current tenant", "operationId": "GetAllTimeExclusion", "parameters": [ { "name": "Content-Type", "in": "header", "description": "", "required": true, "style": "simple", "schema": { "enum": [ "application/vnd.api+json" ], "type": "string", "example": "application/vnd.api+json" } } ], "responses": { "200": { "description": "Success", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/TimeExclusionResponseArraySpec" } } } }, "403": { "description": "Access to resource forbidden for user", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Unexpected error", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "deprecated": false } }, "/v3/twe/{id}": { "patch": { "tags": [ "Time Window Exclusions" ], "summary": "UpdateTimeExclusion", "description": "Updates a provisioned time exclusion of the current tenant", "operationId": "UpdateTimeExclusion", "parameters": [ { "name": "id", "in": "path", "description": "", "required": true, "style": "simple", "schema": { "type": "string" } } ], "requestBody": { "description": "", "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/TimeExclusionUpdateRequestSpec" } } }, "required": true }, "responses": { "200": { "description": "Updated", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/TimeExclusionResponseSpec" } } } }, "403": { "description": "Access to resource forbidden for user", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not Found", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "412": { "description": "Precondition failed", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "deprecated": false }, "get": { "tags": [ "Time Window Exclusions" ], "summary": "GetTimeExclusion", "description": "Retrieves a provisioned time exclusion for the current tenant by name", "operationId": "GetTimeExclusion", "parameters": [ { "name": "id", "in": "path", "description": "", "required": true, "style": "simple", "schema": { "type": "string" } }, { "name": "Content-Type", "in": "header", "description": "", "required": true, "style": "simple", "schema": { "enum": [ "application/vnd.api+json" ], "type": "string", "example": "application/vnd.api+json" } } ], "responses": { "200": { "description": "Success", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/TimeExclusionResponseSpec" } } } }, "403": { "description": "Access to resource forbidden for user", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not Found", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Unexpected error", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "deprecated": false }, "delete": { "tags": [ "Time Window Exclusions" ], "summary": "DeleteTimeExclusion", "description": "Removes a provisioned time exclusion for the current tenant by name", "operationId": "DeleteTimeExclusion", "parameters": [ { "name": "id", "in": "path", "description": "", "required": true, "style": "simple", "schema": { "type": "string" } }, { "name": "Content-Type", "in": "header", "description": "", "required": true, "style": "simple", "schema": { "enum": [ "application/vnd.api+json" ], "type": "string", "example": "application/vnd.api+json" } } ], "responses": { "204": { "description": "Deleted", "headers": {}, "content": {} }, "403": { "description": "Access to resource forbidden for user", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not Found", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Unexpected error", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "deprecated": false } }, "/v3/twe/events": { "get": { "tags": [ "Time Window Exclusions" ], "summary": "TimeExclusionEvents", "description": "Returns all time window exclusions for the tenant that have occurrences between start and end time. If monitoredObjectID is specified, only time window exclusions that affect the monitored object during the specified time window are returned", "operationId": "TimeExclusionEvents", "parameters": [ { "name": "start", "in": "query", "description": "", "required": true, "style": "form", "explode": true, "schema": { "type": "integer", "format": "int32" } }, { "name": "end", "in": "query", "description": "", "required": true, "style": "form", "explode": true, "schema": { "type": "integer", "format": "int32" } }, { "name": "monitoredObjectID", "in": "query", "description": "", "style": "form", "explode": true, "schema": { "type": "string" } }, { "name": "Content-Type", "in": "header", "description": "", "required": true, "style": "simple", "schema": { "enum": [ "application/vnd.api+json" ], "type": "string", "example": "application/vnd.api+json" } } ], "responses": { "200": { "description": "Success", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/TimeWindowExclusionEventArraySpec" } } } }, "400": { "description": "Bad request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Access to resource forbidden for user", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Monitored object not found", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Unexpected error", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "deprecated": false } }, "/v2/tenants": { "post": { "tags": [ "AdminProvisioningServiceV2" ], "summary": "CreateTenantV2", "description": "Create a Tenant.", "operationId": "CreateTenantV2", "parameters": [], "requestBody": { "description": "", "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/TenantCreationRequest" } } }, "required": true }, "responses": { "201": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/TenantResponse" } } } }, "400": { "description": "Request data does not pass validation", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "409": { "description": "The Tenant being provisioned already exists", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "get": { "tags": [ "AdminProvisioningServiceV2" ], "summary": "GetAllTenantsV2", "description": "Retrieve all Tenants.", "operationId": "GetAllTenantsV2", "parameters": [], "responses": { "200": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/TenantListResponse" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "There are no Tenants provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v2/tenants/{tenantId}": { "get": { "tags": [ "AdminProvisioningServiceV2" ], "summary": "GetTenantV2", "description": "Retrieve a Tenant by id.", "operationId": "GetTenantV2", "parameters": [ { "name": "tenantId", "in": "path", "description": "", "required": true, "style": "simple", "schema": { "type": "string" } } ], "responses": { "200": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/TenantResponse" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "There requested Tenant is not provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "delete": { "tags": [ "AdminProvisioningServiceV2" ], "summary": "DeleteTenantV2", "description": "Delete a Tenant", "operationId": "DeleteTenantV2", "parameters": [ { "name": "tenantId", "in": "path", "description": "", "required": true, "style": "simple", "schema": { "type": "string" } } ], "responses": { "200": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/TenantResponse" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "There requested Tenant is not provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "patch": { "tags": [ "AdminProvisioningServiceV2" ], "summary": "PatchTenantV2", "description": "Patch a Tenant", "operationId": "PatchTenantV2", "parameters": [ { "name": "tenantId", "in": "path", "description": "", "required": true, "style": "simple", "schema": { "type": "string" } } ], "requestBody": { "description": "", "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/TenantUpdateRequest" } } }, "required": true }, "responses": { "200": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/TenantResponse" } } } }, "400": { "description": "Request data does not pass validation", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "There requested Tenant is not provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "409": { "description": "Incorrect revision provided for the update request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v2/tenant-by-alias/{value}": { "get": { "tags": [ "AdminProvisioningServiceV2" ], "summary": "GetTenantIdByAliasV2", "description": "Returns the Id of a Tenant that matches the provided alias.", "operationId": "GetTenantIdByAliasV2", "parameters": [ { "name": "value", "in": "path", "description": "", "required": true, "style": "simple", "schema": { "type": "string" } } ], "responses": { "200": { "description": "", "headers": {}, "content": { "text/plain": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "text/plain": { "schema": { "type": "string" } } } }, "404": { "description": "There requested Tenant is not provisioned", "headers": {}, "content": { "text/plain": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "text/plain": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v2/tenant-summary-by-alias/{value}": { "get": { "tags": [ "AdminProvisioningServiceV2" ], "summary": "GetTenantSummaryByAliasV2", "description": "Returns a summary of the Tenant that matches the provided alias.", "operationId": "GetTenantSummaryByAliasV2", "parameters": [ { "name": "value", "in": "path", "description": "", "required": true, "style": "simple", "schema": { "type": "string" } } ], "responses": { "200": { "description": "", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TenantSummaryResponse" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/json": { "schema": { "type": "string" } } } }, "404": { "description": "There requested Tenant is not provisioned", "headers": {}, "content": { "application/json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v2/ingestion-dictionaries": { "get": { "tags": [ "AdminProvisioningServiceV2" ], "summary": "GetIngestionDictionaryV2", "description": "Retrieve an Ingestion Dictionary.", "operationId": "GetIngestionDictionaryV2", "parameters": [], "responses": { "200": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/IngestionDictionaryListResponse" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v2/valid-types": { "get": { "tags": [ "AdminProvisioningServiceV2" ], "summary": "GetValidTypesV2", "description": "Retrieve a Valid Types object.", "operationId": "GetValidTypesV2", "parameters": [], "responses": { "200": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/ValidTypesListResponse" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v2/tenant-metadata/{tenantId}": { "get": { "tags": [ "AdminProvisioningServiceV2" ], "summary": "GetTenantMetadataV2", "description": "Retrieve a Tenant's Metadata. This API is authorized to Datahub Administrators only.", "operationId": "GetTenantMetadataV2", "parameters": [ { "name": "tenantId", "in": "path", "description": "", "required": true, "style": "simple", "schema": { "type": "string" } } ], "responses": { "200": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/TenantMetadataResponse" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "The specified TenantMetadata is not provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "patch": { "tags": [ "AdminProvisioningServiceV2" ], "summary": "UpdateTenantMetadataV2", "description": "Update a Tenant's Metadata. This API is authorized to Datahub Administrators only.", "operationId": "UpdateTenantMetadataV2", "parameters": [ { "name": "tenantId", "in": "path", "description": "", "required": true, "style": "simple", "schema": { "type": "string" } } ], "requestBody": { "description": "", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TenantMetadataUpdateRequest" } } }, "required": true }, "responses": { "200": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/TenantMetadataResponse" } } } }, "400": { "description": "Request data does not pass validation", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "The specified TenantMetadata is not provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "409": { "description": "Incorrect revision number passed in to the TenantMetadata being updated", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v2/alerts/monitoredObjectIds/{monitoredObjectId}": { "get": { "tags": [ "TenantAlertServiceV2" ], "summary": "getAlertsForMonitoredObject", "description": "Retrieve the alerts for a given monitoredObjectId over an interval", "operationId": "getAlertsForMonitoredObject", "parameters": [ { "name": "monitoredObjectId", "in": "path", "description": "The monitored object id", "required": true, "style": "simple", "schema": { "type": "string" } }, { "name": "interval", "in": "query", "description": "The interval in ISO 6801 standard but with the '/' replaced with '_'", "required": true, "style": "form", "explode": true, "schema": { "type": "string" } }, { "name": "alertState", "in": "query", "description": "Filter on a particular condition. If left empty, both raised and clears will be returned.", "style": "form", "explode": true, "schema": { "$ref": "#/components/schemas/alertState3" } }, { "name": "policyId", "in": "query", "description": "The Policy ID", "style": "form", "explode": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Retrieved alerts successfully", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AlertsPayloadListResponse" } }, "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/AlertsPayloadListResponse" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/json": { "schema": { "type": "string" } }, "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/json": { "schema": { "type": "string" } }, "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v2/alerts/active/monitoredObjectIds/{monitoredObjectId}": { "get": { "tags": [ "TenantAlertServiceV2" ], "summary": "getActiveAlertsForMonitoredObject", "description": "Retrieve active alerts for the provided monitoredObjectId", "operationId": "getActiveAlertsForMonitoredObject", "parameters": [ { "name": "monitoredObjectId", "in": "path", "description": "The monitored object id", "required": true, "style": "simple", "schema": { "type": "string" } }, { "name": "policyId", "in": "query", "description": "The policyId", "style": "form", "explode": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Retrieved active alerts successfully", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ActiveAlertsListResponse" } }, "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/ActiveAlertsListResponse" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/json": { "schema": { "type": "string" } }, "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/json": { "schema": { "type": "string" } }, "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "delete": { "tags": [ "TenantAlertServiceV2" ], "summary": "deleteActiveAlertsForMonitoredObject", "description": "Delete Active Alerts for the provided monitoredObjectId", "operationId": "deleteActiveAlertsForMonitoredObject", "parameters": [ { "name": "monitoredObjectId", "in": "path", "description": "The monitored object id", "required": true, "style": "simple", "schema": { "type": "string" } }, { "name": "policyId", "in": "query", "description": "The policyId", "style": "form", "explode": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Deleted active alerts successfully", "headers": {}, "content": { "application/json": { "schema": { "type": "string" } }, "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/json": { "schema": { "type": "string" } }, "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/json": { "schema": { "type": "string" } }, "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v2/alerts/active/monitoredObjectIds": { "post": { "tags": [ "TenantAlertServiceV2" ], "summary": "createActiveAlertForMonitoredObject", "description": "Create active alerts for the provided monitoredObjectId", "operationId": "createActiveAlertForMonitoredObject", "parameters": [], "requestBody": { "description": "The Active Alert", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ActiveAlert" } } }, "required": true }, "responses": { "200": { "description": "Created active alerts successfully", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ActiveAlert" } }, "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/ActiveAlert" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/json": { "schema": { "type": "string" } }, "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/json": { "schema": { "type": "string" } }, "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v2/alerts/active/policies/{policyId}": { "get": { "tags": [ "TenantAlertServiceV2" ], "summary": "getActiveAlertsForPolicy", "description": "Retrieve active alerts for the provided policyId", "operationId": "getActiveAlertsForPolicy", "parameters": [ { "name": "policyId", "in": "path", "description": "The policyId", "required": true, "style": "simple", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Delete active alerts successfully", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ActiveAlertsListResponse" } }, "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/ActiveAlertsListResponse" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/json": { "schema": { "type": "string" } }, "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/json": { "schema": { "type": "string" } }, "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "delete": { "tags": [ "TenantAlertServiceV2" ], "summary": "deleteActiveAlertsForPolicy", "description": "Delete Active Alerts for the provided policyId", "operationId": "deleteActiveAlertsForPolicy", "parameters": [ { "name": "policyId", "in": "path", "description": "The policyId", "required": true, "style": "simple", "schema": { "type": "string" } }, { "name": "monitoredObjectId", "in": "query", "description": "The monitored object id", "style": "form", "explode": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Deleted active alerts successfully", "headers": {}, "content": { "application/json": { "schema": { "type": "string" } }, "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/json": { "schema": { "type": "string" } }, "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/json": { "schema": { "type": "string" } }, "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v2/alerts/active/groupBy": { "post": { "tags": [ "TenantAlertServiceV2" ], "summary": "getActiveAlertGroupBy", "description": "Retrieves specified aggregation grouped by the provided fields and filtered by the metadata specification", "operationId": "getActiveAlertGroupBy", "parameters": [], "requestBody": { "description": "", "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/JsonApiActiveAlertGroupByRequest" } } }, "required": true }, "responses": { "200": { "description": "Group by successfully processed", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/JsonApiActiveAlertGroupByResponse" } } } }, "400": { "description": "Request data does not pass validation", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "Missing provisioned data", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v2/alerts/active": { "post": { "tags": [ "TenantAlertServiceV2" ], "summary": "getActiveAlertsForMetaFilter", "description": "Retrieve Active Alerts based on the provided filter criterea", "operationId": "getActiveAlertsForMetaFilter", "parameters": [], "requestBody": { "description": "", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ActiveAlertsFilteredListRequest" } } }, "required": true }, "responses": { "200": { "description": "A List of active alerts based on the provided filter criterea", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ActiveAlertsListResponse" } }, "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/ActiveAlertsListResponse" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/json": { "schema": { "type": "string" } }, "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/json": { "schema": { "type": "string" } }, "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v2/alerts/active/count": { "post": { "tags": [ "TenantAlertServiceV2" ], "summary": "getActiveAlertsFilteredCounts", "description": "Retrieve Counts of Active Alerts based on the provided filter criterea", "operationId": "getActiveAlertsFilteredCounts", "parameters": [], "requestBody": { "description": "", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ActiveAlertsFilteredCountsRequest" } } }, "required": true }, "responses": { "200": { "description": "A count of active alerts based on the provided filter criterea", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ActiveAlertsFilteredCountsResponse" } }, "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/ActiveAlertsFilteredCountsResponse" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/json": { "schema": { "type": "string" } }, "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/json": { "schema": { "type": "string" } }, "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v2/alerts/active/securityState": { "post": { "tags": [ "TenantAlertServiceV2" ], "summary": "updateActiveAlertsSecurityState", "description": "Update the security state of alerts with provided objectIDs", "operationId": "updateActiveAlertsSecurityState", "parameters": [], "requestBody": { "description": "", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ActiveAlertsSecurityStateUpdateRequest" } } }, "required": true }, "responses": { "200": { "description": "Security state changed successfully, returns updated alerts", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ActiveAlertsListResponse" } }, "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/ActiveAlertsListResponse" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/json": { "schema": { "type": "string" } }, "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/json": { "schema": { "type": "string" } }, "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v2/policies/alerting": { "post": { "tags": [ "TenantAlertServiceV2" ], "summary": "createRequestAlertPolicy", "description": "Create an Alert Policy", "operationId": "createRequestAlertPolicy", "parameters": [], "requestBody": { "description": "", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/alertPolicyCreateRequest" } } }, "required": true }, "responses": { "201": { "description": "Policy creation completed successfully", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/alertPolicyResponse" } }, "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/alertPolicyResponse" } } } }, "400": { "description": "Request data does not pass validation", "headers": {}, "content": { "application/json": { "schema": { "type": "string" } }, "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requester does not have authorization to perform this action", "headers": {}, "content": { "application/json": { "schema": { "type": "string" } }, "application/vnd.api+json": { "schema": { "type": "string" } } } }, "409": { "description": "There was a conflict when creating the record", "headers": {}, "content": { "application/json": { "schema": { "type": "string" } }, "application/vnd.api+json": { "schema": { "type": "string" } } } }, "422": { "description": "The provided request did not pass validation", "headers": {}, "content": { "application/json": { "schema": { "type": "string" } }, "application/vnd.api+json": { "schema": { "type": "string" } } } }, "424": { "description": "The provided request Failed Dependency", "headers": {}, "content": { "application/json": { "schema": { "type": "string" } }, "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/json": { "schema": { "type": "string" } }, "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "get": { "tags": [ "TenantAlertServiceV2" ], "summary": "getAllRequestAlertPolicy", "description": "Get all Alert Policies", "operationId": "getAllRequestAlertPolicy", "parameters": [ { "name": "useRawMetaKey", "in": "query", "description": "Returns the raw metadata key's ID from the DB.", "style": "form", "explode": true, "schema": { "type": "boolean", "default": false } }, { "name": "includeDeleted", "in": "query", "description": "Include deleted policies in the results.", "style": "form", "explode": true, "schema": { "type": "boolean", "default": false } }, { "name": "policyType", "in": "query", "description": "Only include policies of specified types.", "style": "form", "explode": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Policy get successful", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/alertPoliciesResponse" } }, "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/alertPoliciesResponse" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/json": { "schema": { "type": "string" } }, "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/json": { "schema": { "type": "string" } }, "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v2/policies/alerting/automatic": { "patch": { "tags": [ "TenantAlertServiceV2" ], "summary": "patchAutomaticAlertPolicy", "description": "Patch automaticAlertPolicy", "operationId": "patchAutomaticAlertPolicy", "parameters": [], "requestBody": { "description": "", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AutomaticAlertPolicyCreateRequest" } } }, "required": true }, "responses": { "201": { "description": "Policy creation completed successfully", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AutomaticAlertPolicyResponse" } }, "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/AutomaticAlertPolicyResponse" } } } }, "400": { "description": "Request data does not pass validation", "headers": {}, "content": { "application/json": { "schema": { "type": "string" } }, "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requester does not have authorization to perform this action", "headers": {}, "content": { "application/json": { "schema": { "type": "string" } }, "application/vnd.api+json": { "schema": { "type": "string" } } } }, "409": { "description": "There was a conflict when creating the record", "headers": {}, "content": { "application/json": { "schema": { "type": "string" } }, "application/vnd.api+json": { "schema": { "type": "string" } } } }, "422": { "description": "The provided request did not pass validation", "headers": {}, "content": { "application/json": { "schema": { "type": "string" } }, "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/json": { "schema": { "type": "string" } }, "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "get": { "tags": [ "TenantAlertServiceV2" ], "summary": "getAutomaticAlertPolicy", "description": "Get Automatic Detection Policy", "operationId": "getAutomaticAlertPolicy", "parameters": [], "responses": { "200": { "description": "Policy get successful", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AutomaticAlertPolicyCreateRequest" } }, "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/AutomaticAlertPolicyCreateRequest" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/json": { "schema": { "type": "string" } }, "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/json": { "schema": { "type": "string" } }, "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v2/policies/alerting/{id}": { "get": { "tags": [ "TenantAlertServiceV2" ], "summary": "getRequestAlertPolicy", "description": "Get a specific Alert Policy", "operationId": "getRequestAlertPolicy", "parameters": [ { "name": "id", "in": "path", "description": "", "required": true, "style": "simple", "schema": { "type": "string" } }, { "name": "useRawMetaKey", "in": "query", "description": "Returns the raw metadata key's ID from the DB.", "style": "form", "explode": true, "schema": { "type": "boolean", "default": false } } ], "responses": { "200": { "description": "Got alert policy document", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/alertPolicyResponse" } }, "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/alertPolicyResponse" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/json": { "schema": { "type": "string" } }, "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/json": { "schema": { "type": "string" } }, "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "delete": { "tags": [ "TenantAlertServiceV2" ], "summary": "deleteRequestAlertPolicy", "description": "Note that this does not physically delete a policy. It will become disabled and unmodifiable in order to provide references to existing alerts.", "operationId": "deleteRequestAlertPolicy", "parameters": [ { "name": "id", "in": "path", "description": "", "required": true, "style": "simple", "schema": { "type": "string" } } ], "responses": { "202": { "description": "Policy Deletion completed successfully", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/alertPolicyResponse" } }, "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/alertPolicyResponse" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/json": { "schema": { "type": "string" } }, "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "No records found", "headers": {}, "content": { "application/json": { "schema": { "type": "string" } }, "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/json": { "schema": { "type": "string" } }, "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "patch": { "tags": [ "TenantAlertServiceV2" ], "summary": "PatchRequestAlertPolicy", "description": "Provides ability to patch a Alert Policy", "operationId": "PatchRequestAlertPolicy", "parameters": [ { "name": "id", "in": "path", "description": "", "required": true, "style": "simple", "schema": { "type": "string" } }, { "name": "force", "in": "query", "description": "If a alert state is currently alarming, Skylight will block put updates if the force query parameter is not set to true.", "style": "form", "explode": true, "schema": { "$ref": "#/components/schemas/force" } } ], "requestBody": { "description": "", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/alertPolicyCreateRequest" } } }, "required": true }, "responses": { "201": { "description": "Policy patch completed successfully", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/alertPolicyResponse" } }, "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/alertPolicyResponse" } } } }, "400": { "description": "Request data does not pass validation", "headers": {}, "content": { "application/json": { "schema": { "type": "string" } }, "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/json": { "schema": { "type": "string" } }, "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "No records found", "headers": {}, "content": { "application/json": { "schema": { "type": "string" } }, "application/vnd.api+json": { "schema": { "type": "string" } } } }, "409": { "description": "There was a conflict when creating the record", "headers": {}, "content": { "application/json": { "schema": { "type": "string" } }, "application/vnd.api+json": { "schema": { "type": "string" } } } }, "422": { "description": "The provided request did not pass validation", "headers": {}, "content": { "application/json": { "schema": { "type": "string" } }, "application/vnd.api+json": { "schema": { "type": "string" } } } }, "424": { "description": "The provided request Failed Dependency", "headers": {}, "content": { "application/json": { "schema": { "type": "string" } }, "application/vnd.api+json": { "schema": { "type": "string" } } } }, "428": { "description": "The provided request is trying to modify alert policy while it is an active alarm.", "headers": {}, "content": { "application/json": { "schema": { "type": "string" } }, "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/json": { "schema": { "type": "string" } }, "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v2/alerts/history/": { "get": { "tags": [ "TenantAlertServiceV2" ], "summary": "getAlertPolicyHistory", "description": "Please use the query parameters to limit the scope of the results. Otherwise, this will return all the raw alerts for a time interval", "operationId": "getAlertPolicyHistory", "parameters": [ { "name": "policyId", "in": "query", "description": "The Policy ID", "style": "form", "explode": true, "schema": { "type": "string" } }, { "name": "interval", "in": "query", "description": "The interval in ISO 6801 standard but with the '/' replaced with '_'", "style": "form", "explode": true, "schema": { "type": "string" } }, { "name": "monitoredObjectId", "in": "query", "description": "The monitored object alert history", "style": "form", "explode": true, "schema": { "type": "string" } }, { "name": "alertState", "in": "query", "description": "Provide all the includes", "style": "form", "explode": true, "schema": { "$ref": "#/components/schemas/alertState4" } }, { "name": "policyType", "in": "query", "description": "", "style": "form", "explode": true, "schema": { "$ref": "#/components/schemas/policyType4" } }, { "name": "limit", "in": "query", "description": "Maximum number of results to return", "style": "form", "explode": true, "schema": { "type": "number", "format": "double" } }, { "name": "useRawMetaKey", "in": "query", "description": "Returns the raw metadata key's ID from the DB.", "style": "form", "explode": true, "schema": { "type": "boolean", "default": false } }, { "name": "category", "in": "query", "description": "Category to filter on", "style": "form", "explode": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Policy history returned", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/alertHistory" } }, "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/alertHistory" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/json": { "schema": { "type": "string" } }, "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/json": { "schema": { "type": "string" } }, "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v2/alerting/groupBy": { "post": { "tags": [ "TenantAlertServiceV2" ], "summary": "GetAlertingGroupByV3", "description": "Retrieves specified aggregation grouped by the provided fields and filtered by the metadata specification", "operationId": "GetAlertingGroupByV3", "parameters": [], "requestBody": { "description": "", "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/JsonApiAlertGroupByRequest" } } }, "required": true }, "responses": { "200": { "description": "Group by successfully processed", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/JsonApiAlertGroupByResponse" } } } }, "400": { "description": "Request data does not pass validation", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "Missing provisioned data", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v2/alerting/aggregate": { "post": { "tags": [ "TenantAlertServiceV2" ], "summary": "GetAlertingAggregateV3", "description": "Aggregates the provided metrics and filters them based on the provided criteria", "operationId": "GetAlertingAggregateV3", "parameters": [], "requestBody": { "description": "", "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/JsonApiAlertAggregateRequest" } } }, "required": true }, "responses": { "200": { "description": "Aggregate query successfully processed", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/JsonApiAlertAggregateResponse" } } } }, "400": { "description": "Request data does not pass validation", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "Missing provisioned data", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v2/ramen/state/{tenantId}": { "get": { "tags": [ "TenantAlertServiceV2" ], "summary": "getRamenState", "description": "Get the latest ramen state for a given tenant.", "operationId": "getRamenState", "parameters": [ { "name": "tenantId", "in": "path", "description": "", "required": true, "style": "simple", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Got the document.", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "object" } } } }, "403": { "description": "Requestor does not have authorization to perform this action.", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "No such tenant.", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request.", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "503": { "description": "Service is not available at all or for that tenant.", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v2/analytics": { "post": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "CreateAnalyticsV2", "description": "Request Analytical analysis from Datahub", "operationId": "CreateAnalyticsV2", "parameters": [], "requestBody": { "description": "", "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/AnalyticsRequest" } } }, "required": true }, "responses": { "201": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/AnalyticsResponse" } } } }, "400": { "description": "Request data does not pass validation", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "get": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "GetAllAnalyticsV2", "description": "Get all currently stored Analytics Result Objects", "operationId": "GetAllAnalyticsV2", "parameters": [ { "name": "Content-Type", "in": "header", "description": "", "required": true, "style": "simple", "schema": { "enum": [ "application/vnd.api+json" ], "type": "string", "example": "application/vnd.api+json" } } ], "responses": { "200": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/AnalyticsListResponse" } } } }, "400": { "description": "Request data does not pass validation", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "No Analytics results found", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v2/analytics/{analyticsId}": { "get": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "GetAnalyticsV2", "description": "Retrieve an Analytics result by Id.", "operationId": "GetAnalyticsV2", "parameters": [ { "name": "analyticsId", "in": "path", "description": "Unique identifier of an Analytics request in Datahub", "required": true, "style": "simple", "schema": { "type": "string" } } ], "responses": { "200": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/AnalyticsResponse" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "The specified Analytics Result is not provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "delete": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "DeleteAnalyticsV2", "description": "Delete an Analytics result by Id.", "operationId": "DeleteAnalyticsV2", "parameters": [ { "name": "analyticsId", "in": "path", "description": "Unique identifier of an Analytics request in Datahub", "required": true, "style": "simple", "schema": { "type": "string" } } ], "responses": { "200": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/AnalyticsResponse" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "The specified Analytics Result is not provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v2/brandings": { "post": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "CreateBrandingV2", "description": "Create a Branding for a Tenant.", "operationId": "CreateBrandingV2", "parameters": [], "requestBody": { "description": "", "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/BrandingCreateRequest" } } }, "required": true }, "responses": { "201": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/BrandingResponse" } } } }, "400": { "description": "Request data does not pass validation", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "409": { "description": "The Branding being provisioned already exists", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "get": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "GetAllBrandingsV2", "description": "Retrieve all Brandings for the specified Tenant.", "operationId": "GetAllBrandingsV2", "parameters": [ { "name": "zone", "in": "query", "description": "", "style": "form", "explode": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/BrandingListResponse" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "No branding records are provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v2/brandings/{brandingId}": { "get": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "GetBrandingV2", "description": "Retrieve a Tenant Branding by Id.", "operationId": "GetBrandingV2", "parameters": [ { "name": "brandingId", "in": "path", "description": "", "required": true, "style": "simple", "schema": { "type": "string" } } ], "responses": { "200": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/BrandingResponse" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "The specified branding is not provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "patch": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "UpdateBrandingV2", "description": "Update a Tenant Branding specified by the provided Branding Id.", "operationId": "UpdateBrandingV2", "parameters": [ { "name": "brandingId", "in": "path", "description": "", "required": true, "style": "simple", "schema": { "type": "string" } } ], "requestBody": { "description": "", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BrandingUpdateRequest" } } }, "required": true }, "responses": { "200": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/BrandingResponse" } } } }, "400": { "description": "Request data does not pass validation", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "The specified branding is not provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "409": { "description": "Incorrect revision number passed in to the branding being updated", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "delete": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "DeleteBrandingV2", "description": "Delete a Tenant Branding specified by the provided Branding Id.", "operationId": "DeleteBrandingV2", "parameters": [ { "name": "brandingId", "in": "path", "description": "", "required": true, "style": "simple", "schema": { "type": "string" } } ], "responses": { "200": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/BrandingResponse" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "The specified branding is not provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v2/locales": { "post": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "CreateLocaleV2", "description": "Create a Locale for a Tenant.", "operationId": "CreateLocaleV2", "parameters": [], "requestBody": { "description": "", "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/LocaleCreateRequest" } } }, "required": true }, "responses": { "201": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/LocaleResponse" } } } }, "400": { "description": "Request data does not pass validation", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "409": { "description": "The Locale being provisioned already exists", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "get": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "GetAllLocalesV2", "description": "Retrieve all Locales for the specified Tenant.", "operationId": "GetAllLocalesV2", "parameters": [], "responses": { "200": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/LocaleListResponse" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "No Locales are provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v2/locales/{localeId}": { "get": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "GetLocaleV2", "description": "Retrieve a Tenant Locale by Id.", "operationId": "GetLocaleV2", "parameters": [ { "name": "localeId", "in": "path", "description": "", "required": true, "style": "simple", "schema": { "type": "string" } } ], "responses": { "200": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/LocaleResponse" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "The requested Locale is not provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "patch": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "UpdateLocaleV2", "description": "Update a Locale for a Tenant.", "operationId": "UpdateLocaleV2", "parameters": [ { "name": "localeId", "in": "path", "description": "", "required": true, "style": "simple", "schema": { "type": "string" } } ], "requestBody": { "description": "", "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/LocaleUpdateRequest" } } }, "required": true }, "responses": { "200": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/LocaleResponse" } } } }, "400": { "description": "Request data does not pass validation", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "The requested Locale is not provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "409": { "description": "Incorrect revision number passed in to the Locale being updated", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "delete": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "DeleteLocaleV2", "description": "Delete a Tenant Locale specified by the provided Locale Id.", "operationId": "DeleteLocaleV2", "parameters": [ { "name": "localeId", "in": "path", "description": "", "required": true, "style": "simple", "schema": { "type": "string" } } ], "responses": { "200": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/LocaleResponse" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "The requested Locale is not provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v2/composite-metrics": { "post": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "CreateCompositeMetricV2", "description": "Create a composite Metric for a Tenant.", "operationId": "CreateCompositeMetricV2", "parameters": [], "requestBody": { "description": "", "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/CompositeMetricCreateRequest" } } }, "required": true }, "responses": { "201": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/CompositeMetricResponse" } } } }, "400": { "description": "Request data does not pass validation", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "409": { "description": "There is already a composite Metric with this ID", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "get": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "GetAllCompositeMetricsV2", "description": "Retrieve all composite metrics for the specified Tenant.", "operationId": "GetAllCompositeMetricsV2", "parameters": [], "responses": { "200": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/CompositeMetricListResponse" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "No composite metrics are provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v2/composite-metrics/{CompositeMetricId}": { "get": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "GetCompositeMetricV2", "description": "Retrieve a composite metric by Id.", "operationId": "GetCompositeMetricV2", "parameters": [ { "name": "CompositeMetricId", "in": "path", "description": "", "required": true, "style": "simple", "schema": { "type": "string" } } ], "responses": { "200": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/CompositeMetricResponse" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "The specified composite metric is not provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "patch": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "UpdateCompositeMetricV2", "description": "Update a composite metric specified by the provided Id.", "operationId": "UpdateCompositeMetricV2", "parameters": [ { "name": "CompositeMetricId", "in": "path", "description": "", "required": true, "style": "simple", "schema": { "type": "string" } } ], "requestBody": { "description": "", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CompositeMetricUpdateRequest" } } }, "required": true }, "responses": { "200": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/CompositeMetricResponse" } } } }, "400": { "description": "Request data does not pass validation", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "The specified composite metric is not provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "409": { "description": "Incorrect revision number passed in to the composite metric being updated", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "delete": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "DeleteCompositeMetricV2", "description": "Delete a composite metric specified by the provided Id.", "operationId": "DeleteCompositeMetricV2", "parameters": [ { "name": "CompositeMetricId", "in": "path", "description": "", "required": true, "style": "simple", "schema": { "type": "string" } } ], "responses": { "200": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/CompositeMetricResponse" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "The specified composite metric is not provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v2/connector-configs": { "post": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "CreateConnectorConfigV2", "description": "Create a ConnectorConfig for a Tenant.", "operationId": "CreateConnectorConfigV2", "parameters": [], "requestBody": { "description": "", "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/ConnectorConfigCreateRequest" } } }, "required": true }, "responses": { "201": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/ConnectorConfigResponse" } } } }, "400": { "description": "Request data does not pass validation", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "409": { "description": "The Connector being provisioned already exists", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "get": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "GetAllConnectorConfigsV2", "description": "Retrieve all ConnectorConfigs for the specified Tenant.", "operationId": "GetAllConnectorConfigsV2", "parameters": [ { "name": "zone", "in": "query", "description": "", "style": "form", "explode": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/ConnectorConfigListResponse" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "No connector configurations are provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v2/connector-configs/{connectorId}": { "get": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "GetConnectorConfigV2", "description": "Retrieve a Tenant ConnectorConfig by Id.", "operationId": "GetConnectorConfigV2", "parameters": [ { "name": "connectorId", "in": "path", "description": "", "required": true, "style": "simple", "schema": { "type": "string" } } ], "responses": { "200": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/ConnectorConfigResponse" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "The specified connector configuration is not provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "patch": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "UpdateConnectorConfigV2", "description": "Update a Tenant ConnectorConfig specified by the provided Connector Id.", "operationId": "UpdateConnectorConfigV2", "parameters": [ { "name": "connectorId", "in": "path", "description": "", "required": true, "style": "simple", "schema": { "type": "string" } } ], "requestBody": { "description": "", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConnectorConfigUpdateRequest" } } }, "required": true }, "responses": { "200": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/ConnectorConfigResponse" } } } }, "400": { "description": "Request data does not pass validation", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "The specified Connector Configuration is not provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "409": { "description": "Incorrect revision number passed in to the Connector Configuration being updated", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "delete": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "DeleteConnectorConfigV2", "description": "Delete a Tenant ConnectorConfig specified by the provided Connector Id.", "operationId": "DeleteConnectorConfigV2", "parameters": [ { "name": "connectorId", "in": "path", "description": "", "required": true, "style": "simple", "schema": { "type": "string" } } ], "responses": { "200": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/ConnectorConfigResponse" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "The specified Connector Configuration is not provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v2/connector-instances": { "post": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "CreateConnectorInstanceV2", "description": "Create a ConnectorInstance for a Tenant.", "operationId": "CreateConnectorInstanceV2", "parameters": [], "requestBody": { "description": "", "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/ConnectorInstanceCreateRequest" } } }, "required": true }, "responses": { "201": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/ConnectorInstanceResponse" } } } }, "400": { "description": "Request data does not pass validation", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "409": { "description": "The Connector Instance being provisioned already exists", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "get": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "GetAllConnectorInstancesV2", "description": "Retrieve all ConnectorInstances for the specified Tenant.", "operationId": "GetAllConnectorInstancesV2", "parameters": [], "responses": { "200": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/ConnectorInstanceListResponse" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "No Connector Instances are provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v2/connector-instances/{connectorInstanceId}": { "get": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "GetConnectorInstanceV2", "description": "Retrieve a Tenant ConnectorInstance by Id.", "operationId": "GetConnectorInstanceV2", "parameters": [ { "name": "connectorInstanceId", "in": "path", "description": "", "required": true, "style": "simple", "schema": { "type": "string" } } ], "responses": { "200": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/ConnectorInstanceResponse" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "The requested Connector Instance is not provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "patch": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "UpdateConnectorInstanceV2", "description": "Update a ConnectorInstance for a Tenant.", "operationId": "UpdateConnectorInstanceV2", "parameters": [ { "name": "connectorInstanceId", "in": "path", "description": "", "required": true, "style": "simple", "schema": { "type": "string" } } ], "requestBody": { "description": "", "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/ConnectorInstanceUpdateRequest" } } }, "required": true }, "responses": { "200": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/ConnectorInstanceResponse" } } } }, "400": { "description": "Request data does not pass validation", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "The requested Connector Instance is not provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "409": { "description": "Incorrect revision number passed in to the Connector Instance being updated", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "delete": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "DeleteConnectorInstanceV2", "description": "Delete a Tenant ConnectorInstance specified by the provided Connector Instance Id.", "operationId": "DeleteConnectorInstanceV2", "parameters": [ { "name": "connectorInstanceId", "in": "path", "description": "", "required": true, "style": "simple", "schema": { "type": "string" } } ], "responses": { "200": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/ConnectorInstanceResponse" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "The requested Connector Instance is not provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v2/dashboards": { "post": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "CreateDashboardV2", "description": "Create a Dashboard for a Tenant.", "operationId": "CreateDashboardV2", "parameters": [], "requestBody": { "description": "", "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/DashboardCreateRequest" } } }, "required": true }, "responses": { "201": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/DashboardResponse" } } } }, "400": { "description": "Request data does not pass validation", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "409": { "description": "The Dashboard being provisioned already exists", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "get": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "GetAllDashboardsV2", "description": "Retrieve all Dashboards for the specified Tenant.", "operationId": "GetAllDashboardsV2", "parameters": [ { "name": "zone", "in": "query", "description": "", "style": "form", "explode": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/DashboardListResponse" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "No Dashboards are provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v2/dashboards/{dashboardId}": { "get": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "GetDashboardV2", "description": "Retrieve a Tenant Dashboard by Id.", "operationId": "GetDashboardV2", "parameters": [ { "name": "dashboardId", "in": "path", "description": "", "required": true, "style": "simple", "schema": { "type": "string" } } ], "responses": { "200": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/DashboardResponse" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "The specified Dashboard is not provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "patch": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "UpdateDashboardV2", "description": "Update a Tenant Dashboard specified by the provided Dashboard Id.", "operationId": "UpdateDashboardV2", "parameters": [ { "name": "dashboardId", "in": "path", "description": "", "required": true, "style": "simple", "schema": { "type": "string" } } ], "requestBody": { "description": "", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DashboardUpdateRequest" } } }, "required": true }, "responses": { "200": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/DashboardResponse" } } } }, "400": { "description": "Request data does not pass validation", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "The specified Dashboard is not provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "409": { "description": "Incorrect revision number passed in to the Dashboard being updated", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "delete": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "DeleteDashboardV2", "description": "Delete a Tenant Dashboard specified by the provided Dashboard Id.", "operationId": "DeleteDashboardV2", "parameters": [ { "name": "dashboardId", "in": "path", "description": "", "required": true, "style": "simple", "schema": { "type": "string" } } ], "responses": { "200": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/DashboardResponse" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "The specified Dashboard is not provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v2/cards": { "post": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "CreateCardV2", "description": "Create a Card for a Tenant.", "operationId": "CreateCardV2", "parameters": [], "requestBody": { "description": "", "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/CardCreateRequest" } } }, "required": true }, "responses": { "201": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/CardResponse" } } } }, "400": { "description": "Request data does not pass validation", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "409": { "description": "The Card being provisioned already exists", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "get": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "GetAllCardsV2", "description": "Retrieve all Cards for the specified Tenant.", "operationId": "GetAllCardsV2", "parameters": [ { "name": "zone", "in": "query", "description": "", "style": "form", "explode": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/CardListResponse" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "No Cardss are provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v2/cards/{cardId}": { "get": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "GetCardV2", "description": "Retrieve a Tenant Card by Id.", "operationId": "GetCardV2", "parameters": [ { "name": "cardId", "in": "path", "description": "", "required": true, "style": "simple", "schema": { "type": "string" } } ], "responses": { "200": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/CardResponse" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "The specified Cards is not provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "patch": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "UpdateCardV2", "description": "Update a Tenant Card specified by the provided Card Id.", "operationId": "UpdateCardV2", "parameters": [ { "name": "cardId", "in": "path", "description": "", "required": true, "style": "simple", "schema": { "type": "string" } } ], "requestBody": { "description": "", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CardUpdateRequest" } } }, "required": true }, "responses": { "200": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/CardResponse" } } } }, "400": { "description": "Request data does not pass validation", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "The specified Cards is not provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "409": { "description": "Incorrect revision number passed in to the Cards being updated", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "delete": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "DeleteCardV2", "description": "Delete a Tenant Card specified by the provided Card Id.", "operationId": "DeleteCardV2", "parameters": [ { "name": "cardId", "in": "path", "description": "", "required": true, "style": "simple", "schema": { "type": "string" } } ], "responses": { "200": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/CardResponse" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "The specified Cards is not provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v2/data-cleaning-profiles": { "post": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "CreateDataCleaningProfile", "description": "Provides ability to Create a Tenant Data Cleaning Profile", "operationId": "CreateDataCleaningProfile", "parameters": [], "requestBody": { "description": "", "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/DataCleaningProfileCreateRequest" } } }, "required": true }, "responses": { "201": { "description": "Profile creation completed successfully", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/DataCleaningProfileResponse" } } } }, "400": { "description": "Request data does not pass validation", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "409": { "description": "There was a conflict when creating the record", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "422": { "description": "The provided request did not pass validation", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "get": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "GetDataCleaningProfiles", "description": "Retrieve all Data Cleaning Profiles for a Tenant.", "operationId": "GetDataCleaningProfiles", "parameters": [], "responses": { "200": { "description": "Fetch completed successfully", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/DataCleaningProfileListResponse" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "Record not found", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v2/data-cleaning-profiles/{profileId}": { "get": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "GetDataCleaningProfile", "description": "Retrieve a Data Cleaning Profiles for a Tenant.", "operationId": "GetDataCleaningProfile", "parameters": [ { "name": "profileId", "in": "path", "description": "", "required": true, "style": "simple", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Fetch completed successfully", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/DataCleaningProfileResponse" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "No records found", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "patch": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "UpdateDataCleaningProfile", "description": "Provides ability to Update a Tenant Data Cleaning Profile", "operationId": "UpdateDataCleaningProfile", "parameters": [ { "name": "profileId", "in": "path", "description": "", "required": true, "style": "simple", "schema": { "type": "string" } } ], "requestBody": { "description": "", "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/DataCleaningProfileUpdateRequest" } } }, "required": true }, "responses": { "200": { "description": "Update completed successfully", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/DataCleaningProfileResponse" } } } }, "400": { "description": "Request data does not pass validation", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "No records found", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "409": { "description": "There was a conflict when updating the record", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "422": { "description": "The provided request did not pass validation", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "delete": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "DeleteDataCleaningProfile", "description": "Delete a Data Cleaning Profile for a Tenant.", "operationId": "DeleteDataCleaningProfile", "parameters": [ { "name": "profileId", "in": "path", "description": "", "required": true, "style": "simple", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Deletion completed successfully", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/DataCleaningProfileResponse" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "No records found", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v2/data-cleaning-history": { "get": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "GetDataCleaningHistory", "description": "Retrieve data cleaning event history for a given monitored object and time period.", "operationId": "GetDataCleaningHistory", "parameters": [ { "name": "monitoredObjectId", "in": "query", "description": "", "required": true, "style": "form", "explode": true, "schema": { "type": "string" } }, { "name": "interval", "in": "query", "description": "ISO-8601 Interval", "required": true, "style": "form", "explode": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Fetch completed successfully", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/DataCleaningHistoryResponse" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "No records found", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v2/distribution/download-roadrunner": { "get": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "DownloadRoadrunner", "description": "Download a roadrunner tarball ready for installing", "operationId": "DownloadRoadrunner", "parameters": [ { "name": "zone", "in": "query", "description": "", "required": true, "style": "form", "explode": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "download roadrunner archive", "headers": { "Content-Disposition": { "content": { "text/plain": { "schema": { "type": "string", "example": "attachment; filename=DataHubConnector.tar.gz;" }, "example": "attachment; filename=DataHubConnector.tar.gz;" } } } }, "content": { "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } }, "400": { "description": "Request data does not pass validation", "headers": {}, "content": { "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "deprecated": false } }, "/v2/ingestion-profiles": { "post": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "CreateIngestionProfileV2", "description": "Create an Ingestion Profile for a Tenant.", "operationId": "CreateIngestionProfileV2", "parameters": [], "requestBody": { "description": "", "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/IngestionProfileCreateRequest" } } }, "required": true }, "responses": { "201": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/IngestionProfileResponse" } } } }, "400": { "description": "Request data does not pass validation", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "409": { "description": "The ingestion profile already exists", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "get": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "GetAllIngestionProfilesV2", "description": "Get all Tenant Ingestion Profiles", "operationId": "GetAllIngestionProfilesV2", "parameters": [ { "name": "Content-Type", "in": "header", "description": "", "required": true, "style": "simple", "schema": { "enum": [ "application/vnd.api+json" ], "type": "string", "example": "application/vnd.api+json" } } ], "responses": { "200": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/IngestionProfileListResponse" } } } }, "400": { "description": "Request data does not pass validation", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "No Ingestion Profile is provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v2/ingestion-profiles/{ingestionProfileId}": { "get": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "GetIngestionProfileV2", "description": "Retrieve a Tenant Ingestion Profile by id.", "operationId": "GetIngestionProfileV2", "parameters": [ { "name": "ingestionProfileId", "in": "path", "description": "", "required": true, "style": "simple", "schema": { "type": "string" } } ], "responses": { "200": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/IngestionProfileResponse" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "The specified Ingestion Profile is not provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "patch": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "UpdateIngestionProfileV2", "description": "Update a Tenant Ingestion Profile", "operationId": "UpdateIngestionProfileV2", "parameters": [ { "name": "ingestionProfileId", "in": "path", "description": "", "required": true, "style": "simple", "schema": { "type": "string" } } ], "requestBody": { "description": "", "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/IngestionProfileUpdateRequest" } } }, "required": true }, "responses": { "200": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/IngestionProfileResponse" } } } }, "400": { "description": "Request data does not pass validation", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "The specified Ingestion Profile is not provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "409": { "description": "Incorrect revision provided for th update request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "delete": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "DeleteIngestionProfileV2", "description": "Delete a Tenant Ingestion Profile specified by the provided Ingestion Profile Id.", "operationId": "DeleteIngestionProfileV2", "parameters": [ { "name": "ingestionProfileId", "in": "path", "description": "", "required": true, "style": "simple", "schema": { "type": "string" } } ], "responses": { "200": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/IngestionProfileResponse" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "The specified Ingestion Profile is not provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v2/metadata-configs": { "post": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "CreateMetadataConfigV2", "description": "Create a Metadata Configuration for a Tenant.", "operationId": "CreateMetadataConfigV2", "parameters": [], "requestBody": { "description": "", "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/MetadataConfigCreateRequest" } } }, "required": true }, "responses": { "201": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/MetadataConfigResponse" } } } }, "400": { "description": "Request data does not pass validation", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "409": { "description": "The Metadata Configuration already exists", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "get": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "GetAllMetadataConfigsV2", "description": "Get all Tenant Metadata Configurations", "operationId": "GetAllMetadataConfigsV2", "parameters": [ { "name": "Content-Type", "in": "header", "description": "", "required": true, "style": "simple", "schema": { "enum": [ "application/vnd.api+json" ], "type": "string", "example": "application/vnd.api+json" } } ], "responses": { "200": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/MetadataConfigListResponse" } } } }, "400": { "description": "Request data does not pass validation", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "No Metadata Configuration is provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v2/metadata-configs/{MetadataConfigId}": { "get": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "GetMetadataConfigV2", "description": "Retrieve a Tenant Metadata Configuration by id.", "operationId": "GetMetadataConfigV2", "parameters": [ { "name": "MetadataConfigId", "in": "path", "description": "", "required": true, "style": "simple", "schema": { "type": "string" } } ], "responses": { "200": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/MetadataConfigResponse" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "The specified Metadata Configuration is not provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "patch": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "UpdateMetadataConfigV2", "description": "Update a Tenant Metadata Configuration", "operationId": "UpdateMetadataConfigV2", "parameters": [ { "name": "MetadataConfigId", "in": "path", "description": "", "required": true, "style": "simple", "schema": { "type": "string" } } ], "requestBody": { "description": "", "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/MetadataConfigUpdateRequest" } } }, "required": true }, "responses": { "200": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/MetadataConfigResponse" } } } }, "400": { "description": "Request data does not pass validation", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "The specified Metadata Configuration is not provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "409": { "description": "Incorrect revision provided for th update request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "delete": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "DeleteMetadataConfigV2", "description": "Delete a Tenant Metadata Configuration specified by the provided Metadata Configuration Id.", "operationId": "DeleteMetadataConfigV2", "parameters": [ { "name": "MetadataConfigId", "in": "path", "description": "", "required": true, "style": "simple", "schema": { "type": "string" } } ], "responses": { "200": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/MetadataConfigResponse" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "The specified Metadata Configuration is not provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v2/metric-baselines/by-monitored-object/{monitoredObjectId}": { "get": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "GetMetricBaselineByMonitoredObjectIdV2", "description": "Retrieve all Tenant Metric Baselines for a single Monitored Object.", "operationId": "GetMetricBaselineByMonitoredObjectIdV2", "parameters": [ { "name": "monitoredObjectId", "in": "path", "description": "", "required": true, "style": "simple", "schema": { "type": "string" } }, { "name": "interval", "in": "query", "description": "", "style": "form", "explode": true, "schema": { "type": "string" } }, { "name": "directions", "in": "query", "description": "", "style": "form", "explode": true, "schema": { "type": "array", "items": { "type": "string" } } }, { "name": "metrics", "in": "query", "description": "", "required": true, "style": "form", "explode": true, "schema": { "type": "array", "items": { "type": "string" } } } ], "responses": { "200": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/MetricBaselineListResponse" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v2/duplicate-monitored-object-reports": { "get": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "GetAllDuplicateMonitoredObjectReportsV2", "description": "Retrieve all Duplicate Monitored Object Reports for the specified Tenant.", "operationId": "GetAllDuplicateMonitoredObjectReportsV2", "parameters": [], "responses": { "200": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/DuplicateMonitoredObjectReportListResponse" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "No DuplicateMonitoredObjectReports are provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "post": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "GenerateDuplicateMonitoredObjectReportV2", "description": "Updates the DuplicateMonitoredObjectReport for the specified Tenant.", "operationId": "GenerateDuplicateMonitoredObjectReportV2", "parameters": [], "responses": { "200": { "description": "The request to update teh Duplicate Monitored Object Report was accepted", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v2/duplicate-monitored-object-reports/{duplicateMonitoredObjectResportId}": { "get": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "GetDuplicateMonitoredObjectReportV2", "description": "Retrieve a Tenant Duplicate Monitored Object Report by Id.", "operationId": "GetDuplicateMonitoredObjectReportV2", "parameters": [ { "name": "duplicateMonitoredObjectResportId", "in": "path", "description": "", "required": true, "style": "simple", "schema": { "type": "string" } } ], "responses": { "200": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/DuplicateMonitoredObjectReportResponse" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "The requested DuplicateMonitoredObjectReport is not provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v2/monitored-object-tag-mappings": { "post": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "CreateMonitoredObjectTagMappingV2", "description": "Create a MonitoredObjectTagMapping for a Tenant.", "operationId": "CreateMonitoredObjectTagMappingV2", "parameters": [], "requestBody": { "description": "", "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/MonitoredObjectTagMappingCreateRequest" } } }, "required": true }, "responses": { "201": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/MonitoredObjectTagMappingResponse" } } } }, "400": { "description": "Request data does not pass validation", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "409": { "description": "The MonitoredObjectTagMapping being provisioned already exists", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "get": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "GetAllMonitoredObjectTagMappingsV2", "description": "Retrieve all MonitoredObjectTagMappings for the specified Tenant.", "operationId": "GetAllMonitoredObjectTagMappingsV2", "parameters": [ { "name": "zone", "in": "query", "description": "", "style": "form", "explode": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/MonitoredObjectTagMappingListResponse" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "No MonitoredObjectTagMappings are provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v2/monitored-object-tag-mappings/{monitoredObjectTagMappingId}": { "get": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "GetMonitoredObjectTagMappingV2", "description": "Retrieve a Tenant MonitoredObjectTagMapping by Id.", "operationId": "GetMonitoredObjectTagMappingV2", "parameters": [ { "name": "monitoredObjectTagMappingId", "in": "path", "description": "", "required": true, "style": "simple", "schema": { "type": "string" } } ], "responses": { "200": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/MonitoredObjectTagMappingResponse" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "The specified MonitoredObjectTagMapping is not provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "patch": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "UpdateMonitoredObjectTagMappingV2", "description": "Update a Tenant MonitoredObjectTagMapping specified by the provided MonitoredObjectTagMapping Id.", "operationId": "UpdateMonitoredObjectTagMappingV2", "parameters": [ { "name": "monitoredObjectTagMappingId", "in": "path", "description": "", "required": true, "style": "simple", "schema": { "type": "string" } } ], "requestBody": { "description": "", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MonitoredObjectTagMappingUpdateRequest" } } }, "required": true }, "responses": { "200": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/MonitoredObjectTagMappingResponse" } } } }, "400": { "description": "Request data does not pass validation", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "The specified MonitoredObjectTagMapping is not provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "409": { "description": "Incorrect revision number passed in to the MonitoredObjectTagMapping being updated", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "delete": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "DeleteMonitoredObjectTagMappingV2", "description": "Delete a Tenant MonitoredObjectTagMapping specified by the provided MonitoredObjectTagMapping Id.", "operationId": "DeleteMonitoredObjectTagMappingV2", "parameters": [ { "name": "monitoredObjectTagMappingId", "in": "path", "description": "", "required": true, "style": "simple", "schema": { "type": "string" } } ], "responses": { "200": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/MonitoredObjectTagMappingResponse" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "The specified MonitoredObjectTagMapping is not provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v2/monitored-objects": { "get": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "GetAllMonitoredObjectsV2", "description": "Retrieve all Monitored Objects for a Tenant.", "operationId": "GetAllMonitoredObjectsV2", "parameters": [ { "name": "start_key", "in": "query", "description": "The name of the Monitored Object from which the result set will begin", "style": "form", "explode": true, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "description": "The maximum number of records to return for a single page", "style": "form", "explode": true, "schema": { "type": "integer", "format": "int32" } } ], "responses": { "200": { "description": "Fetch completed successfully", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/MonitoredObjectListResponse" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "No Monitored objects are provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "post": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "CreateMonitoredObjectV2", "description": "Create a Monitored Object for a Tenant.", "operationId": "CreateMonitoredObjectV2", "parameters": [], "requestBody": { "description": "", "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/MonitoredObjectCreateRequest" } } }, "required": true }, "responses": { "201": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/MonitoredObjectResponse" } } } }, "400": { "description": "Request data does not pass validation", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "409": { "description": "A Monitored Object with this objectId is already provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v2/monitored-objects/count": { "post": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "GetFilteredMonitoredObjectCountV2", "description": "Retrieve a count of monitored objects based on the provided filter criteria", "operationId": "GetFilteredMonitoredObjectCountV2", "parameters": [ { "name": "group-by", "in": "query", "description": "", "style": "form", "explode": true, "schema": { "$ref": "#/components/schemas/group-by1" } } ], "requestBody": { "description": "", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MonitoredObjectFilteredListRequest" } } }, "required": true }, "responses": { "200": { "description": "Response list containing counts by provided grouping that match the provided meta filter criteria", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/MonitoredObjectFilteredCountResponse" } } } }, "400": { "description": "Request data does not pass validation", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v2/monitored-objects/id-list": { "post": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "GetFilteredMonitoredObjectListV2", "description": "Retrieve a list of monitored objects based on the provided filter criteria", "operationId": "GetFilteredMonitoredObjectListV2", "parameters": [], "requestBody": { "description": "", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MonitoredObjectFilteredListRequest" } } }, "required": true }, "responses": { "200": { "description": "Response list containing all monitored object IDs that match the provided meta filter criteria", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/MonitoredObjectFilteredListResponse" } } } }, "400": { "description": "Request data does not pass validation", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v2/monitored-objects/reporting": { "post": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "GetMonitoredObjectReportingListV2", "description": "Retrieve a list of monitored objects based on the provided reporting status criteria", "operationId": "GetMonitoredObjectReportingListV2", "parameters": [], "requestBody": { "description": "", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MonitoredObjectReportingListRequest" } } }, "required": true }, "responses": { "200": { "description": "Response list containing all monitored object IDs that match the provided reporting status criteria", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/MonitoredObjectFilteredListResponse" } } } }, "400": { "description": "Request data does not pass validation", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v2/monitored-object-geo-clusters": { "post": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "GetMonitoredObjectGeoClustersV2", "description": "Retrieve set of counts clustered by GeoHash identifiers specified by the open source GeoHashing algorithm.", "operationId": "GetMonitoredObjectGeoClustersV2", "parameters": [ { "name": "precision", "in": "query", "description": "The level of precision required for the geohashing grid", "required": true, "style": "form", "explode": true, "schema": { "type": "integer", "format": "int32" } }, { "name": "location", "in": "query", "description": "The location field that we want clustering based off of", "required": true, "style": "form", "explode": true, "schema": { "$ref": "#/components/schemas/location" } } ], "requestBody": { "description": "", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MonitoredObjectFilteredListRequest" } } }, "required": false }, "responses": { "200": { "description": "Counts of monitored objects grouped by GeoHash identifiers", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/MonitoredObjectGeoClusterResponse" } } } }, "400": { "description": "Request data does not pass validation", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v2/monitored-object-meta-details": { "get": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "GetMonitoredObjectMetadataDetailsV2", "description": "Retrieve a record of the provisioned metadata including the counts of Monitored Objects that use each metadata value", "operationId": "GetMonitoredObjectMetadataDetailsV2", "parameters": [ { "name": "meta", "in": "query", "description": "List of metadata category names by which the request should be filtered", "style": "form", "explode": true, "schema": { "type": "array", "items": { "type": "string" } } }, { "name": "value-prefix", "in": "query", "description": "Prefix by which all metadata values names by should start", "style": "form", "explode": true, "schema": { "type": "string" } }, { "name": "categories-only", "in": "query", "description": "Flag to indicate if the response should include only the metadata category names (when set to true) or also include meta values and counts (when set to false)", "style": "form", "explode": true, "schema": { "type": "boolean", "default": false } }, { "name": "Content-Type", "in": "header", "description": "", "required": true, "style": "simple", "schema": { "enum": [ "application/json" ], "type": "string", "example": "application/json" } } ], "responses": { "200": { "description": "Response list containing all monitored object IDs that match the provided meta filter criteria", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/MonitoredObjectMetadataDetailsListResponse" } } } }, "400": { "description": "Request data does not pass validation", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "post": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "GetFilteredMonitoredObjectMetadataDetailsV2", "description": "Retrieve a record of the provisioned metadata including the counts of Monitored Objects that use each metadata value after being filtered by the passed in request body parameters", "operationId": "GetFilteredMonitoredObjectMetadataDetailsV2", "parameters": [], "requestBody": { "description": "", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MonitoredObjectFilteredListRequest" } } }, "required": true }, "responses": { "200": { "description": "Response list containing all monitored object IDs that match the provided meta filter criteria", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/MonitoredObjectMetadataDetailsListResponse" } } } }, "400": { "description": "Request data does not pass validation", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v2/monitored-objects/{monObjId}": { "get": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "GetMonitoredObjectV2", "description": "Retrieve a Tenant Monitored Object by id.", "operationId": "GetMonitoredObjectV2", "parameters": [ { "name": "monObjId", "in": "path", "description": "", "required": true, "style": "simple", "schema": { "type": "string" } } ], "responses": { "200": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/MonitoredObjectResponse" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "The requested Monitored Object is not provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "patch": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "UpdateMonitoredObjectV2", "description": "Update a Tenant Monitored Object", "operationId": "UpdateMonitoredObjectV2", "parameters": [ { "name": "monObjId", "in": "path", "description": "", "required": true, "style": "simple", "schema": { "type": "string" } } ], "requestBody": { "description": "", "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/MonitoredObjectUpdateRequest" } } }, "required": true }, "responses": { "200": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/MonitoredObjectResponse" } } } }, "400": { "description": "Request data does not pass validation", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "The requested Monitored Object is not provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "409": { "description": "Incorrect revision provided for the update request to the Monitored Object", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "delete": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "DeleteMonitoredObjectV2", "description": "Delete a Tenant Monitored Object specified by the provided id.", "operationId": "DeleteMonitoredObjectV2", "parameters": [ { "name": "monObjId", "in": "path", "description": "", "required": true, "style": "simple", "schema": { "type": "string" } } ], "responses": { "200": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/MonitoredObjectResponse" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "The requested Monitored Object is not provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v2/bulk/patch/monitored-objects": { "patch": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "BulkPatchMonitoredObjectsV2", "description": "Patches one or more Monitored Objects's based on the provided values", "operationId": "BulkPatchMonitoredObjectsV2", "parameters": [], "requestBody": { "description": "", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BulkMonitoredObjectPatchRequest" } } }, "required": true }, "responses": { "200": { "description": "", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BulkOperationResponseV2" } } } }, "400": { "description": "Request data does not pass validation", "headers": {}, "content": { "application/json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v2/bulk/insert/monitored-objects": { "post": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "BulkInsertMonitoredObjectsV2", "description": "Create one or more Monitored Objects in a single API request.", "operationId": "BulkInsertMonitoredObjectsV2", "parameters": [], "requestBody": { "description": "", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BulkMonitoredObjectCreateRequest" } } }, "required": true }, "responses": { "200": { "description": "", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BulkOperationResponseV2" } } } }, "400": { "description": "Request data does not pass validation", "headers": {}, "content": { "application/json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "put": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "BulkUpdateMonitoredObjectsV2", "description": "Update one or more Monitored Objects in a single API request. Note that this is a PUT operation for each Monitored Object. This means that all properties must be explicitly provided", "operationId": "BulkUpdateMonitoredObjectsV2", "parameters": [], "requestBody": { "description": "", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BulkMonitoredObjectUpdateRequest" } } }, "required": true }, "responses": { "200": { "description": "", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BulkOperationResponseV2" } } } }, "400": { "description": "Request data does not pass validation", "headers": {}, "content": { "application/json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v2/bulk/insert/monitored-objects/meta": { "post": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "BulkInsertMonitoredObjectsMetaV2", "description": "Update the metadata of one or more Monitored Objects in a single API request.", "operationId": "BulkInsertMonitoredObjectsMetaV2", "parameters": [], "requestBody": { "description": "", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BulkMonitoredObjectMetaCreateRequest" } } }, "required": true }, "responses": { "200": { "description": "", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BulkOperationResponseV2" } } } }, "400": { "description": "Request data does not pass validation", "headers": {}, "content": { "application/json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v2/monitored-object-summaries": { "get": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "GetAllMonitoredObjectSummariesV2", "description": "Retrieve all Monitored Object Summaries for a Tenant.", "operationId": "GetAllMonitoredObjectSummariesV2", "parameters": [ { "name": "start_key", "in": "query", "description": "The name of the Monitored Object from which the result set will begin", "style": "form", "explode": true, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "description": "The maximum number of records to return for a single page", "style": "form", "explode": true, "schema": { "type": "integer", "format": "int32" } } ], "responses": { "200": { "description": "Fetch completed successfully", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/MonitoredObjectSummaryListResponse" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "No Monitored objects are provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v2/monitored-object-summaries/{monObjId}": { "get": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "GetMonitoredObjectSummaryV2", "description": "Retrieve a Tenant Monitored Object Summary by the Monitored Object's id.", "operationId": "GetMonitoredObjectSummaryV2", "parameters": [ { "name": "monObjId", "in": "path", "description": "", "required": true, "style": "simple", "schema": { "type": "string" } } ], "responses": { "200": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/MonitoredObjectSummaryResponse" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "The requested Monitored Object is not provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v2/metadata-category-mappings": { "get": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "GetAllMetadataCategoryMappingsV2", "description": "Retrieve all Monitored Object Metadata Mappings for a Tenant.", "operationId": "GetAllMetadataCategoryMappingsV2", "parameters": [], "responses": { "200": { "description": "Fetch completed successfully", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/MonitoredObjectMetadataCategoryMappingListResponse" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "No Monitored Object Metadata Mappings are provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v2/metadata-category-mappings/{mappingType}": { "get": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "GetMetadataCategoryMappingV2", "description": "Retrieve a particular Tenant Monitored Object Metadata Mapping by the type of mapping.", "operationId": "GetMetadataCategoryMappingV2", "parameters": [ { "name": "mappingType", "in": "path", "description": "The type of Metadata Category Mapping", "required": true, "style": "simple", "schema": { "$ref": "#/components/schemas/mappingType2" } } ], "responses": { "200": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/MonitoredObjectMetadataCategoryMappingResponse" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "The requested Monitored Object is not provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "patch": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "UpdateMetadataCategoryMappingV2", "description": "Update a particular Tenant Monitored Object Metadata Mapping by the type of mapping.", "operationId": "UpdateMetadataCategoryMappingV2", "parameters": [ { "name": "mappingType", "in": "path", "description": "The type of Metadata Category Mapping to be updated", "required": true, "style": "simple", "schema": { "$ref": "#/components/schemas/mappingType2" } } ], "requestBody": { "description": "", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MetadataCategoryMappingUpdateRequest" } } }, "required": true }, "responses": { "200": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/MonitoredObjectMetadataCategoryMappingResponse" } } } }, "400": { "description": "Request data does not pass validation", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "The requested Monitored Object is not provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v2/session-filter-profiles": { "post": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "CreateSessionFilterProfileV2", "description": "Create a SessionFilterProfile for a Tenant.", "operationId": "CreateSessionFilterProfileV2", "parameters": [], "requestBody": { "description": "", "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/SessionFilterProfileCreateRequest" } } }, "required": true }, "responses": { "201": { "description": "Successfully Created", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/SessionFilterProfileResponse" } } } }, "400": { "description": "Request data does not pass validation", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "409": { "description": "A SessionFilterProfile with this name already exists", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "get": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "GetAllSessionFilterProfilesV2", "description": "Retrieve all SessionFilterProfiles for the specified Tenant.", "operationId": "GetAllSessionFilterProfilesV2", "parameters": [], "responses": { "200": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/SessionFilterProfileListResponse" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "No SessionFilterProfiles are provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v2/session-filter-profiles/{sessionFilterProfileId}": { "get": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "GetSessionFilterProfileV2", "description": "Retrieve a Tenant Dashboard by Id.", "operationId": "GetSessionFilterProfileV2", "parameters": [ { "name": "sessionFilterProfileId", "in": "path", "description": "", "required": true, "style": "simple", "schema": { "type": "string" } } ], "responses": { "200": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/SessionFilterProfileResponse" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "The specified Dashboard is not provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "put": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "UpdateSessionFilterProfileV2", "description": "Update a Tenant SessionFilterProfile specified by the provided SessionFilterProfile Id.", "operationId": "UpdateSessionFilterProfileV2", "parameters": [ { "name": "sessionFilterProfileId", "in": "path", "description": "", "required": true, "style": "simple", "schema": { "type": "string" } } ], "requestBody": { "description": "", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SessionFilterProfileUpdateRequest" } } }, "required": true }, "responses": { "200": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/SessionFilterProfileResponse" } } } }, "400": { "description": "Request data does not pass validation", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "The specified SessionFilterProfile is not provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "409": { "description": "A SessionFilterProfile with the given name already exists", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "patch": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "PatchSessionFilterProfileV2", "description": "Patch a Tenant SessionFilterProfile specified by the provided SessionFilterProfile Id, with partial modifications.", "operationId": "PatchSessionFilterProfileV2", "parameters": [ { "name": "sessionFilterProfileId", "in": "path", "description": "", "required": true, "style": "simple", "schema": { "type": "string" } } ], "requestBody": { "description": "", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PatchSessionFilterProfileRequest" } } }, "required": true }, "responses": { "200": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/SessionFilterProfileResponse" } } } }, "400": { "description": "Request data does not pass validation", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "The specified SessionFilterProfile is not provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "409": { "description": "A SessionFilterProfile with the given name already exists", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "delete": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "DeleteSessionFilterProfileV2", "description": "Delete a Tenant SessionFilterProfile specified by the provided SessionFilterProfile Id.", "operationId": "DeleteSessionFilterProfileV2", "parameters": [ { "name": "sessionFilterProfileId", "in": "path", "description": "", "required": true, "style": "simple", "schema": { "type": "string" } } ], "responses": { "200": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/SessionFilterProfileResponse" } } } }, "400": { "description": "Request data does not pass validation", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "The specified SessionFilterProfile is not provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v2/session-filters": { "post": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "CreateSessionFilterV2", "description": "Create a SessionFilter for a Tenant.", "operationId": "CreateSessionFilterV2", "parameters": [], "requestBody": { "description": "", "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/SessionFilterCreateRequest" } } }, "required": true }, "responses": { "201": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/SessionFilterResponse" } } } }, "400": { "description": "Request data does not pass validation", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "409": { "description": "The SessionFilter being provisioned already exists", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "get": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "GetAllSessionFiltersV2", "description": "Retrieve all SessionFilters for the specified Tenant.", "operationId": "GetAllSessionFiltersV2", "parameters": [], "responses": { "200": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/SessionFilterListResponse" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "No SessionFilters are provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v2/session-filters/{sessionFilterId}": { "get": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "GetSessionFilterV2", "description": "Retrieve a Tenant SessionFilter by Id.", "operationId": "GetSessionFilterV2", "parameters": [ { "name": "sessionFilterId", "in": "path", "description": "", "required": true, "style": "simple", "schema": { "type": "string" } } ], "responses": { "200": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/SessionFilterResponse" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "The specified SessionFilters is not provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "put": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "UpdateSessionFilterV2", "description": "Update a Tenant SessionFilter specified by the provided SessionFilter Id.", "operationId": "UpdateSessionFilterV2", "parameters": [ { "name": "sessionFilterId", "in": "path", "description": "", "required": true, "style": "simple", "schema": { "type": "string" } } ], "requestBody": { "description": "", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SessionFilterUpdateRequest" } } }, "required": true }, "responses": { "200": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/SessionFilterResponse" } } } }, "400": { "description": "Request data does not pass validation", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "The specified SessionFilter is not provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "409": { "description": "A SessionFilter with the given name already exists", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "patch": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "PatchSessionFilterV2", "description": "Patch a Tenant SessionFilter specified by the provided SessionFilter Id, with partial modifications.", "operationId": "PatchSessionFilterV2", "parameters": [ { "name": "sessionFilterId", "in": "path", "description": "", "required": true, "style": "simple", "schema": { "type": "string" } } ], "requestBody": { "description": "", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PatchSessionFilterRequest" } } }, "required": true }, "responses": { "200": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/SessionFilterResponse" } } } }, "400": { "description": "Request data does not pass validation", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "The specified SessionFilter is not provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "409": { "description": "A SessionFilter with the given name already exists", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "delete": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "DeleteSessionFilterV2", "description": "Delete a Tenant SessionFilter specified by the provided SessionFilter Id.", "operationId": "DeleteSessionFilterV2", "parameters": [ { "name": "sessionFilterId", "in": "path", "description": "", "required": true, "style": "simple", "schema": { "type": "string" } } ], "responses": { "200": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/SessionFilterResponse" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "The specified SessionFilter is not provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v2/threshold-profiles": { "post": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "CreateThresholdProfileV2", "description": "Create a Threshold Profile for a Tenant.", "operationId": "CreateThresholdProfileV2", "parameters": [], "requestBody": { "description": "", "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/ThresholdProfileCreateRequest" } } }, "required": true }, "responses": { "201": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/ThresholdProfileResponse" } } } }, "400": { "description": "Request data does not pass validation", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "409": { "description": "The record is already provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "get": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "GetAllThresholdProfilesV2", "description": "Retrieve all Threshold Profiles for the specified Tenant.", "operationId": "GetAllThresholdProfilesV2", "parameters": [], "responses": { "200": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/ThresholdProfileListResponse" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "There are no Threshold Profiles provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v2/threshold-profiles/{thrPrfId}": { "get": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "GetThresholdProfileV2", "description": "Retrieve a Tenant Threshold Profile by id.", "operationId": "GetThresholdProfileV2", "parameters": [ { "name": "thrPrfId", "in": "path", "description": "", "required": true, "style": "simple", "schema": { "type": "string" } } ], "responses": { "200": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/ThresholdProfileResponse" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "The requested Threshold Profile is not provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "patch": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "UpdateThresholdProfileV2", "description": "Update a Tenant Threshold Profile", "operationId": "UpdateThresholdProfileV2", "parameters": [ { "name": "thrPrfId", "in": "path", "description": "", "required": true, "style": "simple", "schema": { "type": "string" } } ], "requestBody": { "description": "", "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/ThresholdProfileUpdateRequest" } } }, "required": true }, "responses": { "200": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/ThresholdProfileResponse" } } } }, "400": { "description": "Request data does not pass validation", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "The requested Threshold Profile is not provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "409": { "description": "Incorrect revision provided in Threshold Profile update request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "delete": { "tags": [ "TenantProvisioningServiceV2" ], "summary": "DeleteThresholdProfileV2", "description": "Delete a Tenant Threshold Profile specified by the provided id.", "operationId": "DeleteThresholdProfileV2", "parameters": [ { "name": "thrPrfId", "in": "path", "description": "", "required": true, "style": "simple", "schema": { "type": "string" } } ], "responses": { "200": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/ThresholdProfileResponse" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "The requested Threshold Profile is not provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v2/cyber/network-assets": { "post": { "tags": [ "TenantCyberSecurityNetworkAssetServiceV2" ], "summary": "CreateNetworkAssetV2", "description": "Create a Network Asset", "operationId": "CreateNetworkAssetV2", "parameters": [], "requestBody": { "description": "", "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/NetworkAssetResponse" } } }, "required": true }, "responses": { "201": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/NetworkAssetResponse" } } } }, "400": { "description": "Request data does not pass validation", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "409": { "description": "A Network Asset with this ip is already provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "get": { "tags": [ "TenantCyberSecurityNetworkAssetServiceV2" ], "summary": "GetAllNetworkAssetsV2", "description": "Retrieve all NetworkAssets for a Tenant.", "operationId": "GetAllNetworkAssetsV2", "parameters": [], "responses": { "200": { "description": "Fetch completed successfully", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/NetworkAssetListResponse" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "No Network Assets are provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v2/cyber/network-assets/{networkAssetId}": { "get": { "tags": [ "TenantCyberSecurityNetworkAssetServiceV2" ], "summary": "GetNetworkAssetV2", "description": "Retrieve a Network Asset by its ID", "operationId": "GetNetworkAssetV2", "parameters": [ { "name": "networkAssetId", "in": "path", "description": "The network asset id", "required": true, "style": "simple", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Retrieved Network Asset successfully", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NetworkAssetResponse" } }, "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/NetworkAssetResponse" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/json": { "schema": { "type": "string" } }, "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/json": { "schema": { "type": "string" } }, "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "patch": { "tags": [ "TenantCyberSecurityNetworkAssetServiceV2" ], "summary": "UpdateNetworkAssetV2", "description": "Update a Tenant Network Asset", "operationId": "UpdateNetworkAssetV2", "parameters": [ { "name": "networkAssetId", "in": "path", "description": "The network asset id", "required": true, "style": "simple", "schema": { "type": "string" } } ], "requestBody": { "description": "", "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/NetworkAssetUpdateRequest" } } }, "required": true }, "responses": { "200": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/NetworkAssetResponse" } } } }, "400": { "description": "Request data does not pass validation", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "The requested Network Asset is not provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "409": { "description": "Incorrect revision provided for the update request to the Network Asset", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "delete": { "tags": [ "TenantCyberSecurityNetworkAssetServiceV2" ], "summary": "DeleteNetworkAssetV2", "description": "Delete a Tenant Network Asset specified by the provided id.", "operationId": "DeleteNetworkAssetV2", "parameters": [ { "name": "networkAssetId", "in": "path", "description": "The network asset id", "required": true, "style": "simple", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Deleted network asset successfully", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "The requested Network Asset is not provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v2/cyber/network-assets/count": { "post": { "tags": [ "TenantCyberSecurityNetworkAssetServiceV2" ], "summary": "GetFilteredNetworkAssetCountV2", "description": "Retrieve a count of monitored objects based on the provided filter criteria", "operationId": "GetFilteredNetworkAssetCountV2", "parameters": [], "requestBody": { "description": "", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NetworkAssetFilteredListRequest" } } }, "required": true }, "responses": { "200": { "description": "Response list containing counts by provided grouping that match the provided meta filter criteria", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/NetworkAssetFilteredCountResponse" } } } }, "400": { "description": "Request data does not pass validation", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v2/cyber/network-assets/list": { "post": { "tags": [ "TenantCyberSecurityNetworkAssetServiceV2" ], "summary": "GetFilteredNetworkAssetListV2", "description": "Retrieve a list of monitored objects based on the provided filter criteria", "operationId": "GetFilteredNetworkAssetListV2", "parameters": [], "requestBody": { "description": "", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NetworkAssetFilteredListRequest" } } }, "required": true }, "responses": { "200": { "description": "Response list containing Network Assets grouping that match the provided meta filter criteria", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/NetworkAssetListResponse" } } } }, "400": { "description": "Request data does not pass validation", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v2/cyber/network-assets/groupBy": { "post": { "tags": [ "TenantCyberSecurityNetworkAssetServiceV2" ], "summary": "GetNetworkAssetGroupByV2", "description": "Retrieves specified aggregation grouped by the provided fields and filtered by the metadata specification", "operationId": "GetNetworkAssetGroupByV2", "parameters": [], "requestBody": { "description": "", "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/NetworkAssetGroupByRequest" } } }, "required": true }, "responses": { "200": { "description": "Group by successfully processed", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/NetworkAssetGroupByResponse" } } } }, "400": { "description": "Request data does not pass validation", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "Missing provisioned data", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v2/manager/monitoredObjectCache/build": { "post": { "tags": [ "ManagerV2" ], "summary": "Bootstraps the monitored object cache for all tenants", "description": "Bootstraps the monitored object cache for all tenants", "operationId": "Bootstrapsthemonitoredobjectcacheforalltenants", "parameters": [ { "name": "Content-Type", "in": "header", "description": "", "required": true, "style": "simple", "schema": { "enum": [ "application/vnd.api+json" ], "type": "string", "example": "application/vnd.api+json" } } ], "responses": { "202": { "description": "Cache build in progress", "headers": {}, "content": {} }, "204": { "description": "Started cache build", "headers": {}, "content": {} }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } }, "application/json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } }, "application/json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v2/manager/baseline/bulkUpdate": { "post": { "tags": [ "ManagerV2" ], "summary": "Invokes baseline bulk update", "description": "Invokes baseline bulk update", "operationId": "Invokesbaselinebulkupdate", "parameters": [ { "name": "Content-Type", "in": "header", "description": "", "required": true, "style": "simple", "schema": { "enum": [ "application/vnd.api+json" ], "type": "string", "example": "application/vnd.api+json" } } ], "responses": { "204": { "description": "Invocation successful", "headers": {}, "content": {} }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } }, "application/json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } }, "application/json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v2/manager/analytics/purgeRecords": { "post": { "tags": [ "ManagerV2" ], "summary": "Purges analytics reports", "description": "Purges analytics reports", "operationId": "Purgesanalyticsreports", "parameters": [ { "name": "Content-Type", "in": "header", "description": "", "required": true, "style": "simple", "schema": { "enum": [ "application/vnd.api+json" ], "type": "string", "example": "application/vnd.api+json" } } ], "responses": { "204": { "description": "Invocation successful", "headers": {}, "content": {} }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } }, "application/json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } }, "application/json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v2/manager/networkAssetCache/build": { "post": { "tags": [ "ManagerV2" ], "summary": "Bootstraps the network asset cache for all tenants", "description": "Bootstraps the network asset cache for all tenants", "operationId": "Bootstrapsthenetworkassetcacheforalltenants", "parameters": [ { "name": "Content-Type", "in": "header", "description": "", "required": true, "style": "simple", "schema": { "enum": [ "application/vnd.api+json" ], "type": "string", "example": "application/vnd.api+json" } } ], "responses": { "202": { "description": "Cache build in progress", "headers": {}, "content": {} }, "204": { "description": "Started cache build", "headers": {}, "content": {} }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } }, "application/json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } }, "application/json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v3/ingestion-dictionaries": { "post": { "tags": [ "TenantProvisioningServiceV3" ], "summary": "CreateIngestionDictionaryV3", "description": "Create an Ingestion Dictionary for a Tenant.", "operationId": "CreateIngestionDictionaryV3", "parameters": [], "requestBody": { "description": "", "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/IngestionDictionaryV3CreateRequest" } } }, "required": true }, "responses": { "201": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/IngestionDictionaryV3Response" } } } }, "400": { "description": "Request data does not pass validation", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "409": { "description": "The ingestion Dictionary already exists", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "get": { "tags": [ "TenantProvisioningServiceV3" ], "summary": "GetAllIngestionDictionariesV3", "description": "Get all Tenant Ingestion Dictionaries", "operationId": "GetAllIngestionDictionariesV3", "parameters": [ { "name": "Content-Type", "in": "header", "description": "", "required": true, "style": "simple", "schema": { "enum": [ "application/vnd.api+json" ], "type": "string", "example": "application/vnd.api+json" } } ], "responses": { "200": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/IngestionDictionaryV3ListResponse" } } } }, "400": { "description": "Request data does not pass validation", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "No Ingestion Dictionary is provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v3/ingestion-dictionaries/{IngestionDictionaryId}": { "get": { "tags": [ "TenantProvisioningServiceV3" ], "summary": "GetIngestionDictionaryV3", "description": "Retrieve a Tenant Ingestion Dictionary by id.", "operationId": "GetIngestionDictionaryV3", "parameters": [ { "name": "IngestionDictionaryId", "in": "path", "description": "", "required": true, "style": "simple", "schema": { "type": "string" } } ], "responses": { "200": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/IngestionDictionaryV3Response" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "The specified Ingestion Dictionary is not provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "patch": { "tags": [ "TenantProvisioningServiceV3" ], "summary": "UpdateIngestionDictionaryV3", "description": "Update a Tenant Ingestion Dictionary", "operationId": "UpdateIngestionDictionaryV3", "parameters": [ { "name": "IngestionDictionaryId", "in": "path", "description": "", "required": true, "style": "simple", "schema": { "type": "string" } } ], "requestBody": { "description": "", "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/IngestionDictionaryV3UpdateRequest" } } }, "required": true }, "responses": { "200": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/IngestionDictionaryV3Response" } } } }, "400": { "description": "Request data does not pass validation", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "The specified Ingestion Dictionary is not provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "409": { "description": "Incorrect revision provided for th update request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "delete": { "tags": [ "TenantProvisioningServiceV3" ], "summary": "DeleteIngestionDictionaryV3", "description": "Delete a Tenant Ingestion Dictionary specified by the provided Ingestion Dictionary Id.", "operationId": "DeleteIngestionDictionaryV3", "parameters": [ { "name": "IngestionDictionaryId", "in": "path", "description": "", "required": true, "style": "simple", "schema": { "type": "string" } } ], "responses": { "200": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/IngestionDictionaryV3Response" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "The specified Ingestion Dictionary is not provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v3/metrics-admin/reconciliation/datasource/{datasource}": { "post": { "tags": [ "MetricsServiceV3" ], "summary": "CreateDatasourceReconciliationTasksV3", "description": "Re-ingests data into the datasource given the input parameters", "operationId": "CreateDatasourceReconciliationTasksV3", "parameters": [ { "name": "datasource", "in": "path", "description": "", "required": true, "style": "simple", "schema": { "type": "string" } }, { "name": "taskCount", "in": "query", "description": "Sets the concurrency level of the ingestion task", "style": "form", "explode": true, "schema": { "type": "integer", "format": "int32" } } ], "requestBody": { "description": "", "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/DatasourceReconciliationTasks" } } }, "required": true }, "responses": { "200": { "description": "Datasource reconciliation tasks create request successfully processed", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/DatasourceReconciliationTasks" } } } }, "400": { "description": "Invalid payload provided", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "Datasource does not exist", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v3/metrics-admin/reindex/datasource/{datasource}": { "post": { "tags": [ "MetricsServiceV3" ], "summary": "CreateDatasourceReindexTasksV3", "description": "Re-formats data in the datasource to optomize the datasource", "operationId": "CreateDatasourceReindexTasksV3", "parameters": [ { "name": "datasource", "in": "path", "description": "", "required": true, "style": "simple", "schema": { "type": "string" } }, { "name": "taskCount", "in": "query", "description": "Sets the concurrency level of the granularity compaction task", "style": "form", "explode": true, "schema": { "type": "integer", "format": "int32", "default": 1 } }, { "name": "periodOffsetMultiplier", "in": "query", "description": "Used to generate reindexing tasks over a period from current time backwards based on the 'c' provided in the body. For example, 'targetSegmentTimebucket' of 'DAY' with 'periodOffsetMultiplier' of '5' invokes daily reindexing from [NOW-5days, NOW).", "style": "form", "explode": true, "schema": { "type": "integer", "format": "int32", "default": 0 } } ], "requestBody": { "description": "", "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/DatasourceReindexTasks" } } }, "required": true }, "responses": { "200": { "description": "Datasource reindex task request successfully processed", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/DatasourceReindexTasks" } } } }, "400": { "description": "Invalid payload provided", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "Datasource does not exist", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v3/metrics/groupBy": { "post": { "tags": [ "MetricsServiceV3" ], "summary": "GetGroupByV3", "description": "Retrieves specified aggregation grouped by the provided fields and filtered by the metadata specification", "operationId": "GetGroupByV3", "parameters": [], "requestBody": { "description": "", "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/JsonApiGroupByRequest" } } }, "required": true }, "responses": { "200": { "description": "Group by successfully processed", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/JsonApiGroupByResponse" } } } }, "400": { "description": "Request data does not pass validation", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "Missing provisioned data", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v3/metrics/aggregate": { "post": { "tags": [ "MetricsServiceV3" ], "summary": "GetAggregateV3", "description": "Aggregates the provided metrics and filters them based on the provided criteria", "operationId": "GetAggregateV3", "parameters": [], "requestBody": { "description": "", "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/JsonApiAggregateV3Request" } } }, "required": true }, "responses": { "200": { "description": "Aggregate query successfully processed", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/JsonApiAggregateV3Response" } } } }, "400": { "description": "Request data does not pass validation", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "Missing provisioned data", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v3/tcpThroughput/tests": { "post": { "tags": [ "TcpThroughputTestReportServiceV3" ], "summary": "CreateTcpThroughputTestReportV3", "description": "Create a TCP Throughput test report", "operationId": "CreateTcpThroughputTestReportV3", "parameters": [], "requestBody": { "description": "", "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/TcpThroughputResponse" } } }, "required": true }, "responses": { "201": { "description": "TCP Throughput test report successfully created", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/TcpThroughputResponse" } } } }, "400": { "description": "Request data does not pass validation", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "409": { "description": "A TCP Throughput test report with this test id and run timestamp is already provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "get": { "tags": [ "TcpThroughputTestReportServiceV3" ], "summary": "GetAllTcpThroughputTestReportsV3", "description": "Retrieve all TCP Throughput test run reports for a tenant.", "operationId": "GetAllTcpThroughputTestReportsV3", "parameters": [ { "name": "shallow", "in": "query", "description": "If set, retrieve only summary kpi's for the test records", "style": "form", "explode": true, "schema": { "type": "boolean" } }, { "name": "token", "in": "query", "description": "For paginated results, the token to receive the next batch of results", "style": "form", "explode": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Fetch completed successfully", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/TcpThroughputListResponse" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "No Network Assets are provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v3/tcpThroughput/tests/{testId}/reports": { "get": { "tags": [ "TcpThroughputTestReportServiceV3" ], "summary": "GetAllTcpThroughputReportsForTestV3", "description": "Retrieve all TCP Throughput test reports for a test instance.", "operationId": "GetAllTcpThroughputReportsForTestV3", "parameters": [ { "name": "testId", "in": "path", "description": "The test identifier", "required": true, "style": "simple", "schema": { "type": "string" } }, { "name": "shallow", "in": "query", "description": "If set, retrieve only summary kpi's for the test records", "style": "form", "explode": true, "schema": { "type": "boolean" } }, { "name": "token", "in": "query", "description": "For paginated results, the token to receive the next batch of results", "style": "form", "explode": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Retrieved TCP Throughput Tests successfully", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TcpThroughputListResponse" } }, "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/TcpThroughputListResponse" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/json": { "schema": { "type": "string" } }, "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/json": { "schema": { "type": "string" } }, "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v3/tcpThroughput/tests/{testId}/reports/{runId}": { "get": { "tags": [ "TcpThroughputTestReportServiceV3" ], "summary": "GetTcpThroughputTestReportV3", "description": "Retrieve a TCP Throughput test report by test id and run id", "operationId": "GetTcpThroughputTestReportV3", "parameters": [ { "name": "testId", "in": "path", "description": "The test identifier", "required": true, "style": "simple", "schema": { "type": "string" } }, { "name": "runId", "in": "path", "description": "The id associated with a particular test run", "required": true, "style": "simple", "schema": { "type": "string" } }, { "name": "shallow", "in": "query", "description": "If set, retrieve only summary kpi's for the test record", "style": "form", "explode": true, "schema": { "type": "boolean" } } ], "responses": { "200": { "description": "Retrieved TCP Throughput test report successfully", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TcpThroughputListResponse" } }, "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/TcpThroughputListResponse" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/json": { "schema": { "type": "string" } }, "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/json": { "schema": { "type": "string" } }, "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "patch": { "tags": [ "TcpThroughputTestReportServiceV3" ], "summary": "UpdateTcpThroughputTestReportV3", "description": "Update a TCP Throughput test report", "operationId": "UpdateTcpThroughputTestReportV3", "parameters": [ { "name": "testId", "in": "path", "description": "The test identifier", "required": true, "style": "simple", "schema": { "type": "string" } }, { "name": "runId", "in": "path", "description": "The is associated with a particular test run", "required": true, "style": "simple", "schema": { "type": "string" } } ], "requestBody": { "description": "", "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/TcpThroughputUpdateRequest" } } }, "required": true }, "responses": { "200": { "description": "", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/TcpThroughputResponse" } } } }, "400": { "description": "Request data does not pass validation", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "The requested TCP Throughput report is not provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "409": { "description": "Incorrect revision provided for the update request to the TCP Throughput report", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false }, "delete": { "tags": [ "TcpThroughputTestReportServiceV3" ], "summary": "DeleteTcpThroughputTestReportV3", "description": "Delete a TCP Throughput Test report specified by the provided test id and run id.", "operationId": "DeleteTcpThroughputTestReportV3", "parameters": [ { "name": "testId", "in": "path", "description": "The test identfifier", "required": true, "style": "simple", "schema": { "type": "string" } }, { "name": "runId", "in": "path", "description": "The id associated with a particular test run", "required": true, "style": "simple", "schema": { "type": "string" } } ], "responses": { "200": { "description": "", "headers": {}, "content": {} }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "404": { "description": "The requested TCP Throughput test report is not provisioned", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v3/tcpThroughput/tests/count": { "post": { "tags": [ "TcpThroughputTestReportServiceV3" ], "summary": "GetFilteredTcpThroughputCountV3", "description": "Retrieve a count of TCP Throughput test reports based on the provided filter criteria", "operationId": "GetFilteredTcpThroughputCountV3", "parameters": [], "requestBody": { "description": "", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TcpThroughputFilteredListRequest" } } }, "required": true }, "responses": { "200": { "description": "Response list containing counts by provided grouping that match the provided meta filter criteria", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/TcpThroughputFilteredCountResponse" } } } }, "400": { "description": "Request data does not pass validation", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } }, "/v3/tcpThroughput/tests/list": { "post": { "tags": [ "TcpThroughputTestReportServiceV3" ], "summary": "GetFilteredTcpThroughputListV3", "description": "Retrieve a list of TCP Throughput test reports based on the provided filter criteria", "operationId": "GetFilteredTcpThroughputListV3", "parameters": [ { "name": "shallow", "in": "query", "description": "If set, retrieve only summary kpi's for the test record", "style": "form", "explode": true, "schema": { "type": "boolean" } }, { "name": "token", "in": "query", "description": "", "style": "form", "explode": true, "schema": { "type": "string" } } ], "requestBody": { "description": "", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TcpThroughputFilteredListRequest" } } }, "required": false }, "responses": { "200": { "description": "Response list containing TCP Throughput test results grouping that match the provided meta filter criteria", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/TcpThroughputListResponse" } } } }, "400": { "description": "Request data does not pass validation", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "403": { "description": "Requestor does not have authorization to perform this action", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } }, "500": { "description": "Unexpected error processing request", "headers": {}, "content": { "application/vnd.api+json": { "schema": { "type": "string" } } } } }, "deprecated": false } } }, "components": { "schemas": { "ValidationResponse": { "title": "ValidationResponse", "type": "object", "properties": { "serviceResponse": { "$ref": "#/components/schemas/ServiceResponse" } } }, "ServiceResponse": { "title": "ServiceResponse", "type": "object", "properties": { "authenticationSuccess": { "$ref": "#/components/schemas/ServiceResponseAuthenticationSuccess" }, "authenticationFailure": { "$ref": "#/components/schemas/ServiceResponseAuthenticationFailure" } } }, "ServiceResponseAuthenticationSuccess": { "title": "ServiceResponseAuthenticationSuccess", "type": "object", "properties": { "user": { "type": "string" }, "attributes": { "$ref": "#/components/schemas/ServiceResponseAuthenticationSuccessAttributes" } } }, "ServiceResponseAuthenticationSuccessAttributes": { "title": "ServiceResponseAuthenticationSuccessAttributes", "type": "object", "properties": { "backend": { "type": "array", "items": { "type": "string" }, "description": "" }, "pvxSession": { "type": "array", "items": { "type": "string" }, "description": "" }, "credentialType": { "type": "array", "items": { "type": "string" }, "description": "" }, "isFromNewLogin": { "type": "array", "items": { "type": "boolean" }, "description": "" }, "authenticationDate": { "type": "array", "items": { "type": "number" }, "description": "" }, "authenticationMethod": { "type": "array", "items": { "type": "string" }, "description": "" }, "roles": { "type": "array", "items": { "type": "string" }, "description": "" }, "groups": { "type": "array", "items": { "type": "string" }, "description": "" }, "isPasswordSet": { "type": "array", "items": { "type": "string" }, "description": "" }, "isRegisteredForEmail": { "type": "array", "items": { "type": "string" }, "description": "" }, "name": { "type": "array", "items": { "type": "string" }, "description": "" }, "tenants": { "type": "array", "items": { "type": "string" }, "description": "" }, "id": { "type": "array", "items": { "type": "string" }, "description": "" }, "onboardingToken": { "type": "array", "items": { "type": "string" }, "description": "" }, "successfulAuthenticationHandlers": { "type": "array", "items": { "type": "string" }, "description": "" }, "longTermAuthenticationRequestTokenUsed": { "type": "array", "items": { "type": "boolean" }, "description": "" }, "access_token": { "type": "array", "items": { "$ref": "#/components/schemas/AccessToken" }, "description": "" } } }, "AccessToken": { "title": "AccessToken", "type": "object", "properties": { "lifetime": { "type": "integer", "format": "int32" }, "parameterName": { "type": "array", "items": { "type": "string" }, "description": "" }, "value": { "type": "string" }, "type": { "$ref": "#/components/schemas/Type" } } }, "ServiceResponseAuthenticationFailure": { "title": "ServiceResponseAuthenticationFailure", "type": "object", "properties": { "code": { "type": "string" }, "description": { "type": "string" } } }, "JsonApiAAAUser": { "title": "JsonApiAAAUser", "type": "object", "properties": { "data": { "$ref": "#/components/schemas/AAAUser" } } }, "JsonApiAAAUserList": { "title": "JsonApiAAAUserList", "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/AAAUser" }, "description": "" } } }, "JsonApiJWT": { "title": "JsonApiJWT", "type": "object", "properties": { "data": { "$ref": "#/components/schemas/JWTClaims" } } }, "JsonApiJWTList": { "title": "JsonApiJWTList", "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/JWTClaims" }, "description": "" } } }, "JWTClaims": { "title": "JWTClaims", "type": "object", "properties": { "type": { "$ref": "#/components/schemas/Type5" }, "attributes": { "$ref": "#/components/schemas/Attributes" }, "id": { "type": "string" } } }, "JsonApiUsergroup": { "title": "JsonApiUsergroup", "type": "object", "properties": { "data": { "$ref": "#/components/schemas/Usergroup" } } }, "JsonApiUsergroupUpdate": { "title": "JsonApiUsergroupUpdate", "type": "object", "properties": { "data": { "$ref": "#/components/schemas/UsergroupUpdate" } } }, "JsonApiUsergroupList": { "title": "JsonApiUsergroupList", "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/Usergroup" }, "description": "" } } }, "AuthMethod": { "title": "AuthMethod", "type": "object", "properties": { "method": { "$ref": "#/components/schemas/Method" }, "providerLinks": { "type": "array", "items": { "$ref": "#/components/schemas/authProvider" }, "description": "" } } }, "Usergroup": { "title": "Usergroup", "required": [ "attributes" ], "type": "object", "properties": { "type": { "$ref": "#/components/schemas/Type6" }, "attributes": { "$ref": "#/components/schemas/Attributes1" }, "id": { "type": "string" }, "relationships": { "$ref": "#/components/schemas/UsergroupRelationships" } } }, "UsergroupUpdate": { "title": "UsergroupUpdate", "required": [ "attributes" ], "type": "object", "properties": { "type": { "$ref": "#/components/schemas/Type6" }, "attributes": { "$ref": "#/components/schemas/Attributes2" }, "id": { "type": "string" }, "relationships": { "$ref": "#/components/schemas/UsergroupRelationships" } } }, "UsergroupRelationships": { "title": "UsergroupRelationships", "type": "object", "properties": { "users": { "$ref": "#/components/schemas/Users" }, "roles": { "$ref": "#/components/schemas/Roles" } } }, "JsonApiRole": { "title": "JsonApiRole", "type": "object", "properties": { "data": { "$ref": "#/components/schemas/Role" } } }, "JsonApiRoleUpdate": { "title": "JsonApiRoleUpdate", "type": "object", "properties": { "data": { "$ref": "#/components/schemas/RoleUpdate" } } }, "JsonApiRoleList": { "title": "JsonApiRoleList", "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/Role" }, "description": "" } } }, "Role": { "title": "Role", "required": [ "attributes" ], "type": "object", "properties": { "type": { "$ref": "#/components/schemas/Type10" }, "attributes": { "$ref": "#/components/schemas/Attributes3" }, "id": { "type": "string" }, "relationships": { "$ref": "#/components/schemas/RoleToPermissionRelationship" } } }, "RoleUpdate": { "title": "RoleUpdate", "required": [ "attributes" ], "type": "object", "properties": { "type": { "$ref": "#/components/schemas/Type10" }, "attributes": { "$ref": "#/components/schemas/Attributes5" }, "id": { "type": "string" }, "relationships": { "$ref": "#/components/schemas/RoleToPermissionRelationship" } } }, "RoleToPermissionRelationship": { "title": "RoleToPermissionRelationship", "type": "object", "properties": { "permissions": { "$ref": "#/components/schemas/Permissions" } } }, "JsonApiPermission": { "title": "JsonApiPermission", "type": "object", "properties": { "data": { "$ref": "#/components/schemas/Permission" } } }, "JsonApiUpdatePermission": { "title": "JsonApiUpdatePermission", "type": "object", "properties": { "data": { "$ref": "#/components/schemas/PermissionUpdate" } } }, "JsonApiUpdatePermissionResponse": { "title": "JsonApiUpdatePermissionResponse", "type": "object", "properties": { "data": { "$ref": "#/components/schemas/PermissionUpdateResponse" } } }, "JsonApiPermissionList": { "title": "JsonApiPermissionList", "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/Permission" }, "description": "" } } }, "Permission": { "title": "Permission", "required": [ "attributes" ], "type": "object", "properties": { "type": { "$ref": "#/components/schemas/Type13" }, "attributes": { "$ref": "#/components/schemas/Attributes6" }, "id": { "type": "string" } } }, "PermissionUpdate": { "title": "PermissionUpdate", "required": [ "attributes" ], "type": "object", "properties": { "type": { "$ref": "#/components/schemas/Type13" }, "attributes": { "$ref": "#/components/schemas/Attributes7" }, "id": { "type": "string" } } }, "PermissionUpdateResponse": { "title": "PermissionUpdateResponse", "required": [ "attributes" ], "type": "object", "properties": { "type": { "$ref": "#/components/schemas/Type13" }, "attributes": { "$ref": "#/components/schemas/Attributes8" }, "id": { "type": "string" } } }, "JsonApiRelationship": { "title": "JsonApiRelationship", "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/JsonApiRelationshipData" }, "description": "" } } }, "JsonApiSingleRelationship": { "title": "JsonApiSingleRelationship", "type": "object", "properties": { "data": { "$ref": "#/components/schemas/JsonApiRelationshipData" } } }, "JsonApiRelationshipData": { "title": "JsonApiRelationshipData", "type": "object", "properties": { "type": { "type": "string" }, "id": { "type": "string" } } }, "AAAUser": { "title": "AAAUser", "required": [ "attributes" ], "type": "object", "properties": { "type": { "$ref": "#/components/schemas/Type1" }, "id": { "type": "string" }, "attributes": { "$ref": "#/components/schemas/AAAUserAttr" }, "relationships": { "$ref": "#/components/schemas/Relationships" } } }, "AAAUserAttr": { "title": "AAAUserAttr", "type": "object", "properties": { "tenants": { "type": "array", "items": { "maxLength": 256, "type": "string" }, "description": "" }, "emailAddress": { "maxLength": 256, "type": "string" }, "password": { "maxLength": 64, "minLength": 8, "type": "string" }, "name": { "maxLength": 64, "type": "string" }, "roles": { "type": "array", "items": { "$ref": "#/components/schemas/Role2" }, "description": "" }, "groups": { "type": "array", "items": { "maxLength": 256, "type": "string" }, "description": "" }, "isPasswordSet": { "type": "boolean", "default": false }, "isRegisteredForEmail": { "type": "boolean", "default": false }, "onboardingToken": { "maxLength": 256, "type": "string" } } }, "EmailChangeRequest": { "title": "EmailChangeRequest", "required": [ "oldEmailAddress", "newEmailAddress" ], "type": "object", "properties": { "oldEmailAddress": { "maxLength": 256, "type": "string" }, "newEmailAddress": { "maxLength": 256, "type": "string" } } }, "SetPasswordRequest": { "title": "SetPasswordRequest", "required": [ "password", "onboardingToken" ], "type": "object", "properties": { "password": { "maxLength": 64, "minLength": 8, "type": "string" }, "onboardingToken": { "maxLength": 256, "type": "string" } } }, "PasswordChangeRequest": { "title": "PasswordChangeRequest", "required": [ "oldPassword", "newPassword" ], "type": "object", "properties": { "oldPassword": { "maxLength": 64, "minLength": 8, "type": "string" }, "newPassword": { "maxLength": 64, "minLength": 8, "type": "string" } } }, "JsonApiTenantInfo": { "title": "JsonApiTenantInfo", "type": "object", "properties": { "data": { "$ref": "#/components/schemas/TenantInfo" } } }, "TenantInfo": { "title": "TenantInfo", "type": "object", "properties": { "type": { "$ref": "#/components/schemas/Type16" }, "id": { "type": "string", "description": "The subdomain of the tenant" }, "attributes": { "$ref": "#/components/schemas/TenantInfoAttr" } } }, "TenantInfoAttr": { "title": "TenantInfoAttr", "type": "object", "properties": { "tenantName": { "maxLength": 256, "type": "string" }, "tenantId": { "maxLength": 256, "type": "string" }, "allowPasswordAuth": { "type": "boolean", "default": false }, "providerLinks": { "type": "array", "items": { "$ref": "#/components/schemas/authProvider" }, "description": "" } } }, "authProvider": { "title": "authProvider", "type": "object", "properties": { "label": { "type": "string" }, "name": { "type": "string" }, "url": { "type": "string" }, "default": { "type": "boolean" } } }, "OIDConfig": { "title": "OIDConfig", "type": "object", "properties": { "issuer": { "type": "string" }, "authorization_endpoint": { "type": "string" }, "token_endpoint": { "type": "string" }, "token_introspection_endpoint": { "type": "string" }, "userinfo_endpoint": { "type": "string" }, "end_session_endpoint": { "type": "string" }, "jwks_uri": { "type": "string" }, "check_session_iframe": { "type": "string" }, "grant_types_supported": { "type": "array", "items": { "type": "string" }, "description": "" }, "response_types_supported": { "type": "array", "items": { "type": "string" }, "description": "" }, "subject_types_supported": { "type": "array", "items": { "type": "string" }, "description": "" }, "id_token_signing_alg_values_supported": { "type": "array", "items": { "type": "string" }, "description": "" }, "userinfo_signing_alg_values_supported": { "type": "array", "items": { "type": "string" }, "description": "" }, "request_object_signing_alg_values_supported": { "type": "array", "items": { "type": "string" }, "description": "" }, "response_modes_supported": { "type": "array", "items": { "type": "string" }, "description": "" }, "registration_endpoint": { "type": "string" }, "token_endpoint_auth_methods_supported": { "type": "array", "items": { "type": "string" }, "description": "" }, "token_endpoint_auth_signing_alg_values_supported": { "type": "array", "items": { "type": "string" }, "description": "" }, "claims_supported": { "type": "array", "items": { "type": "string" }, "description": "" }, "claim_types_supported": { "type": "array", "items": { "type": "string" }, "description": "" }, "claims_parameter_supported": { "type": "boolean" }, "scopes_supported": { "type": "array", "items": { "type": "string" }, "description": "" }, "request_parameter_supported": { "type": "boolean" }, "request_uri_parameter_supported": { "type": "boolean" } } }, "OIDToken": { "title": "OIDToken", "type": "object", "properties": { "access_token": { "type": "string" }, "token_type": { "type": "string" }, "refresh_token": { "type": "string" }, "expires_in": { "type": "integer", "format": "int32" }, "refresh_expires_in": { "type": "integer", "format": "int32" }, "session_state": { "type": "string" }, "id_token": { "type": "string" } } }, "PouchOk": { "title": "PouchOk", "type": "object", "properties": { "ok": { "type": "string" }, "_id": { "type": "string" }, "_rev": { "type": "string" } } }, "PouchError": { "title": "PouchError", "type": "object", "properties": { "error": { "type": "string" }, "reason": { "type": "string" } } }, "PouchGetDatabase": { "title": "PouchGetDatabase", "type": "object", "properties": { "db_name": { "type": "string" }, "update_seq": { "type": "string" }, "sizes": { "$ref": "#/components/schemas/Sizes" }, "purge_seq": { "type": "integer", "format": "int32" }, "other": { "$ref": "#/components/schemas/Other" }, "doc_del_count": { "type": "integer", "format": "int32" }, "doc_count": { "type": "integer", "format": "int32" }, "disk_size": { "type": "integer", "format": "int32" }, "disk_format_version": { "type": "integer", "format": "int32" }, "data_size": { "type": "integer", "format": "int32" }, "compact_running": { "type": "boolean" }, "cluster": { "$ref": "#/components/schemas/Cluster" }, "instance_start_time": { "type": "string" } } }, "PouchGetDocument": { "title": "PouchGetDocument", "type": "object", "properties": { "_id": { "type": "string" }, "_rev": { "type": "string" } } }, "ExportReportsConfigurationModel": { "title": "ExportReportsConfigurationModel", "type": "object", "properties": { "meta": { "$ref": "#/components/schemas/ExportConfigurationMeta" }, "data": { "$ref": "#/components/schemas/Data" } }, "description": "Model for the export configuration" }, "ExportThresholdModel": { "title": "ExportThresholdModel", "required": [ "comparator", "metric", "value", "aggregator" ], "type": "object", "properties": { "comparator": { "$ref": "#/components/schemas/Comparator" }, "metric": { "type": "string", "description": "The metric you want to test the threshold against", "example": "delayP95" }, "value": { "type": "number", "description": "Value for the metric to compare to", "example": 42 }, "aggregator": { "$ref": "#/components/schemas/ExportAggregators" } }, "description": "Model for Export Threshold Crossing columns, which will be a boolean type" }, "ExportMetricSelector": { "title": "ExportMetricSelector", "required": [ "name", "aggregator" ], "type": "object", "properties": { "name": { "type": "string", "example": "delayP95" }, "aggregator": { "$ref": "#/components/schemas/ExportAggregators" } } }, "ExportAggregators": { "title": "ExportAggregators", "enum": [ "min", "max", "avg", "sum" ], "type": "string", "example": "min" }, "ExportReportModel": { "title": "ExportReportModel", "type": "object", "properties": { "meta": { "$ref": "#/components/schemas/ExportConfigurationMeta" }, "data": { "$ref": "#/components/schemas/Data1" } }, "description": "Returns an exported dataset" }, "ExportConfigurationMeta": { "title": "ExportConfigurationMeta", "type": "object", "properties": { "enabled": { "type": "boolean", "default": true }, "createdBy": { "type": "string" }, "everyone": { "$ref": "#/components/schemas/Everyone" }, "viewers": { "type": "array", "items": { "type": "string" }, "description": "" }, "editors": { "type": "array", "items": { "type": "string" }, "description": "" }, "managers": { "type": "array", "items": { "type": "string" }, "description": "" } }, "description": "Resuable block for users to see permission properties for a resource" }, "Error": { "title": "Error", "type": "object", "properties": { "errors": { "type": "array", "items": { "$ref": "#/components/schemas/Error1" }, "description": "" } }, "example": { "errors": [ { "status": "500", "code": "GATHER-34", "title": "Warp engine failure", "details": "Replace dilithium" } ] } }, "TimeExclusionRequestSpec": { "title": "TimeExclusionRequestSpec", "required": [ "data" ], "type": "object", "properties": { "data": { "$ref": "#/components/schemas/Data2" } } }, "TimeExclusionRequest": { "title": "TimeExclusionRequest", "required": [ "name", "exclusionType", "match", "startTime" ], "type": "object", "properties": { "name": { "type": "string" }, "description": { "type": "string" }, "locale": { "type": "string", "description": "Locale label - Should match tome zone define in startTime and endTime, but is not enforced" }, "exclusionType": { "$ref": "#/components/schemas/ExclusionType" }, "match": { "$ref": "#/components/schemas/TimeWindowExclusionMatch" }, "startTime": { "type": "string", "format": "date-time" }, "endTime": { "type": "string", "format": "date-time" }, "duration": { "pattern": "P(\\d+W)?(\\d+D)?(T(\\d+H)?(\\d+M)?(\\d+S)?)?", "type": "string" }, "recurrence": { "type": "array", "items": { "$ref": "#/components/schemas/TimeWindowExclusionRecurrence" }, "description": "" } } }, "TimeExclusionUpdateRequestSpec": { "title": "TimeExclusionUpdateRequestSpec", "required": [ "data" ], "type": "object", "properties": { "data": { "$ref": "#/components/schemas/Data3" } } }, "TimeExclusionUpdateRequest": { "title": "TimeExclusionUpdateRequest", "type": "object", "properties": { "name": { "type": "string" }, "description": { "type": "string" }, "locale": { "type": "string", "description": "Locale label - Should match tome zone define in startTime and endTime, but is not enforced" }, "exclusionType": { "$ref": "#/components/schemas/ExclusionType" }, "match": { "$ref": "#/components/schemas/TimeWindowExclusionMatch" }, "startTime": { "type": "string", "format": "date-time" }, "endTime": { "type": "string", "format": "date-time" }, "duration": { "pattern": "P(\\d+W)?(\\d+D)?(T(\\d+H)?(\\d+M)?(\\d+S)?)?", "type": "string" }, "recurrence": { "type": "array", "items": { "$ref": "#/components/schemas/TimeWindowExclusionRecurrence" }, "description": "" } } }, "TimeExclusionResponseSpec": { "title": "TimeExclusionResponseSpec", "required": [ "data" ], "type": "object", "properties": { "data": { "$ref": "#/components/schemas/Data4" } } }, "TimeExclusionResponseArraySpec": { "title": "TimeExclusionResponseArraySpec", "required": [ "data" ], "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/Data4" }, "description": "" } } }, "TimeExclusionResponse": { "title": "TimeExclusionResponse", "type": "object", "properties": { "name": { "type": "string" }, "description": { "type": "string" }, "locale": { "type": "string", "description": "Locale label - Should match tome zone define in startTime and endTime, but is not enforced" }, "exclusionType": { "$ref": "#/components/schemas/ExclusionType" }, "match": { "$ref": "#/components/schemas/TimeWindowExclusionMatch" }, "startTime": { "type": "string", "format": "date-time" }, "endTime": { "type": "string", "format": "date-time" }, "duration": { "pattern": "P(\\d+W)?(\\d+D)?(T(\\d+H)?(\\d+M)?(\\d+S)?)?", "type": "string" }, "recurrence": { "type": "array", "items": { "$ref": "#/components/schemas/TimeWindowExclusionRecurrence" }, "description": "" } } }, "TimeWindowExclusionMatch": { "title": "TimeWindowExclusionMatch", "type": "object", "properties": { "monitoredObjectIds": { "type": "array", "items": { "type": "string" }, "description": "A list of monitored object IDs. Supports '*' wildcard to match all monitored objects" }, "metaData": { "$ref": "#/components/schemas/MetaData" }, "applicationIds": { "type": "array", "items": { "type": "string" }, "description": "" }, "zones": { "type": "array", "items": { "type": "string" }, "description": "" }, "sensorIds": { "type": "array", "items": { "type": "string" }, "description": "" } } }, "TimeWindowExclusionRecurrence": { "title": "TimeWindowExclusionRecurrence", "required": [ "freq" ], "type": "object", "properties": { "freq": { "$ref": "#/components/schemas/Freq" }, "until": { "type": "string", "description": "The end of this recurrence", "format": "date-time" }, "count": { "type": "integer", "description": "The maximum number of recurrence", "format": "int32" }, "interval": { "type": "integer", "description": "The numeric interval", "format": "int32" }, "bySecond": { "type": "array", "items": { "maximum": 60.0, "minimum": 0.0, "type": "integer", "format": "int32" }, "description": "" }, "byMinute": { "type": "array", "items": { "maximum": 59.0, "minimum": 0.0, "type": "integer", "format": "int32" }, "description": "" }, "byHour": { "type": "array", "items": { "maximum": 23.0, "minimum": 0.0, "type": "integer", "format": "int32" }, "description": "" }, "byDay": { "type": "array", "items": { "pattern": "^(\\+|-)?([1-9]|[0-4][0-9]|5[0-3])?(MO|TU|WE|TH|FR|SA|SU)", "type": "string" }, "description": "" }, "byMonthDay": { "type": "array", "items": { "pattern": "^(\\+|-)?([1-9]|[1-2][0-9]|3[0-1])", "type": "string" }, "description": "" }, "byYearDay": { "type": "array", "items": { "pattern": "^(\\+|-)?([1-9]|[1-2][0-9][0-9]|3[0-5][0-9]|36[0-6])", "type": "string" }, "description": "" }, "byWeekNo": { "type": "array", "items": { "pattern": "^(\\+|-)?([1-9]|[0-4][0-9]|5[0-3])", "type": "string" }, "description": "" }, "byMonth": { "type": "array", "items": { "maximum": 12.0, "minimum": 1.0, "type": "integer", "format": "int32" }, "description": "" }, "bySetPos": { "type": "array", "items": { "pattern": "^(\\+|-)?([1-9]|[1-2][0-9][0-9]|3[0-5][0-9]|36[0-6])", "type": "string" }, "description": "" }, "wkst": { "pattern": "^(MO|TU|WE|TH|FR|SA|SU)", "type": "string" } } }, "TimeWindowExclusionEventArraySpec": { "title": "TimeWindowExclusionEventArraySpec", "required": [ "data" ], "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/Data6" }, "description": "" } } }, "TimeWindowExclusionEvent": { "title": "TimeWindowExclusionEvent", "type": "object", "properties": { "name": { "type": "string" }, "description": { "type": "string" }, "locale": { "type": "string", "description": "Locale label - Should match tome zone define in startTime and endTime, but is not enforced" }, "exclusionType": { "$ref": "#/components/schemas/ExclusionType" }, "match": { "$ref": "#/components/schemas/TimeWindowExclusionMatch" }, "occurrences": { "type": "array", "items": { "$ref": "#/components/schemas/Occurrence" }, "description": "" } } }, "TenantCreationRequest": { "title": "TenantCreationRequest", "required": [ "data" ], "type": "object", "properties": { "data": { "$ref": "#/components/schemas/TenantCreationObject" } }, "description": "The request used when creating a new Tenant in Datahub" }, "TenantUpdateRequest": { "title": "TenantUpdateRequest", "required": [ "data" ], "type": "object", "properties": { "data": { "$ref": "#/components/schemas/TenantUpdateObject" } }, "description": "The request used when updating an existing Tenant in Datahub" }, "TenantResponse": { "title": "TenantResponse", "required": [ "data" ], "type": "object", "properties": { "data": { "$ref": "#/components/schemas/Tenant" } }, "description": "The response returned for a single Tenant from Datahub" }, "TenantListResponse": { "title": "TenantListResponse", "required": [ "data" ], "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/Tenant" }, "description": "" } }, "description": "The response returned for multiple Tenants from Datahub" }, "TenantCreationObject": { "title": "TenantCreationObject", "required": [ "type", "attributes" ], "type": "object", "properties": { "type": { "enum": [ "tenants" ], "type": "string", "example": "tenants" }, "id": { "type": "string" }, "attributes": { "$ref": "#/components/schemas/Attributes11" } } }, "TenantUpdateObject": { "title": "TenantUpdateObject", "required": [ "type", "id", "attributes" ], "type": "object", "properties": { "type": { "enum": [ "tenants" ], "type": "string", "example": "tenants" }, "id": { "type": "string" }, "attributes": { "$ref": "#/components/schemas/Attributes12" } } }, "Tenant": { "title": "Tenant", "required": [ "type", "id", "attributes" ], "type": "object", "properties": { "type": { "enum": [ "tenants" ], "type": "string", "example": "tenants" }, "id": { "type": "string" }, "attributes": { "$ref": "#/components/schemas/Attributes13" } } }, "OpenIDConfig": { "title": "OpenIDConfig", "required": [ "baseURL", "clientID" ], "type": "object", "properties": { "domainMapping": { "type": "object", "additionalProperties": {} }, "default": { "type": "boolean" }, "label": { "type": "string" }, "baseURL": { "type": "string" }, "clientID": { "type": "string" }, "clientName": { "type": "string" }, "secretEnv": { "type": "string" } } }, "SAMLConfig": { "title": "SAMLConfig", "required": [ "identityProviderMetadataPath" ], "type": "object", "properties": { "keystorePath": { "type": "string" }, "keystorePasswordEnv": { "type": "string" }, "privateKeyPasswordEnv": { "type": "string" }, "identityProviderMetadataPath": { "type": "string" }, "serviceProviderEntityID": { "type": "string" }, "serviceProviderMetadataPath": { "type": "string" }, "default": { "type": "boolean", "description": "If this flag is true, then UI will show this one as default login option" }, "clientName": { "type": "string" }, "label": { "type": "string" } } }, "IngestionDictionaryListResponse": { "title": "IngestionDictionaryListResponse", "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/Data7" }, "description": "" } }, "description": "Provides a listing of all metric values supported by Datahub" }, "ValidTypesListResponse": { "title": "ValidTypesListResponse", "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/Data8" }, "description": "" } }, "description": "Provides known values mappings for Datahub" }, "JsonApiSolutionManifestResponse": { "title": "JsonApiSolutionManifestResponse", "type": "object", "properties": { "data": { "$ref": "#/components/schemas/Data9" } }, "description": "A manifest containing Skylight Analytics release and solution versions as well as the version of all running services" }, "TenantSummaryResponse": { "title": "TenantSummaryResponse", "type": "object", "properties": { "data": { "$ref": "#/components/schemas/Data10" } }, "description": "Contains the mapping of an alias to a Tenant ID" }, "TenantMetadataUpdateRequest": { "title": "TenantMetadataUpdateRequest", "required": [ "data" ], "type": "object", "properties": { "data": { "$ref": "#/components/schemas/Data11" } }, "description": "Object used to update a TenantMetadata in Datahub" }, "TenantMetadataResponse": { "title": "TenantMetadataResponse", "required": [ "data" ], "type": "object", "properties": { "data": { "$ref": "#/components/schemas/TenantMetadata" } }, "description": "A single object TenantMetadata response from Datahub" }, "MetricDatasourceConfig": { "title": "MetricDatasourceConfig", "required": [ "maxIngestionPeriod", "acceptNewData", "retainData", "canQuery", "granularity", "tableName" ], "type": "object", "properties": { "maxDeltaIngestionThreads": { "type": "integer", "description": "The maximum amount of threads that will be used to ingest data into this datasource for delta tasks", "format": "int32" }, "maxIngestionThreads": { "type": "integer", "description": "The maximum amount of threads that will be used to ingest data into this datasource for refresh tasks", "format": "int32" }, "maxRowsPerFile": { "type": "integer", "description": "The maximum amount of rows that will be stored in a persisted metric file", "format": "int64" }, "maxRowsInMemory": { "type": "integer", "description": "The maximum amount of rows that will be processed (among all threads) before persisting the metrics files", "format": "int64" }, "maxIngestionPeriod": { "type": "string", "description": "ISO8601 format period (only Time variant i.e. must start 'PT') which determines how far in the past data for this datasource will be accepted." }, "acceptNewData": { "type": "boolean", "description": "If set to 'true' then new data will be ingested for this datasource. If 'false', no new data will be ingested for this datasource" }, "retainData": { "type": "boolean", "description": "If set to 'true' then existing data must be retained up to the maxIngestionPeriod. If 'false', data for this datasource may be purged" }, "canQuery": { "type": "boolean", "description": "If set to 'true' then this datasource may be queried up to maxIngestionPeriod. If 'false', data may be missing from this datasource so it should not be queried" }, "granularity": { "type": "string", "description": "ISO8601 format period (only Time variant i.e. must start 'PT') which describes the granularity of the data in the datasource." }, "tableName": { "type": "string", "description": "Name of the table root for finding ingestion data for this datasource." } }, "description": "Properties that describe how a metric datasource should be managed" }, "MetricQueryConfig": { "title": "MetricQueryConfig", "required": [ "targetNumberOfDataPoints", "datasourceQueryDurationMap" ], "type": "object", "properties": { "targetNumberOfDataPoints": { "type": "integer", "description": "Approximate number of datapoints to return from any Session Metrics query. This is used to determine the Granularity bucket size for an interval.", "format": "int32" }, "datasourceQueryDurationMap": { "type": "object", "additionalProperties": { "type": "string" } } }, "description": "Properties that describe how Session metrics will be queried from a Multi-Resolution datasource setup" }, "TenantMetadata": { "title": "TenantMetadata", "required": [ "type", "id", "attributes" ], "type": "object", "properties": { "type": { "enum": [ "tenantMetadata" ], "type": "string", "example": "tenantMetadata" }, "id": { "type": "string" }, "attributes": { "$ref": "#/components/schemas/Attributes19" } }, "description": "Represents TenantMetadata used to provide context for a Tenant in Datahub" }, "IngestionVersionRetetionProperties": { "title": "IngestionVersionRetetionProperties", "required": [ "metricAdmin", "metricDelta", "metricTable" ], "type": "object", "properties": { "metricAdmin": { "type": "string", "description": "ISO8601 format period (only Time variant i.e. must start 'PT') which determines for what period of time old versions of metric admin data (baselines, ing profile data, etc) will be kept" }, "metricDelta": { "type": "string", "description": "ISO8601 format period (only Time variant i.e. must start 'PT') which determines for what period of time old versions of metric delta will be kept" }, "metricTable": { "type": "string", "description": "ISO8601 format period (only Time variant i.e. must start 'PT') which determines for what period of time old versions of metric refresh will be kept" } } }, "ActiveAlert": { "title": "ActiveAlert", "required": [ "tenantId", "objectId", "policyId" ], "type": "object", "properties": { "tenantId": { "type": "string", "description": "The tenant ID" }, "objectId": { "type": "string", "description": "The Object ID for the active alert" }, "policyId": { "type": "string", "description": "The policy ID" }, "policyName": { "type": "string", "description": "Message is associated with an existing policy's Name" }, "direction": { "type": "string", "description": "The direction of the metric that caused the alert" }, "raiseProcessedAt": { "type": "integer", "description": "When the alert was raised at. Note this is not the record's timestamp", "format": "int64" }, "startTimestamp": { "type": "integer", "description": "The timestamp of the last record in the series to trigger this alert", "format": "int64" }, "endTimestamp": { "type": "integer", "description": "The timestamp of the last record in the series to trigger the clearing of this alert", "format": "int64" }, "alertState": { "$ref": "#/components/schemas/AlertState" }, "policyType": { "$ref": "#/components/schemas/PolicyType" }, "metric": { "type": "string" }, "duration": { "type": "number", "description": "The total amount of time spent in violation" }, "meta": { "type": "object", "additionalProperties": { "type": "string" }, "description": "Attributes added to a Monitored Object that help identify the Monitored Object as well as provide flitering/grouping properties" }, "srcLat": { "type": "number", "description": "Geographic latitude of Monitored Object source" }, "srcLon": { "type": "number", "description": "Geographic longitude of Monitored Object source" }, "dstLat": { "type": "number", "description": "Geographic latitude of Monitored Object destination" }, "dstLon": { "type": "number", "description": "Geographic longitude of Monitored Object destination" }, "sourceLocation": { "$ref": "#/components/schemas/MonitoredObjectLocation" }, "destinationLocation": { "$ref": "#/components/schemas/MonitoredObjectLocation" }, "topology": { "type": "array", "items": { "type": "string" }, "description": "Tags used to describe the path segments associated with the Monitored Object" }, "value": { "type": "string", "description": "This can either be the threshold value or a distance measure for dynamic thresholds" }, "comparator": { "$ref": "#/components/schemas/Comparator1" }, "sessionId": { "type": "string" }, "bcn": { "type": "string" }, "bca": { "type": "string" }, "ip": { "type": "string" }, "captureLayer": { "type": "string" }, "captureZone": { "type": "string" }, "captureApplicationId": { "type": "string" }, "captureZoneId": { "type": "string" }, "captureMetaThresholds": { "type": "number" }, "captureMetaValues": { "type": "string" }, "captureMetaIps": { "type": "string" }, "captureMetaDesc": { "type": "string" }, "captureMetaDate_stop": { "type": "number" }, "captureMetaDate_start": { "type": "number" }, "captureMetaIp_client": { "type": "string" }, "captureMetaIp_count": { "type": "number" }, "captureMetaStart": { "type": "number" }, "captureMetaStop": { "type": "number" }, "captureMetaName": { "type": "string" }, "captureMetaAlert_id": { "type": "number" }, "captureMetaNow": { "type": "number" }, "captureMetaFirst_sent": { "type": "number" }, "captureMetaLast_sent": { "type": "number" }, "captureMetaSite": { "type": "string" }, "captureMetaWorker": { "type": "string" }, "captureMetaFiring": { "type": "string" }, "captureMetaCertainty": { "type": "number" }, "captureMetaHostname": { "type": "string" }, "captureMetaCertainty_percent": { "type": "number" }, "captureClientZoneId": { "type": "string" }, "captureServerZoneId": { "type": "string" }, "severity": { "$ref": "#/components/schemas/Severity" }, "sourceIp": { "type": "string" }, "destinationIp": { "type": "string" }, "killchain": { "$ref": "#/components/schemas/Killchain" }, "securityJobType": { "type": "string" }, "sourceNetworkAssetRoles": { "type": "string" }, "destinationNetworkAssetRoles": { "type": "string" }, "securityState": { "$ref": "#/components/schemas/ActiveAlertSecurityState" }, "sourcePort": { "type": "number" }, "destinationPort": { "type": "number" } }, "description": "An active alert for a monitoredObject" }, "ActiveAlertSecurityState": { "title": "ActiveAlertSecurityState", "type": "object", "properties": { "currentState": { "$ref": "#/components/schemas/CurrentState" }, "changeHistory": { "type": "array", "items": { "$ref": "#/components/schemas/ActiveAlertSecurityStateUpdate" }, "description": "" } } }, "ActiveAlertSecurityStateUpdate": { "title": "ActiveAlertSecurityStateUpdate", "type": "object", "properties": { "from": { "type": "string" }, "to": { "type": "string" }, "userId": { "type": "string" }, "timestamp": { "type": "integer", "format": "int64" }, "comment": { "type": "string" } } }, "ActiveAlertsSecurityStateUpdateRequest": { "title": "ActiveAlertsSecurityStateUpdateRequest", "required": [ "targetAlerts", "newState" ], "type": "object", "properties": { "targetAlerts": { "type": "array", "items": { "type": "string" }, "description": "A list of objectIDs of alerts to change security state of" }, "newState": { "$ref": "#/components/schemas/NewState" }, "comment": { "type": "string" } } }, "ActiveAlertsListResponse": { "title": "ActiveAlertsListResponse", "required": [ "data" ], "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/ActiveAlert" }, "description": "" }, "meta": { "$ref": "#/components/schemas/Meta" } }, "description": "ActiveAlert response including one or more values" }, "ActiveAlertsFilteredCountsResponse": { "title": "ActiveAlertsFilteredCountsResponse", "required": [ "data" ], "type": "object", "properties": { "data": { "$ref": "#/components/schemas/Data12" } }, "description": "Active Alert counts response" }, "ActiveAlertsFilteredCountsRequest": { "title": "ActiveAlertsFilteredCountsRequest", "required": [ "data" ], "type": "object", "properties": { "data": { "$ref": "#/components/schemas/Data13" } } }, "ActiveAlertsQueryContextSortEntry": { "title": "ActiveAlertsQueryContextSortEntry", "required": [ "field" ], "type": "object", "properties": { "field": { "$ref": "#/components/schemas/Field" }, "order": { "$ref": "#/components/schemas/Order" } } }, "ActiveAlertsQueryContext": { "title": "ActiveAlertsQueryContext", "type": "object", "properties": { "sort": { "type": "array", "items": { "$ref": "#/components/schemas/ActiveAlertsQueryContextSortEntry" }, "description": "" }, "numResults": { "type": "integer", "format": "int32" } } }, "ActiveAlertsFilteredListRequest": { "title": "ActiveAlertsFilteredListRequest", "type": "object", "properties": { "queryContext": { "$ref": "#/components/schemas/ActiveAlertsQueryContext" }, "expressions": { "$ref": "#/components/schemas/expressions" }, "meta": { "type": "object", "additionalProperties": {}, "description": "An object that allows filtering on arbitrary metadata criteria and their values. The keys in the map are associated with metadata categories and the value array corresponds to a set of whitelist filter-in values for that category. The logical semantics associated with this structure are conditional-AND across metadata criteria (keys) and conditional-OR across the values contained within the value array. For example, {\"region\":[\"montreal\",\"ottawa\"], \"group\":[\"radio\"]} will match all records that are of group \"radio\" AND from the region \"montreal\" OR \"ottawa\"", "example": { "region": [ "montreal", "ottawa" ], "group": [ "radio" ] } }, "metaExclude": { "type": "array", "items": { "type": "string" }, "description": "An array that allows blacklisting one or more metadata criteria. Each key in the array must correspond to a given key in the MetaFilter portion of the request. This exclusion is a logical NOT for any values belonging to the metadata criteria listed in this request. For example, if the MetaFilter is: {\"region\":[\"montreal\",\"ottawa\"], \"group\":[\"radio\"]}, we can have a MetaExclude of the form [\"region\"]. This would result in a request that includes any records that are of group \"radio\" AND NOT in regions Ottawa or Montreal.", "example": [ "group" ] }, "objectId": { "type": "array", "items": { "type": "string" }, "description": "The Object ID for the active alert" }, "policyName": { "type": "string", "description": "Message is associated with an existing policy's Name" }, "policyId": { "type": "array", "items": { "type": "string" }, "description": "The policy ID" }, "policyType": { "type": "array", "items": { "type": "string" }, "description": "" }, "direction": { "type": "array", "items": { "type": "string" }, "description": "The direction of the metric that caused the alert" }, "metric": { "type": "array", "items": { "type": "string" }, "description": "" }, "topology": { "type": "array", "items": { "type": "string" }, "description": "" }, "captureZone": { "type": "array", "items": { "type": "string" }, "description": "" }, "captureApplicationId": { "type": "array", "items": { "type": "string" }, "description": "" }, "captureZoneId": { "type": "array", "items": { "type": "string" }, "description": "" }, "captureLayer": { "type": "array", "items": { "type": "string" }, "description": "" }, "captureClientZoneId": { "type": "array", "items": { "type": "string" }, "description": "" }, "captureServerZoneId": { "type": "array", "items": { "type": "string" }, "description": "" }, "severity": { "type": "array", "items": { "type": "string" }, "description": "" }, "sourceLocation": { "$ref": "#/components/schemas/GeoFence" }, "destinationLocation": { "$ref": "#/components/schemas/GeoFence" }, "sourceIp": { "type": "array", "items": { "type": "string" }, "description": "" }, "destinationIp": { "type": "array", "items": { "type": "string" }, "description": "" }, "killchain": { "type": "array", "items": { "type": "string" }, "description": "" }, "securityJobType": { "type": "array", "items": { "type": "string" }, "description": "" }, "sourceNetworkAssetRoles": { "type": "array", "items": { "type": "string" }, "description": "" }, "destinationNetworkAssetRoles": { "type": "array", "items": { "type": "string" }, "description": "" } } }, "JsonApiActiveAlertGroupByRequest": { "title": "JsonApiActiveAlertGroupByRequest", "type": "object", "properties": { "data": { "$ref": "#/components/schemas/Data14" } }, "description": "JSON API compliant wrapper for the groupby query" }, "JsonApiActiveAlertGroupByResponse": { "title": "JsonApiActiveAlertGroupByResponse", "type": "object", "properties": { "data": { "$ref": "#/components/schemas/Data15" } }, "description": "JSON API compliant wrapper for the groupby response" }, "ActiveAlertGroupByConfig": { "title": "ActiveAlertGroupByConfig", "required": [ "groupingContext", "alerts" ], "type": "object", "properties": { "queryContext": { "$ref": "#/components/schemas/ActiveAlertGroupByQueryContext" }, "metaContext": { "$ref": "#/components/schemas/MetaContext" }, "groupingContext": { "$ref": "#/components/schemas/GroupingContext" }, "aggregation": { "$ref": "#/components/schemas/SupportedAggregations" }, "expressions": { "$ref": "#/components/schemas/expressions" }, "alerts": { "type": "array", "items": { "$ref": "#/components/schemas/ActiveAlertSpec" }, "description": "A set of identifiers that considers specific alert based on the provided information" }, "enableSecurityMetrics": { "type": "boolean", "description": "Enable additional aggregations for each group of alerts", "default": false } }, "description": "The necessary request parameters for the metric api call" }, "ActiveAlertGroupedResultEntryParameters": { "title": "ActiveAlertGroupedResultEntryParameters", "required": [ "groupedResults" ], "type": "object", "properties": { "policyId": { "type": "array", "items": { "type": "string" }, "description": "Policy ID to filter on" }, "policyType": { "type": "array", "items": { "type": "string" }, "description": "Hint to the query engine to limit the metric to certain types of entity.", "example": [ "micro-tca", "anomaly", "capture", "capture-automatic", "security", "capture-v2" ] }, "alertState": { "type": "array", "items": { "type": "string" }, "description": "Set of one or more alert state to be used by the filter", "example": [ "raised", "cleared" ] }, "metric": { "type": "array", "items": { "type": "string" }, "description": "Name that identifies the specific metric within a monitored object", "example": [ "delayp95", "hit.rtt.per_sec" ] }, "direction": { "type": "array", "items": { "type": "string" }, "description": "Set of one or more directions to be used by the filter to identify required metric records", "example": [ "0", "1" ] }, "topology": { "type": "string", "description": "Name of a node on the route of the Monitored Object" }, "objectId": { "type": "array", "items": { "type": "string" }, "description": "Set of object IDs to filter on", "example": [ "333732dc-99d4-4224-915e-3972b50d10ef", "931e7d13-6320-4ad7-ae06-7ff2df4f782a" ] }, "captureZone": { "type": "array", "items": { "type": "string" }, "description": "" }, "captureApplicationId": { "type": "array", "items": { "type": "string" }, "description": "" }, "captureZoneId": { "type": "array", "items": { "type": "string" }, "description": "" }, "captureLayer": { "type": "array", "items": { "type": "string" }, "description": "" }, "captureClientZoneId": { "type": "array", "items": { "type": "string" }, "description": "" }, "captureServerZoneId": { "type": "array", "items": { "type": "string" }, "description": "" }, "severity": { "type": "array", "items": { "type": "string" }, "description": "" }, "sourceIp": { "type": "array", "items": { "type": "string" }, "description": "" }, "destinationIp": { "type": "array", "items": { "type": "string" }, "description": "" }, "killchain": { "type": "array", "items": { "type": "string" }, "description": "" }, "securityJobType": { "type": "array", "items": { "type": "string" }, "description": "" }, "sourceNetworkAssetRoles": { "type": "array", "items": { "type": "string" }, "description": "" }, "destinationNetworkAssetRoles": { "type": "array", "items": { "type": "string" }, "description": "" }, "sourceLocation": { "$ref": "#/components/schemas/GeoFence" }, "destinationLocation": { "$ref": "#/components/schemas/GeoFence" }, "groupedResults": { "type": "array", "items": { "$ref": "#/components/schemas/GroupedResult" }, "description": "" } }, "description": "Describes filtering criteria used for a particular query that uses a grouping" }, "ActiveAlertGroupByQueryContext": { "title": "ActiveAlertGroupByQueryContext", "type": "object", "properties": { "timeout": { "type": "integer", "description": "Query timeout in milliseconds", "format": "int32", "example": 30000 }, "sortOnGroupingKey": { "type": "string", "description": "Allows a client to sort on a grouping key instead of the metric's value", "default": "policyId", "example": "policyId" }, "sorted": { "$ref": "#/components/schemas/Sorted" }, "numResults": { "type": "integer", "description": "Number of results to return in grouped queries. A non-positive integer for this value implies there is no result limit. Only applicable to grouped queries.", "format": "int32", "example": 10 } }, "description": "Hints indicating how the query may be Returns" }, "ActiveAlertSpec": { "title": "ActiveAlertSpec", "type": "object", "properties": { "policyId": { "type": "array", "items": { "type": "string" }, "description": "Policy ID to filter on" }, "policyType": { "type": "array", "items": { "type": "string" }, "description": "Hint to the query engine to limit the metric to certain types of entity.", "example": [ "micro-tca", "anomaly", "capture", "capture-automatic", "security", "capture-v2" ] }, "alertState": { "type": "array", "items": { "type": "string" }, "description": "Set of one or more alert state to be used by the filter", "example": [ "raised", "cleared" ] }, "metric": { "type": "array", "items": { "type": "string" }, "description": "Name that identifies the specific metric within a monitored object", "example": [ "delayp95", "hit.rtt.per_sec" ] }, "direction": { "type": "array", "items": { "type": "string" }, "description": "Set of one or more directions to be used by the filter to identify required metric records", "example": [ "0", "1" ] }, "topology": { "type": "string", "description": "Name of a node on the route of the Monitored Object" }, "objectId": { "type": "array", "items": { "type": "string" }, "description": "Set of object IDs to filter on", "example": [ "333732dc-99d4-4224-915e-3972b50d10ef", "931e7d13-6320-4ad7-ae06-7ff2df4f782a" ] }, "captureZone": { "type": "array", "items": { "type": "string" }, "description": "" }, "captureApplicationId": { "type": "array", "items": { "type": "string" }, "description": "" }, "captureZoneId": { "type": "array", "items": { "type": "string" }, "description": "" }, "captureLayer": { "type": "array", "items": { "type": "string" }, "description": "" }, "captureClientZoneId": { "type": "array", "items": { "type": "string" }, "description": "" }, "captureServerZoneId": { "type": "array", "items": { "type": "string" }, "description": "" }, "severity": { "type": "array", "items": { "type": "string" }, "description": "" }, "sourceIp": { "type": "array", "items": { "type": "string" }, "description": "" }, "destinationIp": { "type": "array", "items": { "type": "string" }, "description": "" }, "killchain": { "type": "array", "items": { "type": "string" }, "description": "" }, "securityJobType": { "type": "array", "items": { "type": "string" }, "description": "" }, "sourceNetworkAssetRoles": { "type": "array", "items": { "type": "string" }, "description": "" }, "destinationNetworkAssetRoles": { "type": "array", "items": { "type": "string" }, "description": "" }, "sourceLocation": { "$ref": "#/components/schemas/GeoFence" }, "destinationLocation": { "$ref": "#/components/schemas/GeoFence" } }, "description": "Filter object that identifies a specific metric within a monitored object by its key attributes" }, "AnalyticsRequest": { "title": "AnalyticsRequest", "required": [ "data" ], "type": "object", "properties": { "data": { "$ref": "#/components/schemas/Data16" } }, "description": "Object used to request a specific analysis from Datahub" }, "AnalyticsPatternMatch": { "title": "AnalyticsPatternMatch", "type": "object", "properties": { "timeSlice": { "$ref": "#/components/schemas/AnalyticsTimeSlice" } }, "description": "Defines the Pattern Match class of anaylics request" }, "AnalyticsTimeSlice": { "title": "AnalyticsTimeSlice", "type": "object", "properties": { "configuration": { "$ref": "#/components/schemas/Configuration" }, "match": { "$ref": "#/components/schemas/Match" } }, "description": "Defines the Time Slice sub-class of anaylics request" }, "AnalyticsTargetScope": { "title": "AnalyticsTargetScope", "required": [ "vendor", "objectType", "metric", "direction" ], "type": "object", "properties": { "vendor": { "type": "string" }, "objectType": { "type": "string" }, "metric": { "type": "string" }, "direction": { "type": "string" } }, "description": "Properties that filter what matched patterns will be returned. If not provided, then the widest match range will be returned" }, "AnalyticsObject": { "title": "AnalyticsObject", "required": [ "type", "id", "attributes" ], "type": "object", "properties": { "type": { "enum": [ "analytics" ], "type": "string", "example": "analytics" }, "id": { "type": "string" }, "attributes": { "$ref": "#/components/schemas/Attributes24" } } }, "AnalyticsListResponse": { "title": "AnalyticsListResponse", "required": [ "data" ], "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/AnalyticsObject" }, "description": "" } }, "description": "Analytics response including one or more values" }, "AnalyticsResponse": { "title": "AnalyticsResponse", "required": [ "data" ], "type": "object", "properties": { "data": { "$ref": "#/components/schemas/AnalyticsObject" } }, "description": "An Analytics response from Datahub" }, "BrandingCreateRequest": { "title": "BrandingCreateRequest", "required": [ "data" ], "type": "object", "properties": { "data": { "$ref": "#/components/schemas/Data17" } } }, "BrandingUpdateRequest": { "title": "BrandingUpdateRequest", "required": [ "data" ], "type": "object", "properties": { "data": { "$ref": "#/components/schemas/Data18" } } }, "BrandingResponse": { "title": "BrandingResponse", "required": [ "data" ], "type": "object", "properties": { "data": { "$ref": "#/components/schemas/Branding" } } }, "BrandingListResponse": { "title": "BrandingListResponse", "required": [ "data" ], "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/Branding" }, "description": "" } } }, "Branding": { "title": "Branding", "required": [ "type", "id", "attributes" ], "type": "object", "properties": { "type": { "enum": [ "brandings" ], "type": "string", "example": "brandings" }, "id": { "type": "string" }, "attributes": { "$ref": "#/components/schemas/Attributes27" } } }, "BrandingLogo": { "title": "BrandingLogo", "type": "object", "properties": { "file": { "$ref": "#/components/schemas/File" } }, "description": "Describes the information used to display the branding logo image on the Datahub UI" }, "LocaleCreateRequest": { "title": "LocaleCreateRequest", "required": [ "data" ], "type": "object", "properties": { "data": { "$ref": "#/components/schemas/Data19" } } }, "LocaleUpdateRequest": { "title": "LocaleUpdateRequest", "required": [ "data" ], "type": "object", "properties": { "data": { "$ref": "#/components/schemas/Data20" } } }, "LocaleResponse": { "title": "LocaleResponse", "required": [ "data" ], "type": "object", "properties": { "data": { "$ref": "#/components/schemas/Locale" } } }, "LocaleListResponse": { "title": "LocaleListResponse", "required": [ "data" ], "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/Locale" }, "description": "" } } }, "Locale": { "title": "Locale", "required": [ "type", "id", "attributes" ], "type": "object", "properties": { "type": { "enum": [ "locales" ], "type": "string", "example": "locales" }, "id": { "type": "string" }, "attributes": { "$ref": "#/components/schemas/Attributes30" } } }, "MetricIdentifierFilter": { "title": "MetricIdentifierFilter", "required": [ "objectType", "metric" ], "type": "object", "properties": { "vendor": { "type": "string", "description": "Vendor name associated with the monitored object", "example": "accedian-twamp" }, "objectType": { "type": "array", "items": { "type": "string" }, "description": "Object types to be considered as part of the filter", "example": [ [ "twamp-pe" ], [ "twamp-sl", "twamp-sf" ] ] }, "metric": { "type": "string", "description": "Name that identifies the specific metric within a monitored object", "example": "delayP95" }, "direction": { "type": "array", "items": { "type": "string" }, "description": "Set of one or more directions to be used by the filter to identify required metric records", "example": [ [ "0" ], [ "0", "1" ] ] } }, "description": "Filter object that identifies a specific metric within a monitored object by its key attributes" }, "MetricBucket": { "title": "MetricBucket", "type": "object", "properties": { "type": { "$ref": "#/components/schemas/Type25" }, "filterMetric": { "type": "string" }, "lower": { "$ref": "#/components/schemas/Lower" }, "upper": { "$ref": "#/components/schemas/Upper" } } }, "SupportedAggregations": { "title": "SupportedAggregations", "enum": [ "min", "max", "avg", "count", "sum" ], "type": "string", "description": "The type of aggregation (avg/min/max/count/sum) avg - Returns the averaging the metric per monitored object for the time range, within the bounding filter as specified by the bucket property. min - Returns the minimum value for the metric per monitored object for the time range, within the bounding filter as specified by the bucket property. max - Returns the maximum value for the metric per monitored object for the time range, within the bounding filter as specified by the bucket property. count - Returns the number of events within the specified bucket property. A single bucket is the preferred usage but multiple buckets can be used as a band pass filter. sum - Returns the summed value of all records grouped by the provided groupings", "example": "min" }, "SpatialFilter": { "title": "SpatialFilter", "type": "object", "properties": { "rectangular": { "$ref": "#/components/schemas/Rectangular" } } }, "SpatialCoordinates": { "title": "SpatialCoordinates", "required": [ "latitude", "longitude" ], "type": "object", "properties": { "latitude": { "type": "number" }, "longitude": { "type": "number" } } }, "MetricSpec": { "title": "MetricSpec", "required": [ "metric" ], "type": "object", "properties": { "vendor": { "type": "string", "description": "Vendor name associated with the monitored object", "example": "accedian-twamp" }, "objectType": { "type": "array", "items": { "type": "string" }, "description": "Object types to be considered as part of the filter", "example": [ [ "twamp-pe" ], [ "twamp-sl", "twamp-sf" ] ] }, "direction": { "type": "array", "items": { "type": "string" }, "description": "Set of one or more directions to be used by the filter to identify required metric records", "example": [ [ "0" ], [ "0", "1" ] ] }, "monitoredObjectId": { "type": "array", "items": { "type": "string" }, "description": "Set of one or more monitored object Ids to be used by the filter to identify required metric records", "example": [ [ "abc" ], [ "abc", "def" ] ] }, "sourceLocation": { "$ref": "#/components/schemas/SpatialFilter" }, "destinationLocation": { "$ref": "#/components/schemas/SpatialFilter" }, "topology": { "type": "string", "description": "Name of a node on the route of the Monitored Object" }, "metadata": { "$ref": "#/components/schemas/Metadata1" }, "valueBoundary": { "$ref": "#/components/schemas/MetricBucket" }, "metric": { "type": "string", "description": "Name that identifies the specific metric within a monitored object", "example": "delayP95" } }, "description": "Filter object that identifies a specific metric within a monitored object by its key attributes" }, "SupportedMetricValueFilters": { "title": "SupportedMetricValueFilters", "type": "object", "properties": { "valueBoundary": { "$ref": "#/components/schemas/MetricBucket" } } }, "SupportedMetricDimensionFilters": { "title": "SupportedMetricDimensionFilters", "type": "object", "properties": { "vendor": { "type": "string", "description": "Vendor name associated with the monitored object", "example": "accedian-twamp" }, "objectType": { "type": "array", "items": { "type": "string" }, "description": "Object types to be considered as part of the filter", "example": [ [ "twamp-pe" ], [ "twamp-sl", "twamp-sf" ] ] }, "direction": { "type": "array", "items": { "type": "string" }, "description": "Set of one or more directions to be used by the filter to identify required metric records", "example": [ [ "0" ], [ "0", "1" ] ] }, "monitoredObjectId": { "type": "array", "items": { "type": "string" }, "description": "Set of one or more monitored object Ids to be used by the filter to identify required metric records", "example": [ [ "abc" ], [ "abc", "def" ] ] }, "sourceLocation": { "$ref": "#/components/schemas/SpatialFilter" }, "destinationLocation": { "$ref": "#/components/schemas/SpatialFilter" }, "topology": { "type": "string", "description": "Name of a node on the route of the Monitored Object" }, "metadata": { "$ref": "#/components/schemas/Metadata1" } } }, "MetricResultSeries": { "title": "MetricResultSeries", "required": [ "metric", "series" ], "type": "object", "properties": { "monitoredObjectIds": { "type": "array", "items": { "type": "string" }, "description": "" }, "vendor": { "type": "string" }, "objectType": { "type": "array", "items": { "type": "string" }, "description": "" }, "metric": { "type": "string" }, "direction": { "type": "array", "items": { "type": "string" }, "description": "" }, "series": { "type": "array", "items": { "$ref": "#/components/schemas/MetricResultEntry" }, "description": "" } }, "description": "Describes series data prefixed with the filter criteria that were used to generate the output" }, "MetricResultEntry": { "title": "MetricResultEntry", "required": [ "timestamp", "value" ], "type": "object", "properties": { "timestamp": { "type": "string" }, "value": { "type": "number" } }, "description": "A singular time series entry that contains the timestamp and value" }, "ResultEntryParameters": { "title": "ResultEntryParameters", "required": [ "metric" ], "type": "object", "properties": { "monitoredObjectIds": { "type": "array", "items": { "type": "string" }, "description": "" }, "vendor": { "type": "string" }, "objectType": { "type": "array", "items": { "type": "string" }, "description": "" }, "metric": { "type": "string" }, "direction": { "type": "array", "items": { "type": "string" }, "description": "" } }, "description": "Describes filtering criteria used for a particular query" }, "genericFilterMapItem": { "title": "genericFilterMapItem", "type": "object", "properties": { "key": { "type": "string", "example": "zone" }, "values": { "type": "array", "items": { "type": "string" }, "description": "", "example": [ "paris", "lyon" ] } } }, "enabledAlertPolicyLimit": { "title": "enabledAlertPolicyLimit", "type": "object", "properties": { "micro-tca": { "type": "integer", "description": "Describes the total number of active micro-tca policies", "format": "int32", "example": 20 }, "capture": { "type": "integer", "description": "Describes the total number of active capture policies", "format": "int32", "example": 20 }, "security": { "type": "integer", "description": "Describes the total number of active security policies", "format": "int32", "example": 20 } } }, "expressionCondition": { "title": "expressionCondition", "type": "object", "properties": { "equal": { "type": "string" }, "notequal": { "type": "string" }, "lt": { "type": "integer", "format": "int32" }, "gt": { "type": "integer", "format": "int32" }, "in": { "type": "array", "items": { "type": "string" }, "description": "" }, "notin": { "type": "array", "items": { "type": "string" }, "description": "" } } }, "expressionItems": { "title": "expressionItems", "type": "object", "properties": { "field": { "type": "string" }, "condition": { "$ref": "#/components/schemas/expressionCondition" }, "expressions": { "$ref": "#/components/schemas/expressions" } } }, "expressions": { "title": "expressions", "type": "object", "properties": { "operator": { "$ref": "#/components/schemas/Operator" }, "expressions": { "type": "array", "items": { "$ref": "#/components/schemas/expressionItems" }, "description": "" } } }, "CompositeMetric": { "title": "CompositeMetric", "required": [ "type", "attributes" ], "type": "object", "properties": { "type": { "enum": [ "compositeMetrics" ], "type": "string", "example": "compositeMetrics" }, "id": { "type": "string" }, "attributes": { "$ref": "#/components/schemas/Attributes31" } }, "description": "Composite metrics" }, "CompositionParameters": { "title": "CompositionParameters", "required": [ "type" ], "type": "object", "properties": { "type": { "$ref": "#/components/schemas/Type27" }, "metricIdentifier": { "$ref": "#/components/schemas/MetricIdentifierFilter" }, "constant": { "$ref": "#/components/schemas/CompositeConstant" }, "compositionId": { "type": "string" } } }, "CompositeMetricOperation": { "title": "CompositeMetricOperation", "required": [ "type", "parameters" ], "type": "object", "properties": { "type": { "$ref": "#/components/schemas/Type26" }, "parameters": { "type": "array", "items": { "$ref": "#/components/schemas/CompositionParameters" }, "description": "" } }, "description": "CompositeMetric metrics operations." }, "CompositeConstant": { "title": "CompositeConstant", "required": [ "value" ], "type": "object", "properties": { "value": { "type": "number" } }, "description": "For arithmetic compositions, constant float values be used as part of the artihmetic" }, "CompositeMetricCreateRequest": { "title": "CompositeMetricCreateRequest", "required": [ "data" ], "type": "object", "properties": { "data": { "$ref": "#/components/schemas/Data21" } }, "description": "Object used to create a CompositeMetric metric in Datahub" }, "CompositeMetricUpdateRequest": { "title": "CompositeMetricUpdateRequest", "required": [ "data" ], "type": "object", "properties": { "data": { "$ref": "#/components/schemas/Data22" } }, "description": "Object used to update a CompositeMetric metric in Datahub" }, "CompositeMetricResponse": { "title": "CompositeMetricResponse", "required": [ "data" ], "type": "object", "properties": { "data": { "$ref": "#/components/schemas/CompositeMetric" } }, "description": "A single object CompositeMetric metric response from Datahub" }, "CompositeMetricListResponse": { "title": "CompositeMetricListResponse", "required": [ "data" ], "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/CompositeMetric" }, "description": "" } }, "description": "Response for one or more CompositeMetricd metrics from Datahub" }, "ConnectorConfigCreateRequest": { "title": "ConnectorConfigCreateRequest", "required": [ "data" ], "type": "object", "properties": { "data": { "$ref": "#/components/schemas/Data23" } } }, "ConnectorConfigUpdateRequest": { "title": "ConnectorConfigUpdateRequest", "required": [ "data" ], "type": "object", "properties": { "data": { "$ref": "#/components/schemas/Data24" } } }, "ConnectorConfigResponse": { "title": "ConnectorConfigResponse", "required": [ "data" ], "type": "object", "properties": { "data": { "$ref": "#/components/schemas/ConnectorConfig" } } }, "ConnectorConfigListResponse": { "title": "ConnectorConfigListResponse", "required": [ "data" ], "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/ConnectorConfig" }, "description": "" } } }, "ConnectorConfig": { "title": "ConnectorConfig", "required": [ "type", "id", "attributes" ], "type": "object", "properties": { "type": { "enum": [ "connectorConfigs" ], "type": "string", "example": "connectorConfigs" }, "id": { "type": "string" }, "attributes": { "$ref": "#/components/schemas/Attributes36" } } }, "SNMPConfig": { "title": "SNMPConfig", "required": [ "targetList", "version", "baseOIDs" ], "type": "object", "properties": { "targetList": { "type": "array", "items": { "$ref": "#/components/schemas/TargetList" }, "description": "" }, "logWalkResults": { "type": "boolean", "description": "Intruct roadrunner to dump the total walk resutls to log for debug purposes. WARNING - On system with lots of\nSNMP targets, this can quite drastically reduce peformance" }, "logSNMPTableResults": { "type": "boolean", "description": "Intruct roadrunner to dump a table view in the logs of the data extracted from the SNMP walk. WARNING - On system with lots of\nSNMP targets, this can quite drastically reduce peformance" }, "version": { "type": "string", "description": "The SNMP Version protocol to use (either v2c or v3)", "example": "v3" }, "V3PrivacyProtocol": { "$ref": "#/components/schemas/V3PrivacyProtocol" }, "V3AuthenticationProtocol": { "$ref": "#/components/schemas/V3AuthenticationProtocol" }, "V3PrivMode": { "$ref": "#/components/schemas/V3PrivMode" }, "community": { "type": "string", "description": "When using v2c SNMP version, the community to use", "default": "public" }, "walkType": { "$ref": "#/components/schemas/WalkType" }, "timeout": { "type": "string", "description": "The fetch timeout duration (in go time.Duration string format)", "default": "10s" }, "maxRepetition": { "type": "integer", "description": "The maximum number of elements to fetch in a bulkGetNext (used during SNMPv3 walks)", "format": "int32", "default": 20 }, "baseOIDs": { "type": "array", "items": { "type": "string" }, "description": "The base OID to start the SNMP walk from. A single bulk fetch is issued every Polling frequency using the OID as root" }, "mibPath": { "type": "string", "description": "A path that is local to the roadrunner instances and that contains properly json formatted mibs for mib resolution. \nSee https://github.com/qmsk/snmpbot for details", "default": "/defaultmibs/" }, "recordMappings": { "type": "array", "items": { "$ref": "#/components/schemas/RecordMappingHeader" }, "description": "" }, "testRawFilePaths": { "type": "array", "items": { "type": "string" }, "description": "For SNMP testing, Roadrunner can fetch a test file from that location and serve it instead of \nhaving to connect to real devices." } } }, "SNMPTrapSenderConfig": { "title": "SNMPTrapSenderConfig", "required": [ "trapTargetHost", "trapTargetPort", "community" ], "type": "object", "properties": { "trapTargetHost": { "type": "string" }, "trapTargetPort": { "type": "string" }, "community": { "type": "string" }, "timeout": { "type": "integer", "format": "int32" } } }, "MQTTConfig": { "title": "MQTTConfig", "type": "object", "properties": { "brokerURI": { "type": "string" }, "clientID": { "type": "string" }, "notificationTopic": { "type": "string" }, "user": { "type": "string" }, "token": { "type": "string" } } }, "CiscoTelemetryConfig": { "title": "CiscoTelemetryConfig", "type": "object", "properties": { "logFetchResults": { "type": "boolean", "description": "Intruct roadrunner to dump all data retrieved from cisco-pipeline to log" }, "logTableResults": { "type": "boolean", "description": "Intruct roadrunner to dump a table view in the logs of the data extracted from cisco-pipeline. WARNING - On system with lots of\nSNMP targets, this can quite drastically reduce peformance" }, "recordMappings": { "type": "array", "items": { "$ref": "#/components/schemas/RecordMappingHeader" }, "description": "" } } }, "OpenMetricsConfig": { "title": "OpenMetricsConfig", "type": "object", "properties": { "logFetchResults": { "type": "boolean", "description": "Instruct roadrunner to dump all data retrieved from open metrics pipeline to log" }, "logTableResults": { "type": "boolean", "description": "Instruct roadrunner to dump a table view in the logs of the data extracted from open metrics pipeline" }, "metricsGatewayHost": { "type": "string", "description": "The address of the web server which the data source will receive metrics on." }, "metricsGatewayPort": { "type": "integer", "description": "The port for the web server which the data source will receive metrics on.", "format": "int32" }, "metricsGatewayURL": { "type": "string", "description": "Endpoint on the web server on which open metrics will be received." }, "metricsGatewayTLS": { "type": "boolean", "description": "Use TLS between the agent and RR for OpenMetrics data" }, "metricsGatewayJWT": { "type": "boolean", "description": "Perform JWT verification on connections between the sensor agents and RR for OpenMetricsData", "default": true }, "blockDuplicateAgentIds": { "type": "boolean", "description": "Block connections from sensor agents if another connection is already registered with the same id", "default": true }, "recordMappings": { "type": "array", "items": { "$ref": "#/components/schemas/RecordMappingHeader" }, "description": "" }, "enableNativeMetrics": { "type": "boolean", "description": "Feature flag to enable connector to publish open metrics in native format." } } }, "OpenMetricsScraperConfig": { "title": "OpenMetricsScraperConfig", "required": [ "prometheusConfig" ], "type": "object", "properties": { "prometheusConfig": { "type": "string", "description": "Raw contents of a prometheus.yml config to use while scraping" }, "batchFrequency": { "type": "string", "description": "Metric data is batched and marked as ready for sending from RoadRunner at this frequency.", "example": "30s" }, "dictionaryReportFrequency": { "type": "string", "description": "Ingestion Dictionaries are sent from RoadRunner at this frequency.", "example": "30s" } } }, "AgentProxyConfig": { "title": "AgentProxyConfig", "type": "object", "properties": { "orchestratorHost": { "type": "string", "description": "Address or hostname of the sensor orchestration component." }, "orchestratorPort": { "type": "integer", "description": "The port which the sensor orchestration component is listening for connections on.", "format": "int32" }, "orchestratorURL": { "type": "string", "description": "The endpoint on the sensor orchestrator for agent control traffic." }, "agentProxyHost": { "type": "string", "description": "The address of the proxy server used by the sensor agents for control messages." }, "agentProxyTLS": { "type": "boolean", "description": "Use TLS between the agent and RR for control messages" }, "agentProxyJWT": { "type": "boolean", "description": "Perform JWT authentication on connections between the sensor agents and RR for control messages", "default": true }, "agentProxyPort": { "type": "integer", "description": "The port for the proxy server used by the sensor agents for control messages.", "format": "int32" }, "agentProxyURL": { "type": "string", "description": "Endpoint on the proxy server for sensor agents to use for establishing a connection to the proxy." } } }, "RecordMappingHeader": { "title": "RecordMappingHeader", "required": [ "monitoredObjectId", "objectType" ], "type": "object", "properties": { "monitoredObjectId": { "type": "string" }, "objectType": { "type": "string" }, "sysUpTimeticks": { "type": "string", "description": "The OID (or SNMPv2-MIB::sysUpTime )" }, "sysCurrentTime": { "type": "string", "description": "The oid (or mib handle) for the current time of the system. We use that and sysUpTimeTick \nto compute a date from timetick" }, "mappingType": { "$ref": "#/components/schemas/MappingType" }, "mappingMatch": { "$ref": "#/components/schemas/MatchEntry" }, "mappings": { "type": "array", "items": { "$ref": "#/components/schemas/RecordMapping" }, "description": "" } } }, "MatchEntry": { "title": "MatchEntry", "required": [ "key", "matches" ], "type": "object", "properties": { "key": { "type": "string" }, "matches": { "type": "string" } } }, "RecordMapping": { "title": "RecordMapping", "required": [ "headerName", "rawSourceName" ], "type": "object", "properties": { "headerName": { "type": "string", "description": "Defines the header name for the column of data to be sent to Analytics" }, "rawSourceName": { "type": "string", "description": "The Source name of the metrics to fetch. For SNMP, this can be either a mib handle (for instance, for Mib2, SNMPv2-MIB::sysName), \nor the equivalent OID (.1.3.6.1.2.1.1.5.0). Note that for in order for mib handle resolution to work, the appropriate mib must have been\nprovided to Connector's deployed instance upfront." }, "ObjectOIDMappingType": { "$ref": "#/components/schemas/ObjectOIDMappingType" }, "rawRecordType": { "$ref": "#/components/schemas/RawRecordType" }, "includeInObjectId": { "type": "boolean", "description": "Wether this record's value must be included as part of the object-ID in the row", "default": false }, "Transformation": { "$ref": "#/components/schemas/Transformation" }, "InstanceIDIdx": { "maxItems": 2, "type": "array", "items": { "type": "integer", "format": "int32" }, "description": "If it's a single number, it's the index of the value in the OID (after we split on dots).\nIf it's an array of 2, it's the start and end indeces of the OID." }, "ChildOid": { "type": "string", "description": "The full child oid to match on", "example": "1.2.3" }, "LookupSrcName": { "type": "string", "description": "The source name of the value we will need in order to do the lookup" }, "LookupDestName": { "type": "string", "description": "The name of the field we're matching the lookup against'" }, "objectIdJoinKey": { "type": "string", "description": "Which chain of characters to use to join this value's to the object Id. Only applicable when \"includeInObjectId\" is true", "default": "-" } } }, "Transformation": { "title": "Transformation", "type": "object", "properties": { "Operation": { "type": "string" }, "Parameter": { "type": "string" }, "Type": { "$ref": "#/components/schemas/Type28" } } }, "ConnectorInstanceCreateRequest": { "title": "ConnectorInstanceCreateRequest", "required": [ "data" ], "type": "object", "properties": { "data": { "$ref": "#/components/schemas/Data25" } } }, "ConnectorInstanceUpdateRequest": { "title": "ConnectorInstanceUpdateRequest", "required": [ "data" ], "type": "object", "properties": { "data": { "$ref": "#/components/schemas/Data26" } } }, "ConnectorInstanceResponse": { "title": "ConnectorInstanceResponse", "required": [ "data" ], "type": "object", "properties": { "data": { "$ref": "#/components/schemas/ConnectorInstance" } } }, "ConnectorInstanceListResponse": { "title": "ConnectorInstanceListResponse", "required": [ "data" ], "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/ConnectorInstance" }, "description": "" } } }, "ConnectorInstance": { "title": "ConnectorInstance", "required": [ "type", "id", "attributes" ], "type": "object", "properties": { "type": { "enum": [ "connectorInstances" ], "type": "string", "example": "connectorInstances" }, "id": { "type": "string" }, "attributes": { "$ref": "#/components/schemas/Attributes39" } } }, "NetworkAssetListResponse": { "title": "NetworkAssetListResponse", "required": [ "data" ], "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/NetworkAsset" }, "description": "" }, "meta": { "$ref": "#/components/schemas/Meta" } } }, "NetworkAssetResponse": { "title": "NetworkAssetResponse", "required": [ "data" ], "type": "object", "properties": { "data": { "$ref": "#/components/schemas/NetworkAsset" } } }, "NetworkAssetCreateRequest": { "title": "NetworkAssetCreateRequest", "required": [ "data" ], "type": "object", "properties": { "data": { "$ref": "#/components/schemas/NetworkAsset" } }, "description": "Object used to create a new Network Asset" }, "NetworkAssetUpdateRequest": { "title": "NetworkAssetUpdateRequest", "required": [ "data" ], "type": "object", "properties": { "data": { "$ref": "#/components/schemas/NetworkAsset" } }, "description": "Object used to update an existing Network Asset" }, "NetworkAssetQueryContextSortEntry": { "title": "NetworkAssetQueryContextSortEntry", "required": [ "field" ], "type": "object", "properties": { "field": { "$ref": "#/components/schemas/Field1" }, "order": { "$ref": "#/components/schemas/Order" } } }, "NetworkAssetFilteredListRequest": { "title": "NetworkAssetFilteredListRequest", "type": "object", "properties": { "queryContext": { "$ref": "#/components/schemas/NetworkAssetQueryContext" }, "meta": { "type": "object", "additionalProperties": {}, "description": "An object that allows filtering on arbitrary metadata criteria and their values. The keys in the map are associated with metadata categories and the value array corresponds to a set of whitelist filter-in values for that category. The logical semantics associated with this structure are conditional-AND across metadata criteria (keys) and conditional-OR across the values contained within the value array. For example, {\"region\":[\"montreal\",\"ottawa\"], \"group\":[\"radio\"]} will match all records that are of group \"radio\" AND from the region \"montreal\" OR \"ottawa\"", "example": { "region": [ "montreal", "ottawa" ], "group": [ "radio" ] } }, "metaExclude": { "type": "array", "items": { "type": "string" }, "description": "An array that allows blacklisting one or more metadata criteria. Each key in the array must correspond to a given key in the MetaFilter portion of the request. This exclusion is a logical NOT for any values belonging to the metadata criteria listed in this request. For example, if the MetaFilter is: {\"region\":[\"montreal\",\"ottawa\"], \"group\":[\"radio\"]}, we can have a MetaExclude of the form [\"region\"]. This would result in a request that includes any records that are of group \"radio\" AND NOT in regions Ottawa or Montreal.", "example": [ "group" ] }, "ip": { "type": "array", "items": { "type": "string" }, "description": "An array of IPs" }, "mac": { "type": "array", "items": { "type": "string" }, "description": "An array of MACs" }, "roles": { "type": "array", "items": { "$ref": "#/components/schemas/NetworkAssetRole" }, "description": "An array of Roles" }, "firstSeen": { "$ref": "#/components/schemas/FirstSeen" }, "lastSeen": { "$ref": "#/components/schemas/LastSeen" } } }, "NetworkAssetFilteredCountResponse": { "title": "NetworkAssetFilteredCountResponse", "required": [ "data" ], "type": "object", "properties": { "data": { "$ref": "#/components/schemas/Data27" } }, "description": "Active Alert counts response" }, "NetworkAssetGroupByRequest": { "title": "NetworkAssetGroupByRequest", "type": "object", "properties": { "data": { "$ref": "#/components/schemas/Data28" } }, "description": "JSON API compliant wrapper for the groupby query" }, "NetworkAssetGroupByResponse": { "title": "NetworkAssetGroupByResponse", "type": "object", "properties": { "data": { "$ref": "#/components/schemas/Data29" } }, "description": "JSON API compliant wrapper for the groupby response" }, "NetworkAssetGroupByConfig": { "title": "NetworkAssetGroupByConfig", "required": [ "groupingContext", "networkAssets" ], "type": "object", "properties": { "queryContext": { "$ref": "#/components/schemas/NetworkAssetQueryContext" }, "metaContext": { "$ref": "#/components/schemas/MetaContext" }, "groupingContext": { "$ref": "#/components/schemas/GroupingContext" }, "aggregation": { "$ref": "#/components/schemas/SupportedAggregations" }, "networkAssets": { "type": "array", "items": { "$ref": "#/components/schemas/NetworkAssetSpec" }, "description": "A set of identifiers that considers specific network asset based on the provided information" } }, "description": "The necessary request parameters for the network asset api call" }, "NetworkAssetGroupedResultEntryParameters": { "title": "NetworkAssetGroupedResultEntryParameters", "required": [ "groupedResults" ], "type": "object", "properties": { "id": { "type": "array", "items": { "type": "string" }, "description": "IDs to filter on" }, "ip": { "type": "array", "items": { "type": "string" }, "description": "IPs to filter on" }, "roles": { "type": "array", "items": { "$ref": "#/components/schemas/NetworkAssetRole" }, "description": "Network Asset Roles to filter on" }, "groupedResults": { "type": "array", "items": { "$ref": "#/components/schemas/GroupedResult1" }, "description": "" } }, "description": "Describes filtering criteria used for a particular query that uses a grouping" }, "NetworkAssetQueryContext": { "title": "NetworkAssetQueryContext", "type": "object", "properties": { "timeout": { "type": "integer", "description": "Query timeout in milliseconds", "format": "int32", "example": 30000 }, "sortOnGroupingKey": { "type": "string", "description": "Allows a client to sort on a grouping key instead of the network asset's id", "default": "id", "example": "id" }, "sorted": { "$ref": "#/components/schemas/Sorted" }, "numResults": { "type": "integer", "description": "Number of results to return in grouped queries. A non-positive integer for this value implies there is no result limit. Only applicable to grouped queries.", "format": "int32", "example": 10 }, "pageNumber": { "type": "integer", "description": "Retrieve certain page of search results.", "format": "int32" }, "sort": { "type": "array", "items": { "$ref": "#/components/schemas/NetworkAssetQueryContextSortEntry" }, "description": "" } }, "description": "Hints indicating how the query may be Returns" }, "NetworkAssetSpec": { "title": "NetworkAssetSpec", "type": "object", "properties": { "id": { "type": "array", "items": { "type": "string" }, "description": "IDs to filter on" }, "ip": { "type": "array", "items": { "type": "string" }, "description": "IPs to filter on" }, "roles": { "type": "array", "items": { "$ref": "#/components/schemas/NetworkAssetRole" }, "description": "Network Asset Roles to filter on" } }, "description": "Filter object that identifies a specific metric within a monitored object by its key attributes" }, "NetworkAssetRole": { "title": "NetworkAssetRole", "required": [ "role" ], "type": "object", "properties": { "role": { "type": "string" }, "info": { "type": "string" }, "firstSeen": { "type": "integer", "format": "int64" }, "lastSeen": { "type": "integer", "format": "int64" } }, "description": "A role that a machine can take on based on heuristics" }, "NetworkAsset": { "title": "NetworkAsset", "required": [ "type", "attributes" ], "type": "object", "properties": { "type": { "enum": [ "networkAssets" ], "type": "string", "example": "networkAssets" }, "id": { "type": "string" }, "attributes": { "$ref": "#/components/schemas/Attributes40" } }, "description": "A network device that is on a customer's network" }, "DashboardCreateRequest": { "title": "DashboardCreateRequest", "required": [ "data" ], "type": "object", "properties": { "data": { "$ref": "#/components/schemas/Data30" } }, "description": "Object used to create a Dashboard in Datahub" }, "DashboardUpdateRequest": { "title": "DashboardUpdateRequest", "required": [ "data" ], "type": "object", "properties": { "data": { "$ref": "#/components/schemas/Data31" } }, "description": "Object used to update a Dashboard in Datahub" }, "DashboardResponse": { "title": "DashboardResponse", "required": [ "data" ], "type": "object", "properties": { "data": { "$ref": "#/components/schemas/Dashboard" } }, "description": "A single object Dashboard response from Datahub" }, "DashboardListResponse": { "title": "DashboardListResponse", "required": [ "data" ], "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/Dashboard" }, "description": "" } }, "description": "Response for one ore more Dashboards from Datahub" }, "Dashboard": { "title": "Dashboard", "required": [ "type", "id", "attributes" ], "type": "object", "properties": { "type": { "enum": [ "dashboards" ], "type": "string", "example": "dashboards" }, "id": { "type": "string" }, "relationships": { "$ref": "#/components/schemas/DashboardRelationships" }, "attributes": { "$ref": "#/components/schemas/Attributes45" } }, "description": "Represents a Dashboard used to display metric information on the Datahub UI" }, "CardPositions1": { "title": "CardPositions1", "required": [ "position" ], "type": "object", "properties": { "position": { "type": "integer", "description": "The placement order of this card on the Dashboard", "format": "int32" }, "dimensions": { "$ref": "#/components/schemas/Dimensions" } } }, "MetadataFilter": { "title": "MetadataFilter", "type": "object", "properties": { "key": { "type": "string" }, "values": { "type": "array", "items": { "type": "string" }, "description": "" } }, "description": "Used to obtain a list of Monitoreed Objects which will be useds to provide metric data to the Dashboard" }, "DashboardRelationships": { "title": "DashboardRelationships", "type": "object", "properties": { "cards": { "$ref": "#/components/schemas/JsonApiRelationship" }, "thresholdProfile": { "$ref": "#/components/schemas/JsonApiSingleRelationship" }, "editors": { "$ref": "#/components/schemas/JsonApiRelationship" }, "managers": { "$ref": "#/components/schemas/JsonApiRelationship" }, "createdBy": { "$ref": "#/components/schemas/JsonApiSingleRelationship" }, "viewers": { "$ref": "#/components/schemas/JsonApiRelationship" } } }, "CardCreateRequest": { "title": "CardCreateRequest", "required": [ "data" ], "type": "object", "properties": { "data": { "$ref": "#/components/schemas/Data32" } }, "description": "Object used to create a Card in Datahub" }, "CardUpdateRequest": { "title": "CardUpdateRequest", "required": [ "data" ], "type": "object", "properties": { "data": { "$ref": "#/components/schemas/Data33" } }, "description": "Object used to update a Card in Datahub" }, "CardResponse": { "title": "CardResponse", "required": [ "data" ], "type": "object", "properties": { "data": { "$ref": "#/components/schemas/Card" } }, "description": "A single object Card response from Datahub" }, "CardListResponse": { "title": "CardListResponse", "required": [ "data" ], "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/Card" }, "description": "" } }, "description": "Response for one ore more Cards from Datahub" }, "Card": { "title": "Card", "required": [ "type", "id", "attributes" ], "type": "object", "properties": { "type": { "enum": [ "cards" ], "type": "string", "example": "cards" }, "id": { "type": "string" }, "attributes": { "$ref": "#/components/schemas/Attributes48" } }, "description": "Models a single Card used by Dashboards in the Datahub UI" }, "CardVisualization": { "title": "CardVisualization", "type": "object", "properties": { "key": { "type": "string", "description": "Label referencing the type of visualization to be displayed" }, "label": { "type": "string", "description": "User provided identifier for a Visualization" }, "category": { "type": "string" }, "icon": { "type": "string" }, "component": { "type": "string" }, "queryParams": { "$ref": "#/components/schemas/QueryParams" }, "availability": { "$ref": "#/components/schemas/Availability" }, "defaultDimensions": { "$ref": "#/components/schemas/DefaultDimensions" } } }, "CardMetric": { "title": "CardMetric", "type": "object", "properties": { "key": { "type": "string" }, "label": { "type": "string" }, "vendorLabel": { "type": "string" }, "vendorKey": { "type": "string" }, "vendor": { "type": "string" }, "objectType": { "type": "string" }, "unit": { "type": "string" }, "type": { "type": "string" }, "rawMetricId": { "type": "string" }, "metric": { "type": "string" }, "metricKey": { "type": "string" }, "enabled": { "type": "boolean" }, "monitoredObjectTypes": { "type": "array", "items": { "type": "string" }, "description": "" }, "directions": { "type": "array", "items": { "type": "string" }, "description": "" }, "units": { "type": "array", "items": { "type": "string" }, "description": "" }, "options": { "$ref": "#/components/schemas/Options" } } }, "DataCleaningProfileCreateRequest": { "title": "DataCleaningProfileCreateRequest", "required": [ "data" ], "type": "object", "properties": { "data": { "$ref": "#/components/schemas/Data34" } }, "description": "Object used to create a Data Cleaning Profile in Datahub" }, "DataCleaningProfileUpdateRequest": { "title": "DataCleaningProfileUpdateRequest", "required": [ "data" ], "type": "object", "properties": { "data": { "$ref": "#/components/schemas/Data35" } }, "description": "Object used to update a Data Cleaning Profile in Datahub" }, "DataCleaningRule": { "title": "DataCleaningRule", "required": [ "metricVendor", "metricLabel", "triggerCondition", "clearCondition" ], "type": "object", "properties": { "metricVendor": { "type": "string", "description": "The name of the vendor which provides the metric used in the rule." }, "metricLabel": { "type": "string", "description": "The name of the metric used in the rule." }, "triggerCondition": { "$ref": "#/components/schemas/DataCleaningCondition" }, "clearCondition": { "$ref": "#/components/schemas/DataCleaningCondition" } }, "description": "Provides the logic used to determine when data should be ommitted from queries" }, "DataCleaningCondition": { "title": "DataCleaningCondition", "required": [ "comparator", "value", "valueAggregate", "duration" ], "type": "object", "properties": { "comparator": { "$ref": "#/components/schemas/Comparator2" }, "value": { "type": "string", "description": "The value against which the selected metric will be compared." }, "valueAggregate": { "$ref": "#/components/schemas/ValueAggregate" }, "duration": { "type": "string", "description": "ISO-8601 interval over which this codition will be evaluated." } }, "description": "A condition used to evalutate when a data cleaning rule should be triggered or cleared." }, "DataCleaningProfileResponse": { "title": "DataCleaningProfileResponse", "required": [ "data" ], "type": "object", "properties": { "data": { "$ref": "#/components/schemas/DataCleaningProfile" } }, "description": "A single object Data Cleaning Profile response from Datahub" }, "DataCleaningProfileListResponse": { "title": "DataCleaningProfileListResponse", "required": [ "data" ], "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/DataCleaningProfile" }, "description": "" } }, "description": "Response for one ore more Data Cleaning Profiles from Datahub" }, "DataCleaningProfile": { "title": "DataCleaningProfile", "required": [ "type", "id", "attributes" ], "type": "object", "properties": { "type": { "enum": [ "dataCleaningProfiles" ], "type": "string", "example": "dataCleaningProfiles" }, "id": { "type": "string" }, "attributes": { "$ref": "#/components/schemas/Attributes51" } } }, "DataCleaningHistoryResponse": { "title": "DataCleaningHistoryResponse", "required": [ "data" ], "type": "object", "properties": { "data": { "$ref": "#/components/schemas/DataCleaningHistory" } } }, "DataCleaningHistory": { "title": "DataCleaningHistory", "required": [ "type", "id", "attributes" ], "type": "object", "properties": { "type": { "enum": [ "dataCleaningHistory" ], "type": "string", "example": "dataCleaningHistory" }, "id": { "type": "string" }, "attributes": { "$ref": "#/components/schemas/Attributes52" } } }, "DataCleaningTransition": { "title": "DataCleaningTransition", "type": "object", "properties": { "timestamp": { "type": "integer", "description": "Time since epoch at which these transitions occurred.", "format": "int64" }, "rulesRaised": { "type": "array", "items": { "$ref": "#/components/schemas/DataCleaningTransitionRule" }, "description": "" }, "rulesCleared": { "type": "array", "items": { "$ref": "#/components/schemas/DataCleaningTransitionRule" }, "description": "" }, "errorsRaised": { "type": "array", "items": { "$ref": "#/components/schemas/DataCleaningTransitionError" }, "description": "" }, "errorsCleared": { "type": "array", "items": { "$ref": "#/components/schemas/DataCleaningTransitionError" }, "description": "" } } }, "DataCleaningTransitionRule": { "title": "DataCleaningTransitionRule", "type": "object", "properties": { "direction": { "type": "string" }, "rule": { "$ref": "#/components/schemas/DataCleaningRule" } } }, "DataCleaningTransitionError": { "title": "DataCleaningTransitionError", "type": "object", "properties": { "direction": { "type": "string" }, "errorCode": { "type": "string" } } }, "IngestionProfileCreateRequest": { "title": "IngestionProfileCreateRequest", "required": [ "data" ], "type": "object", "properties": { "data": { "$ref": "#/components/schemas/Data36" } }, "description": "Object used to create an Ingestion Profile in Datahub" }, "IngestionProfileUpdateRequest": { "title": "IngestionProfileUpdateRequest", "required": [ "data" ], "type": "object", "properties": { "data": { "$ref": "#/components/schemas/Data37" } }, "description": "Object used to update an Ingestion Profile in Datahub" }, "IngestionProfileListResponse": { "title": "IngestionProfileListResponse", "required": [ "data" ], "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/IngestionProfile" }, "description": "" } }, "description": "Ingestion Profile response including one or more values" }, "IngestionProfileResponse": { "title": "IngestionProfileResponse", "required": [ "data" ], "type": "object", "properties": { "data": { "$ref": "#/components/schemas/IngestionProfile" } }, "description": "A single object Ingestion Profile response from Datahub" }, "IngestionProfile": { "title": "IngestionProfile", "required": [ "type", "id", "attributes" ], "type": "object", "properties": { "type": { "enum": [ "ingestionProfiles" ], "type": "string", "example": "ingestionProfiles" }, "id": { "type": "string" }, "attributes": { "$ref": "#/components/schemas/Attributes55" } } }, "IngestionProfileMetrics": { "title": "IngestionProfileMetrics", "type": "object", "properties": { "vendorMap": { "type": "object", "additionalProperties": { "$ref": "#/components/schemas/VendorMap" } } }, "description": "This object will be deprecated in a future version of the Datahub API" }, "IngestionProfileMetricListItem": { "title": "IngestionProfileMetricListItem", "type": "object", "properties": { "vendor": { "type": "string", "description": "The name of the Vendor from which this Metric originates" }, "monitoredObjectType": { "type": "string", "description": "The name of the type of Monitored Object for which this Metric is applicable" }, "metric": { "type": "string", "description": "The name of the Metric" }, "enabled": { "type": "boolean", "description": "When true, this metric will be recorded by Datahub. When false, this metric is ommitted." }, "direction": { "type": "string", "description": "Describes the direction of the test in case a Threshold needs to be different for one direction (i.e. actuator to reflector) versus another (i.e. round trip)" }, "dimensions": { "type": "object", "description": "Provides data properties by which the Metric may be filtered and/or aggregated" } }, "description": "Provides customization on which Metrics will be available to query from Datahub" }, "MetadataConfigCreateRequest": { "title": "MetadataConfigCreateRequest", "required": [ "data" ], "type": "object", "properties": { "data": { "$ref": "#/components/schemas/Data38" } }, "description": "Object used to create a Metadata Configuration in Datahub" }, "MetadataConfigUpdateRequest": { "title": "MetadataConfigUpdateRequest", "required": [ "data" ], "type": "object", "properties": { "data": { "$ref": "#/components/schemas/Data39" } }, "description": "Object used to update a Metadata Configuration in Datahub" }, "MetadataConfigListResponse": { "title": "MetadataConfigListResponse", "required": [ "data" ], "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/MetadataConfig" }, "description": "" } }, "description": "Metadata Configuration response including one or more values" }, "MetadataConfigResponse": { "title": "MetadataConfigResponse", "required": [ "data" ], "type": "object", "properties": { "data": { "$ref": "#/components/schemas/MetadataConfig" } }, "description": "A single object Metadata Configuration response from Datahub" }, "MetadataConfig": { "title": "MetadataConfig", "required": [ "type", "id", "attributes" ], "type": "object", "properties": { "type": { "enum": [ "metadataConfigs" ], "type": "string", "example": "metadataConfigs" }, "id": { "type": "string" }, "attributes": { "$ref": "#/components/schemas/Attributes58" } } }, "MetadataConfigGeo": { "title": "MetadataConfigGeo", "type": "object", "properties": { "startPoint": { "$ref": "#/components/schemas/GeoDetails" }, "endPoint": { "$ref": "#/components/schemas/GeoDetails" } }, "description": "The geographical location information for nodes on the logical map" }, "GeoDetails": { "title": "GeoDetails", "required": [ "latitude", "longitude" ], "type": "object", "properties": { "latitude": { "type": "string" }, "longitude": { "type": "string" } } }, "MetricBaselineData": { "title": "MetricBaselineData", "type": "object", "properties": { "metric": { "type": "string", "description": "The name of the metric represented by this baseline" }, "direction": { "type": "string", "description": "The direction of the metric baseline" }, "average": { "type": "number", "description": "The calculated average of the Metric obtained via (sum/count)" } } }, "MetricBaseline": { "title": "MetricBaseline", "required": [ "type", "id", "attributes" ], "type": "object", "properties": { "type": { "enum": [ "metricBaselines" ], "type": "string", "example": "metricBaselines" }, "id": { "type": "string" }, "attributes": { "$ref": "#/components/schemas/Attributes59" } } }, "MetricBaselineResponse": { "title": "MetricBaselineResponse", "required": [ "data" ], "type": "object", "properties": { "data": { "$ref": "#/components/schemas/MetricBaseline" } }, "description": "A Metric Baseline response from Datahub" }, "MetricBaselineListResponse": { "title": "MetricBaselineListResponse", "required": [ "data" ], "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/MetricBaseline" }, "description": "" } }, "description": "Metric Baseline response including one or more values" }, "MetricBaselineDataWrapper": { "title": "MetricBaselineDataWrapper", "required": [ "type", "attributes" ], "type": "object", "properties": { "type": { "enum": [ "metricBaselineData" ], "type": "string", "example": "metricBaselineData" }, "id": { "type": "string" }, "attributes": { "$ref": "#/components/schemas/MetricBaselineData" } } }, "DuplicateMonitoredObjectReportResponse": { "title": "DuplicateMonitoredObjectReportResponse", "required": [ "data" ], "type": "object", "properties": { "data": { "$ref": "#/components/schemas/DuplicateMonitoredObjectReport" } } }, "DuplicateMonitoredObjectReportListResponse": { "title": "DuplicateMonitoredObjectReportListResponse", "required": [ "data" ], "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/DuplicateMonitoredObjectReport" }, "description": "" } } }, "DuplicateMonitoredObjectReport": { "title": "DuplicateMonitoredObjectReport", "required": [ "type", "id", "attributes" ], "type": "object", "properties": { "type": { "enum": [ "duplicateMonitoredObjectReport" ], "type": "string", "example": "duplicateMonitoredObjectReport" }, "id": { "type": "string" }, "attributes": { "$ref": "#/components/schemas/Attributes60" } } }, "MonitoredObjectTagMappingCreateRequest": { "title": "MonitoredObjectTagMappingCreateRequest", "required": [ "data" ], "type": "object", "properties": { "data": { "$ref": "#/components/schemas/Data40" } }, "description": "Object used to create a MonitoredObjectTagMapping in Datahub" }, "MonitoredObjectTagMappingUpdateRequest": { "title": "MonitoredObjectTagMappingUpdateRequest", "required": [ "data" ], "type": "object", "properties": { "data": { "$ref": "#/components/schemas/Data41" } }, "description": "Object used to update a MonitoredObjectTagMapping in Datahub" }, "MonitoredObjectTagMappingResponse": { "title": "MonitoredObjectTagMappingResponse", "required": [ "data" ], "type": "object", "properties": { "data": { "$ref": "#/components/schemas/MonitoredObjectTagMapping" } }, "description": "A single object MonitoredObjectTagMapping response from Datahub" }, "MonitoredObjectTagMappingListResponse": { "title": "MonitoredObjectTagMappingListResponse", "required": [ "data" ], "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/MonitoredObjectTagMapping" }, "description": "" } }, "description": "Response for one ore more MonitoredObjectTagMappings from Datahub" }, "MonitoredObjectTagMapping": { "title": "MonitoredObjectTagMapping", "required": [ "type", "id", "attributes" ], "type": "object", "properties": { "type": { "enum": [ "monitoredObjectTagMappings" ], "type": "string", "example": "monitoredObjectTagMappings" }, "id": { "type": "string" }, "attributes": { "$ref": "#/components/schemas/Attributes63" } }, "description": "Represents a MonitoredObjectTagMapping used to group a list of Monitored Object Ids to an ad-hoc value" }, "MonitoredObjectCreateRequest": { "title": "MonitoredObjectCreateRequest", "required": [ "data" ], "type": "object", "properties": { "data": { "$ref": "#/components/schemas/MonitoredObjectCreate" } }, "description": "Object used to create a new Monitored Object in Datahub" }, "MonitoredObjectUpdateRequest": { "title": "MonitoredObjectUpdateRequest", "required": [ "data" ], "type": "object", "properties": { "data": { "$ref": "#/components/schemas/MonitoredObjectUpdate" } }, "description": "Object used to update an existing Monitored Object in Datahub" }, "MonitoredObjectListResponse": { "title": "MonitoredObjectListResponse", "required": [ "data" ], "type": "object", "properties": { "links": { "type": "object", "additionalProperties": { "type": "string" } }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/MonitoredObject" }, "description": "" } }, "description": "Monitoerd Object response including one or more values" }, "MonitoredObjectResponse": { "title": "MonitoredObjectResponse", "required": [ "data" ], "type": "object", "properties": { "links": { "type": "object", "additionalProperties": { "type": "string" } }, "data": { "$ref": "#/components/schemas/MonitoredObject" } }, "description": "A single object Monitored Object response from Datahub" }, "MonitoredObject": { "title": "MonitoredObject", "required": [ "type", "id", "attributes" ], "type": "object", "properties": { "type": { "enum": [ "monitoredObjects" ], "type": "string", "example": "monitoredObjects" }, "id": { "type": "string" }, "attributes": { "$ref": "#/components/schemas/Attributes66" } } }, "BulkOperationResponseV2": { "title": "BulkOperationResponseV2", "required": [ "data" ], "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/Data42" }, "description": "" } } }, "BulkMonitoredObjectCreateRequest": { "title": "BulkMonitoredObjectCreateRequest", "required": [ "data" ], "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/MonitoredObjectCreate" }, "description": "" } }, "description": "Object used to create one or more Monitored Object in Datahub" }, "MonitoredObjectCreate": { "title": "MonitoredObjectCreate", "required": [ "type", "attributes" ], "type": "object", "properties": { "type": { "enum": [ "monitoredObjects" ], "type": "string", "example": "monitoredObjects" }, "id": { "type": "string" }, "attributes": { "$ref": "#/components/schemas/Attributes64" } } }, "BulkMonitoredObjectMetaCreateRequest": { "title": "BulkMonitoredObjectMetaCreateRequest", "required": [ "data" ], "type": "object", "properties": { "data": { "$ref": "#/components/schemas/Data43" } }, "description": "Object used to update the meta information for one or more Monitored Objects in Datahub" }, "BulkMonitoredObjectPatchRequest": { "title": "BulkMonitoredObjectPatchRequest", "required": [ "data" ], "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/MonitoredObjectPatch" }, "description": "" } }, "description": "Patch the names for Monitored Objects in Datahub" }, "BulkMonitoredObjectUpdateRequest": { "title": "BulkMonitoredObjectUpdateRequest", "required": [ "data" ], "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/MonitoredObjectUpdate" }, "description": "" } }, "description": "Object used to update one or more Monitored Objects in Datahub" }, "MonitoredObjectFilteredListRequest": { "title": "MonitoredObjectFilteredListRequest", "type": "object", "properties": { "objectNamePrefix": { "type": "string" }, "objectType": { "type": "array", "items": { "type": "string" }, "description": "" }, "meta": { "type": "object", "additionalProperties": {}, "description": "An object that allows filtering on arbitrary metadata criteria and their values. The keys in the map are associated with metadata categories and the value array corresponds to a set of whitelist filter-in values for that category. The logical semantics associated with this structure are conditional-AND across metadata criteria (keys) and conditional-OR across the values contained within the value array. For example, {\"region\":[\"montreal\",\"ottawa\"], \"group\":[\"radio\"]} will match all records that are of group \"radio\" AND from the region \"montreal\" OR \"ottawa\"", "example": { "region": [ "montreal", "ottawa" ], "group": [ "radio" ] } }, "metaExclude": { "type": "array", "items": { "type": "string" }, "description": "An array that allows blacklisting one or more metadata criteria. Each key in the array must correspond to a given key in the MetaFilter portion of the request. This exclusion is a logical NOT for any values belonging to the metadata criteria listed in this request. For example, if the MetaFilter is: {\"region\":[\"montreal\",\"ottawa\"], \"group\":[\"radio\"]}, we can have a MetaExclude of the form [\"region\"]. This would result in a request that includes any records that are of group \"radio\" AND NOT in regions Ottawa or Montreal.", "example": [ "group" ] }, "archiveTimestamp": { "$ref": "#/components/schemas/TimeRange" }, "createdTimestamp": { "$ref": "#/components/schemas/TimeRange" }, "sourceLocation": { "$ref": "#/components/schemas/GeoFence" }, "destinationLocation": { "$ref": "#/components/schemas/GeoFence" }, "topology": { "type": "array", "items": { "type": "string" }, "description": "" } } }, "GeoFence": { "title": "GeoFence", "type": "object", "properties": { "box": { "$ref": "#/components/schemas/Box" } } }, "TimeRange": { "title": "TimeRange", "type": "object", "properties": { "before": { "type": "integer", "format": "int32" }, "after": { "type": "integer", "format": "int32" }, "absent": { "type": "boolean" } }, "description": "A time range specified by before and after in epoch time. Both before and after are inclusive to the specified value." }, "MonitoredObjectFilteredCountResponse": { "title": "MonitoredObjectFilteredCountResponse", "required": [ "data" ], "type": "object", "properties": { "data": { "$ref": "#/components/schemas/MonitoredObjectFilteredCount" } } }, "MonitoredObjectFilteredCount": { "title": "MonitoredObjectFilteredCount", "required": [ "type", "attributes" ], "type": "object", "properties": { "id": { "type": "string" }, "type": { "enum": [ "filteredMonitoredObjectCount" ], "type": "string", "example": "filteredMonitoredObjectCount" }, "attributes": { "$ref": "#/components/schemas/Attributes70" } } }, "MonitoredObjectFilteredListResponse": { "title": "MonitoredObjectFilteredListResponse", "required": [ "data" ], "type": "object", "properties": { "data": { "$ref": "#/components/schemas/MonitoredObjectFilteredList" } } }, "MonitoredObjectFilteredList": { "title": "MonitoredObjectFilteredList", "required": [ "type", "attributes" ], "type": "object", "properties": { "id": { "type": "string" }, "type": { "enum": [ "filteredResourceIdentifierList" ], "type": "string", "example": "filteredResourceIdentifierList" }, "attributes": { "$ref": "#/components/schemas/Attributes71" } } }, "MonitoredObjectMetadataDetailsListResponse": { "title": "MonitoredObjectMetadataDetailsListResponse", "required": [ "data" ], "type": "object", "properties": { "data": { "$ref": "#/components/schemas/MonitoredObjectMetadataDetailsList" } } }, "MonitoredObjectMetadataDetailsList": { "title": "MonitoredObjectMetadataDetailsList", "required": [ "type", "attributes" ], "type": "object", "properties": { "id": { "type": "string" }, "type": { "enum": [ "monitoredObjectMetadataDetails" ], "type": "string", "example": "monitoredObjectMetadataDetails" }, "attributes": { "$ref": "#/components/schemas/Attributes72" } } }, "MonitoredObjectGeoClusterResponse": { "title": "MonitoredObjectGeoClusterResponse", "required": [ "data" ], "type": "object", "properties": { "data": { "$ref": "#/components/schemas/MonitoredObjectGeoClusters" } } }, "MonitoredObjectGeoClusters": { "title": "MonitoredObjectGeoClusters", "type": "object", "properties": { "id": { "type": "string" }, "type": { "$ref": "#/components/schemas/Type30" }, "attributes": { "$ref": "#/components/schemas/Attributes73" } } }, "MonitoredObjectPatch": { "title": "MonitoredObjectPatch", "required": [ "type", "id", "attributes" ], "type": "object", "properties": { "type": { "enum": [ "monitoredObjects" ], "type": "string", "example": "monitoredObjects" }, "id": { "type": "string" }, "attributes": { "$ref": "#/components/schemas/Attributes69" } } }, "MonitoredObjectUpdate": { "title": "MonitoredObjectUpdate", "required": [ "type", "id", "attributes" ], "type": "object", "properties": { "type": { "enum": [ "monitoredObjects" ], "type": "string", "example": "monitoredObjects" }, "id": { "type": "string" }, "attributes": { "$ref": "#/components/schemas/Attributes65" } } }, "MonitoredObjectSummaryListResponse": { "title": "MonitoredObjectSummaryListResponse", "required": [ "data" ], "type": "object", "properties": { "links": { "type": "object", "additionalProperties": { "type": "string" } }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/MonitoredObjectSummary" }, "description": "" } }, "description": "Monitoerd Object Summary response including one or more values" }, "MonitoredObjectSummaryResponse": { "title": "MonitoredObjectSummaryResponse", "required": [ "data" ], "type": "object", "properties": { "links": { "type": "object", "additionalProperties": { "type": "string" } }, "data": { "$ref": "#/components/schemas/MonitoredObjectSummary" } }, "description": "A single object Monitored Object Summary response from Datahub" }, "MonitoredObjectSummary": { "title": "MonitoredObjectSummary", "required": [ "type", "id", "attributes" ], "type": "object", "properties": { "type": { "enum": [ "monitoredObjectSummaries" ], "type": "string", "example": "monitoredObjectSummaries" }, "id": { "type": "string" }, "attributes": { "$ref": "#/components/schemas/Attributes74" } }, "description": "Provides a trimmed down and modified version of a monitored object. Used for providing provisioning details to Datahub processing applications" }, "MonitoredObjectMetadataCategoryMappingListResponse": { "title": "MonitoredObjectMetadataCategoryMappingListResponse", "required": [ "data" ], "type": "object", "properties": { "links": { "type": "object", "additionalProperties": { "type": "string" } }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/MetadataCategoryMapping" }, "description": "" } }, "description": "Monitoerd Object Metadata Category Mapping response including one or more values" }, "MonitoredObjectMetadataCategoryMappingResponse": { "title": "MonitoredObjectMetadataCategoryMappingResponse", "required": [ "data" ], "type": "object", "properties": { "links": { "type": "object", "additionalProperties": { "type": "string" } }, "data": { "$ref": "#/components/schemas/MetadataCategoryMapping" } }, "description": "A single object Monitored Object Metadata Category Mapping response from Datahub" }, "MetadataCategoryMapping": { "title": "MetadataCategoryMapping", "required": [ "type", "id", "attributes" ], "type": "object", "properties": { "type": { "enum": [ "metadataCategoryMapping" ], "type": "string", "example": "metadataCategoryMapping" }, "id": { "type": "string" }, "attributes": { "$ref": "#/components/schemas/Attributes75" } }, "description": "Provides a mapping of Metadata Category name mappings to the Customer facing aliases" }, "MetadataAlias": { "title": "MetadataAlias", "required": [ "name", "isActive", "activeRangeMap" ], "type": "object", "properties": { "name": { "type": "string", "description": "The customer provided alias name for the Metadata Category" }, "isActive": { "type": "boolean", "description": "Boolean flag indicating if this Metadata Category Alias is currently being used (true) or if it is no longer an active Metadata Category (false)" }, "activeRangeMap": { "type": "object", "additionalProperties": { "type": "integer", "format": "int64" }, "description": "A mapping of start timestamp to end timestamp ranges when this particular Metadata Mapping Alias was active." } }, "description": "Properties of an alias used for Monitored Object Metadata storade in Datahub" }, "MetadataCategoryMappingUpdateRequest": { "title": "MetadataCategoryMappingUpdateRequest", "required": [ "data" ], "type": "object", "properties": { "data": { "$ref": "#/components/schemas/Data44" } }, "description": "Object used to update a Metadata Category Mapping for a Tenant in Datahub" }, "MetadataRenameData": { "title": "MetadataRenameData", "required": [ "existingName", "newName" ], "type": "object", "properties": { "existingName": { "type": "string", "description": "The current alias name of a Metadata Category Mapping to be changed" }, "newName": { "type": "string", "description": "The desired alias name of a Metadata Category Mapping to be changed" } }, "description": "Object providing Metadata Category Mapping alias name change information" }, "MonitoredObjectLocation": { "title": "MonitoredObjectLocation", "required": [ "lat", "lon" ], "type": "object", "properties": { "lat": { "type": "number", "description": "Geographic latitude" }, "lon": { "type": "number", "description": "Geographic longitude" } }, "description": "Defines the geographical location of the Monitored Object" }, "MonitoredObjectReportingListRequest": { "title": "MonitoredObjectReportingListRequest", "type": "object", "properties": { "reportingObjects": { "type": "boolean", "description": "If true, the result will be a list of ids for monitored objects that are reporting. If false, the returned list will be monitored objects that are not reporting", "default": true }, "numberOfDays": { "maximum": 31.0, "minimum": 1.0, "type": "number", "description": "Number of days, from current time, to look in the past to determine if the Monitored Objects are reporting", "default": 7 } }, "description": "Contains the parameters related to fetching a list of reporting Monitored Object IDs for a given timeframe" }, "JsonApiAlertGroupByRequest": { "title": "JsonApiAlertGroupByRequest", "type": "object", "properties": { "data": { "$ref": "#/components/schemas/Data45" } }, "description": "JSON API compliant wrapper for the groupby query" }, "JsonApiAlertGroupByResponse": { "title": "JsonApiAlertGroupByResponse", "type": "object", "properties": { "data": { "$ref": "#/components/schemas/Data46" } }, "description": "JSON API compliant wrapper for the groupby response" }, "AlertQueryContext": { "title": "AlertQueryContext", "type": "object", "properties": { "groupNull": { "type": "boolean", "description": "When doing a group by, there are columns with no value associated with the metadata key supplied. By default, we ignore these rows but in certain use-cases, it is advantageous to group all the records not in the set as a new value.", "default": false }, "ignoreCleaning": { "type": "boolean", "description": "A value of true will have the aggregation request execute on all data regardless of whether it has been cleaned or not" }, "timeout": { "type": "integer", "description": "Query timeout in milliseconds", "format": "int32", "example": 30000 }, "sortOnGroupingKey": { "type": "string", "description": "Allows a client to sort on a grouping key instead of the metric's value", "default": "metric", "example": "startTimestamp" }, "sorted": { "$ref": "#/components/schemas/Sorted" }, "numResults": { "type": "integer", "description": "Number of results to return in grouped queries. A non-positive integer for this value implies there is no result limit. Only applicable to grouped queries.", "format": "int32", "example": 10 } }, "description": "Hints indicating how the query may be Returns" }, "AlertGroupByConfig": { "title": "AlertGroupByConfig", "required": [ "groupingContext", "interval", "aggregation", "metrics" ], "type": "object", "properties": { "queryContext": { "$ref": "#/components/schemas/AlertQueryContext" }, "metaContext": { "$ref": "#/components/schemas/MetaContext" }, "groupingContext": { "$ref": "#/components/schemas/GroupingContext" }, "interval": { "type": "string", "description": "Time boundary for the metrics under consideration using the ISO-8601 standard", "example": "2018-04-08T14:00:00/2018-04-09T15:00:00" }, "aggregation": { "$ref": "#/components/schemas/SupportedAggregations" }, "metrics": { "type": "array", "items": { "$ref": "#/components/schemas/AlertSpec" }, "description": "A set of identifiers that considers specific metrics based on the provided information" } }, "description": "The necessary request parameters for the metric api call" }, "AlertGroupedResultEntryParameters": { "title": "AlertGroupedResultEntryParameters", "required": [ "groupedResults" ], "type": "object", "properties": { "policyId": { "type": "array", "items": { "type": "string" }, "description": "Policy ID to filter on" }, "policyType": { "type": "array", "items": { "$ref": "#/components/schemas/PolicyType1" }, "description": "Hint to the query engine to limit the metric to certain types of entity." }, "alertState": { "type": "array", "items": { "type": "string" }, "description": "Set of one or more alert state to be used by the filter", "example": [ "raised", "cleared" ] }, "metric": { "type": "array", "items": { "type": "string" }, "description": "Name that identifies the specific metric within a monitored object", "example": [ "delayp95", "hit.rtt.per_sec" ] }, "uid": { "type": "array", "items": { "type": "string" }, "description": "Filter on Alert UID.", "example": [ "111111111" ] }, "startTimestamp": { "type": "array", "items": { "type": "integer", "format": "int64" }, "description": "Start Timestamp to filter on" }, "captureSpec": { "type": "object", "additionalProperties": {} }, "objectType": { "type": "array", "items": { "type": "string" }, "description": "Object types to be considered as part of the filter", "example": [ "twamp-sl", "flowmeter" ] }, "direction": { "type": "array", "items": { "type": "string" }, "description": "Set of one or more directions to be used by the filter to identify required metric records", "example": [ "0", "1" ] }, "geoSpatial": { "$ref": "#/components/schemas/SpatialFilter" }, "sourceLocation": { "$ref": "#/components/schemas/SpatialFilter" }, "destinationLocation": { "$ref": "#/components/schemas/SpatialFilter" }, "topology": { "type": "string", "description": "Name of a node on the route of the Monitored Object" }, "valueBoundary": { "$ref": "#/components/schemas/MetricBucket" }, "objectId": { "type": "array", "items": { "type": "string" }, "description": "Set of object IDs to filter on", "example": [ "333732dc-99d4-4224-915e-3972b50d10ef", "931e7d13-6320-4ad7-ae06-7ff2df4f782a" ] }, "captureClientZoneId": { "type": "array", "items": { "type": "string" }, "description": "" }, "captureServerZoneId": { "type": "array", "items": { "type": "string" }, "description": "" }, "severity": { "type": "array", "items": { "type": "string" }, "description": "" }, "sourceIp": { "type": "array", "items": { "type": "string" }, "description": "" }, "destinationIp": { "type": "array", "items": { "type": "string" }, "description": "" }, "killchain": { "type": "array", "items": { "type": "string" }, "description": "" }, "securityJobType": { "type": "array", "items": { "type": "string" }, "description": "" }, "sourceNetworkAssetRoles": { "type": "array", "items": { "type": "string" }, "description": "" }, "destinationNetworkAssetRoles": { "type": "array", "items": { "type": "string" }, "description": "" }, "groupedResults": { "type": "array", "items": { "$ref": "#/components/schemas/GroupedResult1" }, "description": "" } }, "description": "Describes filtering criteria used for a particular query that uses a grouping" }, "JsonApiAlertAggregateRequest": { "title": "JsonApiAlertAggregateRequest", "type": "object", "properties": { "data": { "$ref": "#/components/schemas/Data47" } }, "description": "JSON API compliant wrapper for the aggregate query" }, "JsonApiAlertAggregateResponse": { "title": "JsonApiAlertAggregateResponse", "type": "object", "properties": { "data": { "$ref": "#/components/schemas/Data48" } }, "description": "JSON API compliant wrapper for the aggregate response" }, "V2AlertAggregateConfig": { "title": "V2AlertAggregateConfig", "required": [ "interval", "granularity", "aggregation", "metrics" ], "type": "object", "properties": { "queryContext": { "$ref": "#/components/schemas/QueryContext" }, "metaContext": { "$ref": "#/components/schemas/MetaContext" }, "interval": { "type": "string", "description": "Time boundary for the metrics under consideration using the ISO-8601 standard", "example": "2018-04-08T14:00:00/2018-04-09T15:00:00" }, "granularity": { "type": "string", "description": "the granularity for timeseries in ISO-8601 duration format, or ALL", "example": "PT1H" }, "aggregation": { "$ref": "#/components/schemas/SupportedAggregations" }, "metrics": { "type": "array", "items": { "$ref": "#/components/schemas/AlertSpec" }, "description": "A set of identifiers that considers specific metrics based on the provided information" } }, "description": "The necessary request parameters for the metric api call" }, "alertTimeseriesResult": { "title": "alertTimeseriesResult", "required": [ "series" ], "type": "object", "properties": { "policyId": { "type": "array", "items": { "type": "string" }, "description": "Policy ID to filter on" }, "policyType": { "type": "array", "items": { "$ref": "#/components/schemas/PolicyType1" }, "description": "Hint to the query engine to limit the metric to certain types of entity." }, "alertState": { "type": "array", "items": { "type": "string" }, "description": "Set of one or more alert state to be used by the filter", "example": [ "raised", "cleared" ] }, "metric": { "type": "array", "items": { "type": "string" }, "description": "Name that identifies the specific metric within a monitored object", "example": [ "delayp95", "hit.rtt.per_sec" ] }, "uid": { "type": "array", "items": { "type": "string" }, "description": "Filter on Alert UID.", "example": [ "111111111" ] }, "startTimestamp": { "type": "array", "items": { "type": "integer", "format": "int64" }, "description": "Start Timestamp to filter on" }, "captureSpec": { "type": "object", "additionalProperties": {} }, "objectType": { "type": "array", "items": { "type": "string" }, "description": "Object types to be considered as part of the filter", "example": [ "twamp-sl", "flowmeter" ] }, "direction": { "type": "array", "items": { "type": "string" }, "description": "Set of one or more directions to be used by the filter to identify required metric records", "example": [ "0", "1" ] }, "geoSpatial": { "$ref": "#/components/schemas/SpatialFilter" }, "sourceLocation": { "$ref": "#/components/schemas/SpatialFilter" }, "destinationLocation": { "$ref": "#/components/schemas/SpatialFilter" }, "topology": { "type": "string", "description": "Name of a node on the route of the Monitored Object" }, "valueBoundary": { "$ref": "#/components/schemas/MetricBucket" }, "objectId": { "type": "array", "items": { "type": "string" }, "description": "Set of object IDs to filter on", "example": [ "333732dc-99d4-4224-915e-3972b50d10ef", "931e7d13-6320-4ad7-ae06-7ff2df4f782a" ] }, "captureClientZoneId": { "type": "array", "items": { "type": "string" }, "description": "" }, "captureServerZoneId": { "type": "array", "items": { "type": "string" }, "description": "" }, "severity": { "type": "array", "items": { "type": "string" }, "description": "" }, "sourceIp": { "type": "array", "items": { "type": "string" }, "description": "" }, "destinationIp": { "type": "array", "items": { "type": "string" }, "description": "" }, "killchain": { "type": "array", "items": { "type": "string" }, "description": "" }, "securityJobType": { "type": "array", "items": { "type": "string" }, "description": "" }, "sourceNetworkAssetRoles": { "type": "array", "items": { "type": "string" }, "description": "" }, "destinationNetworkAssetRoles": { "type": "array", "items": { "type": "string" }, "description": "" }, "series": { "type": "array", "items": { "$ref": "#/components/schemas/MetricTimeseriesResultEntry" }, "description": "" } }, "description": "Describes series data prefixed with the filter criteria that were used to generate the output" }, "AlertSpec": { "title": "AlertSpec", "type": "object", "properties": { "policyId": { "type": "array", "items": { "type": "string" }, "description": "Policy ID to filter on" }, "policyType": { "type": "array", "items": { "$ref": "#/components/schemas/PolicyType1" }, "description": "Hint to the query engine to limit the metric to certain types of entity." }, "alertState": { "type": "array", "items": { "type": "string" }, "description": "Set of one or more alert state to be used by the filter", "example": [ "raised", "cleared" ] }, "metric": { "type": "array", "items": { "type": "string" }, "description": "Name that identifies the specific metric within a monitored object", "example": [ "delayp95", "hit.rtt.per_sec" ] }, "uid": { "type": "array", "items": { "type": "string" }, "description": "Filter on Alert UID.", "example": [ "111111111" ] }, "startTimestamp": { "type": "array", "items": { "type": "integer", "format": "int64" }, "description": "Start Timestamp to filter on" }, "captureSpec": { "type": "object", "additionalProperties": {} }, "objectType": { "type": "array", "items": { "type": "string" }, "description": "Object types to be considered as part of the filter", "example": [ "twamp-sl", "flowmeter" ] }, "direction": { "type": "array", "items": { "type": "string" }, "description": "Set of one or more directions to be used by the filter to identify required metric records", "example": [ "0", "1" ] }, "geoSpatial": { "$ref": "#/components/schemas/SpatialFilter" }, "sourceLocation": { "$ref": "#/components/schemas/SpatialFilter" }, "destinationLocation": { "$ref": "#/components/schemas/SpatialFilter" }, "topology": { "type": "string", "description": "Name of a node on the route of the Monitored Object" }, "valueBoundary": { "$ref": "#/components/schemas/MetricBucket" }, "objectId": { "type": "array", "items": { "type": "string" }, "description": "Set of object IDs to filter on", "example": [ "333732dc-99d4-4224-915e-3972b50d10ef", "931e7d13-6320-4ad7-ae06-7ff2df4f782a" ] }, "captureClientZoneId": { "type": "array", "items": { "type": "string" }, "description": "" }, "captureServerZoneId": { "type": "array", "items": { "type": "string" }, "description": "" }, "severity": { "type": "array", "items": { "type": "string" }, "description": "" }, "sourceIp": { "type": "array", "items": { "type": "string" }, "description": "" }, "destinationIp": { "type": "array", "items": { "type": "string" }, "description": "" }, "killchain": { "type": "array", "items": { "type": "string" }, "description": "" }, "securityJobType": { "type": "array", "items": { "type": "string" }, "description": "" }, "sourceNetworkAssetRoles": { "type": "array", "items": { "type": "string" }, "description": "" }, "destinationNetworkAssetRoles": { "type": "array", "items": { "type": "string" }, "description": "" } }, "description": "Filter object that identifies a specific metric within a monitored object by its key attributes" }, "alertHistory": { "title": "alertHistory", "required": [ "type", "id", "data" ], "type": "object", "properties": { "type": { "enum": [ "alertHistories" ], "type": "string", "example": "alertHistories" }, "id": { "type": "string" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Data49" }, "description": "" } } }, "alertPolicyCreateRequest": { "title": "alertPolicyCreateRequest", "required": [ "data" ], "type": "object", "properties": { "data": { "$ref": "#/components/schemas/alertPolicy" } }, "description": "JSON API wrapper for creating Alert Policy" }, "alertPoliciesResponse": { "title": "alertPoliciesResponse", "required": [ "data" ], "type": "object", "properties": { "meta": { "$ref": "#/components/schemas/Meta2" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/alertPolicy" }, "description": "" } }, "description": "JSON API Response for Alert Policies" }, "alertPolicyResponse": { "title": "alertPolicyResponse", "required": [ "data" ], "type": "object", "properties": { "data": { "$ref": "#/components/schemas/alertPolicy" } }, "description": "JSON API Response for Alert Policy" }, "alertPoliciesStatistics": { "title": "alertPoliciesStatistics", "required": [ "id", "type", "attributes" ], "type": "object", "properties": { "id": { "type": "string", "description": "The timestamp when this status was queried at" }, "type": { "enum": [ "status" ], "type": "string", "example": "status" }, "attributes": { "$ref": "#/components/schemas/Attributes79" } } }, "alertPolicy": { "title": "alertPolicy", "required": [ "type", "attributes" ], "type": "object", "properties": { "type": { "enum": [ "alertPolicies" ], "type": "string", "example": "alertPolicies" }, "id": { "type": "string" }, "relationships": { "$ref": "#/components/schemas/Relationships2" }, "included": { "type": "array", "items": { "$ref": "#/components/schemas/alertPoliciesStatistics" }, "description": "" }, "attributes": { "$ref": "#/components/schemas/Attributes80" } } }, "alertsConfiguration": { "title": "alertsConfiguration", "required": [ "policyType" ], "type": "object", "properties": { "policyType": { "$ref": "#/components/schemas/PolicyType3" }, "aggregationGranularity": { "description": "Capture aggregation's granularity. The alert condition's duration must be same or larger than this value." }, "severity": { "$ref": "#/components/schemas/Severity" }, "killchain": { "$ref": "#/components/schemas/Killchain2" }, "context": { "type": "array", "items": { "$ref": "#/components/schemas/genericFilterMapItem" }, "description": "" } } }, "alertConditionGroup": { "title": "alertConditionGroup", "required": [ "triggersOn" ], "type": "object", "properties": { "triggersOn": { "$ref": "#/components/schemas/alertCondition" }, "recoversOn": { "$ref": "#/components/schemas/alertCondition" } }, "description": "\"The conditions for an alert (violation or recovery). eg: metric > threshold\"\n\"Note that metric will in the future support composite metrics.\"" }, "alertCondition": { "title": "alertCondition", "type": "object", "properties": { "duration": { "type": "string", "default": "PT5M" }, "metric": { "$ref": "#/components/schemas/Metric" }, "ratioPercent": { "type": "number" }, "value": { "type": "string" }, "values": { "type": "array", "items": { "type": "string" }, "description": "" }, "comparator": { "$ref": "#/components/schemas/Comparator4" }, "blacklist": { "type": "array", "items": { "$ref": "#/components/schemas/alertConditionListEntry" }, "description": "Generic blacklist of fields and their values that can trigger an alert.\nSupported only for \"security\" policy type!" }, "whitelist": { "type": "array", "items": { "$ref": "#/components/schemas/alertConditionListEntry" }, "description": "" } } }, "alertConditionListEntry": { "title": "alertConditionListEntry", "required": [ "field", "value" ], "type": "object", "properties": { "field": { "type": "string" }, "value": { "type": "string" }, "description": { "type": "string" } } }, "AlertPayload": { "title": "AlertPayload", "required": [ "tenantName", "tenantId", "processedTimestamp", "timestamp", "startTimestamp", "policyId", "source", "policyType", "alertState" ], "type": "object", "properties": { "uid": { "type": "string", "description": "Unique Identifier" }, "tenantName": { "type": "string", "description": "The tenant Name" }, "tenantId": { "type": "string", "description": "The tenant ID" }, "processedTimestamp": { "type": "integer", "description": "When the record was processed by the stream processor. Note that this is not the record's timestamp.", "format": "int64" }, "timestamp": { "type": "integer", "description": "The timestamp of the last record that causes the alert to trigger.", "format": "int64" }, "startTimestamp": { "type": "integer", "description": "For a raised alert, this will match the timestamp value. For a cleared alert, this value will signify the timestamp of the last record that causes the alert to clear.", "format": "int64" }, "endTimestamp": { "type": "integer", "description": "As usual it will be capture end data. Or end of time window", "format": "int64" }, "policyName": { "type": "string", "description": "Message is associated with an existing policy's Name" }, "policyId": { "type": "string", "description": "Message is associated with an existing policy", "format": "uuid" }, "objectId": { "type": "string", "description": "Object ID that is in violation if the policy is configured for micro-TCA" }, "objectName": { "type": "string", "description": "Object Name that is in violation if the policy is configured for micro-TCA" }, "source": { "type": "string", "description": "Originator of the message, eg: the stream processors" }, "uri": { "type": "string", "description": "The alert may provide a link to the alert's dashboard for investigation" }, "annotation": { "maxLength": 255, "type": "string" }, "metric": { "type": "string", "description": "The metric that this alert sampled" }, "direction": { "type": "string", "description": "The direction of the metric that caused the alert" }, "tags": { "maxLength": 255, "type": "string", "description": "Miscellenous data the user wants to tag this alert with" }, "policyType": { "$ref": "#/components/schemas/PolicyType" }, "objectType": { "type": "string", "description": "The type of object this alert is for" }, "duration": { "type": "number", "description": "The minimum amount of time beyond the threshold" }, "timeInViolation": { "type": "number", "description": "The total amount of time spent in violation" }, "alertState": { "$ref": "#/components/schemas/AlertState" }, "srcLat": { "type": "number", "description": "Geographic latitude of Monitored Object source" }, "srcLon": { "type": "number", "description": "Geographic longitude of Monitored Object source" }, "dstLat": { "type": "number", "description": "Geographic latitude of Monitored Object destination" }, "dstLon": { "type": "number", "description": "Geographic longitude of Monitored Object destination" }, "topology": { "type": "array", "items": { "type": "string" }, "description": "Tags used to describe the path segments associated with the Monitored Object" }, "metadata": { "type": "object", "additionalProperties": { "type": "string" }, "description": "Metadata Attributes of an monitored object", "example": { "meta21": "First value", "meta31": "Second value" } }, "value": { "type": "string", "description": "This can either be the threshold value or a distance measure for dynamic thresholds" }, "comparator": { "$ref": "#/components/schemas/Comparator1" }, "sessionId": { "type": "string" }, "bcn": { "type": "string" }, "bca": { "type": "string" }, "ip": { "type": "string" }, "captureLayer": { "type": "string" }, "captureZone": { "type": "string" }, "captureApplicationId": { "type": "string" }, "captureZoneId": { "type": "string" }, "captureMetaThresholds": { "type": "number" }, "captureMetaValues": { "type": "string" }, "captureMetaIps": { "type": "string" }, "captureMetaDesc": { "type": "string" }, "captureMetaDate_stop": { "type": "number" }, "captureMetaDate_start": { "type": "number" }, "captureMetaIp_client": { "type": "string" }, "captureMetaIp_count": { "type": "number" }, "captureMetaStart": { "type": "number" }, "captureMetaStop": { "type": "number" }, "captureMetaName": { "type": "string" }, "captureMetaAlert_id": { "type": "string" }, "captureMetaNow": { "type": "number" }, "captureMetaFirst_sent": { "type": "number" }, "captureMetaLast_sent": { "type": "number" }, "captureMetaSite": { "type": "string" }, "captureMetaWorker": { "type": "string" }, "captureMetaFiring": { "type": "string" }, "captureMetaCertainty": { "type": "number" }, "captureMetaHostname": { "type": "string" }, "captureMetaCertainty_percent": { "type": "number" }, "captureClientZoneId": { "type": "string" }, "captureServerZoneId": { "type": "string" }, "sourceIp": { "type": "string" }, "destinationIp": { "type": "string" }, "severity": { "$ref": "#/components/schemas/Severity" }, "killchain": { "$ref": "#/components/schemas/Killchain" }, "securityJobType": { "type": "string" }, "sourceNetworkAssetRoles": { "type": "string" }, "destinationNetworkAssetRoles": { "type": "string" }, "sourcePort": { "type": "number" }, "destinationPort": { "type": "number" } } }, "AutomaticAlertPolicyCreateRequest": { "title": "AutomaticAlertPolicyCreateRequest", "required": [ "data" ], "type": "object", "properties": { "data": { "$ref": "#/components/schemas/Data50" } }, "description": "JSON API wrapper for creating Alert Policy" }, "AutomaticAlertPolicyResponse": { "title": "AutomaticAlertPolicyResponse", "required": [ "data" ], "type": "object", "properties": { "data": { "$ref": "#/components/schemas/Data50" } }, "description": "JSON API Response for Alert Policy" }, "AutomaticAlertConfiguration": { "title": "AutomaticAlertConfiguration", "type": "object", "properties": { "enabled": { "type": "boolean", "default": true }, "capture": { "$ref": "#/components/schemas/Capture" }, "sessionAnomaly": { "$ref": "#/components/schemas/SessionAnomaly" } }, "description": "We have built in rules that are already running and the user will be able to tune those rules here." }, "AlertSummary": { "title": "AlertSummary", "required": [ "tenantId", "policyId", "timestamp", "policyType", "alertState" ], "type": "object", "properties": { "metric": { "type": "string", "description": "The metric that this alert sampled" }, "direction": { "type": "string" }, "tenantId": { "type": "string" }, "policyId": { "type": "string" }, "itemsInViolationCount": { "type": "number" }, "startTimestamp": { "type": "integer", "format": "int64" }, "timestamp": { "type": "integer", "format": "int64" }, "duration": { "type": "number" }, "policyType": { "type": "string" }, "alertState": { "$ref": "#/components/schemas/AlertState2" }, "objectId": { "type": "string" }, "srcLat": { "type": "number", "description": "Geographic latitude of Monitored Object source" }, "srcLon": { "type": "number", "description": "Geographic longitude of Monitored Object source" }, "dstLat": { "type": "number", "description": "Geographic latitude of Monitored Object destination" }, "dstLon": { "type": "number", "description": "Geographic longitude of Monitored Object destination" }, "topology": { "type": "array", "items": { "type": "string" }, "description": "Tags used to describe the path segments associated with the Monitored Object" }, "value": { "type": "string", "description": "This can either be the threshold value or a distance measure for dynamic thresholds" }, "comparator": { "$ref": "#/components/schemas/Comparator1" }, "sessionId": { "type": "string" }, "bcn": { "type": "string" }, "bca": { "type": "string" }, "ip": { "type": "string" }, "captureLayer": { "type": "string" }, "captureZone": { "type": "string" }, "captureApplicationId": { "type": "string" }, "captureZoneId": { "type": "string" }, "captureMetaThresholds": { "type": "number" }, "captureMetaValues": { "type": "string" }, "captureMetaIps": { "type": "string" }, "captureMetaDesc": { "type": "string" }, "captureMetaDate_stop": { "type": "number" }, "captureMetaDate_start": { "type": "number" }, "captureMetaIp_client": { "type": "string" }, "captureMetaIp_count": { "type": "number" }, "captureMetaStart": { "type": "number" }, "captureMetaStop": { "type": "number" }, "captureMetaName": { "type": "string" }, "captureMetaAlert_id": { "type": "number" }, "captureMetaNow": { "type": "number" }, "captureMetaFirst_sent": { "type": "number" }, "captureMetaLast_sent": { "type": "number" }, "captureMetaSite": { "type": "string" }, "captureMetaWorker": { "type": "string" }, "captureMetaFiring": { "type": "string" }, "captureMetaCertainty": { "type": "number" }, "captureMetaHostname": { "type": "string" }, "captureMetaCertainty_percent": { "type": "number" } }, "description": "Alerts summaries are checkpoints to aid in the tracking of sets of active objects per policy every hour" }, "AlertsPayloadListResponse": { "title": "AlertsPayloadListResponse", "required": [ "data" ], "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/AlertPayload" }, "description": "" } }, "description": "AlertPayload response including one or more values" }, "SessionFilterProfile": { "title": "SessionFilterProfile", "required": [ "type", "id", "attributes" ], "type": "object", "properties": { "type": { "enum": [ "SessionFilterProfiles" ], "type": "string", "example": "SessionFilterProfiles" }, "id": { "type": "string" }, "relationships": { "$ref": "#/components/schemas/SessionFilterProfileRelationships" }, "attributes": { "$ref": "#/components/schemas/Attributes81" } } }, "SessionFilterProfileRelationships": { "title": "SessionFilterProfileRelationships", "type": "object", "properties": { "sessionFilters": { "$ref": "#/components/schemas/JsonApiRelationship" } } }, "SessionFilterProfileListResponse": { "title": "SessionFilterProfileListResponse", "required": [ "data" ], "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/SessionFilterProfile" }, "description": "" } }, "description": "Response for one ore more SessionFilterProfiles from Datahub" }, "SessionFilterProfileResponse": { "title": "SessionFilterProfileResponse", "required": [ "data" ], "type": "object", "properties": { "data": { "$ref": "#/components/schemas/SessionFilterProfile" } }, "description": "A single object SessionFilterProfile response from Datahub" }, "SessionFilterProfileCreateRequest": { "title": "SessionFilterProfileCreateRequest", "required": [ "data" ], "type": "object", "properties": { "data": { "$ref": "#/components/schemas/Data52" } }, "description": "Object used to create a SessionFilterProfile in Datahub" }, "SessionFilterProfileUpdateRequest": { "title": "SessionFilterProfileUpdateRequest", "required": [ "data" ], "type": "object", "properties": { "data": { "$ref": "#/components/schemas/Data53" } }, "description": "Object used to update a SessionFilterProfile in Datahub" }, "SessionFilter": { "title": "SessionFilter", "required": [ "type", "id", "attributes" ], "type": "object", "properties": { "type": { "enum": [ "filterList" ], "type": "string", "example": "filterList" }, "id": { "type": "string" }, "attributes": { "$ref": "#/components/schemas/Attributes84" } } }, "SessionFilterListResponse": { "title": "SessionFilterListResponse", "required": [ "data" ], "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/SessionFilter" }, "description": "" } }, "description": "Response for one ore more SessionFilters from Datahub" }, "SessionFilterResponse": { "title": "SessionFilterResponse", "required": [ "data" ], "type": "object", "properties": { "data": { "$ref": "#/components/schemas/SessionFilter" } }, "description": "A single object SessionFilter response from Datahub" }, "SessionFilterCreateRequest": { "title": "SessionFilterCreateRequest", "required": [ "data" ], "type": "object", "properties": { "data": { "$ref": "#/components/schemas/Data54" } }, "description": "Object used to create a SessionFilter in Datahub" }, "SessionFilterUpdateRequest": { "title": "SessionFilterUpdateRequest", "required": [ "data" ], "type": "object", "properties": { "data": { "$ref": "#/components/schemas/Data55" } }, "description": "Object used to update a SessionFilter in Datahub" }, "FilterItem": { "title": "FilterItem", "required": [ "field", "value", "isPartialMatch" ], "type": "object", "properties": { "field": { "type": "string", "description": "The field the filtering will be filtering on." }, "value": { "type": "string", "description": "The value the filtering will be filtering by. Can be a full value, or partial string match." }, "isPartialMatch": { "type": "boolean", "description": "If true, 'value' will be used as a partial string match." } } }, "PatchSessionFilterProfileRequest": { "title": "PatchSessionFilterProfileRequest", "required": [ "data" ], "type": "object", "properties": { "data": { "$ref": "#/components/schemas/Data56" } }, "description": "Object used to patch a SessionFilterProfile in Datahub" }, "PatchSessionFilterRequest": { "title": "PatchSessionFilterRequest", "type": "object", "properties": { "data": { "$ref": "#/components/schemas/Data57" } } }, "ThresholdProfileCreateRequest": { "title": "ThresholdProfileCreateRequest", "required": [ "data" ], "type": "object", "properties": { "data": { "$ref": "#/components/schemas/Data58" } }, "description": "Object used to create a new Threshold Profile in Datahub" }, "ThresholdProfileUpdateRequest": { "title": "ThresholdProfileUpdateRequest", "required": [ "data" ], "type": "object", "properties": { "data": { "$ref": "#/components/schemas/Data59" } }, "description": "Object used to update an existing Threshold Profile in Datahub" }, "ThresholdProfileListResponse": { "title": "ThresholdProfileListResponse", "required": [ "data" ], "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/ThresholdProfile" }, "description": "" } }, "description": "Threshold Profile response including one or more values" }, "ThresholdProfileResponse": { "title": "ThresholdProfileResponse", "required": [ "data" ], "type": "object", "properties": { "data": { "$ref": "#/components/schemas/ThresholdProfile" } }, "description": "A single object Threshold Profile response from Datahub" }, "ThresholdProfile": { "title": "ThresholdProfile", "required": [ "type", "id", "attributes" ], "type": "object", "properties": { "type": { "enum": [ "thresholdProfiles" ], "type": "string", "example": "thresholdProfiles" }, "id": { "type": "string" }, "attributes": { "$ref": "#/components/schemas/Attributes91" } } }, "ThresholdsObject": { "title": "ThresholdsObject", "type": "object", "properties": { "vendorMap": { "type": "object", "additionalProperties": { "$ref": "#/components/schemas/VendorMap1" } } } }, "IngestionDictionaryV3CreateRequest": { "title": "IngestionDictionaryV3CreateRequest", "required": [ "data" ], "type": "object", "properties": { "data": { "$ref": "#/components/schemas/IngestionDictionaryV3" } }, "description": "Object used to create an Ingestion Dictionary in Datahub" }, "IngestionDictionaryV3UpdateRequest": { "title": "IngestionDictionaryV3UpdateRequest", "required": [ "data" ], "type": "object", "properties": { "data": { "$ref": "#/components/schemas/IngestionDictionaryV3" } }, "description": "Object used to update an Ingestion Dictionary in Datahub" }, "IngestionDictionaryV3ListResponse": { "title": "IngestionDictionaryV3ListResponse", "required": [ "data" ], "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/IngestionDictionaryV3" }, "description": "" } }, "description": "Ingestion Dictionary response including one or more values" }, "IngestionDictionaryV3Response": { "title": "IngestionDictionaryV3Response", "required": [ "data" ], "type": "object", "properties": { "data": { "$ref": "#/components/schemas/IngestionDictionaryV3" } }, "description": "A single object Ingestion Dictionary response from Datahub" }, "IngestionDictionaryV3": { "title": "IngestionDictionaryV3", "required": [ "type", "attributes" ], "type": "object", "properties": { "type": { "enum": [ "ingestionDictionaries" ], "type": "string", "example": "ingestionDictionaries" }, "id": { "type": "string" }, "attributes": { "$ref": "#/components/schemas/Attributes92" } } }, "IngestionDictionaryV3Item": { "title": "IngestionDictionaryV3Item", "required": [ "analyticsName" ], "type": "object", "properties": { "analyticsName": { "type": "string" }, "rawName": { "type": "string" }, "dataType": { "$ref": "#/components/schemas/DataType" }, "hasBaseline": { "type": "boolean" }, "sqlExpr": { "type": "string" }, "unit": { "type": "string" }, "directions": { "type": "array", "items": { "type": "string" }, "description": "" } } }, "DatasourceReconciliationTasks": { "title": "DatasourceReconciliationTasks", "type": "object", "properties": { "data": { "$ref": "#/components/schemas/Data60" } }, "description": "JSON API compliant wrapper for the datasource reconciliation tasks request" }, "DatasourceReconciliationTaskConfig": { "title": "DatasourceReconciliationTaskConfig", "required": [ "interval" ], "type": "object", "properties": { "interval": { "type": "string" }, "storage": { "$ref": "#/components/schemas/Storage" } } }, "DatasourceReindexTasks": { "title": "DatasourceReindexTasks", "type": "object", "properties": { "data": { "$ref": "#/components/schemas/Data61" } }, "description": "JSON API compliant wrapper for the datasource reindex tasks request" }, "DatasourceReindexConfig": { "title": "DatasourceReindexConfig", "required": [ "targetSegmentTimebucket" ], "type": "object", "properties": { "intervalStart": { "type": "string", "description": "Start of time interval over which to execute the granularity compaction. Is of format 'YYYY-MM-DD'", "format": "date", "example": "2021-04-01" }, "intervalEnd": { "type": "string", "description": "End of time interval over which to execute the granularity compaction. Is of format 'YYYY-MM-DD", "format": "date", "example": "2021-04-08" }, "targetSegmentTimebucket": { "$ref": "#/components/schemas/TargetSegmentTimebucket" } }, "description": "Payload for a reindexing task of a metrics datasource. 'intervalStart' and 'intervalEnd' are required unless query parameter 'periodOffsetMultiplier' is provided, in which case they are ignored" }, "JsonApiGroupByRequest": { "title": "JsonApiGroupByRequest", "type": "object", "properties": { "data": { "$ref": "#/components/schemas/Data62" } }, "description": "JSON API compliant wrapper for the groupby query" }, "JsonApiGroupByResponse": { "title": "JsonApiGroupByResponse", "type": "object", "properties": { "meta": { "$ref": "#/components/schemas/MetricQueryResponseMeta" }, "data": { "$ref": "#/components/schemas/Data63" } }, "description": "JSON API compliant wrapper for the groupby response" }, "GroupByConfig": { "title": "GroupByConfig", "required": [ "groupingContext", "interval", "aggregation", "metrics" ], "type": "object", "properties": { "queryContext": { "$ref": "#/components/schemas/QueryContext" }, "metaContext": { "$ref": "#/components/schemas/MetaContext" }, "groupingContext": { "$ref": "#/components/schemas/GroupingContext" }, "interval": { "type": "string", "description": "Time boundary for the metrics under consideration using the ISO-8601 standard", "example": "2018-04-08T14:00:00/2018-04-09T15:00:00" }, "aggregation": { "$ref": "#/components/schemas/SupportedAggregations" }, "globalMetricFilterContext": { "$ref": "#/components/schemas/SupportedMetricDimensionFilters" }, "metrics": { "type": "array", "items": { "$ref": "#/components/schemas/MetricSpec" }, "description": "A set of identifiers that considers specific metrics based on the provided information" } }, "description": "The necessary request parameters for the metric api call" }, "GroupedResultEntryParameters": { "title": "GroupedResultEntryParameters", "required": [ "metric", "groupedResults" ], "type": "object", "properties": { "vendor": { "type": "string", "description": "Vendor name associated with the monitored object", "example": "accedian-twamp" }, "objectType": { "type": "array", "items": { "type": "string" }, "description": "Object types to be considered as part of the filter", "example": [ [ "twamp-pe" ], [ "twamp-sl", "twamp-sf" ] ] }, "direction": { "type": "array", "items": { "type": "string" }, "description": "Set of one or more directions to be used by the filter to identify required metric records", "example": [ [ "0" ], [ "0", "1" ] ] }, "monitoredObjectId": { "type": "array", "items": { "type": "string" }, "description": "Set of one or more monitored object Ids to be used by the filter to identify required metric records", "example": [ [ "abc" ], [ "abc", "def" ] ] }, "sourceLocation": { "$ref": "#/components/schemas/SpatialFilter" }, "destinationLocation": { "$ref": "#/components/schemas/SpatialFilter" }, "topology": { "type": "string", "description": "Name of a node on the route of the Monitored Object" }, "metadata": { "$ref": "#/components/schemas/Metadata1" }, "valueBoundary": { "$ref": "#/components/schemas/MetricBucket" }, "metric": { "type": "string", "description": "Name that identifies the specific metric within a monitored object", "example": "delayP95" }, "groupedResults": { "type": "array", "items": { "$ref": "#/components/schemas/GroupedResult3" }, "description": "" } }, "description": "Describes filtering criteria used for a particular query that uses a grouping" }, "MetaContext": { "title": "MetaContext", "required": [ "metadataFilters" ], "type": "object", "properties": { "metadataFilters": { "type": "object", "additionalProperties": {}, "description": "An object that allows filtering on arbitrary metadata criteria and their values. The keys in the map are associated with metadata categories and the value array corresponds to a set of whitelist filter-in values for that category. The logical semantics associated with this structure are conditional-AND across metadata criteria (keys) and conditional-OR across the values contained within the value array. For example, {\"region\":[\"montreal\",\"ottawa\"], \"group\":[\"radio\"]} will match all records that are of group \"radio\" AND from the region \"montreal\" OR \"ottawa\"", "example": { "region": [ "montreal", "ottawa" ], "group": [ "radio" ] } }, "metaExclude": { "type": "array", "items": { "type": "string" }, "description": "An array that allows blacklisting one or more metadata criteria. Each key in the array must correspond to a given key in the MetaFilter portion of the request. This exclusion is a logical NOT for any values belonging to the metadata criteria listed in this request. For example, if the MetaFilter is: {\"region\":[\"montreal\",\"ottawa\"], \"group\":[\"radio\"]}, we can have a MetaExclude of the form [\"region\"]. This would result in a request that includes any records that are of group \"radio\" AND NOT in regions Ottawa or Montreal.", "example": [ "group" ] } }, "description": "Elements of the query that define metadata specific components" }, "QueryContext": { "title": "QueryContext", "type": "object", "properties": { "ignoreCleaning": { "type": "boolean", "description": "A value of true will have the aggregation request execute on all data regardless of whether it has been cleaned or not" }, "focusBusyHour": { "type": "boolean", "description": "A value of true will only consider data tagged as 'busyHour' for the aggregation request" }, "ignoreMaintenance": { "type": "boolean", "description": "A value of true will ignore data tagged as 'maintenance' for the aggregation request" }, "timeout": { "type": "integer", "description": "Query timeout in milliseconds", "format": "int32", "example": 30000 }, "sorted": { "$ref": "#/components/schemas/Sorted" }, "numResults": { "type": "integer", "description": "Number of results to return in grouped queries. A non-positive integer for this value implies there is no result limit. Only applicable to grouped queries.", "format": "int32", "example": 10 } }, "description": "Hints indicating how the query may be Returns" }, "GroupingContext": { "title": "GroupingContext", "required": [ "groupings" ], "type": "object", "properties": { "strictGroupings": { "type": "boolean", "description": "Value of true indicates that all requested groupings MUST exist within a data record in order to be considered for aggregation within that group" }, "groupings": { "type": "array", "items": { "$ref": "#/components/schemas/GroupingEntity" }, "description": "" } }, "description": "Defines how the results should be grouped" }, "GroupingEntity": { "title": "GroupingEntity", "required": [ "groupName", "groupType" ], "type": "object", "properties": { "groupName": { "type": "string" }, "groupType": { "$ref": "#/components/schemas/GroupType" } }, "description": "Provides additional information about the entity to group by" }, "JsonApiAggregateV3Request": { "title": "JsonApiAggregateV3Request", "type": "object", "properties": { "data": { "$ref": "#/components/schemas/Data64" } }, "description": "JSON API compliant wrapper for the aggregate query" }, "JsonApiAggregateV3Response": { "title": "JsonApiAggregateV3Response", "type": "object", "properties": { "meta": { "$ref": "#/components/schemas/MetricQueryResponseMeta" }, "data": { "$ref": "#/components/schemas/Data65" } }, "description": "JSON API compliant wrapper for the aggregate response" }, "AggregateV3Config": { "title": "AggregateV3Config", "required": [ "interval", "granularity", "aggregation", "metrics" ], "type": "object", "properties": { "queryContext": { "$ref": "#/components/schemas/QueryContext" }, "metaContext": { "$ref": "#/components/schemas/MetaContext" }, "interval": { "type": "string", "description": "Time boundary for the metrics under consideration using the ISO-8601 standard", "example": "2018-04-08T14:00:00/2018-04-09T15:00:00" }, "granularity": { "type": "string", "description": "the granularity for timeseries in ISO-8601 duration format, or ALL", "example": "PT1H" }, "aggregation": { "$ref": "#/components/schemas/SupportedAggregations" }, "globalMetricFilterContext": { "$ref": "#/components/schemas/SupportedMetricDimensionFilters" }, "metrics": { "type": "array", "items": { "$ref": "#/components/schemas/MetricSpec" }, "description": "A set of identifiers that considers specific metrics based on the provided information" } }, "description": "The necessary request parameters for the metric api call" }, "MetricTimeseriesResult": { "title": "MetricTimeseriesResult", "required": [ "metric", "series" ], "type": "object", "properties": { "vendor": { "type": "string", "description": "Vendor name associated with the monitored object", "example": "accedian-twamp" }, "objectType": { "type": "array", "items": { "type": "string" }, "description": "Object types to be considered as part of the filter", "example": [ [ "twamp-pe" ], [ "twamp-sl", "twamp-sf" ] ] }, "direction": { "type": "array", "items": { "type": "string" }, "description": "Set of one or more directions to be used by the filter to identify required metric records", "example": [ [ "0" ], [ "0", "1" ] ] }, "monitoredObjectId": { "type": "array", "items": { "type": "string" }, "description": "Set of one or more monitored object Ids to be used by the filter to identify required metric records", "example": [ [ "abc" ], [ "abc", "def" ] ] }, "sourceLocation": { "$ref": "#/components/schemas/SpatialFilter" }, "destinationLocation": { "$ref": "#/components/schemas/SpatialFilter" }, "topology": { "type": "string", "description": "Name of a node on the route of the Monitored Object" }, "metadata": { "$ref": "#/components/schemas/Metadata1" }, "valueBoundary": { "$ref": "#/components/schemas/MetricBucket" }, "metric": { "type": "string", "description": "Name that identifies the specific metric within a monitored object", "example": "delayP95" }, "series": { "type": "array", "items": { "$ref": "#/components/schemas/MetricTimeseriesResultEntry" }, "description": "" } }, "description": "Describes series data prefixed with the filter criteria that were used to generate the output" }, "MetricTimeseriesResultEntry": { "title": "MetricTimeseriesResultEntry", "required": [ "timestamp", "value" ], "type": "object", "properties": { "timestamp": { "type": "string" }, "value": { "type": "number" } }, "description": "A singular time series entry that contains the timestamp and value" }, "MetricQueryResponseMeta": { "title": "MetricQueryResponseMeta", "type": "object", "properties": { "datasource": { "type": "string" }, "datasourceSelectionRules": { "type": "array", "items": { "type": "string" }, "description": "" }, "queryID": { "type": "string" } }, "description": "Provides additional diagnostic information about the query to the skylight-admin user" }, "TcpThroughputResponse": { "title": "TcpThroughputResponse", "required": [ "data" ], "type": "object", "properties": { "data": { "$ref": "#/components/schemas/TcpThroughputTestReport" } } }, "TcpThroughputPaginationStanza": { "title": "TcpThroughputPaginationStanza", "type": "object", "properties": { "total-results": { "type": "integer", "format": "int32" }, "token": { "type": "string" }, "next": { "type": "string" } } }, "TcpThroughputListResponse": { "title": "TcpThroughputListResponse", "required": [ "data" ], "type": "object", "properties": { "pagination": { "$ref": "#/components/schemas/TcpThroughputPaginationStanza" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/TcpThroughputTestReport" }, "description": "" } } }, "TcpThroughputUpdateRequest": { "title": "TcpThroughputUpdateRequest", "required": [ "data" ], "type": "object", "properties": { "data": { "$ref": "#/components/schemas/TcpThroughputUpdateBody" } }, "description": "Object used to update an existing TCP Throughput test report" }, "TcpThroughputUpdateBody": { "title": "TcpThroughputUpdateBody", "required": [ "type", "attributes" ], "type": "object", "properties": { "id": { "type": "string" }, "type": { "enum": [ "tcpThroughputReport" ], "type": "string", "example": "tcpThroughputReport" }, "attributes": { "$ref": "#/components/schemas/Attributes96" } }, "description": "A single instance of a TCP Throughput test run." }, "TcpThroughputFilteredListRequest": { "title": "TcpThroughputFilteredListRequest", "type": "object", "properties": { "expressions": { "$ref": "#/components/schemas/expressions" }, "user-meta": { "type": "object", "additionalProperties": {}, "description": "An object that allows filtering on arbitrary metadata criteria and their values. The keys in the map are associated with metadata categories and the value array corresponds to a set of whitelist filter-in values for that category. The logical semantics associated with this structure are conditional-AND across metadata criteria (keys) and conditional-OR across the values contained within the value array. For example, {\"region\":[\"montreal\",\"ottawa\"], \"group\":[\"radio\"]} will match all records that are of group \"radio\" AND from the region \"montreal\" OR \"ottawa\"", "example": { "region": [ "montreal", "ottawa" ], "group": [ "radio" ] } }, "ingestion-meta": { "type": "object", "additionalProperties": {}, "description": "An object that allows filtering on arbitrary metadata criteria and their values. The keys in the map are associated with metadata categories and the value array corresponds to a set of whitelist filter-in values for that category. The logical semantics associated with this structure are conditional-AND across metadata criteria (keys) and conditional-OR across the values contained within the value array. For example, {\"region\":[\"montreal\",\"ottawa\"], \"group\":[\"radio\"]} will match all records that are of group \"radio\" AND from the region \"montreal\" OR \"ottawa\"", "example": { "region": [ "montreal", "ottawa" ], "group": [ "radio" ] } }, "metaExclude": { "type": "array", "items": { "type": "string" }, "description": "An array that allows blacklisting one or more metadata criteria. Each key in the array must correspond to a given key in the MetaFilter portion of the request. This exclusion is a logical NOT for any values belonging to the metadata criteria listed in this request. For example, if the MetaFilter is: {\"region\":[\"montreal\",\"ottawa\"], \"group\":[\"radio\"]}, we can have a MetaExclude of the form [\"region\"]. This would result in a request that includes any records that are of group \"radio\" AND NOT in regions Ottawa or Montreal.", "example": [ "group" ] }, "test-id": { "type": "array", "items": { "type": "string" }, "description": "An array of test identifiers" }, "run-id": { "type": "array", "items": { "type": "string" }, "description": "An array of run identifiers" } } }, "TcpThroughputFilteredCountResponse": { "title": "TcpThroughputFilteredCountResponse", "required": [ "data" ], "type": "object", "properties": { "data": { "$ref": "#/components/schemas/Data66" } }, "description": "Tcp Throughput counts response" }, "TcpThroughputTestSummaryReport": { "title": "TcpThroughputTestSummaryReport", "type": "object", "properties": { "id": { "type": "string" }, "type": { "$ref": "#/components/schemas/Type39" }, "attributes": { "$ref": "#/components/schemas/Attributes98" } } }, "TcpThroughputTestIntervalReport": { "title": "TcpThroughputTestIntervalReport", "type": "object", "properties": { "id": { "type": "string" }, "type": { "$ref": "#/components/schemas/Type39" }, "attributes": { "$ref": "#/components/schemas/Attributes99" } } }, "TcpThroughputTestReport": { "title": "TcpThroughputTestReport", "required": [ "type", "attributes" ], "type": "object", "properties": { "id": { "type": "string" }, "type": { "enum": [ "tcpThroughputReport" ], "type": "string", "example": "tcpThroughputReport" }, "attributes": { "$ref": "#/components/schemas/Attributes95" } }, "description": "A single instance of a TCP Throughput test run." }, "ActuatorType": { "title": "ActuatorType", "enum": [ "unknown", "accedian-nid", "accedian-vnid" ], "type": "string", "description": "Type of the origin of the Monitored Object", "example": "unknown" }, "Aggregation": { "title": "Aggregation", "enum": [ "count" ], "type": "string", "description": "Count will provide you the number of active alerts in total.", "example": "count" }, "Aggregation1": { "title": "Aggregation1", "enum": [ "none", "sum", "min", "max", "avg" ], "type": "string", "example": "none" }, "Aggregator2": { "title": "Aggregator2", "enum": [ "min", "max", "avg" ], "type": "string", "description": "The type of aggregation to use when displaying the values", "example": "min" }, "AlertConfig": { "title": "AlertConfig", "type": "object", "properties": { "enabledAlertPolicyLimit": { "$ref": "#/components/schemas/enabledAlertPolicyLimit" } } }, "AlertState": { "title": "AlertState", "enum": [ "raised", "cleared", "error", "forced-clear" ], "type": "string", "description": "Message type\nforced-clear -\nraised - Policy is declaring violation conditions are met\ncleared - Policy is declaring recovery conditions are met\nerror - Analytics engine encountered an error at timestamp", "example": "raised" }, "AlertState2": { "title": "AlertState2", "enum": [ "summary", "object-checkpoint" ], "type": "string", "example": "summary" }, "alertState3": { "title": "alertState3", "enum": [ "raised", "cleared", "activeAndCleared" ], "type": "string", "example": "raised" }, "alertState4": { "title": "alertState4", "enum": [ "raised", "cleared" ], "type": "string", "example": "raised" }, "Attributes": { "title": "Attributes", "type": "object", "properties": { "tokenID": { "type": "string", "description": "ID of the jwt" }, "iss": { "type": "string", "description": "Issuer of the jwt" }, "sub": { "type": "string", "description": "Subject of the jwt (the user)" }, "aud": { "type": "string", "description": "Audience - Recipient for which the JWT is intended (tenant name)" }, "exp": { "type": "integer", "description": "Expiry of the JWT - in unix time format", "format": "int32" }, "nbf": { "type": "integer", "description": "Time before which the JWT must not be accepted for processing", "format": "int32" }, "permissions": { "type": "array", "items": { "type": "string" }, "description": "" }, "zone": { "type": "string", "description": "Roadrunner Zone attribute" }, "deploymentURL": { "type": "string", "description": "URL of the base deployment" }, "tenantURL": { "type": "string", "description": "URL of the tenant this JWT was created for" }, "natsHost": { "type": "string", "description": "Hostname of the nats server" }, "tenantID": { "type": "string", "description": "ID of the tenant this JWT was created for" } } }, "Attributes1": { "title": "Attributes1", "required": [ "name" ], "type": "object", "properties": { "name": { "maxLength": 128, "type": "string" }, "tenantId": { "maxLength": 256, "type": "string" } } }, "Attributes2": { "title": "Attributes2", "type": "object", "properties": { "name": { "maxLength": 128, "type": "string" }, "tenantId": { "maxLength": 256, "type": "string" } } }, "Attributes3": { "title": "Attributes3", "required": [ "name", "description" ], "type": "object", "properties": { "name": { "maxLength": 128, "type": "string" }, "description": { "maxLength": 256, "type": "string" }, "tenantId": { "maxLength": 256, "type": "string" } } }, "Attributes4": { "title": "Attributes4", "type": "object", "properties": { "selectors": { "type": "array", "items": { "type": "string" }, "description": "" } } }, "Attributes5": { "title": "Attributes5", "type": "object", "properties": { "name": { "maxLength": 128, "type": "string" }, "description": { "maxLength": 256, "type": "string" }, "tenantId": { "maxLength": 256, "type": "string" } } }, "Attributes6": { "title": "Attributes6", "required": [ "app", "domains", "actions", "description" ], "type": "object", "properties": { "app": { "type": "string", "description": "The application that owns and enforces the permission" }, "domains": { "type": "array", "items": { "type": "string" }, "description": "" }, "actions": { "type": "array", "items": { "type": "string" }, "description": "" }, "description": { "type": "string", "description": "A description of the permission" } } }, "Attributes7": { "title": "Attributes7", "type": "object", "properties": { "domains": { "type": "array", "items": { "type": "string" }, "description": "" }, "actions": { "type": "array", "items": { "type": "string" }, "description": "" }, "description": { "type": "string", "description": "A description of the permission" } } }, "Attributes8": { "title": "Attributes8", "type": "object", "properties": { "app": { "type": "string", "description": "The app that created and enforces this permission" }, "domains": { "type": "array", "items": { "type": "string" }, "description": "" }, "actions": { "type": "array", "items": { "type": "string" }, "description": "" }, "description": { "type": "string", "description": "A description of the permission" } } }, "Attributes9": { "title": "Attributes9", "required": [ "name", "schedule", "filters", "columns", "emails", "groupBy" ], "type": "object", "properties": { "name": { "type": "string", "example": "My first Export Job" }, "tenantId": { "type": "string" }, "schedule": { "$ref": "#/components/schemas/Schedule" }, "duration": { "type": "string", "description": "The duration of the query. P1M means 1 month from the time before expected execution of the report schedule.", "example": "P1M" }, "filters": { "$ref": "#/components/schemas/Filters" }, "columns": { "$ref": "#/components/schemas/Columns" }, "emails": { "type": "array", "items": { "type": "string" }, "description": "List of emails that will get the report", "example": [ "jon@doe.com", "fancy@nancy.com" ] }, "groupBy": { "$ref": "#/components/schemas/GroupBy" } } }, "Attributes10": { "title": "Attributes10", "type": "object", "properties": { "format": { "$ref": "#/components/schemas/Format" }, "lastModified": { "type": "string", "description": "The dataset's last modified timestamp", "example": "2021-06-16T13:02:59.514Z" }, "size": { "type": "number", "description": "Size of the payload attribute in bytes" }, "compression": { "type": "string", "description": "The type of compression applied to the payload", "example": "gzip" }, "payload": { "type": "string", "description": "This is the dataset stored in BASE64. You must decode the BASE64 and then decompress it using the compression format defined in the 'compression' attribute. Example: `cat .csv.gz.b64 | base64 -d | gzip -d > file.csv`" }, "download": { "type": "string", "description": "Link to the file" } } }, "Attributes11": { "title": "Attributes11", "required": [ "name", "urlSubdomain", "state" ], "type": "object", "properties": { "name": { "type": "string", "description": "The name of the Tenant" }, "urlSubdomain": { "type": "string", "description": "The subdomain used in the URL for accessing the Tenant's portal in Datahub" }, "state": { "$ref": "#/components/schemas/State" }, "allowPasswordAuth": { "type": "boolean", "description": "Whether or not we allow username/password authentication" }, "openIDProviders": { "type": "array", "items": { "$ref": "#/components/schemas/OpenIDConfig" }, "description": "Names of supported OpenID providers" }, "samlProviders": { "type": "array", "items": { "$ref": "#/components/schemas/SAMLConfig" }, "description": "Names of supported SAML providers" } } }, "Attributes12": { "title": "Attributes12", "required": [ "_rev" ], "type": "object", "properties": { "_rev": { "type": "string", "description": "The current version of this record. Used to guarantee updates are made in the proper order" }, "name": { "type": "string", "description": "The name of the Tenant" }, "allowPasswordAuth": { "type": "boolean", "description": "Whether or not we allow username/password authentication" }, "urlSubdomain": { "type": "string", "description": "The subdomain used in the URL for accessing the Tenant's portal in Datahub" }, "state": { "$ref": "#/components/schemas/State" }, "openIDProviders": { "type": "array", "items": { "$ref": "#/components/schemas/OpenIDConfig" }, "description": "Names of supported OpenID providers" }, "samlProviders": { "type": "array", "items": { "$ref": "#/components/schemas/SAMLConfig" }, "description": "Names of supported SAML providers" } } }, "Attributes13": { "title": "Attributes13", "required": [ "_rev", "name", "urlSubdomain", "state", "createdTimestamp", "lastModifiedTimestamp" ], "type": "object", "properties": { "_rev": { "type": "string", "description": "The current version of this record. Used to guarantee updates are made in the proper order" }, "name": { "type": "string", "description": "The name of the Tenant" }, "allowPasswordAuth": { "type": "boolean", "description": "Whether or not we allow username/password authentication" }, "urlSubdomain": { "type": "string", "description": "The subdomain used in the URL for accessing the Tenant's portal in Datahub" }, "state": { "$ref": "#/components/schemas/State" }, "openIDProviders": { "type": "array", "items": { "$ref": "#/components/schemas/OpenIDConfig" }, "description": "Names of supported OpenID providers" }, "samlProviders": { "type": "array", "items": { "$ref": "#/components/schemas/SAMLConfig" }, "description": "Names of supported SAML providers" }, "createdTimestamp": { "type": "integer", "description": "The timestamp at which this record was created in Datahub", "format": "int64" }, "lastModifiedTimestamp": { "type": "integer", "description": "The timestamp of the last update to this record in Datahub", "format": "int64" } } }, "Attributes14": { "title": "Attributes14", "required": [ "metrics" ], "type": "object", "properties": { "metricGroups": { "type": "array", "items": { "$ref": "#/components/schemas/MetricGroup" }, "description": "This property will be deprecated in the next API version." }, "metricList": { "type": "array", "items": { "$ref": "#/components/schemas/MetricList" }, "description": "Provides an array of objects that describe the possible metric combinations that may be retained by Datahub" }, "metrics": { "type": "object", "additionalProperties": { "$ref": "#/components/schemas/Metrics" }, "description": "Metrics will be deprecated in the next API version. Please use the 'metricList' property instead" } } }, "Attributes15": { "title": "Attributes15", "required": [ "monitoredObjectTypes", "monitoredObjectDeviceTypes" ], "type": "object", "properties": { "monitoredObjectTypes": { "type": "object", "additionalProperties": { "type": "string" }, "description": "Lists the known Monitored Object Types as well as known alias values for Monitored Object types" }, "monitoredObjectDeviceTypes": { "type": "object", "additionalProperties": { "type": "string" }, "description": "Lists the known Monitored Object Device Types as well as known alias values for Monitored Object Device types" } } }, "Attributes16": { "title": "Attributes16", "required": [ "solutionVersion", "releaseVersion" ], "type": "object", "properties": { "solutionVersion": { "type": "object", "additionalProperties": { "type": "string" }, "description": "The currently installed solution version. If followed by a *, indicates that local modification has been detected" }, "releaseVersion": { "type": "object", "additionalProperties": { "type": "string" }, "description": "The currently installed release version." }, "isDirty": { "type": "boolean", "description": "Set to true when a local change was detected in the compose file (i.e. the expected hash of the docker compose file doesn't match the computed one)" }, "componentsVersions": { "type": "array", "items": { "$ref": "#/components/schemas/ComponentsVersion" }, "description": "" } } }, "Attributes17": { "title": "Attributes17", "type": "object", "properties": { "id": { "type": "string", "description": "The unique identifier of the Tenant in Datahub" }, "alias": { "type": "string", "description": "A known alias for the Tenant in Datahub" } } }, "Attributes18": { "title": "Attributes18", "required": [ "_rev", "tenantName", "metadataCategoryLimit", "deltaBatchCompactionDurationMinutes", "aggregateDataCleaningThreshold", "ingestionVacuumSettings", "baselinePeriod", "latentDataPeriod", "metricDatasourceSettings", "metricQueryConfig", "alertConfig" ], "type": "object", "properties": { "_rev": { "type": "string", "description": "Value used to ensure updates to this object are handled in order." }, "tenantName": { "type": "string", "description": "The name of a Tenant in Datahub" }, "metadataCategoryLimit": { "type": "integer", "description": "The maximum amount of Metadata Categories allowed for this Tenant", "format": "int32" }, "deltaBatchCompactionDurationMinutes": { "maximum": 30.0, "minimum": 1.0, "type": "integer", "description": "The amount of time we will compact collected delta batch ingestion notifications before submitting them for ingestion", "format": "int32", "example": 5 }, "aggregateDataCleaningThreshold": { "maximum": 1.0, "minimum": 0.0, "exclusiveMinimum": true, "type": "number", "description": "Percentage (0.0 - 1.0] of data points which must be marked as 'dirty' before the aggregated value will also be marked as 'dirty'" }, "ingestionVacuumSettings": { "$ref": "#/components/schemas/IngestionVersionRetetionProperties" }, "baselinePeriod": { "type": "string", "description": "ISO8601 format period (only Time variant i.e. must start 'PT') which determines how far in the past data will contribute to the baseline average values of metrics." }, "latentDataPeriod": { "type": "string", "description": "ISO8601 format period (only Time variant i.e. must start 'PT') which determines how far in the past data for this Tenant data will be accepted in the real-time ingestion pipeline." }, "metricDatasourceSettings": { "type": "object", "additionalProperties": { "$ref": "#/components/schemas/MetricDatasourceConfig" }, "description": "Holds a map of datasource granularity to properties that control how that granularity of metric datasource for the tenant is managed" }, "metricQueryConfig": { "$ref": "#/components/schemas/MetricQueryConfig" }, "alertConfig": { "$ref": "#/components/schemas/AlertConfig" } } }, "Attributes19": { "title": "Attributes19", "required": [ "_rev", "datatype", "tenantId", "tenantName", "metadataCategoryLimit", "aggregateDataCleaningThreshold", "deltaBatchCompactionDurationMinutes", "baselinePeriod", "ingestionVacuumSettings", "metricDatasourceSettings", "metricQueryConfig", "latentDataPeriod", "alertConfig", "createdTimestamp", "lastModifiedTimestamp" ], "type": "object", "properties": { "_rev": { "type": "string", "description": "Value used to ensure updates to this object are handled in order." }, "datatype": { "type": "string", "description": "Name used to identify this type of record in Datahub" }, "tenantId": { "type": "string", "description": "Unique identifier of a Tenant in Datahub" }, "tenantName": { "type": "string", "description": "The name of a Tenant in Datahub" }, "metadataCategoryLimit": { "type": "integer", "description": "The maximum amount of Metadata Categories allowed for this Tenant", "format": "int32" }, "aggregateDataCleaningThreshold": { "maximum": 1.0, "minimum": 0.0, "exclusiveMinimum": true, "type": "number", "description": "Percentage (0.0 - 1.0] of data points which must be marked as 'dirty' before the aggregated value will also be marked as 'dirty'" }, "deltaBatchCompactionDurationMinutes": { "maximum": 30.0, "minimum": 1.0, "type": "integer", "description": "The amount of time we will compact collected delta batch ingestion notifications before submitting them for ingestion", "format": "int32", "example": 5 }, "baselinePeriod": { "type": "string", "description": "ISO8601 format period (only Time variant i.e. must start 'PT') which determines how far in the past data will contribute to the baseline average values of metrics." }, "ingestionVacuumSettings": { "$ref": "#/components/schemas/IngestionVersionRetetionProperties" }, "metricDatasourceSettings": { "type": "object", "additionalProperties": { "$ref": "#/components/schemas/MetricDatasourceConfig" }, "description": "Holds a map of datasource granularity to properties that control how that granularity of metric datasource for the tenant is managed" }, "metricQueryConfig": { "$ref": "#/components/schemas/MetricQueryConfig" }, "latentDataPeriod": { "type": "string", "description": "ISO8601 format period (only Time variant i.e. must start 'PT') which determines how far in the past data for this Tenant data will be accepted in the real-time ingestion pipeline." }, "alertConfig": { "$ref": "#/components/schemas/AlertConfig" }, "createdTimestamp": { "type": "integer", "description": "Time since epoch at which this object was created.", "format": "int64" }, "lastModifiedTimestamp": { "type": "integer", "description": "Time since epoch at which this object was last altered.", "format": "int64" } } }, "Attributes20": { "title": "Attributes20", "type": "object", "properties": { "filters": { "$ref": "#/components/schemas/ActiveAlertsFilteredListRequest" }, "value": { "type": "number" } } }, "Attributes21": { "title": "Attributes21", "type": "object", "properties": { "aggregation": { "$ref": "#/components/schemas/Aggregation" }, "filters": { "$ref": "#/components/schemas/ActiveAlertsFilteredListRequest" } } }, "Attributes22": { "title": "Attributes22", "required": [ "groupingContext", "alerts", "result" ], "type": "object", "properties": { "queryContext": { "$ref": "#/components/schemas/ActiveAlertGroupByQueryContext" }, "metaContext": { "$ref": "#/components/schemas/MetaContext" }, "groupingContext": { "$ref": "#/components/schemas/GroupingContext" }, "aggregation": { "$ref": "#/components/schemas/SupportedAggregations" }, "expressions": { "$ref": "#/components/schemas/expressions" }, "alerts": { "type": "array", "items": { "$ref": "#/components/schemas/ActiveAlertSpec" }, "description": "A set of identifiers that considers specific alert based on the provided information" }, "enableSecurityMetrics": { "type": "boolean", "description": "Enable additional aggregations for each group of alerts", "default": false }, "result": { "type": "array", "items": { "$ref": "#/components/schemas/ActiveAlertGroupedResultEntryParameters" }, "description": "The rendered response structure from the metric query" } } }, "Attributes23": { "title": "Attributes23", "type": "object", "properties": { "request": { "$ref": "#/components/schemas/Request" } } }, "Attributes24": { "title": "Attributes24", "required": [ "tenantId", "_id", "_rev", "datatype", "request", "lastModifiedTimestamp" ], "type": "object", "properties": { "tenantId": { "type": "string", "description": "Unique identifier of the Tenant in Datahub" }, "_id": { "type": "string" }, "_rev": { "type": "string", "description": "Value used to ensure updates to this object are handled in order." }, "datatype": { "type": "string", "description": "Name used to identify this type of record in Datahub" }, "request": { "$ref": "#/components/schemas/Request1" }, "result": { "$ref": "#/components/schemas/Result" }, "createdTimestamp": { "type": "integer", "description": "Time since epoch at which this object was instantiated.", "format": "int64" }, "lastModifiedTimestamp": { "type": "integer", "description": "Time since epoch at which this object was last altered.", "format": "int64" } } }, "Attributes25": { "title": "Attributes25", "type": "object", "properties": { "color": { "type": "string", "description": "The primary colour used for the Datahub UI" }, "logo": { "$ref": "#/components/schemas/BrandingLogo" } } }, "Attributes26": { "title": "Attributes26", "required": [ "_rev" ], "type": "object", "properties": { "_rev": { "type": "string", "description": "Value used to ensure updates to this object are handled in order." }, "color": { "type": "string", "description": "The primary colour used for the Datahub UI" }, "logo": { "$ref": "#/components/schemas/BrandingLogo" } } }, "Attributes27": { "title": "Attributes27", "required": [ "_rev", "datatype", "color", "logo", "createdTimestamp", "lastModifiedTimestamp" ], "type": "object", "properties": { "_rev": { "type": "string", "description": "Value used to ensure updates to this object are handled in order." }, "datatype": { "type": "string" }, "tenantId": { "type": "string" }, "color": { "type": "string", "description": "The primary colour used for the Datahub UI" }, "logo": { "$ref": "#/components/schemas/BrandingLogo" }, "createdTimestamp": { "type": "integer", "description": "Time since epoch at which this object was instantiated.", "format": "int64" }, "lastModifiedTimestamp": { "type": "integer", "description": "Time since epoch at which this object was last altered.", "format": "int64" } } }, "Attributes28": { "title": "Attributes28", "required": [ "intl", "moment", "timezone" ], "type": "object", "properties": { "intl": { "type": "string", "description": "The short-form code for the internationalization region" }, "moment": { "type": "string" }, "timezone": { "type": "string", "description": "Timezone used to coordinate timestamps for the specified region" } } }, "Attributes29": { "title": "Attributes29", "required": [ "_rev" ], "type": "object", "properties": { "_rev": { "type": "string", "description": "Value used to ensure updates to this object are handled in order." }, "intl": { "type": "string", "description": "The short-form code for the internationalization region" }, "moment": { "type": "string" }, "timezone": { "type": "string", "description": "Timezone used to coordinate timestamps for the specified region" } } }, "Attributes30": { "title": "Attributes30", "required": [ "_rev", "datatype", "intl", "moment", "timezone", "createdTimestamp", "lastModifiedTimestamp" ], "type": "object", "properties": { "_rev": { "type": "string", "description": "Value used to ensure updates to this object are handled in order." }, "datatype": { "type": "string" }, "tenantId": { "type": "string" }, "intl": { "type": "string", "description": "The short-form code for the internationalization region" }, "moment": { "type": "string" }, "timezone": { "type": "string", "description": "Timezone used to coordinate timestamps for the specified region" }, "createdTimestamp": { "type": "integer", "description": "Time since epoch at which this object was instantiated.", "format": "int64" }, "lastModifiedTimestamp": { "type": "integer", "description": "Time since epoch at which this object was last altered.", "format": "int64" } } }, "Attributes31": { "title": "Attributes31", "required": [ "name", "direction", "vendor", "objectType", "operation" ], "type": "object", "properties": { "_id": { "type": "string" }, "_rev": { "type": "string" }, "tenantId": { "type": "string", "description": "Unique identifier of a Tenant in Datahub" }, "name": { "type": "string", "description": "Name of the composition" }, "direction": { "type": "string", "description": "The composite metric user's defined direction." }, "vendor": { "type": "string", "description": "The composite metric user's defined direction." }, "objectType": { "type": "array", "items": { "type": "string" }, "description": "Object types to be considered as part of the filter", "example": [ [ "twamp-pe" ], [ "twamp-sl", "twamp-sf" ] ] }, "description": { "type": "string", "description": "Space to provide in depth explanation of the composition." }, "enabled": { "type": "boolean", "description": "Used to enable/disable the composition from the GUI. Compositions are always available when using the RESTful API." }, "unitType": { "type": "string", "description": "The composite metric's unit of measurement.", "example": "us" }, "createdTimestamp": { "type": "integer", "description": "Time since epoch at which this object was instantiated.", "format": "int32" }, "lastModifiedTimestamp": { "type": "integer", "description": "Time since epoch at which this object was last altered.", "format": "int32" }, "operation": { "$ref": "#/components/schemas/CompositeMetricOperation" } } }, "Attributes32": { "title": "Attributes32", "required": [ "name", "direction", "vendor", "objectType", "enabled", "unitType", "operation" ], "type": "object", "properties": { "name": { "type": "string", "description": "Name of the composition" }, "direction": { "type": "string", "description": "The composite metric user's defined direction." }, "vendor": { "type": "string", "description": "The composite metric user's defined direction." }, "objectType": { "type": "array", "items": { "type": "string" }, "description": "Object types to be considered as part of the filter", "example": [ [ "twamp-pe" ], [ "twamp-sl", "twamp-sf" ] ] }, "description": { "type": "string", "description": "Space to provide in depth explanation of the composition." }, "enabled": { "type": "boolean", "description": "Used to enable/disable the composition from the GUI. Compositions are always available when using the RESTful API." }, "unitType": { "type": "string", "description": "The composite metric's unit of measurement." }, "operation": { "$ref": "#/components/schemas/CompositeMetricOperation" } } }, "Attributes33": { "title": "Attributes33", "required": [ "_rev" ], "type": "object", "properties": { "_rev": { "type": "string" }, "name": { "type": "string", "description": "Name of the composition" }, "direction": { "type": "string", "description": "The composite metric user's defined direction." }, "vendor": { "type": "string", "description": "The composite metric user's defined direction." }, "objectType": { "type": "array", "items": { "type": "string" }, "description": "Object types to be considered as part of the filter", "example": [ [ "twamp-pe" ], [ "twamp-sl", "twamp-sf" ] ] }, "description": { "type": "string", "description": "Space to provide in depth explanation of the composition." }, "enabled": { "type": "boolean" }, "unitType": { "type": "string", "description": "The composite metric's unit of measurement." }, "operation": { "$ref": "#/components/schemas/CompositeMetricOperation" } } }, "Attributes34": { "title": "Attributes34", "required": [ "url", "type" ], "type": "object", "properties": { "name": { "type": "string" }, "url": { "type": "string" }, "port": { "type": "integer", "format": "int32" }, "pollingFrequency": { "type": "integer", "format": "int32", "default": 60 }, "username": { "type": "string" }, "password": { "type": "string" }, "exportGroup": { "type": "string" }, "datahubHeartbeatFrequency": { "type": "integer", "format": "int32" }, "datahubConnectionRetryFrequency": { "type": "integer", "format": "int32" }, "type": { "type": "string" }, "zone": { "pattern": "^[a-zA-Z0-9:_-]*$", "type": "string" }, "prometheusAddr": { "type": "string", "description": "When set, instructs roadrunner to connect to this local prometheus store intermediary metrics" }, "prometheusPort": { "type": "integer", "format": "int32" }, "ciscoTelemetryConfig": { "$ref": "#/components/schemas/CiscoTelemetryConfig" }, "openMetricsConfig": { "$ref": "#/components/schemas/OpenMetricsConfig" }, "openMetricsScraperConfig": { "$ref": "#/components/schemas/OpenMetricsScraperConfig" }, "agentProxyConfig": { "$ref": "#/components/schemas/AgentProxyConfig" }, "SNMPConfig": { "$ref": "#/components/schemas/SNMPConfig" }, "SNMPTrapSenderConfig": { "$ref": "#/components/schemas/SNMPTrapSenderConfig" }, "MQTTConfig": { "$ref": "#/components/schemas/MQTTConfig" }, "restartRoadrunner": { "type": "boolean", "description": "Triggers a restart of roadrunner on configuration reload" }, "pauseRoadRunnerMetricIngestion": { "type": "boolean", "description": "Pauses RoadRunner Ingestion", "default": false }, "sessionFilterProfileID": { "type": "string", "description": "If set, RR will fetch and use the session filter profile for the given ID." } } }, "Attributes35": { "title": "Attributes35", "required": [ "_rev" ], "type": "object", "properties": { "_rev": { "type": "string", "description": "Value used to ensure updates to this object are handled in order." }, "name": { "type": "string" }, "url": { "type": "string" }, "port": { "type": "integer", "format": "int32" }, "pollingFrequency": { "type": "integer", "format": "int32" }, "username": { "type": "string" }, "password": { "type": "string" }, "exportGroup": { "type": "string" }, "datahubHeartbeatFrequency": { "type": "integer", "format": "int32" }, "datahubConnectionRetryFrequency": { "type": "integer", "format": "int32" }, "type": { "type": "string" }, "zone": { "pattern": "^[a-zA-Z0-9_-]*$", "type": "string" }, "prometheusAddr": { "type": "string", "description": "When set, instructs roadrunner to connect to this local prometheus store intermediary metrics" }, "prometheusPort": { "type": "integer", "format": "int32" }, "ciscoTelemetryConfig": { "$ref": "#/components/schemas/CiscoTelemetryConfig" }, "openMetricsConfig": { "$ref": "#/components/schemas/OpenMetricsConfig" }, "openMetricsScraperConfig": { "$ref": "#/components/schemas/OpenMetricsScraperConfig" }, "agentProxyConfig": { "$ref": "#/components/schemas/AgentProxyConfig" }, "SNMPConfig": { "$ref": "#/components/schemas/SNMPConfig" }, "SNMPTrapSenderConfig": { "$ref": "#/components/schemas/SNMPTrapSenderConfig" }, "MQTTConfig": { "$ref": "#/components/schemas/MQTTConfig" }, "sessionFilterProfileID": { "type": "string", "description": "If set, RR will fetch and use the session filter profile for the given ID." } } }, "Attributes36": { "title": "Attributes36", "required": [ "_rev", "url", "pollingFrequency", "type", "createdTimestamp", "lastModifiedTimestamp" ], "type": "object", "properties": { "_rev": { "type": "string", "description": "Value used to ensure updates to this object are handled in order." }, "loglvl": { "$ref": "#/components/schemas/Loglvl" }, "datatype": { "type": "string" }, "tenantId": { "type": "string" }, "name": { "type": "string" }, "url": { "type": "string" }, "port": { "type": "integer", "format": "int32" }, "pollingFrequency": { "type": "integer", "format": "int32" }, "username": { "type": "string" }, "password": { "type": "string" }, "exportGroup": { "type": "string" }, "datahubHeartbeatFrequency": { "type": "integer", "format": "int32" }, "datahubConnectionRetryFrequency": { "type": "integer", "format": "int32" }, "type": { "type": "string" }, "zone": { "type": "string" }, "createdTimestamp": { "type": "integer", "description": "Time since epoch at which this object was instantiated.", "format": "int64" }, "lastModifiedTimestamp": { "type": "integer", "description": "Time since epoch at which this object was last altered.", "format": "int64" }, "connectorInstanceId": { "type": "string", "description": "When set, describes the connectorInstanceId that corresponds to a roadrunner connection and that is currently using this connectorConfig" }, "prometheusAddr": { "type": "string", "description": "When set, instructs roadrunner to connect to this local prometheus store intermediary metrics" }, "prometheusPort": { "type": "integer", "format": "int32" }, "SNMPConfig": { "$ref": "#/components/schemas/SNMPConfig" }, "SNMPTrapSenderConfig": { "$ref": "#/components/schemas/SNMPTrapSenderConfig" }, "MQTTConfig": { "$ref": "#/components/schemas/MQTTConfig" }, "ciscoTelemetryConfig": { "$ref": "#/components/schemas/CiscoTelemetryConfig" }, "openMetricsConfig": { "$ref": "#/components/schemas/OpenMetricsConfig" }, "openMetricsScraperConfig": { "$ref": "#/components/schemas/OpenMetricsScraperConfig" }, "agentProxyConfig": { "$ref": "#/components/schemas/AgentProxyConfig" }, "sessionFilterProfileID": { "type": "string", "description": "If set, RR will fetch and use the session filter profile for the given ID." } } }, "Attributes37": { "title": "Attributes37", "required": [ "status", "hostname" ], "type": "object", "properties": { "status": { "type": "string" }, "hostname": { "type": "string" } } }, "Attributes38": { "title": "Attributes38", "required": [ "_rev" ], "type": "object", "properties": { "_rev": { "type": "string", "description": "Value used to ensure updates to this object are handled in order." }, "status": { "type": "string" }, "hostname": { "type": "string" }, "createdTimestamp": { "type": "integer", "description": "Time since epoch at which this object was instantiated.", "format": "int64" }, "lastModifiedTimestamp": { "type": "integer", "description": "Time since epoch at which this object was last altered.", "format": "int64" } } }, "Attributes39": { "title": "Attributes39", "required": [ "_rev", "datatype", "tenantId", "status", "hostname", "createdTimestamp", "lastModifiedTimestamp" ], "type": "object", "properties": { "_rev": { "type": "string", "description": "Value used to ensure updates to this object are handled in order." }, "datatype": { "type": "string" }, "tenantId": { "type": "string" }, "status": { "type": "string" }, "hostname": { "type": "string" }, "createdTimestamp": { "type": "integer", "description": "Time since epoch at which this object was instantiated.", "format": "int64" }, "lastModifiedTimestamp": { "type": "integer", "description": "Time since epoch at which this object was last altered.", "format": "int64" } } }, "Attributes40": { "title": "Attributes40", "type": "object", "properties": { "ip": { "type": "string" }, "mac": { "type": "string" }, "roles": { "type": "array", "items": { "$ref": "#/components/schemas/NetworkAssetRole" }, "description": "" }, "meta": { "type": "object", "additionalProperties": { "type": "string" }, "description": "Attributes added to a Network Asset that help identify the Network Asset as well as provide filtering/grouping properties" }, "firstSeen": { "type": "integer", "format": "int64" }, "lastSeen": { "type": "integer", "format": "int64" } } }, "Attributes41": { "title": "Attributes41", "type": "object", "properties": { "filters": { "$ref": "#/components/schemas/NetworkAssetFilteredListRequest" }, "count": { "type": "integer", "format": "int32" } } }, "Attributes42": { "title": "Attributes42", "required": [ "groupingContext", "networkAssets", "result" ], "type": "object", "properties": { "queryContext": { "$ref": "#/components/schemas/NetworkAssetQueryContext" }, "metaContext": { "$ref": "#/components/schemas/MetaContext" }, "groupingContext": { "$ref": "#/components/schemas/GroupingContext" }, "aggregation": { "$ref": "#/components/schemas/SupportedAggregations" }, "networkAssets": { "type": "array", "items": { "$ref": "#/components/schemas/NetworkAssetSpec" }, "description": "A set of identifiers that considers specific network asset based on the provided information" }, "result": { "type": "array", "items": { "$ref": "#/components/schemas/NetworkAssetGroupedResultEntryParameters" }, "description": "The rendered response structure from the network asset query" } } }, "Attributes43": { "title": "Attributes43", "required": [ "name" ], "type": "object", "properties": { "name": { "type": "string", "description": "User provided identifier for a Dashboard" }, "category": { "type": "string", "description": "Name of the visual 'group' where this Dashboard will be displayed when looking at the list of all Dashboards in Datahub" }, "metaExclude": { "type": "array", "items": { "type": "string" }, "description": "An array that allows blacklisting one or more metadata criteria. Each key in the array must correspond to a given key in the MetaFilter portion of the request. This exclusion is a logical NOT for any values belonging to the metadata criteria listed in this request. For example, if the MetaFilter is: {\"region\":[\"montreal\",\"ottawa\"], \"group\":[\"radio\"]}, we can have a MetaExclude of the form [\"region\"]. This would result in a request that includes any records that are of group \"radio\" AND NOT in regions Ottawa or Montreal.", "example": [ "group" ] }, "metadataFilters": { "type": "array", "items": { "$ref": "#/components/schemas/MetadataFilter" }, "description": "List of filters used to obtain a list of Monitoreed Objects which will be useds to provide metric data to the Dashboard" }, "cardPositions": { "type": "object", "additionalProperties": { "$ref": "#/components/schemas/CardPositions1" }, "description": "Describes the locations of the Cards on the Dashboard in the Datahub UI" }, "_permissions": { "type": "array", "items": { "type": "string" }, "description": "" }, "sharedWithAll": { "$ref": "#/components/schemas/SharedWithAll" } } }, "Attributes44": { "title": "Attributes44", "required": [ "_rev", "name" ], "type": "object", "properties": { "_rev": { "type": "string", "description": "Value used to ensure updates to this object are handled in order." }, "name": { "type": "string", "description": "User provided identifier for a Dashboard" }, "category": { "type": "string", "description": "Name of the visual 'group' where this Dashboard will be displayed when looking at the list of all Dashboards in Datahub" }, "metaExclude": { "type": "array", "items": { "type": "string" }, "description": "An array that allows blacklisting one or more metadata criteria. Each key in the array must correspond to a given key in the MetaFilter portion of the request. This exclusion is a logical NOT for any values belonging to the metadata criteria listed in this request. For example, if the MetaFilter is: {\"region\":[\"montreal\",\"ottawa\"], \"group\":[\"radio\"]}, we can have a MetaExclude of the form [\"region\"]. This would result in a request that includes any records that are of group \"radio\" AND NOT in regions Ottawa or Montreal.", "example": [ "group" ] }, "metadataFilters": { "type": "array", "items": { "$ref": "#/components/schemas/MetadataFilter" }, "description": "List of filters used to obtain a list of Monitoreed Objects which will be useds to provide metric data to the Dashboard" }, "cardPositions": { "type": "object", "additionalProperties": { "$ref": "#/components/schemas/CardPositions1" }, "description": "Describes the locations of the Cards on the Dashboard in the Datahub UI" }, "_permissions": { "type": "array", "items": { "type": "string" }, "description": "" }, "sharedWithAll": { "$ref": "#/components/schemas/SharedWithAll" } } }, "Attributes45": { "title": "Attributes45", "required": [ "_rev", "datatype", "tenantId", "name", "category", "metaExclude", "metadataFilters", "cardPositions", "createdTimestamp", "lastModifiedTimestamp" ], "type": "object", "properties": { "_rev": { "type": "string", "description": "Value used to ensure updates to this object are handled in order." }, "datatype": { "type": "string", "description": "Name used to identify this type of record in Datahub" }, "tenantId": { "type": "string", "description": "Unique identifier of a Tenant in Datahub" }, "name": { "type": "string", "description": "User provided identifier for a Dashboard" }, "category": { "type": "string", "description": "Name of the visual 'group' where this Dashboard will be displayed when looking at the list of all Dashboards in Datahub" }, "metaExclude": { "type": "array", "items": { "type": "string" }, "description": "An array that allows blacklisting one or more metadata criteria. Each key in the array must correspond to a given key in the MetaFilter portion of the request. This exclusion is a logical NOT for any values belonging to the metadata criteria listed in this request. For example, if the MetaFilter is: {\"region\":[\"montreal\",\"ottawa\"], \"group\":[\"radio\"]}, we can have a MetaExclude of the form [\"region\"]. This would result in a request that includes any records that are of group \"radio\" AND NOT in regions Ottawa or Montreal.", "example": [ "group" ] }, "metadataFilters": { "type": "array", "items": { "$ref": "#/components/schemas/MetadataFilter" }, "description": "List of filters used to obtain a list of Monitoreed Objects which will be useds to provide metric data to the Dashboard" }, "cardPositions": { "type": "object", "additionalProperties": { "$ref": "#/components/schemas/CardPositions1" }, "description": "Describes the locations of the Cards on the Dashboard in the Datahub UI" }, "createdTimestamp": { "type": "integer", "format": "int64" }, "lastModifiedTimestamp": { "type": "integer", "description": "Time since epoch at which this object was last altered.", "format": "int64" }, "_permissions": { "type": "array", "items": { "type": "string" }, "description": "" }, "sharedWithAll": { "$ref": "#/components/schemas/SharedWithAll" } } }, "Attributes46": { "title": "Attributes46", "required": [ "name", "state" ], "type": "object", "properties": { "name": { "type": "string" }, "description": { "type": "string" }, "state": { "$ref": "#/components/schemas/State3" }, "visualization": { "$ref": "#/components/schemas/CardVisualization" }, "metaExclude": { "type": "array", "items": { "type": "string" }, "description": "An array that allows blacklisting one or more metadata criteria. Each key in the array must correspond to a given key in the MetaFilter portion of the request. This exclusion is a logical NOT for any values belonging to the metadata criteria listed in this request. For example, if the MetaFilter is: {\"region\":[\"montreal\",\"ottawa\"], \"group\":[\"radio\"]}, we can have a MetaExclude of the form [\"region\"]. This would result in a request that includes any records that are of group \"radio\" AND NOT in regions Ottawa or Montreal.", "example": [ "group" ] }, "metadataFilters": { "type": "array", "items": { "$ref": "#/components/schemas/MetadataFilter" }, "description": "" }, "metrics": { "type": "array", "items": { "$ref": "#/components/schemas/CardMetric" }, "description": "" } } }, "Attributes47": { "title": "Attributes47", "required": [ "_rev" ], "type": "object", "properties": { "_rev": { "type": "string", "description": "Value used to ensure updates to this object are handled in order." }, "name": { "type": "string" }, "description": { "type": "string" }, "state": { "$ref": "#/components/schemas/State3" }, "visualization": { "$ref": "#/components/schemas/CardVisualization" }, "metaExclude": { "type": "array", "items": { "type": "string" }, "description": "An array that allows blacklisting one or more metadata criteria. Each key in the array must correspond to a given key in the MetaFilter portion of the request. This exclusion is a logical NOT for any values belonging to the metadata criteria listed in this request. For example, if the MetaFilter is: {\"region\":[\"montreal\",\"ottawa\"], \"group\":[\"radio\"]}, we can have a MetaExclude of the form [\"region\"]. This would result in a request that includes any records that are of group \"radio\" AND NOT in regions Ottawa or Montreal.", "example": [ "group" ] }, "metadataFilters": { "type": "array", "items": { "$ref": "#/components/schemas/MetadataFilter" }, "description": "" }, "metrics": { "type": "array", "items": { "$ref": "#/components/schemas/CardMetric" }, "description": "" } } }, "Attributes48": { "title": "Attributes48", "required": [ "_rev", "datatype", "tenantId", "name", "description", "state", "visualization", "metaExclude", "metadataFilters", "metrics", "createdTimestamp", "lastModifiedTimestamp" ], "type": "object", "properties": { "_rev": { "type": "string", "description": "Value used to ensure updates to this object are handled in order." }, "datatype": { "type": "string", "description": "Name used to identify this type of record in Datahub" }, "tenantId": { "type": "string", "description": "Unique identifier of a Tenant in Datahub" }, "name": { "type": "string", "description": "User provided identifier for a Card" }, "description": { "type": "string", "description": "User provided description for a Card" }, "state": { "$ref": "#/components/schemas/State3" }, "visualization": { "$ref": "#/components/schemas/CardVisualization" }, "metaExclude": { "type": "array", "items": { "type": "string" }, "description": "An array that allows blacklisting one or more metadata criteria. Each key in the array must correspond to a given key in the MetaFilter portion of the request. This exclusion is a logical NOT for any values belonging to the metadata criteria listed in this request. For example, if the MetaFilter is: {\"region\":[\"montreal\",\"ottawa\"], \"group\":[\"radio\"]}, we can have a MetaExclude of the form [\"region\"]. This would result in a request that includes any records that are of group \"radio\" AND NOT in regions Ottawa or Montreal.", "example": [ "group" ] }, "metadataFilters": { "type": "array", "items": { "$ref": "#/components/schemas/MetadataFilter" }, "description": "" }, "metrics": { "type": "array", "items": { "$ref": "#/components/schemas/CardMetric" }, "description": "A list of the data which will be displayed in the Card visualization" }, "createdTimestamp": { "type": "integer", "description": "Time since epoch at which this object was instantiated.", "format": "int32" }, "lastModifiedTimestamp": { "type": "integer", "description": "Time since epoch at which this object was last altered.", "format": "int32" } } }, "Attributes49": { "title": "Attributes49", "required": [ "rules" ], "type": "object", "properties": { "rules": { "type": "array", "items": { "$ref": "#/components/schemas/DataCleaningRule" }, "description": "List of all the rules to evaluate for Data Cleaning" } } }, "Attributes50": { "title": "Attributes50", "required": [ "_rev", "rules" ], "type": "object", "properties": { "_rev": { "type": "string", "description": "Value used to ensure updates to this object are handled in order." }, "rules": { "type": "array", "items": { "$ref": "#/components/schemas/DataCleaningRule" }, "description": "List of all the rules to evaluate for Data Cleaning" } } }, "Attributes51": { "title": "Attributes51", "required": [ "_rev", "rules", "createdTimestamp", "lastModifiedTimestamp" ], "type": "object", "properties": { "_rev": { "type": "string", "description": "Value used to ensure updates to this object are handled in order." }, "rules": { "type": "array", "items": { "$ref": "#/components/schemas/DataCleaningRule" }, "description": "List of all the rules to evaluate for Data Cleaning" }, "createdTimestamp": { "type": "integer", "description": "Time since epoch at which this object was instantiated.", "format": "int64" }, "lastModifiedTimestamp": { "type": "integer", "description": "Time since epoch at which this object was last altered.", "format": "int64" } } }, "Attributes52": { "title": "Attributes52", "type": "object", "properties": { "transitions": { "type": "array", "items": { "$ref": "#/components/schemas/DataCleaningTransition" }, "description": "List of data cleaning events" } } }, "Attributes53": { "title": "Attributes53", "required": [ "metrics" ], "type": "object", "properties": { "metrics": { "$ref": "#/components/schemas/IngestionProfileMetrics" }, "metricList": { "type": "array", "items": { "$ref": "#/components/schemas/IngestionProfileMetricListItem" }, "description": "" } } }, "Attributes54": { "title": "Attributes54", "required": [ "_rev" ], "type": "object", "properties": { "_rev": { "type": "string", "description": "Value used to ensure updates to this object are handled in order." }, "metrics": { "$ref": "#/components/schemas/IngestionProfileMetrics" }, "metricList": { "type": "array", "items": { "$ref": "#/components/schemas/IngestionProfileMetricListItem" }, "description": "A list of objects that allow customization on which Metrics will be available to query from Datahub" } } }, "Attributes55": { "title": "Attributes55", "required": [ "tenantId", "_id", "_rev", "metrics", "createdTimestamp", "lastModifiedTimestamp" ], "type": "object", "properties": { "tenantId": { "type": "string", "description": "Unique identifier of the Tenant in Datahub" }, "_id": { "type": "string" }, "_rev": { "type": "string", "description": "Value used to ensure updates to this object are handled in order." }, "datatype": { "type": "string", "description": "Name used to identify this type of record in Datahub" }, "metrics": { "$ref": "#/components/schemas/IngestionProfileMetrics" }, "metricList": { "type": "array", "items": { "$ref": "#/components/schemas/IngestionProfileMetricListItem" }, "description": "A collection of Metric descriptors that determine which metrics will be recorded by Datahub" }, "createdTimestamp": { "type": "integer", "description": "Time since epoch at which this object was instantiated.", "format": "int64" }, "lastModifiedTimestamp": { "type": "integer", "description": "Time since epoch at which this object was last altered.", "format": "int64" } } }, "Attributes56": { "title": "Attributes56", "required": [ "startPoint", "endPoint", "midPoints" ], "type": "object", "properties": { "startPoint": { "type": "string", "description": "The first point of a Logical Map" }, "endPoint": { "type": "string", "description": "The last point of a Logical Map" }, "midPoints": { "type": "array", "items": { "type": "string" }, "description": "The points between the startPoint and endPoint of a logical map" }, "geo": { "$ref": "#/components/schemas/MetadataConfigGeo" } } }, "Attributes57": { "title": "Attributes57", "required": [ "_rev" ], "type": "object", "properties": { "_rev": { "type": "string", "description": "Value used to ensure updates to this object are handled in order." }, "startPoint": { "type": "string", "description": "The first point of a Logical Map" }, "endPoint": { "type": "string", "description": "The last point of a Logical Map" }, "midPoints": { "type": "array", "items": { "type": "string" }, "description": "The points between the startPoint and endPoint of a logical map" }, "geo": { "$ref": "#/components/schemas/MetadataConfigGeo" } } }, "Attributes58": { "title": "Attributes58", "required": [ "tenantId", "_id", "_rev", "startPoint", "endPoint", "midPoints", "createdTimestamp", "lastModifiedTimestamp" ], "type": "object", "properties": { "tenantId": { "type": "string", "description": "Unique identifier of the Tenant in Datahub" }, "_id": { "type": "string" }, "_rev": { "type": "string", "description": "Value used to ensure updates to this object are handled in order." }, "datatype": { "type": "string", "description": "Name used to identify this type of record in Datahub" }, "startPoint": { "type": "string", "description": "The first point of a Logical Map" }, "endPoint": { "type": "string", "description": "The last point of a Logical Map" }, "midPoints": { "type": "array", "items": { "type": "string" }, "description": "The points between the startPoint and endPoint of a logical map" }, "geo": { "$ref": "#/components/schemas/MetadataConfigGeo" }, "createdTimestamp": { "type": "integer", "description": "Time since epoch at which this object was instantiated.", "format": "int64" }, "lastModifiedTimestamp": { "type": "integer", "description": "Time since epoch at which this object was last altered.", "format": "int64" } } }, "Attributes59": { "title": "Attributes59", "required": [ "tenantId", "_id", "datatype", "baselines" ], "type": "object", "properties": { "tenantId": { "type": "string", "description": "Unique identifier of the Tenant in Datahub" }, "_id": { "type": "string" }, "datatype": { "type": "string", "description": "Name used to identify this type of record in Datahub" }, "monitoredObjectId": { "type": "string", "description": "Unique identifier of the Monitored Object for which these baselines are applicable" }, "hourOfWeek": { "maximum": 167.0, "minimum": 0.0, "type": "integer", "description": "Integer value of the day of the week and hour of day for which this baseline is calculated. Values are 0-167 which corresponds to each our of each day in one week", "format": "int32" }, "baselines": { "type": "array", "items": { "$ref": "#/components/schemas/MetricBaselineData" }, "description": "Contains the dynamically calculated baseline values for the metrics collected by Datahub" } } }, "Attributes60": { "title": "Attributes60", "required": [ "_rev", "datatype", "tenantId", "duplicateMap", "createdTimestamp", "lastModifiedTimestamp" ], "type": "object", "properties": { "_rev": { "type": "string", "description": "Value used to ensure updates to this object are handled in order." }, "datatype": { "type": "string" }, "tenantId": { "type": "string" }, "duplicateMap": { "type": "object", "additionalProperties": {}, "description": "A map of Monitored Object Name to a list of Monitored Object Ids of Monitored Objects that all share the same name" }, "createdTimestamp": { "type": "integer", "description": "Time since epoch at which this object was instantiated.", "format": "int64" }, "lastModifiedTimestamp": { "type": "integer", "description": "Time since epoch at which this object was last altered.", "format": "int64" } } }, "Attributes61": { "title": "Attributes61", "required": [ "tag", "monitoredObjectIdList" ], "type": "object", "properties": { "tag": { "type": "string", "description": "User provided identifier for a MonitoredObjectTagMapping" }, "monitoredObjectIdList": { "type": "array", "items": { "type": "string" }, "description": "List of Monitored Object IDs that are grouped by the Tag" } } }, "Attributes62": { "title": "Attributes62", "required": [ "_rev", "tag", "monitoredObjectIdList" ], "type": "object", "properties": { "_rev": { "type": "string", "description": "Value used to ensure updates to this object are handled in order." }, "tag": { "type": "string", "description": "User provided identifier for a MonitoredObjectTagMapping" }, "monitoredObjectIdList": { "type": "array", "items": { "type": "string" }, "description": "List of Monitored Object IDs that are grouped by the Tag" } } }, "Attributes63": { "title": "Attributes63", "required": [ "_rev", "datatype", "tenantId", "tag", "monitoredObjectIdList", "createdTimestamp", "lastModifiedTimestamp" ], "type": "object", "properties": { "_rev": { "type": "string", "description": "Value used to ensure updates to this object are handled in order." }, "datatype": { "type": "string", "description": "Name used to identify this type of record in Datahub" }, "tenantId": { "type": "string", "description": "Unique identifier of a Tenant in Datahub" }, "tag": { "type": "string", "description": "User provided identifier for a MonitoredObjectTagMapping" }, "monitoredObjectIdList": { "type": "array", "items": { "type": "string" }, "description": "List of Monitored Object IDs that are grouped by the Tag" }, "createdTimestamp": { "type": "integer", "format": "int64" }, "lastModifiedTimestamp": { "type": "integer", "description": "Time since epoch at which this object was last altered.", "format": "int64" } } }, "Attributes64": { "title": "Attributes64", "required": [ "objectId" ], "type": "object", "properties": { "objectId": { "type": "string", "description": "Unique identifier of the Monitored Object in Datahub" }, "actuatorName": { "type": "string", "description": "Name of the origin of the Monitored Object" }, "actuatorType": { "$ref": "#/components/schemas/ActuatorType" }, "reflectorName": { "type": "string", "description": "Name of the target of the Monitored Object" }, "reflectorType": { "$ref": "#/components/schemas/ReflectorType" }, "objectName": { "type": "string", "description": "Name of the Monitored Object" }, "objectType": { "type": "string", "description": "Type of the Monitored Object. For instance, possible values are [unknown, flowmeter, twamp-pe, twamp-sf, twamp-sl, cisco-interface, cisco-node-summary, pvx, paa, \nregulator, rfc8321, dmm, slm, eth-dm, eth-vs, port, sa, sa-metrics, pl, iperf, echo-icmp, echo-udp]. If using dynamic types (i.e, for SNMP), you must enter the name of the dynamic type here" }, "meta": { "type": "object", "additionalProperties": { "type": "string" }, "description": "Attributes added to a Monitored Object that help identify the Monitored Object as well as provide flitering/grouping properties", "example": { "region": "paris", "wgs87_x": "-45.7123912", "wgs87_y": "-74.2130912" } }, "sourceLocation": { "$ref": "#/components/schemas/MonitoredObjectLocation" }, "destinationLocation": { "$ref": "#/components/schemas/MonitoredObjectLocation" }, "topology": { "type": "array", "items": { "type": "string" }, "description": "Tags used to describe the path segments associated with the Monitored Object" } } }, "Attributes65": { "title": "Attributes65", "required": [ "_rev", "objectId", "actuatorName", "actuatorType", "reflectorName", "reflectorType", "objectName", "objectType", "createdTimestamp", "topology" ], "type": "object", "properties": { "_rev": { "type": "string", "description": "Value used to ensure updates to this object are handled in order." }, "objectId": { "type": "string", "description": "Unique identifier of the Monitored Object in Datahub" }, "actuatorName": { "type": "string", "description": "Name of the origin of the Monitored Object", "example": "unknown" }, "actuatorType": { "$ref": "#/components/schemas/ActuatorType" }, "reflectorName": { "type": "string", "description": "Name of the target of the Monitored Object", "example": "unknown" }, "reflectorType": { "$ref": "#/components/schemas/ReflectorType" }, "objectName": { "type": "string", "description": "Name of the Monitored Object" }, "objectType": { "type": "string", "description": "Type of the Monitored Object. For instance, possible values are [unknown, flowmeter, twamp-pe, twamp-sf, twamp-sl, cisco-interface, cisco-node-summary, pvx, paa, \nregulator, rfc8321, dmm, slm, eth-dm, eth-vs, port, sa, sa-metrics, pl, iperf, echo-icmp, echo-udp]. If using dynamic types (i.e, for SNMP), you must enter the name of the dynamic type here" }, "createdTimestamp": { "type": "integer", "description": "Time since epoch at which this object was instantiated.", "format": "int32" }, "meta": { "type": "object", "additionalProperties": { "type": "string" }, "description": "Attributes added to a Monitored Object that help identify the Monitored Object as well as provide flitering/grouping properties", "example": { "region": "paris", "wgs87_x": "-45.7123912", "wgs87_y": "-74.2130912" } }, "sourceLocation": { "$ref": "#/components/schemas/MonitoredObjectLocation" }, "destinationLocation": { "$ref": "#/components/schemas/MonitoredObjectLocation" }, "topology": { "type": "array", "items": { "type": "string" }, "description": "Tags used to describe the path segments associated with the Monitored Object" }, "archiveTimestamp": { "type": "integer", "description": "Time since epoch at which this object was archived.", "format": "int64", "default": 0 } } }, "Attributes66": { "title": "Attributes66", "required": [ "_rev", "objectId", "actuatorName", "actuatorType", "reflectorName", "reflectorType", "objectName", "objectType", "sourceLocation", "topology", "archiveTimestamp", "createdTimestamp" ], "type": "object", "properties": { "_rev": { "type": "string", "description": "Value used to ensure updates to this object are handled in order." }, "datatype": { "type": "string", "description": "Name used to identify this type of record in Datahub" }, "tenantId": { "type": "string", "description": "Unique identifier of the Tenant in Datahub" }, "objectId": { "type": "string", "description": "Unique identifier of the Monitored Object in Datahub" }, "reportingMonitoredObjectId": { "type": "string", "description": "Unique identifier the object is reported with. This may change, while the objectId can never change" }, "actuatorName": { "type": "string", "description": "Name of the origin of the Monitored Object" }, "actuatorType": { "$ref": "#/components/schemas/ActuatorType" }, "reflectorName": { "type": "string", "description": "Name of the target of the Monitored Object" }, "reflectorType": { "$ref": "#/components/schemas/ReflectorType" }, "objectName": { "type": "string", "description": "Common name of the Monitored Object" }, "objectType": { "type": "string", "description": "Type of the Monitored Object. For instance, possible values are [unknown, flowmeter, twamp-pe, twamp-sf, twamp-sl, cisco-interface, cisco-node-summary, pvx, paa, \nregulator, rfc8321, dmm, slm, eth-dm, eth-vs, port, sa, sa-metrics, pl, iperf, echo-icmp, echo-udp]. If using dynamic types (i.e, for SNMP), you must enter the name of the dynamic type here" }, "meta": { "type": "object", "additionalProperties": { "type": "string" }, "description": "Attributes added to a Monitored Object that help identify the Monitored Object as well as provide flitering/grouping properties", "example": { "region": "paris", "wgs87_x": "-45.7123912", "wgs87_y": "-74.2130912" } }, "sourceLocation": { "$ref": "#/components/schemas/MonitoredObjectLocation" }, "destinationLocation": { "$ref": "#/components/schemas/MonitoredObjectLocation" }, "topology": { "type": "array", "items": { "type": "string" }, "description": "Tags used to describe the path segments associated with the Monitored Object" }, "archiveTimestamp": { "type": "integer", "description": "Time since epoch at which this object was archived.", "format": "int64" }, "createdTimestamp": { "type": "integer", "description": "Time since epoch at which this object was instantiated.", "format": "int64" }, "lastModifiedTimestamp": { "type": "integer", "description": "Time since epoch at which this object was last altered.", "format": "int64" }, "previousIdentities": { "type": "array", "items": { "$ref": "#/components/schemas/PreviousIdentity" }, "description": "" } } }, "Attributes67": { "title": "Attributes67", "type": "object", "properties": { "ok": { "type": "boolean" }, "id": { "type": "string" }, "rev": { "type": "string" }, "error": { "type": "string" }, "reason": { "type": "string" } }, "description": "Provides the result of multiple operations that were issued in a single request to Datahub" }, "Attributes68": { "title": "Attributes68", "type": "object", "properties": { "metadata-entries": { "type": "array", "items": { "$ref": "#/components/schemas/MetadataEntry" }, "description": "" } } }, "Attributes69": { "title": "Attributes69", "type": "object", "properties": { "actuatorName": { "type": "string", "description": "Name of the origin of the Monitored Object", "default": "unknown" }, "actuatorType": { "$ref": "#/components/schemas/ActuatorType" }, "reflectorName": { "type": "string", "description": "Name of the target of the Monitored Object", "default": "unknown" }, "reflectorType": { "$ref": "#/components/schemas/ReflectorType" }, "objectType": { "type": "string", "description": "Type of the Monitored Object. For instance, possible values are [unknown, flowmeter, twamp-pe, twamp-sf, twamp-sl, cisco-interface, cisco-node-summary, pvx, paa, \nregulator, rfc8321, dmm, slm, eth-dm, eth-vs, port, sa, sa-metrics, pl, iperf, echo-icmp, echo-udp]. If using dynamic types (i.e, for SNMP), you must enter the name of the dynamic type here" }, "meta": { "type": "object", "additionalProperties": { "type": "string" }, "description": "Attributes added to a Monitored Object that help identify the Monitored Object as well as provide flitering/grouping properties", "example": { "region": "paris", "wgs87_x": "-45.7123912", "wgs87_y": "-74.2130912" } }, "sourceLocation": { "$ref": "#/components/schemas/MonitoredObjectLocation" }, "destinationLocation": { "$ref": "#/components/schemas/MonitoredObjectLocation" }, "topology": { "type": "array", "items": { "type": "string" }, "description": "Tags used to describe the path segments associated with the Monitored Object" } } }, "Attributes70": { "title": "Attributes70", "type": "object", "properties": { "totalCount": { "type": "integer", "format": "int32" }, "groupedCounts": { "type": "object", "additionalProperties": { "type": "integer", "format": "int32" } } } }, "Attributes71": { "title": "Attributes71", "type": "object", "properties": { "resourceIdentifiers": { "type": "array", "items": { "type": "string" }, "description": "" } } }, "Attributes72": { "title": "Attributes72", "required": [ "datatype", "tenantId", "countPerValueMap" ], "type": "object", "properties": { "datatype": { "type": "string", "description": "Name used to identify this type of record in Datahub" }, "tenantId": { "type": "string", "description": "Unique identifier of the Tenant in Datahub" }, "countPerValueMap": { "type": "object", "additionalProperties": { "type": "integer", "format": "int64" }, "description": "Contains a map of metadata category names to the values and their corresponding count of Monitored Objects that use the Metadata value" } } }, "Attributes73": { "title": "Attributes73", "type": "object", "properties": { "datatype": { "type": "string", "description": "Name used to identify this type of record in Datahub" }, "clusters": { "type": "array", "items": { "$ref": "#/components/schemas/Cluster1" }, "description": "" } } }, "Attributes74": { "title": "Attributes74", "type": "object", "properties": { "tenantId": { "type": "string", "description": "Unique identifier of the Tenant in Datahub" }, "objectId": { "type": "string", "description": "Unique identifier of the Monitored Object in Datahub" }, "objectName": { "type": "string", "description": "Common name of the Monitored Object" }, "meta": { "type": "object", "additionalProperties": { "type": "string" }, "description": "The map of the metrics column and value that should be entered into that column" }, "srcLat": { "type": "number", "description": "Geographic latitude of Monitored Object source" }, "srcLon": { "type": "number", "description": "Geographic longitude of Monitored Object source" }, "dstLat": { "type": "number", "description": "Geographic latitude of Monitored Object destination" }, "dstLon": { "type": "number", "description": "Geographic longitude of Monitored Object destination" }, "topology": { "type": "array", "items": { "type": "string" }, "description": "Tags used to describe the path segments associated with the Monitored Object" } } }, "Attributes75": { "title": "Attributes75", "required": [ "_rev", "datatype", "tenantId", "mappingType", "metadataCategoryMap", "createdTimestamp", "lastModifiedTimestamp" ], "type": "object", "properties": { "_rev": { "type": "string", "description": "Value used to ensure updates to this object are handled in order." }, "datatype": { "type": "string", "description": "Name used to identify this type of record in Datahub" }, "tenantId": { "type": "string", "description": "Unique identifier of the Tenant in Datahub" }, "mappingType": { "$ref": "#/components/schemas/MappingType1" }, "metadataCategoryMap": { "type": "object", "additionalProperties": { "$ref": "#/components/schemas/MetadataAlias" }, "description": "Name of the target of the Monitored Object" }, "createdTimestamp": { "type": "integer", "description": "Time since epoch at which this object was instantiated.", "format": "int64" }, "lastModifiedTimestamp": { "type": "integer", "description": "Time since epoch at which this object was last altered.", "format": "int64" } } }, "Attributes76": { "title": "Attributes76", "type": "object", "properties": { "add": { "type": "array", "items": { "type": "string" }, "description": "List of Metadata Category Names to be added to the Metadata Category Mapping" }, "archive": { "type": "array", "items": { "type": "string" }, "description": "List of Metadata Category Names that should no longer be tracked against the Monitored Objects" }, "rename": { "type": "array", "items": { "$ref": "#/components/schemas/MetadataRenameData" }, "description": "List of Metadata Category Names to be renamed in the Metadata Category Mapping" } } }, "Attributes77": { "title": "Attributes77", "required": [ "groupingContext", "interval", "aggregation", "metrics", "result" ], "type": "object", "properties": { "queryContext": { "$ref": "#/components/schemas/AlertQueryContext" }, "metaContext": { "$ref": "#/components/schemas/MetaContext" }, "groupingContext": { "$ref": "#/components/schemas/GroupingContext" }, "interval": { "type": "string", "description": "Time boundary for the metrics under consideration using the ISO-8601 standard", "example": "2018-04-08T14:00:00/2018-04-09T15:00:00" }, "aggregation": { "$ref": "#/components/schemas/SupportedAggregations" }, "metrics": { "type": "array", "items": { "$ref": "#/components/schemas/AlertSpec" }, "description": "A set of identifiers that considers specific metrics based on the provided information" }, "result": { "type": "array", "items": { "$ref": "#/components/schemas/AlertGroupedResultEntryParameters" }, "description": "The rendered response structure from the metric query" } } }, "Attributes78": { "title": "Attributes78", "required": [ "interval", "granularity", "aggregation", "metrics", "result" ], "type": "object", "properties": { "queryContext": { "$ref": "#/components/schemas/QueryContext" }, "metaContext": { "$ref": "#/components/schemas/MetaContext" }, "interval": { "type": "string", "description": "Time boundary for the metrics under consideration using the ISO-8601 standard", "example": "2018-04-08T14:00:00/2018-04-09T15:00:00" }, "granularity": { "type": "string", "description": "the granularity for timeseries in ISO-8601 duration format, or ALL", "example": "PT1H" }, "aggregation": { "$ref": "#/components/schemas/SupportedAggregations" }, "metrics": { "type": "array", "items": { "$ref": "#/components/schemas/AlertSpec" }, "description": "A set of identifiers that considers specific metrics based on the provided information" }, "result": { "type": "array", "items": { "$ref": "#/components/schemas/alertTimeseriesResult" }, "description": "The rendered response structure from the metric query" } } }, "Attributes79": { "title": "Attributes79", "required": [ "activeAlerts", "totalObjects" ], "type": "object", "properties": { "activeAlerts": { "type": "integer", "description": "Number of alerts that have crossed thresholds", "format": "int32" }, "totalObjects": { "type": "integer", "description": "Total number of objects in this policy's object set", "format": "int32" } } }, "Attributes80": { "title": "Attributes80", "required": [ "conditions", "configuration", "name", "description" ], "type": "object", "properties": { "enabled": { "type": "boolean", "description": "Controls whether this policy should be enabled", "default": true }, "deleted": { "type": "boolean", "description": "This flag is to tell us whether the alert has been deleted and cannot be modified. The reasoning we don't do a real delete is because existing alerts in the database still need to correspond to something.", "default": false }, "_rev": { "type": "string", "description": "Policy revision. Not necessarily sequential" }, "lastModifiedTimestamp": { "type": "integer", "description": "Last modification timestamp in POSIX epoch generated by server", "format": "int64" }, "createdTimestamp": { "type": "integer", "description": "Creation timestamp in POSIX epoch generated by server", "format": "int64" }, "useCleanData": { "type": "boolean", "description": "By default alerts will ignore records that are marked dirty. This can be overriden (switch this to false) in the scenarios that alert should check invalid records.", "default": true }, "useBusyHourOnly": { "type": "boolean", "description": "By default alerts will ignore records that are marked as busyHour. If this is set to true, ONLY busy hour data will be considered when alert rules are applied", "default": false }, "useMaintenance": { "type": "boolean", "description": "By default alerts will consider records that are marked as maintenance. If this is set to false, data tagged as maintenance will be ignored when alert rules are applied", "default": true }, "conditions": { "type": "array", "items": { "$ref": "#/components/schemas/alertConditionGroup" }, "description": "" }, "configuration": { "$ref": "#/components/schemas/alertsConfiguration" }, "name": { "maxLength": 64, "minLength": 1, "type": "string", "description": "The name of the alert so it can be easily differentiated." }, "description": { "maxLength": 512, "type": "string", "description": "Brief description of what the Alert Policy will do" }, "tags": { "maxLength": 255, "type": "string", "description": "Miscellaneous data the user wants to tag this alert with", "example": "orderId:uuid123" } }, "description": "Every alert policy requires a trigger condition. Recovery is optional as some alarms may need to be stopped\nby an operator.\nTrigger condition - This is the policies that causes an alarm to start\nRecovery condition - This is the policies that automatically causes an alarm to stop" }, "Attributes81": { "title": "Attributes81", "required": [ "name", "tenantId" ], "type": "object", "properties": { "name": { "type": "string" }, "tenantId": { "type": "string" }, "createdTimestamp": { "type": "integer", "format": "int32" }, "lastModifiedTimestamp": { "type": "integer", "format": "int32" } } }, "Attributes82": { "title": "Attributes82", "required": [ "name" ], "type": "object", "properties": { "name": { "type": "string", "description": "User provided identifier for a SessionFilterProfile" } } }, "Attributes84": { "title": "Attributes84", "required": [ "tenantId", "reportingDuration", "type", "filterItems" ], "type": "object", "properties": { "tenantId": { "type": "string" }, "name": { "type": "string" }, "reportingDuration": { "type": "integer", "description": "The minimum allowed reporting duration, in seconds. ex: - per second data = 1 - per 5 minute data = 5*60 = 300 - per 15 miunte data = 5*15 = 900 The lower the duration, the higher the rate. i.e.: - per second data = 1 record every second = 3600 every hour", "format": "int32" }, "type": { "$ref": "#/components/schemas/Type32" }, "filterItems": { "type": "array", "items": { "$ref": "#/components/schemas/FilterItem" }, "description": "A list containing the attribute and value the filter will work on." } } }, "Attributes85": { "title": "Attributes85", "required": [ "name" ], "type": "object", "properties": { "name": { "type": "string" }, "reportingDuration": { "type": "integer", "description": "The minimum allowed reporting duration, in seconds. ex: - per second data = 1 - per 5 minute data = 5*60 = 300 - per 15 miunte data = 5*15 = 900 The lower the duration, the higher the rate. i.e.: - per second data = 1 record every second = 3600 every hour", "format": "int32" }, "type": { "$ref": "#/components/schemas/Type32" }, "filterItems": { "type": "array", "items": { "$ref": "#/components/schemas/FilterItem" }, "description": "A list containing the attribute and value the filter will work on." } } }, "Attributes87": { "title": "Attributes87", "type": "object", "properties": { "addSessionFilters": { "type": "array", "items": { "type": "string" }, "description": "List of SessionFilter IDs to be added to this SessionFilterProfile" }, "removeSessionFilters": { "type": "array", "items": { "type": "string" }, "description": "List of SessionFilter IDs to be removed from this SessionFilterProfile" }, "updateProperties": { "$ref": "#/components/schemas/UpdateProperties" } } }, "Attributes88": { "title": "Attributes88", "type": "object", "properties": { "addSessionFilterItems": { "type": "array", "items": { "$ref": "#/components/schemas/FilterItem" }, "description": "List of SessionFilterItems to be added to this SessionFilter" }, "removeSessionFilterItems": { "type": "array", "items": { "$ref": "#/components/schemas/FilterItem" }, "description": "List of SessionFilterItems to be removed from this SessionFilter" }, "updateProperties": { "$ref": "#/components/schemas/UpdateProperties1" } } }, "Attributes89": { "title": "Attributes89", "required": [ "name" ], "type": "object", "properties": { "name": { "type": "string" }, "thresholds": { "$ref": "#/components/schemas/ThresholdsObject" }, "thresholdList": { "type": "array", "items": { "$ref": "#/components/schemas/ThresholdList" }, "description": "Contains an array of objects that outline thresholds per vendor/monitoredObjectType/direction which, when crossed, will generate events" } } }, "Attributes90": { "title": "Attributes90", "required": [ "_rev" ], "type": "object", "properties": { "_rev": { "type": "string", "description": "Value used to ensure updates to this object are handled in order." }, "name": { "type": "string" }, "thresholds": { "$ref": "#/components/schemas/ThresholdsObject" }, "thresholdList": { "type": "array", "items": { "$ref": "#/components/schemas/ThresholdList" }, "description": "Contains an array of objects that outline thresholds per vendor/monitoredObjectType/direction which, when crossed, will generate events" } } }, "Attributes91": { "title": "Attributes91", "required": [ "tenantId", "_id", "_rev", "datatype", "name", "createdTimestamp", "lastModifiedTimestamp", "thresholds" ], "type": "object", "properties": { "tenantId": { "type": "string", "description": "Unique identifier of the Tenant in Datahub" }, "_id": { "type": "string" }, "_rev": { "type": "string", "description": "Value used to ensure updates to this object are handled in order." }, "datatype": { "type": "string", "description": "Name used to identify this type of record in Datahub" }, "name": { "type": "string", "description": "Identifying name of a Threshold Profile" }, "createdTimestamp": { "type": "integer", "description": "Time since epoch at which this object was instantiated.", "format": "int64" }, "lastModifiedTimestamp": { "type": "integer", "description": "Time since epoch at which this object was last altered.", "format": "int64" }, "thresholds": { "$ref": "#/components/schemas/ThresholdsObject" }, "thresholdList": { "type": "array", "items": { "$ref": "#/components/schemas/ThresholdList" }, "description": "Contains an array of objects that outline thresholds per vendor/monitoredObjectType/direction which, when crossed, will generate events" } } }, "Attributes92": { "title": "Attributes92", "required": [ "tenantId", "dictionaryName", "objectType" ], "type": "object", "properties": { "tenantId": { "type": "string", "description": "Unique identifier of the Tenant in Datahub" }, "_id": { "type": "string" }, "_rev": { "type": "string", "description": "Value used to ensure updates to this object are handled in order." }, "dictionaryName": { "type": "string" }, "dictionaryType": { "$ref": "#/components/schemas/DictionaryType" }, "vendor": { "type": "string" }, "objectType": { "type": "string" }, "dimensions": { "type": "array", "items": { "$ref": "#/components/schemas/IngestionDictionaryV3Item" }, "description": "" }, "metrics": { "type": "array", "items": { "$ref": "#/components/schemas/IngestionDictionaryV3Item" }, "description": "" }, "customMetrics": { "type": "array", "items": { "$ref": "#/components/schemas/IngestionDictionaryV3Item" }, "description": "" }, "createdTimestamp": { "type": "integer", "description": "Time since epoch at which this object was instantiated.", "format": "int64" }, "lastModifiedTimestamp": { "type": "integer", "description": "Time since epoch at which this object was last altered.", "format": "int64" } } }, "Attributes93": { "title": "Attributes93", "required": [ "groupingContext", "interval", "aggregation", "metrics", "result" ], "type": "object", "properties": { "queryContext": { "$ref": "#/components/schemas/QueryContext" }, "metaContext": { "$ref": "#/components/schemas/MetaContext" }, "groupingContext": { "$ref": "#/components/schemas/GroupingContext" }, "interval": { "type": "string", "description": "Time boundary for the metrics under consideration using the ISO-8601 standard", "example": "2018-04-08T14:00:00/2018-04-09T15:00:00" }, "aggregation": { "$ref": "#/components/schemas/SupportedAggregations" }, "globalMetricFilterContext": { "$ref": "#/components/schemas/SupportedMetricDimensionFilters" }, "metrics": { "type": "array", "items": { "$ref": "#/components/schemas/MetricSpec" }, "description": "A set of identifiers that considers specific metrics based on the provided information" }, "result": { "type": "array", "items": { "$ref": "#/components/schemas/GroupedResultEntryParameters" }, "description": "The rendered response structure from the metric query" } } }, "Attributes94": { "title": "Attributes94", "required": [ "interval", "granularity", "aggregation", "metrics", "result" ], "type": "object", "properties": { "queryContext": { "$ref": "#/components/schemas/QueryContext" }, "metaContext": { "$ref": "#/components/schemas/MetaContext" }, "interval": { "type": "string", "description": "Time boundary for the metrics under consideration using the ISO-8601 standard", "example": "2018-04-08T14:00:00/2018-04-09T15:00:00" }, "granularity": { "type": "string", "description": "the granularity for timeseries in ISO-8601 duration format, or ALL", "example": "PT1H" }, "aggregation": { "$ref": "#/components/schemas/SupportedAggregations" }, "globalMetricFilterContext": { "$ref": "#/components/schemas/SupportedMetricDimensionFilters" }, "metrics": { "type": "array", "items": { "$ref": "#/components/schemas/MetricSpec" }, "description": "A set of identifiers that considers specific metrics based on the provided information" }, "result": { "type": "array", "items": { "$ref": "#/components/schemas/MetricTimeseriesResult" }, "description": "The rendered response structure from the metric query" } } }, "Attributes95": { "title": "Attributes95", "type": "object", "properties": { "test-id": { "type": "string" }, "run-id": { "type": "string" }, "run-timestamp": { "type": "string" }, "user-meta": { "type": "object", "additionalProperties": { "type": "string" }, "description": "User defined attributes added to a TCP Test that help identify the test as well as provide filtering/grouping properties" }, "ingestion-meta": { "type": "object", "additionalProperties": { "type": "string" }, "description": "Attributes added to a TCP Test at ingestion time that help identify the test as well as provide filtering/grouping properties" }, "test-summary-metrics": { "type": "object", "additionalProperties": { "type": "string" }, "description": "Free form map of KPIs" }, "test-interval-metrics": { "type": "object", "additionalProperties": { "type": "string" } } } }, "Attributes96": { "title": "Attributes96", "type": "object", "properties": { "user-meta": { "type": "object", "additionalProperties": { "type": "string" }, "description": "User defined attributes added to a TCP Test that help identify the test as well as provide filtering/grouping properties" } } }, "Attributes97": { "title": "Attributes97", "type": "object", "properties": { "filters": { "$ref": "#/components/schemas/TcpThroughputFilteredListRequest" }, "count": { "type": "integer", "format": "int32" } } }, "Attributes98": { "title": "Attributes98", "type": "object", "properties": { "test-id": { "type": "string" }, "run-id": { "type": "string" }, "run-timestamp": { "type": "string" }, "user-meta": { "type": "object", "additionalProperties": { "type": "string" }, "description": "User defined attributes added to a TCP Test that help identify the test as well as provide filtering/grouping properties" }, "ingestion-meta": { "type": "object", "additionalProperties": { "type": "string" }, "description": "Attributes added to a TCP Test at ingestion time that help identify the test as well as provide filtering/grouping properties" }, "test-summary-metrics": { "type": "object", "additionalProperties": { "type": "string" }, "description": "Free form map of KPIs" } } }, "Attributes99": { "title": "Attributes99", "type": "object", "properties": { "test-id": { "type": "string" }, "run-id": { "type": "string" }, "run-timestamp": { "type": "string" }, "user-meta": { "type": "object", "additionalProperties": { "type": "string" }, "description": "User defined attributes added to a TCP Test that help identify the test as well as provide filtering/grouping properties" }, "ingestion-meta": { "type": "object", "additionalProperties": { "type": "string" }, "description": "Attributes added to a TCP Test at ingestion time that help identify the test as well as provide filtering/grouping properties" }, "test-interval-metrics": { "type": "object", "additionalProperties": { "type": "string" } } } }, "Availability": { "title": "Availability", "type": "object", "properties": { "count": { "type": "integer", "format": "int32" }, "type": { "type": "array", "items": { "type": "string" }, "description": "" } } }, "Box": { "title": "Box", "type": "object", "properties": { "topLeft": { "$ref": "#/components/schemas/SpatialCoordinates" }, "bottomRight": { "$ref": "#/components/schemas/SpatialCoordinates" } } }, "Capture": { "title": "Capture", "type": "object", "properties": { "scanDetection": { "$ref": "#/components/schemas/ScanDetection" }, "ddosDetection": { "$ref": "#/components/schemas/DdosDetection" }, "synFloodDetection": { "$ref": "#/components/schemas/SynFloodDetection" }, "perApplication": { "$ref": "#/components/schemas/PerApplication" } } }, "Centroid": { "title": "Centroid", "type": "object", "properties": { "lat": { "type": "number", "description": "Geographic latitude of the calculated center of the Monitored Objects in the geofence bounds" }, "lon": { "type": "number", "description": "Geographic longitude of the calculated center of the Monitored Objects in the geofence bounds" } } }, "Cluster": { "title": "Cluster", "type": "object", "properties": { "q": { "type": "integer", "format": "int32" }, "n": { "type": "integer", "format": "int32" }, "w": { "type": "integer", "format": "int32" }, "r": { "type": "integer", "format": "int32" } } }, "Cluster1": { "title": "Cluster1", "type": "object", "properties": { "geohash": { "type": "string" }, "count": { "type": "integer", "format": "int32" }, "centroid": { "$ref": "#/components/schemas/Centroid" } } }, "Columns": { "title": "Columns", "type": "object", "properties": { "metrics": { "type": "array", "items": { "$ref": "#/components/schemas/ExportMetricSelector" }, "description": "" }, "metadata": { "type": "array", "items": { "type": "string" }, "description": "" }, "topology": { "type": "boolean", "default": false }, "thresholds": { "type": "array", "items": { "$ref": "#/components/schemas/ExportThresholdModel" }, "description": "" } }, "description": "Columns you wish to see in the exported dataset, can be dimensions, metrics, metadata" }, "Comparator": { "title": "Comparator", "enum": [ "gte", "lte" ], "type": "string", "description": "The metric value can be greater or lesser (and equal) according to the operator", "example": "gte" }, "Comparator1": { "title": "Comparator1", "enum": [ "gt", "lt", "eq", "gte", "lte" ], "type": "string", "description": "Operand to use when evaluating the condition.\ngt = greaterThan\nlt = lessThan\neq = equal", "example": "gt" }, "Comparator2": { "title": "Comparator2", "enum": [ "gt", "lt", "gte", "lte", "eq" ], "type": "string", "description": "Operand to use when evaluating the condition. [gt=greaterThan, lt=lessThan, gte=greaterThanOrEqual, lte=lessThanOrEqual, eq=equal]", "example": "gt" }, "Comparator4": { "title": "Comparator4", "enum": [ "gt", "lt", "eq", "gte", "lte", "in" ], "type": "string", "description": "Operand to use when evaluating the condition.\ngt = greaterThan\nlt = lessThan\neq = equal", "example": "gt" }, "ComponentsVersion": { "title": "ComponentsVersion", "required": [ "name", "image", "version" ], "type": "object", "properties": { "name": { "type": "string" }, "image": { "type": "string" }, "version": { "type": "string" } } }, "Configuration": { "title": "Configuration", "required": [ "pattern", "interval", "granularity", "constraints" ], "type": "object", "properties": { "pattern": { "type": "array", "items": { "$ref": "#/components/schemas/MetricResultEntry" }, "description": "The analytics engine will normalize the pattern time series and then determine monitored objects with similar patterns for the given interval. This will not do time stretching on the dataset but will fill in the gaps so it is one continuous segment." }, "interval": { "type": "string", "description": "The window of time for which the time slice pattern will be evaluated. Uses ISO 8601 timestamp formatting rules." }, "granularity": { "type": "string", "description": "The granularity of the datapoints in ISO 8601 format", "example": "PT1M" }, "numResults": { "type": "integer", "description": "The number of results to return for the time slice analysis", "format": "int32" }, "constraints": { "$ref": "#/components/schemas/AnalyticsTargetScope" } }, "description": "Details outlining the pattern that will be compared against to determine approximate matches" }, "CurrentState": { "title": "CurrentState", "enum": [ "new", "in-progress", "resolved", "closed" ], "type": "string", "example": "new" }, "Data": { "title": "Data", "type": "object", "properties": { "id": { "type": "string", "description": "Export Configuration ID" }, "type": { "$ref": "#/components/schemas/Type17" }, "attributes": { "$ref": "#/components/schemas/Attributes9" } } }, "Data1": { "title": "Data1", "required": [ "id" ], "type": "object", "properties": { "id": { "type": "string", "description": "Export Configuration ID" }, "type": { "$ref": "#/components/schemas/Type18" }, "attributes": { "$ref": "#/components/schemas/Attributes10" } } }, "Data2": { "title": "Data2", "required": [ "type", "attributes" ], "type": "object", "properties": { "id": { "type": "string" }, "type": { "enum": [ "twe" ], "type": "string", "example": "twe" }, "attributes": { "$ref": "#/components/schemas/TimeExclusionRequest" } } }, "Data3": { "title": "Data3", "required": [ "id", "type", "attributes" ], "type": "object", "properties": { "id": { "type": "string" }, "type": { "type": "string" }, "attributes": { "$ref": "#/components/schemas/TimeExclusionUpdateRequest" } } }, "Data4": { "title": "Data4", "required": [ "id", "type", "attributes" ], "type": "object", "properties": { "id": { "type": "string" }, "type": { "type": "string" }, "attributes": { "$ref": "#/components/schemas/TimeExclusionResponse" } } }, "Data6": { "title": "Data6", "required": [ "id", "type", "attributes" ], "type": "object", "properties": { "id": { "type": "string" }, "type": { "type": "string" }, "attributes": { "$ref": "#/components/schemas/TimeWindowExclusionEvent" } } }, "Data7": { "title": "Data7", "type": "object", "properties": { "type": { "$ref": "#/components/schemas/Type19" }, "id": { "type": "string" }, "attributes": { "$ref": "#/components/schemas/Attributes14" } } }, "Data8": { "title": "Data8", "type": "object", "properties": { "type": { "$ref": "#/components/schemas/Type20" }, "id": { "type": "string" }, "attributes": { "$ref": "#/components/schemas/Attributes15" } } }, "Data9": { "title": "Data9", "type": "object", "properties": { "type": { "$ref": "#/components/schemas/Type21" }, "attributes": { "$ref": "#/components/schemas/Attributes16" } } }, "Data10": { "title": "Data10", "type": "object", "properties": { "type": { "$ref": "#/components/schemas/Type22" }, "id": { "type": "string" }, "attributes": { "$ref": "#/components/schemas/Attributes17" } } }, "Data11": { "title": "Data11", "required": [ "type", "id", "attributes" ], "type": "object", "properties": { "type": { "enum": [ "tenantMetadata" ], "type": "string", "example": "tenantMetadata" }, "id": { "type": "string" }, "attributes": { "$ref": "#/components/schemas/Attributes18" } } }, "Data12": { "title": "Data12", "required": [ "id", "type", "attributes" ], "type": "object", "properties": { "id": { "type": "string" }, "type": { "enum": [ "activeAlertCounts" ], "type": "string", "example": "activeAlertCounts" }, "attributes": { "$ref": "#/components/schemas/Attributes20" } } }, "Data13": { "title": "Data13", "required": [ "id", "type", "attributes" ], "type": "object", "properties": { "id": { "type": "string" }, "type": { "enum": [ "activeAlertCounts" ], "type": "string", "example": "activeAlertCounts" }, "attributes": { "$ref": "#/components/schemas/Attributes21" } } }, "Data14": { "title": "Data14", "required": [ "type", "attributes" ], "type": "object", "properties": { "id": { "type": "string" }, "type": { "enum": [ "groupByActiveAlerts" ], "type": "string", "example": "groupByActiveAlerts" }, "attributes": { "$ref": "#/components/schemas/ActiveAlertGroupByConfig" } } }, "Data15": { "title": "Data15", "required": [ "type" ], "type": "object", "properties": { "id": { "type": "string" }, "type": { "enum": [ "groupByActiveAlerts" ], "type": "string", "example": "groupByActiveAlerts" }, "attributes": { "$ref": "#/components/schemas/Attributes22" } } }, "Data16": { "title": "Data16", "required": [ "type", "attributes" ], "type": "object", "properties": { "type": { "enum": [ "analytics" ], "type": "string", "example": "analytics" }, "id": { "type": "string" }, "attributes": { "$ref": "#/components/schemas/Attributes23" } } }, "Data17": { "title": "Data17", "required": [ "type", "attributes" ], "type": "object", "properties": { "type": { "enum": [ "brandings" ], "type": "string", "example": "brandings" }, "id": { "type": "string" }, "attributes": { "$ref": "#/components/schemas/Attributes25" } } }, "Data18": { "title": "Data18", "required": [ "type", "id", "attributes" ], "type": "object", "properties": { "type": { "enum": [ "brandings" ], "type": "string", "example": "brandings" }, "id": { "type": "string" }, "attributes": { "$ref": "#/components/schemas/Attributes26" } } }, "Data19": { "title": "Data19", "required": [ "type", "attributes" ], "type": "object", "properties": { "type": { "enum": [ "locales" ], "type": "string", "example": "locales" }, "id": { "type": "string" }, "attributes": { "$ref": "#/components/schemas/Attributes28" } } }, "Data20": { "title": "Data20", "required": [ "type", "id", "attributes" ], "type": "object", "properties": { "type": { "enum": [ "locales" ], "type": "string", "example": "locales" }, "id": { "type": "string" }, "attributes": { "$ref": "#/components/schemas/Attributes29" } } }, "Data21": { "title": "Data21", "required": [ "type", "attributes" ], "type": "object", "properties": { "id": { "type": "string" }, "type": { "enum": [ "compositeMetrics" ], "type": "string", "example": "compositeMetrics" }, "attributes": { "$ref": "#/components/schemas/Attributes32" } } }, "Data22": { "title": "Data22", "required": [ "id", "type", "attributes" ], "type": "object", "properties": { "id": { "type": "string" }, "type": { "enum": [ "compositeMetrics" ], "type": "string", "example": "compositeMetrics" }, "attributes": { "$ref": "#/components/schemas/Attributes33" } } }, "Data23": { "title": "Data23", "required": [ "type", "attributes" ], "type": "object", "properties": { "type": { "enum": [ "connectorConfigs" ], "type": "string", "example": "connectorConfigs" }, "id": { "type": "string" }, "attributes": { "$ref": "#/components/schemas/Attributes34" } } }, "Data24": { "title": "Data24", "required": [ "type", "id", "attributes" ], "type": "object", "properties": { "type": { "enum": [ "connectorConfigs" ], "type": "string", "example": "connectorConfigs" }, "id": { "type": "string" }, "attributes": { "$ref": "#/components/schemas/Attributes35" } } }, "Data25": { "title": "Data25", "required": [ "type", "attributes" ], "type": "object", "properties": { "type": { "enum": [ "connectorInstances" ], "type": "string", "example": "connectorInstances" }, "id": { "type": "string" }, "attributes": { "$ref": "#/components/schemas/Attributes37" } } }, "Data26": { "title": "Data26", "required": [ "type", "id", "attributes" ], "type": "object", "properties": { "type": { "enum": [ "connectorInstances" ], "type": "string", "example": "connectorInstances" }, "id": { "type": "string" }, "attributes": { "$ref": "#/components/schemas/Attributes38" } } }, "Data27": { "title": "Data27", "required": [ "type", "attributes" ], "type": "object", "properties": { "type": { "enum": [ "networkAssetCount" ], "type": "string", "example": "networkAssetCount" }, "attributes": { "$ref": "#/components/schemas/Attributes41" } } }, "Data28": { "title": "Data28", "required": [ "type", "attributes" ], "type": "object", "properties": { "id": { "type": "string" }, "type": { "enum": [ "groupByNetworkAssets" ], "type": "string", "example": "groupByNetworkAssets" }, "attributes": { "$ref": "#/components/schemas/NetworkAssetGroupByConfig" } } }, "Data29": { "title": "Data29", "required": [ "type" ], "type": "object", "properties": { "id": { "type": "string" }, "type": { "enum": [ "groupByNetworkAssets" ], "type": "string", "example": "groupByNetworkAssets" }, "attributes": { "$ref": "#/components/schemas/Attributes42" } } }, "Data30": { "title": "Data30", "required": [ "type", "attributes" ], "type": "object", "properties": { "type": { "enum": [ "dashboards" ], "type": "string", "example": "dashboards" }, "id": { "type": "string" }, "relationships": { "$ref": "#/components/schemas/DashboardRelationships" }, "attributes": { "$ref": "#/components/schemas/Attributes43" } } }, "Data31": { "title": "Data31", "required": [ "type", "id", "attributes" ], "type": "object", "properties": { "type": { "enum": [ "dashboards" ], "type": "string", "example": "dashboards" }, "id": { "type": "string" }, "relationships": { "$ref": "#/components/schemas/DashboardRelationships" }, "attributes": { "$ref": "#/components/schemas/Attributes44" } } }, "Data32": { "title": "Data32", "required": [ "type", "attributes" ], "type": "object", "properties": { "type": { "enum": [ "cards" ], "type": "string", "example": "cards" }, "id": { "type": "string" }, "attributes": { "$ref": "#/components/schemas/Attributes46" } } }, "Data33": { "title": "Data33", "required": [ "type", "id", "attributes" ], "type": "object", "properties": { "type": { "enum": [ "cards" ], "type": "string", "example": "cards" }, "id": { "type": "string" }, "attributes": { "$ref": "#/components/schemas/Attributes47" } } }, "Data34": { "title": "Data34", "required": [ "type", "attributes" ], "type": "object", "properties": { "type": { "enum": [ "dataCleaningProfiles" ], "type": "string", "example": "dataCleaningProfiles" }, "id": { "type": "string" }, "attributes": { "$ref": "#/components/schemas/Attributes49" } } }, "Data35": { "title": "Data35", "required": [ "type", "id", "attributes" ], "type": "object", "properties": { "type": { "enum": [ "dataCleaningProfiles" ], "type": "string", "example": "dataCleaningProfiles" }, "id": { "type": "string" }, "attributes": { "$ref": "#/components/schemas/Attributes50" } } }, "Data36": { "title": "Data36", "required": [ "type", "attributes" ], "type": "object", "properties": { "type": { "enum": [ "ingestionProfiles" ], "type": "string", "example": "ingestionProfiles" }, "id": { "type": "string" }, "attributes": { "$ref": "#/components/schemas/Attributes53" } } }, "Data37": { "title": "Data37", "required": [ "type", "id", "attributes" ], "type": "object", "properties": { "type": { "enum": [ "ingestionProfiles" ], "type": "string", "example": "ingestionProfiles" }, "id": { "type": "string" }, "attributes": { "$ref": "#/components/schemas/Attributes54" } } }, "Data38": { "title": "Data38", "required": [ "type", "attributes" ], "type": "object", "properties": { "type": { "enum": [ "metadataConfigs" ], "type": "string", "example": "metadataConfigs" }, "id": { "type": "string" }, "attributes": { "$ref": "#/components/schemas/Attributes56" } } }, "Data39": { "title": "Data39", "required": [ "type", "id", "attributes" ], "type": "object", "properties": { "type": { "enum": [ "metadataConfigs" ], "type": "string", "example": "metadataConfigs" }, "id": { "type": "string" }, "attributes": { "$ref": "#/components/schemas/Attributes57" } } }, "Data40": { "title": "Data40", "required": [ "type", "attributes" ], "type": "object", "properties": { "type": { "enum": [ "monitoredObjectTagMappings" ], "type": "string", "example": "monitoredObjectTagMappings" }, "id": { "type": "string" }, "attributes": { "$ref": "#/components/schemas/Attributes61" } } }, "Data41": { "title": "Data41", "required": [ "type", "id", "attributes" ], "type": "object", "properties": { "type": { "enum": [ "monitoredObjectTagMappings" ], "type": "string", "example": "monitoredObjectTagMappings" }, "id": { "type": "string" }, "attributes": { "$ref": "#/components/schemas/Attributes62" } } }, "Data42": { "title": "Data42", "required": [ "type", "id", "attributes" ], "type": "object", "properties": { "type": { "enum": [ "bulkOperationResponses" ], "type": "string", "example": "bulkOperationResponses" }, "id": { "type": "string" }, "attributes": { "$ref": "#/components/schemas/Attributes67" } } }, "Data43": { "title": "Data43", "required": [ "type", "attributes" ], "type": "object", "properties": { "type": { "enum": [ "monitoredObjectsMeta" ], "type": "string", "example": "monitoredObjectsMeta" }, "attributes": { "$ref": "#/components/schemas/Attributes68" } } }, "Data44": { "title": "Data44", "required": [ "type", "attributes" ], "type": "object", "properties": { "id": { "type": "string" }, "type": { "enum": [ "metadataCategoryMappings" ], "type": "string", "example": "metadataCategoryMappings" }, "attributes": { "$ref": "#/components/schemas/Attributes76" } } }, "Data45": { "title": "Data45", "required": [ "type", "attributes" ], "type": "object", "properties": { "id": { "type": "string" }, "type": { "enum": [ "groupByAlerts" ], "type": "string", "example": "groupByAlerts" }, "attributes": { "$ref": "#/components/schemas/AlertGroupByConfig" } } }, "Data46": { "title": "Data46", "required": [ "type" ], "type": "object", "properties": { "id": { "type": "string" }, "type": { "enum": [ "groupByAlerts" ], "type": "string", "example": "groupByAlerts" }, "attributes": { "$ref": "#/components/schemas/Attributes77" } } }, "Data47": { "title": "Data47", "required": [ "type", "attributes" ], "type": "object", "properties": { "id": { "type": "string" }, "type": { "enum": [ "aggregateAlerts" ], "type": "string", "example": "aggregateAlerts" }, "attributes": { "$ref": "#/components/schemas/V2AlertAggregateConfig" } } }, "Data48": { "title": "Data48", "required": [ "type" ], "type": "object", "properties": { "id": { "type": "string" }, "type": { "enum": [ "aggregateAlerts" ], "type": "string", "example": "aggregateAlerts" }, "attributes": { "$ref": "#/components/schemas/Attributes78" } } }, "Data49": { "title": "Data49", "type": "object", "properties": { "relationships": { "$ref": "#/components/schemas/Relationships1" }, "attributes": { "$ref": "#/components/schemas/AlertPayload" } } }, "Data50": { "title": "Data50", "type": "object", "properties": { "id": { "type": "string" }, "rev": { "type": "string" }, "configuration": { "$ref": "#/components/schemas/AutomaticAlertConfiguration" } } }, "Data52": { "title": "Data52", "required": [ "type", "attributes" ], "type": "object", "properties": { "type": { "enum": [ "sessionFilterProfiles" ], "type": "string", "example": "sessionFilterProfiles" }, "id": { "type": "string" }, "relationships": { "$ref": "#/components/schemas/SessionFilterProfileRelationships" }, "attributes": { "$ref": "#/components/schemas/Attributes82" } } }, "Data53": { "title": "Data53", "required": [ "type", "id", "attributes" ], "type": "object", "properties": { "type": { "enum": [ "sessionFilterProfiles" ], "type": "string", "example": "sessionFilterProfiles" }, "id": { "type": "string" }, "relationships": { "$ref": "#/components/schemas/SessionFilterProfileRelationships" }, "attributes": { "$ref": "#/components/schemas/Attributes82" } } }, "Data54": { "title": "Data54", "required": [ "type", "attributes" ], "type": "object", "properties": { "type": { "enum": [ "sessionFilters" ], "type": "string", "example": "sessionFilters" }, "id": { "type": "string" }, "attributes": { "$ref": "#/components/schemas/Attributes85" } } }, "Data55": { "title": "Data55", "required": [ "type", "id", "attributes" ], "type": "object", "properties": { "type": { "enum": [ "sessionFilters" ], "type": "string", "example": "sessionFilters" }, "id": { "type": "string" }, "attributes": { "$ref": "#/components/schemas/Attributes85" } } }, "Data56": { "title": "Data56", "required": [ "id", "type", "attributes" ], "type": "object", "properties": { "id": { "type": "string" }, "type": { "enum": [ "sessionFilterProfiles" ], "type": "string", "example": "sessionFilterProfiles" }, "attributes": { "$ref": "#/components/schemas/Attributes87" } } }, "Data57": { "title": "Data57", "required": [ "id", "type", "attributes" ], "type": "object", "properties": { "id": { "type": "string" }, "type": { "enum": [ "sessionFilters" ], "type": "string", "example": "sessionFilters" }, "attributes": { "$ref": "#/components/schemas/Attributes88" } } }, "Data58": { "title": "Data58", "required": [ "type", "attributes" ], "type": "object", "properties": { "type": { "enum": [ "thresholdProfiles" ], "type": "string", "example": "thresholdProfiles" }, "id": { "type": "string" }, "attributes": { "$ref": "#/components/schemas/Attributes89" } } }, "Data59": { "title": "Data59", "required": [ "type", "id", "attributes" ], "type": "object", "properties": { "type": { "enum": [ "thresholdProfiles" ], "type": "string", "example": "thresholdProfiles" }, "id": { "type": "string" }, "attributes": { "$ref": "#/components/schemas/Attributes90" } } }, "Data60": { "title": "Data60", "type": "object", "properties": { "id": { "type": "string" }, "type": { "$ref": "#/components/schemas/Type36" }, "attributes": { "$ref": "#/components/schemas/DatasourceReconciliationTaskConfig" } } }, "Data61": { "title": "Data61", "type": "object", "properties": { "id": { "type": "string" }, "type": { "$ref": "#/components/schemas/Type37" }, "attributes": { "$ref": "#/components/schemas/DatasourceReindexConfig" } } }, "Data62": { "title": "Data62", "required": [ "type", "attributes" ], "type": "object", "properties": { "id": { "type": "string" }, "type": { "enum": [ "groupByMetrics" ], "type": "string", "example": "groupByMetrics" }, "attributes": { "$ref": "#/components/schemas/GroupByConfig" } } }, "Data63": { "title": "Data63", "required": [ "type" ], "type": "object", "properties": { "id": { "type": "string" }, "type": { "enum": [ "groupByMetrics" ], "type": "string", "example": "groupByMetrics" }, "attributes": { "$ref": "#/components/schemas/Attributes93" } } }, "Data64": { "title": "Data64", "required": [ "type", "attributes" ], "type": "object", "properties": { "id": { "type": "string" }, "type": { "enum": [ "aggregates" ], "type": "string", "example": "aggregates" }, "attributes": { "$ref": "#/components/schemas/AggregateV3Config" } } }, "Data65": { "title": "Data65", "required": [ "type" ], "type": "object", "properties": { "id": { "type": "string" }, "type": { "enum": [ "aggregates" ], "type": "string", "example": "aggregates" }, "attributes": { "$ref": "#/components/schemas/Attributes94" } } }, "Data66": { "title": "Data66", "type": "object", "properties": { "type": { "$ref": "#/components/schemas/Type38" }, "attributes": { "$ref": "#/components/schemas/Attributes97" } } }, "DataType": { "title": "DataType", "enum": [ "integer", "long", "float", "double", "string" ], "type": "string", "example": "integer" }, "Datum": { "title": "Datum", "type": "object", "properties": { "id": { "type": "string" }, "type": { "$ref": "#/components/schemas/Type2" } } }, "Datum1": { "title": "Datum1", "type": "object", "properties": { "id": { "type": "string" }, "type": { "$ref": "#/components/schemas/Type3" } } }, "Datum2": { "title": "Datum2", "type": "object", "properties": { "id": { "type": "string" }, "type": { "$ref": "#/components/schemas/Type4" } } }, "Datum3": { "title": "Datum3", "type": "object", "properties": { "id": { "type": "string" }, "type": { "$ref": "#/components/schemas/Type7" } } }, "Datum5": { "title": "Datum5", "type": "object", "properties": { "id": { "type": "string" }, "type": { "$ref": "#/components/schemas/Type11" }, "attributes": { "$ref": "#/components/schemas/Attributes4" } } }, "DdosDetection": { "title": "DdosDetection", "type": "object", "properties": { "enabled": { "type": "boolean", "default": false }, "false_pos_rate": { "type": "number" }, "remember_duration": { "type": "string" }, "avg_win": { "type": "string" }, "whitelist": { "type": "array", "items": { "type": "string" }, "description": "" } } }, "DefaultDimensions": { "title": "DefaultDimensions", "type": "object", "properties": { "columns": { "type": "integer", "format": "int32" }, "rows": { "type": "integer", "format": "int32" } } }, "Details": { "title": "Details", "type": "object", "properties": { "patternMatch": { "$ref": "#/components/schemas/PatternMatch" } } }, "DictionaryType": { "title": "DictionaryType", "enum": [ "custom", "extension", "global" ], "type": "string", "example": "custom" }, "Dimensions": { "title": "Dimensions", "type": "object", "properties": { "columns": { "type": "integer", "format": "int32" }, "rows": { "type": "integer", "format": "int32" } }, "description": "The amount of columns and rows this card will occupy" }, "DirectionMap": { "title": "DirectionMap", "type": "object", "properties": { "eventMap": { "type": "object", "additionalProperties": { "$ref": "#/components/schemas/EventMap" } } } }, "Error1": { "title": "Error1", "type": "object", "properties": { "title": { "type": "string" }, "status": { "type": "string" }, "code": { "type": "string" }, "detail": { "type": "string" } } }, "EventMap": { "title": "EventMap", "type": "object", "properties": { "eventAttrMap": { "type": "object", "additionalProperties": { "type": "string" } } } }, "Everyone": { "title": "Everyone", "enum": [ "none", "viewer", "editor", "manager" ], "type": "string", "example": "none" }, "ExclusionType": { "title": "ExclusionType", "enum": [ "busyHour", "maintenance" ], "type": "string", "example": "busyHour" }, "Field": { "title": "Field", "enum": [ "objectId", "killchain", "policyId", "securityJobType", "severity", "startTimestamp", "endTimestamp", "raiseProcessedAt", "sourceIp", "destinationIp" ], "type": "string", "example": "objectId" }, "Field1": { "title": "Field1", "enum": [ "firstSeen", "lastSeen" ], "type": "string", "example": "firstSeen" }, "File": { "title": "File", "type": "object", "properties": { "content_type": { "type": "string", "description": "Describes the media type of the document stored" }, "data": { "type": "string", "description": "Contains the image data for the uploaded branding logo" } } }, "Filters": { "title": "Filters", "required": [ "objectType" ], "type": "object", "properties": { "includeOnlyCleanData": { "type": "boolean", "description": "If true, includes records marked clean record flag", "default": false }, "includeBusyHour": { "type": "boolean", "description": "If true, includes records marked with busy hour flag", "default": false }, "includeMaintenanceWindow": { "type": "boolean", "description": "If true, includes records marked with maintenance flag", "default": false }, "includeMetadata": { "type": "object", "additionalProperties": {}, "description": "Include metadata key-values that you want to filter on" }, "objectType": { "type": "string", "description": "We must know the object type the export is for. We cannot run a single report against multiple object types in this version.", "example": "twamp-sf" }, "direction": { "type": "array", "items": { "type": "string" }, "description": "" } } }, "FirstSeen": { "title": "FirstSeen", "type": "object", "properties": { "from": { "type": "integer", "format": "int64" }, "to": { "type": "integer", "format": "int64" } } }, "force": { "title": "force", "enum": [ "false", "true" ], "type": "string", "example": "false" }, "Format": { "title": "Format", "enum": [ "csv" ], "type": "string", "description": "The format the payload is in.", "example": "csv" }, "Freq": { "title": "Freq", "enum": [ "SECONDLY", "MINUTELY", "HOURLY", "DAILY", "WEEKLY", "MONTHLY", "YEARLY" ], "type": "string", "description": "The frequency", "example": "SECONDLY" }, "Granularity": { "title": "Granularity", "enum": [ "P1D", "PT1H" ], "type": "string", "description": "The granularity to be applied to the aggregation. Note that PT1H is only allowed when the interval is less than 1 day", "example": "P1D" }, "GroupBy": { "title": "GroupBy", "required": [ "type", "granularity" ], "type": "object", "properties": { "type": { "enum": [ "objectId" ], "type": "string", "description": "The metric you want to group on", "example": "objectId" }, "granularity": { "$ref": "#/components/schemas/Granularity" } } }, "group-by1": { "title": "group-by1", "enum": [ "object-type" ], "type": "string", "example": "object-type" }, "GroupedResult": { "title": "GroupedResult", "required": [ "value" ], "type": "object", "properties": { "groupings": { "type": "object", "additionalProperties": { "type": "string" } }, "value": { "type": "number" }, "securityMetrics": { "type": "object", "additionalProperties": { "type": "string" } } } }, "GroupedResult1": { "title": "GroupedResult1", "required": [ "value" ], "type": "object", "properties": { "groupings": { "type": "object", "additionalProperties": { "type": "string" } }, "value": { "type": "number" } } }, "GroupedResult3": { "title": "GroupedResult3", "required": [ "groupings", "value" ], "type": "object", "properties": { "groupings": { "type": "object", "additionalProperties": { "type": "string" } }, "value": { "type": "number" } } }, "GroupType": { "title": "GroupType", "enum": [ "active", "passive", "meta" ], "type": "string", "example": "active" }, "Killchain": { "title": "Killchain", "enum": [ "ActionsOnObjective", "CommandAndControl", "Exfiltration", "Exploitation", "Reconnaissance" ], "type": "string", "example": "ActionsOnObjective" }, "Killchain2": { "title": "Killchain2", "enum": [ "ActionsOnObjective", "CommandAndControl", "Exfiltration", "Exploitation", "Reconnaissance" ], "type": "string", "description": "Killchain step according to MITRE techniques. Applicable to security alerts only.", "example": "ActionsOnObjective" }, "LastSeen": { "title": "LastSeen", "type": "object", "properties": { "from": { "type": "integer", "format": "int64" }, "to": { "type": "integer", "format": "int64" } } }, "location": { "title": "location", "enum": [ "source", "destination" ], "type": "string", "example": "source" }, "Loglvl": { "title": "Loglvl", "enum": [ "debug", "info", "warning", "error" ], "type": "string", "example": "debug" }, "Lower": { "title": "Lower", "required": [ "value" ], "type": "object", "properties": { "value": { "type": "number", "description": "The lower, positive number to be used to describe the lowest value of the bucket. Omitting this value assumes that this bucket includes anything lower than the defined \"upper\" value" }, "strict": { "type": "boolean", "description": "If set to true, then the lower value is assumed to be exclusive. Otherwise a value of false or the absence of this value assumes that the lower value is to be taken inclusively" } }, "description": "The specification for the lower boundary of the bucket" }, "MappingType": { "title": "MappingType", "enum": [ "scalars", "array", "timetickArray" ], "type": "string", "description": "Describes if the raw record format is a single scalar or if it is express as an array. \nIn some raw format (for instance, SNMP, or CiscoTelemetry), arrays are natively supported. When this is the \ncase, the connectors instance will be instructed to parse the array and generate one row of data\nper row in the array", "example": "scalars" }, "MappingType1": { "title": "MappingType1", "enum": [ "unknown", "activeMetrics" ], "type": "string", "description": "Type of the origin of the Monitored Object", "example": "unknown" }, "mappingType2": { "title": "mappingType2", "enum": [ "unknown", "activeMetrics" ], "type": "string", "example": "unknown" }, "Match": { "title": "Match", "type": "object", "properties": { "constraints": { "type": "array", "items": { "$ref": "#/components/schemas/AnalyticsTargetScope" }, "description": "An array of metric related scoping parameters for which scopes of data the pattern should be matched against" } }, "description": "Details outlining the specific types of metrics to compare the pattern against for matches" }, "Meta": { "title": "Meta", "required": [ "count" ], "type": "object", "properties": { "count": { "type": "integer", "format": "int32" } } }, "Meta2": { "title": "Meta2", "type": "object", "properties": { "enabledAlertPolicyLimit": { "$ref": "#/components/schemas/enabledAlertPolicyLimit" } } }, "MetaData": { "title": "MetaData", "type": "object", "properties": { "include": { "type": "object", "additionalProperties": {} }, "exclude": { "type": "object", "additionalProperties": {} } } }, "Metadata1": { "title": "Metadata1", "type": "object", "properties": { "include": { "type": "object", "additionalProperties": {}, "description": "An object that allows filtering on arbitrary metadata criteria and their values. The keys in the map are associated with metadata categories and the value array corresponds to a set of whitelist filter-in values for that category. The logical semantics associated with this structure are conditional-AND across metadata criteria (keys) and conditional-OR across the values contained within the value array. For example, {\"region\":[\"montreal\",\"ottawa\"], \"group\":[\"radio\"]} will match all records that are of group \"radio\" AND from the region \"montreal\" OR \"ottawa\"", "example": { "region": [ "montreal", "ottawa" ], "group": [ "radio" ] } }, "exclude": { "type": "object", "additionalProperties": {}, "description": "An object that allows filtering on arbitrary metadata criteria and their values. The keys in the map are associated with metadata categories and the value array corresponds to a set of whitelist filter-in values for that category. The logical semantics associated with this structure are conditional-AND across metadata criteria (keys) and conditional-OR across the values contained within the value array. For example, {\"region\":[\"montreal\",\"ottawa\"], \"group\":[\"radio\"]} will match all records that are of group \"radio\" AND from the region \"montreal\" OR \"ottawa\"", "example": { "region": [ "montreal", "ottawa" ], "group": [ "radio" ] } } }, "description": "Inclusion and exclusion filters for metadata records" }, "MetadataEntry": { "title": "MetadataEntry", "required": [ "objectName", "metadata" ], "type": "object", "properties": { "objectName": { "type": "string", "description": "Name of the monitored object in the datastore" }, "metadata": { "type": "object", "additionalProperties": { "type": "string" }, "description": "Attributes added to a Monitored Object that help identify the Monitored Object as well as provide filtering/grouping properties", "example": { "region": "paris", "wgs87_x": "-45.7123912", "wgs87_y": "-74.2130912" } }, "sourceLocation": { "$ref": "#/components/schemas/MonitoredObjectLocation" }, "destinationLocation": { "$ref": "#/components/schemas/MonitoredObjectLocation" }, "topology": { "type": "array", "items": { "type": "string" }, "description": "Tags used to describe the path segments associated with the Monitored Object" } } }, "Method": { "title": "Method", "enum": [ "password", "openid" ], "type": "string", "example": "password" }, "Metric": { "title": "Metric", "required": [ "vendor" ], "type": "object", "properties": { "type": { "$ref": "#/components/schemas/Type31" }, "layer": { "type": "string", "description": "Capture field name", "example": "http" }, "vendor": { "type": "string", "description": "Vendor name associated with the monitored object", "example": "accedian-twamp" }, "objectType": { "type": "array", "items": { "type": "string" }, "description": "Object types to be considered as part of the filter", "example": [ "twamp-sl", "twamp-sf" ] }, "id": { "type": "string", "description": "The metric's identifier", "example": "delayP95" }, "direction": { "type": "array", "items": { "type": "string" }, "description": "Set of one or more directions to be used by the filter to identify required metric records", "example": [ "0" ] } } }, "MetricGroup": { "title": "MetricGroup", "type": "object", "properties": { "vendor": { "type": "string" }, "groups": { "type": "array", "items": { "type": "string" }, "description": "" } } }, "MetricList": { "title": "MetricList", "type": "object", "properties": { "vendor": { "type": "string", "description": "The name of the Vendor from which this Metric originates" }, "monitoredObjectType": { "type": "string", "description": "The name of the type of Monitored Object for which this Metric is applicable" }, "metric": { "type": "string", "description": "The name of the Metric" }, "rawMetricId": { "type": "string", "description": "The name of the Metric as it is reported during measurments" }, "directions": { "type": "array", "items": { "type": "string" }, "description": "Describes the possible directions of the test (i.e. actuator to reflector) versus another (i.e. round trip)" }, "dimensions": { "type": "object", "additionalProperties": {}, "description": "Provides data properties by which the Metric may be filtered and/or aggregated" }, "unit": { "type": "string", "description": "The unit of measurement used when capturing the value for this Metric" }, "ui": { "$ref": "#/components/schemas/Ui" } }, "description": "Describes a single Metric available in Datahub" }, "MetricMap": { "title": "MetricMap", "type": "object", "properties": { "monitoredObjectTypes": { "type": "array", "items": { "$ref": "#/components/schemas/MonitoredObjectType" }, "description": "" }, "ui": { "$ref": "#/components/schemas/Ui2" } } }, "MetricMap1": { "title": "MetricMap1", "type": "object", "properties": { "eventAttrMap": { "type": "object", "additionalProperties": { "type": "string" } } } }, "MetricMap2": { "title": "MetricMap2", "type": "object", "properties": { "directionMap": { "type": "object", "additionalProperties": { "$ref": "#/components/schemas/DirectionMap" } } } }, "Metrics": { "title": "Metrics", "type": "object", "properties": { "ui": { "$ref": "#/components/schemas/Ui1" }, "metricMap": { "type": "object", "additionalProperties": { "$ref": "#/components/schemas/MetricMap" } } } }, "MonitoredObjectType": { "title": "MonitoredObjectType", "type": "object", "properties": { "key": { "type": "string" }, "rawMetricId": { "type": "string" }, "units": { "type": "array", "items": { "type": "string" }, "description": "" }, "directions": { "type": "array", "items": { "type": "string" }, "description": "" } } }, "MonitoredObjectTypeMap": { "title": "MonitoredObjectTypeMap", "type": "object", "properties": { "metricMap": { "type": "object", "additionalProperties": { "type": "boolean" } } } }, "MonitoredObjectTypeMap1": { "title": "MonitoredObjectTypeMap1", "type": "object", "properties": { "metricMap": { "type": "object", "additionalProperties": { "$ref": "#/components/schemas/MetricMap2" } } } }, "NeighbourResult": { "title": "NeighbourResult", "type": "object", "properties": { "monitoredObjectId": { "type": "string", "description": "Unique identifier of the matching Monitored Object" }, "direction": { "type": "string", "description": "The direction matched for the matched pattern" }, "distance": { "type": "number", "description": "How closely the matching Monitored Object resembles the provided comparison baseline" }, "vendor": { "type": "string", "description": "The vendor for the matched pattern" }, "objectType": { "type": "string", "description": "The type of the monitored object for the matched pattern" }, "metric": { "type": "string", "description": "The metric for the matched pattern" } } }, "NewState": { "title": "NewState", "enum": [ "new", "in-progress", "resolved", "closed" ], "type": "string", "example": "new" }, "ObjectOIDMappingType": { "title": "ObjectOIDMappingType", "enum": [ "oidIndex", "instanceID", "encoded", "encodedv2", "lookup" ], "type": "string", "description": "Describes how objects IDs are encoded inside the OID. In some cases, portions of the OID are used as an instance ID, and this is important to know\nand use for mapping data to the correct object.", "example": "oidIndex" }, "Occurrence": { "title": "Occurrence", "type": "object", "properties": { "startTimestamp": { "type": "integer", "description": "Unix timestamp (ms)", "format": "int64" }, "endTimestamp": { "type": "integer", "description": "Unix timestamp (ms)", "format": "int64" } } }, "Operator": { "title": "Operator", "enum": [ "and", "or" ], "type": "string", "description": "Locical Operator for filter fields", "example": "and" }, "Options": { "title": "Options", "type": "object", "properties": { "useExplicitSeries": { "type": "boolean" }, "useBins": { "type": "boolean" }, "formatUnit": { "type": "string" }, "bins": { "type": "array", "items": { "type": "number" }, "description": "" }, "series": { "type": "array", "items": { "type": "string" }, "description": "" }, "type": { "$ref": "#/components/schemas/Type29" }, "directions": { "type": "array", "items": { "type": "string" }, "description": "" }, "buckets": { "type": "array", "items": { "type": "object" }, "description": "" }, "aggregation": { "$ref": "#/components/schemas/Aggregation1" } } }, "Order": { "title": "Order", "enum": [ "asc", "desc" ], "type": "string", "example": "asc" }, "Other": { "title": "Other", "type": "object", "properties": { "data_size": { "type": "integer", "format": "int32" } } }, "PatternMatch": { "title": "PatternMatch", "type": "object", "properties": { "timeSlice": { "$ref": "#/components/schemas/TimeSlice" } }, "description": "Defines the result format for a PatternMatch analytics operation" }, "PerApplication": { "title": "PerApplication", "type": "object", "properties": { "enabled": { "type": "boolean", "default": false }, "fitting_points": { "type": "number" }, "smooth_coefficient": { "type": "number" } } }, "Permissions": { "title": "Permissions", "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/Datum5" }, "description": "" } } }, "PolicyType": { "title": "PolicyType", "enum": [ "micro-tca", "anomaly", "capture", "capture-automatic", "security", "capture-v2" ], "type": "string", "example": "micro-tca" }, "PolicyType1": { "title": "PolicyType1", "enum": [ "capture", "capture-automatic", "micro-tca", "anomaly", "security" ], "type": "string", "example": "capture" }, "PolicyType3": { "title": "PolicyType3", "enum": [ "micro-tca", "anomaly", "capture", "security", "capture-v2" ], "type": "string", "description": "micro-tca - Alerts per monitored object.\nanomaly - Alerts detected by the Anomaly detector.\ncapture - Alerts for Capture\ncapture-v2 - Alerts for Capture with a v2 schema.", "example": "micro-tca" }, "policyType4": { "title": "policyType4", "enum": [ "micro-tca", "anomaly", "capture", "capture-automatic" ], "type": "string", "example": "micro-tca" }, "PreviousIdentity": { "title": "PreviousIdentity", "type": "object", "properties": { "time": { "type": "string", "format": "date-time" }, "objectId": { "type": "string" }, "objectName": { "type": "string" } } }, "QueryParams": { "title": "QueryParams", "type": "object", "properties": { "limit": { "type": "integer", "description": "Restricts the number ofresults to the provided limit.", "format": "int32" }, "sortDescending": { "type": "boolean", "description": "Items will be displayed sorted in descending order when true, ascending order when false", "default": true }, "aggregator": { "$ref": "#/components/schemas/Aggregator2" } } }, "RawRecordType": { "title": "RawRecordType", "enum": [ "timestamp", "fixed", "interpolate", "mapped", "rate", "rateMean", "rate1", "rate5", "rate15", "oidIndex", "timetick", "instanceID", "encoded", "encodedv2", "lookup", "transformation", "instanceIDMap" ], "type": "string", "description": "Describes if the raw record format a generated timestamp at the connector level (for \nsources where the collection time is not available), \"fixed\" (an absolute provided here), \"interpolate\" (we apply the value from another \nfield specified in the rawSourceName -- for instance, if field \"Name\" is interpolated and has rawSourceName=objectId, we will use the computed \nobjectId to set the value of the field \"Name\") or if it is express as an mapped value, (fetched from the data received from the probed host).\n\"rateMean\", \"rate1\", \"rate5\" and \"rate15\" computes the specified rate and sets this mapping with the appropriate value.", "example": "timestamp" }, "Rectangular": { "title": "Rectangular", "type": "object", "properties": { "minCoordinates": { "$ref": "#/components/schemas/SpatialCoordinates" }, "maxCoordinates": { "$ref": "#/components/schemas/SpatialCoordinates" } } }, "ReflectorType": { "title": "ReflectorType", "enum": [ "unknown", "accedian-nid", "accedian-vnid" ], "type": "string", "description": "Type of the target of the Monitored Object", "example": "unknown" }, "Relationships": { "title": "Relationships", "type": "object", "properties": { "roles": { "$ref": "#/components/schemas/Roles" }, "usergroups": { "$ref": "#/components/schemas/Usergroups" }, "tenants": { "$ref": "#/components/schemas/Tenants" } } }, "Relationships1": { "title": "Relationships1", "type": "object", "properties": { "policyId": { "$ref": "#/components/schemas/JsonApiSingleRelationship" }, "objectId": { "$ref": "#/components/schemas/JsonApiSingleRelationship" } } }, "Relationships2": { "title": "Relationships2", "type": "object", "properties": { "createdBy": { "$ref": "#/components/schemas/JsonApiSingleRelationship" }, "modifiedBy": { "$ref": "#/components/schemas/JsonApiSingleRelationship" }, "tenantId": { "$ref": "#/components/schemas/JsonApiSingleRelationship" }, "tenantName": { "$ref": "#/components/schemas/JsonApiSingleRelationship" } } }, "Request": { "title": "Request", "type": "object", "properties": { "type": { "$ref": "#/components/schemas/Type23" }, "patternMatch": { "$ref": "#/components/schemas/AnalyticsPatternMatch" } }, "description": "Request for Analytical analysis from Datahub" }, "Request1": { "title": "Request1", "type": "object", "properties": { "type": { "$ref": "#/components/schemas/Type23" }, "patternMatch": { "$ref": "#/components/schemas/AnalyticsPatternMatch" } }, "description": "The details of the original request for Analytical analysis from Datahub" }, "Result": { "title": "Result", "type": "object", "properties": { "computationExecTime": { "type": "string", "description": "The time it took to perform the anyltical analysis." }, "status": { "type": "string", "description": "Indicates the success or failure of an anyltical analysis" }, "message": { "type": "string", "description": "When an anyltical analysis is an error, this message will explain the error" }, "details": { "$ref": "#/components/schemas/Details" } }, "description": "The details of the result of the Analytical analysis from Datahub" }, "Role2": { "title": "Role2", "enum": [ "unknown", "skylight-admin", "tenant-admin", "tenant-user", "tenant-contributor" ], "type": "string", "example": "unknown" }, "Roles": { "title": "Roles", "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/Datum" }, "description": "" } } }, "ScanDetection": { "title": "ScanDetection", "type": "object", "properties": { "enabled": { "type": "boolean", "default": false }, "false_pos_rate": { "type": "number" }, "remember_duration": { "type": "string" }, "time_step": { "type": "string" }, "max_ports": { "type": "number" }, "max_hosts": { "type": "number" }, "max_num_packets": { "type": "number" }, "top_size": { "type": "number" }, "top_max_size": { "type": "number" }, "alert_memory": { "type": "string" }, "whilelist": { "type": "array", "items": { "type": "string" }, "description": "" } } }, "Schedule": { "title": "Schedule", "type": "object", "properties": { "hour": { "type": "number", "description": "When the report interval should end at. Jobs are run when system is not busy so the hour is a best effort. Can't be 'star'" }, "dayOfMonth": { "type": "string", "description": "On what date of the month should this run. Note that if you wish to run this once a month for the LAST month of data, you should specify the 1 (st) of every month with a duration of `P1M`. You can only specify dayOfMonth or dayOfWeek. If both are filled in, your request will be rejected.", "example": "14" }, "dayOfWeek": { "type": "string", "description": "On what day of the week to schedule the job on. 0 is sunday, 1 is monday, 2 is tuesday, 3 is wednesday, 4 si thursday, 5 is friday, 6 is saturday" } } }, "SessionAnomaly": { "title": "SessionAnomaly", "type": "object", "properties": { "enabled": { "type": "boolean" } }, "description": "Place holder for anomoly detection" }, "Severity": { "title": "Severity", "enum": [ "low", "medium", "high", "critical" ], "type": "string", "example": "low" }, "SharedWithAll": { "title": "SharedWithAll", "enum": [ "none", "viewers", "editors", "managers" ], "type": "string", "example": "none" }, "Sizes": { "title": "Sizes", "type": "object", "properties": { "file": { "type": "integer", "format": "int32" }, "external": { "type": "integer", "format": "int32" }, "active": { "type": "integer", "format": "int32" } } }, "Sorted": { "title": "Sorted", "enum": [ "asc", "desc" ], "type": "string", "description": "Indicates whether the response should return grouped by queries in ascending or descending order. Only applicable to grouped queries.", "example": "asc" }, "State": { "title": "State", "enum": [ "USER_UNKNOWN", "INVITED", "ACTIVE", "SUSPENDED", "PENDING_DELETE" ], "type": "string", "description": "The current state of the Tenant", "example": "USER_UNKNOWN" }, "State3": { "title": "State3", "enum": [ "active", "pending" ], "type": "string", "example": "active" }, "Storage": { "title": "Storage", "enum": [ "hdfs", "s3" ], "type": "string", "example": "hdfs" }, "SynFloodDetection": { "title": "SynFloodDetection", "type": "object", "properties": { "enabled": { "type": "boolean", "default": false }, "time_step": { "type": "string" }, "max_syns_per_sec": { "type": "number" }, "top_size": { "type": "number" }, "top_max_size": { "type": "number" }, "alert_memory": { "type": "string" }, "whitelist": { "type": "array", "items": { "type": "string" }, "description": "" } } }, "TargetList": { "title": "TargetList", "type": "object", "properties": { "host": { "type": "string" }, "port": { "type": "integer", "format": "int32", "default": 161 }, "name": { "type": "string" } } }, "TargetSegmentTimebucket": { "title": "TargetSegmentTimebucket", "enum": [ "DAY", "MONTH" ], "type": "string", "description": "Target granularity at which the files holding the data in the datasource will be compacted", "example": "DAY" }, "Tenants": { "title": "Tenants", "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/Datum2" }, "description": "" } } }, "ThresholdList": { "title": "ThresholdList", "type": "object", "properties": { "vendor": { "type": "string", "description": "The name of the Vendor from which this Metric originates" }, "monitoredObjectType": { "type": "string", "description": "The name of the type of Monitored Object for which this Metric is applicable" }, "metric": { "type": "string", "description": "The name of the Metric" }, "direction": { "type": "string", "description": "Describes the direction of the test in case a Threshold needs to be different for one direction (i.e. actuator to reflector) versus another (i.e. round trip)" }, "enabled": { "type": "string", "description": "When true, Threshold Crossing for this Metric will be reported. When false, Threshold Crossings for this Metric are not reported." }, "dimensions": { "type": "object", "description": "Provides data properties by which the Metric may be filtered and/or aggregated" }, "events": { "type": "array", "items": { "type": "string" }, "description": "A collection of objects that describe the properties of a Threshold for a Metric" } } }, "TimeSlice": { "title": "TimeSlice", "type": "object", "properties": { "neighbourResults": { "type": "array", "items": { "$ref": "#/components/schemas/NeighbourResult" }, "description": "Ordered list (based on distance) of Monitored Objects that resembled the provided comparison baseline" } }, "description": "Defines the result format for the Time Slice sub-class of a PatternMatch analytics operation" }, "Type": { "title": "Type", "type": "object", "properties": { "value": { "type": "string" } } }, "Type1": { "title": "Type1", "enum": [ "users" ], "type": "string", "example": "users" }, "Type2": { "title": "Type2", "enum": [ "roles", "addRole", "removeRole" ], "type": "string", "example": "roles" }, "Type3": { "title": "Type3", "enum": [ "usergroups", "addGroup", "removeGroup" ], "type": "string", "example": "usergroups" }, "Type4": { "title": "Type4", "enum": [ "tenants", "addTenant", "removeTenant" ], "type": "string", "example": "tenants" }, "Type5": { "title": "Type5", "enum": [ "tokens" ], "type": "string", "example": "tokens" }, "Type6": { "title": "Type6", "enum": [ "usergroups" ], "type": "string", "example": "usergroups" }, "Type7": { "title": "Type7", "enum": [ "user", "users", "addUser", "removeUser" ], "type": "string", "example": "user" }, "Type10": { "title": "Type10", "enum": [ "roles" ], "type": "string", "example": "roles" }, "Type11": { "title": "Type11", "enum": [ "permissions", "addPermission", "removePermission" ], "type": "string", "example": "permissions" }, "Type13": { "title": "Type13", "enum": [ "permissions" ], "type": "string", "example": "permissions" }, "Type16": { "title": "Type16", "enum": [ "tenant-info" ], "type": "string", "example": "tenant-info" }, "Type17": { "title": "Type17", "enum": [ "export-configs" ], "type": "string", "example": "export-configs" }, "Type18": { "title": "Type18", "enum": [ "datasetExport" ], "type": "string", "example": "datasetExport" }, "Type19": { "title": "Type19", "enum": [ "ingestionDictionaries" ], "type": "string", "example": "ingestionDictionaries" }, "Type20": { "title": "Type20", "enum": [ "validTypes" ], "type": "string", "example": "validTypes" }, "Type21": { "title": "Type21", "enum": [ "solutionManifest" ], "type": "string", "example": "solutionManifest" }, "Type22": { "title": "Type22", "enum": [ "tenantSummaries" ], "type": "string", "example": "tenantSummaries" }, "Type23": { "title": "Type23", "enum": [ "verticalSliceQuery" ], "type": "string", "example": "verticalSliceQuery" }, "Type25": { "title": "Type25", "enum": [ "fixed", "baseline_percentage", "baseline_static_below", "baseline_static_above" ], "type": "string", "example": "fixed" }, "Type26": { "title": "Type26", "enum": [ "add", "subtract", "divide", "multiply" ], "type": "string", "example": "add" }, "Type27": { "title": "Type27", "enum": [ "constant", "metric", "compositeMetric" ], "type": "string", "example": "constant" }, "Type28": { "title": "Type28", "enum": [ "fixed", "interpolate" ], "type": "string", "example": "fixed" }, "Type29": { "title": "Type29", "enum": [ "measure", "events", "bins" ], "type": "string", "example": "measure" }, "Type30": { "title": "Type30", "enum": [ "monitoredObjectGeoClusters" ], "type": "string", "example": "monitoredObjectGeoClusters" }, "Type31": { "title": "Type31", "enum": [ "session", "capture", "security" ], "type": "string", "example": "session" }, "Type32": { "title": "Type32", "enum": [ "whitelist", "blacklist" ], "type": "string", "example": "whitelist" }, "Type36": { "title": "Type36", "enum": [ "datasourceReconciliationTasks" ], "type": "string", "example": "datasourceReconciliationTasks" }, "Type37": { "title": "Type37", "enum": [ "datasourceReindexTasks" ], "type": "string", "example": "datasourceReindexTasks" }, "Type38": { "title": "Type38", "enum": [ "tcpThroughputReportCount" ], "type": "string", "example": "tcpThroughputReportCount" }, "Type39": { "title": "Type39", "enum": [ "tcpThroughputReport" ], "type": "string", "example": "tcpThroughputReport" }, "Ui": { "title": "Ui", "type": "object", "properties": { "group": { "type": "string" }, "position": { "type": "string" } }, "description": "This property will be deprecated in the next API version." }, "Ui1": { "title": "Ui1", "type": "object", "properties": { "metricGroups": { "type": "array", "items": { "type": "string" }, "description": "" } } }, "Ui2": { "title": "Ui2", "type": "object", "properties": { "group": { "type": "string" }, "position": { "type": "string" } } }, "UpdateProperties": { "title": "UpdateProperties", "type": "object", "properties": { "name": { "type": "string" } }, "description": "Properties to be edited on the SessionFilterProfile" }, "UpdateProperties1": { "title": "UpdateProperties1", "type": "object", "properties": { "name": { "type": "string" }, "type": { "$ref": "#/components/schemas/Type32" } }, "description": "Properties to be edited on the SessionFilter" }, "Upper": { "title": "Upper", "required": [ "value" ], "type": "object", "properties": { "value": { "type": "number", "description": "The upper, positive number to be used to describe the highest value of the bucket. Omitting this value assumes that this bucket includes anything higher than the defined \"lower\" value" }, "strict": { "type": "boolean", "description": "If set to true, then the upper value is assumed to be exclusive. Otherwise a value of false or the absence of this value assumes that the upper value is to be taken inclusively" } }, "description": "The specification for the upper boundary of the bucket" }, "Usergroups": { "title": "Usergroups", "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/Datum1" }, "description": "" } } }, "Users": { "title": "Users", "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/Datum3" }, "description": "" } } }, "V3AuthenticationProtocol": { "title": "V3AuthenticationProtocol", "enum": [ "SHA", "MD5" ], "type": "string", "description": "The authentication protocol to use for V3 (SHA or MD5)", "example": "SHA" }, "V3PrivacyProtocol": { "title": "V3PrivacyProtocol", "enum": [ "AES", "DES" ], "type": "string", "description": "The privacy protocol to use (AES or DES)", "example": "AES" }, "V3PrivMode": { "title": "V3PrivMode", "enum": [ "NoAuthNoPriv", "AuthNoPriv", "AuthPriv" ], "type": "string", "description": "The v3 privacy mode (NoAuthNoPriv, AuthNoPriv, AuthPriv)", "example": "NoAuthNoPriv" }, "ValueAggregate": { "title": "ValueAggregate", "enum": [ "min", "max", "avg" ], "type": "string", "description": "The method of aggregation by which the selected metric will be aggregateds. [min=minimum, max=maximum, avg=average]", "example": "min" }, "VendorMap": { "title": "VendorMap", "type": "object", "properties": { "monitoredObjectTypeMap": { "type": "object", "additionalProperties": { "$ref": "#/components/schemas/MonitoredObjectTypeMap" } } } }, "VendorMap1": { "title": "VendorMap1", "type": "object", "properties": { "metricMap": { "type": "object", "additionalProperties": { "$ref": "#/components/schemas/MetricMap1" } }, "monitoredObjectTypeMap": { "type": "object", "additionalProperties": { "$ref": "#/components/schemas/MonitoredObjectTypeMap1" } } } }, "WalkType": { "title": "WalkType", "enum": [ "walk", "bulkwalk" ], "type": "string", "description": "Allows the choice of using snmp walk vs snmp bulk walk", "example": "walk" } } }, "tags": [ { "name": "OpenID", "description": "" }, { "name": "SAML", "description": "" }, { "name": "TicketService", "description": "" }, { "name": "AuthService", "description": "" }, { "name": "ExportService", "description": "" }, { "name": "AdminGetSolutionManifest", "description": "" }, { "name": "Time Window Exclusions", "description": "" }, { "name": "AdminProvisioningServiceV2", "description": "" }, { "name": "TenantAlertServiceV2", "description": "" }, { "name": "TenantProvisioningServiceV2", "description": "" }, { "name": "TenantCyberSecurityNetworkAssetServiceV2", "description": "" }, { "name": "ManagerV2", "description": "" }, { "name": "TenantProvisioningServiceV3", "description": "" }, { "name": "MetricsServiceV3", "description": "" }, { "name": "TcpThroughputTestReportServiceV3", "description": "" } ] }