4. API overview

Subject
Action
ActivityLogFilter
ActivityReport
ActivityReportSubscription
Address
Analytics
Application
AuditLog
BackupPolicy
BackupServerReport
BillingCycle
BillingData
BillingDataDeliveryConfig
Brand
BusinessUnit
ClientOption
ClientOptionName
ClientOptionSet
CohesityDataSource
CohesityServer
Comment
CommentType
ComplianceReport
ComplianceSummary
ComplianceTemplate
ConsoleQuery
Consumer
ConsumerReport
Consumption
Contract
ContractException
Country
Currency
DataCenter
DataView
DataViewConfig
DeleteProcess
DeleteRequest
DeleteRequestSettings
Domain
Download
DurationUnit
EventDurationSetting
Export
ExportDataSubscription
Filespace
Hypervisor
HypervisorReport
IdentityProvider
Invoice
InvoiceFile
Job
JobDeliveryConfig
JobIncidentConfig
JobName
JobQueue
JobSeverityConfig
JobSubscription
JobView
Language
License
ManagementClass
Microsoft365Account
Microsoft365AccountReport
Microsoft365RestorePoint
Microsoft365Tenant
Microsoft365TenantReport
NamingRule
Node
NodeActivationRule
NodeAssignmentFilter
NodeDeletionRule
NodeGroup
NodeNamingRule
NodeOperatingSystem
NodeOsLevel
NodePasswordRule
NodePlatform
NodeReport
NodeReportDeliveryConfig
NodeReportFilter
NodeReportSubscription
NodeSyncState
NodeTsmClientVersion
NodeType
PasswordRuleType
PaymentTerms
PeriodUnit
PointBucket
PointBucketPreset
PointPartition
PointServer
PointUser
PolicySet
Product
Referral
RemoteActivity
RemoteReport
ReportErrorConfig
RestorePoint
RetentionRule
RetentionSet
Role
RubrikDataSource
RubrikFileset
RubrikFilesetTemplate
RubrikRequest
RubrikServer
RubrikSnapshot
Saml
Schedule
ScheduleBinding
Search
ServerCredentials
ServerReportDeliveryConfig
ServiceLevelAgreement
SlaDomain
Smtp
SpPlusServer
SpServer
StatusReport
StatusReportConsumptionUnitDeliveryConfig
StatusReportDeliveryConfig
StatusReportEmailContent
StatusReportSubscription
StatusReportView
StoragePool
Subscription
SubscriptionComponent
SubscriptionLog
System
SystemErrorDeliveryConfig
SystemSetting
Tag
TimeZone
TotpSettings
TsmRequest
User
VirtualMachineReport
Vm
VmAssignmentFilter
VmReport

Action

Action operations

APIDescription
GET v1/actions

Get all actions available in the system.

GET v1/actions/{actionId}

Get a specific action.

ActivityLogFilter

Activity log filters are used to remove activity logs that should not cause a warning for the backup node

APIDescription
GET v1/bunits/{bunitId}/consumers/{consumerId}/node/activitylogfilters

Get a list of all filters related to a backup node of a consumer

GET v1/bunits/{bunitId}/consumers/{consumerId}/node/activitylogfilters/{activityLogFilterId}

Get a filter related to a backup node of a consumer

POST v1/bunits/{bunitId}/consumers/{consumerId}/node/activitylogfilters

Create a filter and at it to the back up node of a consumer

PUT v1/bunits/{bunitId}/consumers/{consumerId}/node/activitylogfilters/{activityLogFilterId}

Update a filter

DELETE v1/bunits/{bunitId}/consumers/{consumerId}/node/activitylogfilters/{activityLogFilterId}

Delete a filter

ActivityReport

APIDescription
GET v1/bunits/{bunitId}/activityreports?startDate={startDate}&endDate={endDate}

Get all reports for each day in the period.
If no dates are specified the report of the current date is returned

GET v1/bunits/{bunitId}/activityreports/{reportDate}?startDate={startDate}

Get information about all activity within a given period.
Returns one activity report with information about all activities

GET v1/bunits/{bunitId}/reports/latest

Gets the latest created report

ActivityReportSubscription

activity report subscriptions enable sending emails when new reports are available.

APIDescription
GET v1/bunits/{bunitId}/activityreportsubscriptions

Get all activity report subscriptions of a business unit

GET v1/bunits/{bunitId}/activityreportsubscriptions/{ActivityReportSubscriptionId}

Get a activity report subscription

POST v1/bunits/{bunitId}/activityreportsubscriptions

Create a activity report subscription for a business unit

PUT v1/bunits/{bunitId}/activityreportsubscriptions/{ActivityReportSubscriptionId}

Update a activity report subscription

PATCH v1/bunits/{bunitId}/activityreportsubscriptions/{activityReportSubscriptionId}

Overwrites the resource's property values with the values specified in the delta object.

DELETE v1/bunits/{bunitId}/activityreportsubscriptions/{ActivityReportSubscriptionId}

Delete a activity report subscription

Address

Business units can have multiple addresses and some are used for different things, e.g. invoicing.

APIDescription
GET v1/addresstypes

Get the available AddressTypes.

GET v1/addresstypes/{addressTypeId}

Get an AddressType.

GET v1/bunits/{bunitId}/addresses

Get all addresses of a business unit.

GET v1/bunits/{bunitId}/addresses/{addressId}

Get a single address of a business unit.

POST v1/bunits/{bunitId}/addresses

Create an address.

PUT v1/bunits/{bunitId}/addresses/{addressId}

Updates an existing address.

DELETE v1/bunits/{bunitId}/addresses/{addressId}

Deletes an address.

Analytics

Business units can have multiple addresses and some are used for different things, e.g. invoicing.

APIDescription
GET v1/bunits/{bunitId}/analytics/nodes?analyticsDate={analyticsDate}

Get node reports for all nodes of the business unit and its descendants.

GET v1/bunits/{bunitId}/analytics/datasources?analyticsDate={analyticsDate}

Get node reports for all data-sources of the business unit and its descendants.

GET v1/bunits/{bunitId}/analytics/businessunits?analyticsDate={analyticsDate}

Get analytics for business unit and its descendants.

Application

End points for applications

APIDescription
GET v1/bunits/{bunitId}/applications

Get all applications of a business unit.

GET v1/bunits/{bunitId}/applications/{applicationId}

Get a single application of a business unit.

POST v1/bunits/{bunitId}/applications

Create an application.

PUT v1/bunits/{bunitId}/applications/{applicationId}

Update an application.

DELETE v1/bunits/{bunitId}/applications/{applicationId}

Deletes an application.

AuditLog

Whenever the state of a Cloutility object is changed by a user, an audit log is saved. This controller exposes data about these log entries.

APIDescription
GET v1/bunits/{bunitId}/auditlogs?types[0]={types[0]}&types[1]={types[1]}&includeDescendants={includeDescendants}&startTime={startTime}&endTime={endTime}

Get all audit log entries that involves the business unit. There are three ways a business unit can be involved in an audit log entry. Either it is the performing business unit, the target business unit or both.

GET v1/bunits/{bunitId}/consumers/{consumerId}/auditlogs?types[0]={types[0]}&types[1]={types[1]}

Get all audit log entries for a consumption unit

GET v1/bunits/{bunitId}/consumers/{consumerId}/node/auditlogs?types[0]={types[0]}&types[1]={types[1]}

Get all audit log entries for a backup node

GET v1/bunits/{bunitId}/consumers/{consumerId}/vmfilespace/auditlogs?types[0]={types[0]}&types[1]={types[1]}

Get all audit log entries for a vm

GET v1/bunits/{bunitId}/consumers/{consumerId}/hypervisor/auditlogs?types[0]={types[0]}&types[1]={types[1]}

Get all audit log entries for a hypervisor

GET v1/bunits/{bunitId}/consumers/{consumerId}/vm/auditlogs?types[0]={types[0]}&types[1]={types[1]}

Get all audit log entries for a vm

GET v1/bunits/{bunitId}/consumers/{consumerId}/microsoft365tenant/auditlogs?types[0]={types[0]}&types[1]={types[1]}

Get all audit log entries for a Microsoft 365 tenant

GET v1/bunits/{bunitId}/consumers/{consumerId}/microsoft365account/auditlogs?types[0]={types[0]}&types[1]={types[1]}

Get all audit log entries for a Microsoft 365 account

GET v1/bunits/{bunitId}/consumers/{consumerId}/rubrikdatasource/auditlogs?types[0]={types[0]}&types[1]={types[1]}

Get all audit log entries for a Rubrik data-source

GET v1/bunits/{bunitId}/consumers/{consumerId}/cohesitydatasource/auditlogs?types[0]={types[0]}&types[1]={types[1]}

Get all audit log entries for a Cohesity data-source

GET v1/bunits/{bunitId}/consumers/{consumerId}/pointbucket/auditlogs?types[0]={types[0]}&types[1]={types[1]}

Get all audit log entries for a PoINT bucket

GET v1/bunits/{bunitId}/users/{userId}/auditlogs?types[0]={types[0]}&types[1]={types[1]}

Get all audit log entries for a user.

GET v1/bunits/{bunitId}/applications/{applicationId}/auditlogs?types[0]={types[0]}&types[1]={types[1]}

Get all audit log entries for an application.
The result is ordered first by error type and then by ID.

DELETE v1/bunits/{bunitId}/applications/{applicationId}/auditlogs/{auditLogId}

Delete an audit log by relation of a user.

BackupPolicy

Backup policy

APIDescription
GET v1/bunits/{bunitId}/datacenters/{dataCenterId}/spplusservers/{spPlusServerId}/backuppolicies?sync={sync}

Get all backup policies of a server.

BackupServerReport

Servers in data center

APIDescription
GET v1/bunits/{bunitId}/datacenters/{dataCenterId}/spservers/{spServerId}/reports

Get backup server reports for an IBM Storage Protect server

GET v1/bunits/{bunitId}/datacenters/{dataCenterId}/spservers/{spServerId}/reports/{reportDate}

Get backup server report for an IBM Storage Protect server for a certain date

GET v1/bunits/{bunitId}/datacenters/{dataCenterId}/spplusservers/{spPlusServerId}/reports

Get backup server reports for an IBM Storage Protect Plus server

GET v1/bunits/{bunitId}/datacenters/{dataCenterId}/spplusservers/{spPlusServerId}/reports/{reportDate}

Get backup server report for an IBM Storage Protect Plus server for a certain date

GET v1/bunits/{bunitId}/datacenters/{dataCenterId}/rubrikservers/{rubrikServerId}/reports

Get backup server reports for a Rubrik server

GET v1/bunits/{bunitId}/datacenters/{dataCenterId}/rubrikservers/{rubrikServerId}/reports/{reportDate}

Get backup server report for a Rubrik server for a certain date

GET v1/bunits/{bunitId}/datacenters/{dataCenterId}/pointservers/{pointServerId}/reports

Get backup server reports for a PoINT server

GET v1/bunits/{bunitId}/datacenters/{dataCenterId}/pointservers/{pointServerId}/reports/{reportDate}

Get backup server report for a PoINT server for a certain date

GET v1/bunits/{bunitId}/datacenters/{dataCenterId}/cohesityservers/{cohesityServerId}/reports

Get backup server reports for a Cohesity server

GET v1/bunits/{bunitId}/datacenters/{dataCenterId}/cohesityservers/{cohesityServerId}/reports/{reportDate}

Get backup server report for a Cohesity server for a certain date

BillingCycle

Billing cycle operations

APIDescription
GET v1/billingcycles

Get all billing cycles.

GET v1/billingcycles/{billingCycleId}

Get a billing cycle.

BillingData

Billing data is generated automatically by a process that runs daily.

APIDescription
GET v1/bunits/{bunitId}/billing?includeNext={includeNext}

Returns a list of available billing dates for a business unit.

GET v1/bunits/{bunitId}/billing/{date}?useForecasting={useForecasting}

Returns the billing data for the specified date. If the date is in the future, simulated billing data will be generated.

BillingDataDeliveryConfig

Status report delivery configurations enable sending emails when new reports are available.

APIDescription
GET v1/bunits/{bunitId}/billingdatadeliveryconfigs

Get billing data delivery configs of a business unit

GET v1/bunits/{bunitId}/billingdatadeliveryconfigs/{deliveryConfigId}

Get a billing data delivery config

POST v1/bunits/{bunitId}/billingdatadeliveryconfigs

Create a billing data delivery config

PUT v1/bunits/{bunitId}/billingdatadeliveryconfigs/{deliveryConfigId}

Save changes to a billing data delivery config

PATCH v1/bunits/{bunitId}/billingdatadeliveryconfigs/{deliveryConfigId}

Overwrites the resource's property values with the values specified in the delta object.

DELETE v1/bunits/{bunitId}/billingdatadeliveryconfigs/{deliveryConfigId}

Delete a billing data delivery config

GET v1/bunits/{bunitId}/billingdatadeliveryconfigs/verify?postUrl={postUrl}

Verify a post URL by sending a post request

Brand

APIDescription
GET v1/bunits/{bunitId}/brand

Get the brand configuration for a business unit.

POST v1/bunits/{bunitId}/brand

Create a brand configuration for a business unit.

PUT v1/bunits/{bunitId}/brand

Update existing brand settings.

DELETE v1/bunits/{bunitId}/brand

Delete a business unit's brand settings.

BusinessUnit

Business units make up the heirarchical center of data in Cloutility. Their goal is to represent companies, divisions or any other meaningful entity or logical group.

APIDescription
GET v1/bunits?bunitId={bunitId}

Returns the descendant tree of the active profile's business unit.

GET v1/bunits/{bunitId}/movedestinations

Returns a tree containing all possible destinations a business unit can be moved to

GET v1/bunits/{bunitId}/bunits

Get business units directly related to a specific business unit.

GET v1/bunits/{bunitId}/ancestors

Get the path from the active business unit to the current user's business unit - both included.

GET v1/bunits/{bunitId}/provider

Returns the first ancestor of the requesting business unit that has a contract.
The provider is the business unit will be invoicing the requesting business unit.

GET v1/bunits/{bunitId}/supportresponsible

Get the business unit responsible for supporting the provided business unit

POST v1/bunits/{bunitId}/bunits?deleteReferrals={deleteReferrals}

Add a business unit.


If the added business unit is an existing business unit, it will be moved to the new parent if possible.
A business unit can be moved if it has no contract or nodes connected to it.

GET v1/bunits/{bunitId}

Get a single business unit.

GET v1/bunits/{bunitId}/latestReportTime

Returns a timestamp for when the status report of the business unit was last updated

PUT v1/bunits/{bunitId}

Update business unit.

PATCH v1/bunits/{bunitId}

Overwrites the resource's property values with the values specified in the delta object.

DELETE v1/bunits/{bunitId}?deleteChildren={deleteChildren}&deleteConsumers={deleteConsumers}&deleteServers={deleteServers}&anonymize={anonymize}

Delete a business unit.

GET v1/bunits/{bunitId}/locknodeinformation
PUT v1/bunits/{bunitId}/locknodeinformation
GET v1/bunits/{bunitId}/availableServerTypes

Get types of servers owned by business unit or it's ancestors.
This information is relevant when it is needed to know what information can be created for the business unit

ClientOption

Client options (has SP commands)

APIDescription
GET v1/bunits/{bunitId}/datacenters/{dataCenterId}/spservers/{spServerId}/clientoptionsets/{clientOptionSetId}/clientoptions?tsmSync={tsmSync}

