Cloud Connect

This resource collection represents sites and their infrastructure components.

Get All Sites

Returns a collection resource representation of all cloud agents installed on sites.

Request
query Parameters
Array of objects or null (FilterParameter)

Specifies the conditions that a resource must meet to be returned in the output.

Array of objects or null (SortParameter)

Specifies the order in which resources are returned from the collection.

limit
integer <int32> [ 1 .. 500 ]
Default: 100

Specifies the first N resources that must be returned in the output.

offset
integer <int32> [ 0 .. 2147483647 ]
Default: 0

Excludes the first N resources from the query output.

Array of objects or null (SelectParameter)

Returns explicitly requested properties.

header Parameters
X-Request-id
string <uuid>

Random UID that you can assign to a request for idempotence and async action progress tracking.

Note that an operation is idempotent only during 5 minute time interval.

Example: ba547d14-c556-42bb-b85c-eeeb16e2f5e7
X-Client-Version
string

Version of Veeam Service Provider Console RESTful API supported by client.

Example: 3.6.1
Responses
200

OK

202

Request has been queued for execution.

default

All client errors (400–499) are returned with the associated HTTP status codes. All server errors (≥500) are returned with the 520 HTTP status code. For details, see the response body.

get/infrastructure/sites
Request samples
Response samples
application/json
{
  • "data": [
    ],
  • "meta": {
    }
}

Get Site

Returns a resource representation of a cloud agent installed on a Veeam Cloud Connect site with the specified UID.

Request
path Parameters
siteUid
required
string <uuid>

Veeam Cloud Connect site UID.

query Parameters
Array of objects or null (SelectParameter)

Returns explicitly requested properties.

header Parameters
X-Request-id
string <uuid>

Random UID that you can assign to a request for idempotence and async action progress tracking.

Note that an operation is idempotent only during 5 minute time interval.

Example: ba547d14-c556-42bb-b85c-eeeb16e2f5e7
X-Client-Version
string

Version of Veeam Service Provider Console RESTful API supported by client.

Example: 3.6.1
Responses
200

OK

202

Request has been queued for execution.

default

All client errors (400–499) are returned with the associated HTTP status codes. All server errors (≥500) are returned with the 520 HTTP status code. For details, see the response body.

get/infrastructure/sites/{siteUid}
Request samples
Response samples
application/json
{
  • "data": {
    }
}

Modify Site

Modifies a cloud agent installed on a Veeam Cloud Connect site with the specified UID.

Request
path Parameters
siteUid
required
string <uuid>

Veeam Cloud Connect site UID.

query Parameters
Array of objects or null (SelectParameter)

Returns explicitly requested properties.

header Parameters
X-Request-id
string <uuid>

Random UID that you can assign to a request for idempotence and async action progress tracking.

Note that an operation is idempotent only during 5 minute time interval.

Example: ba547d14-c556-42bb-b85c-eeeb16e2f5e7
X-Client-Version
string

Version of Veeam Service Provider Console RESTful API supported by client.

Example: 3.6.1
Request Body schema: application/json
required

Array of JSON Patch operations according to RFC 6902.

Array
op
required
string

Performed operation.

Enum: "add" "replace" "test" "remove" "move" "copy"
value
required
string

Value that is added, replaced, tested or removed by the PATCH operation.

path
required
string

JSON Pointer containing path to a target location where the PATCH operation is performed.

from
string or null

JSON Pointer containing path to a location from which data is moved or copied.

Responses
200

OK

202

Request has been queued for execution.

default

All client errors (400–499) are returned with the associated HTTP status codes. All server errors (≥500) are returned with the 520 HTTP status code. For details, see the response body.

patch/infrastructure/sites/{siteUid}
Request samples
application/json
[
  • {
    },
  • {
    }
]
Response samples
application/json
{
  • "data": {
    }
}

Set Site Maintenance Mode

Enables or disables the maintenance mode for a site with the specified UID.

Request
path Parameters
siteUid
required
string <uuid>

Veeam Cloud Connect site UID.

query Parameters
maintenanceMode
required
boolean

Pass the true value to enable maintenance mode and the false value to disable it.

Array of objects or null (SelectParameter)

Returns explicitly requested properties.

header Parameters
X-Request-id
string <uuid>

Random UID that you can assign to a request for idempotence and async action progress tracking.

Note that an operation is idempotent only during 5 minute time interval.

Example: ba547d14-c556-42bb-b85c-eeeb16e2f5e7
X-Client-Version
string

Version of Veeam Service Provider Console RESTful API supported by client.

Example: 3.6.1
Responses
200

OK

202

Request has been queued for execution.

default

All client errors (400–499) are returned with the associated HTTP status codes. All server errors (≥500) are returned with the 520 HTTP status code. For details, see the response body.

put/infrastructure/sites/{siteUid}/maintenanceModeIsEnabled
Request samples
Response samples
application/json
{
  • "data": {
    }
}

Set Tenant Management on Site

Enables or disables tenant management on a Veeam Cloud Connect site with the specified UID.

Request
path Parameters
siteUid
required
string <uuid>

Veeam Cloud Connect site UID.

query Parameters
tenantManagementMode
required
boolean

Pass the true value to enable tenant management and the false value to disable it.

Array of objects or null (SelectParameter)

Returns explicitly requested properties.

header Parameters
X-Request-id
string <uuid>

Random UID that you can assign to a request for idempotence and async action progress tracking.

Note that an operation is idempotent only during 5 minute time interval.

Example: ba547d14-c556-42bb-b85c-eeeb16e2f5e7
X-Client-Version
string

Version of Veeam Service Provider Console RESTful API supported by client.

Example: 3.6.1
Responses
200

OK

202

Request has been queued for execution.

default

All client errors (400–499) are returned with the associated HTTP status codes. All server errors (≥500) are returned with the 520 HTTP status code. For details, see the response body.

put/infrastructure/sites/{siteUid}/tenantManagementInCloudConnectIsEnabled
Request samples
Response samples
application/json
{
  • "data": {
    }
}

Get All Hardware Plans

Returns a collection resource representation of all hardware plans.

Request
query Parameters
Array of objects or null (FilterParameter)

Specifies the conditions that a resource must meet to be returned in the output.

Array of objects or null (SortParameter)

Specifies the order in which resources are returned from the collection.

limit
integer <int32> [ 1 .. 500 ]
Default: 100

Specifies the first N resources that must be returned in the output.

offset
integer <int32> [ 0 .. 2147483647 ]
Default: 0

Excludes the first N resources from the query output.

Array of objects or null (SelectParameter)

Returns explicitly requested properties.

header Parameters
X-Request-id
string <uuid>

Random UID that you can assign to a request for idempotence and async action progress tracking.

Note that an operation is idempotent only during 5 minute time interval.

Example: ba547d14-c556-42bb-b85c-eeeb16e2f5e7
X-Client-Version
string

Version of Veeam Service Provider Console RESTful API supported by client.

Example: 3.6.1
Responses
200

OK

202

Request has been queued for execution.

default

All client errors (400–499) are returned with the associated HTTP status codes. All server errors (≥500) are returned with the 520 HTTP status code. For details, see the response body.

get/infrastructure/sites/hardwarePlans
Request samples
Response samples
application/json
{
  • "data": [
    ],
  • "meta": {
    }
}

Get All Hardware Plans Configured on Site

Returns a collection resource representation of all hardware plans configured on a Veeam Cloud Connect site with the specified UID.

Request
path Parameters
siteUid
required
string <uuid>

Veeam Cloud Connect site UID.

query Parameters
Array of objects or null (FilterParameter)

Specifies the conditions that a resource must meet to be returned in the output.

Array of objects or null (SortParameter)

Specifies the order in which resources are returned from the collection.

limit
integer <int32> [ 1 .. 500 ]
Default: 100

Specifies the first N resources that must be returned in the output.

offset
integer <int32> [ 0 .. 2147483647 ]
Default: 0

Excludes the first N resources from the query output.

Array of objects or null (SelectParameter)

Returns explicitly requested properties.

header Parameters
X-Request-id
string <uuid>

Random UID that you can assign to a request for idempotence and async action progress tracking.

Note that an operation is idempotent only during 5 minute time interval.

Example: ba547d14-c556-42bb-b85c-eeeb16e2f5e7
X-Client-Version
string

Version of Veeam Service Provider Console RESTful API supported by client.

Example: 3.6.1
Responses
200

OK

202

Request has been queued for execution.

default

All client errors (400–499) are returned with the associated HTTP status codes. All server errors (≥500) are returned with the 520 HTTP status code. For details, see the response body.

get/infrastructure/sites/{siteUid}/hardwarePlans
Request samples
Response samples
application/json
{
  • "data": [
    ],
  • "meta": {
    }
}

Get Hardware Plan

Returns a resource representation of a hardware plan with the specified UID.

Request
path Parameters
instanceUid
required
string <uuid>

Hardware plan UID.

query Parameters
Array of objects or null (SelectParameter)

Returns explicitly requested properties.

header Parameters
X-Request-id
string <uuid>

Random UID that you can assign to a request for idempotence and async action progress tracking.

Note that an operation is idempotent only during 5 minute time interval.

Example: ba547d14-c556-42bb-b85c-eeeb16e2f5e7
X-Client-Version
string

Version of Veeam Service Provider Console RESTful API supported by client.

Example: 3.6.1
Responses
200

OK

202

Request has been queued for execution.

default

All client errors (400–499) are returned with the associated HTTP status codes. All server errors (≥500) are returned with the 520 HTTP status code. For details, see the response body.

get/infrastructure/sites/hardwarePlans/{instanceUid}
Request samples
Response samples
application/json
{
  • "data": {
    }
}

Get All Hardware Plan Storage Entities

Returns a collection resource representation of all storage entities in all hardware plans.

Request
query Parameters
Array of objects or null (FilterParameter)

Specifies the conditions that a resource must meet to be returned in the output.

Array of objects or null (SortParameter)

Specifies the order in which resources are returned from the collection.

limit
integer <int32> [ 1 .. 500 ]
Default: 100

Specifies the first N resources that must be returned in the output.

offset
integer <int32> [ 0 .. 2147483647 ]
Default: 0

Excludes the first N resources from the query output.

Array of objects or null (SelectParameter)

Returns explicitly requested properties.

header Parameters
X-Request-id
string <uuid>

Random UID that you can assign to a request for idempotence and async action progress tracking.

Note that an operation is idempotent only during 5 minute time interval.

Example: ba547d14-c556-42bb-b85c-eeeb16e2f5e7
X-Client-Version
string

Version of Veeam Service Provider Console RESTful API supported by client.

Example: 3.6.1
Responses
200

OK

202

Request has been queued for execution.

default

All client errors (400–499) are returned with the associated HTTP status codes. All server errors (≥500) are returned with the 520 HTTP status code. For details, see the response body.

get/infrastructure/sites/hardwarePlans/storages
Request samples
Response samples
application/json
{
  • "data": [
    ],
  • "meta": {
    }
}

Get All Hardware Plan Storage Entities

Returns a collection resource representation of all storage entities in a hardware plan with the specified UID.

Request
path Parameters
instanceUid
required
string <uuid>

Hardware plan UID.

query Parameters
Array of objects or null (FilterParameter)

Specifies the conditions that a resource must meet to be returned in the output.

Array of objects or null (SortParameter)

Specifies the order in which resources are returned from the collection.

limit
integer <int32> [ 1 .. 500 ]
Default: 100

Specifies the first N resources that must be returned in the output.

offset
integer <int32> [ 0 .. 2147483647 ]
Default: 0

Excludes the first N resources from the query output.

Array of objects or null (SelectParameter)

Returns explicitly requested properties.

header Parameters
X-Request-id
string <uuid>

Random UID that you can assign to a request for idempotence and async action progress tracking.

Note that an operation is idempotent only during 5 minute time interval.

Example: ba547d14-c556-42bb-b85c-eeeb16e2f5e7
X-Client-Version
string

Version of Veeam Service Provider Console RESTful API supported by client.

Example: 3.6.1
Responses
200

OK

202

Request has been queued for execution.

default

All client errors (400–499) are returned with the associated HTTP status codes. All server errors (≥500) are returned with the 520 HTTP status code. For details, see the response body.

get/infrastructure/sites/hardwarePlans/{instanceUid}/storages
Request samples
Response samples
application/json
{
  • "data": [
    ],
  • "meta": {
    }
}

Get All Cloud Gateway Pools

Returns a collection resource representation of all cloud gateway pools.

Request
query Parameters
Array of objects or null (FilterParameter)

Specifies the conditions that a resource must meet to be returned in the output.

Array of objects or null (SortParameter)

Specifies the order in which resources are returned from the collection.

limit
integer <int32> [ 1 .. 500 ]
Default: 100

Specifies the first N resources that must be returned in the output.

offset
integer <int32> [ 0 .. 2147483647 ]
Default: 0

Excludes the first N resources from the query output.

Array of objects or null (SelectParameter)

Returns explicitly requested properties.

header Parameters
X-Request-id
string <uuid>

Random UID that you can assign to a request for idempotence and async action progress tracking.

Note that an operation is idempotent only during 5 minute time interval.

Example: ba547d14-c556-42bb-b85c-eeeb16e2f5e7
X-Client-Version
string

Version of Veeam Service Provider Console RESTful API supported by client.

Example: 3.6.1
Responses
200

OK

202

Request has been queued for execution.

default

All client errors (400–499) are returned with the associated HTTP status codes. All server errors (≥500) are returned with the 520 HTTP status code. For details, see the response body.

get/infrastructure/sites/cloudgatewaypools
Request samples
Response samples
application/json
{
  • "data": [
    ],
  • "meta": {
    }
}

Get All Cloud Gateway Pools Configured for Site

Returns a collection resource representation of all cloud gateway pools configured for a Veeam Cloud Connect site with the specified UID.

Request
path Parameters
siteUid
required
string <uuid>

Veeam Cloud Connect site UID.

query Parameters
Array of objects or null (FilterParameter)

