Global Administration#

Logging In#

GlobalAdmin.login(username, password)

Parameters:

username (str) – Username
password (str) – Password

admin.login('admin', 'G3neralZ0d!')

GlobalAdmin.logout(): Log out

admin.logout()

Browsing Tenants#

Portals.browse_global_admin(): Browse the Global Admin

admin.portals.browse_global_admin()

Portals.browse(tenant)

Browse a tenant

Parameters:: tenant (str) – Name of the tenant to browse

admin.portals.browse('portal')

Managing Licenses#

Licenses.all()

Retrieve a list of installed licenses

Returns:: A list of licenses
Return type:: list[cterasdk.common.object.Object]

Licenses.add(*keys)

Add license keys

Parameters:: keys (list[str]) – List of license keys

admin.licenses.add('ABCD', 'EFGH', 'IJKL')

Licenses.remove(*keys)

Remove license keys

Returns:: A list of installed licenses
Return type:: list[cterasdk.common.object.Object]

admin.licenses.remove('ABCD')

Storage Classes#

StorageClasses.add(name)

Add a storage class

Parameters:: name (str) – Name

admin.storage_classes.add('Archive')

StorageClasses.all()

Get storage classes

Returns:: List of storage classes
Return type:: list(cterasdk.common.object.Object)

for storage_class in admin.storage_classes.all():
    print(storage_class)

StorageClasses.get(name)

Get storage class

Parameters:: name (str) – Storage class name, defaults to None
Returns:: Storage class
Return type:: cterasdk.common.object.Object

print(admin.storage_classes.get('Archive'))

Managing Storage Nodes#

Buckets.get(name, include=None)

Get a Bucket

Parameters:

name (str) – Name of the bucket
include (list[str]) – List of fields to retrieve, defaults to ['name']

bucket = admin.buckets.get('MainStorage')
print(bucket)

bucket = admin.buckets.get('MainStorage', include=['bucket', 'driver'])
print(bucket.name, bucket.bucket, bucket.driver)

Buckets.add(name, bucket, read_only=False, dedicated_to=None)

Add a Bucket

Parameters:

name (str) – Name of the bucket
bucket (cterasdk.core.types.Bucket) – Storage bucket to add
read_only (bool,optional) – Set bucket to read-delete only, defaults to False
dedicated_to (str,optional) – Name of a tenant, defaults to None

"""Add an Amazon S3 bucket using IAM Role Policy"""
bucket = core_types.AmazonS3('mybucket')
admin.buckets.add('cterabucket', bucket)

"""Add an Amazon S3 bucket called 'mybucket' using an access key and secret key pair"""
bucket = core_types.AmazonS3('mybucket', 'access-key', 'secret-key')
admin.buckets.add('cterabucket', bucket)

"""Add an Amazon S3 bucket called 'mybucket', dedicated to a tenant called 'mytenant'"""
bucket = core_types.AmazonS3('mybucket', 'access-key', 'secret-key')
admin.buckets.add('cterabucket', bucket, dedicated_to='mytenant')

"""Add an Amazon S3 bucket and trust all certificates"""
bucket = core_types.AmazonS3('mybucket', verify_ssl=False)
admin.buckets.add('cterabucket', bucket)

"""Add a bucket in read-delete only mode"""
bucket = core_types.AmazonS3('mybucket', 'access-key', 'secret-key')
admin.buckets.add('cterabucket', bucket, read_only=True)

Buckets.modify(current_name, new_name=None, read_only=None, dedicated_to=None, verify_ssl=None)

Modify a Bucket

Parameters:

current_name (str) – The current bucket name
new_name (str,optional) – New name
read_only (bool,optional) – Set bucket to read-delete only
dedicated (bool,optional) – Dedicate bucket to a tenant
verify_ssl (bool,optional) – False to trust all certificate, True to verify.
dedicated_to (str,optional) – Tenant name

"""Modify an existing bucket, set it to read-delete only and dedicate it to 'mytenant'"""
admin.buckets.modify('MainStorage', read_only=True, dedicated_to='mytenant')

Buckets.list_buckets(include=None)

List Buckets.

To retrieve buckets, you must first browse the Global Administration Portal, using: GlobalAdmin.portals.browse_global_admin()

Parameters:: include (list[str],optional) – List of fields to retrieve, defaults to ['name']

for bucket in admin.buckets.list_buckets():
    print(bucket)

Buckets.delete(name)

Delete a Bucket

Parameters:: name (str) – Name of the bucket

admin.buckets.delete('MainStorage')

Buckets.read_write(name)

Set bucket to Read Write

Parameters:: name (str) – Name of the bucket

admin.buckets.read_write('MainStorage')

Buckets.read_only(name)

Set bucket to Read Only

Parameters:: name (str) – Name of the bucket

admin.buckets.read_only('MainStorage')

Managing Portals#

Querying#

Portals.list_tenants(include=None, portal_type=None)

List tenants.

To retrieve tenants, you must first browse the Global Administration Portal, using: GlobalAdmin.portals.browse_global_admin()

Parameters:

include (list[str],optional) – List of fields to retrieve, defaults to [‘name’]
portal_type (cterasdk.core.enum.PortalType) – The Portal type

"""List all tenants"""
for tenant in admin.portals.list_tenants():
    print(tenant)

"""List Team Portals. For each tenant, retrieve its creation date, subscription plan and activation status"""
for tenant in admin.portals.list_tenants(include=['createDate', 'plan', 'activationStatus'], portal_type=core_enum.PortalType.Team):
    print(tenant)

Portals.tenants(include_deleted=False)

Get all tenants

Parameters:: include_deleted (bool,optional) – Include deleted tenants, defaults to False

for tenant in admin.portals.tenants():
    print(tenant.name, tenant.usedStorageQuota, tenant.totalStorageQuota)

Creating a Team Portal#

Portals.add(name, display_name=None, billing_id=None, company=None, plan=None, comment=None)

Add a new tenant

Parameters:

name (str) – Name of the new tenant
display_name (str,optional) – Display Name of the new tenant, defaults to None
billing_id (str,optional) – Billing ID of the new tenant, defaults to None
company (str,optional) – Company Name of the new tenant, defaults to None
plan (str,optional) – Subscription plan name to assign to the new tenant, defaults to None
comment (str,optional) – Assign a comment to the new tenant, defaults to None

Return str:

A relative url path to the Team Portal

"""Create a Team Portal"""

admin.portals.add('acme')

"""Create a Team Portal, including a display name, billing id and a company name"""

admin.portals.add('ctera', 'CTERA', 'Tz9YRDSd8LNfaouzr3Db', 'CTERA Networks')

"""Create a Team Portal and assign it to a pre-configured subscription plan"""
admin.portals.add('ctera', plan = 'Default')

Subcribing a Portal to a Plan#

Portals.subscribe(tenant, plan)

Subscribe a tenant to a plan

Parameters:

name (str) – Name of the tenant
str,plan – Name of the subscription plan

admin.portals.subscribe('ctera', '10tb')

Apply Provisioning Changes#

Portals.apply_changes(wait=False)

Apply provisioning changes.

Parameters:: wait (bool,optional) – Wait for all changes to apply

"""Apply Portal Provisioning Changes"""
admin.portals.apply_changes()
admin.portals.apply_changes(wait=True)  # wait for all changes to apply

"""Apply User Provisioning Changes"""
admin.users.apply_changes()
admin.users.apply_changes(wait=True)  # wait for all changes to apply

Delete a Team Portal#

Portals.delete(name)

Delete an existing tenant

Parameters:: name (str) – Name of the tenant to delete

admin.portals.delete_tenant('acme')

Recover a Team Portal#

Portals.undelete(name)

Undelete a previously deleted tenant

Parameters:: name (str) – Name of the tenant to undelete

admin.portals.undelete_tenant('acme')

Subscription Plans#

Plans.get(name, include=None)

Retrieve subscription plan properties

Parameters:

name (str) – Name of the subscription plan
include (list[str]) – List of fields to retrieve, defaults to [‘name’]

Returns:

The subscription plan, including the requested fields

plan = admin.plans.get('good_plan', ['createDate', 'modifiedDate'])

Plans.list_plans(include=None, filters=None)

List Plans

Parameters:

include (list[str],optional) – List of fields to retrieve, defaults to [‘name’]
filters (list[],optional) – List of additional filters, defaults to None

Returns:

Iterator for all matching Plans

Return type:

cterasdk.lib.iterator.Iterator

"""List plans and include their creation date"""
for plan in admin.plans.list_plans(['createDate']):
    print(plan)

Plans.by_name(names, include=None)

Get Plans by their names

Parameters:

names (list[str],optional) – List of names of plans
include (list[str],optional) – List of fields to retrieve, defaults to [‘name’]
filters (list[cterasdk.core.query.FilterBuilder],optional) – List of additional filters, defaults to None

Returns:

Iterator for all matching Plans

Return type:

cterasdk.lib.iterator.Iterator

"""List plans 'PlanOne' and 'PlanTwo'; and retrieve the 'modifiedDate', 'uid' and 'isDefault' properties"""
for plan in admin.plans.by_name(['PlanOne', 'PlanTwo'], ['modifiedDate', 'uid', 'isDefault']):
    print(plan)

Plans.add(name, services=None, retention=None, quotas=None)

Add a subscription plan

Parameters:

services (dict,optional) – Services to enable or disable
retention (dict,optional) – The data retention policy
quotas (dict,optional) – The items included in the plan and their respective quota

