openapi: 3.2.0 info: version: 1.0.0 description: Public APIs for Site Continuity v2 service. title: Site Continuity v2 Service DR Plan API termsOfService: https://cohesity.com contact: email: support@cohesity.com servers: - url: https://helios.cohesity.com/v2/mcm/site-continuity/v2 security: - ApiKeyAuth: [] tags: - name: DRPlan paths: /dr-plans: post: description: 'Privileges: DRAAS_MODIFY Creates a new DR plan consisting of application, primary site, DR site and resource profile configuration.' tags: - DRPlan summary: Creates a DR plan operationId: SCCreateDRPlan responses: 201: $ref: '#/components/responses/SCCreateDRPlanResponse' default: $ref: '#/components/responses/SCErrorResponse' requestBody: content: application/json: schema: $ref: '#/components/schemas/SCDRPlanCreateOrUpdateParams' description: Specifies the parameters to create a DR plan. required: true get: description: 'Privileges: DRAAS_VIEW Returns a list of DR Plans based on the defined filter criteria.' tags: - DRPlan summary: Returns a list of DR plans operationId: SCGetDrPlans parameters: - name: drPlanIds description: Specifies IDs to filter the DR plans response. in: query schema: type: array items: type: integer format: int64 - name: drPlanNames description: Specifies DR plan names to filter the DR plans response. This is case insensitive and supports substring search. in: query schema: type: array items: type: string - name: appIds description: Specifies application IDs to filter the DR plans response. in: query schema: type: array items: type: integer format: int64 - name: states description: Specifies list of states to filter the DR plans response. in: query schema: type: array items: type: string enum: - Created - Active - Deleted - Failed - Completed - name: primarySiteIds description: Specifies primary site IDs to filter the DR plans response. in: query schema: type: array items: type: integer format: int64 - name: drSiteIds description: Specifies DR site IDs to filter the DR plans response. in: query schema: type: array items: type: integer format: int64 - name: statuses description: Specifies list of status to filter the DR plans response. in: query schema: type: array items: type: string enum: - ActivationReady - ActivationInProgress - ActivationNotReady - ConfigurationError - FailoverNotReady - FailoverReady - FailoverInProgress - FailoverFailed - FailoverCompleted - PrepareForFailbackInProgress - FailbackNotReady - FailbackReady - FailbackInProgress - FailbackFailed - FailbackCompleted - TeardownInProgress - CancellationInProgress - TestFailoverInProgress - TestFailbackInProgress - PrepareForFailoverInProgress - SystemError - name: slaStatus description: Specifies the SLA status to filter the DR Plans response. in: query schema: type: string enum: - Satisfied - NotSatisfied - name: includeSummary description: Specifies the filter to include the summary of the DR plans. This must be passed and set to true in order to get the summary. in: query schema: type: boolean responses: 200: $ref: '#/components/responses/SCGetDRPlansResponse' default: $ref: '#/components/responses/SCErrorResponse' /dr-plans/{id}: get: description: 'Privileges: DRAAS_VIEW Gets DR plan information using its ID.' tags: - DRPlan summary: Returns a DR plan by ID operationId: SCGetDRPlanById parameters: - name: id description: Specifies the ID of the DR plan. in: path required: true schema: type: integer format: int64 responses: 200: $ref: '#/components/responses/SCGetDRPlanByIdResponse' default: $ref: '#/components/responses/SCErrorResponse' delete: description: 'Privileges: DRAAS_MODIFY Deletes a DR plan using its ID.' tags: - DRPlan summary: Deletes a DR plan by ID operationId: SCDeleteDRPlanById parameters: - name: id description: Specifies the ID of the DR plan. in: path required: true schema: type: integer format: int64 responses: 204: description: No content default: $ref: '#/components/responses/SCErrorResponse' put: description: 'Privileges: DRAAS_MODIFY Updates DR plan''s information using its ID.' tags: - DRPlan summary: Updates a DR Plan by ID operationId: SCUpdateDRPlanById parameters: - name: id description: Specifies the ID of the DR plan. in: path required: true schema: type: integer format: int64 responses: 200: $ref: '#/components/responses/SCUpdateDRPlanResponse' default: $ref: '#/components/responses/SCErrorResponse' requestBody: content: application/json: schema: $ref: '#/components/schemas/SCDRPlanCreateOrUpdateParams' description: Specifies the parameters to update a DR plan. required: true /dr-plans/{id}/actions: post: description: 'Privileges: DRAAS_MODIFY Performs actions such as activate, failover, failback, etc on a given DR plan.' tags: - DRPlan summary: Performs an action on a DR plan operationId: SCPerformActionOnDRPlan parameters: - name: id description: Specifies the ID of the DR plan. in: path required: true schema: type: integer format: int64 responses: 202: $ref: '#/components/responses/SCPerformActionDrPlanResponse' default: $ref: '#/components/responses/SCErrorResponse' requestBody: content: application/json: schema: $ref: '#/components/schemas/SCPerformActionOnDrPlanParams' description: Specifies the parameters to perform action on DR plan. required: true /actions: get: description: 'Privileges: DRAAS_VIEW Returns a list of actions on DR plans based on the defined filter criteria.' tags: - DRPlan summary: Returns a list of actions operationId: SCGetActions parameters: - name: actionIds description: Specifies IDs to filter the actions response. in: query schema: type: array items: type: integer format: int64 - name: statuses description: Specifies list of statuses to filter the actions response. in: query schema: type: array items: type: string enum: - Running - Completed - Failed - Canceled - Canceling - name: types description: Specifies list of types to filter the actions response. in: query schema: type: array items: type: string enum: - Activate - PrepareForFailover - PrepareForFailback - TestFailover - TestFailback - Failover - Failback - Teardown - name: drPlanIds description: Filter the actions response by DR plan IDs. in: query schema: type: array items: type: integer format: int64 - name: fromTimeUsecs description: Specifies the starting timestamp in Unix time epoch in microseconds to get actions response. This filter will return the actions having start time greater than equal to this value. in: query schema: type: integer format: int64 - name: toTimeUsecs description: Specifies the ending timestamp in Unix time epoch in microseconds to get actions response. This filter will return the actions having finish time less than equal to toTimeUsecs. in: query schema: type: integer format: int64 - name: includeStepDetails description: Specifies the filter to include step level details for attempts associated with every DR action. This must be passed as true to include the step details in attempts. in: query schema: type: boolean responses: 200: $ref: '#/components/responses/SCGetActionsResponse' default: $ref: '#/components/responses/SCErrorResponse' /actions/{id}: get: description: 'Privileges: DRAAS_VIEW Gets action information performed on DR plan using its action ID.' tags: - DRPlan summary: Returns an action by ID operationId: SCGetActionById parameters: - name: id description: Specifies the ID of the action. in: path required: true schema: type: integer format: int64 - name: includeStepDetails description: Specifies the filter to include step level details for attempts associated with DR action. This must be passed as true to include the step details in attempts. in: query schema: type: boolean responses: 200: $ref: '#/components/responses/SCGetActionByIdResponse' default: $ref: '#/components/responses/SCErrorResponse' /actions/{id}/operations: post: description: 'Privileges: DRAAS_MODIFY Perform operations like cancel, resume and force finish on a DR plan action. The provided operation will be validated and error will be returned if operation cannot be performed at that time. Resume and force finish creates a new attempt on the DR plan action. Cancel cancels the latest attempt on the DR plan action. An attempt details must be accessed using the GET actions API by providing the the same action ID as provided here.' tags: - DRPlan summary: Performs operations on a DR plan action operationId: SCPerformOperationOnDrPlanAction parameters: - name: id description: Specifies the ID of the action on which the operation needs to be performed. in: path required: true schema: type: integer format: int64 responses: 204: $ref: '#/components/responses/NoContentResponse' default: $ref: '#/components/responses/SCErrorResponse' requestBody: content: application/json: schema: $ref: '#/components/schemas/SCOperationOnActionParams' description: Specifies the parameters to perform the operation on a DR plan action. required: true components: schemas: SCNetworkPortGroupComputeConfig: description: Specifies the compute settings for the network port group object located under a specific vCenter object hierarchy on Cohesity. type: object required: - id properties: id: description: Specifies the ID of the network port group object. type: - integer - 'null' format: int64 moRef: description: Specifies the Managed Object Reference (MoRef) of the network port group object. This is a unique identifier inside vCenter. type: - string - 'null' readOnly: true name: description: Specifies the name of the network port group object. type: - string - 'null' readOnly: true SCFailbackActionParams: description: Specifies the action parameters to trigger a failback on a DR plan. type: object allOf: - $ref: '#/components/schemas/SCDRPlanActionCommonParams' - type: object required: - environment properties: environment: description: Specifies the environment of the source for which the failback action needs to be performed. type: string enum: - vmware vmwareParams: description: Specifies the VMware specific parameters to perform the failback action. type: object $ref: '#/components/schemas/SCFailbackActionVMwareParams' SCUserActionConfig: description: Specifies the user configuration which was used during the submission of the action. type: object properties: sourceConfig: description: Specifies the source configuration which was used during submission of the action. This configuration will contain the details such as source type, source identifier, resource profile etc. In case of vCenter source, resource profile array will always contain a single entry of the resource profile selected used during the submission of the DR action. This field will only be populated for actions such as Failover, Failback, TestFailover, and TestFailback. type: object $ref: '#/components/schemas/SCSourceConfig' objectSnapshots: description: Specifies the list of object and snapshot details that was provided at the time of action submission. type: array items: $ref: '#/components/schemas/SCObjectSnapshotUserConfig' SCOriginalStaticIpConfig: description: Specifies the original static IP configuration. allOf: - $ref: '#/components/schemas/SCCommonDNSSettings' SCObjectDetails: description: Specifies the object level details. type: object properties: objectId: description: Specifies the ID of the object. type: - integer - 'null' format: int64 objectName: description: Specifies the name of the object. type: - string - 'null' objectType: description: Specifies the type of the object. type: - string - 'null' enum: - virtualMachine virtualMachineInfo: description: Specifies the details specific to the virtualMachine object type. type: object $ref: '#/components/schemas/SCVMDetails' SCPrimarySiteConfig: description: Specifies the configuration for primary site. type: object required: - siteId - source properties: siteId: description: Specifies the unique identifier of the site. type: - integer - 'null' format: int64 source: description: Specifies the registered source configuration on the primary site. type: object allOf: - $ref: '#/components/schemas/SCSourceConfig' SCFailbackActionVMwareParams: description: Specifies the action parameters to trigger failback for VMware environment. type: object required: - resourceProfileName properties: resourceProfileName: description: Specifies the unique resource profile name which is added as a part of the DR plan. type: - string - 'null' shutdownVms: description: Specifies if the data objects such as VMs at DR site should be shut down after failback is completed. type: - boolean - 'null' protectVms: description: Specifies if the data objects such as VMs at primary site should be re-protected after failback is completed. type: - boolean - 'null' SCHealthCheck: description: Specifies the information about the health check. type: object allOf: - $ref: '#/components/schemas/SCInitiateHealthCheckParams' properties: status: description: Specifies the current status of the health check. type: - string - 'null' enum: - Scheduled - Running - Successful - Failed startTimeUsecs: description: Specifies the start time of the health check in microseconds. type: - integer - 'null' format: int64 endTimeUsecs: description: Specifies the end time of the health check in microseconds. type: - integer - 'null' format: int64 message: description: Specifies the message associated with the health check. type: - string - 'null' SCObjectSnapshotOverride: description: Specifies the list of object Ids along with the snapshot timestamps typically used for actual or test failover/failback. required: - objectId properties: objectId: description: Specifies the unique ID of the object in DR plan. This identifier uniquely locates the data object such as VM in primary site. type: - integer - 'null' format: int64 snapshotId: description: Specifies the snapshot identifier associated with the object id mentioned above. If objectID is provided but 'snapshotId' is not, then the field will be defaulted to a latest snapshot Id internally. type: - string - 'null' pointInTimeUsecs: description: Specifies the epoch timestamp in microseconds for recovering to a point-in-time in the past. This option is only available if Continuous Data Protection (CDP) is enabled for data objects. type: - integer - 'null' format: int64 SCTestFailbackActionVMwareParams: description: Specifies the action parameters to trigger a test failback on a DR plan. type: object required: - resourceProfileName properties: resourceProfileName: description: Specifies the unique resource profile name which is added as a part of the DR plan. type: - string - 'null' performStorageVmotion: description: Specifies whether to perform the storage vMotion operation with the test failback action. Default value is false if not specified. type: - boolean - 'null' SCDRPlansResponse: description: Specifies the list of DR plans. type: object properties: drPlans: description: Specifies the list of DR plans. type: array items: $ref: '#/components/schemas/SCDRPlan' summary: description: Specifies the summary of the DR plans. type: object $ref: '#/components/schemas/SCDRPlansSummary' SCDRSourceVCenterParams: description: Specifies the vCenter parameters to configure a source. type: object required: - objectId properties: objectId: description: Specifies the object ID of the vCenter. This object identifier uniquely locates the vCenter object within Cohesity. type: - integer - 'null' format: int64 resourceProfiles: description: Specifies the resource profile settings. type: array items: $ref: '#/components/schemas/SCvCenterResourceProfileParams' SCAttemptStepObject: description: Specifies the object level details involved in the individual step of an attempt. type: object properties: objectId: description: Specifies the ID of the object. type: - integer - 'null' format: int64 objectName: description: Specifies the name of the object. type: - string - 'null' SCSnapshotDetails: description: Specifies the specific details of the snapshot. type: object properties: snapshotId: description: Specifies the unique identifier for the snapshot. type: - string - 'null' snapshotTimeUsecs: description: Specifies the Unix time epoch in microseconds when the snapshot was taken. type: - integer - 'null' format: int64 SCNetworkMappingIpConfig: description: Specifies the network mapping configuration. allOf: - type: object properties: sourceNetwork: description: Specifies the source network. type: - string - 'null' targetNetwork: description: Specifies the target network. type: - string - 'null' gateway: description: Specifies the gateway network address. type: - string - 'null' - $ref: '#/components/schemas/SCCommonDNSSettings' SCManualStaticIpConfig: description: Specifies the manual IP configuration. type: object properties: manualObjectLevelConfig: description: Specifies object level network mapping. type: array items: $ref: '#/components/schemas/SCManualObjectLevelIpConfig' SCvCenterCustomResourceSet: description: Specifies the parameters required to configure a custom resource set. type: object allOf: - $ref: '#/components/schemas/SCvCenterDefaultResourceSet' - type: object properties: objectIds: description: Specifies the list of VM object IDs to which the given resource settings will apply. These objects will override the default settings provided in default resource set. type: array items: type: integer format: int64 minItems: 1 SCActionAttempt: description: Specifies the attempt details for an action. A new attempt is created under following two conditions.
1. When an top level action (Failover, Failback, Test Failover, Test Failback) is performed on a DR plan, a new attempt will be created.
2. In case if action created from point 1 results into the failed state, then clients can execute operations such as resume or force finish to recover from errors. Each of these operations will create a new attempt and clients must use the latest attempt to track the progress of a DR action.
type: object properties: attemptId: description: Specifies the unique identifier for the attempt. This identifier is unique within the scope of the DR plan action. type: - integer - 'null' format: int64 operationType: description: Specifies the current operation which is being performed on a DR plan action. This operation type will be populated only if the attempt is initiated by executing an operation on a DR action. type: - string - 'null' enum: - Resume - ForceFinish status: description: Specifies the current status of an attempt. type: - string - 'null' enum: - Running - Completed - Failed - Canceled - Canceling message: description: Specifies the message associated with the status. In case of errors/warnings, this field will be populated with appropriate message. type: - string - 'null' startTimeUsecs: description: Specifies the start time of an attempt in microseconds. type: - integer - 'null' format: int64 endTimeUsecs: description: Specifies the end time of an attempt in microseconds. type: - integer - 'null' format: int64 cancellationTimeUsecs: description: Specifies the time when cancel operation was initiated on the ongoing attempt. This field will be populated only if the operation type is 'Cancel'. type: - integer - 'null' format: int64 steps: description: Specifies the list of steps associated with the attempt. Each step indicates the incremental progression of the attempt. type: array items: $ref: '#/components/schemas/SCAttemptStep' SCAction: description: Specifies the details of an ongoing or past action performed on a DR plan. type: object properties: id: description: Specifies the identifier for an action. type: - integer - 'null' format: int64 type: description: Specifies the current action which is being performed on a DR plan.
'Activate' activates the DR plan which periodically checks the protection and replication status to determine if the DR plan Recovery Point Objective (RPO) is met.
'TestFailover' tests if a failover from primary site to DR site works.
'Failover' fails over the resources from primary site to DR site.
'PrepareForFailback' prepares the DR plan for a Failback operation by validating the required configuration for failback to the primary site.
'TestFailback' tests if a failback from DR site to primary site works.
'Failback' fails back the resources from DR site to primary site.
'PrepareForFailover' prepares the DR plan for subsequent Failover operation (after a successful Failover and Failback) by validating the required configuration for Failover to the DR site.
'Teardown' can be used to tear down configuration after a failed/partially successful Failover or Failback operation. This option can also be used to tear down configuration after a successful/failed/partially successful Test Failover or Test Failback operation.
type: - string - 'null' enum: - Activate - PrepareForFailover - PrepareForFailback - TestFailover - TestFailback - Failover - Failback - Teardown drPlanId: description: Specifies the ID of the DR plan with which the current action is associated. type: - integer - 'null' format: int64 status: description: Specifies the current status of the DR plan action. Following status field will always match with latest attempt's status. type: - string - 'null' enum: - Running - Completed - Failed - Canceled - Canceling message: description: Specifies the message associated with the above status. In case of errors/warnings, this field will be populated with appropriate message. type: - string - 'null' progressPercentage: description: Specifies the progress in percentage for a DR plan action. type: integer format: int32 minimum: 0 maximum: 100 startTimeUsecs: description: Specifies the start time of the action in microseconds. type: - integer - 'null' format: int64 endTimeUsecs: description: Specifies the end time of the action in microseconds. type: - integer - 'null' format: int64 latestAttemptId: description: Specifies the identifier to locate the latest attempt for a DR plan action. type: - integer - 'null' format: int64 attempts: description: Specifies the list of attempts associated with an action. The list of attempts will be returned in the order of start timestamps where latest timestamp will appear first and so on. type: array items: $ref: '#/components/schemas/SCActionAttempt' parentId: description: Specifies the identifier of the parent action on which the current action is performed. e.g Teardown action can be performed on failover/test failover/failback/test failback action. This field will not be populated for activities such as Activation, Failover, Test failover, Failback, Test failback etc where no parent action exists. type: - integer - 'null' format: int64 supportedOperations: description: Specifies the operations that can be performed to handle the failures that resulted from this action. type: array items: type: - string - 'null' enum: - ForceFinish - Resume - Cancel - Teardown userConfig: description: Specifies the user provided configuration associated with the current activity. This field will only be populated for types of activities such as Failover, TestFailover, Failback, TestFailback etc. where explicit user configuration is provided when performing an action on DR plan. type: object $ref: '#/components/schemas/SCUserActionConfig' SCInitiateHealthCheckParams: description: Specifies the parameters required to initiate a health check. type: object required: - checkType properties: checkType: description: Specifies the type of the resource on which the health check should be initiated. type: - string - 'null' enum: - DRPlan drPlanHealthCheckParams: description: Specifies the parameters required for initiating health check on a DR plan. type: - object - 'null' $ref: '#/components/schemas/SCDRPlanHealthCheckParams' SCObjectSnapshotUserConfig: description: Specifies the object and snapshot details from the user provided configuration at the time of action submission. type: object properties: objectDetails: description: Specifies the specific details of the object. type: object $ref: '#/components/schemas/SCObjectDetails' snapshotDetails: description: Specifies the specific details of the snapshot for the object. type: object $ref: '#/components/schemas/SCSnapshotDetails' pointInTimeUsecs: description: Specifies the epoch timestamp in microseconds of a point-in-time selected by the user. type: - integer - 'null' format: int64 SCVMDetails: description: Specifies the details specific to the virtualMachine object type. type: object properties: isCdpProtected: description: Specifies true if the VM is protected using Continuous Data Protection (CDP). type: - boolean - 'null' SCDRPlanHealthCheckParams: description: Specifies the parameters associated with DR plan health check. type: object required: - drPlanId properties: drPlanId: description: Specifies the unique identifier for the DR plan. type: - integer - 'null' format: int64 SCDRPlan: description: Specifies the information about a DR plan. type: object properties: id: description: Specifies the unique identifier for the DR plan. type: - integer - 'null' format: int64 state: description: Specifies the current state of the DR plan. type: - string - 'null' enum: - Created - Active - Failed - Completed - Deleted status: description: Specifies the current status of the DR plan. type: - string - 'null' enum: - ActivationReady - ActivationInProgress - ActivationNotReady - ConfigurationError - FailoverNotReady - FailoverReady - FailoverInProgress - FailoverFailed - FailoverCompleted - PrepareForFailbackInProgress - FailbackNotReady - FailbackReady - FailbackInProgress - FailbackFailed - FailbackCompleted - TeardownInProgress - CancellationInProgress - TestFailoverInProgress - TestFailbackInProgress - PrepareForFailoverInProgress - SystemError errorDetails: description: Specifies the error details in case DR plan is in a failed state. type: - object - 'null' $ref: '#/components/schemas/DrPlanErrorDetails' slaStatus: description: Specifies the SLA status for a DR plan. type: - string - 'null' enum: - Satisfied - NotSatisfied lastActionId: description: Specifies the last action id of a DR plan. type: - integer - 'null' format: int64 isAppRunningOnDRSite: description: Specifies whether the app is currently running on the DR site. Value true implies that the app is running on DR site and false implies that the app is running on primary site. If no app is associated with the DR plan, this field will not be populated. type: - boolean - 'null' markedForDeletion: description: Specifies whether the DR plan is undergoing deletion in background. Once the DR plan is fully deleted, the response will not contain this DR plan. type: - boolean - 'null' lastTestActionId: description: Specifies the last test action ID on the DR plan. This will only be populated if at least one test action such as test failover or test failback has run on the DR plan. type: - integer - 'null' format: int64 lastHealthCheckDetails: description: Specifies the details of the last health check executed on a DR plan. type: - object - 'null' $ref: '#/components/schemas/SCHealthCheck' allOf: - $ref: '#/components/schemas/SCDRPlanCreateOrUpdateParams' SCvCenterDefaultResourceSet: description: Specifies the parameters required to configure default resource set. type: object required: - computeConfig properties: name: description: Specifies name of the resource set. If name is not provided then an internally generated name will be assigned to this resource set. type: - string - 'null' computeConfig: description: Specifies the compute settings for the current resource set. type: object $ref: '#/components/schemas/SCvCenterComputeConfig' SCManualObjectLevelIpConfig: description: Specifies the object level manual IP configuration. allOf: - type: object required: - objectId - ipAddress - subnet - gateway properties: objectId: description: Specifies the object ID for VM for which static IP need to be assigned. type: - integer - 'null' format: int64 ipAddress: description: Specifies the static IP address. type: - string - 'null' subnet: description: Specifies the subnet for IP address. type: - string - 'null' gateway: description: Specifies the gateway network address. type: - string - 'null' - $ref: '#/components/schemas/SCCommonDNSSettings' SCDRPlansSummary: description: Specifies the summary of the DR Plans. type: object properties: totalPlans: description: Specifies the total number DR Plans. type: - integer - 'null' format: int32 activePlans: description: Specifies the total number of active DR plans. This includes the plans that are either currently active, completed or failed due to an error. type: - integer - 'null' format: int32 runningPlans: description: Specifies the total number of DR Plans in running status. This includes the plans that are in failover running, failback running, teardown running or cancelling status. type: - integer - 'null' format: int32 completedPlans: description: Specifies the total number of completed DR plans. This includes the plans that are currently either failover completed or failback completed. type: - integer - 'null' format: int32 readyPlans: description: Specifies the total number of DR plans that are ready for any of the actions such as activation, failover, or failback. type: - integer - 'null' format: int32 notReadyPlans: description: Specifies the total number of DR plans that are not ready for any of the actions such as activation, failover, or failback. type: - integer - 'null' format: int32 failedPlans: description: Specifies the total number of plans that either failed a failover or failback operation, or have some configuration error. type: - integer - 'null' format: int32 slaSatisfiedPlans: description: Specifies the total number of active DR plans where SLA is satisfied. type: - integer - 'null' format: int32 slaNotSatisfiedPlans: description: Specifies the total number of active DR plans where SLA is not satisfied. type: - integer - 'null' format: int32 DrPlanErrorDetails: description: Specifies the error details in case DR plan is in a failed state. type: object properties: message: description: Specifies the overall error in the DR plan. type: - string - 'null' detailedErrors: description: Specifies more detailed errors and can be specific to entities, protection groups, policies etc. type: - array - 'null' items: type: string SCAttemptStep: description: Specifies the step level details such as message, status, progress percentage for the respective DR action. type: object properties: message: description: Specifies the detailed message for the step. type: - string - 'null' status: description: Specifies the status of the step.
'Created' state specifies that attempt step has been created.
'InProgress' status specifies that attempt step is in progress. This is a transient status and will not emit a timestamp. Instead, the status will change to 'Success' or 'Failure' when step reaches a terminating status such as success or failure.
'Success' status specifies that attempt step has successfully finished.
'Failure' status specifies that attempt step has failed.
type: - string - 'null' enum: - Started - InProgress - Success - Failure stepTimeUsecs: description: Specifies the emit time of the step in microseconds. This timestamp will not be emitted for inProgress steps. type: - integer - 'null' format: int64 progressPercentage: description: Specifies the progress in percentage for the step. type: integer format: int32 minimum: 0 maximum: 100 objects: description: Specifies the list of objects associated with this step. A single step may be working on one or more objects as per the functioning of the step. type: array items: $ref: '#/components/schemas/SCAttemptStepObject' subSteps: description: Specifies the list of sub-steps associated with the current step. At occasions, larger steps may be divided into smaller sub-steps and details of these steps will be returned here. type: array items: $ref: '#/components/schemas/SCAttemptStep' SCDataCenterComputeConfig: description: Specifies the compute settings for the data center located under a specific vCenter object hierarchy on Cohesity. type: object required: - id properties: id: description: Specifies the ID of the data center object. type: - integer - 'null' format: int64 moRef: description: Specifies the Managed Object Reference (MoRef) of the data center object. This is a unique identifier inside vCenter. type: - string - 'null' readOnly: true name: description: Specifies the name of the data center object. type: - string - 'null' readOnly: true SCTeardownActionParams: description: Specifies the action parameters to teardown a DR plan action. type: object required: - actionId properties: actionId: description: Specifies the action identifier on which the teardown operation needs to be performed. For specified action ID, if teardown action is not applicable then validation error will be returned. type: - integer - 'null' format: int64 SCDRPlanActionCommonParams: description: Specifies the action parameters to trigger failover or failback on a DR plan. type: object properties: objectSnapshotOverrides: description: Specifies the list of object Ids along with the snapshot ID which will be used during failover. If object ID is not specified then latest snapshot will be used internally for failover action for that object. type: - array - 'null' items: $ref: '#/components/schemas/SCObjectSnapshotOverride' SCDatastoreComputeConfig: description: Specifies the compute settings for the data store object located under a specific vCenter object hierarchy on Cohesity. type: object required: - id properties: id: description: Specifies the ID of the data store object. type: - integer - 'null' format: int64 moRef: description: Specifies the Managed Object Reference (MoRef) of the data store object. This is a unique identifier inside vCenter. type: - string - 'null' readOnly: true name: description: Specifies the name of the data store object. type: - string - 'null' readOnly: true SCRPOConfig: description: Specifies the Recovery Point Objective (RPO) configuration for a DR Plan. required: - unit properties: unit: description: Specifies the unit for RPO settings. type: - string - 'null' enum: - Minutes - Hours - Days frequency: description: Specifies the frequency at which RPO need to be executed along with the unit. type: - integer - 'null' format: int32 minimum: 1 SCClusterComputeConfig: description: Specifies the compute settings for the cluster object located under a specific vCenter object hierarchy on Cohesity. type: object required: - id properties: id: description: Specifies the ID of the cluster object. type: - integer - 'null' format: int64 moRef: description: Specifies the Managed Object Reference (MoRef) of the cluster object. This is a unique identifier inside vCenter. type: - string - 'null' readOnly: true name: description: Specifies the name of the cluster object. type: - string - 'null' readOnly: true SCError: description: Specifies the error object with error code and a message. type: object properties: errorCode: description: Specifies the error code. $ref: '#/components/schemas/SCErrorCode' errorMessage: description: Specifies the error message. type: - string - 'null' SCPerformActionOnDrPlanParams: description: Specifies the parameters required to perform a specific action on a DR plan. type: object required: - action properties: action: description: Specifies the current action which is being performed on a DR plan.
'Activate' activates the DR plan which periodically checks the protection and replication status to determine if the DR plan Recovery Point Objective (RPO) is met.
'TestFailover' tests if a failover from primary site to DR site works.
'Failover' fails over the resources from primary site to DR site.
'PrepareForFailback' prepares the DR plan for a Failback operation by validating the required configuration for failback to the primary site.
'TestFailback' tests if a failback from DR site to primary site works.
'Failback' fails back the resources from DR site to primary site.
'PrepareForFailover' prepares the DR plan for subsequent Failover operation (after a successful Failover and Failback) by validating the required configuration for Failover to the DR site.
'Teardown' can be used to tear down configuration after a failed/partially successful Failover or Failback operation. This option can also be used to tear down configuration after a successful/failed/partially successful Test Failover or Test Failback operation.
type: - string - 'null' enum: - Activate - PrepareForFailover - PrepareForFailback - TestFailover - TestFailback - Failover - Failback - Teardown failoverParams: description: Specifies the parameters to trigger failover on a DR plan. type: object $ref: '#/components/schemas/SCFailoverActionParams' testFailoverParams: description: Specifies the parameters to trigger a test failover on a DR plan. type: object $ref: '#/components/schemas/SCTestFailoverActionParams' failbackParams: description: Specifies the parameters to trigger a failback on a DR plan. type: object $ref: '#/components/schemas/SCFailbackActionParams' testFailbackParams: description: Specifies the parameters to trigger a test failback on a DR plan. type: object $ref: '#/components/schemas/SCTestFailbackActionParams' teardownParams: description: Specifies the parameters to trigger a teardown operation on a specified action. type: object $ref: '#/components/schemas/SCTeardownActionParams' SCvCenterResourceProfileParams: description: Specifies the resource profile settings for vCenter source. type: object required: - name - defaultResourceSet properties: name: description: Specifies name of the resource profile. type: - string - 'null' isValid: description: Specifies whether the resource profile is valid for performing failover/failback on the DR plan. type: - boolean - 'null' readOnly: true defaultResourceSet: description: Specifies the parameters required to configure a default resource set. Default resource set must be configured and all settings will be generically applied to all objects unless they are specifically overridden in custom resource set settings. type: object allOf: - $ref: '#/components/schemas/SCvCenterDefaultResourceSet' customResourceSets: description: Specifies the parameters required to configure custom resource sets. These are additional resource sets added along with default resource set primarily to override default settings. type: array items: $ref: '#/components/schemas/SCvCenterCustomResourceSet' ipConfig: description: Specifies the custom IP configuration for VMs as part of a resource profile. type: object $ref: '#/components/schemas/SCIpConfig' SCDhcpIpConfig: description: Specifies the DHCP IP configurations. allOf: - $ref: '#/components/schemas/SCCommonDNSSettings' SCResourcePoolComputeConfig: description: Specifies the compute settings for the resource pool object located under a specific vCenter object hierarchy on Cohesity. type: object required: - id properties: id: description: Specifies the ID of the resource pool object. type: - integer - 'null' format: int64 moRef: description: Specifies the Managed Object Reference (MoRef) of the resource pool object. This is a unique identifier inside vCenter. type: - string - 'null' readOnly: true name: description: Specifies the name of the resource pool object. type: - string - 'null' readOnly: true SCTestFailoverActionParams: description: Specifies the action parameters to trigger test failover on a DR plan. type: object allOf: - $ref: '#/components/schemas/SCDRPlanActionCommonParams' - type: object required: - environment properties: environment: description: Specifies the environment of the source for which the test failover action needs to be performed. type: string enum: - vmware vmwareParams: description: Specifies the VMware specific parameters to perform the test failover action. type: object $ref: '#/components/schemas/SCTestFailoverActionVMwareParams' SCDRSiteConfig: description: Specifies the configuration for DR site. type: object required: - siteId - source properties: siteId: description: Specifies the unique identifier of the DR site. type: - integer - 'null' format: int64 source: description: Specifies the registered source configuration on the DR site. type: object allOf: - $ref: '#/components/schemas/SCSourceConfig' SCOperationOnActionParams: description: Specifies the parameters for an performing an operation on a DR plan action. type: object required: - operationType properties: operationType: description: Specifies the current operation type which is being performed on an action.
'Cancel' is used to cancel any of the following in-flight actions - Activate, PrepareForFailover, PrepareForFailback, TestFailover, Failover, TestFailback, Failback. This operation will cancel the latest ongoing attempt.
'Resume' resumes a failed/partially successful Failover or Failback action. This operation will create a new attempt to resume the respective DR plan action.
'ForceFinish' forcefully finishes a partially successful Failover or Failback action without attempting to bring up the failed resources. This operation will create a new attempt to force finish the respective DR plan action.
type: - string - 'null' enum: - Cancel - Resume - ForceFinish SCDrPlanAction: description: Specifies the action configuration to be executed on a DR plan. type: object properties: actionId: description: Specifies the identifier which can be used to get the current status of the action. type: - integer - 'null' format: int64 action: description: Specifies the current action which is being performed on a DR plan.
'Activate' activates the DR plan which periodically checks the protection and replication status to determine if the DR plan Recovery Point Objective (RPO) is met.
'TestFailover' tests if a failover from primary site to DR site works.
'Failover' fails over the resources from primary site to DR site.
'PrepareForFailback' prepares the DR plan for a Failback operation by validating the required configuration for failback to the primary site.
'TestFailback' tests if a failback from DR site to primary site works.
'Failback' fails back the resources from DR site to primary site.
'PrepareForFailover' prepares the DR plan for subsequent Failover operation (after a successful Failover and Failback) by validating the required configuration for Failover to the DR site.
'Teardown' can be used to tear down configuration after a failed/partially successful Failover or Failback operation. This option can also be used to tear down configuration after a successful/failed/partially successful Test Failover or Test Failback operation.
type: - string - 'null' enum: - Activate - PrepareForFailover - PrepareForFailback - TestFailover - TestFailback - Failover - Failback - Teardown SCDRPlanCreateOrUpdateParams: description: Specifies the parameters required for creation of DR plan. type: object required: - name - primarySite - drSite - rpo properties: name: description: Specifies the name of the DR Plan. type: - string - 'null' description: description: Specifies the description of the DR Plan. type: - string - 'null' primarySite: description: Specifies the primary site configuration of the DR plan. type: object $ref: '#/components/schemas/SCPrimarySiteConfig' drSite: description: Specifies the DR site configuration of the DR plan. type: object $ref: '#/components/schemas/SCDRSiteConfig' appId: description: Specifies the unique identifier for the application. This field is optional for creation of DR plan but it is required before performing any actions on a DR plan. type: - integer - 'null' format: int64 rpo: description: Specifies the Recovery Point Objective (RPO) configuration required for this DR plan. This value is used to validate the RPO expectation of the DR plan by comparing this configuration against the backup and replication frequencies set on the objects in the DR plan. type: object $ref: '#/components/schemas/SCRPOConfig' SCStaticIpConfig: description: Specifies the Static IP configurations. required: - configOption properties: configOption: description: Specifies the config option for static Ip config. type: - string - 'null' enum: - Original - NetworkMapping - Manual originalConfig: description: Specifies the original static IP configuration. type: object $ref: '#/components/schemas/SCOriginalStaticIpConfig' networkMappingConfig: description: Specifies the new network mapping. type: array items: $ref: '#/components/schemas/SCNetworkMappingIpConfig' manualIpConfig: description: Specifies the manual IP setting at object/vm level. type: object $ref: '#/components/schemas/SCManualStaticIpConfig' SCErrorCode: description: Specifies all the error codes that are returned by API server type: string enum: - kNoError - kValidationError - kInternalError SCIpConfig: description: Specifies the customer IP configuration parameters. type: object required: - configurationType properties: configurationType: description: Specifies the type of the IP configuration. type: - string - 'null' enum: - DHCP - Static dhcpConfig: description: Specifies the dhcp IP configuration. type: object $ref: '#/components/schemas/SCDhcpIpConfig' staticConfig: description: Specifies the static IP configuration. type: object $ref: '#/components/schemas/SCStaticIpConfig' SCFailoverActionVMwareParams: description: Specifies the action parameters to trigger failover for VMware environment. type: object required: - resourceProfileName properties: resourceProfileName: description: Specifies the unique resource profile name which is added as a part of the DR plan. type: - string - 'null' shutdownVms: description: Specifies if the data objects such as VMs at primary site should be shut down after failover is completed. type: - boolean - 'null' protectVms: description: Specifies if the data objects such as VMs at DR site should be protected after failover is completed. If this field is not set then failback operation will not be possible as a part of the current DR plan. type: - boolean - 'null' SCvCenterComputeConfig: description: Specifies the compute configuration for a vCenter resource set. type: object required: - dataCenterConfig - clusterComputeConfig - resourcePoolConfig - datastoreConfig - networkPortGroupConfig properties: dataCenterConfig: description: Specifies the compute settings for the data center located under a specific vCenter object hierarchy on Cohesity. type: object $ref: '#/components/schemas/SCDataCenterComputeConfig' clusterComputeConfig: description: Specifies the compute settings for the cluster located under a specific vCenter object hierarchy on Cohesity. type: object $ref: '#/components/schemas/SCClusterComputeConfig' resourcePoolConfig: description: Specifies the compute settings for the resource pool located under a specific vCenter object hierarchy on Cohesity. type: object $ref: '#/components/schemas/SCResourcePoolComputeConfig' datastoreConfig: description: Specifies the compute settings for the data store located under a specific vCenter object hierarchy on Cohesity. type: object $ref: '#/components/schemas/SCDatastoreComputeConfig' networkPortGroupConfig: description: Specifies the compute settings for the data store located under a specific vCenter object hierarchy on Cohesity. type: object $ref: '#/components/schemas/SCNetworkPortGroupComputeConfig' SCFailoverActionParams: description: Specifies the action parameters to trigger failover on a DR plan. type: object allOf: - $ref: '#/components/schemas/SCDRPlanActionCommonParams' - type: object required: - environment properties: environment: description: Specifies the environment of the source for which the failover action needs to be performed. type: string enum: - vmware vmwareParams: description: Specifies the VMware specific parameters to perform the failover action. type: object $ref: '#/components/schemas/SCFailoverActionVMwareParams' SCTestFailoverActionVMwareParams: description: Specifies the VMware specific parameters to perform the test failover action. type: object required: - resourceProfileName properties: resourceProfileName: description: Specifies the unique resource profile name which is added as a part of the DR plan. type: - string - 'null' performStorageVmotion: description: Specifies whether to perform the storage vMotion operation with the test failover action. Default value is false if not specified. type: - boolean - 'null' SCSourceConfig: description: Specifies the source details for DR plan configuration. type: object required: - environment properties: environment: description: Specifies the source environment. type: string enum: - vmware vmwareParams: description: Specifies the source for adding VMware data object parameters. Only vCenter is supported at this time. type: object $ref: '#/components/schemas/SCDRSourceVMwareParams' SCTestFailbackActionParams: description: Specifies the action parameters to trigger a test failback on a DR plan. type: object allOf: - $ref: '#/components/schemas/SCDRPlanActionCommonParams' - type: object required: - environment properties: environment: description: Specifies the environment of the source for which the test failback action needs to be performed. type: string enum: - vmware vmwareParams: description: Specifies the VMware specific parameters to perform the test failback action. type: object $ref: '#/components/schemas/SCTestFailbackActionVMwareParams' SCDRSourceVMwareParams: description: Specifies the source details for adding VMware objects. type: object required: - sourceType properties: sourceType: description: Specifies the type of the VMware source. type: - string - 'null' enum: - vCenter vCenterParams: description: Specifies the parameters to configure vCenter source. type: object $ref: '#/components/schemas/SCDRSourceVCenterParams' SCActionsResponse: description: Specifies the list of actions. type: object properties: actions: description: Specifies the list of actions. type: array items: $ref: '#/components/schemas/SCAction' SCCommonDNSSettings: description: Specifies the common DNS IP settings. properties: dnsServers: description: Specifies the list of DNS servers. type: array items: type: string dnsSuffixes: description: Specifies the list of DNS suffixes. type: array items: type: string responses: SCGetActionsResponse: description: Specifies the response of a successful get actions. content: application/json: schema: $ref: '#/components/schemas/SCActionsResponse' SCCreateDRPlanResponse: description: Specifies the response of a successful DR plan creation. content: application/json: schema: $ref: '#/components/schemas/SCDRPlan' SCUpdateDRPlanResponse: description: Specifies the response of a successful DR plan update. content: application/json: schema: $ref: '#/components/schemas/SCDRPlan' SCPerformActionDrPlanResponse: description: Specifies the response after performing an action on DR plan. content: application/json: schema: $ref: '#/components/schemas/SCDrPlanAction' SCGetDRPlansResponse: description: Specifies the response of a successful get DR plans operation. content: application/json: schema: $ref: '#/components/schemas/SCDRPlansResponse' SCGetActionByIdResponse: description: Specifies the response of a successful get DR plan operation. content: application/json: schema: $ref: '#/components/schemas/SCAction' SCGetDRPlanByIdResponse: description: Specifies the response of a successful get DR plan operation. content: application/json: schema: $ref: '#/components/schemas/SCDRPlan' SCErrorResponse: description: Specifies the common error definition. content: application/json: schema: $ref: '#/components/schemas/SCError' NoContentResponse: description: No Content securitySchemes: ApiKeyAuth: type: apiKey in: header name: apiKey