Specifies the conditions that a resource must meet to be returned in the output.

Array of objects or null (SortParameter)

Specifies the order in which resources are returned from the collection.

limit
integer <int32> [ 1 .. 500 ]
Default: 100

Specifies the first N resources that must be returned in the output.

offset
integer <int32> [ 0 .. 2147483647 ]
Default: 0

Excludes the first N resources from the query output.

Array of objects or null (SelectParameter)

Returns explicitly requested properties.

header Parameters
X-Request-id
string <uuid>

Random UID that you can assign to a request for idempotence and async action progress tracking.

Note that an operation is idempotent only during 5 minute time interval.

Example: ba547d14-c556-42bb-b85c-eeeb16e2f5e7
X-Client-Version
string

Version of Veeam Service Provider Console RESTful API supported by client.

Example: 3.6.1
Responses
200

OK

202

Request has been queued for execution.

default

All client errors (400–499) are returned with the associated HTTP status codes. All server errors (≥500) are returned with the 520 HTTP status code. For details, see the response body.

get/infrastructure/sites/{siteUid}/cloudgatewaypools
Request samples
Response samples
application/json
{
  • "data": [
    ],
  • "meta": {
    }
}

Get Cloud Gateway Pool

Returns a resource representation of a cloud gateway pool with the specified UID.

Request
path Parameters
instanceUid
required
string <uuid>

Cloud gateway pool UID.

query Parameters
Array of objects or null (SelectParameter)

Returns explicitly requested properties.

header Parameters
X-Request-id
string <uuid>

Random UID that you can assign to a request for idempotence and async action progress tracking.

Note that an operation is idempotent only during 5 minute time interval.

Example: ba547d14-c556-42bb-b85c-eeeb16e2f5e7
X-Client-Version
string

Version of Veeam Service Provider Console RESTful API supported by client.

Example: 3.6.1
Responses
200

OK

202

Request has been queued for execution.

default

All client errors (400–499) are returned with the associated HTTP status codes. All server errors (≥500) are returned with the 520 HTTP status code. For details, see the response body.

get/infrastructure/sites/cloudgatewaypools/{instanceUid}
Request samples
Response samples
application/json
{
  • "data": {
    }
}

Get All Cloud Gateways in Pool

Returns a collection resource representation of all cloud gateways included in a pool with the specified UID.

Request
path Parameters
instanceUid
required
string <uuid>

Cloud gateway pool UID.

query Parameters
Array of objects or null (FilterParameter)

Specifies the conditions that a resource must meet to be returned in the output.

Array of objects or null (SortParameter)

Specifies the order in which resources are returned from the collection.

limit
integer <int32> [ 1 .. 500 ]
Default: 100

Specifies the first N resources that must be returned in the output.

offset
integer <int32> [ 0 .. 2147483647 ]
Default: 0

Excludes the first N resources from the query output.

Array of objects or null (SelectParameter)

Returns explicitly requested properties.

header Parameters
X-Request-id
string <uuid>

Random UID that you can assign to a request for idempotence and async action progress tracking.

Note that an operation is idempotent only during 5 minute time interval.

Example: ba547d14-c556-42bb-b85c-eeeb16e2f5e7
X-Client-Version
string

Version of Veeam Service Provider Console RESTful API supported by client.

Example: 3.6.1
Responses
200

OK

202

Request has been queued for execution.

default

All client errors (400–499) are returned with the associated HTTP status codes. All server errors (≥500) are returned with the 520 HTTP status code. For details, see the response body.

get/infrastructure/sites/cloudgatewaypools/{instanceUid}/cloudgateways
Request samples
Response samples
application/json
{
  • "data": [
    ],
  • "meta": {
    }
}

Get All Cloud Gateways

Returns a collection resource representation of all cloud gateways.

Request
query Parameters
Array of objects or null (FilterParameter)

Specifies the conditions that a resource must meet to be returned in the output.

Array of objects or null (SortParameter)

Specifies the order in which resources are returned from the collection.

limit
integer <int32> [ 1 .. 500 ]
Default: 100

Specifies the first N resources that must be returned in the output.

offset
integer <int32> [ 0 .. 2147483647 ]
Default: 0

Excludes the first N resources from the query output.

Array of objects or null (SelectParameter)

Returns explicitly requested properties.

header Parameters
X-Request-id
string <uuid>

Random UID that you can assign to a request for idempotence and async action progress tracking.

Note that an operation is idempotent only during 5 minute time interval.

Example: ba547d14-c556-42bb-b85c-eeeb16e2f5e7
X-Client-Version
string

Version of Veeam Service Provider Console RESTful API supported by client.

Example: 3.6.1
Responses
200

OK

202

Request has been queued for execution.

default

All client errors (400–499) are returned with the associated HTTP status codes. All server errors (≥500) are returned with the 520 HTTP status code. For details, see the response body.

get/infrastructure/sites/cloudgateways
Request samples
Response samples
application/json
{
  • "data": [
    ],
  • "meta": {
    }
}

Get All Cloud Gateways Configured for Site

Returns a collection resource representation of all cloud gateways configured for a Veeam Cloud Connect site with the specified UID.

Request
path Parameters
siteUid
required
string <uuid>

Veeam Cloud Connect site UID.

query Parameters
Array of objects or null (FilterParameter)

Specifies the conditions that a resource must meet to be returned in the output.

Array of objects or null (SortParameter)

Specifies the order in which resources are returned from the collection.

limit
integer <int32> [ 1 .. 500 ]
Default: 100

Specifies the first N resources that must be returned in the output.

offset
integer <int32> [ 0 .. 2147483647 ]
Default: 0

Excludes the first N resources from the query output.

Array of objects or null (SelectParameter)

Returns explicitly requested properties.

header Parameters
X-Request-id
string <uuid>

Random UID that you can assign to a request for idempotence and async action progress tracking.

Note that an operation is idempotent only during 5 minute time interval.

Example: ba547d14-c556-42bb-b85c-eeeb16e2f5e7
X-Client-Version
string

Version of Veeam Service Provider Console RESTful API supported by client.

Example: 3.6.1
Responses
200

OK

202

Request has been queued for execution.

default

All client errors (400–499) are returned with the associated HTTP status codes. All server errors (≥500) are returned with the 520 HTTP status code. For details, see the response body.

get/infrastructure/sites/{siteUid}/cloudgateways
Request samples
Response samples
application/json
{
  • "data": [
    ],
  • "meta": {
    }
}

Get Cloud Gateway

Returns a resource representation of a cloud gateway with the specified UID.

Request
path Parameters
gatewayUid
required
string <uuid>

Cloud gateway pool UID.

query Parameters
Array of objects or null (SelectParameter)

Returns explicitly requested properties.

header Parameters
X-Request-id
string <uuid>

Random UID that you can assign to a request for idempotence and async action progress tracking.

Note that an operation is idempotent only during 5 minute time interval.

Example: ba547d14-c556-42bb-b85c-eeeb16e2f5e7
X-Client-Version
string

Version of Veeam Service Provider Console RESTful API supported by client.

Example: 3.6.1
Responses
200

OK

202

Request has been queued for execution.

default

All client errors (400–499) are returned with the associated HTTP status codes. All server errors (≥500) are returned with the 520 HTTP status code. For details, see the response body.

get/infrastructure/sites/cloudgateways/{gatewayUid}
Request samples
Response samples
application/json
{
  • "data": {
    }
}

Get All Wan Accelerators

Returns a collection resource representation of all WAN accelerators.

Request
query Parameters
Array of objects or null (FilterParameter)

Specifies the conditions that a resource must meet to be returned in the output.

Array of objects or null (SortParameter)

Specifies the order in which resources are returned from the collection.

limit
integer <int32> [ 1 .. 500 ]
Default: 100

Specifies the first N resources that must be returned in the output.

offset
integer <int32> [ 0 .. 2147483647 ]
Default: 0

Excludes the first N resources from the query output.

Array of objects or null (SelectParameter)

Returns explicitly requested properties.

header Parameters
X-Request-id
string <uuid>

Random UID that you can assign to a request for idempotence and async action progress tracking.

Note that an operation is idempotent only during 5 minute time interval.

Example: ba547d14-c556-42bb-b85c-eeeb16e2f5e7
X-Client-Version
string

Version of Veeam Service Provider Console RESTful API supported by client.

Example: 3.6.1
Responses
200

OK

202

Request has been queued for execution.

default

All client errors (400–499) are returned with the associated HTTP status codes. All server errors (≥500) are returned with the 520 HTTP status code. For details, see the response body.

get/infrastructure/sites/wanAccelerators
Request samples
Response samples
application/json
{
  • "data": [
    ],
  • "meta": {
    }
}

Get All Wan Accelerators Configured for Site

Returns a collection resource representation of all WAN accelerators configured for a Veeam Cloud Connect site with the specified UID.

Request
path Parameters
siteUid
required
string <uuid>

Veeam Cloud Connect site UID.

query Parameters
Array of objects or null (FilterParameter)

Specifies the conditions that a resource must meet to be returned in the output.

Array of objects or null (SortParameter)

Specifies the order in which resources are returned from the collection.

limit
integer <int32> [ 1 .. 500 ]
Default: 100

Specifies the first N resources that must be returned in the output.

offset
integer <int32> [ 0 .. 2147483647 ]
Default: 0

Excludes the first N resources from the query output.

Array of objects or null (SelectParameter)

Returns explicitly requested properties.

header Parameters
X-Request-id
string <uuid>

Random UID that you can assign to a request for idempotence and async action progress tracking.

Note that an operation is idempotent only during 5 minute time interval.

Example: ba547d14-c556-42bb-b85c-eeeb16e2f5e7
X-Client-Version
string

Version of Veeam Service Provider Console RESTful API supported by client.

Example: 3.6.1
Responses
200

OK

202

Request has been queued for execution.

default

All client errors (400–499) are returned with the associated HTTP status codes. All server errors (≥500) are returned with the 520 HTTP status code. For details, see the response body.

get/infrastructure/sites/{siteUid}/wanAccelerators
Request samples
Response samples
application/json
{
  • "data": [
    ],
  • "meta": {
    }
}

Get Wan Accelerator

Returns a resource representation of a WAN accelerator with the specified UID.

Request
path Parameters
wanAcceleratorUid
required
string <uuid>

WAN accelerator UID.

query Parameters
Array of objects or null (SelectParameter)

Returns explicitly requested properties.

header Parameters
X-Request-id
string <uuid>

Random UID that you can assign to a request for idempotence and async action progress tracking.

Note that an operation is idempotent only during 5 minute time interval.

Example: ba547d14-c556-42bb-b85c-eeeb16e2f5e7
X-Client-Version
string

Version of Veeam Service Provider Console RESTful API supported by client.

Example: 3.6.1
Responses
200

OK

202

Request has been queued for execution.

default

All client errors (400–499) are returned with the associated HTTP status codes. All server errors (≥500) are returned with the 520 HTTP status code. For details, see the response body.

get/infrastructure/sites/wanAccelerators/{wanAcceleratorUid}
Request samples
Response samples
application/json
{
  • "data": {
    }
}

Get All Site Backups

Returns a collection resource representation of backups created by all Veeam Cloud Connect sites.

Request
query Parameters
Array of objects or null (FilterParameter)

Specifies the conditions that a resource must meet to be returned in the output.

Array of objects or null (SortParameter)

Specifies the order in which resources are returned from the collection.

limit
integer <int32> [ 1 .. 500 ]
Default: 100

Specifies the first N resources that must be returned in the output.

offset
integer <int32> [ 0 .. 2147483647 ]
Default: 0

Excludes the first N resources from the query output.

Array of objects or null (SelectParameter)

Returns explicitly requested properties.

header Parameters
X-Request-id
string <uuid>

Random UID that you can assign to a request for idempotence and async action progress tracking.

Note that an operation is idempotent only during 5 minute time interval.

Example: ba547d14-c556-42bb-b85c-eeeb16e2f5e7
X-Client-Version
string

Version of Veeam Service Provider Console RESTful API supported by client.

Example: 3.6.1
Responses
200

OK

202

Request has been queued for execution.

default

All client errors (400–499) are returned with the associated HTTP status codes. All server errors (≥500) are returned with the 520 HTTP status code. For details, see the response body.

get/infrastructure/sites/backups
Request samples
Response samples
application/json
{
  • "data": [
    ],
  • "meta": {
    }
}

Get Site Backup

Returns a resource representation of a backup with the specified UID created by a Veeam Cloud Connect site.

Request
path Parameters
backupUid
required
string <uuid>

UID assigned to a backup.

query Parameters
Array of objects or null (SelectParameter)

Returns explicitly requested properties.

header Parameters
X-Request-id
string <uuid>

Random UID that you can assign to a request for idempotence and async action progress tracking.

Note that an operation is idempotent only during 5 minute time interval.

Example: ba547d14-c556-42bb-b85c-eeeb16e2f5e7
X-Client-Version
string

Version of Veeam Service Provider Console RESTful API supported by client.

Example: 3.6.1
Responses
200

OK

202

Request has been queued for execution.

default

All client errors (400–499) are returned with the associated HTTP status codes. All server errors (≥500) are returned with the 520 HTTP status code. For details, see the response body.

get/infrastructure/sites/backups/{backupUid}
Request samples
Response samples
application/json
{
  • "data": {
    }
}

Get All Backups Created by Site

Returns a collection resource representation of all backups created by a Veeam Cloud Connect site with the specified UID.

Request
path Parameters
siteUid
required
string <uuid>

Veeam Cloud Connect site UID.

query Parameters
Array of objects or null (FilterParameter)

Specifies the conditions that a resource must meet to be returned in the output.

Array of objects or null (SortParameter)

Specifies the order in which resources are returned from the collection.

limit
integer <int32> [ 1 .. 500 ]
Default: 100

Specifies the first N resources that must be returned in the output.

offset
integer <int32> [ 0 .. 2147483647 ]
Default: 0

Excludes the first N resources from the query output.

Array of objects or null (SelectParameter)