"""
Retention Policy (core_enum.PlanRetention):
- All: All Versions
- Hourly: Hourly Versions
- Daily: Daily Versions
- Weekly: Weekly Versions
- Monthly: Monthly Versions
- Quarterly: Quarterly Versions
- Yearly: Yearly Versions
- Deleted: Recycle Bin

Quotas (core_enum.PlanItem):
- Storage: Storage Quota, in Gigabytes
- EV4: CTERA Edge Filer, Up to 4 TB of Local Cache
- EV8: CTERA Edge Filer, Up to 8 TB of Local Cache
- EV16: CTERA Edge Filer, Up to 16 TB of Local Cache
- EV32: CTERA Edge Filer, Up to 32 TB of Local Cache
- EV64: CTERA Edge Filer, Up to 64 TB of Local Cache
- EV128: CTERA Edge Filer, Up to 128 TB of Local Cache
- WA: Workstation Backup Agent
- SA: Server Agent
- Share: CTERA Drive Share
- Connect: CTERA Drive Connect
"""

"""
Create the 'good_plan' subscription plan:
1) Retention: 7 daily versions, 12 monthly versions
2) Quotas: 10 x EV16, 5 x EV32, 100 x Cloud Drive (Share)
"""

name = 'good_plan'
services = {core_enum.PlanService.CloudBackup: core_enum.PlanServiceState.Disabled, core_enum.PlanService.CloudDrive: core_enum.PlanServiceState.Disabled}
retention = {core_enum.PlanRetention.Daily: 7, core_enum.PlanRetention.Monthly: 12}
quotas = {core_enum.PlanItem.EV16: 10, core_enum.PlanItem.EV32: 5, core_enum.PlanItem.Share: 100}
admin.plans.add(name, services, retention, quotas)

Plans.modify(name, services=None, retention=None, quotas=None, apply_changes=True)

Modify a subscription plan

Parameters:

services (dict,optional) – Services to enable or disable
retention (dict,optional) – The data retention policy
quotas (dict,optional) – The items included in the plan and their respective quota
apply_changes (bool,optional) – Apply provisioning changes immediately

"""
Modify 'good_plan' subscription plan:
1) Retention: 30 daily versions, 36 monthly versions
2) Quotas: 20 x EV16, 10 x EV32, 200 x Cloud Drive (Share)
"""

name = 'good_plan'
services = {core_enum.PlanService.CloudBackup: core_enum.PlanServiceState.Disabled, core_enum.PlanService.CloudDrive: core_enum.PlanServiceState.Disabled}
retention = {core_enum.PlanRetention.Daily: 30, core_enum.PlanRetention.Monthly: 36}
quotas = {core_enum.PlanItem.EV16: 20, core_enum.PlanItem.EV32: 10, core_enum.PlanItem.Share: 200}
admin.plans.modify(name, services, retention, quotas)

Plans.delete(name)

Delete a subscription plan

Parameters:: username (str) – The name of the subscription plan

name = 'good_plan'
admin.plan.delete(name)

Plan Auto Assignment Rules#

PlanAutoAssignPolicy.get_policy(): Get plans auto assignment policy

PlanAutoAssignPolicy.set_policy(rules, apply_default=None, default=None, apply_changes=True)

Set plans auto assignment policy

Parameters:

rules (list[cterasdk.common.types.PolicyRule]) – List of policy rules
apply_default (bool,optional) – If no match found, apply default plan. If not passed, the current config will be kept
default (str,optional) – Name of a plan to assign if no match found. Ignored unless the apply_default is set to True
apply_changes (bool,optional) – Apply provisioning changes upon update, defaults to True

"""Apply the '100GB' plan to all user names that start with 'adm'"""
c1 = core_types.PlanCriteriaBuilder.username().startswith('adm').build()
r1 = PolicyRule('100GB', c1)

"""Apply the '200GB' plan to all user names that end with 'inc'"""
c2 = core_types.PlanCriteriaBuilder.username().endswith('inc').build()
r2 = PolicyRule('200GB', c2)

"""Apply the 'Bingo' plan to all user names that contain 'bing'"""
c3 = core_types.PlanCriteriaBuilder.username().contains('bing').build()
r3 = PolicyRule('Bingo', c3)

"""Apply the 'ABC' plan to 'alice', 'bob' and 'charlie'"""
c4 = core_types.PlanCriteriaBuilder.username().isoneof(['alice', 'bob', 'charlie']).build()
r4 = PolicyRule('ABC', c4)

"""Apply the '10TB' plan to read write, read only and support administrators"""
roles = [core_enum.Role.ReadWriteAdmin, core_enum.Role.ReadOnlyAdmin, core_enum.Role.Support]
c5 = core_types.PlanCriteriaBuilder.role().include(roles).build()
r5 = PolicyRule('10TB', c5)

"""Apply the 'TechStaff' plan to the 'Product' and 'Support' groups"""
c6 = core_types.PlanCriteriaBuilder.user_groups().include(['Product', 'Support']).build()
r6 = PolicyRule('TechStaff', c6)

admin.plans.auto_assign.set_policy([r1, r2, r3, r4, r5, r6])

"""Remove all policy rules"""
admin.plans.auto_assign.set_policy([])

"""Do not assign a default plan if no match applies"""
admin.plans.auto_assign.set_policy([], False)

"""Assign 'Default' if no match applies"""
admin.plans.auto_assign.set_policy([], True, 'Default')

Configuration Templates#

Templates.get(name, include=None)

Get a Configuration Template

Parameters:

name (str) – Name of the template
include (list[str]) – List of fields to retrieve, defaults to ['name']

admin.templates.get('MyTemplate')

Templates.list_templates(include=None, filters=None)

List Configuration Templates.

To retrieve templates, you must first browse the tenant, using: GlobalAdmin.portals.browse()

Parameters:

include (list[str],optional) – List of fields to retrieve, defaults to ['name']
filters (list[],optional) – List of additional filters, defaults to None

for template in admin.templates.list_templates(include=['name', 'description', 'modifiedDate']):
    print(template.name, template.description, template.modifiedDate)

Templates.add(name, description=None, include_sets=None, exclude_sets=None, apps=None, backup_schedule=None, versions=None, update_settings=None, scripts=None, cli_commands=None, consent_page=None)

Add a Configuration Template

Parameters:

name (str) – Name of the template
description (str,optional) – Template description
include_sets (list[cterasdk.common.types.FilterBackupSet],optional) – List of backup sets to include
exclude_sets (list[cterasdk.common.types.FilterBackupSet],optional) – List of backup sets to exclude
apps (list[cterasdk.common.enum.Application],optional) – List of applications to back up
backup_schedule (cterasdk.common.types.TaskSchedule,optional) – Backup schedule
versions (list[cterasdk.core.types.PlatformVersion],optional) – List of platforms and their associated versions. Pass None to inherit the default settings from the Global Administration Portal
update_settings (cterasdk.common.types.SoftwareUpdatesTopic,optional) – Software update settings
scripts (list[cterasdk.core.types.TemplateScript],optional) – Scripts to execute after logon, before or after backup
cli_commands (list[str],optional) – Template CLI commands to execute
consent_page (cterasdk.common.types.ConsentPage) – Consent page to show to end-user

This library provides several classes, methods and enumerators to assist in creating configuration templates: #. Builder class for filtered backup sets. cterasdk.common.types.FileFilterBuilder #. A class representing a backup include or exclude set. cterasdk.common.types.FilterBackupSet #. Builder class for defining backup schedule. cterasdk.common.types.BackupScheduleBuilder #. A time-range class, used to configure backups to run at a specific time. cterasdk.common.types.TimeRange #. Enumerator containing applications supported for backup. cterasdk.common.enum.Application #. A named tuple defining a platform and a software version. cterasdk.core.types.PlatformVersion #. Enumerator containing a list of platforms. cterasdk.core.enum.Platform

"""Include all 'pptx', 'xlsx' and 'docx' file types for all users"""
docs = common_types.FileFilterBuilder.extensions().include(['pptx', 'xlsx', 'docx']).build()
include_sets = common_types.FilterBackupSet('Documents', filter_rules=[docs],
                                                      template_dirs=[core_enum.EnvironmentVariables.ALLUSERSPROFILE])

"""Exclude all 'cmd', 'exe' and 'bat' file types for all users"""
programs = common_types.FileFilterBuilder.extensions().include(['cmd', 'exe', 'bat']).build()
exclude_sets = common_types.FilterBackupSet('Programs', filter_rules=[programs],
                                                        template_dirs=[core_enum.EnvironmentVariables.ALLUSERSPROFILE])

"""Schedule backup to run periodically"""
backup_schedule = common_types.BackupScheduleBuilder.interval(hours=6)  # periodically, every 6 hours
backup_schedule = common_types.BackupScheduleBuilder.interval(hours=0, minutes=30)  # periodically, every 30 minutes

"""Schedule backup for a specific time"""
time_range = common_types.TimeRange().start('07:00:00').days(common_enum.DayOfWeek.Weekdays).build()  # 7am, on weekdays
backup_schedule = common_types.BackupScheduleBuilder.window(time_range)

"""Backup applications"""
apps = [common_enum.Application.NTDS, common_enum.Application.HyperV]  # back up Active Directory and Hyper-V
apps = common_enum.Application.All  # back up all applications

"""Configure software versions"""
versions = [core_types.PlatformVersion(core_enum.Platform.Edge_7, '7.0.981.7')]  # use 7.0.981.7 for v7 Edge Filers