Get all options of a client option set
(SP)

GET v1/bunits/{bunitId}/datacenters/{dataCenterId}/spservers/{spServerId}/clientoptionsets/{clientOptionSetId}/clientoptions/{clientOptionId}

Get a single client option.

POST v1/bunits/{bunitId}/datacenters/{dataCenterId}/spservers/{spServerId}/clientoptionsets/{clientOptionSetId}/clientoptions

Create a client option on a client option set.
(SP)

PUT v1/bunits/{bunitId}/datacenters/{dataCenterId}/spservers/{spServerId}/clientoptionsets/{clientOptionSetId}/clientoptions/{clientOptionId}

Update a client option.
(SP)

DELETE v1/bunits/{bunitId}/datacenters/{dataCenterId}/spservers/{spServerId}/clientoptionsets/{clientOptionSetId}/clientoptions/{clientOptionId}

Delete client option.
(SP)

ClientOptionName

ClientOptionName operations

APIDescription
GET v1/clientOptionNames

Get all ClientOptionNames available in the system.

GET v1/clientOptionNames/{clientOptionNameId}

Get a specific ClientOptionName.

ClientOptionSet

Client options sets (has SP commands)

APIDescription
GET v1/bunits/{bunitId}/datacenters/{dataCenterId}/spservers/{spServerId}/clientoptionsets?tsmSync={tsmSync}

Get all COSs of server.

GET v1/bunits/{bunitId}/defaultserver/clientoptionsets

Get all default COSs for when creating nodes for a business unit.

GET v1/bunits/{bunitId}/datacenters/{dataCenterId}/spservers/{spServerId}/clientoptionsets/{clientOptionSetId}

Get a single COS.

POST v1/bunits/{bunitId}/datacenters/{dataCenterId}/spservers/{spServerId}/clientoptionsets

Create a COS on a server.
(SP)

PUT v1/bunits/{bunitId}/datacenters/{dataCenterId}/spservers/{spServerId}/clientoptionsets/{clientOptionSetId}

Update a COS.
(SP)

DELETE v1/bunits/{bunitId}/datacenters/{dataCenterId}/spservers/{spServerId}/clientoptionsets/{clientOptionSetId}

Delete COS.
(SP)

CohesityDataSource

Cohesity data-sources

APIDescription
GET v1/bunits/{bunitId}/unassignedCohesityHosts

Get all primary Cohesity data-sources located on servers of the business unit that are not assigned to a business unit

POST v1/bunits/{bunitId}/unassignedCohesityHosts /{cohesityDataSourceId}?bunitIdToLink={bunitIdToLink}

Assign a list of primary Cohesity data-sources to a business unit
A consumption unit for each Cohesity data-source will be created

GET v1/bunits/{bunitId}/cohesityTenants

Get secondary Cohesity data-sources related to data-sources of a business unit
These are or can be related to the business unit or descendants of the business unit

POST v1/bunits/{bunitId}/cohesityTenants

Assign a list of secondary Cohesity data-sources to a business unit
A consumption unit for each Cohesity data-source will be created

GET v1/bunits/{bunitId}/consumers/{consumerId}/cohesitydatasource

Get a Cohesity data-source related to a consumption unit

PUT v1/bunits/{bunitId}/consumers/{consumerId}/cohesitydatasource

Update the information of a Cohesity data-source

DELETE v1/bunits/{bunitId}/consumers/{consumerId}/cohesitydatasource

Unassign a Cohesity data-source from a business unit
This will delete the consumption unit that relates the Cohesity data-source to the business unit

GET v1/bunits/{bunitId}/consumers/{consumerId}/cohesitydatasource/cohesityTenants

Get secondary data-sources related to a data-source

CohesityServer

Cohesity servers in data center

APIDescription
GET v1/bunits/{bunitId}/datacenters/{dataCenterId}/cohesityservers

Get all Cohesity servers related to a data center.

GET v1/bunits/{bunitId}/datacenters/{dataCenterId}/cohesityservers/{CohesityServerId}

Get a single server.

GET v1/bunits/{bunitId}/defaultrubrikserver

Get the default server of a business unit
The server used when creating new data-sources. If a business unit has no server selected, a default server will be assigned
based on certain criteria: Does the business unit have a data center and if so is there a default server in this data center?
If not find the default server of the parent using the same criteria: Is one selected => does a data center with a default server exist => inheritance.

GET v1/bunits/{bunitId}/fallbackrubrikserver

Get the fallback server of a business unit
This will be the server set as default for the business unit if none is selected.
The rules for finding it is the same as the default server but the currently selected server will
not be considered. If none is selected for the business unit the default server and the fallback server
will be the same.
This server is used to inform about which server will be used if the currently selected is removed

POST v1/bunits/{bunitId}/datacenters/{dataCenterId}/cohesityservers

Create a new server and starts a synchronization process.

GET v1/bunits/{bunitId}/datacenters/{dataCenterId}/cohesityservers/{CohesityServerId}/sync

Force synchronization with the SP environment.

PUT v1/bunits/{bunitId}/datacenters/{dataCenterId}/cohesityservers/{CohesityServerId}

Update a server.

PATCH v1/bunits/{bunitId}/datacenters/{dataCenterId}/cohesityservers/{CohesityServerId}

Overwrites the resource's property values with the values specified in the delta object.

DELETE v1/bunits/{bunitId}/datacenters/{dataCenterId}/cohesityservers/{CohesityServerId}?deleteDataSources={deleteDataSources}

Delete a server.

GET v1/bunits/{bunitId}/datacenters/{dataCenterId}/cohesityservers/{CohesityServerId}/logs

Get logs of a server

Comment

Get comments of a consumption unit

APIDescription
POST v1/bunits/{bunitId}/comments

Create multiple comments (from form-data).

POST v1/bunits/{bunitId}/consumers/{consumerId}/comments

Create a comment.

GET v1/bunits/{bunitId}/consumers/{consumerId}/comments/{commentId}

Get a single comment.

GET v1/bunits/{bunitId}/consumers/{consumerId}/comments?includeDetails={includeDetails}&types[0]={types[0]}&types[1]={types[1]}

Get all comments of a consumption unit

DELETE v1/bunits/{bunitId}/consumers/{consumerId}/comments/{commentId}

Delete a comment.

PUT v1/bunits/{bunitId}/consumers/{consumerId}/comments/{commentId}

Update a comment.

GET v1/bunits/{bunitId}/consumers/{consumerId}/comments/{commentId}/attachments/{attachmentId}

Download an attachment of a comment

CommentType

Node comment types

APIDescription
GET v1/commenttypes

Get all comment types available in the system.

GET v1/commenttypes/{commentTypeId}

Get a specific comment type

ComplianceReport

Information on how well a business unit has met it's SLA within a given month

APIDescription
POST v1/bunits/{bunitId}/complianceReports?year={year}&month={month}&format={format}

Get the compliance report of a specified month

ComplianceSummary

Information on how well a business unit has met it's SLA within a given month

APIDescription
GET v1/bunits/{bunitId}/complianceSummaries?recalculate={recalculate}

Get all summaries of a business unit

GET v1/bunits/{bunitId}/complianceSummaries/{year}/{month}?recalculate={recalculate}

Get the summary of a specified month

ComplianceTemplate

Template for A business unit can upload invoice files to Cloutility for its customers to download

APIDescription
GET v1/bunits/{bunitId}/ComplianceTemplate/download

Returns template file for compliance report
This can be either own or inherited but always applicable for current business unit

GET v1/bunits/{bunitId}/ComplianceTemplate

Returns true if business unit has own template
Returns false if business unit has inherited template
If no template exists Not found error is thrown

POST v1/bunits/{bunitId}/ComplianceTemplate

Upload a template for compliance report

DELETE v1/bunits/{bunitId}/ComplianceTemplate

Delete a template for compliance report

ConsoleQuery

A console query is a saved IBM Storage Protect query that can be used by all users of a business unit

APIDescription
GET v1/bunits/{bunitId}/consolequeries

Get all console queries of a business unit

GET v1/bunits/{bunitId}/consolequeries/{consoleQueryId}

Get a console query

DELETE v1/bunits/{bunitId}/consolequeries/{consoleQueryId}

Delete a console query

POST v1/bunits/{bunitId}/consolequeries

Create a console query

PUT v1/bunits/{bunitId}/consolequeries/{consoleQueryId}

Update a console query

PATCH v1/bunits/{bunitId}/consolequeries/{consoleQueryId}

Update a console query

Consumer

Consumption units are a representation and relation between data-sources and business units.

APIDescription
GET v1/bunits/{bunitId}/consumers?includeDescendants={includeDescendants}

Get all consumption units of the business unit

GET v1/bunits/{bunitId}/consumers/{consumerId}

Get a single consumption unit

GET v1/bunits/{bunitId}/consumers/count

Get count of all consumption units of the business unit

GET v1/consumers/{consumerId}