Returns explicitly requested properties.

header Parameters
X-Request-id
string <uuid>

Random UID that you can assign to a request for idempotence and async action progress tracking.

Note that an operation is idempotent only during 5 minute time interval.

Example: ba547d14-c556-42bb-b85c-eeeb16e2f5e7
X-Client-Version
string

Version of Veeam Service Provider Console RESTful API supported by client.

Example: 3.6.1
Responses
200

OK

202

Request has been queued for execution.

default

All client errors (400–499) are returned with the associated HTTP status codes. All server errors (≥500) are returned with the 520 HTTP status code. For details, see the response body.

get/infrastructure/sites/{siteUid}/backups
Request samples
Response samples
application/json
{
  • "data": [
    ],
  • "meta": {
    }
}

Get All Tenants

Returns a collection resource representation of all tenants.

Request
query Parameters
Array of objects or null (FilterParameter)

Specifies the conditions that a resource must meet to be returned in the output.

Array of objects or null (SortParameter)

Specifies the order in which resources are returned from the collection.

limit
integer <int32> [ 1 .. 500 ]
Default: 100

Specifies the first N resources that must be returned in the output.

offset
integer <int32> [ 0 .. 2147483647 ]
Default: 0

Excludes the first N resources from the query output.

Array of objects or null (SelectParameter)

Returns explicitly requested properties.

header Parameters
X-Request-id
string <uuid>

Random UID that you can assign to a request for idempotence and async action progress tracking.

Note that an operation is idempotent only during 5 minute time interval.

Example: ba547d14-c556-42bb-b85c-eeeb16e2f5e7
X-Client-Version
string

Version of Veeam Service Provider Console RESTful API supported by client.

Example: 3.6.1
Responses
200

OK

202

Request has been queued for execution.

default

All client errors (400–499) are returned with the associated HTTP status codes. All server errors (≥500) are returned with the 520 HTTP status code. For details, see the response body.

get/infrastructure/sites/tenants
Request samples
Response samples
application/json
{
  • "data": [
    ],
  • "meta": {
    }
}

Get All Tenants Registered on Site

Returns a collection resource representation of tenants registered on a Veeam Cloud Connect site with the specified UID.

Request
path Parameters
siteUid
required
string <uuid>

Veeam Cloud Connect site UID.

query Parameters
Array of objects or null (FilterParameter)

Specifies the conditions that a resource must meet to be returned in the output.

Array of objects or null (SortParameter)

Specifies the order in which resources are returned from the collection.

limit
integer <int32> [ 1 .. 500 ]
Default: 100

Specifies the first N resources that must be returned in the output.

offset
integer <int32> [ 0 .. 2147483647 ]
Default: 0

Excludes the first N resources from the query output.

Array of objects or null (SelectParameter)

Returns explicitly requested properties.

header Parameters
X-Request-id
string <uuid>

Random UID that you can assign to a request for idempotence and async action progress tracking.

Note that an operation is idempotent only during 5 minute time interval.

Example: ba547d14-c556-42bb-b85c-eeeb16e2f5e7
X-Client-Version
string

Version of Veeam Service Provider Console RESTful API supported by client.

Example: 3.6.1
Responses
200

OK

202

Request has been queued for execution.

default

All client errors (400–499) are returned with the associated HTTP status codes. All server errors (≥500) are returned with the 520 HTTP status code. For details, see the response body.

get/infrastructure/sites/{siteUid}/tenants
Request samples
Response samples
application/json
{
  • "data": [
    ],
  • "meta": {
    }
}

Create Tenant on Site

Creates a new tenant on a Veeam Cloud Connect site with the specified UID.

Request
path Parameters
siteUid
required
string <uuid>

Veeam Cloud Connect site UID.

query Parameters
Array of objects or null (SelectParameter)

Returns explicitly requested properties.

header Parameters
X-Request-id
string <uuid>

Random UID that you can assign to a request for idempotence and async action progress tracking.

Note that an operation is idempotent only during 5 minute time interval.

Example: ba547d14-c556-42bb-b85c-eeeb16e2f5e7
X-Client-Version
string

Version of Veeam Service Provider Console RESTful API supported by client.

Example: 3.6.1
Request Body schema: application/json
required

Tenant properties.

required
object

Credentials or user name of a tenant account configured for a VMware Cloud Director organization.

The user name becomes tenant name on tenant creation.

type
string
Default: "General"

Type of a tenant account.

Enum: "Unknown" "General" "VCD"
vCloudOrganizationUid
string or null <uuid>

UID assigned to a VMware Cloud Director organization.

isLeaseExpirationEnabled
boolean
Default: false

Indicates whether a tenant account must be disabled automatically.

leaseExpirationDate
string or null <date-time>

Date and time when a company account must be disabled.

description
string or null

Description of a tenant account.

isThrottlingEnabled
boolean
Default: false

Indicates whether incoming network traffic that will be accepted from a tenant is limited.

throttlingValue
integer or null <int32> [ 1 .. 9999 ]
Default: 1

Maximum incoming network traffic bandwidth that will be accepted from a tenant.

If throttling is disabled, the property value is null.

throttlingUnit
string or null
Default: "MbytePerSec"

Measurement units of incoming network traffic accepted from a company.

If throttling is disabled, the property value is null.

Enum: "MbitPerSec" "KbytePerSec" "MbytePerSec"
maxConcurrentTask
integer <int32> [ 1 .. 10000 ]
Default: 1

Maximum number of concurrent tasks available to a tenant.

isBackupProtectionEnabled
boolean
Default: false

Indicates whether deleted backup file protection is enabled.

backupProtectionPeriod
integer or null <int32> [ 1 .. 99 ]
Default: 7

Number of days during which deleted backup files must be kept in the recycle bin on the Veeam Cloud Connect server.

gatewaySelectionType
string
Default: "StandaloneGateways"

Type of gateway selection.

Enum: "Unknown" "StandaloneGateways" "GatewayPool"
gatewayPoolsUids
Array of strings or null <uuid> unique

Collection of UIDs assigned to gateway pools that are allocated to a company.

If the collection is empty, company will automatically use a standalone gateway.

isGatewayFailoverEnabled
boolean
Default: false

Indicates whether a tenant is allowed to fail over to a cloud gateway that is not added to a selected cloud gateway pool.

isNativeReplicationResourcesEnabled
boolean
Default: false

Indicates whether cloud replication resources are allocated to a tenant.

isVcdReplicationResourcesEnabled
boolean
Default: false

Indicates whether organization VDCs are allocated to a tenant as cloud hosts.

assignedForCompany
string or null <uuid>

UID of a company to which a tenant is assigned.

For reseller users, the property value is required.

Responses
200

OK

202

Request has been queued for execution.

default

All client errors (400–499) are returned with the associated HTTP status codes. All server errors (≥500) are returned with the 520 HTTP status code. For details, see the response body.

post/infrastructure/sites/{siteUid}/tenants
Request samples
application/json
{
  • "type": "General",
  • "vCloudOrganizationUid": null,
  • "isLeaseExpirationEnabled": false,
  • "leaseExpirationDate": null,
  • "credentials": {
    },
  • "description": "Tenant for Alpha company",
  • "isThrottlingEnabled": false,
  • "throttlingValue": null,
  • "throttlingUnit": null,
  • "maxConcurrentTask": 1,
  • "isBackupProtectionEnabled": false,
  • "backupProtectionPeriod": null,
  • "gatewaySelectionType": "StandaloneGateways",
  • "gatewayPoolsUids": [ ],
  • "isGatewayFailoverEnabled": false,
  • "isNativeReplicationResourcesEnabled": false,
  • "isVcdReplicationResourcesEnabled": false,
  • "assignedForCompany": null
}
Response samples
application/json
{
  • "data": {
    }
}

Get Tenant

Returns a resource representation of a tenant with the specified UID.

Request
path Parameters
tenantUid
required
string <uuid>

Tenant UID.

query Parameters
Array of objects or null (SelectParameter)

Returns explicitly requested properties.

header Parameters
X-Request-id
string <uuid>

Random UID that you can assign to a request for idempotence and async action progress tracking.

Note that an operation is idempotent only during 5 minute time interval.

Example: ba547d14-c556-42bb-b85c-eeeb16e2f5e7
X-Client-Version
string

Version of Veeam Service Provider Console RESTful API supported by client.

Example: 3.6.1
Responses
200

OK

202

Request has been queued for execution.

default

All client errors (400–499) are returned with the associated HTTP status codes. All server errors (≥500) are returned with the 520 HTTP status code. For details, see the response body.

get/infrastructure/sites/tenants/{tenantUid}
Request samples
Response samples
application/json
{
  • "data": {
    }
}

Modify Tenant

Modifies a tenant with the specified UID.

Request
path Parameters
tenantUid
required
string <uuid>

Tenant UID.

query Parameters
Array of objects or null (SelectParameter)

Returns explicitly requested properties.

header Parameters
X-Request-id
string <uuid>

Random UID that you can assign to a request for idempotence and async action progress tracking.

Note that an operation is idempotent only during 5 minute time interval.

Example: ba547d14-c556-42bb-b85c-eeeb16e2f5e7
X-Client-Version
string

Version of Veeam Service Provider Console RESTful API supported by client.

Example: 3.6.1
Request Body schema: application/json
required

Array of JSON Patch operations according to RFC 6902.

Array
op
required
string

Performed operation.

Enum: "add" "replace" "test" "remove" "move" "copy"
value
required
string

Value that is added, replaced, tested or removed by the PATCH operation.

path
required
string

JSON Pointer containing path to a target location where the PATCH operation is performed.

from
string or null

JSON Pointer containing path to a location from which data is moved or copied.

Responses
200

OK

202

Request has been queued for execution.

default

All client errors (400–499) are returned with the associated HTTP status codes. All server errors (≥500) are returned with the 520 HTTP status code. For details, see the response body.

patch/infrastructure/sites/tenants/{tenantUid}
Request samples
application/json
[
  • {
    }
]
Response samples
application/json
{
  • "data": {
    }
}

Delete Tenant

Deletes a tenant with the specified UID.

Request
path Parameters
tenantUid
required
string <uuid>

Tenant UID.

query Parameters
deleteBackups
required
boolean

Defines if all backup files of a tenant must be deleted.

header Parameters
X-Request-id
string <uuid>

Random UID that you can assign to a request for idempotence and async action progress tracking.

Note that an operation is idempotent only during 5 minute time interval.

Example: ba547d14-c556-42bb-b85c-eeeb16e2f5e7
X-Client-Version
string

Version of Veeam Service Provider Console RESTful API supported by client.

Example: 3.6.1
Responses
200

OK

202

Request has been queued for execution.

default

All client errors (400–499) are returned with the associated HTTP status codes. All server errors (≥500) are returned with the 520 HTTP status code. For details, see the response body.

delete/infrastructure/sites/tenants/{tenantUid}
Request samples
Response samples
application/json
{
  • "errors": [
    ],
  • "data": { },
  • "meta": {
    }
}

Enable Cloud Tenant

Enables a cloud tenant with the specified UID.

Request
path Parameters
tenantUid
required
string <uuid>

Tenant UID.

query Parameters
Array of objects or null (SelectParameter)

Returns explicitly requested properties.

header Parameters
X-Request-id
string <uuid>

Random UID that you can assign to a request for idempotence and async action progress tracking.

Note that an operation is idempotent only during 5 minute time interval.

Example: ba547d14-c556-42bb-b85c-eeeb16e2f5e7
X-Client-Version
string

Version of Veeam Service Provider Console RESTful API supported by client.

Example: 3.6.1
Responses
200

OK

202

Request has been queued for execution.

default

All client errors (400–499) are returned with the associated HTTP status codes. All server errors (≥500) are returned with the 520 HTTP status code. For details, see the response body.

post/infrastructure/sites/tenants/{tenantUid}/enable
Request samples
Response samples
application/json
{
  • "data": {
    }
}

Disable Cloud Tenant

Disables a cloud tenant with the specified UID.

Request
path Parameters
tenantUid
required
string <uuid>

Tenant UID.

query Parameters
Array of objects or null (SelectParameter)

Returns explicitly requested properties.

header Parameters
X-Request-id
string <uuid>

Random UID that you can assign to a request for idempotence and async action progress tracking.

Note that an operation is idempotent only during 5 minute time interval.

Example: ba547d14-c556-42bb-b85c-eeeb16e2f5e7
X-Client-Version
string

Version of Veeam Service Provider Console RESTful API supported by client.

Example: 3.6.1
Responses
200

OK

202

Request has been queued for execution.

default

All client errors (400–499) are returned with the associated HTTP status codes. All server errors (≥500) are returned with the 520 HTTP status code. For details, see the response body.

post/infrastructure/sites/tenants/{tenantUid}/disable
Request samples
Response samples
application/json
{
  • "data": {
    }
}

Get All Tenant Backup Resources

Returns a collection resource representation of all tenant cloud backup resources.

Request
query Parameters
Array of objects or null (FilterParameter)

Specifies the conditions that a resource must meet to be returned in the output.

Array of objects or null (SortParameter)

Specifies the order in which resources are returned from the collection.

limit
integer <int32> [ 1 .. 500 ]
Default: 100

Specifies the first N resources that must be returned in the output.

offset
integer <int32> [ 0 .. 2147483647 ]
Default: 0

Excludes the first N resources from the query output.

Array of objects or null (SelectParameter)

Returns explicitly requested properties.

header Parameters
X-Request-id
string <uuid>

Random UID that you can assign to a request for idempotence and async action progress tracking.

Note that an operation is idempotent only during 5 minute time interval.

Example: ba547d14-c556-42bb-b85c-eeeb16e2f5e7
X-Client-Version
string

Version of Veeam Service Provider Console RESTful API supported by client.

Example: 3.6.1
Responses
200

OK

202

Request has been queued for execution.

default

All client errors (400–499) are returned with the associated HTTP status codes. All server errors (≥500) are returned with the 520 HTTP status code. For details, see the response body.

