openapi: 3.2.0
info:
description: Cohesity API provides a RESTful interface to access the various data management operations on Cohesity cluster and Helios.
title: Cohesity REST Protection Groups API
version: '2.0'
servers:
- url: /v2
tags:
- name: Protection Groups
paths:
/data-protect/protection-groups:
get:
description: Get the list of Protection Groups.
tags:
- Protection Groups
summary: Get the list of Protection Groups
operationId: GetProtectionGroups
parameters:
- description: Filter by a list of Protection Group ids.
name: ids
in: query
schema:
type: array
items:
type: string
- description: Filter by a list of Protection Group names.
name: names
in: query
schema:
type: array
items:
type: string
- description: Filter by Policy ids that are associated with Protection Groups. Only Protection Groups associated with the specified Policy ids, are returned.
name: policyIds
in: query
schema:
type: array
items:
type: string
- description: Filter by Storage Domain id. Only Protection Groups writing data to this Storage Domain will be returned.
name: storageDomainId
in: query
schema:
type: integer
format: int64
- description: Whether to only return Protection Groups with a datalock.
name: includeGroupsWithDatalockOnly
in: query
schema:
type: boolean
- description: Filter by environment types such as 'kVMware', 'kView', etc. Only Protection Groups protecting the specified environment types are returned.
name: environments
in: query
schema:
type: array
items:
enum:
- kVMware
- kHyperV
- kAzure
- kGCP
- kKVM
- kAcropolis
- kAWS
- kPhysical
- kGPFS
- kElastifile
- kNetapp
- kGenericNas
- kIsilon
- kFlashBlade
- kPure
- kSQL
- kExchange
- kAD
- kOracle
- kView
- kRemoteAdapter
- kO365
- kKubernetes
- kCassandra
- kMongoDB
- kCouchbase
- kHdfs
- kHive
- kHBase
- kUDA
type: string
- name: office365Workloads
in: query
schema:
type: array
items:
enum:
- kMailbox
- kOneDrive
- kSharePoint
- kPublicFolders
- kGroups
- kTeams
type: string
- description: Filter by Inactive or Active Protection Groups. If not set, all Inactive and Active Protection Groups are returned. If true, only Active Protection Groups are returned. If false, only Inactive Protection Groups are returned. When you create a Protection Group on a Primary Cluster with a replication schedule, the Cluster creates an Inactive copy of the Protection Group on the Remote Cluster. In addition, when an Active and running Protection Group is deactivated, the Protection Group becomes Inactive.
name: isActive
in: query
schema:
type: boolean
- description: If true, return only Protection Groups that have been deleted but still have Snapshots associated with them. If false, return all Protection Groups except those Protection Groups that have been deleted and still have Snapshots associated with them. A Protection Group that is deleted with all its Snapshots is not returned for either of these cases.
name: isDeleted
in: query
schema:
type: boolean
- description: Filter by paused or non paused Protection Groups, If not set, all paused and non paused Protection Groups are returned. If true, only paused Protection Groups are returned. If false, only non paused Protection Groups are returned.
name: isPaused
in: query
schema:
type: boolean
- description: Filter by last local backup run status.
'Running' indicates that the run is still running.
'Canceled' indicates that the run has been canceled.
'Canceling' indicates that the run is in the process of being canceled.
'Failed' indicates that the run has failed.
'Missed' indicates that the run was unable to take place at the scheduled time because the previous run was still happening.
'Succeeded' indicates that the run has finished successfully.
'SucceededWithWarning' indicates that the run finished successfully, but there were some warning messages.
name: lastRunLocalBackupStatus
in: query
schema:
type: array
items:
enum:
- Accepted
- Running
- Canceled
- Canceling
- Failed
- Missed
- Succeeded
- SucceededWithWarning
- OnHold
type: string
- description: Filter by last remote replication run status.
'Running' indicates that the run is still running.
'Canceled' indicates that the run has been canceled.
'Canceling' indicates that the run is in the process of being canceled.
'Failed' indicates that the run has failed.
'Missed' indicates that the run was unable to take place at the scheduled time because the previous run was still happening.
'Succeeded' indicates that the run has finished successfully.
'SucceededWithWarning' indicates that the run finished successfully, but there were some warning messages.
name: lastRunReplicationStatus
in: query
schema:
type: array
items:
enum:
- Accepted
- Running
- Canceled
- Canceling
- Failed
- Missed
- Succeeded
- SucceededWithWarning
- OnHold
type: string
- description: Filter by last cloud archival run status.
'Running' indicates that the run is still running.
'Canceled' indicates that the run has been canceled.
'Canceling' indicates that the run is in the process of being canceled.
'Failed' indicates that the run has failed.
'Missed' indicates that the run was unable to take place at the scheduled time because the previous run was still happening.
'Succeeded' indicates that the run has finished successfully.
'SucceededWithWarning' indicates that the run finished successfully, but there were some warning messages.
name: lastRunArchivalStatus
in: query
schema:
type: array
items:
enum:
- Accepted
- Running
- Canceled
- Canceling
- Failed
- Missed
- Succeeded
- SucceededWithWarning
- OnHold
type: string
- description: Filter by last cloud spin run status.
'Running' indicates that the run is still running.
'Canceled' indicates that the run has been canceled.
'Canceling' indicates that the run is in the process of being canceled.
'Failed' indicates that the run has failed.
'Missed' indicates that the run was unable to take place at the scheduled time because the previous run was still happening.
'Succeeded' indicates that the run has finished successfully.
'SucceededWithWarning' indicates that the run finished successfully, but there were some warning messages.
name: lastRunCloudSpinStatus
in: query
schema:
type: array
items:
enum:
- Accepted
- Running
- Canceled
- Canceling
- Failed
- Missed
- Succeeded
- SucceededWithWarning
- OnHold
type: string
- description: Filter by last any run status.
'Running' indicates that the run is still running.
'Canceled' indicates that the run has been canceled.
'Canceling' indicates that the run is in the process of being canceled.
'Failed' indicates that the run has failed.
'Missed' indicates that the run was unable to take place at the scheduled time because the previous run was still happening.
'Succeeded' indicates that the run has finished successfully.
'SucceededWithWarning' indicates that the run finished successfully, but there were some warning messages.
name: lastRunAnyStatus
in: query
schema:
type: array
items:
enum:
- Accepted
- Running
- Canceled
- Canceling
- Failed
- Missed
- Succeeded
- SucceededWithWarning
- OnHold
type: string
- description: If true, return Protection Groups for which last run SLA was violated.
name: isLastRunSlaViolated
in: query
schema:
type: boolean
- description: TenantIds contains ids of the tenants for which objects are to be returned.
name: tenantIds
in: query
schema:
type: array
items:
type: string
- description: If true, the response will include Protection Groups which were created by all tenants which the current user has permission to see. If false, then only Protection Groups created by the current user will be returned.
name: includeTenants
in: query
schema:
type: boolean
- description: If true, the response will include last run info. If it is false or not specified, the last run info won't be returned.
name: includeLastRunInfo
in: query
schema:
type: boolean
- description: If true, the response will not include the list of excluded source IDs in groups that contain this field. This can be set to true in order to improve performance if excluded source IDs are not needed by the user.
name: pruneExcludedSourceIds
in: query
schema:
type: boolean
responses:
'200':
$ref: '#/components/responses/GetProtectionGroupsResponse'
default:
$ref: '#/components/responses/ErrorResponse'
security:
- APIKeyHeader: []
post:
description: Create a Protection Group.
tags:
- Protection Groups
summary: Create a Protection Group
operationId: CreateProtectionGroup
responses:
'201':
$ref: '#/components/responses/CreateOrUpdateProtectionGroupResponse'
default:
$ref: '#/components/responses/ErrorResponse'
security:
- APIKeyHeader: []
requestBody:
content:
application/json:
schema:
x-cohesity-discriminator-ref: CommonProtectionGroupRequestParams
$ref: '#/components/schemas/CommonProtectionGroupRequestParamse9ef605d-4350-4f91-93ca-9e8a25d0f659'
description: Specifies the parameters to create a Protection Group.
required: true
/data-protect/protection-groups/states:
post:
description: Perform an action like pause, resume, active, deactivate on all specified Protection Groups. Note that the pause or resume actions will take effect from next Protection Run. Also, user can specify only one type of action on all the Protection Groups. Deactivate and activate actions are independent of pause and resume state. Deactivate and activate actions are useful in case of failover situations. Returns success if the state of all the Protection Groups state is changed successfully.
tags:
- Protection Groups
summary: Perform an action like pause, resume, active, deactivate on all specified…
operationId: UpdateProtectionGroupsState
responses:
'200':
$ref: '#/components/responses/UpdateProtectionGroupsStateResponse'
default:
$ref: '#/components/responses/ErrorResponse'
security:
- APIKeyHeader: []
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateProtectionGroupsStateRequest'
description: Specifies the parameters to perform an action of list of Protection Groups.
required: true
/data-protect/protection-groups/{id}:
get:
description: Returns the Protection Group corresponding to the specified Group id.
tags:
- Protection Groups
summary: List details about single Protection Group
operationId: GetProtectionGroupById
parameters:
- description: Specifies a unique id of the Protection Group.
name: id
in: path
required: true
schema:
type: string
- description: If true, the response will include last run info. If it is false or not specified, the last run info won't be returned.
name: includeLastRunInfo
in: query
schema:
type: boolean
- description: If true, the response will not include the list of excluded source IDs in groups that contain this field. This can be set to true in order to improve performance if excluded source IDs are not needed by the user.
name: pruneExcludedSourceIds
in: query
schema:
type: boolean
responses:
'200':
$ref: '#/components/responses/GetProtectionGroupResponse'
default:
$ref: '#/components/responses/ErrorResponse'
security:
- APIKeyHeader: []
put:
description: Update the specified Protection Group.
tags:
- Protection Groups
summary: Update a Protection Group
operationId: UpdateProtectionGroup
parameters:
- description: Specifies the id of the Protection Group.
name: id
in: path
required: true
schema:
type: string
responses:
'200':
$ref: '#/components/responses/CreateOrUpdateProtectionGroupResponse'
default:
$ref: '#/components/responses/ErrorResponse'
security:
- APIKeyHeader: []
requestBody:
content:
application/json:
schema:
x-cohesity-discriminator-ref: CommonProtectionGroupRequestParams
$ref: '#/components/schemas/CommonProtectionGroupRequestParamse9ef605d-4350-4f91-93ca-9e8a25d0f659'
description: Specifies the parameters to update a Protection Group.
required: true
delete:
description: Returns Success if the Protection Group is deleted.
tags:
- Protection Groups
summary: Delete a Protection Group
operationId: DeleteProtectionGroup
parameters:
- description: Specifies a unique id of the Protection Group.
name: id
in: path
required: true
schema:
type: string
- description: Specifies if Snapshots generated by the Protection Group should also be deleted when the Protection Group is deleted.
name: deleteSnapshots
in: query
schema:
type: boolean
responses:
'204':
$ref: '#/components/responses/NoContentResponse'
default:
$ref: '#/components/responses/ErrorResponse'
security:
- APIKeyHeader: []
/data-protect/protection-groups/{id}/runs:
get:
description: Get the runs for a particular Protection Group.
tags:
- Protection Groups
summary: Get the list of runs for a Protection Group
operationId: GetProtectionGroupRuns
parameters:
- description: Specifies a unique id of the Protection Group.
name: id
in: path
required: true
schema:
type: string
- description: Specifies the protection run id.
name: runId
in: query
schema:
type: string
pattern: ^\d+:\d+$
- description: Filter by a start time. Specify the start time as a Unix epoch Timestamp (in microseconds).
name: startTimeUsecs
in: query
schema:
type: integer
format: int64
- description: Filter by a end time. Specify the start time as a Unix epoch Timestamp (in microseconds).
name: endTimeUsecs
in: query
schema:
type: integer
format: int64
- description: TenantIds contains ids of the tenants for which objects are to be returned.
name: tenantIds
in: query
schema:
type: array
items:
type: string
- description: If true, the response will include Protection Group Runs which were created by all tenants which the current user has permission to see. If false, then only Protection Group Runs created by the current user will be returned.
name: includeTenants
in: query
schema:
type: boolean
- description: Filter by run type. Only protection run matching the specified types will be returned.
name: runTypes
in: query
schema:
type: array
items:
enum:
- kAll
- kLog
- kSystem
- kIncremental
- kFull
type: string
uniqueItems: true
- description: Specifies if the result includes the object details for each protection run. If set to true, details of the protected object will be returned. If set to false or not specified, details will not be returned.
name: includeObjectDetails
in: query
schema:
type: boolean
- description: Specifies a list of local backup status, runs matching the status will be returned.
'Running' indicates that the run is still running.
'Canceled' indicates that the run has been canceled.
'Canceling' indicates that the run is in the process of being canceled.
'Failed' indicates that the run has failed.
'Missed' indicates that the run was unable to take place at the scheduled time because the previous run was still happening.
'Succeeded' indicates that the run has finished successfully.
'SucceededWithWarning' indicates that the run finished successfully, but there were some warning messages.
name: localBackupRunStatus
in: query
schema:
type: array
items:
enum:
- Accepted
- Running
- Canceled
- Canceling
- Failed
- Missed
- Succeeded
- SucceededWithWarning
- OnHold
type: string
- description: Specifies a list of replication status, runs matching the status will be returned.
'Running' indicates that the run is still running.
'Canceled' indicates that the run has been canceled.
'Canceling' indicates that the run is in the process of being canceled.
'Failed' indicates that the run has failed.
'Missed' indicates that the run was unable to take place at the scheduled time because the previous run was still happening.
'Succeeded' indicates that the run has finished successfully.
'SucceededWithWarning' indicates that the run finished successfully, but there were some warning messages.
name: replicationRunStatus
in: query
schema:
type: array
items:
enum:
- Accepted
- Running
- Canceled
- Canceling
- Failed
- Missed
- Succeeded
- SucceededWithWarning
- OnHold
type: string
- description: Specifies a list of archival status, runs matching the status will be returned.
'Running' indicates that the run is still running.
'Canceled' indicates that the run has been canceled.
'Canceling' indicates that the run is in the process of being canceled.
'Failed' indicates that the run has failed.
'Missed' indicates that the run was unable to take place at the scheduled time because the previous run was still happening.
'Succeeded' indicates that the run has finished successfully.
'SucceededWithWarning' indicates that the run finished successfully, but there were some warning messages.
name: archivalRunStatus
in: query
schema:
type: array
items:
enum:
- Accepted
- Running
- Canceled
- Canceling
- Failed
- Missed
- Succeeded
- SucceededWithWarning
- OnHold
type: string
- description: Specifies a list of cloud spin status, runs matching the status will be returned.
'Running' indicates that the run is still running.
'Canceled' indicates that the run has been canceled.
'Canceling' indicates that the run is in the process of being canceled.
'Failed' indicates that the run has failed.
'Missed' indicates that the run was unable to take place at the scheduled time because the previous run was still happening.
'Succeeded' indicates that the run has finished successfully.
'SucceededWithWarning' indicates that the run finished successfully, but there were some warning messages.
name: cloudSpinRunStatus
in: query
schema:
type: array
items:
enum:
- Accepted
- Running
- Canceled
- Canceling
- Failed
- Missed
- Succeeded
- SucceededWithWarning
- OnHold
type: string
- description: Specifies the max number of runs. If not specified, at most 100 runs will be returned.
name: numRuns
in: query
schema:
type: integer
format: int64
- description: Specifies whether to exclude non restorable runs. Run is treated restorable only if there is atleast one object snapshot (which may be either a local or an archival snapshot) which is not deleted or expired. Default value is false.
name: excludeNonRestorableRuns
in: query
schema:
type: boolean
default: false
responses:
'200':
$ref: '#/components/responses/GetProtectionGroupRunsResponse'
default:
$ref: '#/components/responses/ErrorResponse'
security:
- APIKeyHeader: []
put:
description: 'Update runs for a particular Protection Group. A user can perform the following actions: 1. Extend or reduce retention of a local, replication and archival snapshots. 2. Can perform resync operation on failed copy snapshots attempts in this Run. 3. Add new replication and archival snapshot targets to the Run. 4. Add or remove legal hold on the snapshots. Only a user with DSO role can perform this operation. 5. Delete the snapshots that were created as a part of this Run. 6. Apply datalock on existing snapshots where a user cannot manually delete snapshots before the expiry time.'
tags:
- Protection Groups
summary: Update runs for a particular Protection Group
operationId: UpdateProtectionGroupRun
parameters:
- description: Specifies a unique id of the Protection Group.
name: id
in: path
required: true
schema:
type: string
responses:
'207':
$ref: '#/components/responses/UpdateProtectionGroupRunResponse'
default:
$ref: '#/components/responses/ErrorResponse'
security:
- APIKeyHeader: []
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateProtectionGroupRunRequestBody'
description: Specifies the parameters to update a Protection Group Run.
required: true
post:
description: Create a new protection run. This can be used to start a run for a Protection Group on demand, ignoring the schedule and retention specified in the protection policy.
tags:
- Protection Groups
summary: Create a new protection run
operationId: CreateProtectionGroupRun
parameters:
- description: Specifies a unique id of the Protection Group.
name: id
in: path
required: true
schema:
type: string
responses:
'202':
$ref: '#/components/responses/CreateProtectionGroupRunResponse'
default:
$ref: '#/components/responses/ErrorResponse'
security:
- APIKeyHeader: []
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/CreateProtectionGroupRunRequest'
description: Specifies the parameters to start a protection run.
required: true
/data-protect/protection-groups/{id}/runs/{runId}:
get:
description: Get a run for a particular Protection Group.
tags:
- Protection Groups
summary: Get a run for a Protection Group
operationId: GetProtectionGroupRun
parameters:
- description: Specifies a unique id of the Protection Group.
name: id
in: path
required: true
schema:
type: string
- description: Specifies a unique run id of the Protection Group run.
name: runId
in: path
required: true
schema:
type: string
pattern: ^\d+:\d+$
- description: TenantIds contains ids of the tenants for which the run is to be returned.
name: tenantIds
in: query
schema:
type: array
items:
type: string
- description: If true, the response will include Protection Group Runs which were created by all tenants which the current user has permission to see. If false, then only Protection Groups created by the current user will be returned. If it's not specified, it is true by default.
name: includeTenants
in: query
schema:
type: boolean
- description: Specifies if the result includes the object details for a protection run. If set to true, details of the protected object will be returned. If set to false or not specified, details will not be returned.
name: includeObjectDetails
in: query
schema:
type: boolean
responses:
'200':
$ref: '#/components/responses/GetProtectionGroupRunResponse'
default:
$ref: '#/components/responses/ErrorResponse'
security:
- APIKeyHeader: []
/data-protect/protection-groups/{id}/runs/{runId}/cancel:
post:
description: Cancel protection run for a given protection group ID and run ID.
tags:
- Protection Groups
summary: Cancel protection group run
operationId: CancelProtectionGroupRun
parameters:
- description: Specifies a unique id of the Protection Group.
name: id
in: path
required: true
schema:
type: string
- description: Specifies a unique run id of the Protection Group run.
name: runId
in: path
required: true
schema:
type: string
pattern: ^\d+:\d+$
responses:
'200':
description: OK
default:
$ref: '#/components/responses/ErrorResponse'
security:
- APIKeyHeader: []
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/CancelProtectionGroupRunRequest'
description: Specifies the parameters to cancel a protection run.
required: true
/data-protect/protection-groups/{id}/runs/{runId}/debug-logs:
get:
description: Get the debug logs for all objects of a run for a particular Protection Group.
tags:
- Protection Groups
summary: Get the debug logs for a run from a Protection Group
operationId: GetRunDebugLogs
parameters:
- description: Specifies a unique id of the Protection Group.
name: id
in: path
required: true
schema:
type: string
pattern: ^\d+:\d+:\d+$
- description: Specifies a unique run id of the Protection Group run.
name: runId
in: path
required: true
schema:
type: string
pattern: ^\d+:\d+$
- description: 'Specifies the id of the object for which debug logs are to be returned. '
name: objectId
in: query
schema:
type: string
responses:
'200':
$ref: '#/components/responses/NoContentResponse'
default:
$ref: '#/components/responses/ErrorResponse'
security:
- APIKeyHeader: []
/data-protect/protection-groups/{id}/runs/{runId}/objects/{objectId}/debug-logs:
get:
description: Get the debug logs for a particular object of a run for a particular Protection Group.
tags:
- Protection Groups
summary: Get the debug logs for a particular object in a run from a Protection Group
operationId: GetRunDebugLogsForObject
parameters:
- description: Specifies a unique id of the Protection Group.
name: id
in: path
required: true
schema:
type: string
pattern: ^\d+:\d+:\d+$
- description: Specifies a unique run id of the Protection Group run.
name: runId
in: path
required: true
schema:
type: string
pattern: ^\d+:\d+$
- description: 'Specifies the id of the object for which debug logs are to be returned. '
name: objectId
in: path
required: true
schema:
type: string
responses:
'200':
$ref: '#/components/responses/NoContentResponse'
default:
$ref: '#/components/responses/ErrorResponse'
security:
- APIKeyHeader: []
/data-protect/protection-groups/{id}/runs/{runId}/objects/{objectId}/downloadMessages:
get:
description: Get an CSV error report for given objectId and run id. Each row in CSV report contains the File Path, error/warning code and error/warning message.
tags:
- Protection Groups
summary: Get the CSV of errors/warnings for a given run and an object
operationId: GetRunErrorsReport
parameters:
- description: Specifies a unique id of the Protection Group.
name: id
in: path
required: true
schema:
type: string
- description: Specifies a unique run id of the Protection Group run.
name: runId
in: path
required: true
schema:
type: string
pattern: ^\d+:\d+$
- description: 'Specifies the id of the object for which errors/warnings are to be returned. '
name: objectId
in: path
required: true
schema:
type: string
responses:
'200':
description: OK
default:
$ref: '#/components/responses/ErrorResponse'
security:
- APIKeyHeader: []
/data-protect/runs/summary:
get:
description: Get a list of protection runs.
tags:
- Protection Groups
summary: Get the list of runs
operationId: GetProtectionRuns
parameters:
- description: Filter by a start time. Specify the start time as a Unix epoch Timestamp (in microseconds), only runs executing after this time will be returned. By default it is endTimeUsecs minus an hour.
name: startTimeUsecs
in: query
schema:
type: integer
format: int64
- description: Filter by a end time. Specify the start time as a Unix epoch Timestamp (in microseconds), only runs executing before this time will be returned. By default it is current time.
name: endTimeUsecs
in: query
schema:
type: integer
format: int64
- description: Specifies a list of status, runs matching the status will be returned.
'Running' indicates that the run is still running.
'Canceled' indicates that the run has been canceled.
'Canceling' indicates that the run is in the process of being canceled.
'Failed' indicates that the run has failed.
'Missed' indicates that the run was unable to take place at the scheduled time because the previous run was still happening.
'Succeeded' indicates that the run has finished successfully.
'SucceededWithWarning' indicates that the run finished successfully, but there were some warning messages.
name: runStatus
in: query
schema:
type: array
items:
enum:
- Accepted
- Running
- Canceled
- Canceling
- Failed
- Missed
- Succeeded
- SucceededWithWarning
- OnHold
type: string
responses:
'200':
$ref: '#/components/responses/GetProtectionRunsResponse'
default:
$ref: '#/components/responses/ErrorResponse'
security:
- APIKeyHeader: []
/data-protect/runs/{runId}/progress:
get:
description: Get the progress of a run.
tags:
- Protection Groups
summary: Get the progress of a run
operationId: GetProtectionRunProgress
parameters:
- description: Specifies a unique run id of the Protection Run.
name: runId
in: path
required: true
schema:
type: string
- description: Specifies the objects whose progress will be returned. This only applies to protection group runs and will be ignored for object runs. If the objects are specified, the run progress will not be returned and only the progress of the specified objects will be returned.
name: objects
in: query
schema:
type: array
items:
type: integer
format: int64
- description: TenantIds contains ids of the tenants for which the run is to be returned.
name: tenantIds
in: query
schema:
type: array
items:
type: string
- description: If true, the response will include Protection Group Runs which were created by all tenants which the current user has permission to see. If false, then only Protection Groups created by the current user will be returned. If it's not specified, it is true by default.
name: includeTenants
in: query
schema:
type: boolean
- description: Specifies whether to return finished tasks. By default only active tasks are returned.
name: includeFinishedTasks
in: query
schema:
type: boolean
- description: Specifies the time after which the progress task starts in Unix epoch Timestamp(in microseconds).
name: startTimeUsecs
in: query
schema:
type: integer
format: int64
- description: Specifies the time before which the progress task ends in Unix epoch Timestamp(in microseconds).
name: endTimeUsecs
in: query
schema:
type: integer
format: int64
- description: Specifies the maximum number of tasks to return.
name: maxTasksNum
in: query
schema:
type: integer
format: int32
- description: Specifies whether to return objects. By default all the task tree are returned.
name: excludeObjectDetails
in: query
schema:
type: boolean
- description: Specifies whether to include event logs
name: includeEventLogs
in: query
schema:
type: boolean
responses:
'200':
$ref: '#/components/responses/GetProtectionRunProgress'
default:
$ref: '#/components/responses/ErrorResponse'
security:
- APIKeyHeader: []
components:
schemas:
AzureTargetConfig:
description: Specifies the configuration for adding Azure as replication target
type: object
title: Azure Target Configuration
required:
- sourceId
properties:
sourceId:
description: Specifies the source id of the Azure protection source registered on Cohesity cluster.
type:
- integer
- 'null'
format: int64
x-order: 0
name:
description: Specifies the name of the Azure Replication target.
type:
- string
- 'null'
x-order: 1
readOnly: true
resourceGroup:
description: Specifies id of the Azure resource group used to filter regions in UI.
type:
- integer
- 'null'
format: int64
x-order: 2
resourceGroupName:
description: Specifies name of the Azure resource group used to filter regions in UI.
type:
- string
- 'null'
x-order: 3
readOnly: true
storageAccount:
description: Specifies id of the storage account of Azure replication target which will contain storage container.
type:
- integer
- 'null'
x-order: 4
readOnly: true
storageAccountName:
description: Specifies name of the storage account of Azure replication target which will contain storage container.
type:
- string
- 'null'
x-order: 5
readOnly: true
storageContainer:
description: Specifies id of the storage container of Azure Replication target.
type:
- integer
- 'null'
x-order: 6
readOnly: true
storageContainerName:
description: Specifies name of the storage container of Azure Replication target.
type:
- string
- 'null'
x-order: 7
readOnly: true
storageResourceGroup:
description: Specifies id of the storage resource group of Azure Replication target.
type:
- integer
- 'null'
x-order: 8
readOnly: true
storageResourceGroupName:
description: Specifies name of the storage resource group of Azure Replication target.
type:
- string
- 'null'
x-order: 9
readOnly: true
ArchivalTargetTierInfo:
description: Specifies the tier info for archival.
title: Archival Target Tier Info
allOf:
- $ref: '#/components/schemas/TierLevelSettings'
- type: object
properties:
currentTierType:
description: Specifies the type of the current tier where the snapshot resides. This will be specified if the run is a CAD run.
type:
- string
- 'null'
enum:
- kAmazonS3Standard
- kAmazonS3StandardIA
- kAmazonS3OneZoneIA
- kAmazonS3IntelligentTiering
- kAmazonS3Glacier
- kAmazonS3GlacierDeepArchive
- kAzureTierHot
- kAzureTierCool
- kAzureTierArchive
- kGoogleStandard
- kGoogleRegional
- kGoogleMultiRegional
- kGoogleNearline
- kGoogleColdline
- kOracleTierStandard
- kOracleTierArchive
x-order: 0
RunTargetsConfiguration:
description: Specifies the replication and archival targets.
type: object
title: Target Configuration
properties:
replications:
description: Specifies a list of replication targets configurations.
type:
- array
- 'null'
items:
$ref: '#/components/schemas/RunReplicationConfig'
x-order: 0
archivals:
description: Specifies a list of archival targets configurations.
type:
- array
- 'null'
items:
$ref: '#/components/schemas/RunArchivalConfig'
x-order: 1
ObjectSummary:
description: Specifies the Object Summary.
title: Object Summary
allOf:
- $ref: '#/components/schemas/ObjectIdentifier'
- type: object
properties:
objectHash:
description: Specifies the hash identifier of the object.
type:
- string
- 'null'
x-order: 0
objectType:
description: Specifies the type of the object.
type:
- string
- 'null'
enum:
- kCluster
- kVserver
- kVolume
- kVCenter
- kStandaloneHost
- kvCloudDirector
- kFolder
- kDatacenter
- kComputeResource
- kClusterComputeResource
- kResourcePool
- kDatastore
- kHostSystem
- kVirtualMachine
- kVirtualApp
- kStoragePod
- kNetwork
- kDistributedVirtualPortgroup
- kTagCategory
- kTag
- kOpaqueNetwork
- kOrganization
- kVirtualDatacenter
- kCatalog
- kOrgMetadata
- kStoragePolicy
- kVirtualAppTemplate
- kDomain
- kOutlook
- kMailbox
- kUsers
- kGroups
- kSites
- kUser
- kGroup
- kSite
- kApplication
- kGraphUser
- kPublicFolders
- kPublicFolder
- kTeams
- kTeam
- kKeyspace
- kTable
- kDatabase
- kCollection
- kBucket
- kNamespace
- kSCVMMServer
- kStandaloneCluster
- kHostGroup
- kHypervHost
- kHostCluster
- kCustomProperty
- kSubscription
- kResourceGroup
- kStorageAccount
- kStorageKey
- kStorageContainer
- kStorageBlob
- kNetworkSecurityGroup
- kVirtualNetwork
- kSubnet
- kComputeOptions
- kSnapshotManagerPermit
- kAvailabilitySet
- kOVirtManager
- kHost
- kStorageDomain
- kVNicProfile
- kIAMUser
- kRegion
- kAvailabilityZone
- kEC2Instance
- kVPC
- kInstanceType
- kKeyPair
- kRDSOptionGroup
- kRDSParameterGroup
- kRDSInstance
- kRDSSubnet
- kRDSTag
- kAuroraCluster
- kAccount
- kSubTaskPermit
- kProject
- kLabel
- kMetadata
- kVPCConnector
- kPrismCentral
- kOtherHypervisorCluster
- kDfsGroup
- kDfsTopDir
- kZone
- kMountPoint
- kStorageArray
- kFileSystem
- kContainer
- kFilesystem
- kFileset
- kViewBox
- kView
- kWindowsCluster
- kOracleRACCluster
- kOracleAPCluster
- kService
- kPVC
- kRootContainer
- kDAGRootContainer
- kExchangeNode
- kExchangeDAGDatabaseCopy
- kExchangeStandaloneDatabase
- kExchangeDAG
- kExchangeDAGDatabase
- kDomainController
- kInstance
- kAAG
- kAAGRootContainer
- kRACRootContainer
- kTableSpace
- kPDB
- kObject
x-order: 1
logicalSizeBytes:
description: Specifies the logical size of object in bytes.
type:
- integer
- 'null'
format: int64
x-order: 2
uuid:
description: Specifies the uuid which is a unique identifier of the object.
type:
- string
- 'null'
x-order: 3
protectionType:
description: Specifies the protection type of the object if any.
type:
- string
- 'null'
enum:
- kAgent
- kNative
- kSnapshotManager
- kRDSSnapshotManager
- kAuroraSnapshotManager
- kFile
- kVolume
x-order: 4
osType:
description: Specifies the operating system type of the object.
type:
- string
- 'null'
enum:
- kLinux
- kWindows
- kAix
- kSolaris
- kSapHana
- kOther
x-order: 5
vCenterSummary:
description: Specifies the vCenter object details.
type:
- object
- 'null'
x-order: 6
$ref: '#/components/schemas/ObjectTypeVCenterParams'
UpdateReplicationSnapshotConfig:
description: Specifies the params to perform actions on replication snapshots taken by a Protection Group Run.
type: object
title: Replication Snapshot Config.
properties:
newSnapshotConfig:
description: Specifies the new configuration about adding Replication Snapshot to existing Protection Group Run.
type:
- array
- 'null'
items:
$ref: '#/components/schemas/RunReplicationConfig'
x-order: 0
updateExistingSnapshotConfig:
description: Specifies the configuration about updating an existing Replication Snapshot Run.
type:
- array
- 'null'
items:
$ref: '#/components/schemas/UpdateExistingReplicationSnapshotConfig'
x-order: 1
AlertTarget:
description: Specifies an alert target to receive an alert.
type: object
required:
- emailAddress
properties:
emailAddress:
description: Specifies an email address to receive an alert.
type:
- string
- 'null'
x-order: 0
language:
description: Specifies the language of the delivery target. Default value is 'en-us'.
type:
- string
- 'null'
enum:
- en-us
- ja-jp
- zh-cn
x-order: 1
recipientType:
description: Specifies the recipient type of email recipient. Default value is 'kTo'.
type:
- string
- 'null'
enum:
- kTo
- kCc
x-order: 2
FailedProtectionGroupDetails:
description: Specifies a list of ids of Protection Group that failed to update along with error details
type: object
properties:
protectionGroupId:
description: Specifies the id of the failed protection group.
type:
- string
- 'null'
x-order: 0
errorMessage:
description: Specifies the error mesage for failed protection group.
type:
- string
- 'null'
x-order: 1
SlaRule:
description: Specifies an SLA rule for a specific Protection Group run type.
type: object
properties:
backupRunType:
description: Specifies the type of run this rule should apply to.
type:
- string
- 'null'
enum:
- kIncremental
- kFull
x-order: 0
slaMinutes:
description: Specifies the number of minutes allotted to a run of the specified type before SLA is considered violated.
type:
- integer
- 'null'
format: int64
minimum: 1
x-order: 1
ReplicationTargetResult:
description: Replication result for a target.
title: Replication result for a target.
allOf:
- $ref: '#/components/schemas/ReplicationTargetSummaryInfo'
- type: object
properties:
startTimeUsecs:
description: Specifies the start time of replication in Unix epoch Timestamp(in microseconds) for a target.
type:
- integer
- 'null'
format: int64
x-order: 0
endTimeUsecs:
description: Specifies the end time of replication in Unix epoch Timestamp(in microseconds) for a target.
type:
- integer
- 'null'
format: int64
x-order: 1
queuedTimeUsecs:
description: Specifies the time when the replication is queued for schedule in Unix epoch Timestamp(in microseconds) for a target.
type:
- integer
- 'null'
format: int64
x-order: 2
status:
description: Status of the replication for a target. 'Running' indicates that the run is still running. 'Canceled' indicates that the run has been canceled. 'Canceling' indicates that the run is in the process of being canceled. 'Failed' indicates that the run has failed. 'Missed' indicates that the run was unable to take place at the scheduled time because the previous run was still happening. 'Succeeded' indicates that the run has finished successfully. 'SucceededWithWarning' indicates that the run finished successfully, but there were some warning messages.
type:
- string
- 'null'
enum:
- Accepted
- Running
- Canceled
- Canceling
- Failed
- Missed
- Succeeded
- SucceededWithWarning
- OnHold
x-order: 3
message:
description: Message about the replication run.
type:
- string
- 'null'
x-order: 4
percentageCompleted:
description: Specifies the progress in percentage.
type:
- integer
- 'null'
format: int32
x-order: 5
stats:
description: Replication data statistics for a target.
x-order: 6
$ref: '#/components/schemas/ReplicationDataStats'
isManuallyDeleted:
description: Specifies whether the snapshot is deleted manually.
type:
- boolean
- 'null'
x-order: 7
expiryTimeUsecs:
description: Specifies the expiry time of attempt in Unix epoch Timestamp (in microseconds) for an object.
type:
- integer
- 'null'
format: int64
x-order: 8
replicationTaskId:
description: Task UID for a replication protection run. This is for tasks that are replicated from another cluster.
type:
- string
- 'null'
x-order: 9
entriesChanged:
description: Specifies the number of metadata actions completed during the protection run.
type:
- integer
- 'null'
format: int32
x-order: 10
isInBound:
description: Specifies the direction of the replication. If the snapshot is replicated to this cluster, then isInBound is true. If the snapshot is replicated from this cluster to another cluster, then isInBound is false.
type:
- boolean
- 'null'
x-order: 11
CommonCloudTierSettings:
description: Specifies the common settings required for configuring cloud tiering.
type: object
properties:
moveAfterUnit:
description: Specifies the unit for moving the data from current tier to next tier. This unit will be a base unit for the 'moveAfter' field specified below.
type:
- string
- 'null'
enum:
- Days
- Weeks
- Months
- Years
x-order: 0
moveAfter:
description: Specifies the time period after which the backup will be moved from current tier to next tier.
type:
- integer
- 'null'
format: int64
x-order: 1
OracleTiers:
description: Specifies Oracle tiers.
type: object
required:
- tiers
properties:
tiers:
description: Specifies the tiers that are used to move the archived backup from current tier to next tier. The order of the tiers determines which tier will be used next for moving the archived backup. The first tier input should always be default tier where backup will be acrhived. Each tier specifies how much time after the backup will be moved to next tier from the current tier.
type:
- array
- 'null'
minLength: 1
items:
$ref: '#/components/schemas/OracleTier'
x-order: 0
ProtectionGroupRun:
description: Protection run.
type: object
allOf:
- $ref: '#/components/schemas/CommonProtectionGroupRunResponseParameters'
RunObjectPhysicalParams:
description: Specifies physical parameters for this run.
type: object
properties:
metadataFilePath:
description: Specifies metadata file path during run-now requests for physical file based backups for some specific source. If specified, it will override any default metadata/directive file path set at the object level for the source. Also note that if the job default does not specify a metadata/directive file path for the source, then specifying this field for that source during run-now request will be rejected.
type:
- string
- 'null'
x-order: 0
AWSTiers:
description: Specifies aws tiers.
type: object
required:
- tiers
properties:
tiers:
description: Specifies the tiers that are used to move the archived backup from current tier to next tier. The order of the tiers determines which tier will be used next for moving the archived backup. The first tier input should always be default tier where backup will be acrhived. Each tier specifies how much time after the backup will be moved to next tier from the current tier.
type:
- array
- 'null'
minLength: 1
items:
$ref: '#/components/schemas/AWSTier'
x-order: 0
AzureCloudSpinParams:
description: Specifies various resources when converting and deploying a VM to Azure.
type: object
title: Azure Parameters.
properties:
networkResourceGroupId:
description: Specifies id of the resource group for the selected virtual network.
type:
- integer
- 'null'
format: int64
x-order: 0
resourceGroupId:
description: Specifies id of the Azure resource group. Its value is globally unique within Azure.
type:
- integer
- 'null'
format: int64
x-order: 1
storageAccountId:
description: Specifies id of the storage account that will contain the storage container within which we will create the blob that will become the VHD disk for the cloned VM.
type:
- integer
- 'null'
format: int64
x-order: 2
storageContainerId:
description: Specifies id of the storage container within the above storage account.
type:
- integer
- 'null'
format: int64
x-order: 3
storageResourceGroupId:
description: Specifies id of the resource group for the selected storage account.
type:
- integer
- 'null'
format: int64
x-order: 4
availabilitySetId:
description: Specifies the availability set.
type:
- integer
- 'null'
format: int64
x-order: 5
tempVmResourceGroupId:
description: Specifies id of the temporary Azure resource group.
type:
- integer
- 'null'
format: int64
x-order: 6
tempVmStorageAccountId:
description: Specifies id of the temporary VM storage account that will contain the storage container within which we will create the blob that will become the VHD disk for the cloned VM.
type:
- integer
- 'null'
format: int64
x-order: 7
tempVmStorageContainerId:
description: Specifies id of the temporary VM storage container within the above storage account.
type:
- integer
- 'null'
format: int64
x-order: 8
tempVmSubnetId:
description: Specifies Id of the temporary VM subnet within the above virtual network.
type:
- integer
- 'null'
format: int64
x-order: 9
tempVmVirtualNetworkId:
description: Specifies Id of the temporary VM Virtual Network.
type:
- integer
- 'null'
format: int64
x-order: 10
TierLevelSettings:
description: 'Specifies the settings tier levels configured with each archival target. The tier settings need to be applied in specific order and default tier should always be passed as first entry in tiers array. The following example illustrates how to configure tiering input for AWS tiering. Same type of input structure applied to other cloud platforms also.
If user wants to achieve following tiering for backup,
User Desired Tiering-
1.Archive Full back up for 12 Months
2.Tier Levels
[1,12] [
s3 (1 to 2 months), (default tier)
s3 Intelligent tiering (3 to 6 months),
s3 One Zone (7 to 9 months)
Glacier (10 to 12 months)]
API Input
1.tiers-[
{''tierType'': ''S3'',''moveAfterUnit'':''months'',
''moveAfter'':2 - move from s3 to s3Inte after 2 months},
{''tierType'': ''S3Inte'',''moveAfterUnit'':''months'',
''moveAfter'':4 - move from S3Inte to Glacier after 4 months},
{''tierType'': ''Glacier'', ''moveAfterUnit'':''months'',
''moveAfter'': 3 - move from Glacier to S3 One Zone after 3 months },
{''tierType'': ''S3 One Zone'', ''moveAfterUnit'': nil,
''moveAfter'': nil - For the last record, ''moveAfter'' and ''moveAfterUnit''
will be ignored since there are no further tier for data movement }
}]'
type: object
required:
- cloudPlatform
properties:
cloudPlatform:
description: Specifies the cloud platform to enable tiering.
type:
- string
- 'null'
enum:
- AWS
- Azure
- Oracle
- Google
x-order: 0
awsTiering:
description: Specifies the settings for AWS Tiers.
type:
- object
- 'null'
x-order: 1
$ref: '#/components/schemas/AWSTiers'
azureTiering:
description: Specifies the settings for Azure Tiers.
type:
- object
- 'null'
x-order: 2
$ref: '#/components/schemas/AzureTiers'
googleTiering:
description: Specifies the settings for Google Tiers.
type:
- object
- 'null'
x-order: 3
$ref: '#/components/schemas/GoogleTiers'
oracleTiering:
description: Specifies the settings for Oracle Tiers.
type:
- object
- 'null'
x-order: 4
$ref: '#/components/schemas/OracleTiers'
UpdateExistingArchivalSnapshotConfig:
description: Specifies the configuration about updating an existing Archival Snapshot Run.
type: object
title: Update Archival Snapshot Config.
required:
- id
- archivalTargetType
properties:
id:
description: Specifies the id of the archival target.
type: integer
format: int64
x-order: 0
archivalTargetType:
description: Specifies the snapshot's archival target type from which recovery has been performed.
type:
- string
- 'null'
enum:
- Tape
- Cloud
- Nas
x-order: 1
enableLegalHold:
description: Specifies whether to retain the snapshot for legal purpose. If set to true, the snapshots cannot be deleted until the retention period. Note that using this option may cause the Cluster to run out of space. If set to false explicitly, the hold is removed, and the snapshots will expire as specified in the policy of the Protection Group. If this field is not specified, there is no change to the hold of the run. This field can be set only by a User having Data Security Role.
type:
- boolean
- 'null'
x-order: 2
deleteSnapshot:
description: Specifies whether to delete the snapshot. When this is set to true, all other params will be ignored.
type:
- boolean
- 'null'
x-order: 3
resync:
description: Specifies whether to retry the archival operation in case if earlier attempt failed. If not specified or set to false, archival is not retried.
type:
- boolean
- 'null'
x-order: 4
dataLock:
description: "Specifies WORM retention type for the snapshots. When a WORM retention type is specified, the snapshots of the Protection Groups using this policy will be kept until the maximum of the snapshot retention time. During that time, the snapshots cannot be deleted. \n'Compliance' implies WORM retention is set for compliance reason. \n'Administrative' implies WORM retention is set for administrative purposes."
type:
- string
- 'null'
enum:
- Compliance
- Administrative
x-order: 5
daysToKeep:
description: Specifies number of days to retain the snapshots. If positive, then this value is added to exisiting expiry time thereby increasing the retention period of the snapshot. Conversly, if this value is negative, then value is subtracted to existing expiry time thereby decreasing the retention period of the snaphot. Here, by this operation if expiry time goes below current time then snapshot is immediately deleted.
type:
- integer
- 'null'
format: int64
x-order: 6
ClusterIdentifier:
description: Specifies the information about a cluster.
type: object
title: Cluster Identifier
properties:
clusterId:
description: Specifies the id of the cluster.
type:
- integer
- 'null'
format: int64
x-order: 0
clusterIncarnationId:
description: Specifies the incarnation id of the cluster.
type:
- integer
- 'null'
format: int64
x-order: 1
clusterName:
description: Specifies the name of the cluster.
type:
- string
- 'null'
x-order: 2
readOnly: true
CommonProtectionGroupRequestParamse9ef605d-4350-4f91-93ca-9e8a25d0f659:
description: Specifies the parameters which are common between all Protection Group requests.
type: object
required:
- name
- policyId
- environment
properties:
name:
description: Specifies the name of the Protection Group.
type:
- string
- 'null'
x-order: 0
policyId:
description: Specifies the unique id of the Protection Policy associated with the Protection Group. The Policy provides retry settings Protection Schedules, Priority, SLA, etc.
type:
- string
- 'null'
x-order: 1
priority:
description: Specifies the priority of the Protection Group.
type:
- string
- 'null'
enum:
- kLow
- kMedium
- kHigh
x-order: 2
storageDomainId:
description: Specifies the Storage Domain (View Box) ID where this Protection Group writes data.
type:
- integer
- 'null'
format: int64
x-order: 3
description:
description: Specifies a description of the Protection Group.
type:
- string
- 'null'
x-order: 4
startTime:
description: Specifies the start time for this Protection Group. If no start time is specified, the start time will default to 2am. This field is only used if the policy has a daily or monthly schedule.
x-order: 5
$ref: '#/components/schemas/TimeOfDay'
endTimeUsecs:
description: Specifies the end time in micro seconds for this Protection Group. If this is not specified, the Protection Group won't be ended.
type:
- integer
- 'null'
format: int64
x-order: 6
alertPolicy:
description: Specifies the alerting policy for this Protection Group.
x-order: 7
$ref: '#/components/schemas/ProtectionGroupAlertingPolicy'
sla:
description: Specifies the SLA parameters for this Protection Group.
type:
- array
- 'null'
items:
$ref: '#/components/schemas/SlaRule'
x-order: 8
qosPolicy:
description: Specifies whether the Protection Group will be written to HDD or SSD.
type:
- string
- 'null'
enum:
- kBackupHDD
- kBackupSSD
- kTestAndDevHigh
- kBackupAll
x-order: 9
abortInBlackouts:
description: Specifies whether currently executing jobs should abort if a blackout period specified by a policy starts. Available only if the selected policy has at least one blackout period. Default value is false.
type:
- boolean
- 'null'
x-order: 10
environment:
description: Specifies the environment type of the Protection Group.
type:
- string
- 'null'
enum:
- kVMware
- kHyperV
- kAzure
- kGCP
- kKVM
- kAcropolis
- kAWS
- kPhysical
- kGPFS
- kElastifile
- kNetapp
- kGenericNas
- kIsilon
- kFlashBlade
- kPure
- kSQL
- kExchange
- kAD
- kOracle
- kView
- kRemoteAdapter
- kO365
- kKubernetes
- kCassandra
- kMongoDB
- kCouchbase
- kHdfs
- kHive
- kHBase
- kUDA
x-order: 11
isPaused:
description: Specifies if the the Protection Group is paused. New runs are not scheduled for the paused Protection Groups. Active run if any is not impacted.
type:
- boolean
- 'null'
x-order: 12
x-cohesity-discriminator-details:
propertyName: environment
x-discriminator:
mapping:
kVMware: '#/definitions/CommonProtectionGroupRequestParamse9ef605d-4350-4f91-93ca-9e8a25d0f659VmwareProtectionGroupParamsWrapper'
kAcropolis: '#/definitions/CommonProtectionGroupRequestParamse9ef605d-4350-4f91-93ca-9e8a25d0f659AcropolisProtectionGroupParamsWrapper'
kKubernetes: '#/definitions/CommonProtectionGroupRequestParamse9ef605d-4350-4f91-93ca-9e8a25d0f659KubernetesProtectionGroupParamsWrapper'
kSQL: '#/definitions/CommonProtectionGroupRequestParamse9ef605d-4350-4f91-93ca-9e8a25d0f659MSSQLProtectionGroupParamsWrapper'
kOracle: '#/definitions/CommonProtectionGroupRequestParamse9ef605d-4350-4f91-93ca-9e8a25d0f659OracleProtectionGroupParamsWrapper'
kView: '#/definitions/CommonProtectionGroupRequestParamse9ef605d-4350-4f91-93ca-9e8a25d0f659ViewProtectionGroupParamsWrapper'
kPure: '#/definitions/CommonProtectionGroupRequestParamse9ef605d-4350-4f91-93ca-9e8a25d0f659PureProtectionGroupParamsWrapper'
kNimble: '#/definitions/CommonProtectionGroupRequestParamse9ef605d-4350-4f91-93ca-9e8a25d0f659NimbleProtectionGroupParamsWrapper'
kHyperV: '#/definitions/CommonProtectionGroupRequestParamse9ef605d-4350-4f91-93ca-9e8a25d0f659HyperVProtectionGroupParamsWrapper'
kAWS: '#/definitions/CommonProtectionGroupRequestParamse9ef605d-4350-4f91-93ca-9e8a25d0f659AwsProtectionGroupParamsWrapper'
kAzure: '#/definitions/CommonProtectionGroupRequestParamse9ef605d-4350-4f91-93ca-9e8a25d0f659AzureProtectionGroupParamsWrapper'
kGCP: '#/definitions/CommonProtectionGroupRequestParamse9ef605d-4350-4f91-93ca-9e8a25d0f659GcpProtectionGroupParamsWrapper'
kKVM: '#/definitions/CommonProtectionGroupRequestParamse9ef605d-4350-4f91-93ca-9e8a25d0f659KvmProtectionGroupParamsWrapper'
kPhysical: '#/definitions/CommonProtectionGroupRequestParamse9ef605d-4350-4f91-93ca-9e8a25d0f659PhysicalProtectionGroupParamsWrapper'
kAD: '#/definitions/CommonProtectionGroupRequestParamse9ef605d-4350-4f91-93ca-9e8a25d0f659ADProtectionGroupParamsWrapper'
kO365: '#/definitions/CommonProtectionGroupRequestParamse9ef605d-4350-4f91-93ca-9e8a25d0f659Office365ProtectionGroupParamsWrapper'
kNetapp: '#/definitions/CommonProtectionGroupRequestParamse9ef605d-4350-4f91-93ca-9e8a25d0f659NetappProtectionGroupParamsWrapper'
kGenericNas: '#/definitions/CommonProtectionGroupRequestParamse9ef605d-4350-4f91-93ca-9e8a25d0f659GenericNasProtectionGroupParamsWrapper'
kIsilon: '#/definitions/CommonProtectionGroupRequestParamse9ef605d-4350-4f91-93ca-9e8a25d0f659IsilonProtectionGroupParamsWrapper'
kFlashBlade: '#/definitions/CommonProtectionGroupRequestParamse9ef605d-4350-4f91-93ca-9e8a25d0f659FlashbladeProtectionGroupParamsWrapper'
kGPFS: '#/definitions/CommonProtectionGroupRequestParamse9ef605d-4350-4f91-93ca-9e8a25d0f659GpfsProtectionGroupParamsWrapper'
kCouchbase: '#/definitions/CommonProtectionGroupRequestParamse9ef605d-4350-4f91-93ca-9e8a25d0f659NoSqlProtectionGroupParamsWrapper'
kElastifile: '#/definitions/CommonProtectionGroupRequestParamse9ef605d-4350-4f91-93ca-9e8a25d0f659ElastifileProtectionGroupParamsWrapper'
kCassandra: '#/definitions/CommonProtectionGroupRequestParamse9ef605d-4350-4f91-93ca-9e8a25d0f659CassandraProtectionGroupParamsWrapper'
kMongoDB: '#/definitions/CommonProtectionGroupRequestParamse9ef605d-4350-4f91-93ca-9e8a25d0f659MongoDBProtectionGroupParamsWrapper'
kHive: '#/definitions/CommonProtectionGroupRequestParamse9ef605d-4350-4f91-93ca-9e8a25d0f659NoSqlProtectionGroupParamsWrapper'
kHdfs: '#/definitions/CommonProtectionGroupRequestParamse9ef605d-4350-4f91-93ca-9e8a25d0f659HdfsProtectionGroupParamsWrapper'
kHBase: '#/definitions/CommonProtectionGroupRequestParamse9ef605d-4350-4f91-93ca-9e8a25d0f659NoSqlProtectionGroupParamsWrapper'
kRemoteAdapter: '#/definitions/CommonProtectionGroupRequestParamse9ef605d-4350-4f91-93ca-9e8a25d0f659RemoteAdapterProtectionGroupParamsWrapper'
kExchange: '#/definitions/CommonProtectionGroupRequestParamse9ef605d-4350-4f91-93ca-9e8a25d0f659ExchangeProtectionGroupParamsWrapper'
kUDA: '#/definitions/CommonProtectionGroupRequestParamse9ef605d-4350-4f91-93ca-9e8a25d0f659UdaProtectionGroupParamsWrapper'
propertyName: environment
UpdateProtectionGroupsStateRequest:
description: Specifies the parameters to perform an action of list of Protection Groups.
type: object
title: Update state of Protection Groups.
required:
- action
- ids
properties:
action:
description: Specifies the action to be performed on all the specfied Protection Groups. 'kActivate' specifies that Protection Group should be activated. 'kDeactivate' sepcifies that Protection Group should be deactivated. 'kPause' specifies that Protection Group should be paused. 'kResume' specifies that Protection Group should be resumed.
type:
- string
- 'null'
enum:
- kPause
- kResume
x-order: 0
ids:
description: Specifies a list of Protection Group ids for which the state should change.
type:
- array
- 'null'
minItems: 1
uniqueItems: true
items:
type: string
x-order: 1
BackupAttempt:
description: Specifies a backup attempt for an object.
type: object
title: Attempt information for an object.
properties:
startTimeUsecs:
description: Specifies the start time of attempt in Unix epoch Timestamp(in microseconds) for an object.
type:
- integer
- 'null'
format: int64
x-order: 0
endTimeUsecs:
description: Specifies the end time of attempt in Unix epoch Timestamp(in microseconds) for an object.
type:
- integer
- 'null'
format: int64
x-order: 1
admittedTimeUsecs:
description: Specifies the time at which the backup task was admitted to run in Unix epoch Timestamp(in microseconds) for an object.
type:
- integer
- 'null'
format: int64
x-order: 2
permitGrantTimeUsecs:
description: Specifies the time when gatekeeper permit is granted to the backup task. If the backup task is rescheduled due to errors, the field is updated to the time when permit is granted again.
type:
- integer
- 'null'
format: int64
x-order: 3
queueDurationUsecs:
description: Specifies the duration between the startTime and when gatekeeper permit is granted to the backup task. If the backup task is rescheduled due to errors, the field is updated considering the time when permit is granted again. Queue duration = PermitGrantTimeUsecs - StartTimeUsecs
type:
- integer
- 'null'
format: int64
x-order: 4
snapshotCreationTimeUsecs:
description: Specifies the time at which the source snapshot was taken in Unix epoch Timestamp(in microseconds) for an object.
type:
- integer
- 'null'
format: int64
x-order: 5
status:
description: Status of the attempt for an object. 'Running' indicates that the run is still running. 'Canceled' indicates that the run has been canceled. 'Canceling' indicates that the run is in the process of being canceled. 'Failed' indicates that the run has failed. 'Missed' indicates that the run was unable to take place at the scheduled time because the previous run was still happening. 'Succeeded' indicates that the run has finished successfully. 'SucceededWithWarning' indicates that the run finished successfully, but there were some warning messages.
type:
- string
- 'null'
enum:
- Accepted
- Running
- Canceled
- Canceling
- Failed
- Missed
- Succeeded
- SucceededWithWarning
- OnHold
x-order: 6
stats:
description: Statistics about backup data for an object.
x-order: 7
$ref: '#/components/schemas/BackupDataStats'
progressTaskId:
description: Progress monitor task for an object..
type:
- string
- 'null'
x-order: 8
message:
description: A message about the error if encountered while performing backup.
type:
- string
- 'null'
x-order: 9
Retention:
description: Specifies the retention of a backup.
type: object
required:
- unit
- duration
properties:
unit:
description: 'Specificies the Retention Unit of a backup measured in days, months or years.
If unit is ''Months'', then number specified in duration is multiplied to 30.
Example: If duration is 4 and unit is ''Months'' then number of retention days will be 30 * 4 = 120 days.
If unit is ''Years'', then number specified in duration is multiplied to 365.
If duration is 2 and unit is ''Months'' then number of retention days will be 365 * 2 = 730 days.'
type:
- string
- 'null'
enum:
- Days
- Weeks
- Months
- Years
x-order: 0
duration:
description: Specifies the duration for a backup retention.
Example. If duration is 7 and unit is Months, the retention of a backup is 7 * 30 = 210 days.
type:
- integer
- 'null'
format: int64
minimum: 1
x-order: 1
ObjectProgressInfo:
description: Specifies the progress of an object.
type: object
allOf:
- $ref: '#/components/schemas/ObjectIdentifier'
- $ref: '#/components/schemas/ProgressTaskInfo'
- type: object
properties:
failedAttempts:
description: Specifies progress for failed attempts of this object.
type:
- array
- 'null'
items:
$ref: '#/components/schemas/ProgressTaskInfo'
x-order: 0
SnapshotInfo:
description: Snapshot info for an object.
type: object
title: Snapshot information for an object.
properties:
snapshotId:
description: Snapshot id for a successful snapshot. This field will not be set if the Protection Group Run has no successful attempt.
type:
- string
- 'null'
x-order: 0
status:
description: Status of snapshot.
type:
- string
- 'null'
enum:
- kInProgress
- kSuccessful
- kFailed
- kWaitingForNextAttempt
- kWarning
x-order: 1
startTimeUsecs:
description: Specifies the start time of attempt in Unix epoch Timestamp(in microseconds) for an object.
type:
- integer
- 'null'
format: int64
x-order: 2
endTimeUsecs:
description: Specifies the end time of attempt in Unix epoch Timestamp(in microseconds) for an object.
type:
- integer
- 'null'
format: int64
x-order: 3
admittedTimeUsecs:
description: Specifies the time at which the backup task was admitted to run in Unix epoch Timestamp(in microseconds) for an object.
type:
- integer
- 'null'
format: int64
x-order: 4
permitGrantTimeUsecs:
description: Specifies the time when gatekeeper permit is granted to the backup task. If the backup task is rescheduled due to errors, the field is updated to the time when permit is granted again.
type:
- integer
- 'null'
format: int64
x-order: 5
queueDurationUsecs:
description: Specifies the duration between the startTime and when gatekeeper permit is granted to the backup task. If the backup task is rescheduled due to errors, the field is updated considering the time when permit is granted again. Queue duration = PermitGrantTimeUsecs - StartTimeUsecs
type:
- integer
- 'null'
format: int64
x-order: 6
snapshotCreationTimeUsecs:
description: Specifies the time at which the source snapshot was taken in Unix epoch Timestamp(in microseconds) for an object.
type:
- integer
- 'null'
format: int64
x-order: 7
stats:
description: Statistics about backup data for an object.
x-order: 8
$ref: '#/components/schemas/BackupDataStats'
progressTaskId:
description: Progress monitor task for an object.
type:
- string
- 'null'
x-order: 9
warnings:
description: Specifies a list of warning messages.
type:
- array
- 'null'
items:
type: string
x-order: 10
isManuallyDeleted:
description: Specifies whether the snapshot is deleted manually.
type:
- boolean
- 'null'
x-order: 11
expiryTimeUsecs:
description: Specifies the expiry time of attempt in Unix epoch Timestamp (in microseconds) for an object.
type:
- integer
- 'null'
format: int64
x-order: 12
totalFileCount:
description: The total number of file and directory entities visited in this backup. Only applicable to file based backups.
type:
- integer
- 'null'
format: int64
x-order: 13
backupFileCount:
description: The total number of file and directory entities that are backed up in this run. Only applicable to file based backups.
type:
- integer
- 'null'
format: int64
x-order: 14
ProgressStats:
description: Specifies the stats within progress.
type: object
properties:
fileWalkDone:
description: Specifies whether the file system walk is done. Only applicable to file based backups.
type:
- boolean
- 'null'
x-order: 0
totalFileCount:
description: Specifies the total number of file and directory entities visited in this backup. Only applicable to file based backups.
type:
- integer
- 'null'
format: int64
x-order: 1
backupFileCount:
description: Specifies the total number of file and directory entities that are backed up in this run. Only applicable to file based backups.
type:
- integer
- 'null'
format: int64
x-order: 2
ObjectTypeVCenterParams:
type: object
title: Object Type VCenter Params
properties:
isCloudEnv:
description: Specifies that registered vCenter source is a VMC (VMware Cloud) environment or not.
type:
- boolean
- 'null'
x-order: 0
BackupRunSummary:
description: Specifies summary information about local snapshot run across all objects.
type: object
title: Summary information for local snapshot run.
properties:
runType:
description: Type of Protection Group run. 'kRegular' indicates an incremental (CBT) backup. Incremental backups utilizing CBT (if supported) are captured of the target protection objects. The first run of a kRegular schedule captures all the blocks. 'kFull' indicates a full (no CBT) backup. A complete backup (all blocks) of the target protection objects are always captured and Change Block Tracking (CBT) is not utilized. 'kLog' indicates a Database Log backup. Capture the database transaction logs to allow rolling back to a specific point in time. 'kSystem' indicates system volume backup. It produces an image for bare metal recovery.
type:
- string
- 'null'
enum:
- kRegular
- kFull
- kLog
- kSystem
- kHydrateCDP
x-order: 0
isSlaViolated:
description: Indicated if SLA has been violated for this run.
type:
- boolean
- 'null'
x-order: 1
startTimeUsecs:
description: Specifies the start time of backup run in Unix epoch Timestamp(in microseconds).
type:
- integer
- 'null'
format: int64
x-order: 2
endTimeUsecs:
description: Specifies the end time of backup run in Unix epoch Timestamp(in microseconds).
type:
- integer
- 'null'
format: int64
x-order: 3
status:
description: Status of the backup run. 'Running' indicates that the run is still running. 'Canceled' indicates that the run has been canceled. 'Canceling' indicates that the run is in the process of being canceled. 'Failed' indicates that the run has failed. 'Missed' indicates that the run was unable to take place at the scheduled time because the previous run was still happening. 'Succeeded' indicates that the run has finished successfully. 'SucceededWithWarning' indicates that the run finished successfully, but there were some warning messages.
type:
- string
- 'null'
enum:
- Accepted
- Running
- Canceled
- Canceling
- Failed
- Missed
- Succeeded
- SucceededWithWarning
- OnHold
x-order: 4
messages:
description: Message about the backup run.
type:
- array
- 'null'
items:
type: string
x-order: 5
successfulObjectsCount:
description: Specifies the count of objects for which backup was successful.
type:
- integer
- 'null'
format: int64
x-order: 6
failedObjectsCount:
description: Specifies the count of objects for which backup failed.
type:
- integer
- 'null'
format: int64
x-order: 7
cancelledObjectsCount:
description: Specifies the count of objects for which backup was cancelled.
type:
- integer
- 'null'
format: int64
x-order: 8
successfulAppObjectsCount:
description: Specifies the count of app objects for which backup was successful.
type:
- integer
- 'null'
format: int32
x-order: 9
failedAppObjectsCount:
description: Specifies the count of app objects for which backup failed.
type:
- integer
- 'null'
format: int32
x-order: 10
cancelledAppObjectsCount:
description: Specifies the count of app objects for which backup was cancelled.
type:
- integer
- 'null'
format: int32
x-order: 11
localSnapshotStats:
description: Statistics about local snapshot (across all objects).
x-order: 12
$ref: '#/components/schemas/BackupDataStats'
indexingTaskId:
description: Progress monitor task for indexing.
type:
- string
- 'null'
x-order: 13
progressTaskId:
description: Progress monitor task id for local backup run.
type:
- string
- 'null'
x-order: 14
dataLock:
description: "Specifies WORM retention type for the local backeup. When a WORM retention type is specified, the snapshots of the Protection Groups using this policy will be kept until the maximum of the snapshot retention time. During that time, the snapshots cannot be deleted. \n'Compliance' implies WORM retention is set for compliance reason. \n'Administrative' implies WORM retention is set for administrative purposes."
type:
- string
- 'null'
enum:
- Compliance
- Administrative
x-order: 15
localTaskId:
description: Task ID for a local protection run.
type:
- string
- 'null'
x-order: 16
BackupDataStats:
description: Specifies statistics about local snapshot.
type: object
title: Local snapshot statistics.
properties:
logicalSizeBytes:
description: Specifies total logical size of object(s) in bytes.
type:
- integer
- 'null'
format: int64
x-order: 0
bytesWritten:
description: Specifies total size of data in bytes written after taking backup.
type:
- integer
- 'null'
format: int64
x-order: 1
bytesRead:
description: Specifies total logical bytes read for creating the snapshot.
type:
- integer
- 'null'
format: int64
x-order: 2
ArchivalTargetSummaryInfo:
description: Specifies archival target summary information.
type: object
title: Archival target.
properties:
targetId:
description: Specifies the archival target ID.
type:
- integer
- 'null'
format: int64
x-order: 0
archivalTaskId:
description: Specifies the archival task id. This is a protection group UID which only applies when archival type is 'Tape'.
type:
- string
- 'null'
x-order: 1
targetName:
description: Specifies the archival target name.
type:
- string
- 'null'
x-order: 2
targetType:
description: Specifies the archival target type.
type:
- string
- 'null'
enum:
- Tape
- Cloud
- Nas
x-order: 3
tierSettings:
description: Specifies the tier level settings configured with archival target. This will be specified if the run is a CAD run.
type:
- object
- 'null'
x-order: 4
$ref: '#/components/schemas/ArchivalTargetTierInfo'
CloudSpinDataStats:
description: Specifies statistics about Cloud Spin data.
type: object
title: Cloud Spin data statistics.
properties:
physicalBytesTransferred:
description: Specifies the physical bytes transferred.
type:
- integer
- 'null'
format: int64
x-order: 0
UpdateProtectionGroupsState:
type: object
title: Specifies the response of updation of state of multiple Protection Groups.
properties:
failedProtectionGroups:
description: Specifies a list of Protection Group ids along with details for which updation of state was failed.
type:
- array
- 'null'
items:
$ref: '#/components/schemas/FailedProtectionGroupDetails'
x-order: 0
successfulProtectionGroupIds:
description: Specifies a list of Protection Group ids for which updation of state was successful.
type:
- array
- 'null'
items:
type: string
x-order: 1
GetProtectionRunProgressBody:
description: Specifies the progress of a protection run.
type: object
properties:
localRun:
description: Progress for the local backup run.
type:
- object
- 'null'
x-order: 0
$ref: '#/components/schemas/BackupRunProgressInfo'
archivalRun:
description: Progress for the archival run.
type:
- array
- 'null'
items:
$ref: '#/components/schemas/ArchivalTargetProgressInfo'
x-order: 1
replicationRun:
description: Progress for the replication run.
type:
- array
- 'null'
items:
$ref: '#/components/schemas/ReplicationTargetProgressInfo'
x-order: 2
ProgressTaskInfo:
description: Specifies the details about a Progress Task.
type: object
title: Progress Task
properties:
status:
description: Specifies the current status of the progress task.
type:
- string
- 'null'
enum:
- Active
- Finished
- FinishedWithError
- Canceled
- FinishedGarbageCollected
x-order: 0
percentageCompleted:
description: Specifies the current completed percentage of the progress task.
type:
- number
- 'null'
format: float
x-order: 1
startTimeUsecs:
description: Specifies the start time of the progress task in Unix epoch Timestamp(in microseconds).
type:
- integer
- 'null'
format: int64
x-order: 2
endTimeUsecs:
description: Specifies the end time of the progress task in Unix epoch Timestamp(in microseconds).
type:
- integer
- 'null'
format: int64
x-order: 3
expectedRemainingTimeUsecs:
description: Specifies the expected remaining time of the progress task in Unix epoch Timestamp(in microseconds).
type:
- integer
- 'null'
format: int64
x-order: 4
events:
description: Specifies the event log created for progress Task.
type: array
items:
$ref: '#/components/schemas/ProgressTaskEvent'
x-order: 5
stats:
description: Specifies the stats within the progress.
type:
- object
- 'null'
x-order: 6
$ref: '#/components/schemas/ProgressStats'
TimeOfDay:
description: Specifies the time of day. Used for scheduling purposes.
type: object
required:
- hour
- minute
properties:
hour:
description: Specifies the hour of the day (0-23).
type:
- integer
- 'null'
format: int32
maximum: 23
minimum: 0
x-order: 0
minute:
description: Specifies the minute of the hour (0-59).
type:
- integer
- 'null'
format: int32
maximum: 59
minimum: 0
x-order: 1
timeZone:
description: Specifies the time zone of the user. If not specified, default value is assumed as America/Los_Angeles.
type:
- string
- 'null'
default: America/Los_Angeles
x-order: 2
AzureTier:
description: Specifies the settings for a Azure tier.
type: object
allOf:
- $ref: '#/components/schemas/CommonCloudTierSettings'
- type: object
required:
- tierType
properties:
tierType:
description: Specifies the Azure tier types.
type:
- string
- 'null'
enum:
- kAzureTierHot
- kAzureTierCool
- kAzureTierArchive
x-order: 0
ProtectionGroups:
description: Protection Group response.
type: object
properties:
protectionGroups:
description: Specifies the list of Protection Groups which were returned by the request.
type:
- array
- 'null'
items:
x-cohesity-discriminator-ref: CommonProtectionGroupResponseParams
$ref: '#/components/schemas/CommonProtectionGroupResponseParamsfd9f614e-2c28-46ff-a431-2430d1548801'
x-order: 0
CreateProtectionGroupRunRequest:
description: Specifies the request to create a protection run. On success, the system will accept the request and return the Protection Group id for which the run is supposed to start. The actual run may start at a later time if the system is busy. Consumers must query the Protection Group to see the run.
type: object
required:
- runType
properties:
runType:
description: Type of protection run. 'kRegular' indicates an incremental (CBT) backup. Incremental backups utilizing CBT (if supported) are captured of the target protection objects. The first run of a kRegular schedule captures all the blocks. 'kFull' indicates a full (no CBT) backup. A complete backup (all blocks) of the target protection objects are always captured and Change Block Tracking (CBT) is not utilized. 'kLog' indicates a Database Log backup. Capture the database transaction logs to allow rolling back to a specific point in time. 'kSystem' indicates system volume backup. It produces an image for bare metal recovery.
type:
- string
- 'null'
enum:
- kRegular
- kFull
- kLog
- kSystem
- kHydrateCDP
x-order: 0
objects:
description: Specifies the list of objects to be protected by this Protection Group run. These can be leaf objects or non-leaf objects in the protection hierarchy. This must be specified only if a subset of objects from the Protection Groups needs to be protected.
type: array
items:
$ref: '#/components/schemas/RunObject'
x-order: 1
targetsConfig:
description: Specifies the remote, archival or cloudSpin targets where the snapshot is backed up.
type:
- object
- 'null'
x-order: 2
$ref: '#/components/schemas/RunTargetsConfiguration'
ObjectIdentifier:
description: Specifies the basic info to identify an object.
title: Object Identifier.
properties:
id:
description: Specifies object id.
type:
- integer
- 'null'
format: int64
x-order: 0
name:
description: Specifies the name of the object.
type:
- string
- 'null'
x-order: 1
sourceId:
description: Specifies registered source id to which object belongs.
type:
- integer
- 'null'
format: int64
x-order: 2
sourceName:
description: Specifies registered source name to which object belongs.
type:
- string
- 'null'
x-order: 3
environment:
description: Specifies the environment of the object.
type:
- string
- 'null'
enum:
- kVMware
- kHyperV
- kAzure
- kKVM
- kAWS
- kAcropolis
- kGCP
- kPhysical
- kPhysicalFiles
- kIsilon
- kNetapp
- kGenericNas
- kFlashBlade
- kElastifile
- kGPFS
- kPure
- kNimble
- kSQL
- kOracle
- kExchange
- kAD
- kView
- kO365
- kHyperFlex
- kKubernetes
- kCassandra
- kMongoDB
- kCouchbase
- kHdfs
- kHive
- kHBase
- kUDA
x-order: 4
UpdateProtectionGroupRunRequestBody:
description: Specifies the params to update a list of Protection Group Runs.
type: object
title: Update Protection Group Run Request Body.
required:
- updateProtectionGroupRunParams
properties:
updateProtectionGroupRunParams:
type:
- array
- 'null'
minItems: 1
items:
$ref: '#/components/schemas/UpdateProtectionGroupRunParams'
x-order: 0
CloudSpinRunSummary:
description: Specifies summary information about cloud spin run.
type: object
title: Summary information for cloud spin run.
properties:
cloudSpinTargetResults:
description: Cloud Spin results for each Cloud Spin target.
type: array
items:
$ref: '#/components/schemas/CloudSpinTargetResult'
x-order: 0
AwsCloudSpinParams:
description: Specifies various resources when converting and deploying a VM to AWS.
type: object
title: AWS Parameters.
required:
- region
properties:
region:
description: Specifies id of the AWS region in which to deploy the VM.
type:
- integer
- 'null'
format: int64
x-order: 0
vpcId:
description: Specifies id of the Virtual Private Cloud to chose for the instance type.
type:
- integer
- 'null'
format: int64
x-order: 1
subnetId:
description: Specifies id of the subnet within above VPC.
type:
- integer
- 'null'
format: int64
x-order: 2
ProtectionRunSummary:
description: Specifies the summary of a protection run.
type: object
properties:
id:
description: Specifies the ID of the Protection Group run.
type:
- string
- 'null'
x-order: 0
protectionGroupId:
description: ProtectionGroupId to which this run belongs.
type:
- string
- 'null'
x-order: 1
protectionGroupName:
description: Name of the Protection Group to which this run belongs.
type:
- string
- 'null'
x-order: 2
environment:
description: Specifies the environment type of the Protection Group.
type:
- string
- 'null'
enum:
- kVMware
- kHyperV
- kAzure
- kGCP
- kKVM
- kAcropolis
- kAWS
- kPhysical
- kGPFS
- kElastifile
- kNetapp
- kGenericNas
- kIsilon
- kFlashBlade
- kPure
- kSQL
- kExchange
- kAD
- kOracle
- kView
- kRemoteAdapter
- kO365
- kKubernetes
- kCassandra
- kMongoDB
- kCouchbase
- kHdfs
- kHive
- kHBase
- kUDA
x-order: 3
isSlaViolated:
description: Indicated if SLA has been violated for this run.
type:
- boolean
- 'null'
x-order: 4
startTimeUsecs:
description: Specifies the start time of backup run in Unix epoch Timestamp(in microseconds).
type:
- integer
- 'null'
format: int64
x-order: 5
endTimeUsecs:
description: Specifies the end time of backup run in Unix epoch Timestamp(in microseconds).
type:
- integer
- 'null'
format: int64
x-order: 6
status:
description: Status of the backup run. 'Running' indicates that the run is still running. 'Canceled' indicates that the run has been canceled. 'Canceling' indicates that the run is in the process of being canceled. 'Failed' indicates that the run has failed. 'Missed' indicates that the run was unable to take place at the scheduled time because the previous run was still happening. 'Succeeded' indicates that the run has finished successfully. 'SucceededWithWarning' indicates that the run finished successfully, but there were some warning messages.
type:
- string
- 'null'
enum:
- Accepted
- Running
- Canceled
- Canceling
- Failed
- Missed
- Succeeded
- SucceededWithWarning
- OnHold
x-order: 7
isFullRun:
description: Specifies if the protection run is a full run.
type:
- boolean
- 'null'
x-order: 8
totalObjectsCount:
description: Specifies the total number of objects protected in this run.
type:
- integer
- 'null'
format: int64
x-order: 9
successObjectsCount:
description: Specifies the number of objects which are successfully protected in this run.
type:
- integer
- 'null'
format: int64
x-order: 10
logicalSizeBytes:
description: Specifies total logical size of object(s) in bytes.
type:
- integer
- 'null'
format: int64
x-order: 11
bytesWritten:
description: Specifies total size of data in bytes written after taking backup.
type:
- integer
- 'null'
format: int64
x-order: 12
ArchivalDataStats:
description: Specifies statistics about archival data.
type: object
title: Archival data statistics.
properties:
logicalSizeBytes:
description: Specifies the logicalSizeBytes.
type:
- integer
- 'null'
format: int64
x-order: 0
bytesRead:
description: Specifies total logical bytes read for creating the snapshot.
type:
- integer
- 'null'
format: int64
x-order: 1
logicalBytesTransferred:
description: Specifies the logical bytes transferred.
type:
- integer
- 'null'
format: int64
x-order: 2
physicalBytesTransferred:
description: Specifies the physical bytes transferred.
type:
- integer
- 'null'
format: int64
x-order: 3
avgLogicalTransferRateBps:
description: Specifies the average rate of transfer in bytes per second.
type:
- integer
- 'null'
format: int64
x-order: 4
fileWalkDone:
description: Specifies whether the file system walk is done. Only applicable to file based backups.
type:
- boolean
- 'null'
x-order: 5
totalFileCount:
description: Specifies the total number of file and directory entities visited in this backup. Only applicable to file based backups.
type:
- integer
- 'null'
format: int64
x-order: 6
backupFileCount:
description: Specifies the total number of file and directory entities that are backed up in this run. Only applicable to file based backups.
type:
- integer
- 'null'
format: int64
x-order: 7
RunReplicationConfig:
description: Specifies settings for copying Snapshots to Remote Clusters. This also specifies the retention policy that should be applied to Snapshots after they have been copied to the specified target.
type: object
title: Replication Target Configuration
required:
- id
properties:
id:
description: Specifies id of Remote Cluster to copy the Snapshots to.
type:
- integer
- 'null'
format: int64
x-order: 0
retention:
description: Specifies the Retention period of snapshot in days, months or years to retain copied Snapshots on the target.
type:
- object
- 'null'
x-order: 1
$ref: '#/components/schemas/Retention'
ProtectionGroupAlertingPolicy:
description: Specifies a policy for alerting users of the status of a Protection Group.
type: object
required:
- backupRunStatus
properties:
backupRunStatus:
description: Specifies the run status for which the user would like to receive alerts.
type: array
minItems: 1
uniqueItems: true
items:
type: string
enum:
- kSuccess
- kFailure
- kSlaViolation
x-order: 0
alertTargets:
description: Specifies a list of targets to receive the alerts.
type: array
items:
$ref: '#/components/schemas/AlertTarget'
x-order: 1
UpdateProtectionGroupRunResponseBody:
description: Specifies the response of update Protection Group Runs request.
type: object
title: Update Protection Group Run Response Body.
properties:
successfulRunIds:
description: Specifies a list of ids of Protection Group Runs that are successfully updated.
type:
- array
- 'null'
items:
type: string
x-order: 0
failedRuns:
description: Specifies a list of ids of Protection Group Runs that failed to update along with error details.
type:
- array
- 'null'
items:
$ref: '#/components/schemas/FailedRunDetails'
x-order: 1
ReplicationDataStats:
description: Specifies statistics about replication data.
type: object
title: Replication data statistics.
properties:
logicalSizeBytes:
description: Specifies the total logical size in bytes.
type:
- integer
- 'null'
format: int64
x-order: 0
logicalBytesTransferred:
description: Specifies the total logical bytes transferred.
type:
- integer
- 'null'
format: int64
x-order: 1
physicalBytesTransferred:
description: Specifies the total physical bytes transferred.
type:
- integer
- 'null'
format: int64
x-order: 2
ProtectionRunsSummary:
description: Specifies a list of summaries of protection runs.
type: object
properties:
protectionRunsSummary:
description: Specifies a list of summaries of protection runs.
type:
- array
- 'null'
items:
$ref: '#/components/schemas/ProtectionRunSummary'
x-order: 0
CloudSpinTarget:
description: Specifies the details about Cloud Spin target where backup snapshots may be converted and stored.
type: object
properties:
id:
description: Specifies the unique id of the cloud spin entity.
type:
- integer
- 'null'
format: int64
x-order: 0
awsParams:
description: Specifies various resources when converting and deploying a VM to AWS.
type:
- object
- 'null'
title: Contains information needed to identify various resources when deploying VMs to Cloud.
x-order: 1
$ref: '#/components/schemas/AwsCloudSpinParams'
azureParams:
description: Specifies various resources when converting and deploying a VM to Azure.
type:
- object
- 'null'
x-order: 2
$ref: '#/components/schemas/AzureCloudSpinParams'
name:
description: Specifies the name of the already added cloud spin target.
type:
- string
- 'null'
x-order: 3
readOnly: true
Tenant:
description: Specifies a tenant object.
type: object
title: Tenant
properties:
id:
description: Specifies the id of the tenant.
type:
- string
- 'null'
x-order: 0
name:
description: Specifies the name of the tenant.
type:
- string
- 'null'
x-order: 1
UpdateLocalSnapshotConfig:
description: Specifies the params to perform actions on local snapshot taken by a Protection Group Run.
type: object
title: Local Snapshot Config.
properties:
enableLegalHold:
description: Specifies whether to retain the snapshot for legal purpose. If set to true, the snapshots cannot be deleted until the retention period. Note that using this option may cause the Cluster to run out of space. If set to false explicitly, the hold is removed, and the snapshots will expire as specified in the policy of the Protection Group. If this field is not specified, there is no change to the hold of the run. This field can be set only by a User having Data Security Role.
type:
- boolean
- 'null'
x-order: 0
deleteSnapshot:
description: Specifies whether to delete the snapshot. When this is set to true, all other params will be ignored.
type:
- boolean
- 'null'
x-order: 1
dataLock:
description: "Specifies WORM retention type for the snapshots. When a WORM retention type is specified, the snapshots of the Protection Groups using this policy will be kept until the maximum of the snapshot retention time. During that time, the snapshots cannot be deleted. \n'Compliance' implies WORM retention is set for compliance reason. \n'Administrative' implies WORM retention is set for administrative purposes."
type:
- string
- 'null'
enum:
- Compliance
- Administrative
x-order: 2
daysToKeep:
description: Specifies number of days to retain the snapshots. If positive, then this value is added to exisiting expiry time thereby increasing the retention period of the snapshot. Conversly, if this value is negative, then value is subtracted to existing expiry time thereby decreasing the retention period of the snaphot. Here, by this operation if expiry time goes below current time then snapshot is immediately deleted.
type:
- integer
- 'null'
format: int64
x-order: 3
ArchivalRunSummary:
description: Specifies summary information about archival run.
type: object
title: Summary information for archival run.
properties:
archivalTargetResults:
description: Archival results for each archival target.
type: array
items:
$ref: '#/components/schemas/ArchivalTargetResult'
x-order: 0
ProgressTaskEvent:
description: Specifies the details about the various events which are created during the execution of Progress Task.
type: object
properties:
message:
description: Specifies the log message describing the current event.
type:
- string
- 'null'
x-order: 0
occuredAtUsecs:
description: Specifies the time of the event occurance in Unix epoch Timestamp(in microseconds).
type:
- integer
- 'null'
format: int64
x-order: 1
ReplicationTargetSummaryInfo:
description: Specifies replication target summary information.
title: Replication target.
allOf:
- $ref: '#/components/schemas/ClusterIdentifier'
- type: object
properties:
awsTargetConfig:
x-order: 0
$ref: '#/components/schemas/AWSTargetConfig'
azureTargetConfig:
x-order: 1
$ref: '#/components/schemas/AzureTargetConfig'
OracleTier:
description: Specifies the settings for a Oracle tier.
type: object
allOf:
- $ref: '#/components/schemas/CommonCloudTierSettings'
- type: object
required:
- tierType
properties:
tierType:
description: Specifies the Oracle tier types.
type:
- string
- 'null'
enum:
- kOracleTierStandard
- kOracleTierArchive
x-order: 0
Error:
description: Specifies the error object with error code and a message.
type: object
title: Error.
properties:
errorCode:
description: Specifies the error code.
type:
- string
- 'null'
x-order: 0
message:
description: Specifies the error message.
type:
- string
- 'null'
x-order: 1
UpdateArchivalSnapshotConfig:
description: Specifies the params to perform actions on archival snapshots taken by a Protection Group Run.
type: object
title: Archival Snapshot Config.
properties:
newSnapshotConfig:
description: Specifies the new configuration about adding Archival Snapshot to existing Protection Group Run.
type:
- array
- 'null'
items:
$ref: '#/components/schemas/RunArchivalConfig'
x-order: 0
updateExistingSnapshotConfig:
description: Specifies the configuration about updating an existing Archival Snapshot Run.
type:
- array
- 'null'
items:
$ref: '#/components/schemas/UpdateExistingArchivalSnapshotConfig'
x-order: 1
CreateProtectionGroupRunResponseBody:
description: Specifies the response for create a protection run. On success, the system will accept the request and return the Protection Group id for which the run is supposed to start. The actual run may start at a later time if the system is busy. Consumers must query the Protection Group to see the run.
type: object
title: Create protection run response.
properties:
protectionGroupId:
description: Specifies id of the Protection Group which must be polled for seeing the new run.
type:
- string
- 'null'
x-order: 0
ProtectionGroupRuns:
description: Protection runs.
type: object
properties:
runs:
description: Specifies the list of Protection Group runs.
type:
- array
- 'null'
items:
$ref: '#/components/schemas/ProtectionGroupRun'
x-order: 0
ObjectRunResult:
description: Snapshot, replication, archival results for an object.
type: object
title: Snapshot, replication, archival results for an object.
properties:
object:
description: Summary information about the object.
x-order: 0
$ref: '#/components/schemas/ObjectSummary'
localSnapshotInfo:
description: Information about local snapshot run for this object.
x-order: 1
$ref: '#/components/schemas/BackupRun'
originalBackupInfo:
description: Information about snapshot run on the original cluster. This only applies to replication run.
x-order: 2
$ref: '#/components/schemas/BackupRun'
replicationInfo:
description: Information about replication run for this object.
x-order: 3
$ref: '#/components/schemas/ReplicationRun'
archivalInfo:
description: Information about archival run for this object.
x-order: 4
$ref: '#/components/schemas/ArchivalRun'
cloudSpinInfo:
description: Information about Cloud Spin run for this object.
x-order: 5
$ref: '#/components/schemas/CloudSpinRun'
onLegalHold:
description: Specifies if object's snapshot is on legal hold.
type:
- boolean
- 'null'
x-order: 6
RunObject:
description: Specifies the object details to create a protection run.
type: object
required:
- id
properties:
id:
description: Specifies the id of object.
type:
- integer
- 'null'
format: int64
x-order: 0
appIds:
description: Specifies a list of ids of applications.
type:
- array
- 'null'
items:
type: integer
format: int64
x-order: 1
physicalParams:
description: Specifies physical parameters for this run.
type:
- object
- 'null'
x-order: 2
$ref: '#/components/schemas/RunObjectPhysicalParams'
FailedRunDetails:
description: Specifies a list of ids of Protection Group Runs that failed to update along with error details
type: object
properties:
runId:
description: Specifies the id of the failed run.
type:
- string
- 'null'
x-order: 0
errorMessage:
description: Specifies the error mesage for failed run.
type:
- string
- 'null'
x-order: 1
CancelProtectionGroupRunRequest:
description: Specifies the request to cancel a protection run.
type: object
title: Cancel protection run request.
properties:
localTaskId:
description: Specifies the task id of the local run.
type:
- string
- 'null'
pattern: ^\d+:\d+:\d+$
x-order: 0
replicationTaskId:
description: Specifies the task id of the replication run.
type:
- array
- 'null'
items:
type: string
pattern: ^\d+:\d+:\d+$
x-order: 1
archivalTaskId:
description: Specifies the task id of the archival run.
type:
- array
- 'null'
items:
type: string
pattern: ^\d+:\d+:\d+$
x-order: 2
cloudSpinTaskId:
description: Specifies the task id of the cloudSpin run.
type:
- array
- 'null'
items:
type: string
pattern: ^\d+:\d+:\d+$
x-order: 3
CommonProtectionGroupRunResponseParameters:
description: Specifies the parameters which are common between Protection Group runs of all Protection Groups.
type: object
title: Common Protection Group run response parameters.
properties:
id:
description: Specifies the ID of the Protection Group run.
type:
- string
- 'null'
x-order: 0
protectionGroupInstanceId:
description: Protection Group instance Id. This field will be removed later.
type:
- integer
- 'null'
format: int64
x-order: 1
protectionGroupId:
description: ProtectionGroupId to which this run belongs.
type:
- string
- 'null'
x-order: 2
isReplicationRun:
description: Specifies if this protection run is a replication run.
type:
- boolean
- 'null'
x-order: 3
originClusterIdentifier:
description: Specifies the information of the primary cluster if this run is a replication run.
x-order: 4
$ref: '#/components/schemas/ClusterIdentifier'
originProtectionGroupId:
description: ProtectionGroupId to which this run belongs on the primary cluster if this run is a replication run.
type:
- string
- 'null'
x-order: 5
protectionGroupName:
description: Name of the Protection Group to which this run belongs.
type:
- string
- 'null'
x-order: 6
isLocalSnapshotsDeleted:
description: Specifies if snapshots for this run has been deleted.
type:
- boolean
- 'null'
x-order: 7
objects:
description: Snapahot, replication, archival results for each object.
type: array
items:
$ref: '#/components/schemas/ObjectRunResult'
x-order: 8
localBackupInfo:
description: Summary information about local snapshot run across all objects.
x-order: 9
$ref: '#/components/schemas/BackupRunSummary'
originalBackupInfo:
description: Summary information about snapshot run on the original cluster. This only applies to replication run.
x-order: 10
$ref: '#/components/schemas/BackupRunSummary'
replicationInfo:
description: Summary information about replication run across all objects.
x-order: 11
$ref: '#/components/schemas/ReplicationRunSummary'
archivalInfo:
description: Summary information about archival run.
x-order: 12
$ref: '#/components/schemas/ArchivalRunSummary'
cloudSpinInfo:
description: Summary information about cloud spin run.
x-order: 13
$ref: '#/components/schemas/CloudSpinRunSummary'
onLegalHold:
description: Specifies if the Protection Run is on legal hold.
type:
- boolean
- 'null'
x-order: 14
permissions:
description: Specifies the list of tenants that have permissions for this protection group run.
type:
- array
- 'null'
items:
$ref: '#/components/schemas/Tenant'
x-order: 15
isCloudArchivalDirect:
description: Specifies whether the run is a CAD run if cloud archive direct feature is enabled. If this field is true, the primary backup copy will only be available at the given archived location.
type:
- boolean
- 'null'
x-order: 16
hasLocalSnapshot:
description: Specifies whether the run has a local snapshot. For cloud retrieved runs there may not be local snapshots.
type:
- boolean
- 'null'
x-order: 17
environment:
description: Specifies the environment of the Protection Group.
type:
- string
- 'null'
x-cohesity-enum: protection_group_run_type
x-order: 18
UpdateProtectionGroupRunParams:
description: Specifies the params to update a Protection Group Run.
type: object
title: Update Protection Group Run Request Params.
required:
- runId
properties:
runId:
description: Specifies a unique Protection Group Run id.
type:
- string
- 'null'
pattern: ^\d+:\d+$
x-order: 0
localSnapshotConfig:
description: Specifies the params to perform actions on local snapshot taken by this Protection Group Run.
type:
- object
- 'null'
x-order: 1
$ref: '#/components/schemas/UpdateLocalSnapshotConfig'
replicationSnapshotConfig:
description: Specifies the params to perform actions on replication snapshots taken by this Protection Group Run. A user can configure new replication targets here.
type:
- object
- 'null'
x-order: 2
$ref: '#/components/schemas/UpdateReplicationSnapshotConfig'
archivalSnapshotConfig:
description: Specifies the params to perform actions on archival snapshots taken by this Protection Group Run. A user can configure new archival targets here.
type:
- object
- 'null'
x-order: 3
$ref: '#/components/schemas/UpdateArchivalSnapshotConfig'
CommonProtectionGroupResponseParamsfd9f614e-2c28-46ff-a431-2430d1548801:
description: Specifies the parameters which are common between all Protection Group responses.
type: object
properties:
id:
description: Specifies the ID of the Protection Group.
type:
- string
- 'null'
x-order: 0
name:
description: Specifies the name of the Protection Group.
type:
- string
- 'null'
x-order: 1
policyId:
description: Specifies the unique id of the Protection Policy associated with the Protection Group. The Policy provides retry settings Protection Schedules, Priority, SLA, etc.
type:
- string
- 'null'
x-order: 2
priority:
description: Specifies the priority of the Protection Group.
type:
- string
- 'null'
enum:
- kLow
- kMedium
- kHigh
x-order: 3
storageDomainId:
description: Specifies the Storage Domain (View Box) ID where this Protection Group writes data.
type:
- integer
- 'null'
format: int64
x-order: 4
description:
description: Specifies a description of the Protection Group.
type:
- string
- 'null'
x-order: 5
startTime:
description: Specifies the start time for this Protection Group. If no start time is specified, the start time will default to 2am. This field is only used if the policy has a daily or monthly schedule.
x-order: 6
$ref: '#/components/schemas/TimeOfDay'
endTimeUsecs:
description: Specifies the end time in micro seconds for this Protection Group. If this is not specified, the Protection Group won't be ended.
type:
- integer
- 'null'
format: int64
x-order: 7
alertPolicy:
description: Specifies the alerting policy for this Protection Group.
x-order: 8
$ref: '#/components/schemas/ProtectionGroupAlertingPolicy'
sla:
description: Specifies the SLA parameters for this Protection Group.
type:
- array
- 'null'
items:
$ref: '#/components/schemas/SlaRule'
x-order: 9
qosPolicy:
description: Specifies whether the Protection Group will be written to HDD or SSD.
type:
- string
- 'null'
enum:
- kBackupHDD
- kBackupSSD
- kTestAndDevHigh
- kBackupAll
x-order: 10
abortInBlackouts:
description: Specifies whether currently executing jobs should abort if a blackout period specified by a policy starts. Available only if the selected policy has at least one blackout period. Default value is false.
type:
- boolean
- 'null'
x-order: 11
isActive:
description: Specifies if the Protection Group is active or not.
type:
- boolean
- 'null'
x-order: 12
isDeleted:
description: Specifies if the Protection Group has been deleted.
type:
- boolean
- 'null'
x-order: 13
isPaused:
description: Specifies if the the Protection Group is paused. New runs are not scheduled for the paused Protection Groups. Active run if any is not impacted.
type:
- boolean
- 'null'
x-order: 14
environment:
description: Specifies the environment of the Protection Group.
type:
- string
- 'null'
enum:
- kVMware
- kHyperV
- kAzure
- kGCP
- kKVM
- kAcropolis
- kAWS
- kPhysical
- kGPFS
- kElastifile
- kNetapp
- kGenericNas
- kIsilon
- kFlashBlade
- kPure
- kSQL
- kExchange
- kAD
- kOracle
- kView
- kRemoteAdapter
- kO365
- kKubernetes
- kCassandra
- kMongoDB
- kCouchbase
- kHdfs
- kHive
- kHBase
- kUDA
x-order: 15
lastRun:
description: Specifies information about the last run for this Protection Group.
x-order: 16
$ref: '#/components/schemas/ProtectionGroupRun'
permissions:
description: Specifies the list of tenants that have permissions for this protection group.
type:
- array
- 'null'
items:
$ref: '#/components/schemas/Tenant'
x-order: 17
isProtectOnce:
description: Specifies if the the Protection Group is using a protect once type of policy. This field is helpful to identify run happen for this group.
type:
- boolean
- 'null'
x-order: 18
x-cohesity-discriminator-details:
propertyName: environment
x-discriminator:
mapping:
kVMware: '#/definitions/CommonProtectionGroupResponseParamsfd9f614e-2c28-46ff-a431-2430d1548801VmwareProtectionGroupParamsWrapper'
kAcropolis: '#/definitions/CommonProtectionGroupResponseParamsfd9f614e-2c28-46ff-a431-2430d1548801AcropolisProtectionGroupParamsWrapper'
kKubernetes: '#/definitions/CommonProtectionGroupResponseParamsfd9f614e-2c28-46ff-a431-2430d1548801KubernetesProtectionGroupParamsWrapper'
kSQL: '#/definitions/CommonProtectionGroupResponseParamsfd9f614e-2c28-46ff-a431-2430d1548801MSSQLProtectionGroupParamsWrapper'
kOracle: '#/definitions/CommonProtectionGroupResponseParamsfd9f614e-2c28-46ff-a431-2430d1548801OracleProtectionGroupParamsWrapper'
kView: '#/definitions/CommonProtectionGroupResponseParamsfd9f614e-2c28-46ff-a431-2430d1548801ViewProtectionGroupParamsWrapper'
kPure: '#/definitions/CommonProtectionGroupResponseParamsfd9f614e-2c28-46ff-a431-2430d1548801PureProtectionGroupParamsWrapper'
kNimble: '#/definitions/CommonProtectionGroupResponseParamsfd9f614e-2c28-46ff-a431-2430d1548801NimbleProtectionGroupParamsWrapper'
kHyperV: '#/definitions/CommonProtectionGroupResponseParamsfd9f614e-2c28-46ff-a431-2430d1548801HyperVProtectionGroupParamsWrapper'
kAWS: '#/definitions/CommonProtectionGroupResponseParamsfd9f614e-2c28-46ff-a431-2430d1548801AwsProtectionGroupParamsWrapper'
kAzure: '#/definitions/CommonProtectionGroupResponseParamsfd9f614e-2c28-46ff-a431-2430d1548801AzureProtectionGroupParamsWrapper'
kGCP: '#/definitions/CommonProtectionGroupResponseParamsfd9f614e-2c28-46ff-a431-2430d1548801GcpProtectionGroupParamsWrapper'
kKVM: '#/definitions/CommonProtectionGroupResponseParamsfd9f614e-2c28-46ff-a431-2430d1548801KvmProtectionGroupParamsWrapper'
kPhysical: '#/definitions/CommonProtectionGroupResponseParamsfd9f614e-2c28-46ff-a431-2430d1548801PhysicalProtectionGroupParamsWrapper'
kAD: '#/definitions/CommonProtectionGroupResponseParamsfd9f614e-2c28-46ff-a431-2430d1548801ADProtectionGroupParamsWrapper'
kO365: '#/definitions/CommonProtectionGroupResponseParamsfd9f614e-2c28-46ff-a431-2430d1548801Office365ProtectionGroupParamsWrapper'
kNetapp: '#/definitions/CommonProtectionGroupResponseParamsfd9f614e-2c28-46ff-a431-2430d1548801NetappProtectionGroupParamsWrapper'
kGenericNas: '#/definitions/CommonProtectionGroupResponseParamsfd9f614e-2c28-46ff-a431-2430d1548801GenericNasProtectionGroupParamsWrapper'
kIsilon: '#/definitions/CommonProtectionGroupResponseParamsfd9f614e-2c28-46ff-a431-2430d1548801IsilonProtectionGroupParamsWrapper'
kFlashBlade: '#/definitions/CommonProtectionGroupResponseParamsfd9f614e-2c28-46ff-a431-2430d1548801FlashbladeProtectionGroupParamsWrapper'
kGPFS: '#/definitions/CommonProtectionGroupResponseParamsfd9f614e-2c28-46ff-a431-2430d1548801GpfsProtectionGroupParamsWrapper'
kElastifile: '#/definitions/CommonProtectionGroupResponseParamsfd9f614e-2c28-46ff-a431-2430d1548801ElastifileProtectionGroupParamsWrapper'
kRemoteAdapter: '#/definitions/CommonProtectionGroupResponseParamsfd9f614e-2c28-46ff-a431-2430d1548801RemoteAdapterProtectionGroupParamsWrapper'
kExchange: '#/definitions/CommonProtectionGroupResponseParamsfd9f614e-2c28-46ff-a431-2430d1548801ExchangeProtectionGroupParamsWrapper'
kCassandra: '#/definitions/CommonProtectionGroupResponseParamsfd9f614e-2c28-46ff-a431-2430d1548801CassandraProtectionGroupParamsWrapper'
kCouchbase: '#/definitions/CommonProtectionGroupResponseParamsfd9f614e-2c28-46ff-a431-2430d1548801NoSqlProtectionGroupParamsWrapper'
kMongoDB: '#/definitions/CommonProtectionGroupResponseParamsfd9f614e-2c28-46ff-a431-2430d1548801MongoDBProtectionGroupParamsWrapper'
kHive: '#/definitions/CommonProtectionGroupResponseParamsfd9f614e-2c28-46ff-a431-2430d1548801NoSqlProtectionGroupParamsWrapper'
kHdfs: '#/definitions/CommonProtectionGroupResponseParamsfd9f614e-2c28-46ff-a431-2430d1548801HdfsProtectionGroupParamsWrapper'
kHBase: '#/definitions/CommonProtectionGroupResponseParamsfd9f614e-2c28-46ff-a431-2430d1548801NoSqlProtectionGroupParamsWrapper'
kUDA: '#/definitions/CommonProtectionGroupResponseParamsfd9f614e-2c28-46ff-a431-2430d1548801UdaProtectionGroupParamsWrapper'
propertyName: environment
ReplicationTargetProgressInfo:
description: Specifies the progress of a replication run target.
type: object
allOf:
- $ref: '#/components/schemas/ReplicationTargetSummaryInfo'
- $ref: '#/components/schemas/ProgressTaskInfo'
- type: object
properties:
objects:
description: Specifies progress for objects.
type:
- array
- 'null'
items:
$ref: '#/components/schemas/ObjectProgressInfo'
x-order: 0
ArchivalRun:
description: Specifies information about archival run for an object.
type: object
title: Archival run information for an object.
properties:
archivalTargetResults:
description: Archival result for an archival target.
type: array
items:
$ref: '#/components/schemas/ArchivalTargetResult'
x-order: 0
GoogleTiers:
description: Specifies Google tiers.
type: object
required:
- tiers
properties:
tiers:
description: Specifies the tiers that are used to move the archived backup from current tier to next tier. The order of the tiers determines which tier will be used next for moving the archived backup. The first tier input should always be default tier where backup will be acrhived. Each tier specifies how much time after the backup will be moved to next tier from the current tier.
type:
- array
- 'null'
minLength: 1
items:
$ref: '#/components/schemas/GoogleTier'
x-order: 0
BackupRunProgressInfo:
description: Specifies the progress of a local backup run.
type: object
allOf:
- $ref: '#/components/schemas/ProgressTaskInfo'
- type: object
properties:
objects:
description: Specifies progress for objects.
type:
- array
- 'null'
items:
$ref: '#/components/schemas/ObjectProgressInfo'
x-order: 0
AWSTargetConfig:
description: Specifies the configuration for adding AWS as repilcation target
type: object
title: AWS Target Configuration
required:
- sourceId
- region
properties:
sourceId:
description: Specifies the source id of the AWS protection source registered on Cohesity cluster.
type:
- integer
- 'null'
format: int64
x-order: 0
name:
description: Specifies the name of the AWS Replication target.
type:
- string
- 'null'
x-order: 1
readOnly: true
region:
description: Specifies id of the AWS region in which to replicate the Snapshot to. Applicable if replication target is AWS target.
type:
- integer
- 'null'
format: int64
x-order: 2
regionName:
description: Specifies name of the AWS region in which to replicate the Snapshot to. Applicable if replication target is AWS target.
type:
- string
- 'null'
x-order: 3
readOnly: true
ReplicationRun:
description: Specifies information about replication run for an object.
type: object
title: Replication run information for an object.
properties:
replicationTargetResults:
description: Replication result for a target.
type: array
items:
$ref: '#/components/schemas/ReplicationTargetResult'
x-order: 0
ArchivalTargetResult:
description: Archival result for an archival target.
title: Archival result for a target.
allOf:
- $ref: '#/components/schemas/ArchivalTargetSummaryInfo'
- type: object
properties:
runType:
description: Type of Protection Group run. 'kRegular' indicates an incremental (CBT) backup. Incremental backups utilizing CBT (if supported) are captured of the target protection objects. The first run of a kRegular schedule captures all the blocks. 'kFull' indicates a full (no CBT) backup. A complete backup (all blocks) of the target protection objects are always captured and Change Block Tracking (CBT) is not utilized. 'kLog' indicates a Database Log backup. Capture the database transaction logs to allow rolling back to a specific point in time. 'kSystem' indicates system volume backup. It produces an image for bare metal recovery.
type:
- string
- 'null'
enum:
- kRegular
- kFull
- kLog
- kSystem
- kHydrateCDP
x-order: 0
isSlaViolated:
description: Indicated if SLA has been violated for this run.
type:
- boolean
- 'null'
x-order: 1
snapshotId:
description: Snapshot id for a successful snapshot. This field will not be set if the archival Run fails to take the snapshot.
type:
- string
- 'null'
x-order: 2
startTimeUsecs:
description: Specifies the start time of replication run in Unix epoch Timestamp(in microseconds) for an archival target.
type:
- integer
- 'null'
format: int64
x-order: 3
endTimeUsecs:
description: Specifies the end time of replication run in Unix epoch Timestamp(in microseconds) for an archival target.
type:
- integer
- 'null'
format: int64
x-order: 4
queuedTimeUsecs:
description: Specifies the time when the archival is queued for schedule in Unix epoch Timestamp(in microseconds) for a target.
type:
- integer
- 'null'
format: int64
x-order: 5
isIncremental:
description: Whether this is an incremental archive. If set to true, this is an incremental archive, otherwise this is a full archive.
type:
- boolean
- 'null'
x-order: 6
isForeverIncremental:
description: Whether this is forever incremental or not
type:
- boolean
- 'null'
x-order: 7
status:
description: Status of the replication run for an archival target. 'Running' indicates that the run is still running. 'Canceled' indicates that the run has been canceled. 'Canceling' indicates that the run is in the process of being canceled. 'Failed' indicates that the run has failed. 'Missed' indicates that the run was unable to take place at the scheduled time because the previous run was still happening. 'Succeeded' indicates that the run has finished successfully. 'SucceededWithWarning' indicates that the run finished successfully, but there were some warning messages.
type:
- string
- 'null'
enum:
- Accepted
- Running
- Canceled
- Canceling
- Failed
- Missed
- Succeeded
- SucceededWithWarning
- OnHold
x-order: 8
message:
description: Message about the archival run.
type:
- string
- 'null'
x-order: 9
progressTaskId:
description: Progress monitor task id for archival.
type:
- string
- 'null'
x-order: 10
indexingTaskId:
description: Progress monitor task for indexing.
type:
- string
- 'null'
x-order: 11
successfulObjectsCount:
description: Specifies the count of objects for which backup was successful.
type:
- integer
- 'null'
format: int64
x-order: 12
failedObjectsCount:
description: Specifies the count of objects for which backup failed.
type:
- integer
- 'null'
format: int64
x-order: 13
cancelledObjectsCount:
description: Specifies the count of objects for which backup was cancelled.
type:
- integer
- 'null'
format: int64
x-order: 14
successfulAppObjectsCount:
description: Specifies the count of app objects for which backup was successful.
type:
- integer
- 'null'
format: int32
x-order: 15
failedAppObjectsCount:
description: Specifies the count of app objects for which backup failed.
type:
- integer
- 'null'
format: int32
x-order: 16
cancelledAppObjectsCount:
description: Specifies the count of app objects for which backup was cancelled.
type:
- integer
- 'null'
format: int32
x-order: 17
stats:
description: Archival data statistics for a target.
x-order: 18
$ref: '#/components/schemas/ArchivalDataStats'
isManuallyDeleted:
description: Specifies whether the snapshot is deleted manually.
type:
- boolean
- 'null'
x-order: 19
expiryTimeUsecs:
description: Specifies the expiry time of attempt in Unix epoch Timestamp (in microseconds).
type:
- integer
- 'null'
format: int64
x-order: 20
UpdateExistingReplicationSnapshotConfig:
description: Specifies the configuration about updating an existing Replication Snapshot Run.
type: object
title: Update Replication Snapshot Config.
required:
- id
properties:
id:
description: Specifies the cluster id of the replication cluster.
type: integer
format: int64
x-order: 0
enableLegalHold:
description: Specifies whether to retain the snapshot for legal purpose. If set to true, the snapshots cannot be deleted until the retention period. Note that using this option may cause the Cluster to run out of space. If set to false explicitly, the hold is removed, and the snapshots will expire as specified in the policy of the Protection Group. If this field is not specified, there is no change to the hold of the run. This field can be set only by a User having Data Security Role.
type:
- boolean
- 'null'
x-order: 1
deleteSnapshot:
description: Specifies whether to delete the snapshot. When this is set to true, all other params will be ignored.
type:
- boolean
- 'null'
x-order: 2
resync:
description: Specifies whether to retry the replication operation in case if earlier attempt failed. If not specified or set to false, replication is not retried.
type:
- boolean
- 'null'
x-order: 3
dataLock:
description: "Specifies WORM retention type for the snapshots. When a WORM retention type is specified, the snapshots of the Protection Groups using this policy will be kept until the maximum of the snapshot retention time. During that time, the snapshots cannot be deleted. \n'Compliance' implies WORM retention is set for compliance reason. \n'Administrative' implies WORM retention is set for administrative purposes."
type:
- string
- 'null'
enum:
- Compliance
- Administrative
x-order: 4
daysToKeep:
description: Specifies number of days to retain the snapshots. If positive, then this value is added to exisiting expiry time thereby increasing the retention period of the snapshot. Conversly, if this value is negative, then value is subtracted to existing expiry time thereby decreasing the retention period of the snaphot. Here, by this operation if expiry time goes below current time then snapshot is immediately deleted.
type:
- integer
- 'null'
format: int64
x-order: 5
RunArchivalConfig:
description: Specifies settings for copying Snapshots External Targets (such as AWS or Tape). This also specifies the retention policy that should be applied to Snapshots after they have been copied to the specified target.
type: object
title: Archival Target Configuration
required:
- id
- archivalTargetType
properties:
id:
description: Specifies the Archival target to copy the Snapshots to.
type:
- integer
- 'null'
format: int64
x-order: 0
archivalTargetType:
description: Specifies the snapshot's archival target type from which recovery has been performed.
type:
- string
- 'null'
enum:
- Tape
- Cloud
- Nas
x-order: 1
retention:
description: Specifies the Retention period of snapshot in days, months or years to retain copied Snapshots on the target.
type:
- object
- 'null'
x-order: 2
$ref: '#/components/schemas/Retention'
AzureTiers:
description: Specifies Azure tiers.
type: object
required:
- tiers
properties:
tiers:
description: Specifies the tiers that are used to move the archived backup from current tier to next tier. The order of the tiers determines which tier will be used next for moving the archived backup. The first tier input should always be default tier where backup will be acrhived. Each tier specifies how much time after the backup will be moved to next tier from the current tier.
type:
- array
- 'null'
minLength: 1
items:
$ref: '#/components/schemas/AzureTier'
x-order: 0
ArchivalTargetProgressInfo:
description: Specifies the progress of an archival run target.
type: object
allOf:
- $ref: '#/components/schemas/ArchivalTargetSummaryInfo'
- $ref: '#/components/schemas/ProgressTaskInfo'
- type: object
properties:
objects:
description: Specifies progress for objects.
type:
- array
- 'null'
items:
$ref: '#/components/schemas/ObjectProgressInfo'
x-order: 0
AWSTier:
description: Specifies the settings for a aws tier.
type: object
allOf:
- $ref: '#/components/schemas/CommonCloudTierSettings'
- type: object
required:
- tierType
properties:
tierType:
description: Specifies the AWS tier types.
type:
- string
- 'null'
enum:
- kAmazonS3Standard
- kAmazonS3StandardIA
- kAmazonS3OneZoneIA
- kAmazonS3IntelligentTiering
- kAmazonS3Glacier
- kAmazonS3GlacierDeepArchive
x-order: 0
GoogleTier:
description: Specifies the settings for a Google tier.
type: object
allOf:
- $ref: '#/components/schemas/CommonCloudTierSettings'
- type: object
required:
- tierType
properties:
tierType:
description: Specifies the Google tier types.
type:
- string
- 'null'
enum:
- kGoogleStandard
- kGoogleRegional
- kGoogleMultiRegional
- kGoogleNearline
- kGoogleColdline
x-order: 0
CloudSpinTargetResult:
description: Cloud Spin result for a target.
title: Cloud Spin result for a target.
allOf:
- $ref: '#/components/schemas/CloudSpinTarget'
- type: object
properties:
startTimeUsecs:
description: Specifies the start time of Cloud Spin in Unix epoch Timestamp(in microseconds) for a target.
type:
- integer
- 'null'
format: int64
x-order: 0
endTimeUsecs:
description: Specifies the end time of Cloud Spin in Unix epoch Timestamp(in microseconds) for a target.
type:
- integer
- 'null'
format: int64
x-order: 1
status:
description: Status of the Cloud Spin for a target. 'Running' indicates that the run is still running. 'Canceled' indicates that the run has been canceled. 'Canceling' indicates that the run is in the process of being canceled. 'Failed' indicates that the run has failed. 'Missed' indicates that the run was unable to take place at the scheduled time because the previous run was still happening. 'Succeeded' indicates that the run has finished successfully. 'SucceededWithWarning' indicates that the run finished successfully, but there were some warning messages.
type:
- string
- 'null'
enum:
- Accepted
- Running
- Canceled
- Canceling
- Failed
- Missed
- Succeeded
- SucceededWithWarning
- OnHold
x-order: 2
message:
description: Message about the Cloud Spin run.
type:
- string
- 'null'
x-order: 3
stats:
description: Cloud Spin data statistics for a target.
x-order: 4
$ref: '#/components/schemas/CloudSpinDataStats'
isManuallyDeleted:
description: Specifies whether the snapshot is deleted manually.
type:
- boolean
- 'null'
x-order: 5
expiryTimeUsecs:
description: Specifies the expiry time of attempt in Unix epoch Timestamp (in microseconds) for an object.
type:
- integer
- 'null'
format: int64
x-order: 6
cloudspinTaskId:
description: Task ID for a CloudSpin protection run.
type:
- string
- 'null'
x-order: 7
progressTaskId:
description: Progress monitor task id for Cloud Spin run.
type:
- string
- 'null'
x-order: 8
ReplicationRunSummary:
description: Specifies summary information about replication run.
type: object
title: Summary information for replication run.
properties:
replicationTargetResults:
description: Replication results for each replication target.
type: array
items:
$ref: '#/components/schemas/ReplicationTargetResult'
x-order: 0
CloudSpinRun:
description: Specifies information about Cloud Spin run for an object.
type: object
title: Cloud Spin run information for an object.
properties:
cloudSpinTargetResults:
description: Cloud Spin result for a target.
type: array
items:
$ref: '#/components/schemas/CloudSpinTargetResult'
x-order: 0
BackupRun:
description: Specifies information about backup run for an object.
type: object
title: Snapshot run information for an object.
properties:
snapshotInfo:
description: Snapshot information for an object.
x-order: 0
$ref: '#/components/schemas/SnapshotInfo'
failedAttempts:
description: Failed backup attempts for an object.
type: array
items:
$ref: '#/components/schemas/BackupAttempt'
x-order: 1
responses:
GetProtectionGroupRunsResponse:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/ProtectionGroupRuns'
UpdateProtectionGroupsStateResponse:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateProtectionGroupsState'
CreateOrUpdateProtectionGroupResponse:
description: Success
content:
application/json:
schema:
x-cohesity-discriminator-ref: CommonProtectionGroupResponseParams
$ref: '#/components/schemas/CommonProtectionGroupResponseParamsfd9f614e-2c28-46ff-a431-2430d1548801'
ErrorResponse:
description: Error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
NoContentResponse:
description: No Content
UpdateProtectionGroupRunResponse:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateProtectionGroupRunResponseBody'
GetProtectionGroupResponse:
description: Success
content:
application/json:
schema:
x-cohesity-discriminator-ref: CommonProtectionGroupResponseParams
$ref: '#/components/schemas/CommonProtectionGroupResponseParamsfd9f614e-2c28-46ff-a431-2430d1548801'
GetProtectionRunProgress:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/GetProtectionRunProgressBody'
GetProtectionRunsResponse:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/ProtectionRunsSummary'
GetProtectionGroupRunResponse:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/ProtectionGroupRun'
CreateProtectionGroupRunResponse:
description: Accepted
content:
application/json:
schema:
$ref: '#/components/schemas/CreateProtectionGroupRunResponseBody'
GetProtectionGroupsResponse:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/ProtectionGroups'
securitySchemes:
APIKeyHeader:
in: header
name: apiKey
type: apiKey