Get details for a single (accessible) consumption unit (regardless of which business unit it's related to)

PUT v1/bunits/{bunitId}/consumers/{consumerId}

Update the information of a consumption unit

POST v1/bunits/{bunitId}/consumers

Add a consumption unit to a business unit.
If the consumption unit already exists on another business unit, it will be moved. Otherwise the consumption unit will be created.

POST v1/bunits/{bunitId}/consumers/multiple

Add a list of consumption units to a business unit.
If a consumption unit already exists on another business unit, it will be moved. Otherwise the consumption unit will be created.

PATCH v1/bunits/{bunitId}/consumers/{consumerId}

Overwrites the resource's property values with the values specified in the delta object.

DELETE v1/bunits/{bunitId}/consumers/{consumerId}?deleteAssociations={deleteAssociations}&unassignSecondaryDataSources={unassignSecondaryDataSources}&deletionComment={deletionComment}

Delete a consumption unit

GET v1/bunits/{bunitId}/consumers/{consumerId}/destinations

A list of business units that are possible targets for moving a consumption unit.
Destinations depends on properties of the consumption unit and the current user.
If the consumption unit has a backup node; The list consists of all business units that have access to the same server as the backup node
If the consumption unit has a VM file space; The list consists of all business units that have access to the backup node where the file space originates
Else the lists consists of all descendants of the user.

POST v1/consumerdestinations

A list of business units that are possible targets for moving a list of consumption units.
Destinations depends on properties of the consumption unit and the current user.
If the consumption unit has a backup node; The list consists of all business units that have access to the same server as the backup node
If the consumption unit has a VM file space; The list consists of all business units that have access to the backup node where the file space originates
Else the lists consists of all descendants of the user.

POST v1/supportstatus?supportStatusId={supportStatusId}

Update support status of the consumption unit for the current date

GET v1/bunits/{bunitId}/consumers/nodatasources?includeDescendants={includeDescendants}
GET v1/bunits/{bunitId}/consumers/{consumerId}/events
GET v1/bunits/{bunitId}/consumers/{consumerId}/activities
GET v1/bunits/{bunitId}/consumers/{consumerId}/suggestedbucketname

If creating an S3 bucket for a consumption unit and auto-generated name is used, this is a preview of what it will be.

ConsumerReport

Reports contain information about the hypervisor, its backups and status You can get the first and latest report to get information about when reports have been made Get all reports to display graphs of development for data

APIDescription
GET v1/bunits/{bunitId}/consumers/{consumerId}/reports?startDate={startDate}&endDate={endDate}&status={status}&warnings={warnings}

Get reports for a consumption unit

GET v1/bunits/{bunitId}/consumers/{consumerId}/reports/{reportDate}?userId={userId}

Get report for a specified date.

GET v1/bunits/{bunitId}/consumers/{consumerId}/reports/latest?userId={userId}

Returns the latest report for the consumption unit.

GET v1/bunits/{bunitId}/consumers/{consumerId}/reports/first?userId={userId}

Returns the first report for the specified consumption unit

GET v1/bunits/{bunitId}/consumers/{consumerId}/reports/{reportDate}/send?subscriptionId={subscriptionId}

Send a backup node report to the recipients of a backup node report delivery configuration.

Consumption

APIDescription
GET v1/bunits/{bunitId}/consumption?startDate={startDate}&endDate={endDate}&detailLevel={detailLevel}&includeConsumptionUnits={includeConsumptionUnits}&includeDescendants={includeDescendants}

Get consumptiondata related to a business unit.
This will include all consumption of
descendant business units and consumption units

GET v1/bunits/{bunitId}/consumers/{consumerId}/consumption?startDate={startDate}&endDate={endDate}&detailLevel={detailLevel}

Get consumption data related to a consumption unit

POST v1/bunits/{bunitId}/consumption

Create consumption related to a business unit

POST v1/bunits/{bunitId}/consumption/multiple

Create multiple consumptions to units in the business units hierarchy.
For each consumption a consumption unit or a business unit should be given
for the system to know what the consumption is related to.

POST v1/bunits/{bunitId}/consumers/{consumerId}/consumption

Create consumption related to a consumption unit

PUT v1/bunits/{bunitId}/consumption/{consumptionId}

Update a consumption

PUT v1/bunits/{bunitId}/consumers/{consumerId}/consumption/{consumptionId}

Update a consumption

DELETE v1/bunits/{bunitId}/consumption/{consumptionId}

Delete a consumption

DELETE v1/bunits/{bunitId}/consumers/{consumerId}/consumption/{consumptionId}

Delete a consumption

Contract

Contract hold information about the economical aspects between a business unit and its ancestor

APIDescription
GET v1/bunits/{bunitId}/contract

Get the contract for a business unit.

POST v1/bunits/{bunitId}/contract

Create a contract for a business unit.

PUT v1/bunits/{bunitId}/contract

Update existing contract.

DELETE v1/bunits/{bunitId}/contract

Delete a business unit's contract.

ContractException

Exceptions to the contract of the business unit

APIDescription
GET v1/bunits/{bunitId}/contract/exceptions

Get a list of all contract exceptions for the contract of the given business unit

GET v1/bunits/{bunitId}/contract/exceptions/{exceptionId}

Get an exception for a contract of a business unit

POST v1/bunits/{bunitId}/contract/exceptions

Create an exception

PUT v1/bunits/{bunitId}/contract/exceptions/{exceptionId}

Update an exception

DELETE v1/bunits/{bunitId}/contract/exceptions/{exceptionId}

Delete an exception from a contract

Country

Country operations

APIDescription
GET v1/countries

Get all countries.

GET v1/countries/{countryId}

Get a specific country.

Currency

Billing cycle operations

APIDescription
GET v1/currencies?bunitId={bunitId}

Get all billing cycles.

GET v1/currencies/{currencyId}?billingCycleId={billingCycleId}

Get a billing cycle.

DataCenter

Data centers

APIDescription
GET v1/bunits/{bunitId}/datacenters?includeDescendants={includeDescendants}

Get all data centers of a business unit.

GET v1/bunits/{bunitId}/availabledatacenters

Get all data centers with servers assignable to the business unit by the user.

GET v1/bunits/{bunitId}/datacenters/{dataCenterId}

Get a single data center.

POST v1/bunits/{bunitId}/datacenters

Create a data center.

PUT v1/bunits/{bunitId}/datacenters/{dataCenterId}

Update a data center.

DELETE v1/bunits/{bunitId}/datacenters/{dataCenterId}

Delete a data center.

DataView

Data view operations

APIDescription
GET v1/dataviews

Get all data views.

GET v1/dataviews/{dataViewId}

Get a specific data view.

DataViewConfig

Status report delivery configurations enable sending emails when new reports are available.

APIDescription
GET v1/bunits/{bunitId}/dataviewconfigs

Get all data view configurations for a business unit

GET v1/bunits/{bunitId}/dataviewconfigs/{dataViewConfigId}

Get a specified data view configuration of a business unit

POST v1/bunits/{bunitId}/dataviewconfigs

Create a data view configuration for a business unit

PUT v1/bunits/{bunitId}/dataviewconfigs/{dataViewConfigId}

Update a data view configuration related to a business unit

DELETE v1/bunits/{bunitId}/dataviewconfigs/{dataViewConfigId}

Delete a data view configuration of a business unit

GET v1/bunits/{bunitId}/users/{userId}/dataviewconfigs

Get all data view configurations of a user

GET v1/bunits/{bunitId}/users/{userId}/dataviewconfigs/{dataViewConfigId}

Get a specified data view configuration of a user

POST v1/bunits/{bunitId}/users/{userId}/dataviewconfigs

Create a data view configuration for a user

PUT v1/bunits/{bunitId}/users/{userId}/dataviewconfigs/{dataViewConfigId}

Update a data view configuration related to a user

DELETE v1/bunits/{bunitId}/users/{userId}/dataviewconfigs/{dataViewConfigId}

Delete a data view configuration of a user

DeleteProcess

Nodes are backup clients (has SP commands)

APIDescription
POST v1/bunits/{bunitId}/deleteprocesses/{deleteProcessId}/reset

Reset a deletion process for either a backup node or a file space
This may be done if the deletion has failed on the IBM Storage Protect server

DeleteRequest

Deletion requests

APIDescription
GET v1/bunits/{bunitId}/deleterequests?statusIds[0]={statusIds[0]}&statusIds[1]={statusIds[1]}

Get all deletion requests relevant to the business unit

GET v1/bunits/{bunitId}/deleterequests/{deleteRequestId}

Get a deletion request

GET v1/bunits/{bunitId}/deleterequests/count

Get a count of pending deletion requests relevant to the business unit

POST v1/bunits/{bunitId}/deleterequests?includeAssignedItems={includeAssignedItems}&deleteVmFilespace={deleteVmFilespace}

Add a deletion request to a business unit.

DELETE v1/bunits/{bunitId}/deleterequests/{deleteRequestId}?rejectComment={rejectComment}

Reject a deletion request

POST v1/bunits/{bunitId}/deleterequests/reject?rejectComment={rejectComment}

Reject a deletion request

POST v1/bunits/{bunitId}/deleterequests/approve?deleteRequestId={deleteRequestId}

Approve a deletion request

POST v1/bunits/{bunitId}/deleterequests/approve

Approve a list of deletion requests

GET v1/bunits/{bunitId}/consumers/{consumerId}/deleterequest

Get deletion request of a consumption unit

DeleteRequestSettings

Deletion requests

APIDescription
GET v1/bunits/{bunitId}/DeleteRequestSettings

Get all deletion request settings of the business unit

GET v1/bunits/{bunitId}/DeleteRequestSettings/{deleteRequestSettingsId}

Get deletion request settings relevant to the business unit

GET v1/bunits/{bunitId}/DeleteRequestSettings/inherited

Get all deletion request settings inherited by the business unit

GET v1/bunits/{bunitId}/DeleteRequestSettings/possibledates?typeId={typeId}

Get deletion request settings relevant to the business unit

POST v1/bunits/{bunitId}/DeleteRequestSettings?allowLessRestrictive={allowLessRestrictive}

Add deletion request settings to a business unit.

PUT v1/bunits/{bunitId}/DeleteRequestSettings/{deleteRequestSettingsId}?allowLessRestrictive={allowLessRestrictive}

Update deletion request settings.

DELETE v1/bunits/{bunitId}/DeleteRequestSettings/{deleteRequestSettingsId}

Delete a deletion request

Domain

Domains (has SP commands)

APIDescription
GET v1/bunits/{bunitId}/datacenters/{dataCenterId}/spservers/{spServerId}/domains?tsmSync={tsmSync}

Get all domains of a server.

GET v1/bunits/{bunitId}/defaultserver/domains

Get all default domains for when creating nodes for a business unit.

GET v1/bunits/{bunitId}/datacenters/{dataCenterId}/spservers/{spServerId}/domains/{domainId}

Get a single domain.

POST v1/bunits/{bunitId}/datacenters/{dataCenterId}/spservers/{spServerId}/domains

Create a domain on a server.
(SP)

PUT v1/bunits/{bunitId}/datacenters/{dataCenterId}/spservers/{spServerId}/domains/{domainId}

Update a domain.
(SP)

DELETE v1/bunits/{bunitId}/datacenters/{dataCenterId}/spservers/{spServerId}/domains/{domainId}

Delete domain.
(SP)

Download

APIDescription
GET v1/download/{downloadGuid}

Download a file anonymously using a supplied one-time download GUID

DurationUnit

Duration unit operations

APIDescription
GET v1/durationUnits

Get all Duration units available in the system.

GET v1/durationUnits/{DurationUnitId}

Get a specific Duration unit.

EventDurationSetting

Event duration settings

APIDescription
GET v1/bunits/{bunitId}/datacenters/{dataCenterId}/eventDurationSetting

Get settings of a datacenter.

POST v1/bunits/{bunitId}/datacenters/{dataCenterId}/eventDurationSetting

Create settings for a datacenter

PUT v1/bunits/{bunitId}/datacenters/{dataCenterId}/eventDurationSetting

Update settings of a datacenter.

DELETE v1/bunits/{bunitId}/datacenters/{dataCenterId}/eventDurationSetting

Delete settings of a datacenter

Export

Endpoints used to export various data sets

APIDescription
GET v1/bunits/{bunitId}/export/serverlist?serverId={serverId}

OBSOLETE: Use bunit/{id}/export endpoint

GET v1/bunits/{bunitId}/export/nodelist?serverId={serverId}

OBSOLETE: Use bunit/{id}/export endpoint

GET v1/bunits/{bunitId}/export/datagrowth?startDate={startDate}&endDate={endDate}

OBSOLETE: Use bunit/{id}/export endpoint

GET v1/bunits/{bunitId}/export/invoicereceivers?getList={getList}

OBSOLETE: Use bunit/{id}/export endpoint

POST v1/bunits/{bunitId}/export

Get various exports from Cloutility

ExportDataSubscription

Export data subscriptions enable sending emails with export data.

APIDescription
GET v1/bunits/{bunitId}/exportDataSubscriptions?compliance={compliance}

Get all export data subscriptions of a business unit

GET v1/bunits/{bunitId}/exportDataSubscriptions/{exportDataSubscriptionId}

Get an export data subscription

POST v1/bunits/{bunitId}/exportDataSubscriptions

Create an export data subscription for a business unit

PUT v1/bunits/{bunitId}/exportDataSubscriptions/{exportDataSubscriptionId}

Update an export data subscription

PATCH v1/bunits/{bunitId}/exportDataSubscriptions/{exportDataSubscriptionId}?deliveryConfigId={deliveryConfigId}

Overwrites the resource's property values with the values specified in the delta object.

DELETE v1/bunits/{bunitId}/exportDataSubscriptions/{exportDataSubscriptionId}

Delete an export data subscription

GET v1/bunits/{bunitId}/exportDataSubscriptions/{exportDataSubscriptionId}/send

Send a subscription

Filespace

Accessing file spaces of a backup node

APIDescription
GET v1/bunits/{bunitId}/consumers/{consumerId}/node/filespaces?tsmSync={tsmSync}

Get all file spaces belonging to a specific backup node

GET v1/bunits/{bunitId}/vmfilespaces

Get all VM file spaces related to nodes of the business unit
These include both assigned and unassigned VM file spaces as long as they resides on nodes of the business unit

GET v1/bunits/{bunitId}/vmfilespaces/{filespaceId}?vmFilespaceId={vmFilespaceId}

Get a VM file space related to a backup node of the business unit
These can be both an assigned and unassigned VM file space as long as it resides on nodes of the business unit

POST v1/bunits/{bunitId}/vmfilespaces

Assign a VM file space to a business unit
This will create a consumption unit.
All data related to the VM file space will be substracted from that of the backup node

GET v1/bunits/{bunitId}/consumers/{consumerId}/vmfilespace

Get a VM file space of a consumption unit

DELETE v1/bunits/{bunitId}/consumers/{consumerId}/vmfilespace

Unassign a VM file space from a business unit
This will delete the consumption unit that relates the VM file space to the business unit
Any data related to the VM file space will be added to that of the backup node it is related to

GET v1/bunits/{bunitId}/consumers/{consumerId}/vmfilespace/datamover

Get datamover of VM file space

DELETE v1/bunits/{bunitId}/consumers/{consumerId}/vmfilespace/datamover

Unassign a VM file space from a datamover
This will not affect the VM on the SP server or the VM environment
but only prevents faulty jobs appearing on VM because SP is not able to
report on a severed related.

GET v1/bunits/{bunitId}/filespacestodelete

Get all file spaces with approved deletion requests

DELETE v1/bunits/{bunitId}/filespacestodelete?filespaceIds[0]={filespaceIds[0]}&filespaceIds[1]={filespaceIds[1]}

Delete file spaces from the IBM Storage Protect server

POST v1/bunits/{bunitId}/consumers/{consumerId}/node/filespaces/{filespaceId}/renamefilespace?newName={newName}

Rename file space on the IBM Storage Protect server

Hypervisor

Hypervisors

APIDescription
GET v1/bunits/{bunitId}/consumers/{consumerId}/hypervisor

Get a hypervisor related to a consumption unit

POST v1/bunits/{bunitId}/unassignedhypervisors?bunitIdToLink={bunitIdToLink}

Assign a list of hypervisors to a business unit
A consumption unit for each hypervisor will be created

PUT v1/bunits/{bunitId}/consumers/{consumerId}/hypervisor

Update the information of a hypervisor

DELETE v1/bunits/{bunitId}/consumers/{consumerId}/hypervisor

Unassign a hypervisor from a business unit
This will delete the consumption unit that relates the hypervisor to the business unit

GET v1/bunits/{bunitId}/unassignedhypervisors

Get all hypervisors located on IBM Storage Protect Plus servers of the business unit that are not assigned to a business unit

HypervisorReport

****** DEPRECATED, please use consumption unit report endpoint ****** Reports contain information about the hypervisor, its backups and status You can get the first and latest report to get information about when reports have been made Get all reports to display graphs of development for data

APIDescription
GET v1/bunits/{bunitId}/consumers/{consumerId}/hypervisor/reports?startDate={startDate}&endDate={endDate}&status={status}&warnings={warnings}

Get reports for a hyper visor

GET v1/bunits/{bunitId}/consumers/{consumerId}/hypervisor/reports/{reportDate}?userId={userId}

Returns the report for the hypervisor on the specified date.

GET v1/bunits/{bunitId}/consumers/{consumerId}/hypervisor/reports/latest?userId={userId}

Returns the latest report for the specified hypervisor.

GET v1/bunits/{bunitId}/consumers/{consumerId}/hypervisor/reports/first?userId={userId}

Returns the first report for the specified hypervisor.

IdentityProvider

Identity provides used for logging in

APIDescription
GET v1/bunits/{bunitId}/identityproviders

Get a list of all identity providers the business unit has created

GET v1/publicIdentityProviders

Get a list of all public identity providers
These can be displayed on the sign in page

GET v1/bunits/{bunitId}/identityproviders/available

A list of all the identity providers available for a business unit
This includes inherited identity providers as well

GET v1/bunits/{bunitId}/identityproviders/{identityProviderId}

Get an identity provider

POST v1/bunits/{bunitId}/identityproviders

Create an identity provider

POST v1/bunits/{bunitId}/identityproviders/{identityProviderId}/certificate

Upload a certificate to an identity provider

GET v1/bunits/{bunitId}/identityproviders/{identityProviderId}/users
PUT v1/bunits/{bunitId}/identityproviders/{identityProviderId}

Update an identity provider

DELETE v1/bunits/{bunitId}/identityproviders/{identityProviderId}

Delete an identity provider

Invoice

Billing data is generated automatically by a process that runs daily.

APIDescription
GET v1/bunits/{bunitId}/invoices

Returns a list of available invoices for a business unit.

GET v1/bunits/{bunitId}/invoices/{date}

Returns the invoice for the specified date. If the date is in the future, simulated billing data will be generated.

InvoiceFile

Invoice files contain real world invoices. A business unit can upload invoice files to Cloutility for its customers to download

APIDescription
GET v1/bunits/{bunitId}/invoicefiles

Returns a list of available invoice files for a business unit.

GET v1/bunits/{bunitId}/invoicefiles/{filename}?downloadUrl={downloadUrl}

Returns an invoice file.

POST v1/bunits/{bunitId}/invoicefiles?erpReference={erpReference}&sendToBillingAddress={sendToBillingAddress}

Upload an invoice file

Job

Information about jobs done for a consumption unit

APIDescription
GET v1/bunits/{bunitId}/consumers/{consumerId}/jobs?startTime={startTime}&endTime={endTime}

Get a list of all jobs related to a consumption unit. By default, the list will be limited to jobs which have occurred within the last 24 hours

POST v1/bunits/{bunitId}/jobs?jobViewId={jobViewId}

Get a list of all jobs related to a business unit (and descendants).
Filter list by using additional parameters

GET v1/bunits/{bunitId}/consumers/{consumerId}/jobs/first

Get first job of a consumption unit

GET v1/bunits/{bunitId}/jobs/first

Get first job of a consumption unit

GET v1/bunits/{bunitId}/consumers/{consumerId}/jobs/latest

Get latest job of a consumption unit

GET v1/bunits/{bunitId}/jobs/latest

Get latest job of a consumption unit

POST v1/Jobsupportstatus?supportStatusId={supportStatusId}

Update support status of jobs

JobDeliveryConfig

Job delivery configurations outlines what should be included in job subscriptions

APIDescription
GET v1/bunits/{bunitId}/jobdeliveryconfig

Get the default job delivery config of the business unit
If none exists an inherited config will be found

POST v1/bunits/{bunitId}/jobdeliveryconfig

Create a job delivery config for a business unit

PUT v1/bunits/{bunitId}/jobdeliveryconfig

Update a job delivery config

DELETE v1/bunits/{bunitId}/jobdeliveryconfig

Delete a job delivery config
If deleted the business unit will use an inherited config

JobIncidentConfig

Status report delivery configurations outlines what should be included in status report subscriptions

APIDescription
GET v1/bunits/{bunitId}/jobincidentconfig

Get the default status report delivery config of the business unit
If none exists an inherited config will be found

POST v1/bunits/{bunitId}/jobincidentconfig

Create a status report delivery config for a business unit

PUT v1/bunits/{bunitId}/jobincidentconfig

Update a status report delivery config

DELETE v1/bunits/{bunitId}/jobincidentconfig

Delete a status report delivery config
If deleted the business unit will use an inherited config

JobName

JobName operations

APIDescription
GET v1/jobnames

Get all job names.

GET v1/jobnames/{jobNameId}

Get a specific JobName.

JobQueue

APIDescription
POST v1/bunits/{bunitId}/JobQueue

Add consumption units to job queue

JobSeverityConfig

Job error configurations are used to determine what jobs should be included in sent out emails.

APIDescription
GET v1/bunits/{bunitId}/jobSeverityConfig

Get the default job error config of the business unit
If none exists an inherited config will be found

GET v1/bunits/{bunitId}/users/{userId}/jobSeverityConfig

Get job error config of user
If none exists an inherited config will be found

POST v1/bunits/{bunitId}/jobSeverityConfig

Create a job error config for a business unit

POST v1/bunits/{bunitId}/users/{userId}/jobSeverityConfig

Create job error config for user

PUT v1/bunits/{bunitId}/jobSeverityConfig

Update a job error config

PUT v1/bunits/{bunitId}/users/{userId}/jobSeverityConfig

Update job error config of user

DELETE v1/bunits/{bunitId}/jobSeverityConfig

Delete a job error config
If deleted the business unit will use an inherited config

DELETE v1/bunits/{bunitId}/users/{userId}/jobSeverityConfig

Delete a job error config
If deleted the business unit will use an inherited config

JobSubscription

Job subscriptions enable sending emails when new jobs match the configuration of the subscription.

APIDescription
GET v1/bunits/{bunitId}/jobsubscriptions

Get all job subscriptions of a business unit

GET v1/bunits/{bunitId}/jobsubscriptions/{jobSubscriptionId}

Get a job subscription

POST v1/bunits/{bunitId}/jobsubscriptions

Create a job subscription for a business unit

PUT v1/bunits/{bunitId}/jobsubscriptions/{jobSubscriptionId}

Update a job subscription

PATCH v1/bunits/{bunitId}/jobsubscriptions/{jobSubscriptionId}

Overwrites the resource's property values with the values specified in the delta object.

DELETE v1/bunits/{bunitId}/jobsubscriptions/{jobSubscriptionId}

Delete a job subscription

GET v1/bunits/{bunitId}/jobsubscriptions/{jobSubscriptionId}/send?resetPeriod={resetPeriod}

Send subscription with current applicable jobs

JobView

Information about jobs done for a consumption unit

APIDescription
GET v1/bunits/{bunitId}/jobviews?includeAncestors={includeAncestors}

Get a list of all job views related to the business unit

GET v1/bunits/{bunitId}/jobviews/{jobViewId}

Get a job view

POST v1/bunits/{bunitId}/jobviews

Create a job view

PUT v1/bunits/{bunitId}/jobviews/{jobViewId}

Edit a job view

DELETE v1/bunits/{bunitId}/jobviews/{jobViewId}

Delete a job view

Language

Language operations

APIDescription
GET v1/translationkeys

Get all keys used for translations.

POST v1/translationkeys

Create a new translation key.

DELETE v1/translationkeys/{translationKeyId}

Delete a translation key. Only inactive keys can be deleted.

GET v1/languages

Get available languages.

GET v1/languages/{languageId}

Get a language.

POST v1/languages

Create a new language.

PUT v1/languages/{languageId}

Update a language.

License

A license is needed to have the system functioning properly It can either be fetched from license server or entered manually

APIDescription
GET v1/license?retrieve={retrieve}

Get the current license of the system

GET v1/modules

Get the current license of the system

POST v1/license?encryptedLicense={encryptedLicense}

Set the license manually

ManagementClass

Management classes

APIDescription
GET v1/bunits/{bunitId}/datacenters/{dataCenterId}/spservers/{spServerId}/policySets/{policySetId}/managementClasses

Get management classes of policy set

Microsoft365Account

Microsoft 365 accounts

APIDescription
GET v1/bunits/{bunitId}/consumers/{consumerId}/microsoft365account

Get a account related to a consumer

GET v1/bunits/{bunitId}/consumers/{consumerId}/microsoft365tenant/accounts

Get accounts related to a tenant

GET v1/bunits/{bunitId}/microsoft365accounts

Get accounts related to tenants of a business unit
These are or can be related to the business unit or descendants of the business unit

POST v1/bunits/{bunitId}/microsoft365accounts

Assign a account to a business unit.

This will create a consumer as well

DELETE v1/bunits/{bunitId}/consumers/{consumerId}/microsoft365account?deleteAssociations={deleteAssociations}

Unassign a account from a business unit
This will delete the consumption unit that relates the account to the business unit
Any data related to the account will be added to that of the tenant it is related to

GET v1/bunits/{bunitId}/microsoft365accounts/{microsoft365AccountId}/destinations?accountId={accountId}

Get possible move destinations

GET v1/bunits/{bunitId}/consumers/{consumerId}/microsoft365account/backuppolicies

Get backup policies assigned to a account

GET v1/bunits/{bunitId}/consumers/{consumerId}/microsoft365account/availablebackuppolicies

Get backup policies available to a account
These excludes the ones already assigned

POST v1/bunits/{bunitId}/consumers/{consumerId}/microsoft365account/backuppolicies

Assign a backup policy to a account

DELETE v1/bunits/{bunitId}/consumers/{consumerId}/microsoft365account/backuppolicies/{backupPolicyId}

Unassign a backup policy from a account

Microsoft365AccountReport

****** DEPRECATED, please use consumption unit report endpoint ****** Reports contain information about the account, its backups and status You can get the first and latest report to get information about when reports have been made Get all reports to display graphs of development for data

APIDescription
GET v1/bunits/{bunitId}/consumers/{consumerId}/microsoft365account/reports?startDate={startDate}&endDate={endDate}&status={status}&warnings={warnings}

Get reports for a account

GET v1/bunits/{bunitId}/consumers/{consumerId}/microsoft365account/reports/{reportDate}?userId={userId}

Returns the report for a account on the specified date.

GET v1/bunits/{bunitId}/consumers/{consumerId}/microsoft365account/reports/latest?userId={userId}

Returns the latest report for the specified account.

GET v1/bunits/{bunitId}/consumers/{consumerId}/microsoft365account/reports/first?userId={userId}

Returns the first report for the specified VM.

Microsoft365RestorePoint

Restore points of a given Microsoft 365 account

APIDescription
GET v1/bunits/{bunitId}/consumers/{consumerId}/microsoft365account/restorepoints

Get restore points related to a Microsoft 365 account

Microsoft365Tenant

Microsoft 365 tenant

APIDescription
GET v1/bunits/{bunitId}/consumers/{consumerId}/microsoft365tenant

Get a Microsoft 365 tenant related to a consumption unit

POST v1/bunits/{bunitId}/unassignedMicrosoft365Tenants?bunitIdToLink={bunitIdToLink}

Assign a list of Microsoft 365 tenants to a business unit
A consumption unit for each tenant will be created

PUT v1/bunits/{bunitId}/consumers/{consumerId}/microsoft365tenant

Update the information of a Microsoft 365 tenant

DELETE v1/bunits/{bunitId}/consumers/{consumerId}/microsoft365tenant

Unassign a Microsoft 365 tenant from a business unit
This will delete the consumption unit that relates the tenant to the business unit

GET v1/bunits/{bunitId}/unassignedMicrosoft365Tenants

Get all Microsoft 365 tenants located on servers of the business unit that are not assigned to a business unit

Microsoft365TenantReport

****** DEPRECATED, please use consumption unit report endpoint ****** Reports contain information about the tenant, its backups and status You can get the first and latest report to get information about when reports have been made Get all reports to display graphs of development for data

APIDescription
GET v1/bunits/{bunitId}/consumers/{consumerId}/microsoft365tenant/reports?startDate={startDate}&endDate={endDate}&status={status}&warnings={warnings}

Get reports for a hyper visor

GET v1/bunits/{bunitId}/consumers/{consumerId}/microsoft365tenant/reports/{reportDate}?userId={userId}

Returns the report for the tenant on the specified date.

GET v1/bunits/{bunitId}/consumers/{consumerId}/microsoft365tenant/reports/latest?userId={userId}

Returns the latest report for the specified tenant.

GET v1/bunits/{bunitId}/consumers/{consumerId}/microsoft365tenant/reports/first?userId={userId}

Returns the first report for the specified tenant.

NamingRule

S3 bucket naming rules determines how buckets are named on an S3 server

APIDescription
GET v1/bunits/{bunitId}/s3namingrule

Get naming rule for business unit.

GET v1/bunits/{bunitId}/inheriteds3namingrule

Get inherited naming rule for business unit.

POST v1/bunits/{bunitId}/s3namingrule

Create a naming rule.

PUT v1/bunits/{bunitId}/s3namingrule

Updates an existing naming rule.

DELETE v1/bunits/{bunitId}/s3namingrule

Deletes a naming rule.

Node

Nodes are backup clients (has SP commands)

APIDescription
GET v1/bunits/{bunitId}/consumers/{consumerId}/node?tsmSync={tsmSync}

Get a specific node belonging to the consumption unit.

POST v1/bunits/{bunitId}/consumers/{consumerId}/node

Add a backup node to a consumption unit.

POST v1/bunits/{bunitId}/nodes

OBSOLETE: Nodes are no longer directly related to business unit.
Please use bunits/{bunitId}/consumers/{consumerId}/node

Add a backup node to a business unit.
If the backup node already exists on another business unit, it will be moved. Otherwise the backup node will be created.

DELETE v1/bunits/{bunitId}/consumers/{consumerId}/node?deleteAssociations={deleteAssociations}

Delete a backup node belonging to a consumption unit

DELETE v1/bunits/{bunitId}/nodestodelete?nodeIds[0]={nodeIds[0]}&nodeIds[1]={nodeIds[1]}

Delete backup nodes from the IBM Storage Protect server.

PUT v1/bunits/{bunitId}/consumers/{consumerId}/node

Update a backup node.

POST v1/bunits/{bunitId}/consumers/{consumerId}/node/password

Update the password for a backup node.
This will enforce the provided password and send a command to the SP server to update the password there as well.

POST v1/bunits/{bunitId}/consumers/{consumerId}/node/lockstate

Update the lock state of a backup node.
This will enforce the provided state and send a command to the SP server to update the state there as well.

PATCH v1/bunits/{bunitId}/consumers/{consumerId}/node

Overwrites the resource's property values with the values specified in the delta object.

GET v1/bunits/{bunitId}/consumers/{consumerId}/node/spname

Gets the name that could be used when activating

GET v1/bunits/{bunitId}/consumers/{consumerId}/node/activate?tsmName={tsmName}

Activates a backup node on the IBM Storage Protect server
(SP)

POST v1/bunits/{bunitId}/inactivenodes

Activate a list of inactive nodes

GET v1/bunits/{bunitId}/inactivenodes

Get all consumers with inactive nodes on business units in the hierarchy

POST v1/bunits/{bunitId}/consumers/{consumerId}/node/unarchive

Unarchive a deleted node

POST v1/bunits/{bunitId}/tsmnodes?syncStateTypeId={syncStateTypeId}&bunitIdToLink={bunitIdToLink}

Change the SyncState for a list of nodes. The status can be changed in the following ways:
From Unassigned to Ignored Unassigned
From Ignored Unassigned to Unassigned
From Unassigned to Syncronized (a business unit id must be provided)

GET v1/bunits/{bunitId}/tsmnodes/{nodeId}

Get a specific node managed by the business unit.

PUT v1/bunits/{bunitId}/tsmnodes/{nodeId}?unassignedNodeId={unassignedNodeId}

Reconnect a missing node by merging it with an unassigned node. The unassigned node will be deleted and the merged node's SyncState will be set to Synchronized.

GET v1/bunits/{bunitId}/consumers/{consumerId}/node/bci

Get the configuration for installing the backup client software on a backup node.

GET v1/bunits/{bunitId}/consumers/{consumerId}/node/proxyagents

Get all the backup nodes that are proxy agent for the current backup node

POST v1/bunits/{bunitId}/consumers/{consumerId}/node/proxyagents?proxyAgentId={proxyAgentId}

Create a proxy relation between a backup node and a proxy agent backup node

DELETE v1/bunits/{bunitId}/consumers/{consumerId}/node/proxyagents/{proxyAgentId}

Remove a proxy relation between a backup node and an proxy agent backup node

GET v1/bunits/{bunitId}/consumers/{consumerId}/node/proxytargets

Get all the backup nodes that are proxy targets for the current backup node

POST v1/bunits/{bunitId}/consumers/{consumerId}/node/proxytargets?proxyTargetId={proxyTargetId}

Create a proxy relation between a backup node and a proxy target backup node

DELETE v1/bunits/{bunitId}/consumers/{consumerId}/node/proxytargets/{proxyTargetId}

Remove a proxy relation between a backup node and an proxy target backup node

GET v1/bunits/{bunitId}/consumers/{consumerId}/node/possibleproxynodes

Get a list of backup nodes that can be set as proxy agents of targets to the current backup node

DELETE v1/bunits/{bunitId}/consumers/{consumerId}/node/replicationnode?name={name}&deleteReplicationNode={deleteReplicationNode}
GET v1/bunits/{bunitId}/availableForMerge

Get all backup nodes in the hierarchy that are available for merge

GET v1/bunits/{bunitId}/nodes?includeDescendants={includeDescendants}

OBSOLETE: Nodes are no longer directly related to business unit.
Please use bunits/{bunitId}/consumers

Get all nodes belonging to the business unit (and descendants if requested)

GET v1/bunits/{bunitId}/nodes/{nodeId}

OBSOLETE: Nodes are no longer directly related to business unit.
Please use bunits/{bunitId}/consumers/{consumerId}/node

Get a specific node belonging to the business unit.

PUT v1/bunits/{bunitId}/nodes/{nodeId}

OBSOLETE: Nodes are no longer directly related to business unit.
Please use bunits/{bunitId}/consumers/{consumerId}/node

Update a backup node.

PATCH v1/bunits/{bunitId}/nodes/{nodeId}

OBSOLETE: Nodes are no longer directly related to business unit.
Please use bunits/{bunitId}/consumers/{consumerId}/node

Overwrites the resource's property values with the values specified in the delta object.

DELETE v1/bunits/{bunitId}/nodes/{nodeId}?deleteAssociations={deleteAssociations}

OBSOLETE: Nodes are no longer directly related to business unit.
Please use bunits/{bunitId}/consumers/{consumerId}/node

Delete a backup node belonging to a business unit

GET v1/bunits/{bunitId}/nodes/{nodeId}/activate?tsmName={tsmName}

OBSOLETE: Nodes are no longer directly related to business unit.
Please use bunits/{bunitId}/consumers/{consumerId}/node

Activates a backup node on the IBM Storage Protect server
(SP)

NodeActivationRule

Rules for what parameters should be used when a backup node is activated on an IBM Storage Protect server

APIDescription
GET v1/bunits/{bunitId}/nodeactivationrules

Get all backup node activation rules of a business unit

GET v1/bunits/{bunitId}/nodeactivationrules/{nodeActivationRuleId}

Get a backup node activation rule

DELETE v1/bunits/{bunitId}/nodeactivationrules/{nodeActivationRuleId}

Delete a backup node activation rule

POST v1/bunits/{bunitId}/nodeactivationrules

Create a backup node activation rule

PUT v1/bunits/{bunitId}/nodeactivationrules/{nodeActivationRuleId}

Update a backup node activation rule

PATCH v1/bunits/{bunitId}/nodeactivationrules/{nodeActivationRuleId}

Update a backup node activation

NodeAssignmentFilter

APIDescription
POST v1/bunits/{bunitId}/nodeAssignmentFilters

Create a filter for assigning backup nodes to a business unit

GET v1/bunits/{bunitId}/nodeAssignmentFilters/{nodeAssignmentFilterId}

Get a single backup node assignment filter

GET v1/bunits/{bunitId}/nodeAssignmentFilters

Get a list of all backup node assignment filters owned by business unit

DELETE v1/bunits/{bunitId}/nodeAssignmentFilters/{nodeAssignmentFilterId}

Deletes a backup node assignment filter

PUT v1/bunits/{bunitId}/nodeAssignmentFilters/{nodeAssignmentFilterId}

Update a single backup node assignment filter

PATCH v1/bunits/{bunitId}/nodeAssignmentFilters/{nodeAssignmentFilterId}

Overwrites the resource's property values with the values specified in the delta object.

NodeDeletionRule

APIDescription
GET v1/bunits/{bunitId}/nodedeletionrule

Get backup node deletion rule for business unit.

PUT v1/bunits/{bunitId}/nodedeletionrule

Updates the deletion rules.

NodeGroup

Node groups can be used on SP to group nodes (has SP commands)

APIDescription
GET v1/bunits/{bunitId}/consumers/{consumerId}/node/nodegroups

Get a list of node groups assigned to a backup node

GET v1/bunits/{bunitId}/datacenters/{dataCenterId}/spservers/{spServerId}/nodegroups?tsmSync={tsmSync}

Get a list of node groups of a SP server

GET v1/bunits/{bunitId}/consumers/{consumerId}/node/nodegroups/available

Get all available node groups
Does not include node groups already associated with the backup node

POST v1/bunits/{bunitId}/consumers/{consumerId}/node/nodegroups

Assign a backup node to a node group

POST v1/bunits/{bunitId}/datacenters/{dataCenterId}/spservers/{spServerId}/nodegroups

Creates a node group on the SP server

DELETE v1/bunits/{bunitId}/consumers/{consumerId}/node/nodegroups/{nodeGroupId}

Deletes a backup node from a node group

DELETE v1/bunits/{bunitId}/datacenters/{dataCenterId}/spservers/{spServerId}/nodegroups/{nodeGroupId}?ignoreAssigned={ignoreAssigned}

Deletes a node group from the SP server

PUT v1/bunits/{bunitId}/datacenters/{dataCenterId}/spservers/{spServerId}/nodegroups/{nodeGroupId}

Save changes to a node group

PATCH v1/bunits/{bunitId}/datacenters/{dataCenterId}/spservers/{spServerId}/nodegroups/{nodeGroupId}

Patch a node group

NodeNamingRule

Backup node naming rules determines how backup nodes are named on an IBM Storage Protect server upon activation

APIDescription
GET v1/bunits/{bunitId}/nodenamingrule

Get naming rule for business unit.

GET v1/bunits/{bunitId}/inheritednodenamingrule

Get inherited naming rule for business unit.

POST v1/bunits/{bunitId}/nodenamingrule

Create a naming rule.

PUT v1/bunits/{bunitId}/nodenamingrule

Updates an existing naming rule.

DELETE v1/bunits/{bunitId}/nodenamingrule

Deletes a naming rule.

NodeOperatingSystem

Operating System operations

APIDescription
GET v1/nodeoperatingsystems

Get all operating systems available in the system.

GET v1/nodeoperatingsystems/{nodeOperatingSystemId}

Get a specific operating system.

PUT v1/nodeoperatingsystems/{nodeOperatingSystemId}

Update the short name of an operating system

NodeOsLevel

OS level operations

APIDescription
GET v1/nodeoslevels

Get all OS levels available in the system.

GET v1/nodeoslevels/{nodeOsLevelId}

Get a specific OS level.

NodePasswordRule

Rules for how passwords are set on backup nodes

APIDescription
GET v1/bunits/{bunitId}/nodepasswordrule

Get password rule for business unit.

GET v1/bunits/{bunitId}/inheritednodepasswordrule

Get inherited password rule for business unit.

POST v1/bunits/{bunitId}/nodepasswordrule

Create a password rule.

PUT v1/bunits/{bunitId}/nodepasswordrule

Updates an existing password rule.

DELETE v1/bunits/{bunitId}/nodepasswordrule

Deletes a password rule.

NodePlatform

Node platform operations

APIDescription
GET v1/nodeplatforms

Get all node platforms available in the system.

GET v1/nodeplatforms/{nodePlatformId}

Get a specific node platform.

NodeReport

****** DEPRECATED, please use consumption unit report endpoint ****** Node reports contain information about the backup node, its backups and status You can get the first and latest report to get information about when reports have been made Get all reports to display graphs of development for data

APIDescription
GET v1/bunits/{bunitId}/consumers/{consumerId}/node/reports?startDate={startDate}&endDate={endDate}&status={status}&warnings={warnings}

Get reports for a backup node

GET v1/bunits/{bunitId}/consumers/{consumerId}/node/reports/{reportDate}?userId={userId}&logLevel={logLevel}

Returns the backup node report for the backup node on the specified date.

GET v1/bunits/{bunitId}/consumers/{consumerId}/node/reports/latest?userId={userId}&logLevel={logLevel}

Returns the latest node report for the specified node.

GET v1/bunits/{bunitId}/consumers/{consumerId}/node/reports/first?userId={userId}&logLevel={logLevel}

Returns the first node report for the specified node.

GET v1/bunits/{bunitId}/consumers/{consumerId}/node/reports/{reportDate}/send?subscriptionId={subscriptionId}

Send a backup node report to the recipients of a backup node report delivery configuration.

GET v1/bunits/{bunitId}/nodes/{nodeId}/reports?startDate={startDate}&endDate={endDate}&status={status}&warnings={warnings}

OBSOLETE: Nodes are no longer directly related to business unit.
Please use bunits/{bunitId}/consumers/{consumerId}/node/reports/

Get all reports for a backup node

GET v1/bunits/{bunitId}/nodes/{nodeId}/reports/{reportDate}?userId={userId}&logLevel={logLevel}

OBSOLETE: Nodes are no longer directly related to business unit.
Please use bunits/{bunitId}/consumers/{consumerId}/node/reports/

Returns the backup node report for the backup node on the specified date.

GET v1/bunits/{bunitId}/nodes/{nodeId}/reports/latest?userId={userId}&logLevel={logLevel}

OBSOLETE: Nodes are no longer directly related to business unit.
Please use bunits/{bunitId}/consumers/{consumerId}/node/reports/latest

Returns the latest node report for the specified node.

GET v1/bunits/{bunitId}/nodes/{nodeId}/reports/first?userId={userId}&logLevel={logLevel}

OBSOLETE: Nodes are no longer directly related to business unit.
Please use bunits/{bunitId}/consumers/{consumerId}/node/reports/first

Returns the first node report for the specified node.

GET v1/bunits/{bunitId}/nodes/{nodeId}/reports/{reportDate}/send?subscriptionId={subscriptionId}

OBSOLETE: Nodes are no longer directly related to business unit.
Please use bunits/{bunitId}/consumers/{consumerId}/node/reports/send

Send a status report to the recipients of a status report delivery configuration.

NodeReportDeliveryConfig

Status report delivery configurations enable sending emails when new reports are available.

APIDescription
GET v1/bunits/{bunitId}/nodedeliveryconfig

Get node report delivery configs of a business unit

POST v1/bunits/{bunitId}/nodedeliveryconfig

Create a node report delivery config

PUT v1/bunits/{bunitId}/nodedeliveryconfig

Save changes to a node report delivery config

DELETE v1/bunits/{bunitId}/nodedeliveryconfig

Delete a node report delivery config

NodeReportFilter

Report error configurations determine when reported warnings are considered errors. Privileged users can create their own configuration while business units can set up a default configuration.

APIDescription
GET v1/bunits/{bunitId}/users/{userId}/nodereportfilter
POST v1/bunits/{bunitId}/users/{userId}/nodereportfilter
PUT v1/bunits/{bunitId}/users/{userId}/nodereportfilter
DELETE v1/bunits/{bunitId}/users/{userId}/nodereportfilter

NodeReportSubscription

Node report subscriptions enable sending emails when new reports are available.

APIDescription
GET v1/bunits/{bunitId}/consumers/{consumerId}/node/nodereportsubscriptions

Get all node report subscribers for a backup node

GET v1/bunits/{bunitId}/consumers/{consumerId}/node/nodereportsubscriptions/{nodeReportSubscriptionId}

Get a backup node report subscription

POST v1/bunits/{bunitId}/consumers/{consumerId}/node/nodereportsubscriptions

Create a subscribtion for the backup node reports of a backup node

PUT v1/bunits/{bunitId}/consumers/{consumerId}/node/nodereportsubscriptions/{nodeReportSubscriptionId}

Update a backup node report subscription

PATCH v1/bunits/{bunitId}/consumers/{consumerId}/node/nodereportsubscriptions/{nodeReportSubscriptionId}

Overwrites the resource's property values with the values specified in the delta object.

DELETE v1/bunits/{bunitId}/consumers/{consumerId}/node/nodereportsubscriptions/{nodeReportSubscriptionId}

Delete a backup node report subscription

NodeSyncState

Node status operations

APIDescription
GET v1/syncstates

Get all available synchronization states.

GET v1/syncstates/{syncStateId}

Get a specific synchronization state object.

NodeTsmClientVersion

SP client version operations

APIDescription
GET v1/nodetsmclientversions

Get all client version available in the system.

GET v1/nodetsmclientversions/{nodeTsmClientVersionId}

Get a specific client version.

NodeType

Node type operations

APIDescription
GET v1/nodetypes

Get all node types available in the system.

GET v1/nodetypes/{nodeTypeId}

Get a specific node type.

PUT v1/nodetypes/{nodeTypeId}

Update the short name of a backup node type

PasswordRuleType

Password rule type operations

APIDescription
GET v1/passwordruletypes

Get all password rule types.

GET v1/passwordruletypes/{passwordRuleTypeId}

Get a password rule type.

PaymentTerms

Payment terms

APIDescription
GET v1/bunits/{bunitId}/paymentterms

Get all payment terms created by a business unit

GET v1/bunits/{bunitId}/availablepaymentterms

Get payment terms available for a business unit

GET v1/bunits/{bunitId}/paymentterms/{paymentTermsId}

Get a specific payment terms instance belonging to the business unit.

DELETE v1/bunits/{bunitId}/paymentterms/{paymentTermsId}

Delete a payment terms resource.

POST v1/bunits/{bunitId}/paymentterms

Add a payment terms to a business unit.


If the payment terms already exists on another business unit, it will be moved. Otherwise the payment terms will be created.

PUT v1/bunits/{bunitId}/paymentterms/{paymentTermsId}

Update a payment terms.

PeriodUnit

Period unit operations

APIDescription
GET v1/periodUnits

Get all period units available in the system.

GET v1/periodUnits/{periodUnitId}

Get a specific period unit.

PointBucket

PoINT buckets

APIDescription
GET v1/bunits/{bunitId}/unassignedpointbuckets

Get all buckets located on PoINT servers of the business unit that are not assigned to a business unit

GET v1/bunits/{bunitId}/deletedpointbuckets

Get all buckets located on PoINT servers of the business unit where the consumption unit has been deleted
The buckets are still active on the PoINT servers but may need to be deleted as they are no longer relevant in Cloutility

POST v1/bunits/{bunitId}/unassignedpointbuckets

When posting a PoINT bucket to unassigned buckets it will be released from the current consumption unit
related to the bucket.

DELETE v1/bunits/{bunitId}/bucketstodelete?bucketIds[0]={bucketIds[0]}&bucketIds[1]={bucketIds[1]}

Delete buckets from PoINT server

POST v1/bunits/{bunitId}/unassignedpointbuckets?bunitIdToLink={bunitIdToLink}

Assign a list of PoINT buckets to a business unit
A consumption unit for each bucket will be created

GET v1/bunits/{bunitId}/consumers/{consumerId}/pointbucket

Get a bucket related to a consumption unit

PUT v1/bunits/{bunitId}/consumers/{consumerId}/pointbucket

Update the information of a bucket

POST v1/bunits/{bunitId}/consumers/{consumerId}/pointbucket

Create a bucket

DELETE v1/bunits/{bunitId}/consumers/{consumerId}/pointbucket

Unassign a bucket from a business unit
This will delete the consumption unit that relates the bucket to the business unit

POST v1/bunits/{bunitId}/consumers/{consumerId}/pointbucket/unarchive

Unarchive a deleted PoINT bucket

PointBucketPreset

Presets for PoINT buckets

APIDescription
GET v1/bunits/{bunitId}/pointbucketpresets

Get all PoINT bucket presets of business unit

GET v1/bunits/{bunitId}/pointbucketpresets/{pointBucketPresetId}

Get a single PoINT bucket preset

POST v1/bunits/{bunitId}/pointbucketpresets

Create a new PoINT bucket preset

PUT v1/bunits/{bunitId}/pointbucketpresets/{pointBucketPresetId}?updateMethod={updateMethod}

Update a PoINT bucket preset.

DELETE v1/bunits/{bunitId}/pointbucketpresets/{pointBucketPresetId}

Delete a PoINT bucket preset.

PointPartition

Partitions on PoINT server

APIDescription
GET v1/bunits/{bunitId}/datacenters/{dataCenterId}/pointservers/{pointServerId}/pointpartitions

Get all Point partitions related to a server.

GET v1/bunits/{bunitId}/pointpartitions

Get all PoINT partitions available to a business unit.

GET v1/bunits/{bunitId}/datacenters/{dataCenterId}/pointservers/{pointServerId}/pointpartitions/{pointPartitionId}

Get a single partition.

GET v1/bunits/{bunitId}/pointpartitionfilters

Get all PoINT partition filters

PUT v1/bunits/{bunitId}/pointpartitionfilters/{pointPartitionFilterId}

Update a PoINT partition filter

PointServer

PoINT servers in data center

APIDescription
GET v1/bunits/{bunitId}/datacenters/{dataCenterId}/pointservers

Get all PoINT servers related to a data center.

GET v1/bunits/{bunitId}/datacenters/{dataCenterId}/pointservers/{pointServerId}

Get a single server.

POST v1/bunits/{bunitId}/datacenters/{dataCenterId}/pointservers

Create a new server and starts a synchronization process.

GET v1/bunits/{bunitId}/datacenters/{dataCenterId}/pointservers/{pointServerId}/sync

Force synchronization with the SP environment.

PUT v1/bunits/{bunitId}/datacenters/{dataCenterId}/pointservers/{pointServerId}

Update a server.

PATCH v1/bunits/{bunitId}/datacenters/{dataCenterId}/pointservers/{pointServerId}

Overwrites the resource's property values with the values specified in the delta object.

DELETE v1/bunits/{bunitId}/datacenters/{dataCenterId}/pointservers/{pointServerId}?deleteDataSources={deleteDataSources}

Delete a server.

GET v1/bunits/{bunitId}/datacenters/{dataCenterId}/pointservers/{pointServerId}/logs

Get logs of a server

PointUser

PoINT users on PoINT server or related to business unit

APIDescription
GET v1/bunits/{bunitId}/datacenters/{dataCenterId}/pointservers/{pointServerId}/pointusers

Get all PoINT users related to a server.

GET v1/bunits/{bunitId}/pointusers

Get all PoINT users related to a business unit.

GET v1/bunits/{bunitId}/datacenters/{dataCenterId}/pointservers/{pointServerId}/pointusers/{pointUserId}

Get a single user.

GET v1/bunits/{bunitId}/pointusers/{pointUserId}

Get a single user.

POST v1/bunits/{bunitId}/datacenters/{dataCenterId}/pointservers/{pointServerId}/pointusers

Create a new user.

POST v1/bunits/{bunitId}/pointusers

Create a new user.

PUT v1/bunits/{bunitId}/datacenters/{dataCenterId}/pointservers/{pointServerId}/pointusers/{pointUserId}

Update a user.

PUT v1/bunits/{bunitId}/pointusers/{pointUserId}

Update a user.

PATCH v1/bunits/{bunitId}/datacenters/{dataCenterId}/pointservers/{pointServerId}/pointusers/{pointUserId}

Overwrites the resource's property values with the values specified in the delta object.

PATCH v1/bunits/{bunitId}/pointusers/{pointUserId}

Overwrites the resource's property values with the values specified in the delta object.

DELETE v1/bunits/{bunitId}/datacenters/{dataCenterId}/pointservers/{pointServerId}/pointusers/{pointUserId}

Delete a user.

DELETE v1/bunits/{bunitId}/pointusers/{pointUserId}

Delete a user.

GET v1/bunits/{bunitId}/pointusers/{pointUserId}/renews3secret

Renew secret for S3 access

PolicySet

Domains (has SP commands)

APIDescription
GET v1/bunits/{bunitId}/datacenters/{dataCenterId}/spservers/{spServerId}/policySets?tsmSync={tsmSync}

Get policy sets of a server.

GET v1/bunits/{bunitId}/datacenters/{dataCenterId}/spservers/{spServerId}/policySets/{policySetId}

Get a policy set.

Product

Product operations

APIDescription
GET v1/invoicemethods

Returns all invoice methods.

GET v1/bunits/{bunitId}/products?methodId={methodId}

Get all products available in the system.

GET v1/bunits/{bunitId}/products/{productId}

Get a specific product relative to a business unit.

The product must be owned, inherited or otherwise assigned to the specified business unit.

POST v1/bunits/{bunitId}/products

Create a product

PUT v1/bunits/{bunitId}/products/{productId}

Update a product

DELETE v1/bunits/{bunitId}/products/{productId}?deleteRelations={deleteRelations}

Delete a product

PUT v1/bunits/{bunitId}/productcodes

Saves the supplied product codes for a business unit. This will overwrite any
existing product codes that match the product in previously set product codes
for this business unit.
NOTE: A product object must be supplied with each product code object. The product should as a minimum have its id property specified.

DELETE v1/bunits/{bunitId}/productcodes/{productCodeId}

Referral

Referrals a business unit receives a fee for

APIDescription
GET v1/bunits/{bunitId}/referrals

Get all referrals of a business unit

GET v1/bunits/{bunitId}/referrals/{referralId}

Get a referral of a business unit

POST v1/bunits/{bunitId}/referrals

Create a referral

PUT v1/bunits/{bunitId}/referrals/{referralId}

Save changes to referral. The relations of the referral can not be updated, only the content (percentage and expiration date) can be changed

DELETE v1/bunits/{bunitId}/referrals/{referralId}

Delete a referral

GET v1/bunits/{bunitId}/contractsiblings

A list of business units that can be the target of a referral.
The list consists of all business units with a contract that are the first descendant of the
provider for the given business unit. If the user is a descendant of the provider only descendants
of the user will be provided.

RemoteActivity

Remote activities

APIDescription
POST v1/bunits/{bunitId}/remoteActivity

Add a collection of remote activites to a consumption unit's report. For including local/client-side activities which aren't available on the backend server in consumption unit reports, e.g. for SAP HANA.
(SP)

RemoteReport

APIDescription
POST v1/remotereports/{systemId}
GET v1/bunits/{bunitId}/remotereports/overview

Get an overview of latest remote reports for all descending business units

GET v1/bunits/{bunitId}/remotesystemversions

ReportErrorConfig

Report error configurations determine when reported warnings are considered errors. Privileged users can create their own configuration while business units can set up a default configuration.

APIDescription
GET v1/nodewarningtypes
GET v1/bunitwarningtypes
GET v1/bunits/{bunitId}/reporterrorconfig

Get business unit's report error configuration.

GET v1/bunits/{bunitId}/users/{userId}/reporterrorconfig?getActiveConfig={getActiveConfig}

Get user's report error configuration.

POST v1/bunits/{bunitId}/reporterrorconfig

Add a new report error configuration for business unit. The new configuration will be inherited by the business unit's descendants but also override the business unit's currently inherited configuration.

POST v1/bunits/{bunitId}/users/{userId}/reporterrorconfig

Add report error configuration for user. This will override any default configuration and only affect the user.

PUT v1/bunits/{bunitId}/reporterrorconfig

Save business unit report error configuration.

PUT v1/bunits/{bunitId}/users/{userId}/reporterrorconfig

Save user report error configuration.

DELETE v1/bunits/{bunitId}/reporterrorconfig

Delete report error configuration for business unit.

DELETE v1/bunits/{bunitId}/users/{userId}/reporterrorconfig

Delete report error configuration for user.

RestorePoint

VMs

APIDescription
GET v1/bunits/{bunitId}/consumers/{consumerId}/vm/restorepoints

Get a restore points related to a VM of a consumer

RetentionRule

Domains (has SP commands)

APIDescription
GET v1/bunits/{bunitId}/datacenters/{dataCenterId}/spservers/{spServerId}/retentionRules?tsmSync={tsmSync}

Get all retention rules of a server.

GET v1/bunits/{bunitId}/datacenters/{dataCenterId}/spservers/{spServerId}/retentionRules/{retentionRuleId}

Get a retention rule

GET v1/bunits/{bunitId}/consumers/{consumerId}/node/availableretentionrules

Get retention rules a backup node can be assigned to

GET v1/bunits/{bunitId}/consumers/{consumerId}/node/retentionRules

Get retention rules a backup node is assigned to

GET v1/bunits/{bunitId}/consumers/{consumerId}/vmfilespace/retentionRules

Get retention rules a VM file space is assigned to

POST v1/bunits/{bunitId}/consumers/{consumerId}/node/retentionRules

Assign a backup node to a retention rule

DELETE v1/bunits/{bunitId}/consumers/{consumerId}/node/retentionRules/{retentionRuleId}

Unassign a backup node from a retention rule

RetentionSet

Domains (has SP commands)

APIDescription
GET v1/bunits/{bunitId}/consumers/{consumerId}/node/retentionSets

Get all retention sets of a backup node

GET v1/bunits/{bunitId}/consumers/{consumerId}/vmfilespace/retentionSets

Get all retention sets of an assigned file space

Role

Role API

APIDescription
GET v1/bunits/{bunitId}/roles?filterForUserId={filterForUserId}

Get all roles of a business unit.

GET v1/bunits/{bunitId}/roles/{roleId}?filterForUserId={filterForUserId}

Get a role

GET v1/bunits/{bunitId}/roles/simple?filterForUserId={filterForUserId}

Get all roles of a business unit.
These are simple roles with no other information than Name and Id
Used for editing users where more information than name is not necessary
These roles can be gotten without having view role privilege

GET v1/bunits/{bunitId}/rolesassignable

Get all roles assignable to a user in a specific business unit.

POST v1/bunits/{bunitId}/roles

Create a role.

PUT v1/bunits/{bunitId}/roles/{roleId}

Update a role.

DELETE v1/bunits/{bunitId}/roles/{roleId}

Delete a role.

GET v1/privileges

Get a list of privileges available to the user.

GET v1/bunits/{bunitId}/roles/{roleId}/usercount

Get the count of users who have the role assigned

GET v1/bunits/{bunitId}/roles/{roleId}/users

Get the users who have the role assigned

POST v1/bunits/{bunitId}/roles/{roleId}/swaprole?newRoleId={newRoleId}

Swap role for all users of role

RubrikDataSource

Rubrik data-sources

APIDescription
GET v1/bunits/{bunitId}/unassignedprimaryrubrikdatasources

Get all primary Rubrik data-sources located on servers of the business unit that are not assigned to a business unit

POST v1/bunits/{bunitId}/unassignedprimaryrubrikdatasources?bunitIdToLink={bunitIdToLink}

Assign a list of primary Rubrik data-sources to a business unit
A consumption unit for each Rubrik data-source will be created

GET v1/bunits/{bunitId}/secondaryrubrikdatasources

Get secondary Rubrik data-sources related to data-sources of a business unit
These are or can be related to the business unit or descendants of the business unit

POST v1/bunits/{bunitId}/secondaryrubrikdatasources

Assign a list of secondary Rubrik data-sources to a business unit
A consumption unit for each Rubrik data-source will be created

GET v1/bunits/{bunitId}/consumers/{consumerId}/rubrikdatasource

Get a Rubrik data-source related to a consumption unit

PUT v1/bunits/{bunitId}/consumers/{consumerId}/rubrikdatasource

Update the information of a Rubrik data-source

DELETE v1/bunits/{bunitId}/consumers/{consumerId}/rubrikdatasource

Unassign a Rubrik data-source from a business unit
This will delete the consumption unit that relates the Rubrik data-source to the business unit

GET v1/bunits/{bunitId}/consumers/{consumerId}/rubrikdatasource/secondaryrubrikdatasources

Get secondary data-sources related to a data-source

RubrikFileset

Rubrik data-sources

APIDescription
GET v1/bunits/{bunitId}/consumers/{consumerId}/rubrikdatasource/filesets

Get filesets of a data-source related to a consumption unit

RubrikFilesetTemplate

Rubrik fileset templates

APIDescription
GET v1/bunits/{bunitId}/datacenters/{dataCenterId}/rubrikservers/{rubrikServerId}/filesettemplates?sync={sync}

Get fileset templates of a Rubrik server

RubrikRequest

Rubrik request

APIDescription
GET v1/bunits/{bunitId}/consumers/{consumerId}/rubrikdatasource/request

Get information about latest request if any

POST v1/bunits/{bunitId}/consumers/{consumerId}/rubrikdatasource/request?forceFullSnapshot={forceFullSnapshot}

Initiate new request for backup of the data-source

RubrikServer

Rubrik servers in data center

APIDescription
GET v1/bunits/{bunitId}/datacenters/{dataCenterId}/rubrikservers

Get all Rubrik servers related to a data center.

GET v1/bunits/{bunitId}/datacenters/{dataCenterId}/rubrikservers/{RubrikServerId}

Get a single server.

POST v1/bunits/{bunitId}/datacenters/{dataCenterId}/rubrikservers

Create a new server and starts a synchronization process.

GET v1/bunits/{bunitId}/datacenters/{dataCenterId}/rubrikservers/{RubrikServerId}/sync

Force synchronization with the SP environment.

PUT v1/bunits/{bunitId}/datacenters/{dataCenterId}/rubrikservers/{RubrikServerId}

Update a server.

PATCH v1/bunits/{bunitId}/datacenters/{dataCenterId}/rubrikservers/{RubrikServerId}

Overwrites the resource's property values with the values specified in the delta object.

DELETE v1/bunits/{bunitId}/datacenters/{dataCenterId}/rubrikservers/{RubrikServerId}?deleteDataSources={deleteDataSources}

Delete a server.

GET v1/bunits/{bunitId}/datacenters/{dataCenterId}/rubrikservers/{RubrikServerId}/logs

Get logs of a server

RubrikSnapshot

Rubrik snapshots

APIDescription
GET v1/bunits/{bunitId}/consumers/{consumerId}/rubrikdatasource/restorepoints

Get all snapshots of the data-source

GET v1/bunits/{bunitId}/consumers/{consumerId}/rubrikdatasource/restorepoints/{snapshotId}/restore

Initiate new request for restore of the data-source

Saml

Saml operations.

APIDescription
GET v1/saml/{identityProviderGuid}
POST v1/saml/{identityProviderGuid}

Checks if the SAML-assertion returned from the IdP is valid and matches a user, redirects to sign-in page with appropriate query.

Schedule

Schedules (has SP commands)

APIDescription
GET v1/bunits/{bunitId}/datacenters/{dataCenterId}/spservers/{spServerId}/domains/{domainId}/schedules?tsmSync={tsmSync}

Get all schedules of a domain.

GET v1/bunits/{bunitId}/datacenters/{dataCenterId}/spservers/{spServerId}/domains/{domainId}/schedules/{scheduleId}

Get a single schedule.

POST v1/bunits/{bunitId}/datacenters/{dataCenterId}/spservers/{spServerId}/domains/{domainId}/schedules

Create a schedule in a domain.
(SP)

PUT v1/bunits/{bunitId}/datacenters/{dataCenterId}/spservers/{spServerId}/domains/{domainId}/schedules/{scheduleId}

Update a schedule.
(SP)

DELETE v1/bunits/{bunitId}/datacenters/{dataCenterId}/spservers/{spServerId}/domains/{domainId}/schedules/{scheduleId}

Delete schedule.
(SP)

GET v1/bunits/{bunitId}/consumers/{consumerId}/node/schedules?tsmSync={tsmSync}

Get schedules related to a backup node.

GET v1/bunits/{bunitId}/consumers/{consumerId}/node/availableschedules?includeAssigned={includeAssigned}

Get schedules that the backup node can be related to

POST v1/bunits/{bunitId}/consumers/{consumerId}/node/schedules?ignoreAssigned={ignoreAssigned}

Add schedule to node.
(SP)

DELETE v1/bunits/{bunitId}/consumers/{consumerId}/node/schedules/{scheduleId}?ignoreNotAssigned={ignoreNotAssigned}

Remove schedule from node.
(SP)

GET v1/bunits/{bunitId}/consumers/{consumerId}/node/nodeschedules/{nodescheduleId}/resolveerror

Set errors of schedule as handled. This will resolve in no errors for the backup node if no events for this schedule
Once a new event with an error happens for the schedule, it will return to unhandled

GET v1/bunits/{bunitId}/consumers/{consumerId}/node/nodeschedules/{nodescheduleId}/unresolveerror

Set errors of schedule as not handled. This will resolve in errors being created for the backup node again for this schedule

GET v1/bunits/{bunitId}/consumers/{consumerId}/node/nodeschedules

Get schedules related to a backup node along with information about the relation between the schedule and the backup node.

ScheduleBinding

Schedule binding enables restriction of associations between backup nodes schedules based on schedule names and backup node types.

APIDescription
GET v1/bunits/{bunitId}/schedulebindings

Get all data centers of a business unit.

GET v1/bunits/{bunitId}/schedulebindings/{bindingId}

Get a single schedule binding.

POST v1/bunits/{bunitId}/schedulebindings

Create a schedule binding.

PUT v1/bunits/{bunitId}/schedulebindings/{bindingId}

Update a schedule binding.

DELETE v1/bunits/{bunitId}/schedulebindings/{bindingId}

Delete a schedule binding.

APIDescription
GET v1/search/bunits?searchTerm={searchTerm}&bunitId={bunitId}

Returns a list of business units with names or ERP reference in their contract matching the search term.
If the searchterm is a number, it will also search by business unit ID.

GET v1/search/consumers?searchTerm={searchTerm}&bunitId={bunitId}

Returns a list of consumption units with name or IDs matching the search term.

GET v1/search/unassignednodes?searchTerm={searchTerm}&bunitId={bunitId}

Returns a list of unassigned items with names matching the search term.

GET v1/search/deletednodes?searchTerm={searchTerm}&bunitId={bunitId}

Returns a list of nodes previously related to now deleted consumption units with names matching the search term.

GET v1/search/unassigneddatasources?searchTerm={searchTerm}&bunitId={bunitId}

Returns a list of unassigned data-sources with names matching the search term.

GET v1/search/users?searchTerm={searchTerm}&bunitId={bunitId}

Returns a list of users with names and/or email addresses matching the search term.

GET v1/search/deleterequests?searchTerm={searchTerm}&bunitId={bunitId}

Returns a list of deletion requests with information matching the search term.

GET v1/search/emailSubscribers?searchTerm={searchTerm}&bunitId={bunitId}

Returns a list of email subscriptions with an email addresses matching the search term.

ServerCredentials

Server credentials

APIDescription
GET v1/bunits/{bunitId}/datacenters/{dataCenterId}/spservers/{spServerId}/credentials

Returns all credentials for a server.

GET v1/bunits/{bunitId}/users/{userId}/credentials

Returns a user's keychain, i.e. all server credentials for a user.

POST v1/bunits/{bunitId}/datacenters/{dataCenterId}/spservers/{spServerId}/credentials?userId={userId}

Add a new set of server credentials to a server and a user's keychain.

PUT v1/bunits/{bunitId}/datacenters/{dataCenterId}/spservers/{spServerId}/credentials/{credentialsId}

Update a set of credentials.

DELETE v1/bunits/{bunitId}/datacenters/{dataCenterId}/spservers/{spServerId}/credentials/{credentialsId}

Delete a set of credentials.

ServerReportDeliveryConfig

Server report delivery configurations enable sending emails when new reports are available.

APIDescription
GET v1/bunits/{bunitId}/serverdeliveryconfigs
GET v1/bunits/{bunitId}/serverdeliveryconfigs/{deliveryConfigId}
POST v1/bunits/{bunitId}/serverdeliveryconfigs
PUT v1/bunits/{bunitId}/serverdeliveryconfigs/{deliveryConfigId}
PATCH v1/bunits/{bunitId}/serverdeliveryconfigs/{deliveryConfigId}

Overwrites the resource's property values with the values specified in the delta object.

DELETE v1/bunits/{bunitId}/serverdeliveryconfigs/{deliveryConfigId}

ServiceLevelAgreement

Information about SLA for business unit

APIDescription
GET v1/bunits/{bunitId}/sla

Get the default SLA of the business unit
If none exists an inherited SLA will be found

POST v1/bunits/{bunitId}/sla

Create an SLA for a business unit

PUT v1/bunits/{bunitId}/sla

Update an SLA

DELETE v1/bunits/{bunitId}/sla

Delete an SLA
If deleted the business unit will use an inherited SLA

GET v1/bunits/{bunitId}/slafordescendants

Get the SLA of the business unit used for its descendants
If none exists an inherited SLA will be found

POST v1/bunits/{bunitId}/slafordescendants

Create an SLA for a business unit for descendants

PUT v1/bunits/{bunitId}/slafordescendants

Update an SLA for descendants

DELETE v1/bunits/{bunitId}/slafordescendants

Delete an SLA for descendants
If deleted the business unit will use an inherited SLA

SlaDomain

Rubrik SLA domain

APIDescription
GET v1/bunits/{bunitId}/datacenters/{dataCenterId}/rubrikservers/{rubrikServerId}/sladomains?sync={sync}

Get all SLA domains of a server.

GET v1/bunits/{bunitId}/datacenters/{dataCenterId}/rubrikservers/{rubrikServerId}/sladomains/{slaDomainId}

Get an SLA domain of a server.

PUT v1/bunits/{bunitId}/datacenters/{dataCenterId}/rubrikservers/{rubrikServerId}/sladomains/{slaDomainId}

Update information of SLA domain
Function is currently limited to information on Cloutility and will not be reflected on Rubrik

GET v1/bunits/{bunitId}/consumers/{consumerId}/rubrikdatasource/sladomains

Get SLA domains related to a data-source

GET v1/bunits/{bunitId}/consumers/{consumerId}/rubrikdatasource/availablesladomains

Get SLA domains that the data-source can be related to

POST v1/bunits/{bunitId}/consumers/{consumerId}/rubrikdatasource/sladomains

Add SLA domain to data-source

DELETE v1/bunits/{bunitId}/consumers/{consumerId}/rubrikdatasource/sladomains/{slaDomainId}

Remove relation to SLA domain for data-source

Smtp

SMTP settings used when sending emails regarding the business unit and its descendants

APIDescription
GET v1/bunits/{bunitId}/smtp

Get all outgoing email (SMTP) settings for a business unit.

GET v1/bunits/{bunitId}/smtp/{smtpId}

Get a single set of outgoing email (SMTP) settings of a business unit.

POST v1/bunits/{bunitId}/smtp

Create outgoing email (SMTP) settings for a business unit.

PUT v1/bunits/{bunitId}/smtp/{smtpId}

Update outgoing email (SMTP) settings.

DELETE v1/bunits/{bunitId}/smtp/{smtpId}

Delete an outgoing email (SMTP) setting.

POST v1/bunits/{bunitId}/smtp/verify

Verify outgoing email (SMTP) settings by connecting to SMTP server and sending a test email.

This method requires an additional field on the SmtpSettings object, "testRecipient",
which specifies the recipient email address for the test email.

SpPlusServer

IBM Storage Protect Plus servers in data center

APIDescription
GET v1/bunits/{bunitId}/datacenters/{dataCenterId}/spplusservers

Get all IBM Storage Protect Plus servers related to a data center.

GET v1/bunits/{bunitId}/datacenters/{dataCenterId}/spplusservers/{spPlusServerId}

Get a single server.

GET v1/bunits/{bunitId}/defaultspplusserver

Get the default server of a business unit
The server used when creating new hypervisors. If a business unit has no server selected, a default server will be assigned
based on certain criteria: Does the business unit have a data center and if so is there a default server in this data center?
If not find the default server of the parent using the same criteria: Is one selected => does a data center with a default server exist => inheritance.

GET v1/bunits/{bunitId}/fallbackspplusserver

Get the fallback server of a business unit
This will be the server set as default for the business unit if none is selected.
The rules for finding it is the same as the default server but the currently selected server will
not be considered. If none is selected for the business unit the default server and the fallback server
will be the same.
This server is used to inform about which server will be used if the currently selected is removed

POST v1/bunits/{bunitId}/datacenters/{dataCenterId}/spplusservers

Create a new server and starts a synchronization process.

GET v1/bunits/{bunitId}/datacenters/{dataCenterId}/spplusservers/{spPlusServerId}/sync

Force synchronization with the SP environment.

PUT v1/bunits/{bunitId}/datacenters/{dataCenterId}/spplusservers/{spPlusServerId}

Update a server.

PATCH v1/bunits/{bunitId}/datacenters/{dataCenterId}/spplusservers/{spPlusServerId}

Overwrites the resource's property values with the values specified in the delta object.

DELETE v1/bunits/{bunitId}/datacenters/{dataCenterId}/spplusservers/{spPlusServerId}?deleteDataSources={deleteDataSources}

Delete a server.

GET v1/bunits/{bunitId}/datacenters/{dataCenterId}/spplusservers/{spPlusServerId}/logs

Get logs of a server

SpServer

Servers in data center

APIDescription
GET v1/bunits/{bunitId}/datacenters/{dataCenterId}/spservers

Get all servers related to a data center.

GET v1/bunits/{bunitId}/datacenters/{dataCenterId}/spservers/{spServerId}

Get a single server.

GET v1/bunits/{bunitId}/defaultserver

Get the default server of a business unit
The server used when creating new nodes. If a business unit has no server selected, a default server will be assigned
based on certain criteria: Does the business unit have a data center and if so is there a default server in this data center?
If not find the default server of the parent using the same criteria: Is one selected => does a data center with a default server exist => inheritance.

GET v1/bunits/{bunitId}/fallbackserver

Get the fallback server of a business unit
This will be the server set as default for the business unit if none is selected.
The rules for finding it is the same as the default server but the currently selected server will
not be considered. If none is selected for the business unit the default server and the fallback server
will be the same.
This server is used to inform about which server will be used if the currently selected is removed

GET v1/bunits/{bunitId}/AvailableSpServers

Get a list of IBM Storage Protect servers avaiable to the user
when creating new backup nodes
These servers reside on business units between where the backup node
is created and the business unit of the current user

GET v1/bunits/{bunitId}/managedtsm?syncStateType={syncStateType}

Returns all IBM Storage Protect servers managed by a business unit with their respective domains and backup nodes included.

POST v1/bunits/{bunitId}/datacenters/{dataCenterId}/spservers

Create a new server and starts a synchronization process.

GET v1/bunits/{bunitId}/datacenters/{dataCenterId}/spservers/{spServerId}/sync

Force synchronization with the SP environment.

GET v1/bunits/{bunitId}/datacenters/{dataCenterId}/spservers/{spServerId}/resetnodes

Set all SP Node IDs to null
Reason for doing this could be that a new environment has been set up
If NodeIDs have changed next syncronization should be based on SP Name instead of ID as these may have changed

PUT v1/bunits/{bunitId}/datacenters/{dataCenterId}/spservers/{spServerId}

Update a server.

PATCH v1/bunits/{bunitId}/datacenters/{dataCenterId}/spservers/{spServerId}

Overwrites the resource's property values with the values specified in the delta object.

DELETE v1/bunits/{bunitId}/datacenters/{dataCenterId}/spservers/{spServerId}?deleteDataSources={deleteDataSources}

Delete a server.

GET v1/bunits/{bunitId}/datacenters/{dataCenterId}/spservers/{spServerId}/logs

Get logs of a server

GET v1/bunits/{bunitId}/servererrors?includeDescendants={includeDescendants}

Get a list of all servers that have had errors during synchronization with Cloutility

GET v1/bunits/{bunitId}/datacenters/{dataCenterId}/spservers/{spServerId}/overlapinfo

Get information about how much overlap should be used

StatusReport

Status reports contain information about data usage and nodes for a business unit. Status reports can have information about nodes owned by the business unit itself, owned by children or both (internal, resale or combined) Generally they will be customied to the user performing the request.

APIDescription
GET v1/bunits/{bunitId}/reports?type={type}

Get all status reports of the business unit. Use these to see development over time in summary details like data usage or nodes.
As such, these reports will not be customized for the requesting user because they do not contain node reports.

GET v1/bunits/{bunitId}/reports/{reportDate}?userId={userId}&viewId={viewId}&logLevel={logLevel}

Get status report for a business unit.

GET v1/bunits/{bunitId}/reports/{reportDate}/send?subscriptionId={subscriptionId}&includeIncidents={includeIncidents}

Send a status report to the recipients of a status subscription.

GET v1/bunits/{bunitId}/reports/latest?userId={userId}

Get the latest status report of the business unit.

StatusReportConsumptionUnitDeliveryConfig

Status report delivery configurations outlines what should be included in status report subscriptions

APIDescription
GET v1/bunits/{bunitId}/statusconsumptionunitdeliveryconfig

Get the default status report delivery config of the business unit
If none exists an inherited config will be found

POST v1/bunits/{bunitId}/statusconsumptionunitdeliveryconfig

Create a status report delivery config for a business unit

PUT v1/bunits/{bunitId}/statusconsumptionunitdeliveryconfig

Update a status report delivery config

DELETE v1/bunits/{bunitId}/statusconsumptionunitdeliveryconfig

Delete a status report delivery config
If deleted the business unit will use an inherited config

StatusReportDeliveryConfig

Status report delivery configurations outlines what should be included in status report subscriptions

APIDescription
GET v1/bunits/{bunitId}/statusdeliveryconfig

Get the default status report delivery config of the business unit
If none exists an inherited config will be found

POST v1/bunits/{bunitId}/statusdeliveryconfig

Create a status report delivery config for a business unit

PUT v1/bunits/{bunitId}/statusdeliveryconfig

Update a status report delivery config

DELETE v1/bunits/{bunitId}/statusdeliveryconfig

Delete a status report delivery config
If deleted the business unit will use an inherited config

StatusReportEmailContent

Status report email content outlines what texts should be in status reports

APIDescription
GET v1/bunits/{bunitId}/statusreportemailcontent

Get the default status report email content of the business unit
If none exists an inherited config will be found

POST v1/bunits/{bunitId}/statusreportemailcontent

Create status report email content for a business unit

PUT v1/bunits/{bunitId}/statusreportemailcontent

Update status report email content

DELETE v1/bunits/{bunitId}/statusreportemailcontent

Delete status report email content
If deleted the business unit will use inherited email content

StatusReportSubscription

Status report subscriptions enable sending emails when new reports are available.

APIDescription
GET v1/bunits/{bunitId}/statusreportsubscriptions

Get all status report subscriptions of a business unit

GET v1/bunits/{bunitId}/statusreportsubscriptions/{statusReportSubscriptionId}

Get a status report subscription

POST v1/bunits/{bunitId}/statusreportsubscriptions

Create a status report subscription for a business unit

PUT v1/bunits/{bunitId}/statusreportsubscriptions/{statusReportSubscriptionId}

Update a status report subscription

PATCH v1/bunits/{bunitId}/statusreportsubscriptions/{statusReportSubscriptionId}

Overwrites the resource's property values with the values specified in the delta object.

DELETE v1/bunits/{bunitId}/statusreportsubscriptions/{statusReportSubscriptionId}

Delete a status report subscription

StatusReportView

Status report views contain configurations for how status reports are viewed. They can be used by all users of the business unit they are related to

APIDescription
GET v1/bunits/{bunitId}/statusreportviews

Get a list of all status report views created by the business unit

GET v1/bunits/{bunitId}/statusreportviews/{statusReportViewId}

Get a single status report view related to a business unit

POST v1/bunits/{bunitId}/statusreportviews

Create a status report view

PUT v1/bunits/{bunitId}/statusreportviews/{statusReportViewId}

Update a status report view

DELETE v1/bunits/{bunitId}/statusreportviews/{statusReportViewId}

Delete a status report view

StoragePool

Servers in data center

APIDescription
GET v1/bunits/{bunitId}/datacenters/{dataCenterId}/spservers/{spServerId}/storagepools?tsmSync={tsmSync}

Get all servers related to a data center.

Subscription

Subscriptions created by a business unit

APIDescription
GET v1/bunits/{bunitId}/subscriptions

Get all subscriptions created by a business unit

GET v1/bunits/{bunitId}/subscriptions/{subscriptionId}

Get a subscription

POST v1/bunits/{bunitId}/subscriptions

Create a subscription

PUT v1/bunits/{bunitId}/subscriptions/{subscriptionId}

Update a subscription

DELETE v1/bunits/{bunitId}/subscriptions/{subscriptionId}

Delete a subscription

GET v1/bunits/{bunitId}/assignedsubscriptions

Get all subscriptions a business unit is assigned

POST v1/bunits/{bunitId}/assignedsubscriptions

Assign a subscription

DELETE v1/bunits/{bunitId}/assignedsubscriptions/{subscriptionId}

Unassign a subscription

GET v1/bunits/{bunitId}/unassignedsubscriptions

Get all subscriptions a business unit can be assigned.
A business unit can be assigned all subscriptions created by their ancestors up to and including the
first with a contract or that of the current user (which ever comes first).
Subscriptions which are assigned to the first ancestor with a contract or that of the current
user is aslo included.
Be aware that subscriptions that are already assigned is not in this list

GET v1/bunits/{bunitId}/availablesubscriptions

Get a list of subscriptions that can be assigned to a contract for the given business unit.
This is not a list of subscriptions available for the selected business unit when creating contracts

GET v1/bunits/{bunitId}/subscriptions/{subscriptionId}/subscribers

Get a list of business units that have a contract using the subscription

GET v1/bunits/{bunitId}/subscriptions/{subscriptionId}/exceptions

Get a list of contract exceptions that are the subscription

SubscriptionComponent

Components of a subscription

APIDescription
GET v1/bunits/{bunitId}/subscriptions/{subscriptionId}/components

Get all components of a subscription

GET v1/bunits/{bunitId}/subscriptions/{subscriptionId}/components/{componentId}

Get a single component

POST v1/bunits/{bunitId}/subscriptions/{subscriptionId}/components

Create a component

PUT v1/bunits/{bunitId}/subscriptions/{subscriptionId}/components/{componentId}

Update a component

DELETE v1/bunits/{bunitId}/subscriptions/{subscriptionId}/components/{componentId}

Delete a component

SubscriptionLog

Status report subscriptions enable sending emails when new reports are available.

APIDescription
GET v1/bunits/{bunitId}/statusreportsubscriptions/{statusReportSubscriptionId}/logs

Get all logs of a status report subscription

GET v1/bunits/{bunitId}/exportDataSubscriptions/{exportDataSubscriptionId}/logs

Get all logs of a data export subscription

GET v1/bunits/{bunitId}/jobsubscriptions/{jobSubscriptionId}/logs

Get all logs of a job subscription

System

Controller for information related to the system itself

APIDescription
GET v1/version

Get version of the assembly
Available without being logged in

GET v1/fullversion

Returns the full version of the system stored in the system settings

GET v1/latestimporttime

Returns the full version of the system stored in the system settings

GET v1/latestjobcreationtime

Returns the full version of the system stored in the system settings

GET v1/dedupstatsdays

Returns the number of days dedup stats are valid

GET v1/loginmessage

Returns the message to display on the login page

GET v1/PdfSupport

The system may support converting certain reports to PDF

POST v1/system?action={action}

An end point for making changes that affects the entire system.
Available actions are:
ResetStatusReports: Delete all status and node reports for the current date, resets servers to do reporting again.

GET v1/system/errors?startDate={startDate}&endDate={endDate}

Get a list of unique errors that have occurred in the system within a time span

GET v1/system/errors

Get a list of unique errors that have occurred in the system within the last day

GET v1/bunits/{bunitId}/errors?startDate={startDate}&endDate={endDate}&includeDescendants={includeDescendants}

Get a list of errors that have occurred within a time span that relates to a business unit

GET v1/bunits/{bunitId}/errors

Get a list of errors that have occurred within a time span that relates to a business unit

GET v1/versionhistory

Get a list of updates made to the system containing version and date

GET v1/daemons

Get a list of daemons including information about latest runtime

GET v1/daemons/{daemonId}

Get a daemon including a list of all sessions

GET v1/daemons/{daemonId}/daemonSessions

Get a list of sessions of a daemon

GET v1/daemons/{daemonId}/daemonSessions/{daemonSessionId}

Get a list of sessions of a daemon

GET v1/daemons/{daemonId}/daemonSessions/{daemonSessionId}/daemonLogs

Get a list of sessions of a daemon

SystemErrorDeliveryConfig

Status report delivery configurations enable sending emails when new reports are available.

APIDescription
GET v1/bunits/{bunitId}/systemerrordeliveryconfigs
GET v1/bunits/{bunitId}/systemerrordeliveryconfigs/{deliveryConfigId}
POST v1/bunits/{bunitId}/systemerrordeliveryconfigs
PUT v1/bunits/{bunitId}/systemerrordeliveryconfigs/{deliveryConfigId}
DELETE v1/bunits/{bunitId}/systemerrordeliveryconfigs/{deliveryConfigId}

SystemSetting

Manage global system settings. Changing these settings will affect the entire system.

APIDescription
GET v1/systemsettings

Returns all system settings.

GET v1/systemsettings/{key}

Returns a specific system setting.

GET v1/systemsettings/OAuthAllowed

Whether or not the system allows OAuth

GET v1/systemsettings/MaxUploadSizeKb

Whether or not the system allows OAuth

GET v1/systemsettings/PreventSendingAutomaticEmails

Whether or not the system sends automatic emails

PUT v1/systemsettings/{key}

Updates the value of a system setting.

Tag

Tags are used to filter business units when searching and viewing and sending out reports

APIDescription
GET v1/bunits/{bunitId}/tags/own

Get the tags that are created by the current business unit

POST v1/bunits/{bunitId}/tags/own

Create a new tag

PUT v1/bunits/{bunitId}/tags/own/{tagId}

Update a tag

DELETE v1/bunits/{bunitId}/tags/own/{tagId}

Delete a tag

GET v1/bunits/{bunitId}/tags/available

Get a list of tags available to the user for assigning to business units.
These tags are those related to the current user's business unit along with
the tags inherited from the ancestors of the current user's business unit

GET v1/bunits/{bunitId}/tags/availablesubscriptions

Get a list of tags available for the business unit to add to a status report subscription.
These tags are those related to the business unit the report should be created for along
with any inherited from the ancestors of the business unit

GET v1/bunits/{bunitId}/tags

Get the tags assigned to a business unit.
These are the assigned tags related to the current user's business unit
along with the assigned tags that are inherited from the current user's
business unit, no matter who assigned them

GET v1/bunits/{bunitId}/consumers/{consumerId}/tags

Get the tags assigned to a consumption unit.
These are the assigned tags related to the current user's business unit
along with the assigned tags that are inherited from the current user's
business unit, no matter who assigned them

POST v1/bunits/{bunitId}/tags

Assign a tag to a business unit

POST v1/bunits/{bunitId}/consumers/{consumerId}/tags

Assign a tag to a consumption unit

DELETE v1/bunits/{bunitId}/tags/{tagId}

Unassign a tag from a business unit

DELETE v1/bunits/{bunitId}/consumers/{consumerId}/tags/{tagId}

Unassign a tag from a consumption unit

GET v1/bunits/{bunitId}/tags/own/{tagId}/consumers

Get a list of consumption units with a given tag

GET v1/bunits/{bunitId}/tags/own/{tagId}/businessunits

Get a list of business units with a given tag

TimeZone

Time zone operations

APIDescription
GET v1/timezones

Get all time zones.

GET v1/timezones/{timeZoneId}

Get a specific time zone.

GET v1/timezones/{timeZoneId}/offset?date={date}

Returns the timezone's offset in minutes.

TotpSettings

Information about how TOTP is required

APIDescription
GET v1/bunits/{bunitId}/totpsettings
PUT v1/bunits/{bunitId}/totpsettings
DELETE v1/bunits/{bunitId}/totpsettings

TsmRequest

API controller for SP requests.

APIDescription
POST v1/bunits/{bunitId}/tsmoperations?returnJson={returnJson}

Perform an SP API request.

User

Operations for managing system users.

APIDescription
GET v1/me

Returns the user for the active profile (the authenticated user performing the request).

POST v1/me/itemsperpage?itemsPerPage={itemsPerPage}

Update the setting for items per page for current user

POST v1/me/groupbybusinessunit?groupByBusinessUnit={groupByBusinessUnit}

Update the setting for group by business unit for current user

GET v1/me/jobtags

Get tags used for filtering job report

POST v1/me/jobtags

Update all job tags of user

DELETE v1/me/jobtags/{tagId}

Remove tag for list used to filter job report

PUT v1/bunits/{bunitId}/users/{userId}/password

Changes the password for a specific user.

POST v1/bunits/{bunitId}/users/{userId}/reset?appUrl={appUrl}&resetUrl={resetUrl}

Create a reset password request for a user.

POST v1/reset?appUrl={appUrl}

Set a new password for a user, using a password reset token.

POST v1/reset/{email}?appUrl={appUrl}&resetUrl={resetUrl}

Create a reset password request for a user with the specified email if he exists.

GET v1/bunits/{bunitId}/users

Get all users related to a business unit.

POST v1/bunits/{bunitId}/users?appUrl={appUrl}&welcomeUrl={welcomeUrl}

Create a new user in a business unit.

GET v1/bunits/{bunitId}/users/{userId}?expand={expand}

Returns a user.

GET v1/bunits/{bunitId}/users/{userId}/deliveries

Get all deliveries for a user
Types:
StatusReport (0)
NodeReport (1)
ServerReport (2)
JobReport (3)
ActivityReport (4)

GET v1/bunits/{bunitId}/deleterequestapprovercount

Get the number of delete request approvers for the provided business unit

GET v1/bunits/{bunitId}/deleterequestapprovers

Get the delete request approvers for the provided business unit

PUT v1/bunits/{bunitId}/users/{userId}

Updates the values of user resource.

PATCH v1/bunits/{bunitId}/users/{userId}

Updates only the supplied values of a user resource.

DELETE v1/bunits/{bunitId}/users/{userId}?deleteSubscriptions={deleteSubscriptions}&anonymize={anonymize}

Deletes a user resource.

GET v1/bunits/{bunitId}/users/{userId}/movedestinations

Returns the business units that the user can be moved to

GET v1/bunits/{bunitId}/users/{userId}/totp

Get a newly generated secret key for TOTP
Can only be done by users not already using TOTP
It is not possibe to retrieve previously generated codes

POST v1/maketotp

Create a secret key for a user

POST v1/bunits/{bunitId}/users/{userId}/totp

When a secret key has been generated the user needs to confirm it before using it

POST v1/verifytotp

When a secret key has been generated the user needs to confirm it before using it

DELETE v1/bunits/{bunitId}/users/{userId}/totp

Turn off time-based one-time password (TOTP) for the user

VirtualMachineReport

****** DEPRECATED, please use consumption unit report endpoint ****** VirtualMachine reports contain information about the VM, its backups and status You can get the first and latest report to get information about when reports have been made Get all reports to display graphs of development for data

APIDescription
GET v1/bunits/{bunitId}/consumers/{consumerId}/vmfilespace/reports?startDate={startDate}&endDate={endDate}&status={status}&warnings={warnings}

Get all reports for a VM

GET v1/bunits/{bunitId}/consumers/{consumerId}/vmfilespace/reports/{reportDate}?userId={userId}

Returns the VM report for the VM on the specified date.

GET v1/bunits/{bunitId}/consumers/{consumerId}/vmfilespace/reports/latest?userId={userId}

Returns the latest VM report for the specified VM.

GET v1/bunits/{bunitId}/consumers/{consumerId}/vmfilespace/reports/first?userId={userId}

Returns the first VM report for the specified VM.

GET v1/bunits/{bunitId}/consumers/{consumerId}/vmfilespace/reports?virtualMachineId={virtualMachineId}&startDate={startDate}&endDate={endDate}&status={status}&warnings={warnings}

OBSOLETE: Virtual machines are no longer directly related to business unit.
Please use bunits/{bunitId}/consumers/{consumerId}/virtualmachine/reports

Get all reports for a VM

GET v1/bunits/{bunitId}/consumers/{consumerId}/vmfilespace/reports/{reportDate}?virtualMachineId={virtualMachineId}&userId={userId}

OBSOLETE: Virtual machines are no longer directly related to business unit.
Please use bunits/{bunitId}/consumers/{consumerId}/virtualmachine/reports

Returns the VM report for the VM on the specified date.

GET v1/bunits/{bunitId}/vmfilespace/{filespaceId}/reports/latest?virtualMachineId={virtualMachineId}&userId={userId}

OBSOLETE: Virtual machines are no longer directly related to business unit.
Please use bunits/{bunitId}/consumers/{consumerId}/virtualmachine/reports/latest

Returns the latest VM report for the specified VM.

GET v1/bunits/{bunitId}/vmfilespace/{filespaceId}/reports/first?virtualMachineId={virtualMachineId}&userId={userId}

OBSOLETE: Virtual machines are no longer directly related to business unit.
Please use bunits/{bunitId}/consumers/{consumerId}/virtualmachine/first

Returns the first VM report for the specified VM.

Vm

VMs

APIDescription
GET v1/bunits/{bunitId}/consumers/{consumerId}/vm

Get a VM related to a consumer

GET v1/bunits/{bunitId}/consumers/{consumerId}/hypervisor/vms

Get VMs related to a hypervisor

GET v1/bunits/{bunitId}/vms

Get VMs related to hypervisors of a business unit
These are or can be related to the business unit or descendants of the business unit

POST v1/bunits/{bunitId}/vms

Assign a VM to a business unit.

This will create a consumer as well

DELETE v1/bunits/{bunitId}/consumers/{consumerId}/vm?deleteAssociations={deleteAssociations}

Unassign a VM from a business unit
This will delete the consumption unit that relates the VM to the business unit
Any data related to the VM will be added to that of the hypervisor it is related to

GET v1/bunits/{bunitId}/vms/{vmId}/destinations

Get possible move destinations

GET v1/bunits/{bunitId}/consumers/{consumerId}/vm/backuppolicies

Get backup policies assigned to a VM

GET v1/bunits/{bunitId}/consumers/{consumerId}/vm/availablebackuppolicies

Get backup policies available to a VM
These excludes the ones already assigned

POST v1/bunits/{bunitId}/consumers/{consumerId}/vm/backuppolicies

Assign a backup policy to a VM

DELETE v1/bunits/{bunitId}/consumers/{consumerId}/vm/backuppolicies/{backupPolicyId}

Unassign a backup policy from a VM

VmAssignmentFilter

APIDescription
POST v1/bunits/{bunitId}/vmAssignmentFilters

Create a filter for assigning backup nodes to a business unit

GET v1/bunits/{bunitId}/vmAssignmentFilters/{vmAssignmentFilterId}

Get a single backup node assignment filter

GET v1/bunits/{bunitId}/vmAssignmentFilters

Get a list of all backup node assignment filters owned by business unit

DELETE v1/bunits/{bunitId}/vmAssignmentFilters/{vmAssignmentFilterId}

Deletes a backup node assignment filter

PUT v1/bunits/{bunitId}/vmAssignmentFilters/{vmAssignmentFilterId}

Update a single backup node assignment filter

PATCH v1/bunits/{bunitId}/vmAssignmentFilters/{vmAssignmentFilterId}

Overwrites the resource's property values with the values specified in the delta object.

VmReport

****** DEPRECATED, please use consumption unit report endpoint ****** Reports contain information about the vm, its backups and status You can get the first and latest report to get information about when reports have been made Get all reports to display graphs of development for data

APIDescription
GET v1/bunits/{bunitId}/consumers/{consumerId}/vm/reports?startDate={startDate}&endDate={endDate}&status={status}&warnings={warnings}

Get reports for a vm

GET v1/bunits/{bunitId}/consumers/{consumerId}/vm/reports/{reportDate}?userId={userId}

Returns the report for a VM on the specified date.

GET v1/bunits/{bunitId}/consumers/{consumerId}/vm/reports/latest?userId={userId}

Returns the latest report for the specified vm.

GET v1/bunits/{bunitId}/consumers/{consumerId}/vm/reports/first?userId={userId}

Returns the first report for the specified VM.