get/infrastructure/sites/tenants/backupResources
Request samples
Response samples
application/json
{
  • "data": [
    ],
  • "meta": {
    }
}

Get All Backup Resources Allocated to Tenant

Returns a collection resource representation of all cloud backup resources allocated to a tenant with the specified UID.

Request
path Parameters
tenantUid
required
string <uuid>

Tenant UID.

query Parameters
Array of objects or null (FilterParameter)

Specifies the conditions that a resource must meet to be returned in the output.

Array of objects or null (SortParameter)

Specifies the order in which resources are returned from the collection.

limit
integer <int32> [ 1 .. 500 ]
Default: 100

Specifies the first N resources that must be returned in the output.

offset
integer <int32> [ 0 .. 2147483647 ]
Default: 0

Excludes the first N resources from the query output.

Array of objects or null (SelectParameter)

Returns explicitly requested properties.

header Parameters
X-Request-id
string <uuid>

Random UID that you can assign to a request for idempotence and async action progress tracking.

Note that an operation is idempotent only during 5 minute time interval.

Example: ba547d14-c556-42bb-b85c-eeeb16e2f5e7
X-Client-Version
string

Version of Veeam Service Provider Console RESTful API supported by client.

Example: 3.6.1
Responses
200

OK

202

Request has been queued for execution.

default

All client errors (400–499) are returned with the associated HTTP status codes. All server errors (≥500) are returned with the 520 HTTP status code. For details, see the response body.

get/infrastructure/sites/tenants/{tenantUid}/backupResources
Request samples
Response samples
application/json
{
  • "data": [
    ],
  • "meta": {
    }
}

Create Tenant Backup Resource

Allocate a new cloud backup resource to a tenant with the specified UID.

Request
path Parameters
tenantUid
required
string <uuid>

Tenant UID.

query Parameters
Array of objects or null (SelectParameter)

Returns explicitly requested properties.

header Parameters
X-Request-id
string <uuid>

Random UID that you can assign to a request for idempotence and async action progress tracking.

Note that an operation is idempotent only during 5 minute time interval.

Example: ba547d14-c556-42bb-b85c-eeeb16e2f5e7
X-Client-Version
string

Version of Veeam Service Provider Console RESTful API supported by client.

Example: 3.6.1
Request Body schema: application/json
required

Cloud backup resource properties.

repositoryUid
required
string <uuid>

UID assigned to a cloud repository.

cloudRepositoryName
required
string

Name of a cloud backup repository.

storageQuota
required
integer <int64> [ 1073741824 .. 1124774006935781400 ]

Amount of space allocated to a company on a cloud repository, in bytes.

serversQuota
integer or null <int32>

Maximum number of Veeam backup agents in the Server mode that a company is allowed to store on a cloud repository.

isServersQuotaUnlimited
boolean
Default: true

Indicates whether a company is allowed to store an unlimited number of Veeam backup agents in the Server mode on a cloud repository.

workstationsQuota
integer or null <int32>

Maximum number of Veeam backup agents in the Workstation mode that a company is allowed to store on a cloud repository.

isWorkstationsQuotaUnlimited
boolean
Default: true

Indicates whether a company is allowed to store an unlimited number of Veeam backup agents in the Workstation mode on a cloud repository.

vmsQuota
integer or null <int32>

Maximum number of VMs that a company is allowed to store on a cloud repository.

isVmsQuotaUnlimited
boolean
Default: true

Indicates whether a company is allowed to store an unlimited number of VMs on a cloud repository.

isWanAccelerationEnabled
boolean
Default: false

Indicates whether WAN acceleration is enabled.

wanAcceleratorUid
string or null <uuid>

UID assigned to a WAN accelerator.

isDefault
boolean
Default: false

Defines whether a cloud repository is set by default.

Responses
200

OK

202

Request has been queued for execution.

default

All client errors (400–499) are returned with the associated HTTP status codes. All server errors (≥500) are returned with the 520 HTTP status code. For details, see the response body.

post/infrastructure/sites/tenants/{tenantUid}/backupResources
Request samples
application/json
{
  • "repositoryUid": "ae61e533-82c7-4cb6-a030-78ae589cf49d",
  • "cloudRepositoryName": "repo1",
  • "storageQuota": 1073741824,
  • "serversQuota": 1,
  • "isServersQuotaUnlimited": false,
  • "workstationsQuota": 1,
  • "isWorkstationsQuotaUnlimited": false,
  • "vmsQuota": 1,
  • "isVmsQuotaUnlimited": false,
  • "isWanAccelerationEnabled": true,
  • "wanAcceleratorUid": "d60543b8-9a53-473a-8e4c-cfdc374286cf",
  • "isDefault": false
}
Response samples
application/json
{
  • "data": {
    }
}

Get Usage of All Backup Resources Allocated to Tenant

Returns a resource representation of cloud backup resource usage by a tenant with the specified UID.

Request
path Parameters
tenantUid
required
string <uuid>

Tenant UID.

query Parameters
Array of objects or null (FilterParameter)

Specifies the conditions that a resource must meet to be returned in the output.

Array of objects or null (SortParameter)

Specifies the order in which resources are returned from the collection.

limit
integer <int32> [ 1 .. 500 ]
Default: 100

Specifies the first N resources that must be returned in the output.

offset
integer <int32> [ 0 .. 2147483647 ]
Default: 0

Excludes the first N resources from the query output.

Array of objects or null (SelectParameter)

Returns explicitly requested properties.

header Parameters
X-Request-id
string <uuid>

Random UID that you can assign to a request for idempotence and async action progress tracking.

Note that an operation is idempotent only during 5 minute time interval.

Example: ba547d14-c556-42bb-b85c-eeeb16e2f5e7
X-Client-Version
string

Version of Veeam Service Provider Console RESTful API supported by client.

Example: 3.6.1
Responses
200

OK

202

Request has been queued for execution.

default

All client errors (400–499) are returned with the associated HTTP status codes. All server errors (≥500) are returned with the 520 HTTP status code. For details, see the response body.

get/infrastructure/sites/tenants/{tenantUid}/backupResources/usage
Request samples
Response samples
application/json
{
  • "data": [
    ],
  • "meta": {
    }
}

Get Usage of All Tenant Backup Resources

Returns a collection resource representation of cloud backup resource usage by all tenants.

Request
query Parameters
Array of objects or null (FilterParameter)

Specifies the conditions that a resource must meet to be returned in the output.

Array of objects or null (SortParameter)

Specifies the order in which resources are returned from the collection.

limit
integer <int32> [ 1 .. 500 ]
Default: 100

Specifies the first N resources that must be returned in the output.

offset
integer <int32> [ 0 .. 2147483647 ]
Default: 0

Excludes the first N resources from the query output.

Array of objects or null (SelectParameter)

Returns explicitly requested properties.

header Parameters
X-Request-id
string <uuid>

Random UID that you can assign to a request for idempotence and async action progress tracking.

Note that an operation is idempotent only during 5 minute time interval.

Example: ba547d14-c556-42bb-b85c-eeeb16e2f5e7
X-Client-Version
string

Version of Veeam Service Provider Console RESTful API supported by client.

Example: 3.6.1
Responses
200

OK

202

Request has been queued for execution.

default

All client errors (400–499) are returned with the associated HTTP status codes. All server errors (≥500) are returned with the 520 HTTP status code. For details, see the response body.

get/infrastructure/sites/tenants/backupResources/usage
Request samples
Response samples
application/json
{
  • "data": [
    ],
  • "meta": {
    }
}

Get Tenant Backup Resource

Returns a resource representation of tenant cloud backup resource with the specified UID.

Request
path Parameters
tenantUid
required
string <uuid>

Tenant UID.

resourceUid
required
string <uuid>

Cloud backup resource UID.

query Parameters
Array of objects or null (SelectParameter)

Returns explicitly requested properties.

header Parameters
X-Request-id
string <uuid>

Random UID that you can assign to a request for idempotence and async action progress tracking.

Note that an operation is idempotent only during 5 minute time interval.

Example: ba547d14-c556-42bb-b85c-eeeb16e2f5e7
X-Client-Version
string

Version of Veeam Service Provider Console RESTful API supported by client.

Example: 3.6.1
Responses
200

OK

202

Request has been queued for execution.

default

All client errors (400–499) are returned with the associated HTTP status codes. All server errors (≥500) are returned with the 520 HTTP status code. For details, see the response body.

get/infrastructure/sites/tenants/{tenantUid}/backupResources/{resourceUid}
Request samples
Response samples
application/json
{
  • "data": {
    }
}

Modify Tenant Backup Resource

Modifies a tenant cloud backup resource with the specified UID.

Request
path Parameters
tenantUid
required
string <uuid>

Tenant UID.

resourceUid
required
string <uuid>

Cloud backup resource UID.

query Parameters
Array of objects or null (SelectParameter)

Returns explicitly requested properties.

header Parameters
X-Request-id
string <uuid>

Random UID that you can assign to a request for idempotence and async action progress tracking.

Note that an operation is idempotent only during 5 minute time interval.

Example: ba547d14-c556-42bb-b85c-eeeb16e2f5e7
X-Client-Version
string

Version of Veeam Service Provider Console RESTful API supported by client.

Example: 3.6.1
Request Body schema: application/json
required

Array of JSON Patch operations according to RFC 6902.

Array
op
required
string

Performed operation.

Enum: "add" "replace" "test" "remove" "move" "copy"
value
required
string

Value that is added, replaced, tested or removed by the PATCH operation.

path
required
string

JSON Pointer containing path to a target location where the PATCH operation is performed.

from
string or null

JSON Pointer containing path to a location from which data is moved or copied.

Responses
200

OK

202

Request has been queued for execution.

default

All client errors (400–499) are returned with the associated HTTP status codes. All server errors (≥500) are returned with the 520 HTTP status code. For details, see the response body.

patch/infrastructure/sites/tenants/{tenantUid}/backupResources/{resourceUid}
Request samples
application/json
[
  • {
    }
]
Response samples
application/json
{
  • "data": {
    }
}

Delete Tenant Backup Resource

Deletes a tenant cloud backup resource with the specified UID.

Request
path Parameters
tenantUid
required
string <uuid>

Tenant UID.

resourceUid
required
string <uuid>

Cloud backup resource UID.

header Parameters
X-Request-id
string <uuid>

Random UID that you can assign to a request for idempotence and async action progress tracking.

Note that an operation is idempotent only during 5 minute time interval.

Example: ba547d14-c556-42bb-b85c-eeeb16e2f5e7
X-Client-Version
string

Version of Veeam Service Provider Console RESTful API supported by client.

Example: 3.6.1
Responses
200

OK

202

Request has been queued for execution.

default

All client errors (400–499) are returned with the associated HTTP status codes. All server errors (≥500) are returned with the 520 HTTP status code. For details, see the response body.

delete/infrastructure/sites/tenants/{tenantUid}/backupResources/{resourceUid}
Request samples
Response samples
application/json
{
  • "errors": [
    ],
  • "data": { },
  • "meta": {
    }
}

Get Tenant Traffic Resource

Returns a resource representation of a cloud traffic quota configured for a tenant with the specified UID.

Request
path Parameters
tenantUid
required
string <uuid>

Tenant UID.

query Parameters
Array of objects or null (SelectParameter)

Returns explicitly requested properties.

header Parameters
X-Request-id
string <uuid>

Random UID that you can assign to a request for idempotence and async action progress tracking.

Note that an operation is idempotent only during 5 minute time interval.

Example: ba547d14-c556-42bb-b85c-eeeb16e2f5e7
X-Client-Version
string

Version of Veeam Service Provider Console RESTful API supported by client.

Example: 3.6.1
Responses
200

OK

202

Request has been queued for execution.

default

All client errors (400–499) are returned with the associated HTTP status codes. All server errors (≥500) are returned with the 520 HTTP status code. For details, see the response body.

get/infrastructure/sites/tenants/{tenantUid}/traffic
Request samples
Response samples
application/json
{
  • "data": {
    }
}

Modify Tenant Traffic Resource

Modifies cloud traffic quota configured for a tenant with the specified UID.

Request
path Parameters
tenantUid
required
string <uuid>

Tenant UID.

query Parameters
Array of objects or null (SelectParameter)

Returns explicitly requested properties.

header Parameters
X-Request-id
string <uuid>

Random UID that you can assign to a request for idempotence and async action progress tracking.

Note that an operation is idempotent only during 5 minute time interval.

Example: ba547d14-c556-42bb-b85c-eeeb16e2f5e7
X-Client-Version
string

Version of Veeam Service Provider Console RESTful API supported by client.

Example: 3.6.1
Request Body schema: application/json
required

Array of JSON Patch operations according to RFC 6902.

Array
op
required
string

Performed operation.

Enum: "add" "replace" "test" "remove" "move" "copy"
value
required
string

Value that is added, replaced, tested or removed by the PATCH operation.

path
required
string

JSON Pointer containing path to a target location where the PATCH operation is performed.

from
string or null

JSON Pointer containing path to a location from which data is moved or copied.

Responses
200

OK

202

Request has been queued for execution.

default

All client errors (400–499) are returned with the associated HTTP status codes. All server errors (≥500) are returned with the 520 HTTP status code. For details, see the response body.

patch/infrastructure/sites/tenants/{tenantUid}/traffic
Request samples
application/json
[
  • {
    }
]
Response samples
application/json
{
  • "data": {
    }
}

Get All Tenant Replication Resources

Returns a collection resource representation of all tenant cloud replication resources.

Request
query Parameters
Array of objects or null (FilterParameter)

Specifies the conditions that a resource must meet to be returned in the output.

Array of objects or null (SortParameter)

Specifies the order in which resources are returned from the collection.

limit
integer <int32> [ 1 .. 500 ]
Default: 100

Specifies the first N resources that must be returned in the output.

offset
integer <int32> [ 0 .. 2147483647 ]
Default: 0

Excludes the first N resources from the query output.

Array of objects or null (SelectParameter)

Returns explicitly requested properties.