"""Configure software update schedule"""
schedule = common_types.TimeRange().start('01:00:00').end('02:00:00').days(common_enum.DayOfWeek.Weekdays).build()
builder = common_types.SoftwareUpdatePolicyBuilder()
update_settings = builder.download_and_install(True).reboot_after_update(True).schedule(schedule).build()

"""Configure Scripts"""
scripts = [
    core_types.TemplateScript.windows().after_logon('echo Current directory: %cd%'),
    core_types.TemplateScript.linux().before_backup('./mysqldump -u admin website > /mnt/backup/backup.sql'),
    core_types.TemplateScript.linux().after_backup('rm /mnt/backup/backup.sql')
]

"""Configure CLI Commands"""
cli_commands = [
    'set /config/agent/stubs/deleteFilesOfCachedFolderOnDisable false',
    'add /config/agent/stubs/allowedExplorerExtensions url'
]

"""Configure Consent Page"""
consent_page = common_types.ConsentPage('the header of your consent page', 'the body of your consent page')

admin.templates.add('MyTemplate', 'woohoo', include_sets=[include_sets], exclude_sets=[exclude_sets],
                   backup_schedule=backup_schedule, apps=apps, versions=versions, update_settings=update_settings,
                   scripts=scripts, cli_commands=cli_commands, consent_page=consent_page)

Templates.set_default(name, wait=False)

Set a Configuration Template as the default template

Parameters:

name (str) – Name of the template
wait (bool,optional) – Wait for all changes to apply, defaults to False

admin.templates.set_default('MyTemplate')

admin.templates.set_default('MyTemplate', wait=True)  # wait for template changes to apply

Templates.remove_default(name, wait=False)

Set a Configuration Template not to be the default template

Parameters:

name (str) – Name of the template
wait (bool,optional) – Wait for all changes to apply, defaults to False

admin.templates.remove_default('MyTemplate')

admin.templates.remove_default('MyTemplate', wait=True)  # wait for template changes to apply

TemplateAutoAssignPolicy.apply_changes(wait=False)

Apply provisioning changes.

Parameters:: wait (bool,optional) – Wait for all changes to apply, defaults to False

admin.templates.auto_assign.apply_changes()

admin.templates.auto_assign.apply_changes(wait=True)  # wait for template changes to apply

Template Auto Assignment Rules#

TemplateAutoAssignPolicy.get_policy(): Get templates auto assignment policy

TemplateAutoAssignPolicy.set_policy(rules, apply_default=None, default=None, apply_changes=True)

Set templates auto assignment policy

Parameters:

rules (list[cterasdk.common.types.PolicyRule]) – List of policy rules
apply_default (bool,optional) – If no match found, apply default template. If not passed, the current config will be kept
default (str,optional) – Name of a template to assign if no match found. Ignored unless the apply_default is set to True
apply_changes (bool,optional) – Apply changes upon update, defaults to True

"""Apply the 'ESeries' template to devices of type: C200, C400, C800, C800P"""
device_types = [core_enum.DeviceType.C200, core_enum.DeviceType.C400, core_enum.DeviceType.C800, core_enum.DeviceType.C800P]
c1 = core_types.TemplateCriteriaBuilder.type().include(device_types).build()
r1 = PolicyRule('ESeries', c1)

"""Apply the 'Windows' template to devices that use a 'Windows' operating system"""
c2 = core_types.TemplateCriteriaBuilder.os().contains('Windows').build()
r2 = PolicyRule('Windows', c2)

"""Apply the 'CTERA7' template to devices running version 7"""
c3 = core_types.TemplateCriteriaBuilder.version().startswith('7.0').build()
r3 = PolicyRule('CTERA7', c3)

"""Apply the 'WD5' template to devices that their hostname ends with 'WD5'"""
c4 = core_types.TemplateCriteriaBuilder.hostname().endswith('WD5').build()
r4 = PolicyRule('WD5', c4)

"""Apply the 'Beta' template to devices that their name is one of"""
c5 = core_types.TemplateCriteriaBuilder.name().isoneof(['DEV1', 'DEV2', 'DEV3']).build()
r5 = PolicyRule('Beta', c5)

admin.templates.auto_assign.set_policy([r1, r2, r3, r4, r5])

"""Remove all policy rules"""
admin.templates.auto_assign.set_policy([])

"""Do not assign a default template if no match applies"""
admin.templates.auto_assign.set_policy([], False)

"""Assign 'Default' if no match applies"""
admin.templates.auto_assign.set_policy([], True, 'Default')

Portal Servers#

Servers.get(name, include=None)

Retrieve server properties

Parameters:

name (str) – Name of the server
include (list[str]) – List of fields to retrieve, defaults to [‘name’]

Returns:

The server, including the requested fields

"""Retrieve a server"""

server = admin.servers.get('server', ['isApplicationServer', 'renderingServer'])
print(server.isApplicationServer, server.renderingServer)

Servers.list_servers(include=None)

Retrieve the servers that comprise CTERA Portal.

To retrieve servers, you must first browse the Global Administration Portal, using: GlobalAdmin.portals.browse_global_admin()

Parameters:: include (list[str],optional) – List of fields to retrieve, defaults to [‘name’]

"""Retrieve all servers"""
servers = admin.servers.list_servers() # will only retrieve the server name
for server in servers:
    print(server.name)

"""Retrieve multiple server attributes"""
servers = admin.servers.list_servers(include = ['name', 'connected', 'isApplicationServer', 'mainDB'])
for server in servers:
    print(server)

Servers.modify(name, server_name=None, app=None, preview=None, enable_public_ip=None, public_ip=None, allow_user_login=None, enable_replication=None, replica_of=None)

Modify a Portal server

Parameters:

name (str) – The current server name
server_name (str,optional) – New server name
app (bool,optional) – Application server
preview (bool,optional) – Preview server
enable_public_ip (bool,optional) – Enable or disable public NAT address
public_ip (str,optional) – Public NAT address
allow_user_login (bool,optional) – Allow or disallow logins to this server
enable_replication (bool,optional) – Enable or disable database replication
replica_of (str,optional) – Configure as a replicate of another Portal server. enable_replication must be set to True

admin.servers.modify('server2', server_name='replica', app=False, enable_replication=True, replica_of='maindb')  # rename and enable database replication

admin.servers.modify('server2', allow_user_login=False)  # disable logins to this server

admin.servers.modify('server2', enable_public_ip=True, public_ip='33.191.55.2')  # configure a public NAT ip address

Server Tasks#

Tasks.background(name)

Get all background tasks

Parameters:: name (str) – Name of the server
Returns:: List of tasks

for task in admin.servers.tasks.background('database'):
    print(task.name)

Tasks.scheduled(name)

Get all scheduled tasks

Parameters:: name (str) – Name of the server
Returns:: List of tasks

for task in admin.servers.tasks.scheduled('database'):
   print(task.name)

Messaging Service#

Messaging.get_status(): Retrieve the global status of messaging service

"""Retrieve the global status of Messaging service"""

print(admin.messaging.get_status())

Messaging.get_servers_status(): Retrieve the status of the messaging servers

"""Retrieve the status of the Messaging servers"""

print(admin.messaging.get_servers_status())

Messaging.add(servers)

Add messaging servers to cluster

Parameters:: servers (list[str]) – Server names (number of allowed servers: 1 or 3)

"""Add Messaging servers to cluster"""

servers = ["server1", "server2", "server3"]
admin.messaging.add(servers)

Key Management Service#

KMS.settings(): Get Key Management Service Settings

admin.kms.settings()

KMS.status(): Get Key Management Service Status

admin.kms.status()

KMS.enable(private_key, client_certificate, server_certificate, expiration=None, timeout=None, port=None)

Enable Key Management Service

Parameters:

private_key (str) – The PEM-encoded private key, or a path to the PEM-encoded private key file
client_certificate (str) – The PEM-encoded client certificate, or a path to the certificate file
server_certificate (str) – The PEM-encoded KMS server certificate, or a path to the certificate file
expiration (int,optional) – Key expiration in days, defaults to 365.
timeout (int,optional) – Connection timeout in seconds, defaults to 2
port (int,optional) – Key server port, defaults to 5696

private_key = './private_key.pem'
client_certificate = './client_certificate.crt'
server_certificate = './server_certificate.crt'

admin.kms.enable(private_key, client_certificate, server_certificate)

KMS.disable(): Disable Key Management Service

admin.kms.disable()

KMS.modify(private_key=None, client_certificate=None, server_certificate=None, expiration=None, timeout=None, port=None)

Modify Key Management Service Settings

Parameters:

private_key (str,optional) – The PEM-encoded private key, or a path to the PEM-encoded private key file
client_certificate (str,optional) – The PEM-encoded client certificate, or a path to the certificate file
server_certificate (str,optional) – The PEM-encoded KMS server certificate, or a path to the certificate file
expiration (int,optional) – Key expiration in days, defaults to 365.
timeout (int,optional) – Connection timeout in seconds, defaults to 2
port (int,optional) – Key server port, defaults to 5696

Key Management Service Servers#

KMSServers.get(name)

Retrieve a key-server

Parameters:: name (str) – Key-server name

admin.kms.servers.get('kms001')

KMSServers.all(): List Key Management Servers

for server in admin.kms.servers.all():
    print(server)

KMSServers.add(name, ipaddr)

Add a key-server

Parameters:

name (str) – Key-server name
ipaddr (str) – Key-server IP address

