Cleanroom Runbook Create
Select
Creation of Cleanroom Runbook
- application/json
Request Body
- name string required
Name of the recovery group. The same name will be used for Target and Hypervisor creation, if Create new option is used.
target object required
Options to use an existing target or create a new one in Cleanroom
entity object
id int32name stringoptions object
Options to create a new cleanroom target
name stringName of the target
vendor stringPossible values: [
NONE
,AZURE_V2
,AMAZON
]The vendor where the target needs to be created
hypervisor object required
Options to provide an existing hypervisor or create a new one
entity object
id int32name stringoptionsAzure object
Create a hypervisor group
name string requiredThe name of the hypervisor group being created
skipCredentialValidation booleanDefault value:
false
if credential validation has to be skipped.
useHostedInfrastructure booleanDefault value:
false
Describes if the infra has to be managed by commvault
accessNodes object[]
id int32name stringdisplayName stringDisplay name of the access node
type int32Type of access node , Ex: 3 - access Node , 28 - Access Node Groups
credentials object
id int32name stringetcdProtection object
Create an application group etcd (system generated) with pre-defined content
enabled booleanDenote if etcd protection is enabled
plan object
id int32name stringplanEntity object
id int32name stringenableCloudConfigProtection booleanDefault value:
false
Protect Cloud Config entities
workloadType stringworkloadRegion object
id int32name stringforceAccessNodeRegion booleanDefault value:
true
If workloadRegion is set, use only access nodes from that region when true (fail if none found). When false, prefer that region but use any node if needed.
hypervisorType string requiredPossible values: [
AZURE_V2
]useManagedIdentity booleanDefault value:
false
set to true, if you want to use System Managed identitiy of Access node for Authentication
subscriptionId string requiredSubscription ID of Azure
isAuthorizedUsingMTA booleanDefault value:
false
Indicates whether the hypervisor was created by authorizing the multitenant app in this tenant.
optionsAmazon object
Create a hypervisor group
name string requiredThe name of the hypervisor group being created
skipCredentialValidation booleanDefault value:
false
if credential validation has to be skipped.
useHostedInfrastructure booleanDefault value:
false
Describes if the infra has to be managed by commvault
accessNodes object[]
id int32name stringdisplayName stringDisplay name of the access node
type int32Type of access node , Ex: 3 - access Node , 28 - Access Node Groups
credentials object
id int32name stringetcdProtection object
Create an application group etcd (system generated) with pre-defined content
enabled booleanDenote if etcd protection is enabled
plan object
id int32name stringplanEntity object
id int32name stringenableCloudConfigProtection booleanDefault value:
false
Protect Cloud Config entities
workloadType stringworkloadRegion object
id int32name stringforceAccessNodeRegion booleanDefault value:
true
If workloadRegion is set, use only access nodes from that region when true (fail if none found). When false, prefer that region but use any node if needed.
hypervisorType string requiredPossible values: [
Amazon
]accessKey string requiredAccess Key of Amazon login
RoleARN stringRole ARN for STS assume role with IAM policy
secretKey string requiredsecret Key of Amazon login
Region stringAWS region if Iam role is used
useIamRole boolean requiredif Iam Role is used
enableAWSAdminAccount booleanuseServiceAccount stringClientname to be used as Admin Account
accessNode object
id int32name stringdisplayName stringDisplay name of the access node
type int32Type of access node , Ex: 3 - access Node , 28 - Access Node Groups
region object required
guid stringname string- entities object[] required
Array of entities that have to be part of the group.
advancedOptions object
Advanced options for cleanroom runbook
postRecoveryActions object[]
path stringThe path of the script to be executed. Can be local path on VM or UNC path accessible by access node
type stringPossible values: [
UNC
,LOCAL
]The type of path being used for DR operation script
scriptCredentials object
savedCredentials object
id int32name stringcredentials object
name stringusername to access the network path
password stringpassword to access the network path
guestCredentials object
savedCredentials object
id int32name stringcredentials object
name stringusername to access the network path
password stringpassword to access the network path
guid stringUnique script identifier string
scriptContent stringContent of the script to be executed
scriptName stringName of the script
reset booleanOn set to true, resets the script to empty
osType stringPossible values: [
WINDOWS
,UNIX
]OS types
delayBetweenPriorityMachines int32The delay between machines in different priorities in minutes
continueOnFailure booleanDefault value:
false
Set to true to continue to the next priority machines on failure
recoveryExpirationOptions object
enableExpirationOption booleanDefault value:
true
If true, cleans up recovered VMs after the set daysToExpire value
daysToExpire int32Default value:
7
Number of days after which recovered VMs are automatically cleaned up
isRescuedCommServe booleanWhether the CommServe is rescued or not
expirationTime int32Timestamp when the clean up of all recovered VMs happens on the rescued CommServe. It happens 4 hours before the CommServe expiration time
enableThreatScan booleanDefault value:
false
Indicates whether a threat scan should be performed after recovery
enableWindowsDefenderScan booleanDefault value:
false
A boolean that specifies whether a windows defender scan is required
powerOffVMPostValidation booleanDefault value:
false
Specifies whether the destination VM should be powered off after recovery and validation
useAutoScale booleanDefault value:
true
Set to true to use auto scale during cleanroom recovery
- 200
- 500
OK
- application/json
- Schema
- Example (from schema)
Schema
recoveryGroup object
id int32name stringerror object
errorMessage stringerrorCode int32
{
"recoveryGroup": {
"id": 0,
"name": "string"
},
"error": {
"errorMessage": "string",
"errorCode": 0
}
}
Internal Server Error
- application/json
- Schema
- Example (from schema)
Schema
- errorMessage string
- errorCode int32
{
"errorMessage": "string",
"errorCode": 0
}