header Parameters
X-Request-id
string <uuid>

Random UID that you can assign to a request for idempotence and async action progress tracking.

Note that an operation is idempotent only during 5 minute time interval.

Example: ba547d14-c556-42bb-b85c-eeeb16e2f5e7
X-Client-Version
string

Version of Veeam Service Provider Console RESTful API supported by client.

Example: 3.6.1
Responses
200

OK

202

Request has been queued for execution.

default

All client errors (400–499) are returned with the associated HTTP status codes. All server errors (≥500) are returned with the 520 HTTP status code. For details, see the response body.

get/infrastructure/sites/tenants/replicationResources
Request samples
Response samples
application/json
{
  • "data": [
    ],
  • "meta": {
    }
}

Get All Replication Resources Allocated to Tenant

Returns a collection resource representation of all cloud replication resources allocated to a tenant with the specified UID.

Request
path Parameters
tenantUid
required
string <uuid>

Tenant UID.

query Parameters
Array of objects or null (SelectParameter)

Returns explicitly requested properties.

header Parameters
X-Request-id
string <uuid>

Random UID that you can assign to a request for idempotence and async action progress tracking.

Note that an operation is idempotent only during 5 minute time interval.

Example: ba547d14-c556-42bb-b85c-eeeb16e2f5e7
X-Client-Version
string

Version of Veeam Service Provider Console RESTful API supported by client.

Example: 3.6.1
Responses
200

OK

202

Request has been queued for execution.

default

All client errors (400–499) are returned with the associated HTTP status codes. All server errors (≥500) are returned with the 520 HTTP status code. For details, see the response body.

get/infrastructure/sites/tenants/{tenantUid}/replicationResources
Request samples
Response samples
application/json
{
  • "data": {
    }
}

Create Tenant Replication Resource

Allocates a new cloud replication resource to a tenant.

Request
path Parameters
tenantUid
required
string <uuid>

Tenant UID.

query Parameters
Array of objects or null (SelectParameter)

Returns explicitly requested properties.

header Parameters
X-Request-id
string <uuid>

Random UID that you can assign to a request for idempotence and async action progress tracking.

Note that an operation is idempotent only during 5 minute time interval.

Example: ba547d14-c556-42bb-b85c-eeeb16e2f5e7
X-Client-Version
string

Version of Veeam Service Provider Console RESTful API supported by client.

Example: 3.6.1
Request Body schema: application/json
required

Cloud replication resource properties.

Array of objects (TenantReplicationResourceHardwarePlan)

Array of hardware plans.

isFailoverCapabilitiesEnabled
boolean
Default: false

Indicates whether performing failover is available to a company.

isPublicAllocationEnabled
boolean or null
Default: false

Indicates whether public IP addresses are allocated to a company.

numberOfPublicIps
integer or null <int32> >= 0
Default: 0

Number of allocated public IP addresses.

Responses
200

OK

202

Request has been queued for execution.

default

All client errors (400–499) are returned with the associated HTTP status codes. All server errors (≥500) are returned with the 520 HTTP status code. For details, see the response body.

post/infrastructure/sites/tenants/{tenantUid}/replicationResources
Request samples
application/json
{
  • "hardwarePlans": [
    ],
  • "isFailoverCapabilitiesEnabled": false,
  • "isPublicAllocationEnabled": false,
  • "numberOfPublicIps": 0
}
Response samples
application/json
{
  • "data": {
    }
}

Modify Tenant Replication Resource

Modifies a cloud replication resource allocated to a tenant with the specified UID.

Request
path Parameters
tenantUid
required
string <uuid>

Tenant UID.

query Parameters
Array of objects or null (SelectParameter)

Returns explicitly requested properties.

header Parameters
X-Request-id
string <uuid>

Random UID that you can assign to a request for idempotence and async action progress tracking.

Note that an operation is idempotent only during 5 minute time interval.

Example: ba547d14-c556-42bb-b85c-eeeb16e2f5e7
X-Client-Version
string

Version of Veeam Service Provider Console RESTful API supported by client.

Example: 3.6.1
Request Body schema: application/json
required

Array of JSON Patch operations according to RFC 6902.

Array
op
required
string

Performed operation.

Enum: "add" "replace" "test" "remove" "move" "copy"
value
required
string

Value that is added, replaced, tested or removed by the PATCH operation.

path
required
string

JSON Pointer containing path to a target location where the PATCH operation is performed.

from
string or null

JSON Pointer containing path to a location from which data is moved or copied.

Responses
200

OK

202

Request has been queued for execution.

default

All client errors (400–499) are returned with the associated HTTP status codes. All server errors (≥500) are returned with the 520 HTTP status code. For details, see the response body.

patch/infrastructure/sites/tenants/{tenantUid}/replicationResources
Request samples
application/json
[
  • {
    }
]
Response samples
application/json
{
  • "data": {
    }
}

Get Tenant Hardware Plan

Returns a resource representation of a tenant hardware plan with the specified UID.

Request
path Parameters
tenantUid
required
string <uuid>

Tenant UID.

hardwarePlanUid
required
string <uuid>

Hardware plan UID.

query Parameters
Array of objects or null (SelectParameter)

Returns explicitly requested properties.

header Parameters
X-Request-id
string <uuid>

Random UID that you can assign to a request for idempotence and async action progress tracking.

Note that an operation is idempotent only during 5 minute time interval.

Example: ba547d14-c556-42bb-b85c-eeeb16e2f5e7
X-Client-Version
string

Version of Veeam Service Provider Console RESTful API supported by client.

Example: 3.6.1
Responses
200

OK

202

Request has been queued for execution.

default

All client errors (400–499) are returned with the associated HTTP status codes. All server errors (≥500) are returned with the 520 HTTP status code. For details, see the response body.

get/infrastructure/sites/tenants/{tenantUid}/replicationResources/hardwarePlans/{hardwarePlanUid}
Request samples
Response samples
application/json
{
  • "data": {
    }
}

Get All Network Extension Appliances Allocated to Tenant

Returns a collection resource representation of a network extension appliances configured for a tenant with the specified UID.

Request
path Parameters
tenantUid
required
string <uuid>

Tenant UID.

query Parameters
Array of objects or null (FilterParameter)

Specifies the conditions that a resource must meet to be returned in the output.

Array of objects or null (SortParameter)

Specifies the order in which resources are returned from the collection.

limit
integer <int32> [ 1 .. 500 ]
Default: 100

Specifies the first N resources that must be returned in the output.

offset
integer <int32> [ 0 .. 2147483647 ]
Default: 0

Excludes the first N resources from the query output.

Array of objects or null (SelectParameter)

Returns explicitly requested properties.

header Parameters
X-Request-id
string <uuid>

Random UID that you can assign to a request for idempotence and async action progress tracking.

Note that an operation is idempotent only during 5 minute time interval.

Example: ba547d14-c556-42bb-b85c-eeeb16e2f5e7
X-Client-Version
string

Version of Veeam Service Provider Console RESTful API supported by client.

Example: 3.6.1
Responses
200

OK

202

Request has been queued for execution.

default

All client errors (400–499) are returned with the associated HTTP status codes. All server errors (≥500) are returned with the 520 HTTP status code. For details, see the response body.

get/infrastructure/sites/tenants/{tenantUid}/replicationResources/networkextensionAppliance
Request samples
Response samples
application/json
{
  • "data": [
    ],
  • "meta": {
    }
}

Get Tenant Network Extension Appliance

Returns a resource representation of a tenant network extension appliance with the specified UID.

Request
path Parameters
tenantUid
required
string <uuid>

Tenant UID.

applianceUid
required
string <uuid>

Network extension appliance UID.

query Parameters
Array of objects or null (SelectParameter)

Returns explicitly requested properties.

header Parameters
X-Request-id
string <uuid>

Random UID that you can assign to a request for idempotence and async action progress tracking.

Note that an operation is idempotent only during 5 minute time interval.

Example: ba547d14-c556-42bb-b85c-eeeb16e2f5e7
X-Client-Version
string

Version of Veeam Service Provider Console RESTful API supported by client.

Example: 3.6.1
Responses
200

OK

202

Request has been queued for execution.

default

All client errors (400–499) are returned with the associated HTTP status codes. All server errors (≥500) are returned with the 520 HTTP status code. For details, see the response body.

get/infrastructure/sites/tenants/{tenantUid}/replicationResources/networkextensionAppliance/{applianceUid}
Request samples
Response samples
application/json
{
  • "meta": {
    },
  • "data": {
    },
  • "errors": [
    ]
}

Modify Tenant Network Extension Appliance

Modifies a tenant network extension appliance with the specified UID.

Request
path Parameters
tenantUid
required
string <uuid>

Tenant UID.

applianceUid
required
string <uuid>

Network extension appliance UID.

query Parameters
Array of objects or null (SelectParameter)

Returns explicitly requested properties.

header Parameters
X-Request-id
string <uuid>

Random UID that you can assign to a request for idempotence and async action progress tracking.

Note that an operation is idempotent only during 5 minute time interval.

Example: ba547d14-c556-42bb-b85c-eeeb16e2f5e7
X-Client-Version
string

Version of Veeam Service Provider Console RESTful API supported by client.

Example: 3.6.1
Request Body schema: application/json
required

Array of JSON Patch operations according to RFC 6902.

Array
op
required
string

Performed operation.

Enum: "add" "replace" "test" "remove" "move" "copy"
value
required
string

Value that is added, replaced, tested or removed by the PATCH operation.

path
required
string

JSON Pointer containing path to a target location where the PATCH operation is performed.

from
string or null

JSON Pointer containing path to a location from which data is moved or copied.

Responses
200

OK

202

Request has been queued for execution.

default

All client errors (400–499) are returned with the associated HTTP status codes. All server errors (≥500) are returned with the 520 HTTP status code. For details, see the response body.

patch/infrastructure/sites/tenants/{tenantUid}/replicationResources/networkextensionAppliance/{applianceUid}
Request samples
application/json
[
  • {
    }
]
Response samples
application/json
{
  • "data": {
    }
}

Get Usage of All Tenant Replication Resources

Returns a collection resource representation of usage of all tenant replication resources.

Request
query Parameters
Array of objects or null (FilterParameter)

Specifies the conditions that a resource must meet to be returned in the output.

Array of objects or null (SortParameter)

Specifies the order in which resources are returned from the collection.

limit
integer <int32> [ 1 .. 500 ]
Default: 100

Specifies the first N resources that must be returned in the output.

offset
integer <int32> [ 0 .. 2147483647 ]
Default: 0

Excludes the first N resources from the query output.

Array of objects or null (SelectParameter)

Returns explicitly requested properties.

header Parameters
X-Request-id
string <uuid>

Random UID that you can assign to a request for idempotence and async action progress tracking.

Note that an operation is idempotent only during 5 minute time interval.

Example: ba547d14-c556-42bb-b85c-eeeb16e2f5e7
X-Client-Version
string

Version of Veeam Service Provider Console RESTful API supported by client.

Example: 3.6.1
Responses
200

OK

202

Request has been queued for execution.

default

All client errors (400–499) are returned with the associated HTTP status codes. All server errors (≥500) are returned with the 520 HTTP status code. For details, see the response body.

get/infrastructure/sites/tenants/replicationResources/usage
Request samples
Response samples
application/json
{
  • "data": [
    ],
  • "meta": {
    }
}

Get Usage of All Replication Resources Allocated to Tenant

Returns a collection resource representation of usage of all cloud replication resources allocated to a tenant with the specified UID.

Request
path Parameters
tenantUid
required
string <uuid>

Tenant UID.

query Parameters
Array of objects or null (FilterParameter)

Specifies the conditions that a resource must meet to be returned in the output.

Array of objects or null (SortParameter)

Specifies the order in which resources are returned from the collection.

limit
integer <int32> [ 1 .. 500 ]
Default: 100

Specifies the first N resources that must be returned in the output.

offset
integer <int32> [ 0 .. 2147483647 ]
Default: 0

Excludes the first N resources from the query output.

Array of objects or null (SelectParameter)

Returns explicitly requested properties.

header Parameters
X-Request-id
string <uuid>

Random UID that you can assign to a request for idempotence and async action progress tracking.

Note that an operation is idempotent only during 5 minute time interval.

Example: ba547d14-c556-42bb-b85c-eeeb16e2f5e7
X-Client-Version
string

Version of Veeam Service Provider Console RESTful API supported by client.

Example: 3.6.1
Responses
200

OK

202

Request has been queued for execution.

default

All client errors (400–499) are returned with the associated HTTP status codes. All server errors (≥500) are returned with the 520 HTTP status code. For details, see the response body.

get/infrastructure/sites/tenants/{tenantUid}/replicationResources/usage
Request samples
Response samples
application/json
{
  • "data": [
    ],
  • "meta": {
    }
}

Get All Tenant VMware Cloud Director Replication Resources

Returns a collection resource representation of all tenant VMware Cloud Director replication resources.

Request
query Parameters
Array of objects or null (FilterParameter)

Specifies the conditions that a resource must meet to be returned in the output.

Array of objects or null (SortParameter)

Specifies the order in which resources are returned from the collection.

limit
integer <int32> [ 1 .. 500 ]
Default: 100

Specifies the first N resources that must be returned in the output.

offset
integer <int32> [ 0 .. 2147483647 ]
Default: 0

Excludes the first N resources from the query output.

Array of objects or null (SelectParameter)

Returns explicitly requested properties.

header Parameters
X-Request-id
string <uuid>

Random UID that you can assign to a request for idempotence and async action progress tracking.

Note that an operation is idempotent only during 5 minute time interval.

Example: ba547d14-c556-42bb-b85c-eeeb16e2f5e7
X-Client-Version
string

Version of Veeam Service Provider Console RESTful API supported by client.

Example: 3.6.1
Responses
200

OK

202

Request has been queued for execution.

default

All client errors (400–499) are returned with the associated HTTP status codes. All server errors (≥500) are returned with the 520 HTTP status code. For details, see the response body.

