models.backup_run module

class models.backup_run.BackupRun(environment=None, error=None, job_run_id=None, message=None, metadata_deleted=None, quiesced=None, run_type=None, sla_violated=None, snapshots_deleted=None, snapshots_deleted_time_usecs=None, source_backup_status=None, stats=None, status=None, warnings=None, worm_retention_type=None)[source]

Bases: object

Implementation of the ‘BackupRun’ model.

Specifies details about the Backup task for a Job Run. A Backup task captures the original backup snapshots for each Protection Source in the Job.

Attributes:
environment (EnvironmentBackupRunEnum): Specifies the environment type

that the task is protecting. Supported environment types such as ‘kView’, ‘kSQL’, ‘kVMware’, etc. NOTE: ‘kPuppeteer’ refers to Cohesity’s Remote Adapter. ‘kVMware’ indicates the VMware Protection Source environment. ‘kHyperV’ indicates the HyperV Protection Source environment. ‘kSQL’ indicates the SQL Protection Source environment. ‘kView’ indicates the View Protection Source environment. ‘kPuppeteer’ indicates the Cohesity’s Remote Adapter. ‘kPhysical’ indicates the physical Protection Source environment. ‘kPure’ indicates the Pure Storage Protection Source environment. ‘Nimble’ indicates the Nimble Storage Protection Source environment. ‘kAzure’ indicates the Microsoft’s Azure Protection Source environment. ‘kNetapp’ indicates the Netapp Protection Source environment. ‘kAgent’ indicates the Agent Protection Source environment. ‘kGenericNas’ indicates the Generic Network Attached Storage Protection Source environment. ‘kAcropolis’ indicates the Acropolis Protection Source environment. ‘kPhsicalFiles’ indicates the Physical Files Protection Source environment. ‘kIsilon’ indicates the Dell EMC’s Isilon Protection Source environment. ‘kGPFS’ indicates IBM’s GPFS Protection Source environment. ‘kKVM’ indicates the KVM Protection Source environment. ‘kAWS’ indicates the AWS Protection Source environment. ‘kExchange’ indicates the Exchange Protection Source environment. ‘kHyperVVSS’ indicates the HyperV VSS Protection Source environment. ‘kOracle’ indicates the Oracle Protection Source environment. ‘kGCP’ indicates the Google Cloud Platform Protection Source environment. ‘kFlashBlade’ indicates the Flash Blade Protection Source environment. ‘kAWSNative’ indicates the AWS Native Protection Source environment. ‘kO365’ indicates the Office 365 Protection Source environment. ‘kO365Outlook’ indicates Office 365 outlook Protection Source environment. ‘kHyperFlex’ indicates the Hyper Flex Protection Source environment. ‘kGCPNative’ indicates the GCP Native Protection Source environment. ‘kAzureNative’ indicates the Azure Native Protection Source environment. ‘kKubernetes’ indicates a Kubernetes Protection Source environment. ‘kElastifile’ indicates Elastifile Protection Source environment. ‘kAD’ indicates Active Directory Protection Source environment. ‘kRDSSnapshotManager’ indicates AWS RDS Protection Source environment. ‘kCassandra’ indicates Cassandra Protection Source environment. ‘kMongoDB’ indicates MongoDB Protection Source environment. ‘kCouchbase’ indicates Couchbase Protection Source environment. ‘kHdfs’ indicates Hdfs Protection Source environment. ‘kHive’ indicates Hive Protection Source environment. ‘kHBase’ indicates HBase Protection Source environment.

error (string): Specifies if an error occurred (if any) while running

this task. This field is populated when the status is equal to ‘kFailure’.

job_run_id (long|int): Specifies the id of the Job Run that ran the

backup task and the copy tasks.

message (string): Specifies a message after finishing the task

successfully. This field is optionally populated when the status is equal to ‘kSuccess’.

metadata_deleted (bool): Specifies if the metadata and snapshots

associated with this Job Run have been deleted. This field is set to true when the snapshots, which are marked for deletion, are removed by garbage collection. The associated metadata is also deleted.

quiesced (bool): Specifies if app-consistent snapshot was captured.

This field is set to true, if an app-consistent snapshot was taken by quiescing applications and the file system before taking a backup.

run_type (RunTypeEnum): Specifies the type of backup such as

‘kRegular’, ‘kFull’, ‘kLog’ or ‘kSystem’. ‘kRegular’ indicates a incremental (CBT) backup. Incremental backups utilizing CBT (if supported) are captured of the target protection objects. The first run of a kRegular schedule captures all the blocks. ‘kFull’ indicates a full (no CBT) backup. A complete backup (all blocks) of the target protection objects are always captured and Change Block Tracking (CBT) is not utilized. ‘kLog’ indicates a Database Log backup. Capture the database transaction logs to allow rolling back to a specific point in time. ‘kSystem’ indicates a system backup. System backups are used to do bare metal recovery of the system to a specific point in time.

sla_violated (bool): Specifies if the SLA was violated for the Job

Run. This field is set to true, if time to complete the Job Run is longer than the SLA specified. This field is populated when the status is set to ‘kSuccess’ or ‘kFailure’.

snapshots_deleted (bool): Specifies if backup snapshots associated

with this Job Run have been marked for deletion because of the retention settings in the Policy or if they were manually deleted from the Cohesity Dashboard.

snapshots_deleted_time_usecs (long|int): Specifies if backup snapshots

associated with this Job Run have been marked for deletion because of the retention settings in the Policy or if they were manually deleted from the Cohesity Dashboard.

source_backup_status (list of SourceBackupStatus): Array of Source

Object Backup Status. Specifies the status of backing up each source objects (such as VMs) associated with the job.

stats (ProtectionJobRunStats): Specifies statistics about a Protection

Job Run. This contains the Job Run level statistics.

status (StatusBackupRunEnum): Specifies the status of Backup task such

as ‘kRunning’, ‘kSuccess’, ‘kFailure’ etc. ‘kAccepted’ indicates the task is queued to run but not yet running. ‘kRunning’ indicates the task is running. ‘kCanceling’ indicates a request to cancel the task has occurred but the task is not yet canceled. ‘kCanceled’ indicates the task has been canceled. ‘kSuccess’ indicates the task was successful. ‘kFailure’ indicates the task failed. ‘kWarning’ indicates the task has finished with warning. ‘kOnHold’ indicates the task is kept onHold. ‘kMissed’ indicates the task is missed.

warnings (list of string): Array of Warnings. Specifies the warnings

that occurred (if any) while running this task.

worm_retention_type (WormRetentionTypeEnum): Specifies WORM retention

type for the snapshot as given by the policy. When a WORM retention type is specified, the snapshot will be kept until the maximum of the snapshot retention time. During that time, the snapshot cannot be deleted. ‘kNone’ implies there is no WORM retention set. ‘kCompliance’ implies WORM retention is set for compliance reason. ‘kAdministrative’ implies WORM retention is set for administrative purposes.

classmethod from_dictionary(dictionary)[source]

Creates an instance of this model from a dictionary

Args:

dictionary (dictionary): A dictionary representation of the object as obtained from the deserialization of the server’s response. The keys MUST match property names in the API description.

Returns:

object: An instance of this structure class.