admin.kms.servers.add('kms001', '192.168.30.1')

KMSServers.modify(current_name, new_name)

Remove a key-server

Parameters:

current_name (str) – Key-server current name
new_name (str) – Key-server new name

admin.kms.servers.modify('kms001', 'kms001-renamed')

KMSServers.delete(name)

Remove a key-server

Parameters:: name (str) – Key-server name

admin.kms.servers.delete('kms001')

Antivirus#

Antivirus.list_servers(include=None)

List the antivirus servers

Parameters:: include (list[str],optional) – List of fields to retrieve, defaults to ['name', 'type']

Antivirus.status(): Get antivirus service status

Antivirus.rescan(): Scan all files using the latest antivirus update. This may take a while

Antivirus.suspend(): Suspend antivirus scanning

Antivirus.unsuspend(): Unsuspend antivirus scanning

Antivirus Servers#

AntivirusServers.get(name)

Get an antivirus server’s configuration

Parameters:: name (str) – Server name

AntivirusServers.add(name, vendor, url, connection_timeout=5)

Add an antivirus server

Parameters:

name (str) – Server name
vendor (cterasdk.core.enum.AntivirusType) – Server type
url (str) – Server URL (example: http://your-antivirus.server.local:1234/signature)
connection_timeout (int,optional) – Server connection timeout (in seconds), defaults to 5 seconds

AntivirusServers.delete(name): Remove an antivirus server

AntivirusServers.suspend(name): Suspend an antivirus server

AntivirusServers.unsuspend(name): Unsuspend antivirus scanning

Global Administrators#

Administrators.list_admins(include=None)

List local administrators

Parameters:: include (list[str]) – List of fields to retrieve, defaults to [‘name’]
Returns:: Iterator for local administrators
Return type:: cterasdk.lib.iterator.Iterator

"""list all global admins"""
for admin in admin.admins.list_global_administrators():
    print(admin.name)

for admin in admin.admins.list_global_administrators(include=['name', 'email', 'firstName', 'lastName']):
    print(admin)

Administrators.add(name, email, first_name, last_name, password, role, company=None, comment=None, password_change=False)

Create a Global Administrator

Parameters:

name (str) – User name for the new GlobalAdmin
email (str) – E-mail address of the new GlobalAdmin
first_name (str) – The first name of the new GlobalAdmin
last_name (str) – The last name of the new GlobalAdmin
password (str) – Password for the new GlobalAdmin
role (cterasdk.core.enum.Role) – User role of the new GlobalAdmin
company (str,optional) – The name of the company of the new GlobalAdmin, defaults to None
comment (str,optional) – Additional comment for the new GlobalAdmin, defaults to None
password_change (variable,optional) – Require the user to change the password on the first login. Pass datetime.date for a specific date, integer for days from creation, or True for immediate , defaults to False

"""Create a global admin"""
admin.admins.add('bruce', 'bruce.wayne@we.com', 'Bruce', 'Wayne', 'G0th4amCity!')

Administrators.modify(current_username, new_username=None, email=None, first_name=None, last_name=None, password=None, role=None, company=None, comment=None)

Modify a Global Administrator user account

Parameters:

current_username (str) – The current GlobalAdmin username
new_username (str,optional) – New name
email (str,optional) – E-mail address
first_name (str,optional) – First name
last_name (str,optional) – Last name
password (str,optional) – Password
role (cterasdk.core.enum.Role,optional) – User role
company (str,optional) – Company name
comment (str,optional) – Comment

"""Modify a global admin"""
admin.admins.modify('bruce', 'bwayne@we.com', 'Bruce', 'Wayne', 'Str0ngP@ssword!', 'Wayne Enterprises')

Administrators.delete(name)

Delete a Global Administrator

Parameters:: username (str) – Global administrator username

"""Delete a global admin"""
admin.admins.delete('alice')

User Roles#

static Roles.types(): Get a list of roles

print(admin.roles.types)

Roles.get(role)

Get Role

Parameters:: role (str) – Role
Returns:: Role settings
Return type:: cterasdk.core.types.RoleSettings

rw_admin_settings = admin.roles.get(core_enum.Role.ReadWriteAdmin)
ro_admin_settings = admin.roles.get(core_enum.Role.ReadOnlyAdmin)
support_admin_settings = admin.roles.get(core_enum.Role.Support)

Roles.modify(role, settings)

Modify Role

Parameters:

role (cterasdk.core.enum.Role) – Role
settings (cterasdk.core.types.RoleSettings) – Role Settings

Returns:

Updated role settings

Return type:

cterasdk.core.types.RoleSettings

support_admin_settings = admin.roles.get(core_enum.Role.Support)
support_admin_settings.manage_logs = True
admin.roles.modify(core_enum.Role.Support, support_admin_settings)

Users#

Users.delete(user)

Delete a user

Parameters:: user (cterasdk.core.types.UserAccount) – the user account

"""Delete a local user"""

alice = core_types.UserAccount('alice')
admin.users.delete(alice)

"""Delete a domain user"""

bruce = core_types.UserAccount('bruce', 'domain.ctera.local')
admin.users.delete(bruce)

Local Users#

Users.list_local_users(include=None)

List all local users

Parameters:: include (list[str]) – List of fields to retrieve, defaults to [‘name’]
Returns:: Iterator for all local users
Return type:: cterasdk.lib.iterator.Iterator

users = admin.users.list_local_users()

for user in users:

    print(user.name)

users = admin.users.list_local_users(include = ['name', 'email', 'firstName', 'lastName'])

for user in users:

    print(user)

Users.add(name, email, first_name, last_name, password, role, company=None, comment=None, password_change=False)

Create a local user account

Parameters:

name (str) – User name for the new user
email (str) – E-mail address of the new user
first_name (str) – The first name of the new user
last_name (str) – The last name of the new user
password (str) – Password for the new user
role (cterasdk.core.enum.Role) – User role of the new user
company (str,optional) – The name of the company of the new user, defaults to None
comment (str,optional) – Additional comment for the new user, defaults to None
password_change (variable,optional) – Require the user to change the password on the first login. Pass datetime.date for a specific date, integer for days from creation, or True for immediate , defaults to False

"""Create a local user"""
admin.users.add('bruce', 'bruce.wayne@we.com', 'Bruce', 'Wayne', 'G0th4amCity!')

Users.modify(current_username, new_username=None, email=None, first_name=None, last_name=None, password=None, role=None, company=None, comment=None)

Modify a local user account

Parameters:

current_username (str) – The current user name
new_username (str,optional) – New name
email (str,optional) – E-mail address
first_name (str,optional) – First name
last_name (str,optional) – Last name
password (str,optional) – Password
role (cterasdk.core.enum.Role,optional) – User role
company (str,optional) – Company name
comment (str,optional) – Comment

"""Modify a local user"""
admin.users.modify('bruce', 'bwayne@we.com', 'Bruce', 'Wayne', 'Str0ngP@ssword!', 'Wayne Enterprises')

Domain Users#

Users.list_domain_users(domain, include=None)

List all the users in the domain

Parameters:

domain (str) – Domain name
include (list[str]) – List of fields to retrieve, defaults to [‘name’]

Returns:

Iterator for all the domain users

Return type:

cterasdk.lib.iterator.Iterator

users = admin.users.list_domain_users('domain.ctera.local') # will only retrieve the 'name' attribute
for user in users:
    print(user.name)

"""Retrieve additional user attributes"""
users = admin.users.list_domain_users('domain.ctera.local', include = ['name', 'email', 'firstName', 'lastName'])
print(user)

Fetch Users & Groups#

DirectoryService.fetch(active_directory_accounts)

Instruct the Portal to fetch the provided Active Directory Accounts

Parameters:: active_directory_accounts (list[cterasdk.core.types.PortalAccount]) – List of Active Directory Accounts to fetch
Returns:: Response Code

"""Fetch domain users"""

alice = core_types.UserAccount('alice', 'domain.ctera.local')
bruce = core_types.UserAccount('bruce', 'domain.ctera.local')

admin.directoryservice.fetch([alice, bruce])

Directory Services#

DirectoryService.connect(domain, username, password, directory='ActiveDirectory', domain_controllers=None, ou=None, ssl=False, krb=False, mapping=None, acl=None, default='Disabled', fetch='Lazy')

Connect a Portal tenant to directory services

Parameters:

domain (str) – The directory services domain to connect to
username (str) – The user name to use when connecting to the active directory services
password (str) – The password to use when connecting to the active directory services
ou (str,optional) – The OU path to use when connecting to the active directory services, defaults to None
directory (cterasdk.core.enum.DirectoryServiceType,optional) – The directory service type, deafults to ‘ActiveDirectory’
domain_controllers (cterasdk.core.types.DomainControllers,optional) – Connect to a primary and a secondary domain controllers, defaults to None
ssl (bool,optional) – Connect using SSL, defaults to False
krb (bool,optional) – Connect using Kerberos, defaults to False
list[cterasdk.common.types.ADDomainIDMapping],optional – The directory services UID/GID mapping
acl (list[cterasdk.core.types.AccessControlEntry],optional) – List of access control entries and their associated roles
default (cterasdk.core.enum.Role) – Default role if no match applies, defaults to None
fetch (str,optional) – Configure identity fetching mode, defaults to ‘Lazy’

"""Connect to Active Directory using a primary domain controller, configure domain UID/GID mapping and access control"""
mapping = [common_types.ADDomainIDMapping('demo.local', 200001, 5000000), common_types.ADDomainIDMapping('trusted.local', 5000001, 10000000)]
rw_admin_group = core_types.AccessControlEntry(
    core_types.GroupAccount('ctera_admins', 'demo.local'),
    core_enum.Role.ReadWriteAdmin
)
ro_admin_user = core_types.AccessControlEntry(
    core_types.UserAccount('jsmith', 'demo.local'),
    core_enum.Role.ReadOnlyAdmin
)
admin.directoryservice.connect('demo.local', 'svc_account', 'P@ssw0rd1', mapping=mapping, domain_controllers=core_types.DomainControllers('172.54.3.52'), acl=[rw_admin, ro_admin])

DirectoryService.domains()

Get domains

Return list(str):: List of names of all discovered domains

print(admin.directoryservice.domains())

DirectoryService.get_connected_domain()

Get the connected domain information. Returns None if the Portal tenant is not connected to a domain

Return str:: The connected domain

print(admin.directoryservice.get_connected_domain())

DirectoryService.get_advanced_mapping()

Retrieve directory services advanced mapping configuration

Returns:: A dictionary of domain mapping objects
Return type:: dict

for domain, mapping in admin.directoryservice.get_advanced_mapping().items():
    print(domain, mapping)

DirectoryService.set_advanced_mapping(mapping)

Configure advanced mapping

Parameters:: mapping (list[cterasdk.common.types.ADDomainIDMapping]) – List of domains and their UID/GID mapping range

"""Configure UID/GID mapping"""
mapping = [common_types.ADDomainIDMapping('demo.local', 200001, 5000000), common_types.ADDomainIDMapping('trusted.local', 5000001, 10000000)]
admin.directoryservice.set_advanced_mapping(mapping)

DirectoryService.get_access_control()

Retrieve directory services access control list

Returns:: List of access control entries
Return type:: list[cterasdk.core.types.AccessControlEntry]

for ace in admin.directoryservice.get_access_control():
    print(ace.account, ace.role)

DirectoryService.set_access_control(acl=None, default=None)

Configure directory services access control

Parameters:

acl (list[cterasdk.core.types.AccessControlEntry],optional) – List of access control entries and their associated roles
default (cterasdk.core.enum.Role) – Default role if no match applies, defaults to None

"""Configure access control for a domain group and a domain user. Set the default role to 'Disabled'"""
rw_admin_group = core_types.AccessControlEntry(
    core_types.GroupAccount('ctera_admins', 'demo.local'),
    core_enum.Role.ReadWriteAdmin
)
ro_admin_user = core_types.AccessControlEntry(
    core_types.UserAccount('jsmith', 'demo.local'),
    core_enum.Role.ReadOnlyAdmin
)
admin.directoryservice.set_access_control([rw_admin_group, ro_admin_user], core_enum.Role.Disabled)

DirectoryService.get_default_role()#: Retrieve the default role assigned when no access control entry match was found

print(admin.directoryservice.get_default_role())

DirectoryService.disconnect(): Disconnect a Portal tenant from directory services

admin.directoryservice.disconnect()

Managing S3 Credentials#

S3.all(user_account=None)

List Credentials

Parameters:: user_account (cterasdk.core.types.UserAccount,optional) – User account

"""List all of 'jsmith@demo.local' S3 credentials"""
jsmith = core_types.UserAccount('jsmith', 'demo.local')
for credential in user.credentials.s3.all(jsmith):
    print(credential.accessKey, credential.activated)

S3.create(user_account=None)

Create Credential

Parameters:: user_account (cterasdk.core.types.UserAccount,optional) – User account

"""Create an S3 credential for a service account"""
service_account = core_types.UserAccount('service_account')
credential = user.credentials.s3.create(service_account)

S3.delete(access_key_id, user_account=None)

Delete Credential

Parameters:

access_key_id (str) – Access Key ID
user_account (cterasdk.core.types.UserAccount,optional) – User account

"""Delete an S3 credentials associated with a user account"""
user_account = core_types.UserAccount('jsmith', 'demo.local')
access_key_id = 'ABCDEFGHIJKLMOP'
user.credentials.s3.delete(access_key_id, user_account)

Managing Groups#

Groups.delete(group_account)

Delete a group

Parameters:: group_account (cterasdk.core.types.GroupAccount) – Group account

"""Delete a local group"""
group = core_types.GroupAccount('local_group')
admin.groups.delete(group)

"""Delete a domain group"""

group = core_types.GroupAccount('domain_group', 'domain.ctera.local')
admin.groups.delete(group)

Local Groups#

Groups.list_local_groups(include=None)

List all local groups

Parameters:: include (list[str]) – List of fields to retrieve, defaults to [‘name’]
Returns:: Iterator for all local groups
Return type:: cterasdk.lib.iterator.Iterator

groups = admin.groups.list_local_groups()
for group in groups:
    print(group.name)

groups = admin.groups.list_local_groups(include=['name', 'description'])
for group in groups:
    print(group)

Groups.add(name, description=None, members=None)

Create a local group

Parameters:

name (str) – Group name
description (str,optional) – Group description
members (list(cterasdk.core.types.UserAccount),optional) – List of user group members

"""Create a local group"""
admin.groups.add('Users')
admin.groups.add('Users', 'A group of users')  # with description
admin.groups.add('Users', members=[core_types.UserAccount('alice'), core_types.UserAccount('bruce', 'domain.ctera.local')])  # with members

Groups.modify(current_groupname, new_groupname=None, description=None)

Modify a local group

Parameters:

current_groupname (str) – The current group name
new_groupname (str,optional) – New group name
description (str,optional) – Group description

"""Modify a local group"""
admin.groups.modify('Users', new_groupname='End Users')  # change group name
admin.groups.modify('Users', description='A group of end users')  # change group description

Groups.get_members(group_account)

Get group members

Parameters:: group_account (cterasdk.core.types.GroupAccount) – Group account

"""Get group members"""
admin.groups.get_members(core_types.GroupAccount('Users'))  # get members of a local group
admin.groups.get_members(core_types.GroupAccount('Users', 'domain.ctera.local'))  # get members of a domain group

Groups.add_members(group_account, members)

Add group members

Parameters:

group_account (cterasdk.core.types.GroupAccount) – Group account
members (list(cterasdk.core.types.UserAccount)) – Users

"""Add group members"""
admin.groups.add_members(core_types.GroupAccount('Users'), [core_types.UserAccount('alice')])  # add local users to a local group
admin.groups.add_members(core_types.GroupAccount('Users'), [core_types.UserAccount('bruce', 'domain.ctera.local')])  # add domain users to a local group

Devices#

Devices.device(device_name, tenant=None, include=None)

Get a Device by its name

Parameters:

device_name (str) – Name of the device to retrieve
tenant (str,optional) – Tenant of the device, defaults to the tenant in the current session
include (list[str],optional) – List of fields to retrieve, defaults to [‘name’, ‘portal’, ‘deviceType’]

Returns:

Managed Device

Return type:

cterasdk.objects.synchronous.Edge or cterasdk.objects.synchronous.Drive

Devices.filers(include=None, allPortals=False, deviceTypes=None)

Get Filers

Parameters:

include (list[str],optional) – List of fields to retrieve, defaults to [‘name’, ‘portal’, ‘deviceType’]
allPortals (bool,optional) – Search in all portals, defaults to False
deviceTypes (list[cterasdk.core.enum.DeviceType.Gateways]) – Types of Filers, defaults to all Filer types

Returns:

Iterator for all matching Filers

Return type:

cterasdk.lib.iterator.Iterator[cterasdk.object.Gateway.Gateway]

"""Retrieve all Gateways from the current tenant"""

filers = admin.devices.filers()
for filer in filers:
    print(filer.name) # will print the Gateway name

"""Retrieve additional Gateway attributes"""
filers = admin.devices.filers(['owner', 'deviceConnectionStatus'])

"""Retrieve nested attributes using the '.' delimiter"""
filers = admin.devices.filers(['deviceReportedStatus.status.device.runningFirmware'])

"""Retrieve filers from all portals"""
admin.portals.browse_global_admin()

filers = admin.devices.filers(allPortals = True)
"""Retrieve C200's and C400's from all portals"""
admin.portals.browse_global_admin()
filers = admin.devices.filers(allPortals = True, deviceTypes = ['C200', 'C400'])

Devices.agents(include=None, allPortals=False)

Get Agents

Parameters:

include (list[str],optional) – List of fields to retrieve, defaults to [‘name’, ‘portal’, ‘deviceType’]
allPortals (bool,optional) – Search in all portals, defaults to False

Returns:

Iterator for all matching Agents

Return type:

cterasdk.lib.iterator.Iterator[cterasdk.object.Agent.Agent]

"""Retrieve all Agents from the current tenant"""
agents = admin.devices.agents()
for agent in agents:
    print(agent.name) # will print the Agent name

"""Retrieve all Agents and the underlying OS name"""
agents = admin.devices.agents(['deviceReportedStatus.status.agent.details.osName'])

Devices.servers(include=None, allPortals=False)

Get Servers

Parameters:

include (list[str],optional) – List of fields to retrieve, defaults to [‘name’, ‘portal’, ‘deviceType’]
allPortals (bool,optional) – Search in all portals, defaults to False

Returns:

Iterator for all matching Servers

Return type:

cterasdk.lib.iterator.Iterator

server_agents = admin.devices.servers()

Devices.desktops(include=None, allPortals=False)

Get Desktops

Parameters:

include (list[str],optional) – List of fields to retrieve, defaults to [‘name’, ‘portal’, ‘deviceType’]
allPortals (bool,optional) – Search in all portals, defaults to False

Returns:

Iterator for all matching Desktops

Return type:

cterasdk.lib.iterator.Iterator

desktop_agents = admin.devices.desktop_agents()

Devices.by_name(names, include=None)

Get Devices by their names

Parameters:

names (list[str],optional) – List of names of devices
include (list[str],optional) – List of fields to retrieve, defaults to [‘name’, ‘portal’, ‘deviceType’]

Returns:

Iterator for all matching Devices

Return type:

cterasdk.lib.iterator.Iterator

Devices.get_comment(device_name, tenant=None)

Get Portal device comment

Parameters:: device (str) – Device name
Returns:: Comment
Return type:: str

print(admin.devices.get_comment('FSRV'))

Devices.set_comment(device_name, comment, tenant=None)

Set a comment to a Portal device

Parameters:

device (str) – Device name
comment (str) – Comment

admin.devices.set_comment('FSRV', 'Production')

Remote Access#

The Devices APIs retrieve a handle that can be used to query and update the configuration of remote Edge Filers or Drive Agents.

"""Retrieving a List of Shares from an Edge Filer"""
edge = admin.devices.device('edge-hostname')
shares = edge.shares.get()
for share in shares:
    print(share.name)

The handle retrieved from the Portal provides limited access to the Edge Filer or Drive Agent APIs. To obtain access to the full set of APIs, use the remote_access function.

Edge.remote_access()

"""Retrieving a List of Shares from an Edge Filer"""

edge = admin.devices.device('edge-hostname')
remote_session = edge.remote_access()  # Returns an authenticated remote access session

"""Downloading a File via a Remote Access Edge Filer Session"""
remote_session.files.download('cloud/users/Service Account/My Files/docs/document.docx')

Device Activation Codes#

Activation.generate_code(username=None, tenant=None)

Generate device activation code

Parameters:

username (str,optional) – User name used for activation, defaults to None
tenant (str,optional) – Tenant name used for activation, defaults to None

Returns:

Portal Activation Code

Return type:

str

"""Generate a device activation code"""
code = admin.activation.generate_code() # will generate a code for the current, logged on, user
code = admin.activation.generate_code('bruce') # will generate a code for 'bruce' in the current tenant
code = admin.activation.generate_code('batman', 'gotham') # will generate a code for 'bruce' in the 'gotham' tenant

Note

Read Write Administrator, granted with the “Super User” role permission, can generate 200 codes every 5 minutes

Reports#

Generate a Report#

Reports.generate(name)

Generate a CTERA Portal Report

Parameters:: report (cterasdk.core.enum.reports) – Report

Reports may take a while to generate, use the following commands to trigger the execution of the reports.

"""Global Administration"""
admin.reports.generate(core_enum.Reports.Storage)
admin.reports.generate(core_enum.Reports.Portals)

"""Team Portal"""
admin.reports.generate(core_enum.Reports.Folders)
admin.reports.generate(core_enum.Reports.FolderGroups)

Retrieve a Report#

Once a report was generated, use the following commands to retrieve the report.

Reports.storage()

Retrieve the portals statistics report.

To retrieve this report, you must first browse the Global Administration Portal, using: GlobalAdmin.portals.browse_global_admin()

Reports.portals()

Retrieve the storage statistics report.

To retrieve this report, you must first browse the Global Administration Portal, using: GlobalAdmin.portals.browse_global_admin()

Reports.folders()

Retrieve the cloud folders statistics report.

To retrieve this report, you must first browse the Virtual Portal that contains the report, using: GlobalAdmin.portals.browse()

Reports.folder_groups()

Retrieve the folder groups statistics report.

To retrieve this report, you must first browse the Virtual Portal that contains the report, using: GlobalAdmin.portals.browse()

Managing the CTERA Global Namespace#

Folder Groups#

FolderGroups.all(include=None, user=None)

List folder groups

Parameters:

include (str,optional) – List of fields to retrieve, defaults to [‘name’, ‘owner’]
user (cterasdk.core.types.UserAccount) – User account of the folder group owner

Returns:

Iterator for all folder groups

"""List all folder groups"""
folder_groups = admin.cloudfs.groups.all()
for folder_group in folder_groups:
    print(folder_group.name, folder_group.owner)

"""List folder groups owned by a domain user"""
bruce = core_types.UserAccount('bruce', 'domain.ctera.local')
folder_groups = admin.cloudfs.groups.all(user=bruce)

FolderGroups.add(name, user=None, deduplication_method_type=None, storage_class=None)

Create a Folder Group

Parameters:

name (str) – Name of the new folder group
user (cterasdk.core.types.UserAccount) – User account, the user directory and name of the new folder group owner (default to None)
deduplication_method_type (cterasdk.core.enum.DeduplicationMethodType) – Deduplication-Method
storage_class (str,optional) – Storage class, defaults to the Default storage class

"""Create a Folder Group, owned by a local user account 'svc_account'"""
svc_account = core_types.UserAccount('svc_account')
admin.cloudfs.groups.add('FG-001', svc_account)

"""Create a Folder Group, owned by the domain user 'ctera.local\wbruce'"""
wbruce = core_types.UserAccount('wbruce', 'ctera.local')
admin.cloudfs.groups.add('FG-002', wbruce)

admin.cloudfs.groups.add('FG-003') # without an owner

"""Create a Folder Group, assigned to an 'Archive' storage class"""
admin.cloudfs.groups.add('Archive', core_types.UserAccount('svc_account'), storage_class='Archive')

FolderGroups.modify(current_name, new_name)

Modify a folder group

Parameters:

current_name (str) – Current folder group name
new_name (str) – New folder group name

"""Rename a Folder Group"
admin.cloudfs.groups.modify('FG-001', 'FG-002')

FolderGroups.delete(name)

Remove a Folder Group

Parameters:: name (str) – Name of the folder group to remove

admin.cloudfs.groups.delete('FG-001')

Backup Folders#

Backups.all(include=None, list_filter='NonDeleted', user=None)

List Backup folders.

Parameters:

include (str,optional) – List of fields to retrieve, defaults to [‘name’, ‘group’, ‘owner’]
list_filter (cterasdk.core.enum.ListFilter) – Filter the list of Backup folders, defaults to non-deleted folders
user (cterasdk.core.types.UserAccount) – Filter by backup folder owner

Returns:

Iterator for all Backup folders

"""List all backup folder"""
for backup_folder in admin.cloudfs.backups.all():
   print(backup_folder)

Backups.add(name, group, owner, xattr=True)

Create a new Backup Folder

Parameters:

name (str) – Name of the backup folder
group (str) – Folder Group to assign this folder to
owner (cterasdk.core.types.UserAccount) – User account, the owner of the backup folder
xattr (bool,optional) – Backup extended attributes, defaults to True

"""Create a backup folder"""
folder_group = 'backup-fg'
owner = core_types.UserAccount('bwayne', 'domain.ctera.local')
admin.cloudfs.backups.add('my-backup', folder_group, owner)

Backups.modify(current_name, new_name=None, new_owner=None, new_group=None, xattr=None)

Modify a Backup Folder

Parameters:

current_name (str) – Current folder name
owner (cterasdk.core.types.UserAccount) – User account, the owner of the folder
new_name (str,optional) – New folder name
new_owner (cterasdk.core.types.UserAccount,optional) – User account, the new owner of the folder
new_group (str,optional) – Folder Group to assign this folder to
xattr (bool,optional) – Backup extended attributes

"""Change backup folder owner"""
bwayne = core_types.UserAccount('bwayne', 'domain.ctera.local')
admin.cloudfs.backups.modify('my-backup', new_owner=bwayne)

Backups.delete(name)

Delete a Backup Folder

Parameters:: name (str) – Name of the Backup Folder to delete

"""Delete a backup folder"""
admin.cloudfs.backups.modify('my-backup')

Cloud Drive Folders#

CloudDrives.all(include=None, list_filter='NonDeleted', user=None)

List Cloud Drive folders.

Parameters:

include (str,optional) – List of fields to retrieve, defaults to [‘name’, ‘group’, ‘owner’]
list_filter (cterasdk.core.enum.ListFilter) – Filter the list of Cloud Drive folders, defaults to non-deleted folders
user (cterasdk.core.types.UserAccount) – User account of the cloud folder owner

Returns:

Iterator for all Cloud Drive folders

"""List all cloud drive folders"""
cloud_drive_folders = admin.cloudfs.drives.all()
for cloud_drive_folder in cloud_drive_folders:
    print(cloud_drive_folder)

"""List cloud drive folders owned by a domain user"""
bruce = core_types.UserAccount('bruce', 'domain.ctera.local')
cloud_drive_folders = admin.cloudfs.drives.all(user=bruce)

"""List both deleted and non-deleted cloud drive folders"""
cloud_drive_folders = admin.cloudfs.drives.all(list_filter=core_enum.ListFilter.All)

"""List deleted cloud drive folders"""
cloud_drive_folders = admin.cloudfs.drives.all(list_filter=core_enum.ListFilter.Deleted)

CloudDrives.add(name, group, owner, winacls=True, description=None, quota=None, compliance_settings=None, xattrs=None)

Create a new Cloud Drive Folder (Cloud Volume)

Parameters:

name (str) – Name of the new folder
group (str) – Folder Group to assign this folder to
owner (cterasdk.core.types.UserAccount) – User account, the owner of the new folder
winacls (bool,optional) – Use Windows ACLs, defaults to True
description (str,optional) – Cloud drive folder description
quota (str,optional) – Cloud drive folder quota in GB
compliance_settings (cterasdk.common.object.Object,optional) – Compliance settings, defaults to disabled. Use cterasdk.core.types.ComplianceSettingsBuilder() to build the compliance settings object
xattrs (cterasdk.common.object.Object,optional) – Extended attributes, defaults to MacOS. Use cterasdk.core.types.ExtendedAttributesBuilder() to build the extended attributes object

"""Create a Cloud Drive folder, owned by a local user account 'svc_account'"""
svc_account = core_types.UserAccount('svc_account')
admin.cloudfs.drives.add('DIR-001', 'FG-001', svc_account)
admin.cloudfs.drives.add('DIR-002', 'FG-002', svc_account, winacls=False,
                         xattrs=core_types.ExtendedAttributesBuilder.disabled().build()) # Disable xattrs and Windows ACL's
admin.cloudfs.drives.add('DIR-003', 'FG-003', svc_account, winacls=True,
                         xattrs=core_types.ExtendedAttributesBuilder.disabled().build()) # Disable xattrs, Enable Windows ACL's
admin.cloudfs.drives.add('DIR-004', 'FG-004', svc_account, quota=1024) # Set folder quota, in GB

"""Create a Cloud Drive folder, owned by the domain user 'ctera.local\wbruce'"""
wbruce = core_types.UserAccount('wbruce', 'ctera.local')
admin.cloudfs.drives.add('DIR-002', 'FG-002', wbruce)

"""Create immutable Cloud Drive folders"""

svc_account = core_types.UserAccount('svc_account')

"""
Mode: Enterprise (i.e., allow privileged delete by the CTERA Compliance Officer role)
Retention Period: 7 Years.
Grace Period: 30 Minutes.
"""
admin.cloudfs.groups.add('FG-Enterprise', svc_account)
settings = core_types.ComplianceSettingsBuilder.enterprise(7, core_enum.Duration.Years).grace_period(30, core_enum.Duration.Minutes).build()
admin.cloudfs.drives.add('Enterprise', 'FG-Enterprise', svc_account, compliance_settings=settings)

"""
Mode: Compliance (data cannot be deleted after grace period expires)
Retention Period: 1 Years.
Grace Period: 1 Hour.
"""
admin.cloudfs.groups.add('FG-Compliance', svc_account)
settings = core_types.ComplianceSettingsBuilder.enterprise(1, core_enum.Duration.Years).grace_period(1, core_enum.Duration.Hours).build()
admin.cloudfs.drives.add('Compliance', 'FG-Compliance', svc_account, compliance_settings=settings)

CloudDrives.modify(current_name, owner, new_name=None, new_owner=None, new_group=None, description=None, winacls=None, quota=None, compliance_settings=None, xattrs=None)

Modify a Cloud Drive Folder (Cloud Volume)

Parameters:

current_name (str) – Current folder name
owner (cterasdk.core.types.UserAccount) – User account, the owner of the folder
new_name (str,optional) – New folder name
new_owner (cterasdk.core.types.UserAccount,optional) – User account, the new owner of the folder
new_group (str,optional) – Folder Group to assign this folder to
description (str,optional) – Folder description
winacls (bool,optional) – Enable or disable Windows ACLs
quota (str,optional) – Folder quota in GB
compliance_settings (cterasdk.common.object.Object,optional) – Compliance settings. Use cterasdk.core.types.ComplianceSettingsBuilder() to build the compliance settings object
xattrs (cterasdk.common.object.Object,optional) – Extended attributes. Use cterasdk.core.types.ExtendedAttributesBuilder() to build the extended attributes object

"""Update Quota of a Cloud Drive Folder"""
svc_account = core_types.UserAccount('svc_account')
admin.cloudfs.drives.modify('DIR-001', svc_account, quota=5120) # Set folder quota to 5 TB

CloudDrives.delete(name, owner, *, permanently=False)

Delete a Cloud Drive Folder

Parameters:

name (str) – Name of the Cloud Drive Folder to delete
owner (cterasdk.core.types.UserAccount) – User account, the owner of the Cloud Drive Folder to delete
permanently (bool,optional) – Delete permanently

"""Delete a Cloud Drive folder, owned by the local user account 'svc_account'"""
svc_account = core_types.UserAccount('svc_account')
admin.cloudfs.drives.delete('DIR-001', svc_account)

"""Delete a Cloud Drive folder permanently"""
admin.cloudfs.drives.delete('DIR-001', svc_account, permanently=True)

"""Delete a Cloud Drive folder, owned by the domain user 'ctera.local\wbruce'"""
wbruce = core_types.UserAccount('wbruce', 'ctera.local')
admin.cloudfs.drives.delete('DIR-002', wbruce)

Zones#

To manage zones, you must be a Read Write Administrator

Zones.get(name)

Get zone by name

Parameters:: name (str) – The name of the zone to get
Returns:: The requested zone

zone = admin.cloudfs.zones.get('ZN-001')

Zones.all(filters=None)

List Zones :param list[],optional filters: List of additional filters, defaults to None

Returns:: Iterator for all Zones
Return type:: cterasdk.lib.iterator.Iterator

for zone in admin.cloudfs.zones.all():
    print(zone)

Zones.search(name)

Search for Zones by name :param str name: Search query

Returns:: Iterator for all matching Zones
Return type:: cterasdk.lib.iterator.Iterator

for zone in admin.cloudfs.zones.search('ZN'):
    print(zone)

Zones.add(name, policy_type='selectedFolders', description=None)

Add a new zone

Parameters:

name (str) – The name of the new zone
policy_type (cterasdk.core.enum.PolicyType,optional) – Policy type of the new zone, defaults to cterasdk.core.enum.PolicyType.SELECT
description (str,optional) – The description of the new zone

"""
Policy Types:
- All: Include all cloud folders
- Select: Select one or more cloud folders to include
- None: Create an empty zone
"""

"""Create a zone with a description"""

admin.cloudfs.zones.add('ZN-NYS-001', description = 'The New York State Zone')

"""Create a zone and include all folders"""

admin.cloudfs.zones.add('ZN-NYS-002', 'All', 'All Folders')

"""Create an empty zone"""

admin.cloudfs.zones.add('ZN-NYS-003', 'None', 'Empty Zone')

Zones.add_folders(name, folder_finding_helpers)

Add the folders to the zone

Parameters:

name (str) – The name of the zone
folder_finding_helpers (list[cterasdk.core.types.CloudFSFolderFindingHelper]) – List of folder names and owners

"""
Add the following cloud folders to zone: 'ZN-001'

1) 'Accounting' folder owned by 'Bruce'
2) 'HR' folder owned by 'Diana'
"""

accounting = core_types.CloudFSFolderFindingHelper('Accounting', 'Bruce')
hr = core_types.CloudFSFolderFindingHelper('HR', 'Diana')

admin.cloudfs.zones.add_folders('ZN-001', [accounting, hr])

Zones.add_devices(name, device_names)

Add devices to a zone

Parameters:

name (str) – The name of the zone to add devices to
device_names (list[str]) – The names of the devices to add to the zone

admin.cloudfs.zones.add_devices('ZN-001', ['vGateway-01ba', 'vGateway-bd02'])

Zones.delete(name)

Delete a zone

Parameters:: name (str) – The name of the zone to delete

admin.cloudfs.zones.delete('ZN-001')

Timezone#

GlobalSettings.get_timezone(): Get timezone

admin.settings.global_settings.get_timezone()

GlobalSettings.set_timezone(timezone)

Set timezone

Parameters:: timezone (str) – Timezone

admin.settings.global_settings.set_timzeone('(GMT-05:00) Eastern Time (US , Canada)')

Virtual Portal Settings#

PortalSettings.get()

admin.settings.portal.get()

PortalSettings.use_global_settings()

PortalSettings.update(settings=None)

Update Portal Settings

Parameters:: settings (cterasdk.common.object.Objcet) – Settings, defaults to using the global settings.

settings = admin.settings.portal.get()
settings.defaultMail = 'support@acme.com'  # assign default email to domain users without an email address
admin.settings.portal.update(settings)  # apply settings changes

Mail Server#

Mail.is_enabled(): Check if forwarding log messages over syslog is enabled

admin.mail.is_enabled()

Mail.enable(host=None, port=None, sender=None, username=None, password=None, use_tls=None)

Enable Mail Server Notifications

Parameters:

host (str,optional) – SMTP host
port (str,optional) – SMTP port
sender (str,optional) – Sender e-mail address
username (str,optional) – The user name of the SMTP Server, defaults to None
password (str,optional) – The password of the SMTP Server, defaults to None
use_tls (bool,optional) – Use TLS when connecting to the SMTP Server, defaults to None

admin.mail.enable('mail.smtp.org', 587, 'support@acme.com', username='user', password='password', use_tls=True)

Mail.modify(host=None, port=None, sender=None, username=None, password=None, use_tls=None)

Modify Mail Server Configuration

Parameters:

host (str,optional) – SMTP host
port (str,optional) – SMTP port
sender (str,optional) – Sender e-mail address
username (str,optional) – The user name of the SMTP Server, defaults to None
password (str,optional) – The password of the SMTP Server, defaults to None
use_tls (bool,optional) – Use TLS when connecting to the SMTP Server, defaults to None

admin.mail.modify('mail.smtp.org', 587, 'support@acme.com', username='user', password='password', use_tls=True)
admin.mail.modify(sender='support@acme.com')  # only update sender
admin.mail.modify(use_tls=True)  # enable TLS

Mail.disable(): Disable Mail Server Notifications

admin.mail.disable()

TLS Certificate#

SSL.get()

Retrieve details of the current installed SSL certificate

Return cterasdk.common.object.Object:: An object including the SSL certificate details

certificate = admin.ssl.get()
print(certificate)

SSL.thumbprint(): Get the SHA1 thumbprint of the Portal SSL certificate

print(admin.ssl.thumbprint)

SSL.export(destination=None)

Export the Portal SSL Certificate to a ZIP archive

Parameters:: destination (str,optional) – File destination, defaults to the default directory

admin.ssl.export()

admin.ssl.export(r'C:\Temp')  # export to an alternate location

SSL.import_from_zip(zipfile)

Import an SSL Certificate to CTERA Portal from a ZIP archive

Parameters:: zipfile (str) – A zip archive including the private key and SSL certificate chain

admin.ssl.import_from_zip(r'C:\Users\jsmith\Downloads\certificate.zip')

SSL.import_from_chain(private_key, *certificates)

Import an SSL Certificate to CTERA Portal from a chain

Parameters:

private_key (str) – The PEM-encoded private key, or a path to the PEM-encoded private key file
certificates (list[str]) – The PEM-encoded certificates, or a list of paths of the PEM-encoded certificate files

admin.ssl.import_from_chain(
    r'C:\Users\jsmith\Downloads\private.key',
    r'C:\Users\jsmith\Downloads\domain.crt',
    r'C:\Users\jsmith\Downloads\intermediate.crt',
    r'C:\Users\jsmith\Downloads\root.crt'
)

Logging#

Logs.get(topic='system', min_severity='info', origin_type='Portal', origin=None, before=None, after=None, filters=None)

Get logs from the Portal

Parameters:

topic (cterasdk.core.enum.LogTopic,optional) – Log topic to get, defaults to cterasdk.core.enum.LogTopic.System
min_severity (cterasdk.core.enum.Severity,optional) – Minimun severity of logs to get, defaults to cterasdk.core.enum.Severity.INFO
origin_type (cterasdk.core.enum.OriginType,optional) – Origin type of the logs to get, defaults to cterasdk.core.enum.OriginType.Portal
origin (str,optional) – Log origin (e.g. device name, Portal server name), defaults to None
before (str,optional) – Get logs before this date (in format “%m/%d/%Y %H:%M:%S”), defaults to None
after (str,optional) – Get logs after this date (in format “%m/%d/%Y %H:%M:%S”), defaults to None
filters (list[cterasdk.core.query.FilterBuilder],optional) – List of additional filters, defaults to None

Returns:

Iterator for all matching logs

Return type:

cterasdk.lib.iterator.Iterator[cterasdk.object.Object]

Logs.device(name, topic='system', min_severity='info', before=None, after=None, filters=None)

Get device logs from the Portal

Parameters:

name (str) – Name of a device
topic (cterasdk.core.enum.LogTopic,optional) – Log topic to get, defaults to cterasdk.core.enum.LogTopic.System
min_severity (cterasdk.core.enum.Severity,optional) – Minimun severity of logs to get, defaults to cterasdk.core.enum.Severity.INFO
before (str,optional) – Get logs before this date (in format “%m/%d/%Y %H:%M:%S”), defaults to None
after (str,optional) – Get logs after this date (in format “%m/%d/%Y %H:%M:%S”), defaults to None
filters (list[cterasdk.core.query.FilterBuilder],optional) – List of additional filters, defaults to None

Returns:

Iterator for all matching logs

Return type:

cterasdk.lib.iterator.Iterator[cterasdk.object.Object]

"""Retrieve all cloud backup logs for device 'WIN-SRV2019'"""
admin.logs.device('WIN-SRV2019', topic='backup')

Log Based Alerts#

Alerts.get()

Get a List of Log Based Alerts

Returns:: A list of alerts
Return type:: list[cterasdk.common.object.Object]

"""Get a list of log based alerts"""
for alert in admin.logs.alerts.get():
   print(alert)

Alerts.add(name, description=None, topic=None, log=None, min_severity=None, origin_type=None, content=None)

Add a Log Based Alert

Parameters:

name (str) – Alert name
description (str,optional) – Alert description
topic (cterasdk.core.enum.LogTopic,optional) – Log topic to get, defaults to any topic
log (str,optional) – Class name of the log
min_severity (cterasdk.core.enum.Severity,optional) – Minimun severity for triggering an alert, defaults to any severity
origin_type (cterasdk.core.enum.OriginType,optional) – Origin type of the log, defaults to any origin
content (str) – Content of the log message

Returns:

A list of alerts

Return type:

list[cterasdk.common.object.Object]

"""Alert on a volume full error event"""
admin.logs.alerts.add('Volume Full', topic='system', log='VolumeFull', origin_type='Device', min_severity='error')

Alerts.put(alerts)

Set Log Based Alerts: Use cterasdk.core.types.AlertBuilder() to build log based alerts

Parameters:: alerts (list[cterasdk.core.types.Alert]) – List of alerts

"""Set alerts. Overrides all existing alerts"""
volume_full = core_types.AlertBuilder.name('volume_full').log('VolumeFull').build()
agent_repo = core_types.AlertBuilder.name('agent_repo').log('AgentRepositoryNotReady').build()
admin.logs.alerts.put([volume_full, agent_repo])

Alerts.delete(name)

Remove a Log Based Alert

Parameters:: name (str) – Alert name

"""Delete an alert by name"""
admin.logs.alerts.delete('volume_full')

"""Delete all alerts"""
admin.logs.alerts.put([])

Syslog#

Syslog.is_enabled(): Check if forwarding log messages over syslog is enabled

Syslog.get_configuration(): Retrieve the syslog server configuration

Syslog.enable(server, port=514, protocol='UDP', min_severity='info', ca_cert=None)

Enable Syslog

Parameters:

server (str) – Syslog server address
port (int,optional) – Syslog server port
protocol (cterasdk.core.enum.IPProtocol,optional) – Syslog server IP protocol
min_severity (cterasdk.core.enum.Severity,optional) – Minimum Log Severity
ca_cert (str,optional) – Path to the PEM-encoded CA certificate.

Syslog.disable()

Syslog.import_ca(certificate)

Import the Syslog Server CA certificate

Parameters:: certificate (str) – Path to the PEM-encoded CA certificate.

Syslog.import_client_certificate(private_key, certificate)

Import the Syslog Server CA certificate

Parameters:

private_key (str) – Path to the PEM-encoded private key.
certificate (str) – Path to the PEM-encoded client certificate.

CLI Execution#

CLI.run_command(cli_command)

Run a CLI command

Parameters:: cli_command (str) – The CLI command to run on the gateway
Return str:: The response of the Portal

result = admin.cli.run_command('show /settings')
print(result)

Setup#

Setup.init_master(name, email, first_name, last_name, password, domain)

Initialize the CTERA Portal master server.

Parameters:

name (str) – User name for the new user
email (str) – E-mail address of the new user
first_name (str) – The first name of the new user
last_name (str) – The last name of the new user
password (str) – Password for the new user
domain (str) – The domain suffix for CTERA Portal

admin.setup.init_master('admin', 'bruce.wayne@we.com', 'Bruce', 'Wayne', 'password1!', 'ctera.me')

Setup.init_application_server(ipaddr, secret)

Initialize a CTERA Portal Application Server.

Parameters:

ipaddr (str) – The CTERA Portal master server IP address
secret (str) – A password or a PEM-encoded private key

"""Connect a secondary Portal server using a password"""
master_ipaddr = '172.31.53.246'
master_password = 'secret'
admin.setup.init_application_server(master_ipaddr, master_password)

"""Connect a secondary Portal server using a private key"""
master_ipaddr = '172.31.53.246'
master_pk = """...PEM-encoded private key..."""
admin.setup.init_application_server(master_ipaddr, master_pk)

Miscellaneous#

GlobalAdmin.test()

admin.test()

GlobalAdmin.whoami()

Return the name of the logged in user.

Return cterasdk.common.object.Object:: The session object of the current user

admin.whoami()

Global Administration

Contents

Global Administration#

Logging In#

Browsing Tenants#

Managing Licenses#

Storage Classes#

Managing Storage Nodes#

Managing Portals#

Querying#

Creating a Team Portal#

Subcribing a Portal to a Plan#

Apply Provisioning Changes#

Delete a Team Portal#

Recover a Team Portal#

Subscription Plans#

Plan Auto Assignment Rules#

Configuration Templates#

Template Auto Assignment Rules#

Portal Servers#

Server Tasks#

Messaging Service#

Key Management Service#

Key Management Service Servers#

Antivirus#

Antivirus Servers#

Global Administrators#

User Roles#

Users#

Local Users#

Domain Users#

Fetch Users & Groups#

Directory Services#

Managing S3 Credentials#

Managing Groups#

Local Groups#

Devices#

Remote Access#

Device Activation Codes#

Reports#

Generate a Report#

Retrieve a Report#

Managing the CTERA Global Namespace#

Folder Groups#

Backup Folders#

Cloud Drive Folders#

Zones#

Timezone#

Virtual Portal Settings#

Mail Server#

TLS Certificate#

Logging#

Log Based Alerts#

Syslog#

CLI Execution#

Setup#

Miscellaneous#