get/infrastructure/sites/tenants/vcdReplicationResources
Request samples
Response samples
application/json
{
  • "data": [
    ],
  • "meta": {
    }
}

Get All VMware Cloud Director Replication Resources Allocated to Tenant

Returns a collection resource representation of all VMware Cloud Director replication resources allocated to a tenant with the specified UID.

Request
path Parameters
tenantUid
required
string <uuid>

Tenant UID.

query Parameters
Array of objects or null (SelectParameter)

Returns explicitly requested properties.

header Parameters
X-Request-id
string <uuid>

Random UID that you can assign to a request for idempotence and async action progress tracking.

Note that an operation is idempotent only during 5 minute time interval.

Example: ba547d14-c556-42bb-b85c-eeeb16e2f5e7
X-Client-Version
string

Version of Veeam Service Provider Console RESTful API supported by client.

Example: 3.6.1
Responses
200

OK

202

Request has been queued for execution.

default

All client errors (400–499) are returned with the associated HTTP status codes. All server errors (≥500) are returned with the 520 HTTP status code. For details, see the response body.

get/infrastructure/sites/tenants/{tenantUid}/vcdReplicationResources
Request samples
Response samples
application/json
{
  • "data": {
    }
}

Create Tenant VMware Cloud Director Replication Resource on Site

Allocates a new VMware Cloud Director replication resource to a tenant with the specified UID.

Request
path Parameters
tenantUid
required
string <uuid>

Tenant UID.

query Parameters
Array of objects or null (SelectParameter)

Returns explicitly requested properties.

header Parameters
X-Request-id
string <uuid>

Random UID that you can assign to a request for idempotence and async action progress tracking.

Note that an operation is idempotent only during 5 minute time interval.

Example: ba547d14-c556-42bb-b85c-eeeb16e2f5e7
X-Client-Version
string

Version of Veeam Service Provider Console RESTful API supported by client.

Example: 3.6.1
Request Body schema: application/json
required

VMware Cloud Director replication resource properties.

Array of objects (TenantVcdReplicationResourceDataCenter)

Array of organization VDCs.

isFailoverCapabilitiesEnabled
boolean
Default: false

Indicates whether performing failover is available to a company.

Responses
200

OK

202

Request has been queued for execution.

default

All client errors (400–499) are returned with the associated HTTP status codes. All server errors (≥500) are returned with the 520 HTTP status code. For details, see the response body.

post/infrastructure/sites/tenants/{tenantUid}/vcdReplicationResources
Request samples
application/json
{
  • "dataCenters": [
    ],
  • "isFailoverCapabilitiesEnabled": false
}
Response samples
application/json
{
  • "data": {
    }
}

Modify Tenant VMware Cloud Director Replication Resource

Modifies a VMware Cloud Director replication resource allocated to a tenant with the specified UID.

Request
path Parameters
tenantUid
required
string <uuid>

Tenant UID.

query Parameters
Array of objects or null (SelectParameter)

Returns explicitly requested properties.

header Parameters
X-Request-id
string <uuid>

Random UID that you can assign to a request for idempotence and async action progress tracking.

Note that an operation is idempotent only during 5 minute time interval.

Example: ba547d14-c556-42bb-b85c-eeeb16e2f5e7
X-Client-Version
string

Version of Veeam Service Provider Console RESTful API supported by client.

Example: 3.6.1
Request Body schema: application/json
required

Array of JSON Patch operations according to RFC 6902.

Array
op
required
string

Performed operation.

Enum: "add" "replace" "test" "remove" "move" "copy"
value
required
string

Value that is added, replaced, tested or removed by the PATCH operation.

path
required
string

JSON Pointer containing path to a target location where the PATCH operation is performed.

from
string or null

JSON Pointer containing path to a location from which data is moved or copied.

Responses
200

OK

202

Request has been queued for execution.

default

All client errors (400–499) are returned with the associated HTTP status codes. All server errors (≥500) are returned with the 520 HTTP status code. For details, see the response body.

patch/infrastructure/sites/tenants/{tenantUid}/vcdReplicationResources
Request samples
application/json
[
  • {
    }
]
Response samples
application/json
{
  • "data": {
    }
}

Get Tenant Organization VDC

Returns a resource representation of a tenant organization VDC with the specified UID.

Request
path Parameters
tenantUid
required
string <uuid>

Tenant UID.

dataCenterUid
required
string <uuid>

Organization vDC UID.

query Parameters
Array of objects or null (SelectParameter)

Returns explicitly requested properties.

header Parameters
X-Request-id
string <uuid>

Random UID that you can assign to a request for idempotence and async action progress tracking.

Note that an operation is idempotent only during 5 minute time interval.

Example: ba547d14-c556-42bb-b85c-eeeb16e2f5e7
X-Client-Version
string

Version of Veeam Service Provider Console RESTful API supported by client.

Example: 3.6.1
Responses
200

OK

202

Request has been queued for execution.

default

All client errors (400–499) are returned with the associated HTTP status codes. All server errors (≥500) are returned with the 520 HTTP status code. For details, see the response body.

get/infrastructure/sites/tenants/{tenantUid}/vcdReplicationResources/dataCenters/{dataCenterUid}
Request samples
Response samples
application/json
{
  • "data": {
    }
}

Get Usage of All Tenant VMware Cloud Director Replication Resources

Returns a collection resource representation of VMware Cloud Director replication resource usage by all tenants.

Request
query Parameters
Array of objects or null (FilterParameter)

Specifies the conditions that a resource must meet to be returned in the output.

Array of objects or null (SortParameter)

Specifies the order in which resources are returned from the collection.

limit
integer <int32> [ 1 .. 500 ]
Default: 100

Specifies the first N resources that must be returned in the output.

offset
integer <int32> [ 0 .. 2147483647 ]
Default: 0

Excludes the first N resources from the query output.

Array of objects or null (SelectParameter)

Returns explicitly requested properties.

header Parameters
X-Request-id
string <uuid>

Random UID that you can assign to a request for idempotence and async action progress tracking.

Note that an operation is idempotent only during 5 minute time interval.

Example: ba547d14-c556-42bb-b85c-eeeb16e2f5e7
X-Client-Version
string

Version of Veeam Service Provider Console RESTful API supported by client.

Example: 3.6.1
Responses
200

OK

202

Request has been queued for execution.

default

All client errors (400–499) are returned with the associated HTTP status codes. All server errors (≥500) are returned with the 520 HTTP status code. For details, see the response body.

get/infrastructure/sites/tenants/vcdReplicationResources/usage
Request samples
Response samples
application/json
{
  • "data": [
    ],
  • "meta": {
    }
}

Get Usage of All VMware Cloud Director Replication Resources Allocated to Tenant

Returns a collection resource representation of usage of all VMware Cloud Director replication resources allocated to a tenant with the specified UID.

Request
path Parameters
tenantUid
required
string <uuid>

Tenant UID.

query Parameters
Array of objects or null (FilterParameter)

Specifies the conditions that a resource must meet to be returned in the output.

Array of objects or null (SortParameter)

Specifies the order in which resources are returned from the collection.

limit
integer <int32> [ 1 .. 500 ]
Default: 100

Specifies the first N resources that must be returned in the output.

offset
integer <int32> [ 0 .. 2147483647 ]
Default: 0

Excludes the first N resources from the query output.

Array of objects or null (SelectParameter)

Returns explicitly requested properties.

header Parameters
X-Request-id
string <uuid>

Random UID that you can assign to a request for idempotence and async action progress tracking.

Note that an operation is idempotent only during 5 minute time interval.

Example: ba547d14-c556-42bb-b85c-eeeb16e2f5e7
X-Client-Version
string

Version of Veeam Service Provider Console RESTful API supported by client.

Example: 3.6.1
Responses
200

OK

202

Request has been queued for execution.

default

All client errors (400–499) are returned with the associated HTTP status codes. All server errors (≥500) are returned with the 520 HTTP status code. For details, see the response body.

get/infrastructure/sites/tenants/{tenantUid}/vcdReplicationResources/usage
Request samples
Response samples
application/json
{
  • "data": [
    ],
  • "meta": {
    }
}

Get All Network Extension Appliances Configured for Tenant

Returns a collection resource representation of all network extension appliances configured for a tenant with the specified system ID.

Request
path Parameters
tenantUid
required
string <uuid>

Tenant UID.

query Parameters
Array of objects or null (FilterParameter)

Specifies the conditions that a resource must meet to be returned in the output.

Array of objects or null (SortParameter)

Specifies the order in which resources are returned from the collection.

limit
integer <int32> [ 1 .. 500 ]
Default: 100

Specifies the first N resources that must be returned in the output.

offset
integer <int32> [ 0 .. 2147483647 ]
Default: 0

Excludes the first N resources from the query output.

Array of objects or null (SelectParameter)

Returns explicitly requested properties.

header Parameters
X-Request-id
string <uuid>

Random UID that you can assign to a request for idempotence and async action progress tracking.

Note that an operation is idempotent only during 5 minute time interval.

Example: ba547d14-c556-42bb-b85c-eeeb16e2f5e7
X-Client-Version
string

Version of Veeam Service Provider Console RESTful API supported by client.

Example: 3.6.1
Responses
200

OK

202

Request has been queued for execution.

default

All client errors (400–499) are returned with the associated HTTP status codes. All server errors (≥500) are returned with the 520 HTTP status code. For details, see the response body.

get/infrastructure/sites/tenants/{tenantUid}/vcdReplicationResources/networkExtensionAppliance
Request samples
Response samples
application/json
{
  • "data": [
    ],
  • "meta": {
    }
}

Get Tenant Network Extension Appliance

Returns a resource representation of a tenant network extension appliance with the specified UID.

Request
path Parameters
tenantUid
required
string <uuid>

Tenant UID.

applianceUid
required
string <uuid>

Network extension appliance UID.

query Parameters
Array of objects or null (SelectParameter)

Returns explicitly requested properties.

header Parameters
X-Request-id
string <uuid>

Random UID that you can assign to a request for idempotence and async action progress tracking.

Note that an operation is idempotent only during 5 minute time interval.

Example: ba547d14-c556-42bb-b85c-eeeb16e2f5e7
X-Client-Version
string

Version of Veeam Service Provider Console RESTful API supported by client.

Example: 3.6.1
Responses
200

OK

202

Request has been queued for execution.

default

All client errors (400–499) are returned with the associated HTTP status codes. All server errors (≥500) are returned with the 520 HTTP status code. For details, see the response body.

get/infrastructure/sites/tenants/{tenantUid}/vcdReplicationResources/networkExtensionAppliance/{applianceUid}
Request samples
Response samples
application/json
{
  • "data": {
    }
}

Modify Tenant Network Extension Appliance

Modifies a tenant network extension appliance with the specified UID.

Request
path Parameters
tenantUid
required
string <uuid>

Tenant UID.

applianceUid
required
string <uuid>

Network extension appliance UID.

query Parameters
Array of objects or null (SelectParameter)

Returns explicitly requested properties.

header Parameters
X-Request-id
string <uuid>

Random UID that you can assign to a request for idempotence and async action progress tracking.

Note that an operation is idempotent only during 5 minute time interval.

Example: ba547d14-c556-42bb-b85c-eeeb16e2f5e7
X-Client-Version
string

Version of Veeam Service Provider Console RESTful API supported by client.

Example: 3.6.1
Request Body schema: application/json
required

Array of JSON Patch operations according to RFC 6902.

Array
op
required
string

Performed operation.

Enum: "add" "replace" "test" "remove" "move" "copy"
value
required
string

Value that is added, replaced, tested or removed by the PATCH operation.

path
required
string

JSON Pointer containing path to a target location where the PATCH operation is performed.

from
string or null

JSON Pointer containing path to a location from which data is moved or copied.

Responses
200

OK

202

Request has been queued for execution.

default

All client errors (400–499) are returned with the associated HTTP status codes. All server errors (≥500) are returned with the 520 HTTP status code. For details, see the response body.

patch/infrastructure/sites/tenants/{tenantUid}/vcdReplicationResources/networkExtensionAppliance/{applianceUid}
Request samples
application/json
[
  • {
    }
]
Response samples
application/json
{
  • "data": {
    }
}

Get All Subtenants

Returns a collection resource representation of all subtenants.

Request
query Parameters
Array of objects or null (FilterParameter)

Specifies the conditions that a resource must meet to be returned in the output.

Array of objects or null (SortParameter)

Specifies the order in which resources are returned from the collection.

limit
integer <int32> [ 1 .. 500 ]
Default: 100

Specifies the first N resources that must be returned in the output.

offset
integer <int32> [ 0 .. 2147483647 ]
Default: 0

Excludes the first N resources from the query output.

Array of objects or null (SelectParameter)

Returns explicitly requested properties.

header Parameters
X-Request-id
string <uuid>

Random UID that you can assign to a request for idempotence and async action progress tracking.

Note that an operation is idempotent only during 5 minute time interval.

Example: ba547d14-c556-42bb-b85c-eeeb16e2f5e7
X-Client-Version
string

Version of Veeam Service Provider Console RESTful API supported by client.

Example: 3.6.1
Responses
200

OK

202

Request has been queued for execution.

default

All client errors (400–499) are returned with the associated HTTP status codes. All server errors (≥500) are returned with the 520 HTTP status code. For details, see the response body.

get/infrastructure/sites/tenants/subtenants
Request samples
Response samples
application/json
{
  • "data": [
    ],
  • "meta": {
    }
}

Get All Subtenants Registered on Site

Returns a collection resource representation of all subtenants provided with resources of a Veeam Cloud Connect site with the specified UID.

Request
path Parameters
siteUid
required
string <uuid>

Veeam Cloud Connect site UID.

query Parameters
Array of objects or null (FilterParameter)

Specifies the conditions that a resource must meet to be returned in the output.

Array of objects or null (SortParameter)

Specifies the order in which resources are returned from the collection.

limit
integer <int32> [ 1 .. 500 ]
Default: 100

Specifies the first N resources that must be returned in the output.

