Operations for the Developer SDK for Python

The Python SDK includes common operations for entities. For detailed documentation on the available operations, review the documentation included in the Python SDK:

  • To view documentation for a module, from the Python command line, type the following command:

    >>> from cvpysdk import module_name >>> help(module_name)

    where module_name is the name of the module, for example, commcell. For a list of modules, see the following table.

  • To view documentation for a class, from the Python command line, type the following command:

    >>> from cvpysdk.module_name import class_name >>> help(class_name)

    where:

    • module_name is the name of the module, for example, usergroup. For a list of modules, see the following table.

    • class_name is the name of the class, for example, UserGroup. For a list of classes, see the following table.

The following table lists common modules and classes included in the Python SDK. For a complete listing, go to the Commvault Developer SDK - Python GitHub site.

Class

Module

Description

Examples

Agent

agent

Performs operations for an agent associated with a client

  • agent.enable_backup()

  • agent.enable_backup_at_time(2017-05-10 23:00:00)

  • agent.disable_backup()

  • agent.enable_restore()

  • agent.enable_restore_at_time(2017-05-10 23:10:30)

  • agent.disable_restore()

Agents

agent

Performs operations on all agents associated with a client

  • boolean_value = client.agents.has_agent(agent_name)

  • agent = client.agents.get(agent_name)

Alert

alert

Performs operations on an alert

  • alert.enable()

  • alert.disable()

  • alert.enable_notification_type()

  • alert.disable_notification_type()

Alerts

alert

Performs operations on all alerts

  • boolean_value = commcell.alerts.has_alert(alert_name)

  • alert = commcell.alerts.get(alert_name)

  • alert = commcell.alerts.get(alert_name=‘Index State’)

  • commcell.alerts.delete(alert_name)

  • console_alerts = commcell.alerts.console_alerts()

ApiLibrary

services

Service URLs for REST API operations

Backupset

backupset

Performs operations on a backup set

  • Update backup set Name: backupset.backupset_name = new_backupset_name

  • Update backup set description: backupset.backupset_description = new_backupset_description

  • backupset.set_default_backupset()

  • jobs_list = backupset.backup()

Backupsets

backupset

Performs operations on all backup sets associated with an agent

  • boolean_value1 = agent.backupsets.has_backupset(backupset_name)

  • boolean_value2 = instance.backupsets.has_backupset(backupset_name)

  • backupset1 = agent.backupsets.get(backupset_name)

  • backupset = agent.backupsets.get(backupset_name='defaultBackupSet')

  • backupset2 = instance.backupsets.get(backupset_name)

  • agent.backupsets.delete(backupset_name)

  • instance.backupsets.delete(backupset_name)

  • backupset1 = agent.backupsets.add(backupset_name)

  • backupset2 = instance.backupsets.add(backupset_name)

Client

client

Performs operations on a client

  • client.enable_backup()

  • client.enable_backup_at_time(2017-05-10 23:00:00)

  • client.disable_backup()

  • client.enable_restore()

  • client.enable_restore_at_time(2017-05-10 23:10:30)

  • client.disable_restore()

  • client.enable_data_aging()

  • client.enable_data_aging_at_time(2017-05-10 23:10:30)

  • client.disable_data_aging()

Clients

client

Performs operations on all clients

  • client = commcell.clients.get(client_name='Client001')

  • boolean_value = commcell.clients.has_client(client_name)

  • client = commcell.clients.get(client_name)

  • commcell.clients.delete(client_name)

  • vmware_client = commcell.clients.add_vmware_client(client_name, vcenter_hostname, vcenter_username, vcenter_password, clients)

ClientGroup

clientgroup

Performs operations on a client computer group

  • clientgroup.enable_backup()

  • clientgroup.enable_backup_at_time(2017-05-10 23:00:00)

  • clientgroup.disable_backup()

  • clientgroup.enable_restore()

  • clientgroup.enable_restore_at_time(2017-05-10 23:10:30)

  • clientgroup.disable_restore()

  • clientgroup.enable_data_aging()

  • clientgroup.enable_data_aging_at_time(2017-05-10 23:10:30)

  • clientgroup.disable_data_aging()

  • clientgroup.add_clients()

  • clientgroup.remove_clients()

  • clientgroup.remove_all_clients()

ClientGroups

clientgroup

Performs operations on all client computer groups

  • boolean_value = commcell.client_groups.has_clientgroup(clientgroup_name)

  • clientgroup = commcell.client_groups.get(clientgroup_name)

  • commcell.client_groups.delete(clientgroup_name)

  • clientgroup = commcell.client_groups.add(clientgroup_name, clients, clientgroup_description, enable_backup, enable_restore, enable_data_aging)

Commcell

commcell

Initializes a connection to the CommCell environment and is the wrapper for all CommCell operations

  • commcell = Commcell(client.mydomain.com, admin, 123abc)

  • commcell.logout()

CVPySDK

cvpysdk

Logs on and off of the CommCell environment and runs the HTTP request

