Cloud Site Controller Resource

The API allows you to list and view cloud sites.

GET /cloud-sites

Returns list of cloud sites filtered by specified query parameters.

Request 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
Response Body
media type data type description
application/json array of CloudSiteListRecord (JSON) list of cloud sites filtered by specified query parameters

Example

Request
GET /cloud-sites
Content-Type: */*
Accept: application/json

                
...
                
              
Response
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
} ]
                
              

POST /cloud-sites/assign-backup-policy

Assign sites to specified policy (or unassign if policy is null)

Request Body
media type data type description
application/json ProtectedEntityBackupPolicyAssignmentRequest (JSON) containing policy and sites info

Example

Request
POST /cloud-sites/assign-backup-policy
Content-Type: application/json

                
{
  "backupPolicy" : "...",
  "protectedEntities" : [ {
    "guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
    "name" : "Entity name"
  }, {
    "guid" : "...",
    "name" : "..."
  } ]
}
                
              
Response
HTTP/1.1 201 Created

              

GET /cloud-sites/backup-cleanup

Returns list of protected entities for backup cleanup.

Request Parameters
name type description
backup-destination query
Response Body
media type data type description
application/json array of CloudSiteListRecord (JSON) list of protected entities for backup cleanup

Example

Request
GET /cloud-sites/backup-cleanup
Content-Type: */*
Accept: application/json

                
...
                
              
Response
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
} ]
                
              

POST /cloud-sites/children-map

Returns map of cloud site children for specified site guids.

Request Parameters
name type description default constraints
only-present query specify this query parameter if only present subsites should be listed (default: true) true boolean
Request Body
media type data type description
application/json array of NameAndGuid (JSON) specify list of local unique identifiers for cloud sites (use by vProtect)
Response Body
media type data type description
application/json map of array of CloudSiteListRecord (JSON) map of cloud site children for specified site guids.

Example

Request
POST /cloud-sites/children-map
Content-Type: application/json
Accept: application/json

                
[ {
  "guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
  "name" : "Entity name"
} ]
                
              
Response
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
  }
} ]
                
              

GET /cloud-sites/rbac-contexts

Returns list of cloud sites filtered by specified query parameters.

Request 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
Response Body
media type data type description
application/json array of RbacContextListRecord (JSON) list of cloud sites filtered by specified query parameters

Example

Request
GET /cloud-sites/rbac-contexts
Content-Type: */*
Accept: application/json

                
...
                
              
Response
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" : "..."
} ]
                
              

POST /cloud-sites/subsites

Returns list of cloud subsites for specified site guids.

Request Parameters
name type description default constraints
only-present query specify this query parameter if only present subsites should be listed (default: true) true boolean
Request Body
media type data type description
application/json array of NameAndGuid (JSON) specify list of local unique identifiers for cloud sites (use by vProtect)
Response Body
media type data type description
application/json array of CloudSiteListRecord (JSON) list of cloud subsites for specified site guids.

Example

Request
POST /cloud-sites/subsites
Content-Type: application/json
Accept: application/json

                
[ {
  "guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
  "name" : "Entity name"
} ]
                
              
Response
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
} ]
                
              

POST /cloud-sites/subsites-map

Returns map of cloud subsites for specified site guids.

Request Parameters
name type description default constraints
only-present query specify this query parameter if only present subsites should be listed (default: true) true boolean
Request Body
media type data type description
application/json array of NameAndGuid (JSON) specify list of local unique identifiers for cloud sites (use by vProtect)
Response Body
media type data type description
application/json map of array of CloudSiteListRecord (JSON) map of cloud subsites for specified site guids.

Example

Request
POST /cloud-sites/subsites-map
Content-Type: application/json
Accept: application/json

                
[ {
  "guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
  "name" : "Entity name"
} ]
                
              
Response
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 /cloud-sites/{guid}

Get a single cloud site.

Request Parameters
name type description
guid path specify local unique identifier for cloud site (use by vProtect)
Response Body
media type data type description
application/json CloudSiteDetails (JSON) cloud site details

Example

Request
GET /cloud-sites/{guid}
Content-Type: */*
Accept: application/json

                
...
                
              
Response
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"
}
                
              

GET /cloud-sites/{guid}/children

Returns list of cloud site children for specified site guid.

Request Parameters
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
Response Body
media type data type description
application/json array of CloudSiteListRecord (JSON) list of cloud site children for specified site guid.

Example

Request
GET /cloud-sites/{guid}/children
Content-Type: */*
Accept: application/json

                
...
                
              
Response
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
} ]
                
              

GET /cloud-sites/{guid}/subsites

Returns list of cloud subsites for specified site guid.

Request Parameters
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
Response Body
media type data type description
application/json array of CloudSiteListRecord (JSON) list of cloud subsites for specified site guid.

Example

Request
GET /cloud-sites/{guid}/subsites
Content-Type: */*
Accept: application/json

                
...
                
              
Response
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
} ]