offset
integer <int32> [ 0 .. 2147483647 ]
Default: 0

Excludes the first N resources from the query output.

Array of objects or null (SelectParameter)

Returns explicitly requested properties.

header Parameters
X-Request-id
string <uuid>

Random UID that you can assign to a request for idempotence and async action progress tracking.

Note that an operation is idempotent only during 5 minute time interval.

Example: ba547d14-c556-42bb-b85c-eeeb16e2f5e7
X-Client-Version
string

Version of Veeam Service Provider Console RESTful API supported by client.

Example: 3.6.1
Responses
200

OK

202

Request has been queued for execution.

default

All client errors (400–499) are returned with the associated HTTP status codes. All server errors (≥500) are returned with the 520 HTTP status code. For details, see the response body.

get/infrastructure/sites/{siteUid}/tenants/subtenants
Request samples
Response samples
application/json
{
  • "data": [
    ],
  • "meta": {
    }
}

Get All Subtenants Registered by Tenant

Returns a collection resource representation of all subtenants registered by a tenant with the specified UID.

Request
path Parameters
tenantUid
required
string <uuid>

Tenant UID.

query Parameters
Array of objects or null (FilterParameter)

Specifies the conditions that a resource must meet to be returned in the output.

Array of objects or null (SortParameter)

Specifies the order in which resources are returned from the collection.

limit
integer <int32> [ 1 .. 500 ]
Default: 100

Specifies the first N resources that must be returned in the output.

offset
integer <int32> [ 0 .. 2147483647 ]
Default: 0

Excludes the first N resources from the query output.

Array of objects or null (SelectParameter)

Returns explicitly requested properties.

header Parameters
X-Request-id
string <uuid>

Random UID that you can assign to a request for idempotence and async action progress tracking.

Note that an operation is idempotent only during 5 minute time interval.

Example: ba547d14-c556-42bb-b85c-eeeb16e2f5e7
X-Client-Version
string

Version of Veeam Service Provider Console RESTful API supported by client.

Example: 3.6.1
Responses
200

OK

202

Request has been queued for execution.

default

All client errors (400–499) are returned with the associated HTTP status codes. All server errors (≥500) are returned with the 520 HTTP status code. For details, see the response body.

get/infrastructure/sites/tenants/{tenantUid}/subtenants
Request samples
Response samples
application/json
{
  • "data": [
    ],
  • "meta": {
    }
}

Get Subtenant

Returns a resource representation of a subtenant with the specified UID.

Request
path Parameters
subtenantUid
required
string <uuid>

Subtenant UID.

query Parameters
Array of objects or null (SelectParameter)

Returns explicitly requested properties.

header Parameters
X-Request-id
string <uuid>

Random UID that you can assign to a request for idempotence and async action progress tracking.

Note that an operation is idempotent only during 5 minute time interval.

Example: ba547d14-c556-42bb-b85c-eeeb16e2f5e7
X-Client-Version
string

Version of Veeam Service Provider Console RESTful API supported by client.

Example: 3.6.1
Responses
200

OK

202

Request has been queued for execution.

default

All client errors (400–499) are returned with the associated HTTP status codes. All server errors (≥500) are returned with the 520 HTTP status code. For details, see the response body.

get/infrastructure/sites/tenants/subtenants/{subtenantUid}
Request samples
Response samples
application/json
{
  • "data": {
    }
}

Get All Cloud Gateway Pools Assigned to Tenant

Returns a collection resource representation of all cloud gateway pools assigned to a tenant with the specified UID.

Request
path Parameters
tenantUid
required
string <uuid>

Tenant UID.

query Parameters
Array of objects or null (FilterParameter)

Specifies the conditions that a resource must meet to be returned in the output.

Array of objects or null (SortParameter)

Specifies the order in which resources are returned from the collection.

limit
integer <int32> [ 1 .. 500 ]
Default: 100

Specifies the first N resources that must be returned in the output.

offset
integer <int32> [ 0 .. 2147483647 ]
Default: 0

Excludes the first N resources from the query output.

Array of objects or null (SelectParameter)

Returns explicitly requested properties.

header Parameters
X-Request-id
string <uuid>

Random UID that you can assign to a request for idempotence and async action progress tracking.

Note that an operation is idempotent only during 5 minute time interval.

Example: ba547d14-c556-42bb-b85c-eeeb16e2f5e7
X-Client-Version
string

Version of Veeam Service Provider Console RESTful API supported by client.

Example: 3.6.1
Responses
200

OK

202

Request has been queued for execution.

default

All client errors (400–499) are returned with the associated HTTP status codes. All server errors (≥500) are returned with the 520 HTTP status code. For details, see the response body.

get/infrastructure/sites/tenants/{tenantUid}/cloudGatewayPools
Request samples
Response samples
application/json
{
  • "data": [
    ],
  • "meta": {
    }
}

Get Tenant Veeam Products

Returns a collection resource representation of tenant Veeam products that generated cloud data the latest.

Request
query Parameters
Array of objects or null (FilterParameter)

Specifies the conditions that a resource must meet to be returned in the output.

Array of objects or null (SortParameter)

Specifies the order in which resources are returned from the collection.

limit
integer <int32> [ 1 .. 500 ]
Default: 100

Specifies the first N resources that must be returned in the output.

offset
integer <int32> [ 0 .. 2147483647 ]
Default: 0

Excludes the first N resources from the query output.

Array of objects or null (SelectParameter)

Returns explicitly requested properties.

header Parameters
X-Request-id
string <uuid>

Random UID that you can assign to a request for idempotence and async action progress tracking.

Note that an operation is idempotent only during 5 minute time interval.

Example: ba547d14-c556-42bb-b85c-eeeb16e2f5e7
X-Client-Version
string

Version of Veeam Service Provider Console RESTful API supported by client.

Example: 3.6.1
Responses
200

OK

202

Request has been queued for execution.

default

All client errors (400–499) are returned with the associated HTTP status codes. All server errors (≥500) are returned with the 520 HTTP status code. For details, see the response body.

get/infrastructure/sites/tenants/products
Request samples
Response samples
application/json
{
  • "data": [
    ],
  • "meta": {
    }
}

Get Tenant Veeam Products on Site

Returns a collection resource representation of tenant Veeam products that generated the latest cloud data managed by a Veeam Cloud Connect site with the specified UID.

Request
path Parameters
siteUid
required
string <uuid>

Veeam Cloud Connect site UID.

query Parameters
Array of objects or null (FilterParameter)

Specifies the conditions that a resource must meet to be returned in the output.

Array of objects or null (SortParameter)

Specifies the order in which resources are returned from the collection.

limit
integer <int32> [ 1 .. 500 ]
Default: 100

Specifies the first N resources that must be returned in the output.

offset
integer <int32> [ 0 .. 2147483647 ]
Default: 0

Excludes the first N resources from the query output.

Array of objects or null (SelectParameter)

Returns explicitly requested properties.

header Parameters
X-Request-id
string <uuid>

Random UID that you can assign to a request for idempotence and async action progress tracking.

Note that an operation is idempotent only during 5 minute time interval.

Example: ba547d14-c556-42bb-b85c-eeeb16e2f5e7
X-Client-Version
string

Version of Veeam Service Provider Console RESTful API supported by client.

Example: 3.6.1
Responses
200

OK

202

Request has been queued for execution.

default

All client errors (400–499) are returned with the associated HTTP status codes. All server errors (≥500) are returned with the 520 HTTP status code. For details, see the response body.

get/infrastructure/sites/{siteUid}/tenants/products
Request samples
Response samples
application/json
{
  • "data": [
    ],
  • "meta": {
    }
}

Get VMware Cloud Director Servers Managed by All Veeam Cloud Connect Sites

Returns a collection resource representation of VMware Cloud Director servers managed by all Veeam Cloud Connect Sites.

Request
query Parameters
Array of objects or null (FilterParameter)

Specifies the conditions that a resource must meet to be returned in the output.

Array of objects or null (SortParameter)

Specifies the order in which resources are returned from the collection.

limit
integer <int32> [ 1 .. 500 ]
Default: 100

Specifies the first N resources that must be returned in the output.

offset
integer <int32> [ 0 .. 2147483647 ]
Default: 0

Excludes the first N resources from the query output.

Array of objects or null (SelectParameter)

Returns explicitly requested properties.

header Parameters
X-Request-id
string <uuid>

Random UID that you can assign to a request for idempotence and async action progress tracking.

Note that an operation is idempotent only during 5 minute time interval.

Example: ba547d14-c556-42bb-b85c-eeeb16e2f5e7
X-Client-Version
string

Version of Veeam Service Provider Console RESTful API supported by client.

Example: 3.6.1
Responses
200

OK

202

Request has been queued for execution.

default

All client errors (400–499) are returned with the associated HTTP status codes. All server errors (≥500) are returned with the 520 HTTP status code. For details, see the response body.

get/infrastructure/sites/vcdServers
Request samples
Response samples
application/json
{
  • "data": [
    ],
  • "meta": {
    }
}

Get All VMware Cloud Director Servers Managed by Veeam Cloud Connect Site

Returns a collection resource representation of all VMware Cloud Director servers managed by a Veeam Cloud Connect site with the specified UID.

Request
path Parameters
siteUid
required
string <uuid>

Veeam Cloud Connect site UID.

query Parameters
Array of objects or null (FilterParameter)

Specifies the conditions that a resource must meet to be returned in the output.

Array of objects or null (SortParameter)

Specifies the order in which resources are returned from the collection.

limit
integer <int32> [ 1 .. 500 ]
Default: 100

Specifies the first N resources that must be returned in the output.

offset
integer <int32> [ 0 .. 2147483647 ]
Default: 0

Excludes the first N resources from the query output.

Array of objects or null (SelectParameter)

Returns explicitly requested properties.

header Parameters
X-Request-id
string <uuid>

Random UID that you can assign to a request for idempotence and async action progress tracking.

Note that an operation is idempotent only during 5 minute time interval.

Example: ba547d14-c556-42bb-b85c-eeeb16e2f5e7
X-Client-Version
string

Version of Veeam Service Provider Console RESTful API supported by client.

Example: 3.6.1
Responses
200

OK

202

Request has been queued for execution.

default

All client errors (400–499) are returned with the associated HTTP status codes. All server errors (≥500) are returned with the 520 HTTP status code. For details, see the response body.

get/infrastructure/sites/{siteUid}/vcdServers
Request samples
Response samples
application/json
{
  • "data": [
    ],
  • "meta": {
    }
}

Get VMware Cloud Director Server Managed by Veeam Cloud Connect Site

Returns a resource representation of a VMware Cloud Director server with the specified UID managed by a Veeam Cloud Connect site.

Request
path Parameters
vcdServerUid
required
string <uuid>

VMware Cloud Director server UID.

siteUid
required
string <uuid>

Veeam Cloud Connect site UID.

query Parameters
Array of objects or null (SelectParameter)

Returns explicitly requested properties.

header Parameters
X-Request-id
string <uuid>

Random UID that you can assign to a request for idempotence and async action progress tracking.

Note that an operation is idempotent only during 5 minute time interval.

Example: ba547d14-c556-42bb-b85c-eeeb16e2f5e7
X-Client-Version
string

Version of Veeam Service Provider Console RESTful API supported by client.

Example: 3.6.1
Responses
200

OK

202

Request has been queued for execution.

default

All client errors (400–499) are returned with the associated HTTP status codes. All server errors (≥500) are returned with the 520 HTTP status code. For details, see the response body.

get/infrastructure/sites/{siteUid}/vcdServers/{vcdServerUid}
Request samples
Response samples
application/json
{
  • "data": {
    }
}

Get VMware Cloud Director Organizations Managed by All Veeam Cloud Connect Sites

Returns a collection resource representation of VMware Cloud Director organizations managed by all Veeam Cloud Connect sites.

Request
query Parameters
Array of objects or null (FilterParameter)

Specifies the conditions that a resource must meet to be returned in the output.

Array of objects or null (SortParameter)

Specifies the order in which resources are returned from the collection.

limit
integer <int32> [ 1 .. 500 ]
Default: 100

Specifies the first N resources that must be returned in the output.

offset
integer <int32> [ 0 .. 2147483647 ]
Default: 0

Excludes the first N resources from the query output.

Array of objects or null (SelectParameter)

Returns explicitly requested properties.

header Parameters
X-Request-id
string <uuid>

Random UID that you can assign to a request for idempotence and async action progress tracking.

Note that an operation is idempotent only during 5 minute time interval.

Example: ba547d14-c556-42bb-b85c-eeeb16e2f5e7
X-Client-Version
string

Version of Veeam Service Provider Console RESTful API supported by client.

Example: 3.6.1
Responses
200

OK

202

Request has been queued for execution.

default

All client errors (400–499) are returned with the associated HTTP status codes. All server errors (≥500) are returned with the 520 HTTP status code. For details, see the response body.

get/infrastructure/sites/vcdServers/vcdOrganizations
Request samples
Response samples
application/json
{
  • "data": [
    ],
  • "meta": {
    }
}

Get All VMware Cloud Director Organizations Managed by Veeam Cloud Connect Site

Returns a collection resource representation of all VMware Cloud Director organizations managed by a Veeam Cloud Connect site with the specified UID.

Request
path Parameters
siteUid
required
string <uuid>

Veeam Cloud Connect site UID.

query Parameters
Array of objects or null (FilterParameter)

Specifies the conditions that a resource must meet to be returned in the output.

Array of objects or null (SortParameter)

Specifies the order in which resources are returned from the collection.

limit
integer <int32> [ 1 .. 500 ]
Default: 100

Specifies the first N resources that must be returned in the output.

offset
integer <int32> [ 0 .. 2147483647 ]
Default: 0

Excludes the first N resources from the query output.

Array of objects or null (SelectParameter)

Returns explicitly requested properties.

header Parameters
X-Request-id
string <uuid>

Random UID that you can assign to a request for idempotence and async action progress tracking.

Note that an operation is idempotent only during 5 minute time interval.