DiskLibrary

storage

Performs operations on a disk library

Read-only attributes:

  • disk_library.library_id

  • disk_library.library_name

DiskLibraries

storage

Performs operations on all disk libraries associated with the CommCell environment

  • disk_library = commcell.disk_libraries.add(library_name='lib001', media_agent='MA0712', mount_path='C:\\Lib001', username='jsmith', password='C2#uzI8p')

  • boolean_value = commcell.disk_libraries.has_library(library_name)

  • disk_library = commcell.disk_libraries.get(library_name)

Instance

instance

Performs operations on an instance

Read-only attributes:

  • instance.instance_id

  • instance.instance_name

Instances

instance

Performs operations on all instances

  • instance = agent.instances.get(instance_name='instance001')

  • boolean_value = agent.instances.has_instance(instance_name)

Job

job

Performs operations on a job and reports the job status

  • job.pause()

  • job.resume()

  • job.kill()

  • job.status

  • job.is_finished

  • job.job_type

  • job.pending_reason

  • job.delay_reason

  • job.start_time

  • job.end_time

MediaAgent

storage

Performs operations on a MediaAgent

Read-only attributes:

  • media_agent.media_agent_id

  • media_agent.media_agent_name

MediaAgents

storage

Performs operations on all MediaAgents associated with the CommCell environment

  • media_agent = commcell.media_agents.get(media_agent_name='MA0712')

  • boolean_value = commcell.media_agents.has_media_agent(media_agent_name)

Schedules

schedules

Performs operations on all schedules associated with the CommCell environment

  • commcell.schedules.has_schedule(schedule_name='Data Aging')

  • print(client.schedules)

  • boolean_value = client.schedules.has_schedule(schedule_name)

  • print(agent.schedules)

  • boolean_value = agent.schedules.has_schedule(schedule_name)

  • print(backupset.schedules)

  • boolean_value = backupset.schedules.has_schedule(schedule_name)

  • print(subclient.schedules)

  • boolean_value = subclient.schedules.has_schedule(schedule_name)

SchedulePolicies

storage

Performs operations on all schedule policies associated with an entity

boolean_value = commcell.schedule_policies.has_policy(policy_name='FS_monthly')

SDKException

exception

Handles all exceptions for the CVPySDK Python package

StoragePolicies

storage

Performs operations on all storage policies associated with the CommCell environment

  • boolean_value = commcell.storage_policies.has_policy(policy_name)

  • commcell.storage_policies.delete(policy_name)

  • commcell.storage_policies.add(policy_name, library, media_agent, dedup_path, incremental_sp, retention_period)

Subclient

subclient

Performs operations on one subclient and performs operations on the subclient

  • Update Subclient Description: subclient.description = new_description

  • Update Subclient content: subclient.content = new_content

  • subclient.enable_backup()

  • subclient.enable_backup_at_time()

  • subclient.disable_backup()

  • job = subclient.backup(backup_level='Full')

  • paths, dictionary = subclient.browse(path='C:\\Users\\jsmith\\Documents', show_deleted_files=False)

  • paths, dictionary = subclient.browse_in_time(path='C:\\Users\\jsmith\\Documents', show_deleted_files=False, from_date='29/07/2016', to_date='31/12/2016')

  • paths, dictionary = subclient.find(file_or_folder_name=”setup”)

  • job = subclient.restore_in_place(paths=[“Folder1”, “Folder2”, “File1”, “File2”])

  • job = subclient.restore_out_of_place(client, destination_path, paths=[“Folder1”, “Folder2”, “File1”, “File2”])

Subclients

subclient

Performs operations on all subclients associated with a backup set

  • boolean_value1 = instance.subclients.has_subclient(subclient_name)

  • boolean_value2 = backupset.subclients.has_subclient(subclient_name)

  • subclient1 = instance.subclients.get(subclient_name)

  • subclient2 = backupset.subclients.get(subclient_name)

  • subclient = backupset.subclients.get(subclient_name='default')

  • instance.subclients.delete(subclient_name)

  • backupset.subclients.delete(subclient_name)

  • subclient1 = instance.subclients.add(subclient_name, storage_policy, description)

  • subclient2 = backupset.subclients.add(subclient_name, storage_policy, description)

UserGroup

usergroup

Performs operations on one user group

Read-only attributes:

  • usergroup.user_group_id

  • usergroup.user_group_name

  • usergroup.description

  • usergroup.email

  • usergroup.users

  • usergroup.associations

UserGroups

usergroup

Performs operations on all user groups associated with the CommCell environment

  • commcell.user_groups.delete(user_group_name='sales')

  • boolean_value = commcell.user_groups.has_user_group(usergroup_name)

  • user_group = commcell.user_groups.get(usergroup_name)

Workflow

workflow

Handles all workflows and runs workflow jobs.

  • boolean_value = commcell.workflows.has_workflow(workflow_name)

  • job = commcell.workflows.execute_workflow(workflow_name)

Loading...