The API allows you to list and view cloud sites.
Returns list of cloud sites filtered by specified query parameters.
name | type | description | default | constraints | multivalued |
---|---|---|---|---|---|
backupStatus | query | "IS_PROTECTED" or "NOT_PROTECTED" or "NO_SCHEDULE" | yes | ||
cloud-service-provider | query | no | |||
direction | query | no | |||
filter | query | no | |||
nameLike | query | no | |||
orderBy | query | no | |||
page | query | no | |||
policy | query | yes | |||
size | query | no | |||
team | query | no | |||
with-childs | query | boolean | no | ||
with-teams | query | false | boolean | no |
media type | data type | description |
---|---|---|
application/json | array of CloudSiteListRecord (JSON) | list of cloud sites filtered by specified query parameters |
GET /cloud-sites
Content-Type: */*
Accept: application/json
...
HTTP/1.1 200 OK
Content-Type: application/json
[ {
"name" : "...",
"type" : "CLOUD_GROUP",
"webUrl" : "...",
"backupUpToDate" : true,
"policy" : {
"guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
"name" : "Entity name"
},
"restorable" : true,
"possibleActions" : [ "WRITE", "HVM_READ" ],
"lastSuccessfulBackupSize" : 12345,
"present" : true,
"lastSuccessfulFullBackupSize" : 12345,
"cloudServiceProvider" : {
"guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
"name" : "Entity name"
},
"warningsPresent" : true,
"cloudServiceProviderType" : "MICROSOFT365",
"lastSuccessfulFullBackup" : {
"guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
"name" : "Entity name"
},
"lastSuccessfulIncBackup" : {
"guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
"name" : "Entity name"
},
"averageProgress" : 12345.0,
"lastChainMarkedForDeletion" : true,
"guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
"lastBackup" : 1451649601000
} ]
Assign sites to specified policy (or unassign if policy is null)
media type | data type | description |
---|---|---|
application/json | ProtectedEntityBackupPolicyAssignmentRequest (JSON) | containing policy and sites info |
POST /cloud-sites/assign-backup-policy
Content-Type: application/json
{
"backupPolicy" : "...",
"protectedEntities" : [ {
"guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
"name" : "Entity name"
}, {
"guid" : "...",
"name" : "..."
} ]
}
HTTP/1.1 201 Created
Returns list of protected entities for backup cleanup.
name | type | description |
---|---|---|
backup-destination | query |
media type | data type | description |
---|---|---|
application/json | array of CloudSiteListRecord (JSON) | list of protected entities for backup cleanup |
GET /cloud-sites/backup-cleanup
Content-Type: */*
Accept: application/json
...
HTTP/1.1 200 OK
Content-Type: application/json
[ {
"name" : "...",
"type" : "CLOUD_GROUP",
"webUrl" : "...",
"backupUpToDate" : true,
"policy" : {
"guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
"name" : "Entity name"
},
"restorable" : true,
"possibleActions" : [ "READ", "WRITE" ],
"lastSuccessfulBackupSize" : 12345,
"present" : true,
"lastSuccessfulFullBackupSize" : 12345,
"cloudServiceProvider" : {
"guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
"name" : "Entity name"
},
"warningsPresent" : true,
"cloudServiceProviderType" : "MICROSOFT365",
"lastSuccessfulFullBackup" : {
"guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
"name" : "Entity name"
},
"lastSuccessfulIncBackup" : {
"guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
"name" : "Entity name"
},
"averageProgress" : 12345.0,
"lastChainMarkedForDeletion" : true,
"guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
"lastBackup" : 1451649601000
} ]
Returns map of cloud site children for specified site guids.
name | type | description | default | constraints |
---|---|---|---|---|
only-present | query | specify this query parameter if only present subsites should be listed (default: true) | true | boolean |
media type | data type | description |
---|---|---|
application/json | array of NameAndGuid (JSON) | specify list of local unique identifiers for cloud sites (use by vProtect) |
media type | data type | description |
---|---|---|
application/json | map of array of CloudSiteListRecord (JSON) | map of cloud site children for specified site guids. |
POST /cloud-sites/children-map
Content-Type: application/json
Accept: application/json
[ {
"guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
"name" : "Entity name"
} ]
HTTP/1.1 201 Created
Content-Type: application/json
[ {
"..." : {
"name" : "...",
"type" : "OS",
"webUrl" : "...",
"backupUpToDate" : true,
"policy" : {
"guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
"name" : "Entity name"
},
"restorable" : true,
"possibleActions" : [ "READ", "READ" ],
"lastSuccessfulBackupSize" : 12345,
"present" : true,
"lastSuccessfulFullBackupSize" : 12345,
"cloudServiceProvider" : {
"guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
"name" : "Entity name"
},
"warningsPresent" : true,
"cloudServiceProviderType" : "MICROSOFT365",
"lastSuccessfulFullBackup" : {
"guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
"name" : "Entity name"
},
"lastSuccessfulIncBackup" : {
"guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
"name" : "Entity name"
},
"averageProgress" : 12345.0,
"lastChainMarkedForDeletion" : true,
"guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
"lastBackup" : 1451649601000
}
} ]
Returns list of cloud sites filtered by specified query parameters.
name | type | description | constraints |
---|---|---|---|
app-cmd-exec-config | query | ||
cloud-service-provider | query | ||
cluster | query | ||
data-center | query | ||
direction | query | ||
filter | query | ||
hypervisor | query | ||
hypervisor-manager | query | ||
nameLike | query | ||
orderBy | query | ||
page | query | ||
project | query | ||
size | query | ||
storage-pool | query | ||
storage-provider | query | ||
teams-group | query | boolean |
media type | data type | description |
---|---|---|
application/json | array of RbacContextListRecord (JSON) | list of cloud sites filtered by specified query parameters |
GET /cloud-sites/rbac-contexts
Content-Type: */*
Accept: application/json
...
HTTP/1.1 200 OK
Content-Type: application/json
[ {
"nameAndGuid" : {
"guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
"name" : "Entity name"
},
"uuid" : "...",
"type" : "HYPERVISOR_MANAGER",
"checked" : true,
"lastLevel" : true,
"present" : true,
"entityType" : "...",
"childrenQueryType" : "..."
} ]
Returns list of cloud subsites for specified site guids.
name | type | description | default | constraints |
---|---|---|---|---|
only-present | query | specify this query parameter if only present subsites should be listed (default: true) | true | boolean |
media type | data type | description |
---|---|---|
application/json | array of NameAndGuid (JSON) | specify list of local unique identifiers for cloud sites (use by vProtect) |
media type | data type | description |
---|---|---|
application/json | array of CloudSiteListRecord (JSON) | list of cloud subsites for specified site guids. |
POST /cloud-sites/subsites
Content-Type: application/json
Accept: application/json
[ {
"guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
"name" : "Entity name"
} ]
HTTP/1.1 201 Created
Content-Type: application/json
[ {
"name" : "...",
"type" : "OS",
"webUrl" : "...",
"backupUpToDate" : true,
"policy" : {
"guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
"name" : "Entity name"
},
"restorable" : true,
"possibleActions" : [ "HV_READ", "INVENTORY_SYNC" ],
"lastSuccessfulBackupSize" : 12345,
"present" : true,
"lastSuccessfulFullBackupSize" : 12345,
"cloudServiceProvider" : {
"guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
"name" : "Entity name"
},
"warningsPresent" : true,
"cloudServiceProviderType" : "MICROSOFT365",
"lastSuccessfulFullBackup" : {
"guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
"name" : "Entity name"
},
"lastSuccessfulIncBackup" : {
"guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
"name" : "Entity name"
},
"averageProgress" : 12345.0,
"lastChainMarkedForDeletion" : true,
"guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
"lastBackup" : 1451649601000
} ]
Returns map of cloud subsites for specified site guids.
name | type | description | default | constraints |
---|---|---|---|---|
only-present | query | specify this query parameter if only present subsites should be listed (default: true) | true | boolean |
media type | data type | description |
---|---|---|
application/json | array of NameAndGuid (JSON) | specify list of local unique identifiers for cloud sites (use by vProtect) |
media type | data type | description |
---|---|---|
application/json | map of array of CloudSiteListRecord (JSON) | map of cloud subsites for specified site guids. |
POST /cloud-sites/subsites-map
Content-Type: application/json
Accept: application/json
[ {
"guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
"name" : "Entity name"
} ]
HTTP/1.1 201 Created
Content-Type: application/json
[ {
"..." : {
"name" : "...",
"type" : "CLOUD",
"webUrl" : "...",
"backupUpToDate" : true,
"policy" : {
"guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
"name" : "Entity name"
},
"restorable" : true,
"possibleActions" : [ "WRITE", "HV_READ" ],
"lastSuccessfulBackupSize" : 12345,
"present" : true,
"lastSuccessfulFullBackupSize" : 12345,
"cloudServiceProvider" : {
"guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
"name" : "Entity name"
},
"warningsPresent" : true,
"cloudServiceProviderType" : "MICROSOFT365",
"lastSuccessfulFullBackup" : {
"guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
"name" : "Entity name"
},
"lastSuccessfulIncBackup" : {
"guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
"name" : "Entity name"
},
"averageProgress" : 12345.0,
"lastChainMarkedForDeletion" : true,
"guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
"lastBackup" : 1451649601000
}
} ]
Get a single cloud site.
name | type | description |
---|---|---|
guid | path | specify local unique identifier for cloud site (use by vProtect) |
media type | data type | description |
---|---|---|
application/json | CloudSiteDetails (JSON) | cloud site details |
GET /cloud-sites/{guid}
Content-Type: */*
Accept: application/json
...
HTTP/1.1 200 OK
Content-Type: application/json
{
"sshHost" : "...",
"sshPort" : 12345,
"credential" : {
"guid" : "...",
"name" : "...",
"user" : "...",
"secretKey" : "...",
"sshKey" : "...",
"sshKeyPath" : "...",
"powerShellTransportType" : "SSL"
},
"sshKeyPath" : "...",
"backupCount" : 12345,
"rules" : [ {
"guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
"name" : "Entity name"
}, {
"guid" : "...",
"name" : "..."
} ],
"name" : "...",
"type" : "CLOUD_USER",
"backupUpToDate" : true,
"restorable" : true,
"lastSuccessfulBackupSize" : 12345,
"lastSuccessfulFullBackupSize" : 12345,
"policy" : {
"rules" : [ {
"guid" : "...",
"name" : "...",
"policy" : { },
"schedules" : [ { }, { } ],
"vmCount" : 12345,
"schedulesCount" : 12345,
"position" : 12345,
"active" : true,
"removable" : true,
"daysToKeepRetentionLock" : 12345
}, {
"guid" : "...",
"name" : "...",
"policy" : { },
"schedules" : [ { }, { } ],
"vmCount" : 12345,
"schedulesCount" : 12345,
"position" : 12345,
"active" : true,
"removable" : true,
"daysToKeepRetentionLock" : 12345
} ],
"name" : "...",
"active" : true,
"guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
"priority" : 50,
"autoAssignSettings" : {
"mode" : "DISABLED",
"includeRegExps" : [ "...", "..." ],
"cloudServiceProviders" : [ { }, { } ]
},
"autoRemoveNonPresent" : true,
"averageBackupSize" : 12345,
"failRemainingBackupTasksExportThreshold" : 12345.0,
"failRemainingBackupTasksStoreThreshold" : 12345.0,
"backupRetryCount" : 12345,
"dailyReportEnabled" : true,
"mailingList" : {
"guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
"name" : "Entity name"
},
"cloudFeatures" : [ {
"name" : "ENUM_NAME",
"description" : "Enum description"
}, {
"name" : "...",
"description" : "..."
} ],
"objectsTimeRange" : 12345,
"backupDeletedItemsFolder" : true
},
"warningsPresent" : true,
"cloudServiceProvider" : {
"guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
"name" : "Entity name"
},
"lastSuccessfulFullBackup" : {
"guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
"name" : "Entity name"
},
"cloudServiceProviderType" : "MICROSOFT365",
"lastSuccessfulIncBackup" : {
"guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
"name" : "Entity name"
},
"averageProgress" : 12345.0,
"groupExternalSourceId" : "...",
"lastChainMarkedForDeletion" : true,
"groupGuid" : "...",
"parentExternalSourceId" : "...",
"guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
"externalSourceId" : "...",
"webUrl" : "...",
"possibleActions" : [ "HV_READ", "HVM_READ" ],
"lastBackup" : 1451649601000,
"present" : true,
"siteType" : "COMMUNICATION"
}
Returns list of cloud site children for specified site guid.
name | type | description | default | constraints |
---|---|---|---|---|
guid | path | specify local unique identifier for cloud site (use by vProtect) | ||
only-present | query | specify this query parameter if only present subsites should be listed (default: true) | true | boolean |
media type | data type | description |
---|---|---|
application/json | array of CloudSiteListRecord (JSON) | list of cloud site children for specified site guid. |
GET /cloud-sites/{guid}/children
Content-Type: */*
Accept: application/json
...
HTTP/1.1 200 OK
Content-Type: application/json
[ {
"name" : "...",
"type" : "CLOUD",
"webUrl" : "...",
"backupUpToDate" : true,
"policy" : {
"guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
"name" : "Entity name"
},
"restorable" : true,
"possibleActions" : [ "HVM_READ", "HV_READ" ],
"lastSuccessfulBackupSize" : 12345,
"present" : true,
"lastSuccessfulFullBackupSize" : 12345,
"cloudServiceProvider" : {
"guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
"name" : "Entity name"
},
"warningsPresent" : true,
"cloudServiceProviderType" : "MICROSOFT365",
"lastSuccessfulFullBackup" : {
"guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
"name" : "Entity name"
},
"lastSuccessfulIncBackup" : {
"guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
"name" : "Entity name"
},
"averageProgress" : 12345.0,
"lastChainMarkedForDeletion" : true,
"guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
"lastBackup" : 1451649601000
} ]
Returns list of cloud subsites for specified site guid.
name | type | description | default | constraints |
---|---|---|---|---|
guid | path | specify local unique identifier for cloud site (use by vProtect) | ||
only-present | query | specify this query parameter if only present subsites should be listed (default: true) | true | boolean |
media type | data type | description |
---|---|---|
application/json | array of CloudSiteListRecord (JSON) | list of cloud subsites for specified site guid. |
GET /cloud-sites/{guid}/subsites
Content-Type: */*
Accept: application/json
...
HTTP/1.1 200 OK
Content-Type: application/json
[ {
"name" : "...",
"type" : "STORAGE",
"webUrl" : "...",
"backupUpToDate" : true,
"policy" : {
"guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
"name" : "Entity name"
},
"restorable" : true,
"possibleActions" : [ "WRITE", "HVM_READ" ],
"lastSuccessfulBackupSize" : 12345,
"present" : true,
"lastSuccessfulFullBackupSize" : 12345,
"cloudServiceProvider" : {
"guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
"name" : "Entity name"
},
"warningsPresent" : true,
"cloudServiceProviderType" : "MICROSOFT365",
"lastSuccessfulFullBackup" : {
"guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
"name" : "Entity name"
},
"lastSuccessfulIncBackup" : {
"guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
"name" : "Entity name"
},
"averageProgress" : 12345.0,
"lastChainMarkedForDeletion" : true,
"guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
"lastBackup" : 1451649601000
} ]