openapi: 3.0.0
info:
title: Secret Server Rest Activations DistributedEngine API
description: REST API documentation for Secret Server. This document describes how to use the REST API. All requests require an authentication token; please see the authentication document for more information. The Swagger specification for this API is also available.
termsOfService: https://delinea.com/eula
contact:
name: Support
url: https://delinea.com
version: 11.7.2
servers:
- url: /SecretServer/api
security:
- BearerToken: []
tags:
- name: DistributedEngine
description: View and maintain Distributed Engine integrations
paths:
/v1/distributed-engine/configuration:
get:
tags:
- DistributedEngine
summary: Distributed Engine Configuration
description: Retrieve the current settings for Distributed Engine configuration
operationId: DistributedEngineService_GetDistributedEngineConfiguration
responses:
'200':
description: Distributed Engines Configuration
content:
application/json:
schema:
$ref: '#/components/schemas/DistributedEngineConfigurationModel'
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequestResponse'
'403':
description: Authentication failed
content:
application/json:
schema:
$ref: '#/components/schemas/AuthenticationFailedResponse'
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerErrorResponse'
deprecated: false
patch:
tags:
- DistributedEngine
summary: Update Distributed Engine Configuration
description: Update the current settings for Distributed Engine configuration
operationId: DistributedEngineService_PatchDistributedEngineConfiguration
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/DistributedEngineConfigurationUpdateArgs'
description: args
responses:
'200':
description: Updated Distributed Engine Configuration
content:
application/json:
schema:
$ref: '#/components/schemas/DistributedEngineConfigurationModel'
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequestResponse'
'403':
description: Authentication failed
content:
application/json:
schema:
$ref: '#/components/schemas/AuthenticationFailedResponse'
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerErrorResponse'
deprecated: false
/v1/distributed-engine/site-connectors:
get:
tags:
- DistributedEngine
summary: Search Site Connectors
description: Search Site Connectors
operationId: DistributedEngineService_SearchSiteConnectors
parameters:
- name: filter.includeInactive
in: query
description: IncludeInactive
required: false
schema:
type: boolean
- name: skip
in: query
description: Number of records to skip before taking results
required: false
schema:
type: integer
format: int32
- name: sortBy[0].direction
in: query
description: Sort direction
required: false
schema:
type: string
- name: sortBy[0].name
in: query
description: Sort field name
required: false
schema:
type: string
- name: sortBy[0].priority
in: query
description: Priority index. Sorts with lower values are executed earlier
required: false
schema:
type: integer
format: int32
- name: take
in: query
description: Maximum number of records to include in results
required: false
schema:
type: integer
format: int32
responses:
'200':
description: Site Connectors that matched
content:
application/json:
schema:
$ref: '#/components/schemas/PagingOfSiteConnectorSummaryModel'
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequestResponse'
'403':
description: Authentication failed
content:
application/json:
schema:
$ref: '#/components/schemas/AuthenticationFailedResponse'
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerErrorResponse'
deprecated: false
/v1/distributed-engine/site-connector/{id}:
get:
tags:
- DistributedEngine
summary: Get Site Connector
description: Get Site Connector for passed in Id
operationId: DistributedEngineService_GetSiteConnector
parameters:
- name: id
in: path
description: id
required: true
schema:
type: integer
format: int32
responses:
'200':
description: Site Connector if found
content:
application/json:
schema:
$ref: '#/components/schemas/SiteConnectorViewModel'
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequestResponse'
'403':
description: Authentication failed
content:
application/json:
schema:
$ref: '#/components/schemas/AuthenticationFailedResponse'
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerErrorResponse'
deprecated: false
patch:
tags:
- DistributedEngine
summary: Update Site Connector
description: Update Site Connector object with passed in Id
operationId: DistributedEngineService_UpdateSiteConnector
parameters:
- name: id
in: path
description: id
required: true
schema:
type: integer
format: int32
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/SiteConnectorUpdateArgs'
description: args
responses:
'200':
description: Updated Site Connector object
content:
application/json:
schema:
$ref: '#/components/schemas/SiteConnectorViewModel'
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequestResponse'
'403':
description: Authentication failed
content:
application/json:
schema:
$ref: '#/components/schemas/AuthenticationFailedResponse'
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerErrorResponse'
deprecated: false
/v1/distributed-engine/site-connector/stub:
get:
tags:
- DistributedEngine
summary: Get Site Connector Stub
description: Get Site Connector for passed in args
operationId: DistributedEngineService_GetSiteConnectorStub
parameters:
- name: queueType
in: query
description: QueueType
required: false
schema:
type: string
responses:
'200':
description: Stub of a Site Connector model
content:
application/json:
schema:
$ref: '#/components/schemas/SiteConnectorViewModel'
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequestResponse'
'403':
description: Authentication failed
content:
application/json:
schema:
$ref: '#/components/schemas/AuthenticationFailedResponse'
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerErrorResponse'
deprecated: false
/v1/distributed-engine/site-connector/{siteConnectorId}/credentials:
get:
tags:
- DistributedEngine
summary: Get Site Connector Credentials
description: Get Site Connector Credentials
operationId: DistributedEngineService_GetSiteConnectorCredentials
parameters:
- name: siteConnectorId
in: path
description: siteConnectorId
required: true
schema:
type: integer
format: int32
responses:
'200':
description: Site Connector Credentials
content:
application/json:
schema:
$ref: '#/components/schemas/SiteConnectorCredentialsModel'
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequestResponse'
'403':
description: Authentication failed
content:
application/json:
schema:
$ref: '#/components/schemas/AuthenticationFailedResponse'
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerErrorResponse'
deprecated: false
/v1/distributed-engine/engines:
get:
tags:
- DistributedEngine
summary: Search Engines
description: Search Engines
operationId: DistributedEngineService_SearchEngines
parameters:
- name: filter.activationStatus
in: query
description: Only return engines with this activation status
required: false
x-nullable: true
schema:
type: string
- name: filter.connectionStatus
in: query
description: Only return engines with this connection status
required: false
x-nullable: true
schema:
type: string
- name: filter.friendlyName
in: query
description: Only return engines with a friendly name that contains this text
required: false
schema:
type: string
- name: filter.onlyIncludeRequiringAction
in: query
description: Only include engines that require action. For example, pending but not deleted or no site assigned.
required: false
schema:
type: boolean
- name: filter.siteId
in: query
description: Only return engines for this site
required: false
x-nullable: true
schema:
type: integer
format: int32
- name: skip
in: query
description: Number of records to skip before taking results
required: false
schema:
type: integer
format: int32
- name: sortBy[0].direction
in: query
description: Sort direction
required: false
schema:
type: string
- name: sortBy[0].name
in: query
description: Sort field name
required: false
schema:
type: string
- name: sortBy[0].priority
in: query
description: Priority index. Sorts with lower values are executed earlier
required: false
schema:
type: integer
format: int32
- name: take
in: query
description: Maximum number of records to include in results
required: false
schema:
type: integer
format: int32
responses:
'200':
description: Engines that matched
content:
application/json:
schema:
$ref: '#/components/schemas/PagingOfEngineSummaryModel'
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequestResponse'
'403':
description: Authentication failed
content:
application/json:
schema:
$ref: '#/components/schemas/AuthenticationFailedResponse'
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerErrorResponse'
deprecated: false
/v1/distributed-engine/engine-settings/site/{siteId}:
get:
tags:
- DistributedEngine
summary: Get Default Engine Settings for Site
description: Get Default Engine Settings object having passed in Site Id
operationId: DistributedEngineService_GetEngineSettingsForSite
parameters:
- name: siteId
in: path
description: siteId
required: true
schema:
type: integer
format: int32
responses:
'200':
description: Get Engine Settings object
content:
application/json:
schema:
$ref: '#/components/schemas/EngineSettingsModel'
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequestResponse'
'403':
description: Authentication failed
content:
application/json:
schema:
$ref: '#/components/schemas/AuthenticationFailedResponse'
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerErrorResponse'
deprecated: false
/v1/distributed-engine/site/{siteId}/engine-audits:
get:
tags:
- DistributedEngine
summary: Get Engine Audits for Site
description: Get Engine Audits having passed in Site Id
operationId: DistributedEngineService_GetEngineAuditsForSite
parameters:
- name: isExporting
in: query
description: isExporting
required: false
schema:
type: boolean
- name: filter.engineId
in: query
description: EngineId
required: false
x-nullable: true
schema:
type: integer
format: int32
- name: filter.searchTerm
in: query
description: SearchTerm
required: false
schema:
type: string
- name: skip
in: query
description: Number of records to skip before taking results
required: false
schema:
type: integer
format: int32
- name: sortBy[0].direction
in: query
description: Sort direction
required: false
schema:
type: string
- name: sortBy[0].name
in: query
description: Sort field name
required: false
schema:
type: string
- name: sortBy[0].priority
in: query
description: Priority index. Sorts with lower values are executed earlier
required: false
schema:
type: integer
format: int32
- name: take
in: query
description: Maximum number of records to include in results
required: false
schema:
type: integer
format: int32
- name: siteId
in: path
description: siteId
required: true
schema:
type: integer
format: int32
responses:
'200':
description: Get Engine Audit Summary object
content:
application/json:
schema:
$ref: '#/components/schemas/PagingOfEngineAuditSummary'
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequestResponse'
'403':
description: Authentication failed
content:
application/json:
schema:
$ref: '#/components/schemas/AuthenticationFailedResponse'
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerErrorResponse'
deprecated: false
/v1/distributed-engine/engine-settings/{engineId}:
get:
tags:
- DistributedEngine
summary: Get Engine Settings
description: Get Engine Settings object having passed in Engine Id
operationId: DistributedEngineService_GetEngineSettings
parameters:
- name: engineId
in: path
description: engineId
required: true
schema:
type: integer
format: int32
responses:
'200':
description: Get Engine Settings object
content:
application/json:
schema:
$ref: '#/components/schemas/EngineSettingsModel'
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequestResponse'
'403':
description: Authentication failed
content:
application/json:
schema:
$ref: '#/components/schemas/AuthenticationFailedResponse'
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerErrorResponse'
deprecated: false
/v1/distributed-engine/sites:
get:
tags:
- DistributedEngine
summary: Search Sites
description: Search Sites
operationId: DistributedEngineService_SearchSites
parameters:
- name: filter.includeInactive
in: query
description: Include inactive sites
required: false
schema:
type: boolean
- name: filter.includeSiteMetrics
in: query
description: When true metrics are included for returned sites such as how many inactive or active sites
required: false
schema:
type: boolean
- name: filter.onlyIncludeSitesThatCanAddNewEngines
in: query
description: Only returns sites that can have new engines added
required: false
schema:
type: boolean
- name: filter.siteId
in: query
description: Return the site with this ID
required: false
x-nullable: true
schema:
type: integer
format: int32
- name: filter.siteName
in: query
description: Return sites that partially match this name
required: false
schema:
type: string
- name: skip
in: query
description: Number of records to skip before taking results
required: false
schema:
type: integer
format: int32
- name: sortBy[0].direction
in: query
description: Sort direction
required: false
schema:
type: string
- name: sortBy[0].name
in: query
description: Sort field name
required: false
schema:
type: string
- name: sortBy[0].priority
in: query
description: Priority index. Sorts with lower values are executed earlier
required: false
schema:
type: integer
format: int32
- name: take
in: query
description: Maximum number of records to include in results
required: false
schema:
type: integer
format: int32
responses:
'200':
description: Sites that matched
content:
application/json:
schema:
$ref: '#/components/schemas/PagingOfSiteSummaryModel'
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequestResponse'
'403':
description: Authentication failed
content:
application/json:
schema:
$ref: '#/components/schemas/AuthenticationFailedResponse'
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerErrorResponse'
deprecated: false
/v1/distributed-engine/site/{id}:
get:
tags:
- DistributedEngine
summary: Get Site
description: Get Site for passed in Id
operationId: DistributedEngineService_GetSite
parameters:
- name: id
in: path
description: id
required: true
schema:
type: integer
format: int32
responses:
'200':
description: Site if found
content:
application/json:
schema:
$ref: '#/components/schemas/SiteBasicModel'
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequestResponse'
'403':
description: Authentication failed
content:
application/json:
schema:
$ref: '#/components/schemas/AuthenticationFailedResponse'
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerErrorResponse'
deprecated: false
patch:
tags:
- DistributedEngine
summary: Patch Site
description: Patch Site object having passed in Id
operationId: DistributedEngineService_PatchSite
parameters:
- name: id
in: path
description: id
required: true
schema:
type: integer
format: int32
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/SiteUpdateArgs'
description: args
responses:
'200':
description: Patch Site object
content:
application/json:
schema:
$ref: '#/components/schemas/SiteBasicModel'
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequestResponse'
'403':
description: Authentication failed
content:
application/json:
schema:
$ref: '#/components/schemas/AuthenticationFailedResponse'
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerErrorResponse'
deprecated: false
/v1/distributed-engine/site/stub:
get:
tags:
- DistributedEngine
summary: Get Site Stub
description: Get Site for passed in args
operationId: DistributedEngineService_GetSiteStub
responses:
'200':
description: Stub of a Site model
content:
application/json:
schema:
$ref: '#/components/schemas/SiteBasicModel'
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequestResponse'
'403':
description: Authentication failed
content:
application/json:
schema:
$ref: '#/components/schemas/AuthenticationFailedResponse'
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerErrorResponse'
deprecated: false
/v1/distributed-engine/site/{id}/audit:
get:
tags:
- DistributedEngine
summary: GetSiteAudits
description: Get audits by Site Id
operationId: DistributedEngineService_GetSiteAudits
parameters:
- name: id
in: path
description: id
required: true
schema:
type: integer
format: int32
- name: isExporting
in: query
description: isExporting
required: false
schema:
type: boolean
- name: skip
in: query
description: Number of records to skip before taking results
required: false
schema:
type: integer
format: int32
- name: sortBy[0].direction
in: query
description: Sort direction
required: false
schema:
type: string
- name: sortBy[0].name
in: query
description: Sort field name
required: false
schema:
type: string
- name: sortBy[0].priority
in: query
description: Priority index. Sorts with lower values are executed earlier
required: false
schema:
type: integer
format: int32
- name: take
in: query
description: Maximum number of records to include in results
required: false
schema:
type: integer
format: int32
responses:
'200':
description: Paged List of Audits
content:
application/json:
schema:
$ref: '#/components/schemas/PagingOfSiteAuditSummary'
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequestResponse'
'403':
description: Authentication failed
content:
application/json:
schema:
$ref: '#/components/schemas/AuthenticationFailedResponse'
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerErrorResponse'
deprecated: false
/v1/distributed-engine/site/{id}/logs:
get:
tags:
- DistributedEngine
summary: SearchSiteLogs
description: Search site logs by Site Id
operationId: DistributedEngineService_SearchSiteLogs
parameters:
- name: id
in: path
description: id
required: true
schema:
type: integer
format: int32
- name: filter.engineId
in: query
description: Filter by a specific engine ID
required: false
x-nullable: true
schema:
type: integer
format: int32
- name: filter.searchTerm
in: query
description: Term used to search the Engine Name and/or the Message of the Site Log
required: false
schema:
type: string
- name: skip
in: query
description: Number of records to skip before taking results
required: false
schema:
type: integer
format: int32
- name: sortBy[0].direction
in: query
description: Sort direction
required: false
schema:
type: string
- name: sortBy[0].name
in: query
description: Sort field name
required: false
schema:
type: string
- name: sortBy[0].priority
in: query
description: Priority index. Sorts with lower values are executed earlier
required: false
schema:
type: integer
format: int32
- name: take
in: query
description: Maximum number of records to include in results
required: false
schema:
type: integer
format: int32
responses:
'200':
description: Paged List of Logs
content:
application/json:
schema:
$ref: '#/components/schemas/PagingOfSiteLogSummaryModel'
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequestResponse'
'403':
description: Authentication failed
content:
application/json:
schema:
$ref: '#/components/schemas/AuthenticationFailedResponse'
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerErrorResponse'
deprecated: false
/v1/distributed-engine/site-connector/{id}/download-memorymq:
get:
tags:
- DistributedEngine
summary: Download Memory MQ
description: Downloads MemoryMQ
operationId: DistributedEngineService_DownloadMemoryMq
parameters:
- name: id
in: path
description: id
required: true
schema:
type: integer
format: int32
responses:
'200':
description: MemoryMQ File Download
content:
application/json:
schema:
$ref: '#/components/schemas/FileStream'
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequestResponse'
'403':
description: Authentication failed
content:
application/json:
schema:
$ref: '#/components/schemas/AuthenticationFailedResponse'
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerErrorResponse'
deprecated: false
/v1/distributed-engine/{id}/server-capabilities:
get:
tags:
- DistributedEngine
summary: Get Server Capabilities
description: Gets the server capabilities of an engine's server
operationId: DistributedEngineService_GetServerCapabilities
parameters:
- name: id
in: path
description: id
required: true
schema:
type: integer
format: int32
responses:
'200':
description: Returns the server capabilities of an engine's server
content:
application/json:
schema:
description: Returns the server capabilities of an engine's server
items:
$ref: '#/components/schemas/EngineServerCapabilitiesSummary'
type: array
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequestResponse'
'403':
description: Authentication failed
content:
application/json:
schema:
$ref: '#/components/schemas/AuthenticationFailedResponse'
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerErrorResponse'
deprecated: false
/v1/distributed-engine/download-distributed-engine:
get:
tags:
- DistributedEngine
summary: Download Distributed Engine
description: Downloads Distributed Engine
operationId: DistributedEngineService_DownloadDistributedEngine
parameters:
- name: is64Bit
in: query
description: is64Bit
required: false
schema:
type: boolean
- name: siteId
in: query
description: siteId
required: false
x-nullable: true
schema:
type: integer
format: int32
responses:
'200':
description: DistributedEngine File Download
content:
application/json:
schema:
$ref: '#/components/schemas/FileStream'
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequestResponse'
'403':
description: Authentication failed
content:
application/json:
schema:
$ref: '#/components/schemas/AuthenticationFailedResponse'
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerErrorResponse'
deprecated: false
/v1/distributed-engine/configuration/engine-latest-version:
patch:
tags:
- DistributedEngine
summary: Updated Distributed Engine Version
description: Update the current settings for Distributed Engine configuration with the latest DE version specified in latest version file if it exists.
operationId: DistributedEngineService_PatchDistributedEngineLatestVersionConfiguration
responses:
'200':
description: Updated Distributed Engine Version
content:
application/json:
schema:
$ref: '#/components/schemas/EngineLatestVersionResult'
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequestResponse'
'403':
description: Authentication failed
content:
application/json:
schema:
$ref: '#/components/schemas/AuthenticationFailedResponse'
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerErrorResponse'
deprecated: false
/v1/distributed-engine/engine-settings/{engineSettingsId}:
patch:
tags:
- DistributedEngine
summary: Patch Engine Settings
description: Patch Engine Settings object having passed in the Id
operationId: DistributedEngineService_PatchEngineSettings
parameters:
- name: engineSettingsId
in: path
description: engineSettingsId
required: true
schema:
type: integer
format: int32
requestBody:
$ref: '#/components/requestBodies/EngineSettingsUpdateArgs'
responses:
'200':
description: Patch Engine Settings object
content:
application/json:
schema:
$ref: '#/components/schemas/EngineSettingsModel'
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequestResponse'
'403':
description: Authentication failed
content:
application/json:
schema:
$ref: '#/components/schemas/AuthenticationFailedResponse'
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerErrorResponse'
deprecated: false
/v1/distributed-engine/engine-settings/engine/{engineId}:
patch:
tags:
- DistributedEngine
summary: Patch Engine Settings For Engine
description: Patch Engine Settings object having passed in the Engine Id
operationId: DistributedEngineService_PatchEngineSettingsForEngine
parameters:
- name: engineId
in: path
description: engineId
required: true
schema:
type: integer
format: int32
requestBody:
$ref: '#/components/requestBodies/EngineSettingsUpdateArgs'
responses:
'200':
description: Patch Engine Settings object
content:
application/json:
schema:
$ref: '#/components/schemas/EngineSettingsModel'
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequestResponse'
'403':
description: Authentication failed
content:
application/json:
schema:
$ref: '#/components/schemas/AuthenticationFailedResponse'
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerErrorResponse'
deprecated: false
/v1/distributed-engine/site-connector:
post:
tags:
- DistributedEngine
summary: Create Site Connector
description: Create Site Connector and returns model
operationId: DistributedEngineService_CreateSiteConnector
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/SiteConnectorCreateArgs'
description: args
responses:
'200':
description: Site Connector object
content:
application/json:
schema:
$ref: '#/components/schemas/SiteConnectorViewModel'
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequestResponse'
'403':
description: Authentication failed
content:
application/json:
schema:
$ref: '#/components/schemas/AuthenticationFailedResponse'
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerErrorResponse'
deprecated: false
/v1/distributed-engine/site-connector/{siteConnectorId}/validate:
post:
tags:
- DistributedEngine
summary: Validate Site Connector
description: Validate Site Connector and returns model
operationId: DistributedEngineService_ValidateSiteConnector
parameters:
- name: siteConnectorId
in: path
description: siteConnectorId
required: true
schema:
type: integer
format: int32
responses:
'200':
description: Site Connector validation result
content:
application/json:
schema:
$ref: '#/components/schemas/SiteConnectorValidationResult'
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequestResponse'
'403':
description: Authentication failed
content:
application/json:
schema:
$ref: '#/components/schemas/AuthenticationFailedResponse'
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerErrorResponse'
deprecated: false
/v1/distributed-engine/update-engine-status:
post:
tags:
- DistributedEngine
summary: Activate Engine
description: Activate the specified engine
operationId: DistributedEngineService_UpdateEngineStatus
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/EngineActivationRequestArgs'
description: args
responses:
'200':
description: Engine Activation Result Model
content:
application/json:
schema:
$ref: '#/components/schemas/EngineActivationResultModel'
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequestResponse'
'403':
description: Authentication failed
content:
application/json:
schema:
$ref: '#/components/schemas/AuthenticationFailedResponse'
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerErrorResponse'
deprecated: false
/v1/distributed-engine/site/{siteId}/validate-connectivity:
post:
tags:
- DistributedEngine
summary: Validate Site Connectivity
description: Validate Site Connectivity within a timeout.
operationId: DistributedEngineService_ValidateSiteConnectivity
parameters:
- name: siteId
in: path
description: Id of Site
required: true
schema:
type: integer
format: int32
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/SiteConnectivityValidationArgs'
description: args
responses:
'200':
description: SiteConnectivityValidationResult object
content:
application/json:
schema:
$ref: '#/components/schemas/SiteConnectivityValidationResult'
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequestResponse'
'403':
description: Authentication failed
content:
application/json:
schema:
$ref: '#/components/schemas/AuthenticationFailedResponse'
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerErrorResponse'
deprecated: false
/v1/distributed-engine/site:
post:
tags:
- DistributedEngine
summary: Create Site
description: Create Site and returns model
operationId: DistributedEngineService_CreateSite
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/SiteCreateArgs'
description: args
responses:
'200':
description: Site object
content:
application/json:
schema:
$ref: '#/components/schemas/SiteBasicModel'
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequestResponse'
'403':
description: Authentication failed
content:
application/json:
schema:
$ref: '#/components/schemas/AuthenticationFailedResponse'
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerErrorResponse'
deprecated: false
/v1/distributed-engine/site/{id}/reassign:
post:
tags:
- DistributedEngine
summary: Reassign Secrets From the Site
description: Reassign Secrets From the Site
operationId: DistributedEngineService_ReassignSecrets
parameters:
- name: id
in: path
description: id
required: true
schema:
type: integer
format: int32
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/ReassignSecretsArgs'
description: args
responses:
'200':
description: The site model
content:
application/json:
schema:
$ref: '#/components/schemas/SiteBasicModel'
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequestResponse'
'403':
description: Authentication failed
content:
application/json:
schema:
$ref: '#/components/schemas/AuthenticationFailedResponse'
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerErrorResponse'
deprecated: false
components:
schemas:
SortDirection:
description: Sort direction
properties: {}
type: string
enum:
- None
- Asc
- Desc
PagingOfEngineAuditSummary:
description: Specify paging and sorting options for querying records and returning results
properties:
batchCount:
description: Number of result batches available with current query options
type: integer
format: int32
currentPage:
description: Index of current result page
type: integer
format: int32
hasNext:
description: Whether there are any results in additional pages
type: boolean
hasPrev:
description: Whether there are any results in previous pages
type: boolean
nextSkip:
description: Correct value of 'skip' for the next page of results
type: integer
format: int32
pageCount:
description: Number of result pages available with current query options
type: integer
format: int32
prevSkip:
description: Correct value of 'skip' for the previous page of results
type: integer
format: int32
records:
description: Query results
items:
$ref: '#/components/schemas/EngineAuditSummary'
type: array
severity:
$ref: '#/components/schemas/Severity'
skip:
description: Number of records to skip before taking results
type: integer
format: int32
sortBy:
description: List of sort properties
items:
$ref: '#/components/schemas/Sort'
type: array
success:
description: Whether the query executed successfully
type: boolean
take:
description: Maximum number of records to include in results
type: integer
format: int32
total:
description: Total number of results available
type: integer
format: int32
type: object
SiteConnectorSummaryModel:
description: Site Connector Summary
properties:
active:
description: Whether Site Connector is active or not
type: boolean
hostName:
description: Host Name of Site Connector
type: string
queueType:
description: Queue Type of Site Connector
type: string
siteConnectorId:
description: Id of Site Connector
type: integer
format: int32
siteConnectorName:
description: Name of Site Connector
type: string
validated:
description: Whether Site Connector has been validated or not
type: boolean
version:
description: Version of Site Connector
type: string
type: object
UpdateFieldValueOfOptionalInt32:
description: The minimum length required for local user passwords
properties:
dirty:
description: Dirty
type: boolean
value:
description: Value
type: integer
format: int32
nullable: true
type: object
SiteConnectivityValidationResult:
description: Result of site connectivity validation
properties:
validationMessage:
description: When false, may contain reason for failure
type: string
validationSuccess:
description: True if successfully validated
type: boolean
type: object
EngineServerCapabilitiesSummary:
description: EngineServerCapabilitiesSummary[]
properties:
lastModifiedDate:
description: When the capability was last updated
type: string
format: date-time
name:
description: Which capability
type: string
value:
description: The server's capability
type: string
type: object
ViewFieldLink:
description: AdditionalLinks
properties:
isExternal:
description: IsExternal
type: boolean
linkText:
description: LinkText
type: string
url:
description: Url
type: string
type: object
IntPtr:
description: Handle
properties: {}
type: object
SiteConnectorValidationResult:
description: Result of site connector validation
properties:
validationMessage:
description: When false, may contain reason for failure
type: string
validationSuccess:
description: True if successfully validated
type: boolean
type: object
ViewFieldValueOfBoolean:
description: When enabled, the log will be able to be viewed online
properties:
additionalLinks:
description: AdditionalLinks
items:
$ref: '#/components/schemas/ViewFieldLink'
type: array
description:
description: Description
type: string
fieldInputType:
description: FieldInputType
type: string
nullable: true
hasHistory:
description: HasHistory
type: boolean
nullable: true
helpLink:
description: HelpLink
type: string
helpLinkText:
description: HelpLinkText
type: string
hidden:
description: Hidden
type: boolean
nullable: true
hideOnView:
description: HideOnView
type: boolean
nullable: true
isRequired:
description: IsRequired
type: boolean
nullable: true
label:
description: Label
type: string
maxLength:
description: MaxLength
type: integer
format: int32
nullable: true
name:
description: Name
type: string
placeholder:
description: Placeholder
type: string
readOnly:
description: ReadOnly
type: boolean
nullable: true
readOnlyReason:
description: ReadOnlyReason
type: string
sortOrder:
description: SortOrder
type: integer
format: int32
nullable: true
value:
description: Value
type: boolean
type: object
EngineActivationResult:
description: The result of the engine status update
properties:
engineId:
description: Engine ID
type: integer
format: int32
engineName:
description: The name of the engine
type: string
error:
description: If there was an error
type: string
success:
description: Whether or not the status change was successful
type: boolean
type: object
SiteConnectorCreateModel:
description: Site Connector Create Model
properties:
active:
description: Whether Site Connector is active or not
type: boolean
hostName:
description: Host Name of Site Connector
type: string
port:
description: Port of Site Connector
type: integer
format: int32
queueType:
$ref: '#/components/schemas/MessageQueueType'
sharedAccessKeyName:
description: Shared Access Key Name of Site Connector
type: string
sharedAccessKeyValue:
description: Shared Access Key Value of Site Connector
type: string
siteConnectorName:
description: Name of Site Connector
type: string
sslCertificateThumbprint:
description: SSL Certificate Thumbprint of Site Connector
type: string
useSsl:
description: Whether Site Connector uses SSL or not
type: boolean
type: object
SiteCreateArgs:
description: SiteCreateArgs
properties:
data:
$ref: '#/components/schemas/SiteCreateModel'
type: object
Sort:
description: Sort options. Multiple sort options can be provided in the query string.
required:
- name
- direction
properties:
direction:
$ref: '#/components/schemas/SortDirection'
name:
description: Sort field name
type: string
priority:
description: Priority index. Sorts with lower values are executed earlier
type: integer
format: int32
type: object
UpdateFieldValueOfBoolean:
description: Active
properties:
dirty:
description: Dirty
type: boolean
value:
description: Value
type: boolean
type: object
SiteConnectorViewModel:
description: Site Connector View Model
properties:
active:
$ref: '#/components/schemas/ViewFieldValueOfBoolean'
hostName:
$ref: '#/components/schemas/ViewFieldValueOfString'
port:
$ref: '#/components/schemas/ViewFieldValueOfInt32'
queueType:
$ref: '#/components/schemas/ViewFieldDropDownValueOfMessageQueueType'
sharedAccessKeyName:
$ref: '#/components/schemas/ViewFieldValueOfString'
sharedAccessKeyValue:
$ref: '#/components/schemas/ViewFieldValueOfString'
siteConnectorId:
description: Id of Site Connector
type: integer
format: int32
siteConnectorName:
$ref: '#/components/schemas/ViewFieldValueOfString'
sslCertificateThumbprint:
$ref: '#/components/schemas/ViewFieldValueOfString'
useSsl:
$ref: '#/components/schemas/ViewFieldValueOfBoolean'
validated:
$ref: '#/components/schemas/ViewFieldValueOfBoolean'
type: object
PagingOfSiteConnectorSummaryModel:
description: Specify paging and sorting options for querying records and returning results
properties:
batchCount:
description: Number of result batches available with current query options
type: integer
format: int32
currentPage:
description: Index of current result page
type: integer
format: int32
hasNext:
description: Whether there are any results in additional pages
type: boolean
hasPrev:
description: Whether there are any results in previous pages
type: boolean
nextSkip:
description: Correct value of 'skip' for the next page of results
type: integer
format: int32
pageCount:
description: Number of result pages available with current query options
type: integer
format: int32
prevSkip:
description: Correct value of 'skip' for the previous page of results
type: integer
format: int32
records:
description: Query results
items:
$ref: '#/components/schemas/SiteConnectorSummaryModel'
type: array
severity:
$ref: '#/components/schemas/Severity'
skip:
description: Number of records to skip before taking results
type: integer
format: int32
sortBy:
description: List of sort properties
items:
$ref: '#/components/schemas/Sort'
type: array
success:
description: Whether the query executed successfully
type: boolean
take:
description: Maximum number of records to include in results
type: integer
format: int32
total:
description: Total number of results available
type: integer
format: int32
type: object
UpdateFieldValueOfProcessingLocationType:
description: Processing Location of Site
properties:
dirty:
description: Dirty
type: boolean
value:
$ref: '#/components/schemas/ProcessingLocationType'
type: object
SiteBasicModel:
description: Basic Site Model
properties:
active:
description: Is Site Active
type: boolean
enableCredSspForWinRm:
description: Enable CredSSP For WinRM
type: boolean
nullable: true
enableRdpProxy:
description: Enable RDP Proxy
type: boolean
enableSshProxy:
description: Enable SSH Proxy
type: boolean
heartbeatInterval:
description: Heartbeat Interval of Site
type: integer
format: int32
jumpBoxAvailablePortRange:
description: JumpBoxAvailablePortRange
type: string
powershellSecretId:
description: Powershell Secret Id of Site if set
type: integer
format: int32
nullable: true
processingLocation:
$ref: '#/components/schemas/ProcessingLocationType'
rdpProxyPort:
description: RDP Proxy Port
type: integer
format: int32
nullable: true
rdpProxyPortInherited:
description: RDP Proxy Port Inherited
type: boolean
secretCount:
description: Secret Count of Site
type: integer
format: int32
siteConnectorId:
description: Id of Site Connector of Site
type: integer
format: int32
nullable: true
siteId:
description: Id of Site
type: integer
format: int32
siteName:
description: Name of Site
type: string
sshProxyPort:
description: SSH Proxy Port
type: integer
format: int32
nullable: true
sshProxyPortInherited:
description: SSH Proxy Port Inherited
type: boolean
systemSite:
description: Is this a system site
type: boolean
winRmEndPointUrl:
description: WinRM End Point URL of Site
type: string
type: object
DistributedEngineConfigurationUpdateArgs:
description: DistributedEngineConfigurationUpdateArgs
properties:
data:
$ref: '#/components/schemas/DistributedEngineConfigurationUpdateModel'
type: object
ViewFieldValueOfString:
description: GeneratedToken
properties:
additionalLinks:
description: AdditionalLinks
items:
$ref: '#/components/schemas/ViewFieldLink'
type: array
description:
description: Description
type: string
fieldInputType:
description: FieldInputType
type: string
nullable: true
hasHistory:
description: HasHistory
type: boolean
nullable: true
helpLink:
description: HelpLink
type: string
helpLinkText:
description: HelpLinkText
type: string
hidden:
description: Hidden
type: boolean
nullable: true
hideOnView:
description: HideOnView
type: boolean
nullable: true
isRequired:
description: IsRequired
type: boolean
nullable: true
label:
description: Label
type: string
maxLength:
description: MaxLength
type: integer
format: int32
nullable: true
name:
description: Name
type: string
placeholder:
description: Placeholder
type: string
readOnly:
description: ReadOnly
type: boolean
nullable: true
readOnlyReason:
description: ReadOnlyReason
type: string
sortOrder:
description: SortOrder
type: integer
format: int32
nullable: true
value:
description: Value
type: string
type: object
SiteCreateModel:
description: Site Create Model
properties:
active:
description: Is Site Active
type: boolean
enableCredSspForWinRm:
description: Enable CredSSP For WinRM
type: boolean
nullable: true
enableRdpProxy:
description: Enable RDP Proxy
type: boolean
enableSshProxy:
description: Enable SSH Proxy
type: boolean
heartbeatInterval:
description: Heartbeat Interval of Site
type: integer
format: int32
powershellSecretId:
description: Powershell Secret Id of Site if set
type: integer
format: int32
nullable: true
rdpProxyPort:
description: RDP Proxy Port
type: integer
format: int32
nullable: true
siteConnectorId:
description: Id of Site Connector of Site
type: integer
format: int32
siteName:
description: Name of Site
type: string
sshProxyPort:
description: SSH Proxy Port
type: integer
format: int32
nullable: true
winRmEndPointUrl:
description: WinRM End Point URL of Site
type: string
type: object
BadRequestResponse:
description: Response object for invalid requests
required:
- message
properties:
message:
description: Error message
type: string
messageDetail:
description: Error message detail
type: string
errorCode:
description: Error message code
type: string
modelState:
description: An object describing validation errors
type: object
type: object
PagingOfEngineSummaryModel:
description: Specify paging and sorting options for querying records and returning results
properties:
batchCount:
description: Number of result batches available with current query options
type: integer
format: int32
currentPage:
description: Index of current result page
type: integer
format: int32
hasNext:
description: Whether there are any results in additional pages
type: boolean
hasPrev:
description: Whether there are any results in previous pages
type: boolean
nextSkip:
description: Correct value of 'skip' for the next page of results
type: integer
format: int32
pageCount:
description: Number of result pages available with current query options
type: integer
format: int32
prevSkip:
description: Correct value of 'skip' for the previous page of results
type: integer
format: int32
records:
description: Query results
items:
$ref: '#/components/schemas/EngineSummaryModel'
type: array
severity:
$ref: '#/components/schemas/Severity'
skip:
description: Number of records to skip before taking results
type: integer
format: int32
sortBy:
description: List of sort properties
items:
$ref: '#/components/schemas/Sort'
type: array
success:
description: Whether the query executed successfully
type: boolean
take:
description: Maximum number of records to include in results
type: integer
format: int32
total:
description: Total number of results available
type: integer
format: int32
type: object
EngineSettingsUpdateArgs:
description: EngineSettingsUpdateArgs
properties:
data:
$ref: '#/components/schemas/EngineSettingsUpdateModel'
type: object
EngineStatusChangeModel:
description: Change engine status
properties:
callbackInterval:
description: When activating an engine if SiteId is null this will be the default callback interval
type: integer
format: int32
changeType:
$ref: '#/components/schemas/EngineStatusChangeType'
engineId:
description: The ID of the engine to change status
type: integer
format: int32
siteConnectorId:
description: When activating an engine if SiteId is null this is the site connector that will be used.
type: integer
format: int32
nullable: true
siteId:
description: When activating an engine SiteId is required
type: integer
format: int32
nullable: true
siteName:
description: When activating an engine if SiteId is null you can pass a SiteName and it will create the site and then activate the engine
type: string
type: object
EngineActivationRequestArgs:
description: EngineActivationRequestArgs
properties:
data:
$ref: '#/components/schemas/EngineActivationRequestModel'
type: object
MessageQueueType:
description: Value
properties: {}
type: string
enum:
- MemoryMq
- RabbitMq
- AzureServiceBus
ProcessingLocationType:
description: Processing Location of Site
properties: {}
type: string
enum:
- UseWebSite
- UseDistributedEngine
EngineActivationRequestModel:
description: Data
properties:
engines:
description: Engines
items:
$ref: '#/components/schemas/EngineStatusChangeModel'
type: array
type: object
UpdateFieldValueOfOptionalLog4NetLevel:
description: Log Level
properties:
dirty:
description: Dirty
type: boolean
value:
description: Value
type: string
nullable: true
type: object
AuthenticationFailedResponse:
description: Response object for authentication failures
required:
- message
properties:
message:
description: Error message
type: string
type: object
SiteAuditSummary:
description: Site Audit Summary
properties:
action:
description: Site Audit Action
type: string
dateRecorded:
description: Site Audit DateRecorded
type: string
format: date-time
notes:
description: Site Audit Notes
type: string
siteAuditId:
description: Site Audit Id
type: integer
format: int32
userName:
description: Site Audit UserName
type: string
type: object
EngineSummaryModel:
description: Query results
properties:
activationStatus:
$ref: '#/components/schemas/EngineActivationStatusType'
bindAddress:
description: BindAddress
type: string
canCancelUpdateVersion:
description: CanCancelUpdateVersion
type: boolean
canUpdateVersion:
description: CanUpdateVersion
type: boolean
connectionStatus:
$ref: '#/components/schemas/EngineConnectionStatusType'
currentVersion:
description: CurrentVersion
type: string
engineId:
description: EngineId
type: integer
format: int32
friendlyName:
description: FriendlyName
type: string
hostName:
description: HostName
type: string
isBlockedByNet48:
description: IsBlockedByNet48
type: boolean
lastConnected:
description: LastConnected
type: string
format: date-time
nullable: true
latestVersion:
description: LatestVersion
type: string
pendingUpdate:
description: PendingUpdate
type: boolean
timeMismatch:
description: TimeMismatch
type: boolean
timeMismatchSeconds:
description: TimeMismatchSeconds
type: integer
format: int64
nullable: true
type: object
SafeFileHandle:
description: SafeFileHandle
properties:
isClosed:
description: IsClosed
type: boolean
isInvalid:
description: IsInvalid
type: boolean
type: object
ReassignSecretsModel:
description: Data
properties:
disableSite:
description: Should the site be disabled as part of the reassign
type: boolean
nullable: true
newSiteId:
description: The new site ID to reassign to
type: integer
format: int32
type: object
UpdateFieldValueOfString:
description: Description
properties:
dirty:
description: Dirty
type: boolean
value:
description: Value
type: string
type: object
FileStream:
description: FileStream
properties:
canRead:
description: CanRead
type: boolean
canSeek:
description: CanSeek
type: boolean
canTimeout:
description: CanTimeout
type: boolean
canWrite:
description: CanWrite
type: boolean
handle:
$ref: '#/components/schemas/IntPtr'
isAsync:
description: IsAsync
type: boolean
length:
description: Length
type: integer
format: int64
name:
description: Name
type: string
position:
description: Position
type: integer
format: int64
readTimeout:
description: ReadTimeout
type: integer
format: int32
safeFileHandle:
$ref: '#/components/schemas/SafeFileHandle'
writeTimeout:
description: WriteTimeout
type: integer
format: int32
type: object
EngineActivationStatusType:
description: ActivationStatus
properties: {}
type: string
enum:
- Pending
- Activated
- Inactive
- Deleted
EngineActivationResultModel:
description: EngineActivationResultModel
properties:
results:
description: Results
items:
$ref: '#/components/schemas/EngineActivationResult'
type: array
type: object
Severity:
description: Error severity level
properties: {}
type: string
enum:
- None
- Retry
- Warn
- Critical
- Fatal
SiteUpdateArgs:
description: SiteUpdateArgs
properties:
data:
$ref: '#/components/schemas/SiteUpdateModel'
type: object
EngineSettingsUpdateModel:
description: Data
properties:
adSyncEnabled:
$ref: '#/components/schemas/UpdateFieldValueOfOptionalBoolean'
advancedAuditingEnabled:
$ref: '#/components/schemas/UpdateFieldValueOfOptionalBoolean'
fipsEnabled:
$ref: '#/components/schemas/UpdateFieldValueOfOptionalBoolean'
localAccountDiscoveryEnabled:
$ref: '#/components/schemas/UpdateFieldValueOfOptionalBoolean'
logLevel:
$ref: '#/components/schemas/UpdateFieldValueOfOptionalLog4NetLevel'
passwordChangingEnabled:
$ref: '#/components/schemas/UpdateFieldValueOfOptionalBoolean'
rdpProxyEnabled:
$ref: '#/components/schemas/UpdateFieldValueOfOptionalBoolean'
secretWorkflowEnabled:
$ref: '#/components/schemas/UpdateFieldValueOfOptionalBoolean'
securityAnalyticsEnabled:
$ref: '#/components/schemas/UpdateFieldValueOfOptionalBoolean'
serviceAccountManagementEnabled:
$ref: '#/components/schemas/UpdateFieldValueOfOptionalBoolean'
sshProxyEnabled:
$ref: '#/components/schemas/UpdateFieldValueOfOptionalBoolean'
sshTerminalEnabled:
$ref: '#/components/schemas/UpdateFieldValueOfOptionalBoolean'
type: object
UpdateFieldValueOfAzureServiceBusTransportType:
description: Azure Service Bus Transport Type
properties:
dirty:
description: Dirty
type: boolean
value:
$ref: '#/components/schemas/AzureServiceBusTransportType'
type: object
UpdateFieldValueOfInt32:
description: How many days until the password expires.
properties:
dirty:
description: Dirty
type: boolean
value:
description: Value
type: integer
format: int32
type: object
SiteConnectivityValidationArgs:
description: SiteConnectivityValidationArgs
properties:
data:
$ref: '#/components/schemas/SiteConnectivityValidationModel'
type: object
EngineSettingsModel:
description: EngineSettingsModel
properties:
adSyncEnabled:
$ref: '#/components/schemas/EngineSettingBool'
advancedAuditingEnabled:
$ref: '#/components/schemas/EngineSettingBool'
engineId:
description: EngineId
type: integer
format: int32
nullable: true
engineSettingsId:
description: EngineSettingsId
type: integer
format: int32
fipsEnabled:
$ref: '#/components/schemas/EngineSettingBool'
localAccountDiscoveryEnabled:
$ref: '#/components/schemas/EngineSettingBool'
logLevel:
description: LogLevel
type: string
nullable: true
passwordChangingEnabled:
$ref: '#/components/schemas/EngineSettingBool'
rdpProxyEnabled:
$ref: '#/components/schemas/EngineSettingBool'
secretWorkflowEnabled:
$ref: '#/components/schemas/EngineSettingBool'
securityAnalyticsEnabled:
$ref: '#/components/schemas/EngineSettingBool'
serviceAccountManagementEnabled:
$ref: '#/components/schemas/EngineSettingBool'
siteId:
description: SiteId
type: integer
format: int32
nullable: true
sshProxyEnabled:
$ref: '#/components/schemas/EngineSettingBool'
sshTerminalEnabled:
$ref: '#/components/schemas/EngineSettingBool'
type: object
EngineSettingBool:
description: AdSyncEnabled
properties:
canEdit:
description: CanEdit
type: boolean
display:
description: Display
type: boolean
enabled:
description: Enabled
type: boolean
type: object
PagingOfSiteAuditSummary:
description: Specify paging and sorting options for querying records and returning results
properties:
batchCount:
description: Number of result batches available with current query options
type: integer
format: int32
currentPage:
description: Index of current result page
type: integer
format: int32
hasNext:
description: Whether there are any results in additional pages
type: boolean
hasPrev:
description: Whether there are any results in previous pages
type: boolean
nextSkip:
description: Correct value of 'skip' for the next page of results
type: integer
format: int32
pageCount:
description: Number of result pages available with current query options
type: integer
format: int32
prevSkip:
description: Correct value of 'skip' for the previous page of results
type: integer
format: int32
records:
description: Query results
items:
$ref: '#/components/schemas/SiteAuditSummary'
type: array
severity:
$ref: '#/components/schemas/Severity'
skip:
description: Number of records to skip before taking results
type: integer
format: int32
sortBy:
description: List of sort properties
items:
$ref: '#/components/schemas/Sort'
type: array
success:
description: Whether the query executed successfully
type: boolean
take:
description: Maximum number of records to include in results
type: integer
format: int32
total:
description: Total number of results available
type: integer
format: int32
type: object
DistributedEngineConfigurationUpdateModel:
description: The fields to update on the Distributed Engine Configuration
properties:
autoUpdateEnginesVersion:
$ref: '#/components/schemas/UpdateFieldValueOfBoolean'
azureServiceBusTransportType:
$ref: '#/components/schemas/UpdateFieldValueOfAzureServiceBusTransportType'
callbackPort:
$ref: '#/components/schemas/UpdateFieldValueOfOptionalInt32'
callbackUrl:
$ref: '#/components/schemas/UpdateFieldValueOfString'
defaultCallbackIntervalSeconds:
$ref: '#/components/schemas/UpdateFieldValueOfInt32'
enableDistributedEngines:
$ref: '#/components/schemas/UpdateFieldValueOfBoolean'
minimumRequiredDistributedEnginesVersion:
$ref: '#/components/schemas/UpdateFieldValueOfString'
protocol:
$ref: '#/components/schemas/UpdateFieldValueOfDistributedEngineProtocol'
responseBusSiteConnectorId:
$ref: '#/components/schemas/UpdateFieldValueOfOptionalInt32'
secretHeartbeatMessageMinutesToLive:
$ref: '#/components/schemas/UpdateFieldValueOfInt32'
secretHeartbeatMessageRetryMinutes:
$ref: '#/components/schemas/UpdateFieldValueOfInt32'
secretPasswordChangeMessageMinutesToLive:
$ref: '#/components/schemas/UpdateFieldValueOfInt32'
secretPasswordChangeMessageRetryMinutes:
$ref: '#/components/schemas/UpdateFieldValueOfInt32'
type: object
EngineStatusChangeType:
description: The action to perform on the engine
properties: {}
type: string
enum:
- Activate
- Deactivate
- RemoveFromSite
- Delete
- UpdateVersion
- CancelUpdateVersion
- AssignToSite
SiteConnectorCredentialsModel:
description: The credentials that should exist in the site connector service
properties:
password:
description: The password that should exist in the site connector service
type: string
username:
description: The username that should exist in the site connector service
type: string
type: object
SiteConnectorUpdateModel:
description: Site Connector Update Model
properties:
active:
$ref: '#/components/schemas/UpdateFieldValueOfBoolean'
hostName:
$ref: '#/components/schemas/UpdateFieldValueOfString'
port:
$ref: '#/components/schemas/UpdateFieldValueOfInt32'
queueType:
$ref: '#/components/schemas/UpdateFieldValueOfMessageQueueType'
sharedAccessKeyName:
$ref: '#/components/schemas/UpdateFieldValueOfString'
sharedAccessKeyValue:
$ref: '#/components/schemas/UpdateFieldValueOfString'
siteConnectorName:
$ref: '#/components/schemas/UpdateFieldValueOfString'
sslCertificateThumbprint:
$ref: '#/components/schemas/UpdateFieldValueOfString'
useSsl:
$ref: '#/components/schemas/UpdateFieldValueOfBoolean'
type: object
EngineConnectionStatusType:
description: ConnectionStatus
properties: {}
type: string
enum:
- Offline
- Online
- Invalid
- OldVersion
ViewFieldValueOfInt32:
description: OrganizationId
properties:
additionalLinks:
description: AdditionalLinks
items:
$ref: '#/components/schemas/ViewFieldLink'
type: array
description:
description: Description
type: string
fieldInputType:
description: FieldInputType
type: string
nullable: true
hasHistory:
description: HasHistory
type: boolean
nullable: true
helpLink:
description: HelpLink
type: string
helpLinkText:
description: HelpLinkText
type: string
hidden:
description: Hidden
type: boolean
nullable: true
hideOnView:
description: HideOnView
type: boolean
nullable: true
isRequired:
description: IsRequired
type: boolean
nullable: true
label:
description: Label
type: string
maxLength:
description: MaxLength
type: integer
format: int32
nullable: true
name:
description: Name
type: string
placeholder:
description: Placeholder
type: string
readOnly:
description: ReadOnly
type: boolean
nullable: true
readOnlyReason:
description: ReadOnlyReason
type: string
sortOrder:
description: SortOrder
type: integer
format: int32
nullable: true
value:
description: Value
type: integer
format: int32
type: object
DistributedEngineConfigurationModel:
description: Distributed Engine Configuration
properties:
autoUpdateEnginesVersion:
description: Always Update Engines Version
type: boolean
azureServiceBusTransportType:
$ref: '#/components/schemas/AzureServiceBusTransportType'
callbackPort:
description: Port of the Distributed Engines
type: integer
format: int32
nullable: true
callbackUrl:
description: Url of the Distributed Engines
type: string
defaultCallbackIntervalSeconds:
description: Default Callback Interval Seconds
type: integer
format: int32
enableDistributedEngines:
description: Whether Distributed Engines are enabled or not
type: boolean
engineVersionUpdateAvailable:
description: Engine Version Update Available
type: boolean
latestDistributedEnginesVersion:
description: Latest Distributed Engines Version
type: string
minimumRequiredDistributedEnginesVersion:
description: Minimum Required Distributed Engines Version
type: string
protocol:
$ref: '#/components/schemas/DistributedEngineProtocol'
responseBusSiteConnectorId:
description: Response Bus Site Connector
type: integer
format: int32
nullable: true
secretHeartbeatMessageMinutesToLive:
description: Secret Heartbeat Message Time to Live in Minutes
type: integer
format: int32
secretHeartbeatMessageRetryMinutes:
description: Secret Heartbeat Message Retry Time in Minutes
type: integer
format: int32
secretPasswordChangeMessageMinutesToLive:
description: Secret Password Change Message Time to Live in Minutes
type: integer
format: int32
secretPasswordChangeMessageRetryMinutes:
description: Secret Password Change Message Retry Time in Minutes
type: integer
format: int32
updateEnginesBannerMessage:
description: Update Engines Banner Message
type: string
type: object
EngineAuditSummary:
description: Query results
properties:
action:
description: Action
type: string
auditId:
description: AuditId
type: integer
format: int32
dateRecorded:
description: DateRecorded
type: string
format: date-time
engineName:
description: EngineName
type: string
notes:
description: Notes
type: string
user:
description: User
type: string
type: object
ViewFieldDropDownOption:
description: DropDownOptions
properties:
fieldDisplay:
description: FieldDisplay
type: string
fieldValue:
description: FieldValue
type: string
type: object
ReassignSecretsArgs:
description: ReassignSecretsArgs
properties:
data:
$ref: '#/components/schemas/ReassignSecretsModel'
type: object
UpdateFieldValueOfDistributedEngineProtocol:
description: Protocol used by Distibuted Engine
properties:
dirty:
description: Dirty
type: boolean
value:
$ref: '#/components/schemas/DistributedEngineProtocol'
type: object
ViewFieldDropDownValueOfMessageQueueType:
description: Queue Type of Site Connector
properties:
additionalLinks:
description: AdditionalLinks
items:
$ref: '#/components/schemas/ViewFieldLink'
type: array
description:
description: Description
type: string
dropDownOptions:
description: DropDownOptions
items:
$ref: '#/components/schemas/ViewFieldDropDownOption'
type: array
fieldInputType:
description: FieldInputType
type: string
nullable: true
hasHistory:
description: HasHistory
type: boolean
nullable: true
helpLink:
description: HelpLink
type: string
helpLinkText:
description: HelpLinkText
type: string
hidden:
description: Hidden
type: boolean
nullable: true
hideOnView:
description: HideOnView
type: boolean
nullable: true
isRequired:
description: IsRequired
type: boolean
nullable: true
label:
description: Label
type: string
maxLength:
description: MaxLength
type: integer
format: int32
nullable: true
name:
description: Name
type: string
placeholder:
description: Placeholder
type: string
readOnly:
description: ReadOnly
type: boolean
nullable: true
readOnlyReason:
description: ReadOnlyReason
type: string
sortOrder:
description: SortOrder
type: integer
format: int32
nullable: true
value:
$ref: '#/components/schemas/MessageQueueType'
type: object
PagingOfSiteSummaryModel:
description: Specify paging and sorting options for querying records and returning results
properties:
batchCount:
description: Number of result batches available with current query options
type: integer
format: int32
currentPage:
description: Index of current result page
type: integer
format: int32
hasNext:
description: Whether there are any results in additional pages
type: boolean
hasPrev:
description: Whether there are any results in previous pages
type: boolean
nextSkip:
description: Correct value of 'skip' for the next page of results
type: integer
format: int32
pageCount:
description: Number of result pages available with current query options
type: integer
format: int32
prevSkip:
description: Correct value of 'skip' for the previous page of results
type: integer
format: int32
records:
description: Query results
items:
$ref: '#/components/schemas/SiteSummaryModel'
type: array
severity:
$ref: '#/components/schemas/Severity'
skip:
description: Number of records to skip before taking results
type: integer
format: int32
sortBy:
description: List of sort properties
items:
$ref: '#/components/schemas/Sort'
type: array
success:
description: Whether the query executed successfully
type: boolean
take:
description: Maximum number of records to include in results
type: integer
format: int32
total:
description: Total number of results available
type: integer
format: int32
type: object
InternalServerErrorResponse:
description: Response object for internal server errors
required:
- message
- exceptionMessage
- exceptionType
- stackTrace
properties:
message:
description: Error message
type: string
exceptionMessage:
description: Error message from exception
type: string
exceptionType:
description: Exception type
type: string
stackTrace:
description: Exception stack trace
type: string
type: object
SiteLogSummaryModel:
description: Site Log Summary Model
properties:
dateRecorded:
description: Date Log Message was Recorded
type: string
format: date-time
engineName:
description: Name of Engine
type: string
message:
description: Message that was Logged
type: string
type: object
DistributedEngineProtocol:
description: Protocol used by Distibuted Engines
properties: {}
type: string
enum:
- Http
- Https
- Tcp
UpdateFieldValueOfOptionalGuid:
description: SSH Cipher Suite
properties:
dirty:
description: Dirty
type: boolean
value:
description: Value
type: string
format: uuid
nullable: true
type: object
SiteConnectorUpdateArgs:
description: SiteConnectorUpdateArgs
properties:
data:
$ref: '#/components/schemas/SiteConnectorUpdateModel'
type: object
EngineLatestVersionResult:
description: Result of Engine Latest Version Command
properties:
latestVersion:
description: Latest Available Version of Distributed Engine
type: string
type: object
UpdateFieldValueOfMessageQueueType:
description: Queue Type of Site Connector
properties:
dirty:
description: Dirty
type: boolean
value:
$ref: '#/components/schemas/MessageQueueType'
type: object
SiteConnectivityValidationModel:
description: Data
properties:
timeout:
description: Millisecond timeout length for testing connectivity.
type: integer
format: int32
type: object
UpdateFieldValueOfOptionalBoolean:
description: Use RADIUS Username for DUO
properties:
dirty:
description: Dirty
type: boolean
value:
description: Value
type: boolean
nullable: true
type: object
PagingOfSiteLogSummaryModel:
description: Specify paging and sorting options for querying records and returning results
properties:
batchCount:
description: Number of result batches available with current query options
type: integer
format: int32
currentPage:
description: Index of current result page
type: integer
format: int32
hasNext:
description: Whether there are any results in additional pages
type: boolean
hasPrev:
description: Whether there are any results in previous pages
type: boolean
nextSkip:
description: Correct value of 'skip' for the next page of results
type: integer
format: int32
pageCount:
description: Number of result pages available with current query options
type: integer
format: int32
prevSkip:
description: Correct value of 'skip' for the previous page of results
type: integer
format: int32
records:
description: Query results
items:
$ref: '#/components/schemas/SiteLogSummaryModel'
type: array
severity:
$ref: '#/components/schemas/Severity'
skip:
description: Number of records to skip before taking results
type: integer
format: int32
sortBy:
description: List of sort properties
items:
$ref: '#/components/schemas/Sort'
type: array
success:
description: Whether the query executed successfully
type: boolean
take:
description: Maximum number of records to include in results
type: integer
format: int32
total:
description: Total number of results available
type: integer
format: int32
type: object
SiteConnectorCreateArgs:
description: SiteConnectorCreateArgs
properties:
data:
$ref: '#/components/schemas/SiteConnectorCreateModel'
type: object
AzureServiceBusTransportType:
description: Azure Service Bus Transport Type
properties: {}
type: string
enum:
- Amqp
- AmqpWebSockets
SiteUpdateModel:
description: Data
properties:
active:
$ref: '#/components/schemas/UpdateFieldValueOfBoolean'
enableCredSspForWinRm:
$ref: '#/components/schemas/UpdateFieldValueOfOptionalBoolean'
enableRdpProxy:
$ref: '#/components/schemas/UpdateFieldValueOfBoolean'
enableSshProxy:
$ref: '#/components/schemas/UpdateFieldValueOfBoolean'
heartbeatInterval:
$ref: '#/components/schemas/UpdateFieldValueOfInt32'
powershellSecretId:
$ref: '#/components/schemas/UpdateFieldValueOfOptionalInt32'
processingLocation:
$ref: '#/components/schemas/UpdateFieldValueOfProcessingLocationType'
rdpProxyPort:
$ref: '#/components/schemas/UpdateFieldValueOfInt32'
siteConnectorId:
$ref: '#/components/schemas/UpdateFieldValueOfInt32'
siteName:
$ref: '#/components/schemas/UpdateFieldValueOfString'
sshCipherSuite:
$ref: '#/components/schemas/UpdateFieldValueOfOptionalGuid'
sshProxyPort:
$ref: '#/components/schemas/UpdateFieldValueOfInt32'
winRmEndPointUrl:
$ref: '#/components/schemas/UpdateFieldValueOfString'
type: object
SiteMetric:
description: List of Metrics for this site such as ConnectionStatusOffline, ConnectionStatusOnline, ActivationStatusPending, LostConnection, and more. Only returned on a search when IncludeSiteMetrics is true.
properties:
metricDisplayName:
description: MetricDisplayName
type: string
metricName:
description: MetricName
type: string
metricValue:
description: MetricValue
type: integer
format: int32
type: object
SiteSummaryModel:
description: Site Summary
properties:
active:
description: Is Site Active
type: boolean
isLocal:
description: Indicates if this site is the local site that cannot have engines assigned
type: boolean
lastActivity:
description: Last Date of Activity of Site
type: string
format: date-time
nullable: true
numEnginesMissingNetFramework:
description: The number of engines on the site missing the minimum DotNet Framework
type: integer
format: int32
numEnginesWithoutAbilityToRestartService:
description: The number of engines on the site without the ability to restart the service, required for upgrades
type: integer
format: int32
offlineEngineCount:
description: Offline Engine Count of Site
type: integer
format: int32
onlineEngineCount:
description: Online Engine Count of Site
type: integer
format: int32
showEngineVersionUpdateBlocklistBannerMessage:
description: Whether to show the banner message indicating one or more engines has a blocklisted version and must be updated manually
type: boolean
siteId:
description: Id of Site
type: integer
format: int32
siteMetrics:
description: List of Metrics for this site such as ConnectionStatusOffline, ConnectionStatusOnline, ActivationStatusPending, LostConnection, and more. Only returned on a search when IncludeSiteMetrics is true.
items:
$ref: '#/components/schemas/SiteMetric'
type: array
siteName:
description: Name of Site
type: string
type: object
requestBodies:
EngineSettingsUpdateArgs:
content:
application/json:
schema:
$ref: '#/components/schemas/EngineSettingsUpdateArgs'
description: args
securitySchemes:
BearerToken:
type: apiKey
description: 'Perform a POST request to `/oauth2/token`. It should include three form data parameters - `username`, `password`, and `grant_type`.The `grant_type` parameter should always have the value `password`.The access token returned should be included in the header of subsequent requests, like ''Authorization: Bearer token''. The token remains valid for a time period returned in the ''expires_in'' property (in seconds). For details, see the token request documentation.'
name: Authorization
in: header