Cohesity DataProtect REST API

consumes:
- application/json
produces:
- application/json
schemes:
- https
swagger: "2.0"
info:
  description: |-
    This API list provides operations for interfacing with the Cohesity
    Cluster.
  title: Cohesity REST API
  version: "1.0"
host: <CLUSTER_VIP>
basePath: /irisservices/api/v1
paths:
  /public/accessTokens:
    post:
      description: |-
        Before making other REST API requests, your REST client must make a
        'POST /public/accessToken' request with a valid Cohesity username and
        password. This POST request returns an access token and type
        in the response that is generated by the Cohesity Cluster.
        Subsequent requests to other Cohesity REST API operations must
        specify the returned access token and type by setting 'Authorization'
        in the http header in the following format:

        Authorization: token_type access_token

        The generated token is valid for 24 hours. If a request is made with
        an expired token, the 'Token expired' error message is returned.
        Add code to your REST client to check for this error and request
        another access token before reissuing the request.
      tags:
      - AccessTokens
      summary: Generate an Access Token.
      operationId: GenerateAccessToken
      parameters:
      - x-go-name: Body
        description: Request to generate access token.
        name: body
        in: body
        required: true
        schema:
          $ref: '#/definitions/AccessTokenCredential'
      responses:
        "201":
          $ref: '#/responses/GenerateAccessTokenResponse'
        default:
          $ref: '#/responses/Error'
  /public/activeDirectory:
    get:
      description: |-
        After a Cohesity Cluster has been joined to an Active Directory domain,
        the users and groups in the domain can be authenticated on the Cohesity Cluster
        using their Active Directory credentials.

        NOTE: The userName and password fields are not populated by this operation.
      tags:
      - ActiveDirectory
      summary: Lists the Active Directories that the Cohesity Cluster has joined.
      operationId: GetActiveDirectoryEntry
      parameters:
      - type: array
        items:
          type: string
        x-go-name: Domains
        description: Specifies the domains to fetch active directory entries.
        name: domains
        in: query
      - type: array
        items:
          type: string
        x-go-name: TenantIds
        description: |-
          TenantIds contains ids of the tenants for which objects are to be
          returned.
        name: tenantIds
        in: query
      - type: boolean
        x-go-name: AllUnderHierarchy
        description: |-
          AllUnderHierarchy specifies if objects of all the tenants under the
          hierarchy of the logged in user's organization should be returned.
        name: allUnderHierarchy
        in: query
      responses:
        "200":
          $ref: '#/responses/GetActiveDirectoryResponse'
        default:
          $ref: '#/responses/Error'
    post:
      description: |-
        After a Cohesity Cluster has been joined to an Active Directory domain,
        the users and groups in the domain can be authenticated on the Cohesity Cluster
        using their Active Directory credentials.
      tags:
      - ActiveDirectory
      summary: Join the Cohesity Cluster to the specified Active Directory.
      operationId: CreateActiveDirectoryEntry
      parameters:
      - x-go-name: Body
        description: Request to join an Active Directory.
        name: body
        in: body
        required: true
        schema:
          $ref: '#/definitions/CreateActiveDirectoryEntryParams'
      responses:
        "201":
          $ref: '#/responses/CreateActiveDirectoryResponse'
        default:
          $ref: '#/responses/Error'
    delete:
      description: |-
        Deletes the join of the Cohesity Cluster to the specified
        Active Directory domain. After the deletion, the Cohesity Cluster
        no longer has access to the principals on the Active Directory.
        For example, you can no longer log in to the Cohesity Cluster
        with a user defined in a principal group of the Active Directory domain.
      tags:
      - ActiveDirectory
      summary: Deletes the join with the Active Directory.
      operationId: DeleteActiveDirectoryEntry
      parameters:
      - x-go-name: Body
        description: Request to delete a join with an Active Directory.
        name: body
        in: body
        required: true
        schema:
          $ref: '#/definitions/ActiveDirectoryEntry'
      responses:
        "204":
          $ref: '#/responses/NoContentResponse'
        default:
          $ref: '#/responses/Error'
  /public/activeDirectory/centrifyZones:
    get:
      tags:
      - ActiveDirectory
      summary: Fetches the list centrify zones of an active directory domain.
      operationId: ListCentrifyZones
      parameters:
      - type: string
        x-go-name: DomainName
        description: Specifies the fully qualified domain name (FQDN) of an Active
          Directory.
        name: domainName
        in: query
      responses:
        "200":
          $ref: '#/responses/ListCentrifyZonesResponse'
        default:
          $ref: '#/responses/Error'
  /public/activeDirectory/domainControllers:
    get:
      tags:
      - ActiveDirectory
      summary: List the domain controllers for a domain.
      operationId: GetActiveDirectoryDomainControllers
      parameters:
      - type: string
        x-go-name: DomainName
        description: Specifies the domain name
        name: domainName
        in: query
      responses:
        "200":
          $ref: '#/responses/ListDomainControllersResponse'
        default:
          $ref: '#/responses/Error'
  /public/activeDirectory/principals:
    get:
      description: |-
        Optionally limit the search results by specifying security identifiers (SIDs),
        an object class (user or group) or a substring.
        You can specify SIDs or a substring but not both.
      tags:
      - ActiveDirectory
      summary: |-
        List the user and group principals in the Active Directory that match the
        filter criteria specified using parameters.
      operationId: SearchActiveDirectoryPrincipals
      parameters:
      - type: string
        x-go-name: Domain
        description: |-
          Specifies the domain name of the principals to search. If specified
          the principals in that domain are searched. Domain could be an
          Active Directory domain joined by the Cluster or any one of the
          trusted domains of the Active Directory domain or the LOCAL domain.
          If not specified, all the domains are searched.
        name: domain
        in: query
      - enum:
        - kUser
        - kGroup
        - kComputer
        - kWellKnownPrincipal
        type: string
        x-go-name: ObjectClass
        description: |-
          Optionally filter by a principal object class such as 'kGroup' or 'kUser'.
          If 'kGroup' is specified, only group principals are returned.
          If 'kUser' is specified, only user principals are returned.
          If not specified, both group and user principals are returned.
          'kUser' specifies a user object class.
          'kGroup' specifies a group object class.
          'kComputer' specifies a computer object class.
          'kWellKnownPrincipal' specifies a well known principal.
        name: objectClass
        in: query
      - type: string
        x-go-name: Search
        description: |-
          Optionally filter by matching a substring. Only principals in
          the with a name or sAMAccountName that matches
          part or all of the specified substring are returned.
          If specified, a 'sids' parameter should not be specified.
        name: search
        in: query
      - type: array
        items:
          type: string
        x-go-name: Sids
        description: |-
          Optionally filter by a list of security identifiers (SIDs) found
          in the specified domain. Only principals matching
          the specified SIDs are returned.
          If specified, a 'search' parameter should not be specified.
        name: sids
        in: query
      - type: boolean
        x-go-name: IncludeComputers
        description: Specifies if Computer/GMSA accounts need to be included in this
          search.
        name: includeComputers
        in: query
      responses:
        "200":
          $ref: '#/responses/SearchActiveDirectoryPrincipalsResponse'
        default:
          $ref: '#/responses/Error'
    post:
      description: |-
        After a group or user has been added to a Cohesity Cluster,
        the referenced Active Directory principal can be used by the Cohesity Cluster.
        In addition, this operation maps Cohesity roles with a group or user and
        this mapping defines the privileges allowed on the Cohesity Cluster for the
        group or user.
        For example if an 'management' group is created on the Cohesity Cluster
        for the Active Directory 'management' principal group and is
        associated with the Cohesity 'View' role, all users in the
        referenced Active Directory 'management' principal group can log in to the
        Cohesity Dashboard but will only have view-only privileges.
        These users cannot create new Protection Jobs, Policies, Views, etc.

        NOTE: Local Cohesity users and groups cannot be created by this operation.
        Local Cohesity users or groups do not have an associated Active Directory
        principals and are created directly in the default LOCAL domain.
      tags:
      - ActiveDirectory
      summary: |-
        Add multiple groups or users on the Cohesity Cluster for the specified
        Active Directory principals. In addition, assign Cohesity roles to the
        users or groups to define their Cohesity privileges.
      operationId: AddActiveDirectoryPrincipals
      parameters:
      - x-go-name: Body
        description: Request to add groups or users to the Cohesity Cluster.
        name: body
        in: body
        schema:
          type: array
          items:
            $ref: '#/definitions/ActiveDirectoryPrincipalsAddParameters'
      responses:
        "201":
          $ref: '#/responses/AddActiveDirectoryPrincipalsResponse'
        default:
          $ref: '#/responses/Error'
  /public/activeDirectory/{name}/enableTrustedDomainState:
    post:
      tags:
      - ActiveDirectory
      summary: Updates the states of trusted domains discovery.
      operationId: EnableTrustedDomainDiscovery
      parameters:
      - x-go-name: Body
        description: Request to update enable trusted domains state of an Active Directory.
        name: body
        in: body
        required: true
        schema:
          $ref: '#/definitions/UpdateTrustedDomainEnableParams'
      - type: string
        x-go-name: Name
        description: Specifies the Active Directory Domain Name.
        name: name
        in: path
        required: true
      responses:
        "200":
          $ref: '#/responses/UpdateActiveDirectoryResponse'
        default:
          $ref: '#/responses/Error'
  /public/activeDirectory/{name}/idMappingInfo:
    put:
      tags:
      - ActiveDirectory
      summary: Updates the user id mapping info of an Active Directory.
      operationId: UpdateActiveDirectoryIdMapping
      parameters:
      - x-go-name: Body
        description: Request to update user id mapping of an Active Directory.
        name: body
        in: body
        required: true
        schema:
          $ref: '#/definitions/IdMappingInfo'
      - type: string
        x-go-name: Name
        description: Specifies the Active Directory Domain Name.
        name: name
        in: path
        required: true
      responses:
        "200":
          $ref: '#/responses/UpdateActiveDirectoryResponse'
        default:
          $ref: '#/responses/Error'
  /public/activeDirectory/{name}/ignoredTrustedDomains:
    put:
      tags:
      - ActiveDirectory
      summary: Updates the list of trusted domains to be ignored during trusted domain
        discovery of an Active Directory.
      operationId: UpdateActiveDirectoryIgnoredTrustedDomains
      parameters:
      - x-go-name: Body
        description: Request to update the list of ignored trusted domains of an AD.
        name: body
        in: body
        required: true
        schema:
          $ref: '#/definitions/UpdateIgnoredTrustedDomainsParams'
      - type: string
        x-go-name: Name
        description: Specifies the Active Directory Domain Name.
        name: name
        in: path
        required: true
      responses:
        "200":
          $ref: '#/responses/UpdateActiveDirectoryResponse'
        default:
          $ref: '#/responses/Error'
  /public/activeDirectory/{name}/ldapProvider:
    put:
      tags:
      - ActiveDirectory
      summary: Updates the LDAP provide Id for an Active Directory domain.
      operationId: UpdateActiveDirectoryLdapProvider
      parameters:
      - x-go-name: Body
        description: Request to update the LDAP provider info.
        name: body
        in: body
        required: true
        schema:
          $ref: '#/definitions/UpdateLdapProviderParams'
      - type: string
        x-go-name: Name
        description: Specifies the Active Directory Domain Name.
        name: name
        in: path
        required: true
      responses:
        "200":
          $ref: '#/responses/UpdateActiveDirectoryResponse'
        default:
          $ref: '#/responses/Error'
  /public/activeDirectory/{name}/machineAccounts:
    post:
      tags:
      - ActiveDirectory
      summary: Updates the machine accounts of an Active Directory.
      operationId: UpdateActiveDirectoryMachineAccounts
      parameters:
      - x-go-name: Body
        description: Request to update machine accounts of an Active Directory.
        name: body
        in: body
        required: true
        schema:
          $ref: '#/definitions/UpdateMachineAccountsParams'
      - type: string
        x-go-name: Name
        description: Specifies the Active Directory Domain Name.
        name: name
        in: path
        required: true
      responses:
        "200":
          $ref: '#/responses/UpdateActiveDirectoryMachineAccountsResponse'
        default:
          $ref: '#/responses/Error'
  /public/activeDirectory/{name}/preferredDomainControllers:
    put:
      description: Updates the preferred domain controllers of an Active Directory
      tags:
      - ActiveDirectory
      operationId: UpdatePreferredDomainControllers
      parameters:
      - x-go-name: Body
        description: Request to update preferred domain controllers of an Active Directory.
        name: body
        in: body
        required: true
        schema:
          type: array
          items:
            $ref: '#/definitions/PreferredDomainController'
      - type: string
        x-go-name: Name
        description: Specifies the Active Directory Domain Name.
        name: name
        in: path
        required: true
      responses:
        "200":
          $ref: '#/responses/UpdateActiveDirectoryResponse'
        default:
          $ref: '#/responses/Error'
  /public/alertCategories:
    get:
      description: Returns alert categories in Cohesity cluster.
      tags:
      - Alerts
      summary: Get alert categories in the Cohesity cluster.
      operationId: GetAlertCategories
      responses:
        "200":
          $ref: '#/responses/GetAlertCategoriesResponse'
        default:
          $ref: '#/responses/Error'
  /public/alertNotificationRules:
    get:
      description: |-
        Gets all alert notification rules containing criteria to deliver notification
        to delivery targets such as email addresses, invoking external apis etc.
      tags:
      - Alerts
      summary: Gets all alert notification rules.
      operationId: GetNotificationRules
      responses:
        "200":
          $ref: '#/responses/GetNotificationRulesResponse'
        default:
          $ref: '#/responses/Error'
    put:
      description: |-
        Updates delivery targets such as email addresses and external apis in an
        existing notification rule.
      tags:
      - Alerts
      summary: Updates an existing alert notification rule.
      operationId: UpdateNotificationRule
      responses:
        "200":
          $ref: '#/responses/UpdateNotificationRulesResponse'
        default:
          $ref: '#/responses/Error'
    post:
      description: |-
        Creates a new notification rule with provided delivery targets such as email
        addresses and external apis.
      tags:
      - Alerts
      summary: Creates a new alert notification rule.
      operationId: CreateNotificationRule
      parameters:
      - x-go-name: Body
        description: Create Notification Rule argument.
        name: body
        in: body
        schema:
          $ref: '#/definitions/NotificationRule'
      responses:
        "201":
          $ref: '#/responses/CreateNotificationRulesResponse'
        default:
          $ref: '#/responses/Error'
  /public/alertNotificationRules/{ruleId}:
    delete:
      description: Deletes an existing alert notification rule matching the rule id.
      tags:
      - Alerts
      summary: Deletes an alert notification rule.
      operationId: DeleteNotificationRule
      parameters:
      - type: integer
        format: int64
        x-go-name: RuleId
        description: Specifies the rule id.
        name: ruleId
        in: path
        required: true
      responses:
        "204":
          $ref: '#/responses/NoContentResponse'
        default:
          $ref: '#/responses/Error'
  /public/alertResolutions:
    get:
      description: |-
        Returns all Alert Resolution objects found on the Cohesity Cluster
        that match the filter criteria specified using parameters.
        If no filter parameters are specified,
        all Alert Resolution objects are returned.
        Each object provides details about the Alert Resolution such as
        the resolution summary and details.
      tags:
      - Alerts
      summary: List the Alert Resolutions on the Cohesity Cluster.
      operationId: GetResolutions
      parameters:
      - type: array
        items:
          type: integer
          format: int64
        x-go-name: ResolutionIdList
        description: Specifies list of Alert Resolution ids to filter resolutions
          by.
        name: resolutionIdList
        in: query
      - type: array
        items:
          type: string
        x-go-name: AlertIdList
        description: Specifies list of Alert Resolution ids to filter resolutions
          by.
        name: alertIdList
        in: query
      - type: integer
        format: int64
        x-go-name: StartTimeUsecs
        description: Specifies Start Time Unix epoch in microseconds to filter resolutions
          by.
        name: startDateUsecs
        in: query
      - type: integer
        format: int64
        x-go-name: EndTimeUsecs
        description: Specifies End Time Unix epoch in microseconds to filter resolutions
          by.
        name: endDateUsecs
        in: query
      - type: integer
        format: int32
        x-go-name: MaxResolutions
        description: |-
          Specifies the number of returned Resolutions to be returned. The newest
          Resolutions are returned.
        name: maxResolutions
        in: query
        required: true
      - type: array
        items:
          type: string
        x-go-name: TenantIds
        description: |-
          TenantIds contains ids of the tenants for which objects are to be
          returned.
        name: tenantIds
        in: query
      - type: boolean
        x-go-name: AllUnderHierarchy
        description: |-
          AllUnderHierarchy specifies if objects of all the tenants under the
          hierarchy of the logged in user's organization should be returned.
        name: allUnderHierarchy
        in: query
      responses:
        "200":
          $ref: '#/responses/GetResolutionsResponse'
        default:
          $ref: '#/responses/Error'
    post:
      description: |-
        Create an Alert Resolution and apply it to one or more Alerts.
        Mark the Alerts as resolved.
      tags:
      - Alerts
      summary: Create an Alert Resolution.
      operationId: CreateResolution
      parameters:
      - x-go-name: Body
        description: Request to create an Alert Resolution and apply it to the specified
          Alerts.
        name: body
        in: body
        required: true
        schema:
          $ref: '#/definitions/AlertResolutionRequest'
      responses:
        "201":
          $ref: '#/responses/CreateResolutionResponse'
        default:
          $ref: '#/responses/Error'
  /public/alertResolutions/{id}:
    get:
      description: |-
        Returns the Alert Resolution object corresponding to passed in Alert
        Resolution Id.
      tags:
      - Alerts
      summary: List details about a single Alert Resolution.
      operationId: GetResolutionById
      parameters:
      - type: integer
        format: int64
        x-go-name: Id
        description: Unique id of the Alert Resolution to return.
        name: id
        in: path
        required: true
      responses:
        "200":
          $ref: '#/responses/GetResolutionByIdResponse'
        default:
          $ref: '#/responses/Error'
    put:
      description: |-
        Apply an existing Alert Resolution to one or more additional Alerts.
        Mark those additional Alerts as resolved.
      tags:
      - Alerts
      summary: Apply an existing Alert Resolution to additional Alerts.
      operationId: UpdateResolution
      parameters:
      - type: integer
        format: int64
        x-go-name: Id
        description: Unique id of the Alert Resolution to return.
        name: id
        in: path
        required: true
      - x-go-name: Body
        description: Request to apply an existing resolution to the specified Alerts.
        name: body
        in: body
        required: true
        schema:
          $ref: '#/definitions/UpdateResolutionParams'
      responses:
        "200":
          $ref: '#/responses/UpdateResolutionResponse'
        default:
          $ref: '#/responses/Error'
  /public/alertTypes:
    get:
      description: |-
        Returns registered alerts in the Cohesity cluster that match the filter
        criteria specified using parameters. If no filter parameters are specified,
        all registered alerts in the Cohesity cluster are returned.
      tags:
      - Alerts
      summary: Get registered alerts in the Cohesity cluster.
      operationId: GetAlertTypes
      parameters:
      - x-go-name: Body
        description: Get alert types params.
        name: body
        in: body
        required: true
        schema:
          $ref: '#/definitions/GetAlertTypesParams'
      responses:
        "200":
          $ref: '#/responses/GetAlertTypesResponse'
        default:
          $ref: '#/responses/Error'
  /public/alerts:
    get:
      description: |-
        Returns all Alert objects found on the Cohesity Cluster that
        match the filter criteria specified using parameters.
        The Cohesity Cluster creates an Alert when a potential problem
        is found or when a threshold has been exceeded on the Cohesity Cluster.
        If no filter parameters are specified, all Alert objects are returned.
        Each object provides details about the Alert such as the Status and Severity.
      tags:
      - Alerts
      summary: List the Alerts on the Cohesity Cluster.
      operationId: GetAlerts
      parameters:
      - type: array
        items:
          type: string
        x-go-name: AlertIdList
        description: Specifies list of Alert ids to filter alerts by.
        name: alertIdList
        in: query
      - type: array
        items:
          type: integer
          format: int32
        x-go-name: AlertTypeList
        description: Specifies list of Alert Types to filter alerts by.
        name: alertTypeList
        in: query
      - type: array
        items:
          enum:
          - kDisk
          - kNode
          - kCluster
          - kNodeHealth
          - kClusterHealth
          - kBackupRestore
          - kEncryption
          - kArchivalRestore
          - kRemoteReplication
          - kQuota
          type: string
        x-go-name: AlertCategoryList
        description: Specifies list of Alert Categories.
        name: alertCategoryList
        in: query
      - type: string
        x-go-name: PropertyKey
        description: Specifies name of the property to filter alerts by.
        name: propertyKey
        in: query
      - type: string
        x-go-name: PropertyValue
        description: Specifies value of the property to filter alerts by.
        name: propertyValue
        in: query
      - type: integer
        format: int64
        x-go-name: StartTimeUsecs
        description: Specifies start time Unix epoch time in microseconds to filter
          alerts by.
        name: startDateUsecs
        in: query
      - type: integer
        format: int64
        x-go-name: EndTimeUsecs
        description: Specifies end time Unix epoch time in microseconds to filter
          alerts by.
        name: endDateUsecs
        in: query
      - type: array
        items:
          enum:
          - kOpen
          - kResolved
          - kAlertSuppressed
          type: string
        x-go-name: AlertStateList
        description: Specifies list of Alert States to filter alerts by.
        name: alertStateList
        in: query
      - type: array
        items:
          enum:
          - kCritical
          - kWarning
          - kInfo
          type: string
        x-go-name: AlertSeverityList
        description: Specifies list of Alert severity to filter alerts by.
        name: alertSeverityList
        in: query
      - type: array
        items:
          enum:
          - kSoftware
          - kHardware
          - kService
          - kOther
          type: string
        x-go-name: AlertTypeBucketList
        description: |-
          Specifies the list of Alert type bucket.
          Specifies the Alert type bucket.
          kSoftware - Alerts which are related to Cohesity services.
          kHardware - Alerts related to hardware on which Cohesity software is running.
          kService - Alerts related to other external services.
          kOther - Alerts not of one of above categories.
        name: alertTypeBucketList
        in: query
      - type: array
        items:
          type: integer
          format: int64
        x-go-name: ResolutionIdList
        description: Specifies alert resolution ids to filter alerts by.
        name: resolutionIdList
        in: query
      - type: integer
        format: int32
        x-go-name: MaxAlerts
        description: |-
          Specifies the number of returned Alerts to be returned. The newest Alerts
          are returned.
        name: maxAlerts
        in: query
        required: true
      - type: array
        items:
          type: string
        x-go-name: TenantIds
        description: |-
          TenantIds contains ids of the tenants for which objects are to be
          returned.
        name: tenantIds
        in: query
      - type: boolean
        x-go-name: AllUnderHierarchy
        description: |-
          AllUnderHierarchy specifies if objects of all the tenants under the
          hierarchy of the logged in user's organization should be returned.
        name: allUnderHierarchy
        in: query
      responses:
        "200":
          $ref: '#/responses/GetAlertsResponse'
        default:
          $ref: '#/responses/Error'
  /public/alerts/{id}:
    get:
      description: Returns the Alert object corresponding to the specified id.
      tags:
      - Alerts
      summary: List details about a single Alert.
      operationId: GetAlertById
      parameters:
      - type: string
        x-go-name: Id
        description: Unique id of the Alert to return.
        name: id
        in: path
        required: true
      responses:
        "200":
          $ref: '#/responses/GetAlertByIdResponse'
        default:
          $ref: '#/responses/Error'
  /public/analytics/analyzeJar:
    post:
      description: Returns the result of the jar analysis.
      tags:
      - Analytics
      summary: Analyze the uploaded jar.
      operationId: AnalyzeJar
      parameters:
      - name: Body
        in: body
        schema:
          $ref: '#/definitions/AnalyseJarArg'
      responses:
        "200":
          $ref: '#/responses/AnalyzeJarResponse'
        default:
          $ref: '#/responses/Error'
  /public/analytics/apps:
    get:
      description: |-
        If no parameters are specified, all Applications currently on
        the Cohesity Cluster are returned.
        Specifying parameters filters the results that are returned.
      tags:
      - Analytics
      summary: List Applications filtered by the specified parameters.
      operationId: GetApplications
      responses:
        "200":
          $ref: '#/responses/GetApplicationsResponse'
        default:
          $ref: '#/responses/Error'
    post:
      description: Returns the created application.
      tags:
      - Analytics
      summary: Create an Application.
      operationId: CreateApplication
      parameters:
      - name: Body
        in: body
        schema:
          $ref: '#/definitions/MapReduceInfo'
      responses:
        "201":
          $ref: '#/responses/ApplicationResponse'
        default:
          $ref: '#/responses/Error'
  /public/analytics/apps/{id}:
    get:
      description: Returns the Application corresponding to the specified Application
        Id.
      tags:
      - Analytics
      summary: List details about a single Application.
      operationId: GetApplicationById
      parameters:
      - type: integer
        format: int64
        x-go-name: Id
        name: id
        in: path
        required: true
      responses:
        "200":
          $ref: '#/responses/GetApplicationByIdResponse'
        default:
          $ref: '#/responses/Error'
    put:
      description: Returns the updated Application.
      tags:
      - Analytics
      summary: Update an Application.
      operationId: UpdateApplication
      parameters:
      - name: Body
        in: body
        schema:
          $ref: '#/definitions/MapReduceInfo'
      - type: integer
        format: int64
        x-go-name: Id
        name: id
        in: path
        required: true
      responses:
        "200":
          $ref: '#/responses/ApplicationResponse'
        default:
          $ref: '#/responses/Error'
    delete:
      description: Returns delete status upon completion.
      tags:
      - Analytics
      summary: Delete an Application.
      operationId: DeleteApplication
      parameters:
      - type: integer
        format: int64
        x-go-name: Id
        name: id
        in: path
        required: true
      responses:
        "204":
          $ref: '#/responses/NoContentResponse'
        default:
          $ref: '#/responses/Error'
  /public/analytics/cancelAppInstanceRun/{id}:
    put:
      description: Returns the result.
      tags:
      - Analytics
      summary: Cancel a specific map reduce instance run.
      operationId: CancelMapReduceInstanceRun
      parameters:
      - type: integer
        format: int64
        x-go-name: Id
        name: id
        in: path
        required: true
      responses:
        "200":
          $ref: '#/responses/CancelMapReduceInstanceRunResponse'
        default:
          $ref: '#/responses/Error'
  /public/analytics/mappers:
    get:
      description: |-
        If no parameters are specified, all Mappers currently on
        the Cohesity Cluster are returned.
        Specifying parameters filters the results that are returned.
      tags:
      - Analytics
      summary: List Mappers filtered by the specified parameters.
      operationId: GetMappers
      responses:
        "200":
          $ref: '#/responses/GetMappersResponse'
        default:
          $ref: '#/responses/Error'
    post:
      description: Returns the created mapper.
      tags:
      - Analytics
      summary: Create a Mapper.
      operationId: CreateMapper
      parameters:
      - name: Body
        in: body
        schema:
          $ref: '#

# --- truncated at 32 KB (2507 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/cohesity/refs/heads/main/openapi/cohesity-cluster-v1-openapi.yml