Example: ba547d14-c556-42bb-b85c-eeeb16e2f5e7
X-Client-Version
string

Version of Veeam Service Provider Console RESTful API supported by client.

Example: 3.6.1
Responses
200

OK

202

Request has been queued for execution.

default

All client errors (400–499) are returned with the associated HTTP status codes. All server errors (≥500) are returned with the 520 HTTP status code. For details, see the response body.

get/infrastructure/sites/{siteUid}/vcdServers/vcdOrganizations
Request samples
Response samples
application/json
{
  • "data": [
    ],
  • "meta": {
    }
}

Get All Organizations Configured on VMware Cloud Director Server Managed by Veeam Cloud Connect Site

Returns a collection resource representation of all VMware Cloud Director organizations configured on a VMware Cloud Director server with the specified UID managed by a Veeam Cloud Connect site.

Request
path Parameters
vcdServerUid
required
string <uuid>

VMware Cloud Director server UID.

siteUid
required
string <uuid>

Veeam Cloud Connect site UID.

query Parameters
Array of objects or null (FilterParameter)

Specifies the conditions that a resource must meet to be returned in the output.

Array of objects or null (SortParameter)

Specifies the order in which resources are returned from the collection.

limit
integer <int32> [ 1 .. 500 ]
Default: 100

Specifies the first N resources that must be returned in the output.

offset
integer <int32> [ 0 .. 2147483647 ]
Default: 0

Excludes the first N resources from the query output.

Array of objects or null (SelectParameter)

Returns explicitly requested properties.

header Parameters
X-Request-id
string <uuid>

Random UID that you can assign to a request for idempotence and async action progress tracking.

Note that an operation is idempotent only during 5 minute time interval.

Example: ba547d14-c556-42bb-b85c-eeeb16e2f5e7
X-Client-Version
string

Version of Veeam Service Provider Console RESTful API supported by client.

Example: 3.6.1
Responses
200

OK

202

Request has been queued for execution.

default

All client errors (400–499) are returned with the associated HTTP status codes. All server errors (≥500) are returned with the 520 HTTP status code. For details, see the response body.

get/infrastructure/sites/{siteUid}/vcdServers/{vcdServerUid}/vcdOrganizations
Request samples
Response samples
application/json
{
  • "data": [
    ],
  • "meta": {
    }
}

Get VMware Cloud Director Organization Managed by Veeam Cloud Connect Site

Returns a resource representation of a VMware Cloud Director organization with the specified UID managed by Veeam Cloud Connect Site.

Request
path Parameters
vcdOrganizationUid
required
string <uuid>

VMware Cloud Director organization UID.

siteUid
required
string <uuid>

Veeam Cloud Connect site UID.

query Parameters
Array of objects or null (SelectParameter)

Returns explicitly requested properties.

header Parameters
X-Request-id
string <uuid>

Random UID that you can assign to a request for idempotence and async action progress tracking.

Note that an operation is idempotent only during 5 minute time interval.

Example: ba547d14-c556-42bb-b85c-eeeb16e2f5e7
X-Client-Version
string

Version of Veeam Service Provider Console RESTful API supported by client.

Example: 3.6.1
Responses
200

OK

202

Request has been queued for execution.

default

All client errors (400–499) are returned with the associated HTTP status codes. All server errors (≥500) are returned with the 520 HTTP status code. For details, see the response body.

get/infrastructure/sites/{siteUid}/vcdServers/vcdOrganizations/{vcdOrganizationUid}
Request samples
Response samples
application/json
{
  • "data": {
    }
}

Get Organization VDCs Managed by All Veeam Cloud Connect Sites

Returns a collection resource representation of organization VDCs managed by all Veeam Cloud Connect Sites.

Request
query Parameters
Array of objects or null (FilterParameter)

Specifies the conditions that a resource must meet to be returned in the output.

Array of objects or null (SortParameter)

Specifies the order in which resources are returned from the collection.

limit
integer <int32> [ 1 .. 500 ]
Default: 100

Specifies the first N resources that must be returned in the output.

offset
integer <int32> [ 0 .. 2147483647 ]
Default: 0

Excludes the first N resources from the query output.

Array of objects or null (SelectParameter)

Returns explicitly requested properties.

header Parameters
X-Request-id
string <uuid>

Random UID that you can assign to a request for idempotence and async action progress tracking.

Note that an operation is idempotent only during 5 minute time interval.

Example: ba547d14-c556-42bb-b85c-eeeb16e2f5e7
X-Client-Version
string

Version of Veeam Service Provider Console RESTful API supported by client.

Example: 3.6.1
Responses
200

OK

202

Request has been queued for execution.

default

All client errors (400–499) are returned with the associated HTTP status codes. All server errors (≥500) are returned with the 520 HTTP status code. For details, see the response body.

get/infrastructure/sites/vcdServers/vcdOrganizations/vDCs
Request samples
Response samples
application/json
{
  • "data": [
    ],
  • "meta": {
    }
}

Get All Organization VDCs Managed by Veeam Cloud Connect Site

Returns a collection resource representation of all organization VDCs managed by a Veeam Cloud Connect site with the specified UID.

Request
path Parameters
siteUid
required
string <uuid>

Veeam Cloud Connect site UID.

query Parameters
Array of objects or null (FilterParameter)

Specifies the conditions that a resource must meet to be returned in the output.

Array of objects or null (SortParameter)

Specifies the order in which resources are returned from the collection.

limit
integer <int32> [ 1 .. 500 ]
Default: 100

Specifies the first N resources that must be returned in the output.

offset
integer <int32> [ 0 .. 2147483647 ]
Default: 0

Excludes the first N resources from the query output.

Array of objects or null (SelectParameter)

Returns explicitly requested properties.

header Parameters
X-Request-id
string <uuid>

Random UID that you can assign to a request for idempotence and async action progress tracking.

Note that an operation is idempotent only during 5 minute time interval.

Example: ba547d14-c556-42bb-b85c-eeeb16e2f5e7
X-Client-Version
string

Version of Veeam Service Provider Console RESTful API supported by client.

Example: 3.6.1
Responses
200

OK

202

Request has been queued for execution.

default

All client errors (400–499) are returned with the associated HTTP status codes. All server errors (≥500) are returned with the 520 HTTP status code. For details, see the response body.

get/infrastructure/sites/{siteUid}/vcdServers/vcdOrganizations/vDCs
Request samples
Response samples
application/json
{
  • "data": [
    ],
  • "meta": {
    }
}

Get All VDCs Providing Resources to VMware Cloud Director Organization Managed by Veeam Cloud Connect Site

Returns a collection resource representation of all VDCs that provide resources to a VMware Cloud Director organization with the specified UID managed by a Veeam Cloud Connect Site.

Request
path Parameters
vcdOrganizationUid
required
string <uuid>

VMware Cloud Director organization UID.

siteUid
required
string <uuid>

Veeam Cloud Connect site UID.

query Parameters
Array of objects or null (FilterParameter)

Specifies the conditions that a resource must meet to be returned in the output.

Array of objects or null (SortParameter)

Specifies the order in which resources are returned from the collection.

limit
integer <int32> [ 1 .. 500 ]
Default: 100

Specifies the first N resources that must be returned in the output.

offset
integer <int32> [ 0 .. 2147483647 ]
Default: 0

Excludes the first N resources from the query output.

Array of objects or null (SelectParameter)

Returns explicitly requested properties.

header Parameters
X-Request-id
string <uuid>

Random UID that you can assign to a request for idempotence and async action progress tracking.

Note that an operation is idempotent only during 5 minute time interval.

Example: ba547d14-c556-42bb-b85c-eeeb16e2f5e7
X-Client-Version
string

Version of Veeam Service Provider Console RESTful API supported by client.

Example: 3.6.1
Responses
200

OK

202

Request has been queued for execution.

default

All client errors (400–499) are returned with the associated HTTP status codes. All server errors (≥500) are returned with the 520 HTTP status code. For details, see the response body.

get/infrastructure/sites/{siteUid}/vcdServers/vcdOrganizations/{vcdOrganizationUid}/vDCs
Request samples
Response samples
application/json
{
  • "data": [
    ],
  • "meta": {
    }
}

Get Organization VDC Managed by Veeam Cloud Connect Site

Returns a resource representation of an organization VDC with the specified UID managed by a Veeam Cloud Connect site.

Request
path Parameters
vdcUid
required
string <uuid>

Organization VDC UID.

siteUid
required
string <uuid>

Veeam Cloud Connect site UID.

query Parameters
Array of objects or null (SelectParameter)

Returns explicitly requested properties.

header Parameters
X-Request-id
string <uuid>

Random UID that you can assign to a request for idempotence and async action progress tracking.

Note that an operation is idempotent only during 5 minute time interval.

Example: ba547d14-c556-42bb-b85c-eeeb16e2f5e7
X-Client-Version
string

Version of Veeam Service Provider Console RESTful API supported by client.

Example: 3.6.1
Responses
200

OK

202

Request has been queued for execution.

default

All client errors (400–499) are returned with the associated HTTP status codes. All server errors (≥500) are returned with the 520 HTTP status code. For details, see the response body.

get/infrastructure/sites/{siteUid}/vcdServers/vcdOrganizations/vDCs/{vdcUid}
Request samples
Response samples
application/json
{
  • "data": {
    }
}

Get Users of VMware Cloud Director Organizations Managed by All Veeam Cloud Connect Sites

Returns a collection resource representation of users of VMware Cloud Director organizations managed by all Veeam Cloud Connect sites.

Request
query Parameters
Array of objects or null (FilterParameter)

Specifies the conditions that a resource must meet to be returned in the output.

Array of objects or null (SortParameter)

Specifies the order in which resources are returned from the collection.

limit
integer <int32> [ 1 .. 500 ]
Default: 100

Specifies the first N resources that must be returned in the output.

offset
integer <int32> [ 0 .. 2147483647 ]
Default: 0

Excludes the first N resources from the query output.

Array of objects or null (SelectParameter)

Returns explicitly requested properties.

header Parameters
X-Request-id
string <uuid>

Random UID that you can assign to a request for idempotence and async action progress tracking.

Note that an operation is idempotent only during 5 minute time interval.

Example: ba547d14-c556-42bb-b85c-eeeb16e2f5e7
X-Client-Version
string

Version of Veeam Service Provider Console RESTful API supported by client.

Example: 3.6.1
Responses
200

OK

202

Request has been queued for execution.

default

All client errors (400–499) are returned with the associated HTTP status codes. All server errors (≥500) are returned with the 520 HTTP status code. For details, see the response body.

get/infrastructure/sites/vcdServers/vcdOrganizations/users
Request samples
Response samples
application/json
{
  • "data": [
    ],
  • "meta": {
    }
}

Get Users of All VMware Cloud Director Organizations Managed by Veeam Cloud Connect Site

Returns a collection resource representation of users of all VMware Cloud Director organizations managed by a Veeam Cloud Connect site with the specified UID.

Request
path Parameters
siteUid
required
string <uuid>

Veeam Cloud Connect site UID.

query Parameters
Array of objects or null (FilterParameter)

Specifies the conditions that a resource must meet to be returned in the output.

Array of objects or null (SortParameter)

Specifies the order in which resources are returned from the collection.

limit
integer <int32> [ 1 .. 500 ]
Default: 100

Specifies the first N resources that must be returned in the output.

offset
integer <int32> [ 0 .. 2147483647 ]
Default: 0

Excludes the first N resources from the query output.

Array of objects or null (SelectParameter)

Returns explicitly requested properties.

header Parameters
X-Request-id
string <uuid>

Random UID that you can assign to a request for idempotence and async action progress tracking.

Note that an operation is idempotent only during 5 minute time interval.

Example: ba547d14-c556-42bb-b85c-eeeb16e2f5e7
X-Client-Version
string

Version of Veeam Service Provider Console RESTful API supported by client.

Example: 3.6.1
Responses
200

OK

202

Request has been queued for execution.

default

All client errors (400–499) are returned with the associated HTTP status codes. All server errors (≥500) are returned with the 520 HTTP status code. For details, see the response body.

get/infrastructure/sites/{siteUid}/vcdServers/vcdOrganizations/users
Request samples
Response samples
application/json
{
  • "data": [
    ],
  • "meta": {
    }
}

Get Users of VMware Cloud Director Organization Managed by Veeam Cloud Connect Site

Returns a collection resource representation of all users of a VMware Cloud Director organization with the specified UID managed by a Veeam Cloud Connect site.

Request
path Parameters
vcdOrganizationUid
required
string <uuid>

VMware Cloud Director organization UID.

siteUid
required
string <uuid>

Veeam Cloud Connect site UID.

query Parameters
Array of objects or null (FilterParameter)

Specifies the conditions that a resource must meet to be returned in the output.

Array of objects or null (SortParameter)

Specifies the order in which resources are returned from the collection.

limit
integer <int32> [ 1 .. 500 ]
Default: 100

Specifies the first N resources that must be returned in the output.

offset
integer <int32> [ 0 .. 2147483647 ]
Default: 0

Excludes the first N resources from the query output.

Array of objects or null (SelectParameter)

Returns explicitly requested properties.

header Parameters
X-Request-id
string <uuid>

Random UID that you can assign to a request for idempotence and async action progress tracking.

Note that an operation is idempotent only during 5 minute time interval.

Example: ba547d14-c556-42bb-b85c-eeeb16e2f5e7
X-Client-Version
string

Version of Veeam Service Provider Console RESTful API supported by client.

Example: 3.6.1
Responses
200

OK

202

Request has been queued for execution.

default

All client errors (400–499) are returned with the associated HTTP status codes. All server errors (≥500) are returned with the 520 HTTP status code. For details, see the response body.

get/infrastructure/sites/{siteUid}/vcdServers/vcdOrganizations/{vcdOrganizationUid}/users
Request samples
Response samples
application/json
{
  • "data": [
    ],
  • "meta": {
    }
}

Document updated 11/06/2025

Page content applies to build 9.1.0.30345