Class Documentation¶
Tintri Class¶
-
exception
tintri.common.
TintriAPINotFoundError
(code, message, details)¶ Bases:
tintri.common.TintriServerError
Tintri APi not found error (HTTP status code: 404)
Parameters:
-
exception
tintri.common.
TintriAuthenticationError
(code, message, details)¶ Bases:
tintri.common.TintriServerError
Tintri authentication error (HTTP status code: 403)
Parameters:
-
exception
tintri.common.
TintriAuthorizationError
(code, message, details)¶ Bases:
tintri.common.TintriServerError
Tintri authorization error (HTTP status code: 403)
Parameters:
-
exception
tintri.common.
TintriBadRequestError
(code, message, details)¶ Bases:
tintri.common.TintriServerError
Tintri bad request error (HTTP status code: 400)
Parameters:
-
class
tintri.common.
TintriBase
(host, username=None, password=None, api_version='310', logger_name='tintri', auto_login=True, disable_cert_warning=True, custom_client_header=None, auto_page=True)¶ Bases:
object
A version-independent Tintri base class. This class should not be instantiated; only extended sublcasses should be instantiated.
-
auto_login
¶ Specifies if session should auto-login in the event of session expiry, default value=True
Returns: auto_login Return type: bool
-
auto_page
¶ auto_page flag is used to change the behavior of pagination as desired, default value=True
Server Response auto_page API Return value Pagination List True Page No pagination as there is single page List False List Not applicable Page True Page On item iteration, Automatically fetches next page Page False Page Item iteration stops at current page, user has to manually fetch next or previous page Returns: auto_page Return type: bool
-
change_password
(new_password)¶ Change the Tintri server password
Parameters: new_password (str) – New password for logged in user. Returns: credentials role name Return type: str
-
custom_client_header
¶ Value associated with ‘Tintri-Api-Client’ key in REST API header, default value=Tintri-PythonSDK-<PySdkVersion>
Returns: Custom client header Return type: str
-
download_file
(report_url, file_name)¶ Downloads the file pointed by URL.
Parameters:
-
is_logged_in
()¶ Indicates if the Tintri server is logged into
Returns: True if logged in Return type: bool
-
is_tgc
()¶ Indicates if the Tintri server is a TGC
Returns: True if logged into a TGC Return type: bool
-
is_vmstore
()¶ Indicates if the Tintri server is a VMstore
Returns: True if logged into a VMstore Return type: bool
-
logger
¶ Logger object used for logging
Returns: logger object Return type: Logger
-
login
(username=None, password=None)¶ Login to Tintri API server, username and password won’t be cached
Parameters: Returns: credentials role name
Return type:
-
logout
()¶ Logout from Tintri server
-
-
exception
tintri.common.
TintriError
(cause=None, message=None, details=None)¶ Bases:
exceptions.Exception
Base class of all Tintri specific exceptions
Parameters:
-
exception
tintri.common.
TintriInternalError
(code, message, details)¶ Bases:
tintri.common.TintriServerError
Tintri internal error (HTTP status code: 500)
Parameters:
-
exception
tintri.common.
TintriInvalidSessionError
(code, message, details)¶ Bases:
tintri.common.TintriServerError
Tintri invalid session error (HTTP status code: 401)
Parameters:
-
exception
tintri.common.
TintriServerError
(status, code=None, cause=None, message=None, details=None)¶ Bases:
tintri.common.TintriError
Exception returned from Tintri server (VMstore or TGC)
Parameters:
-
class
tintri.common.
Version
¶ Bases:
tintri.common.TintriObject
Version class of a Tintri server across all Tintri API versions
-
class
tintri.common.
TintriPage
(paginated=False, auto_page=False, items=None, context={})¶ -
absoluteTotal
¶ Absolute number of requested objects without any qualifications including filtering, active, or deleted
-
completedIn
¶ Time in milliseconds indicating how long it took to serve the request
-
filteredTotal
¶ Number of objects as specified by filter. If no filter was requested, it would be same as total
-
get_next_page
()¶ Return next page if it exists
-
get_prev_page
()¶ Return previous page if it exists
-
lastUpdatedTime
¶ Time when the page was accessed
-
next
()¶ Iterates items in page along with navigating to next page
-
offsetMatchFound
¶ Indicates if requested item(s) is/are found
-
overflow
¶ Flag giving notice the amount of data did not fit into the given specified or default offset
-
pageTotal
¶ Total number of pages
-
page_number
¶ Current page number
-
total
¶ Total number of active objects across all pages
-
Tintri V310 Class¶
-
class
tintri.v310.
Tintri
(host, username=None, password=None, api_version='310', logger_name='tintri', auto_login=True, disable_cert_warning=True, custom_client_header=None, auto_page=True)¶ Bases:
tintri.common.TintriBase
Tintri class which provides APIs to interact with Tintri Server.
-
accept_recommendation
(vmstore_pool_id, recommendation_id)Accept a Recommendation. A Recommendation can only be accepted when Recommendation is in Available and Available_Acked state. All other states, an error will be returned.
Supported on: TGC (since v310.51)
Parameters:
-
acknowledge_recommendation
(vmstore_pool_id, recommendation_id)Acknowledge a Recommendation. If Recommendation is not in Available state, an error will be returned.
Supported on: TGC (since v310.51)
Parameters:
-
acknowledge_task
(task_id)Acknowledge a job
Supported on: VMstore (all versions)
Parameters: task_id (str) – The ID of the Task to be acknowledged.
-
add_certificate
(appliance_id, cert)Upload a certificate to VMStore.
Supported on: VMstore and TGC (all versions)
Parameters: - appliance_id (str) – Appliance object’s UUID
- cert (Certificate) – An instance of Certificate
-
add_vmstore
(vmstore)Add a VMstore to Tintri Global Center
Supported on: TGC (all versions)
Parameters: vmstore (Vmstore) – VMStore and its properties Returns: VMStore with the new Tintri UUID assigned by the system Return type: Vmstore
-
apply_service_group_qos_config
(service_group_id)Apply QOS config on service group.
Supported on: TGC (all versions)
Parameters: service_group_id (str) – service group id
-
associate_external_groups_with_role
(role_id, external_groups)Associates collection of external groups with an access control role
Supported on: VMstore and TGC (all versions)
Parameters: - role_id (str) – access control role id
- external_groups (List[str]) – collection of external groups
-
cancel_recommendation
(vmstore_pool_id, recommendation_id)Cancel a Recommendation. If Recommendation is not in accepted state, an error will be returned.
Supported on: TGC (since v310.51)
Parameters:
-
clone_vm
(clonespec, wait, refreshInterval)Clone a VM
Supported on: VMstore (all versions)
Parameters: - clonespec (VirtualMachineCloneSpec) – Clone spec
- wait (bool) – True if wait for clone VM task to complete, False otherwise
- refreshInterval (int) – interval to refresh task status
Returns: task ID
Return type:
-
convert_vm_to_thin_provision
(vm_ids)Convert a collection of VMs and all their files to thin-provisioning for maximum space savings. If a VM is already thin-provisioned, then it will be skipped. This operation is only allowed on T800 series or newer models of VMStore and supported for VMs originating from VMWare Hypervisor only.
Supported on: VMstore (since v310.11)
Parameters: vm_ids (List[str]) – A list of VM IDs.
-
create_acl
(obj, datastore_id, fileshare_name)Creates an Acl object.
Supported on: VMstore (since v310.11)
Parameters: Returns: The Ace object created.
Return type:
-
create_alert_report
(repot_filter)Gets the URL for retrieving specified alert report.
Supported on: TGC (all versions)
Parameters: repot_filter (AlertDownloadableReportFilter) – filter for generating report Returns: URL to retrieve alert list report Return type: str
-
create_appliance_snmp_target
(obj, appliance_id)Creates an ApplianceSnmpTarget object
Supported on: VMstore (all versions)
Parameters: - obj (ApplianceSnmpTarget) – An instance of ApplianceSnmpTarget.
- appliance_id (str) – Appliance object’s UUID.
-
create_appliance_snmp_user
(obj, appliance_id)Creates an ApplianceSnmpUser object
Supported on: VMstore (all versions)
Parameters: - obj (ApplianceSnmpUser) – An instance of ApplianceSnmpUser.
- appliance_id (str) – Appliance object’s UUID.
-
create_certificate
(appliance_id)Generate new self-signed host certificate with hostname and IP address in the Subject Alternative Name extension on VMstore.
Supported on: TGC (since v310.41)
Parameters: appliance_id (str) – Appliance object’s UUID
-
create_datastore_replication_path
(obj, datastore_id)Creates a DatastoreReplicationPath object.
Supported on: VMstore (all versions)
Parameters: - obj (DatastoreReplicationPath) – An instance of DatastoreReplicationPath.
- datastore_id (str) – Datastore Object’s UUID
Returns: The DatastoreReplicationPath object created.
Return type:
-
create_historic_stats_report
(datastore_id, report_filter)Create a URL for retrieving the system historical performance statistics report which is returned as output.
Supported on: TGC (all versions)
Parameters: - datastore_id (str) – Datastore object’s UUID
- report_filter (DatastoreStatDownloadableReportFilter) – filter for generating the report
Returns: URL to retrieve historic datastore statistics report
Return type:
-
create_hypervisor_manager_config
(obj, datastore_id)Creates a HypervisorManagerConfig object.
Supported on: VMstore (since v310.21)
Parameters: - obj (HypervisorManagerConfig) – An instance of HypervisorManagerConfig.
- datastore_id (str) – Datastore Object’s UUID
Returns: The HypervisorManagerConfig object created.
Return type:
-
create_license
(obj)Creates a License object.
Supported on: VMstore and TGC (all versions)
Parameters: obj (License) – An instance of License. Returns: The License object created. Return type: License
-
create_license_report
(license_report_filter)Get license list report as URL
Supported on: TGC (since v310.51)
Parameters: license_report_filter (LicenseDownloadableReportFilter) – License report filter Returns: URL to retrieve license list report Return type: str
-
create_licenses
(license_str)Adds one or more licenses.
Supported on: TGC (since v310.51)
Parameters: license_str (str) – string of one of more license keys separated by comma, space or line break Returns: List of validated or failed licenses Return type: List[str]
-
create_service_group
(obj)Creates a Service Group on the server.
Supported on: VMstore and TGC (all versions)
Parameters: obj (ServiceGroup) – An instance of ServiceGroup. Returns: The created ServiceGroup UUID. Return type: (str)
-
create_service_group_report
(report_filter)Get a URL for retrieving service group report
Supported on: TGC (all versions)
Parameters: report_filter (SvgDownloadableReportFilter) – filter for generating the report Returns: URL to retrieve service group list report Return type: str
-
create_snapshot
(SnapshotSpes)Creates a snapshots from a list of snapshot specification.
Supported on: VMstore (all versions)
Parameters: SnapshotSpes (List[SnapshotSpec]) – List of SnapshotSpecs. Returns: A list of created snapshot UUIDs. Return type: (List[str])
-
create_user_account
(obj)Creates an UserAccount object.
Supported on: VMstore and TGC (all versions)
Parameters: obj (UserAccount) – An instance of UserAccount. Returns: The UserAccount object created. Return type: UserAccount
-
create_vm_historical_stats_report
(vm_id, report_filter)Creates a URL for retrieving specified VM historical statistics report.
Supported on: TGC (all versions)
Parameters: - vm_id (str) – VM Object’s UUID
- report_filter (VirtualMachineStatDownloadableReportFilter) – Filter to use for generating report
Returns: URL to the report
Return type:
-
create_vm_list_report
(report_filter)Creates a URL for retrieving specified VM list report.
Supported on: TGC (all versions)
Parameters: report_filter (VirtualMachineDownloadableReportFilter) – Filter to use for generating report Returns: URL to the report Return type: str
-
create_vmpool_list_report
(report_filter)Creates a URL for retrieving specified VM pool report.
Supported on: TGC (since v310.51)
Parameters: report_filter (VmstorePoolDownloadableReportFilter) – Filter to use for generating report Returns: URL to the report Return type: str
-
create_vmstore
(obj)Creates a Vmstore object.
Supported on: VMstore and TGC (all versions)
Parameters: obj (Vmstore) – An instance of Vmstore. Returns: The Vmstore object created. Return type: Vmstore
-
create_vmstore_list_report
(report_filter)Creates a URL for retrieving specified VM historical statistics report.
Supported on: TGC (all versions)
Parameters: report_filter (VMstoreDownloadableReportFilter) – Filter to use for generating report Returns: URL to the report Return type: str
-
create_vmstore_pool
(obj)Creates a VmstorePool object.
Supported on: TGC (since v310.51)
Parameters: obj (VmstorePool) – An instance of VmstorePool. Returns: The VmstorePool object created. Return type: VmstorePool
-
delete_ace
(datastore_id, fileshare_id, ace_id)Deletes the Ace object specified by its ID.
Supported on: VMstore (since v310.11)
Parameters:
-
delete_appliance
(appliance_id)Deletes the Appliance object specified by its ID.
Supported on: VMstore and TGC (all versions)
Parameters: appliance_id (str) – Appliance Object’s UUID
-
delete_appliance_snmp_target
(appliance_id, target_id)Deletes the ApplianceSnmpTarget object specified by its ID.
Supported on: VMstore (all versions)
Parameters:
-
delete_appliance_snmp_user
(appliance_id, snmp_username)Deletes the ApplianceSnmpUser object specified by its ID.
Supported on: VMstore (all versions)
Parameters:
-
delete_certificate
(appliance_id, certificate_id)Deletes the Certificate object specified by its ID.
Supported on: VMstore and TGC (all versions)
Parameters:
-
delete_datastore_replication_path
(datastore_id, repl_id)Deletes the DatastoreReplicationPath object specified by its ID.
Supported on: VMstore (all versions)
Parameters:
-
delete_hypervisor_manager_config
(datastore_id, config_id)Deletes the HypervisorManagerConfig object specified by its ID.
Supported on: VMstore (since v310.21)
Parameters:
-
delete_license
(license_key)Deletes the License object specified by its ID.
Supported on: VMstore and TGC (all versions)
Parameters: license_key (str) – License Key
-
delete_service_group
(service_group_id)Deletes the ServiceGroup object specified by its ID.
Supported on: VMstore and TGC (all versions)
Parameters: service_group_id (str) – Service Group Object’s UUID
-
delete_snapshot
(snapshot_id)Deletes the Snapshot object specified by its ID.
Supported on: VMstore (all versions)
Parameters: snapshot_id (str) – Snapshot Object’s UUID
-
delete_snapshots
(filter)Removes snapshots that matches given snapshot filter criteria.
Supported on: VMstore (all versions)
Parameters: filter (dict or SnapshotFilterSpec) – Filter criteria for the snapshots to be removed. Returns: Formatted string Return type: str
-
delete_task
(task_id)Deletes the Task object specified by its ID.
Supported on: VMstore (all versions)
Parameters: task_id (str) – Task Object’s UUID
-
delete_user_account
(user_account_id)Deletes the UserAccount object specified by its ID.
Supported on: VMstore and TGC (all versions)
Parameters: user_account_id (str) – User Account Object’s UUID
-
delete_vm_incoming_replication_config
(vm_id)Delete incoming replication configuration for a VM.
Supported on: VMstore (since v310.51)
Parameters: vm_id (str) – VM object’s UUID
-
delete_vm_sync_disks
(vm_ids)Delete all the virtual disks that restored via SyncVM File-Level Restore operation for each of the targeted virtual machine.
Supported on: VMstore (since v310.31)
Parameters: vm_ids (List[str]) – A list of Virtual Macine object’s UUID
-
delete_vmstore
(vmstore_id)Deletes the Vmstore object specified by its ID.
Supported on: VMstore and TGC (all versions)
Parameters: vmstore_id (str) – Vmstore Object’s UUID
-
delete_vmstore_pool
(vmstore_pool_id)Deletes the VmstorePool object specified by its ID.
Supported on: TGC (since v310.51)
Parameters: vmstore_pool_id (str) – Vmstore Pool Object’s UUID
-
enable_disk_encryption
(appliance_id)Enables disk encryption.
Supported on: VMstore (all versions)
Parameters: appliance_id (str) – Appliance object’s UUID Returns: Appliance disk encryption result Return type: ApplianceDiskEncryptionResult
-
get_ace
(datastore_id, fileshare_name, ace_id)Gets a specific Ace object by its ID.
Supported on: VMstore (since v310.11)
Parameters: Returns: The Ace with the specified ID.
Return type:
-
get_acl
(datastore_id, fileshare_name)Gets a specific Acl object by its ID.
Supported on: VMstore (since v310.11)
Parameters: Returns: The Acl with the specified ID.
Return type:
-
get_alert_filter_scope
()Returns alert properties as specified by a filter request such as VMstore names and log message count.
Supported on: TGC (all versions)
Returns: filter scope Return type: FilterScope
-
get_alerts
(filters)Gets all Alerts, and returns them in a Page object.
Supported on: VMstore and TGC (all versions)
Parameters: filters (dict or AlertFilterSpec) – Filter Spec object Returns: Paginated Alert objects. Return type: Page
-
get_appliance
(appliance_id, filters)Gets Tintri Appliance properties
Supported on: VMstore and TGC (all versions)
Parameters: - appliance_id (str) – Appliance object’s UUID. (“default”) is valid.
- filters (dict or PageFilterSpec) – Filter Specification object.
Returns: One appliance instance
Return type:
-
get_appliance_alert_counts
(appliance_id)Gets a specific ApplianceAlertCounts object by its ID.
Supported on: VMstore (all versions)
Parameters: appliance_id (str) – Appliance Object’s UUID Returns: The ApplianceAlertCounts with the specified ID. Return type: ApplianceAlertCounts
-
get_appliance_components
(appliance_id)Gets all ApplianceComponents, and returns them in a Page object.
Supported on: VMstore (since v310.31)
Parameters: appliance_id (str) – Appliance Object’s UUID Returns: A list of ApplianceComponent objects. Return type: List[ApplianceComponent]
-
get_appliance_controllers
(appliance_id)Gets all ApplianceControllers, and returns them in a Page object.
Supported on: VMstore (since v310.31)
Parameters: appliance_id (str) – Appliance Object’s UUID Returns: A list of ApplianceController objects. Return type: List[ApplianceController]
-
get_appliance_customization_info
(appliance_id)Gets a specific ApplianceCustomizationInfo object by its ID.
Supported on: VMstore (all versions)
Parameters: appliance_id (str) – Appliance Object’s UUID Returns: The ApplianceCustomizationInfo with the specified ID. Return type: ApplianceCustomizationInfo
-
get_appliance_date_time
(appliance_id)Gets a specific ApplianceDateTime object by its ID.
Supported on: VMstore and TGC (all versions)
Parameters: appliance_id (str) – Appliance Object’s UUID Returns: The ApplianceDateTime with the specified ID. Return type: ApplianceDateTime
-
get_appliance_disk_encryption_info
(appliance_id)Gets a specific ApplianceDiskEncryptionInfo object by its ID.
Supported on: VMstore (all versions)
Parameters: appliance_id (str) – Appliance Object’s UUID Returns: The ApplianceDiskEncryptionInfo with the specified ID. Return type: ApplianceDiskEncryptionInfo
-
get_appliance_disks
(appliance_id)Gets all ApplianceDisks, and returns them in a Page object.
Supported on: VMstore (since v310.31)
Parameters: appliance_id (str) – Appliance Object’s UUID Returns: A list of ApplianceDisk objects. Return type: List[ApplianceDisk]
-
get_appliance_dns
(appliance_id)Gets a specific ApplianceDns object by its ID.
Supported on: VMstore and TGC (all versions)
Parameters: appliance_id (str) – Appliance Object’s UUID Returns: The ApplianceDns with the specified ID. Return type: ApplianceDns
-
get_appliance_email
(appliance_id)Gets a specific ApplianceEmail object by its ID.
Supported on: VMstore and TGC (all versions)
Parameters: appliance_id (str) – Appliance Object’s UUID Returns: The ApplianceEmail with the specified ID. Return type: ApplianceEmail
-
get_appliance_email_alerts
(appliance_id)Gets a specific ApplianceEmailAlerts object by its ID.
Supported on: VMstore and TGC (all versions)
Parameters: appliance_id (str) – Appliance Object’s UUID Returns: The ApplianceEmailAlerts with the specified ID. Return type: ApplianceEmailAlerts
-
get_appliance_failed_components
(appliance_id)Gets a specific ApplianceFailedComponents object by its ID.
Supported on: VMstore (all versions)
Parameters: appliance_id (str) – Appliance Object’s UUID Returns: The ApplianceFailedComponents with the specified ID. Return type: ApplianceFailedComponents
-
get_appliance_info
(appliance_id)Gets a specific ApplianceInfo object by its ID.
Supported on: VMstore and TGC (all versions)
Parameters: appliance_id (str) – Appliance Object’s UUID Returns: The ApplianceInfo with the specified ID. Return type: ApplianceInfo
-
get_appliance_ipmi
(appliance_id)Gets a specific ApplianceIpmi object by its ID.
Supported on: VMstore (all versions)
Parameters: appliance_id (str) – Appliance Object’s UUID Returns: The ApplianceIpmi with the specified ID. Return type: ApplianceIpmi
-
get_appliance_ips
(appliance_id)Gets all ApplianceIps, and returns them in a Page object.
Supported on: VMstore and TGC (all versions)
Parameters: appliance_id (str) – Appliance Object’s UUID Returns: A list of ApplianceIp objects. Return type: List[ApplianceIp]
-
get_appliance_lacp
(appliance_id)Gets a specific ApplianceLacp object by its ID.
Supported on: VMstore (all versions)
Parameters: appliance_id (str) – Appliance Object’s UUID Returns: The ApplianceLacp with the specified ID. Return type: ApplianceLacp
-
get_appliance_maintenance_mode
(appliance_id)Gets a specific ApplianceMaintenanceMode object by its ID.
Supported on: VMstore (all versions)
Parameters: appliance_id (str) – Appliance Object’s UUID Returns: The ApplianceMaintenanceMode with the specified ID. Return type: ApplianceMaintenanceMode
-
get_appliance_operational_info
(appliance_id)Gets a specific ApplianceOperationalInfo object by its ID.
Supported on: VMstore and TGC (all versions)
Parameters: appliance_id (str) – Appliance Object’s UUID Returns: The ApplianceOperationalInfo with the specified ID. Return type: ApplianceOperationalInfo
-
get_appliance_snmp
(appliance_id)Gets a specific ApplianceSnmp object by its ID.
Supported on: VMstore (all versions)
Parameters: appliance_id (str) – Appliance Object’s UUID Returns: The ApplianceSnmp with the specified ID. Return type: ApplianceSnmp
-
get_appliance_snmp_target
(appliance_id, target_id)Gets a specific ApplianceSnmpTarget object by its ID.
Supported on: VMstore (all versions)
Parameters: Returns: The ApplianceSnmpTarget with the specified ID.
Return type:
-
get_appliance_snmp_targets
(appliance_id)Get all the SNMP trap targets information. Currently, only one trap target is supported.
Supported on: VMstore (all versions)
Parameters: appliance_id (str) – The appliance ID. Returns: The list of all the SNMP trap target configurations. Return type: Response
-
get_appliance_snmp_user
(appliance_id, snmp_username)Gets a specific ApplianceSnmpUser object by its ID.
Supported on: VMstore (all versions)
Parameters: Returns: The ApplianceSnmpUser with the specified ID.
Return type:
-
get_appliance_snmp_users
(appliance_id)Gets SNMP users.
Supported on: VMstore (all versions)
Parameters: appliance_id (str) – The appliance ID. Returns: The list of all the SNMP user configurations. Return type: Response
-
get_appliance_support
(appliance_id)Gets a specific ApplianceSupport object by its ID.
Supported on: VMstore and TGC (all versions)
Parameters: appliance_id (str) – Appliance Object’s UUID Returns: The ApplianceSupport with the specified ID. Return type: ApplianceSupport
-
get_appliance_syslog_forwarding
(appliance_id)Gets a specific ApplianceSyslogForwarding object by its ID.
Supported on: VMstore (all versions)
Parameters: appliance_id (str) – Appliance Object’s UUID Returns: The ApplianceSyslogForwarding with the specified ID. Return type: ApplianceSyslogForwarding
-
get_appliance_timezones
(appliance_id)Returns list of time zones supported by the server
Supported on: VMstore and TGC (all versions)
Parameters: appliance_id (str) – Appliance object’s UUID Returns: List of string representation of time zones Return type: List[str]
-
get_appliance_upgrade_info
(appliance_id)Gets the Tintri appliance upgrade information, which includes upgrade state, checksum, version, error message. This is asynchronous information
Supported on: VMstore and TGC (all versions)
Parameters: appliance_id (str) – Appliance object’s UUID Returns: Appliance upgrade information Return type: ApplianceUpgradeInfo
-
get_appliances
(filters)Gets all Appliances, and returns them in a Page object.
Supported on: VMstore and TGC (all versions)
Parameters: filters (dict or PageFilterSpec) – Filter Spec object Returns: A list of Appliance objects. Return type: List[Appliance]
-
get_certificate
(appliance_id, certificate_id)Returns certificate(s) that matche the certificate ID or empty collection if not found.
Supported on: VMstore and TGC (all versions)
Parameters: Returns: Certificate if found, else None
Return type:
-
get_certificates
(appliance_id)Gets all Certificates, and returns them in a Page object.
Supported on: VMstore and TGC (all versions)
Parameters: appliance_id (str) – Appliance Object’s UUID Returns: A list of Certificate objects. Return type: List[Certificate]
-
get_cluster_configuration
()Gets a specific ClusterConfiguration object by its ID.
Supported on: TGC (all versions)
Returns: The ClusterConfiguration with the specified ID. Return type: ClusterConfiguration
-
get_current_recommendation
(vmstore_pool_id)Gets the current recommendation for specified VMstore pool ID
Supported on: TGC (since v310.51)
Parameters: vmstore_pool_id (str) – Vmstore pool ID
-
get_current_session
()Gets the current user sessions information
Supported on: VMstore (since v310.51)
Returns: Current User session Return type: UserSession
-
get_datastore
(datastore_id)Gets a specific Datastore object by its ID.
Supported on: VMstore and TGC (all versions)
Parameters: datastore_id (str) – Datastore Object’s UUID Returns: The Datastore with the specified ID. Return type: Datastore
-
get_datastore_historic_stats
(datastore_id)Gets the historic datastore performance slices containing all of the statistics for the datastore.
Supported on: VMstore and TGC (all versions)
Parameters: datastore_id (str) – Datastore object’s UUID Returns: Paginated Stats items containing a list of DatastoreStat. Return type: Page
-
get_datastore_nfs_accesses
(datastore_id)Gets a specific DatastoreNfsAccesses object by its ID.
Supported on: VMstore (all versions)
Parameters: datastore_id (str) – Datastore Object’s UUID Returns: The DatastoreNfsAccesses with the specified ID. Return type: DatastoreNfsAccesses
-
get_datastore_qos_info
(datastore_id)Gets a specific DatastoreQosInfo object by its ID.
Supported on: VMstore (since v310.21)
Parameters: datastore_id (str) – Datastore Object’s UUID Returns: The DatastoreQosInfo with the specified ID. Return type: DatastoreQosInfo
-
get_datastore_realtime_stats
(datastore_id)Gets the real time datastore performance slice containing all of the statistics for the datastore.
Supported on: VMstore and TGC (all versions)
Parameters: datastore_id (str) – The datastore UUID. Returns: Paginated Stats items containing a list of DatastoreStat. Return type: Page
-
get_datastore_replication_info
(datastore_id)Gets a specific DatastoreReplicationInfo object by its ID.
Supported on: VMstore and TGC (all versions)
Parameters: datastore_id (str) – Datastore Object’s UUID Returns: The DatastoreReplicationInfo with the specified ID. Return type: DatastoreReplicationInfo
-
get_datastore_replication_paths
(datastore_id)Gets all DatastoreReplicationPaths, and returns them in a Page object.
Supported on: VMstore and TGC (all versions)
Parameters: datastore_id (str) – Datastore Object’s UUID Returns: A list of DatastoreReplicationPath objects. Return type: List[DatastoreReplicationPath]
-
get_datastore_smb_setting
(datastore_id)Gets a specific DatastoreSmbSetting object by its ID.
Supported on: VMstore (since v310.11)
Parameters: datastore_id (str) – Datastore Object’s UUID Returns: The DatastoreSmbSetting with the specified ID. Return type: DatastoreSmbSetting
-
get_datastore_summary_stats
(datastore_id)Gets the latest historic datastore performance slice containing all of the statistics for the datastore.
Supported on: VMstore and TGC (all versions)
Parameters: datastore_id (str) – The datastore UUID. Returns: The latest statistics for the datastore. Return type: DatastoreStat
-
get_datastores
()Gets all Datastores, and returns them in a Page object.
Supported on: VMstore and TGC (all versions)
Returns: A list of Datastore objects. Return type: List[Datastore]
-
get_distinct_vm_snapshot_schedules
(datastore_id)Gets a list of distinct snapshot schedules, including the system default snapshot schedules. The system default snapshot schedules will be listed at the top of the list.
Supported on: VMstore (all versions)
Parameters: datastore_id (str) – Datastore object’s UUID Returns: A list of snapshot schedules. Return type: List[VirtualMachineSnapshotSchedule]
-
get_filter_scopes
()Gets all FilterScopes, and returns them in a Page object.
Supported on: TGC (all versions)
Returns: A list of FilterScope objects. Return type: List[FilterScope]
-
get_hypervisor_datastores
(datastore_id, query_params)Gets all HypervisorDatastores, and returns them in a Page object.
Supported on: VMstore (all versions)
Parameters: Returns: A list of HypervisorDatastore objects.
Return type: List[HypervisorDatastore]
-
get_hypervisor_manager_configs
(datastore_id)Gets all HypervisorManagerConfigs, and returns them in a Page object.
Supported on: VMstore (since v310.21)
Parameters: datastore_id (str) – Datastore Object’s UUID Returns: A list of HypervisorManagerConfig objects. Return type: List[HypervisorManagerConfig]
-
get_hypervisor_managers_from_ad
(datastore_id)Find potential Hyper-V hosts from Active Directory that this Datastore can manage.
Supported on: VMstore (since v310.31)
Parameters: datastore_id (str) – Datastore object’s UUID Returns: A list of Hyper-V hosts. Return type: List[HypervisorManagerConfig]
-
get_license_summary
()Gets a specific LicenseSummary object by its ID.
Supported on: TGC (since v310.51)
Returns: The LicenseSummary with the specified ID. Return type: LicenseSummary
-
get_licenses
()Gets all Licenses, and returns them in a Page object.
Supported on: VMstore and TGC (all versions)
Returns: A list of License objects. Return type: List[License]
-
get_policy_config
(service_group_id)Gets a specific PolicyConfig object by its ID.
Supported on: TGC (since v310.21)
Parameters: service_group_id (str) – Service Group Object’s UUID Returns: The PolicyConfig with the specified ID. Return type: PolicyConfig
-
get_rbac_external_config
(appliance_id)Gets a specific RbacExternalConfig object by its ID.
Supported on: VMstore and TGC (all versions)
Parameters: appliance_id (str) – Appliance Object’s UUID Returns: The RbacExternalConfig with the specified ID. Return type: RbacExternalConfig
-
get_recommendation
(vmstore_pool_id, recommendation_id)Gets a specific Recommendation object by its ID.
Supported on: TGC (since v310.51)
Parameters: Returns: The Recommendation with the specified ID.
Return type:
-
get_recommendations
(vmstore_pool_id)Gets a list of Recommendation based on query parameters
Supported on: TGC (since v310.51)
Parameters: vmstore_pool_id (str) – Vmstore pool ID
-
get_replication_links
()Gets the replication links
Supported on: TGC (all versions)
Returns: List of replication links Return type: List[ReplLink]
-
get_role
(alert_id)Get access control tole by instance Tintri UUID
Supported on: VMstore and TGC (all versions)
Parameters: alert_id (str) – Alert Object Tintri UUID Returns: an access control Role by instance Tintri UUID Return type: GenericRestApiRole
-
get_role_external
(group_id)Gets a specific RoleExternal object by its ID.
Supported on: VMstore and TGC (all versions)
Parameters: group_id (str) – Group Object’s UUID Returns: The RoleExternal with the specified ID. Return type: RoleExternal
-
get_role_externals
()Gets all RoleExternals, and returns them in a Page object.
Supported on: VMstore and TGC (all versions)
Returns: A list of RoleExternal objects. Return type: List[RoleExternal]
-
get_roles
()Returns a collection of fixed access control Role instances.
Supported on: VMstore and TGC (all versions)
Returns: Paginated fixed access control Role instances. Return type: Page
-
get_service_group
(service_group_id)Gets a specific ServiceGroup object by its ID.
Supported on: VMstore and TGC (all versions)
Parameters: service_group_id (str) – Service Group Object’s UUID Returns: The ServiceGroup with the specified ID. Return type: ServiceGroup
-
get_service_group_members
(service_group_id, filters)Gets all ServiceGroupMembers, and returns them in a Page object.
Supported on: VMstore and TGC (all versions)
Parameters: - service_group_id (str) – Service Group Object’s UUID
- filters (dict or PageFilterSpec) – Filter Spec object
Returns: Paginated ServiceGroupMember objects.
Return type:
-
get_service_group_operation_status
(service_group_id)Gets a specific ServiceGroupOperationStatus object by its ID.
Supported on: TGC (all versions)
Parameters: service_group_id (str) – Service Group Object’s UUID Returns: The ServiceGroupOperationStatus with the specified ID. Return type: ServiceGroupOperationStatus
-
get_service_group_qos_config
(service_group_id)Gets the QOS policy of given service group
Supported on: TGC (since v310.31)
Parameters: service_group_id (str) – service group id Returns: QoS config associated with service group Return type: VirtualMachineQosConfig
-
get_service_group_qos_operation_status
(service_group_id)Get QOS operation status of service group
Supported on: TGC (all versions)
Parameters: service_group_id (str) – service group id Returns: QoS operation status Return type: ServiceGroupOperationStatus
-
get_service_group_replication_config
(service_group_id)Get replication configuration associated with the service group.
Supported on: VMstore and TGC (all versions)
Parameters: service_group_id (str) – The service group ID. Returns: The replication configuration associated with the service group. Return type: VirtualMachineReplicationConfig
-
get_service_group_snapshot_schedules
(service_group_id)Returns list of snapshot schedules which will be applied to members of this service group.
Supported on: VMstore and TGC (all versions)
Parameters: service_group_id (str) – The service group ID. Returns: List of snapshot schedules associated the service group. Return type: List[VirtualMachineSnapshotSchedule]
-
get_service_groups
(filters)Gets all ServiceGroups, and returns them in a Page object.
Supported on: VMstore and TGC (all versions)
Parameters: filters (dict or PageFilterSpec) – Filter Spec object Returns: Paginated ServiceGroup objects. Return type: Page
-
get_snapshot
(tid)Gets a specific Snapshot object by its ID.
Supported on: VMstore (all versions)
Parameters: tid (str) – Object’s UUID Returns: The Snapshot with the specified ID. Return type: Snapshot
-
get_snapshots
(filters)Gets all Snapshots, and returns them in a Page object.
Supported on: VMstore (all versions)
Parameters: filters (dict or SnapshotFilterSpec) – Filter Spec object Returns: Paginated Snapshot objects. Return type: Page
-
get_srm_config
(service_group_id)Gets a specific SrmConfig object by its ID.
Supported on: VMstore and TGC (all versions)
Parameters: service_group_id (str) – Service Group Object’s UUID Returns: The SrmConfig with the specified ID. Return type: SrmConfig
-
get_task
(task_id, filters)Gets a specific Task object by its ID.
Supported on: VMstore (all versions)
Parameters: - task_id (str) – Task Object’s UUID
- filters (dict or TaskFilterSpec) – Filter Spec object
Returns: The Task with the specified ID.
Return type:
-
get_tasks
(filters)Gets all Tasks, and returns them in a Page object.
Supported on: VMstore (all versions)
Parameters: filters (dict or TaskFilterSpec) – Filter Spec object Returns: Paginated Task objects. Return type: Page
-
get_temperatures
(appliance_id)Gets all Temperatures, and returns them in a Page object.
Supported on: VMstore (since v310.31)
Parameters: appliance_id (str) – Appliance Object’s UUID Returns: A list of Temperature objects. Return type: List[Temperature]
-
get_timezones
(appliance_id)Returns list of all time zones supported by the server. Time zone follows standard format - <Country>/<Region> For more details about latest time zones, Please refer to - http://www.iana.org/time-zones
Supported on: VMstore and TGC (all versions)
Parameters: appliance_id (str) – The appliance ID. Returns: The list of string representation of time zones. Return type: List[str]
-
get_user_account
(tid)Gets a specific UserAccount object by its ID.
Supported on: VMstore and TGC (all versions)
Parameters: tid (str) – Object’s UUID Returns: The UserAccount with the specified ID. Return type: UserAccount
-
get_user_accounts
()Gets all UserAccounts, and returns them in a Page object.
Supported on: VMstore and TGC (all versions)
Returns: A list of UserAccount objects. Return type: List[UserAccount]
-
get_user_agreement
()Gets a specific UserAgreement object by its ID.
Supported on: VMstore and TGC (all versions)
Returns: The UserAgreement with the specified ID. Return type: UserAgreement
-
get_user_sessions
()Gets a list of user sessions information that are currently logged in
Supported on: VMstore (since v310.51)
Returns: list of UserSession objects Return type: List[UserSession]
-
get_virtual_disk_filter_scope
(filter)Return virtual disk filter scope.
Supported on: VMstore (all versions)
Parameters: filter (dict or VirtualDiskFilterSpec) – A dictionary or VirtualDiskFilterSpec that filters the returned results. Returns: A CommonStatFilterScope object. Return type: CommonStatFilterScope
-
get_virtual_disk_from_snapshot
(snapshot_id)Fetches disks of a snapshot. Only these two attributes are populated: - name (example: scsi0:0) - path (example: “ttvm23-vm19000/ttvm23-vm19000.vmdk”)
Supported on: VMstore (since v310.21)
Parameters: snapshot_id (str) – The snapshot ID. Returns: List of VirtualDisk objects of snapshot. Return type: List[VirtualDisk]
-
get_virtual_disk_historic_stats
(vm_id, virtual_disk_id, filter)Performance historic trend data for the virtual disk.
Supported on: VMstore (all versions)
Parameters: - vm_id (str) – The virtual machine ID.
- virtual_disk_id (str) – The virtual disk ID.
- filter (dict or VirtualDiskFilterSpec) – A dictionary or VirtualDiskFilterSpec that filters the returned results.
Returns: Paginated Stats items containing a list of CommonStat.
Return type:
-
get_virtual_disk_realtime_stats
(vm_id, virtual_disk_id, filter)Latest performance trend data for the virtual disk.
Supported on: VMstore (all versions)
Parameters: - vm_id (str) – The virtual machine ID.
- virtual_disk_id (str) – The virtual disk ID.
- filter (dict or VirtualDiskFilterSpec) – A dictionary or VirtualDiskFilterSpec that filters the returned results.
Returns: Paginated Stats items containing a list of CommonStat.
Return type:
-
get_virtual_disks
(filters)Gets all VirtualDisks, and returns them in a Page object.
Supported on: VMstore (all versions)
Parameters: filters (dict or VirtualDiskFilterSpec) – Filter Spec object Returns: Paginated VirtualDisk objects. Return type: Page
-
get_virtual_machine_customization_scripts
(vm_id)Gets customization scripts for VM specified.
Supported on: VMstore (since v310.21)
Parameters: vm_id (str) – VM Object’s UUID Returns: List[str] - A list of strings
-
get_virtual_machine_customization_spec
(datatore_id, vcenter_name)Gets a specific VirtualMachineCustomizationSpec object by its ID.
Supported on: VMstore (all versions)
Parameters: Returns: The VirtualMachineCustomizationSpec with the specified ID.
Return type:
-
get_virtual_machine_host_resources
(datatore_id, query_params)Gets all VirtualMachineHostResources, and returns them in a Page object.
Supported on: VMstore (all versions)
Parameters: Returns: A list of VirtualMachineHostResource objects.
Return type:
-
get_vm
(vm_id)Gets a specific Vm object by its ID.
Supported on: VMstore and TGC (all versions)
Parameters: vm_id (str) – Vm Object’s UUID Returns: The Vm with the specified ID. Return type: Vm
-
get_vm_filter_scopes
(filters)Gets all VmFilterScopes, and returns them in a Page object.
Supported on: VMstore (all versions)
Parameters: filters (dict or VirtualMachineFilterSpec) – Filter Spec object Returns: A list of VmFilterScope objects. Return type: List[VmFilterScope]
-
get_vm_historic_stats
(vm_id, filter)Gets the historic VM performance slice containing all of the statistics for the VM specified by query parameters.
Supported on: VMstore and TGC (all versions)
Parameters: - vm_id (str) – VM Object’s UUID.
- filter (dict or VirtualMachineFilterSpec) – dictionary or VirtualMachineFilterSpec to filter vms
Returns: Paginated Stats items containing a list of VirtualMachineStat.
Return type:
-
get_vm_policy_error_stats
(filters)Gets all VmPolicyErrorStats, and returns them in a Page object.
Supported on: TGC (all versions)
Parameters: filters (dict or PolicyErrorStatFilterSpec) – Filter Spec object Returns: Paginated VmPolicyErrorStat objects. Return type: Page
-
get_vm_realtime_stats
(vm_id, filter)Gets the real time VM performance slice containing all of the statistics for the VM.
Supported on: VMstore (all versions)
Parameters: - vm_id (str) – VM Object’s UUID.
- filter (dict or VirtualMachineFilterSpec) – dictionary or VirtualMachineFilterSpec to filter vms
Returns: Paginated Stats items containing a list of VirtualMachineStat.
Return type:
-
get_vm_replication_config_from_datastore
(datastore_id)Returns the system-wide replication configuration.
Supported on: VMstore and TGC (all versions)
Parameters: datastore_id (str) – Datastore object’s UUID Returns: The system-wide replication configuration. Return type: VirtualMachineReplicationConfig
-
get_vms
(filters)Gets all Vms, and returns them in a Page object.
Supported on: VMstore and TGC (all versions)
Parameters: filters (dict or VirtualMachineFilterSpec) – Filter Spec object Returns: Paginated Vm objects. Return type: Page
-
get_vmstore_pool
(vmstore_pool_id)Gets a specific VmstorePool object by its ID.
Supported on: TGC (since v310.51)
Parameters: vmstore_pool_id (str) – Vmstore Pool Object’s UUID Returns: The VmstorePool with the specified ID. Return type: VmstorePool
-
get_vmstore_pools
(filters)Gets all VmstorePools, and returns them in a Page object.
Supported on: TGC (since v310.51)
Parameters: filters (dict or PageFilterSpec) – Filter Spec object Returns: Paginated VmstorePool objects. Return type: Page
-
get_vmstores
()Gets all Vmstores, and returns them in a Page object.
Supported on: TGC (all versions)
Returns: A list of Vmstore objects. Return type: List[Vmstore]
-
mark_alerts_archived
()Marks all non-archived alerts to archived.
Supported on: VMstore and TGC (all versions)
-
mark_alerts_read
()Marks all non-acknowledged alerts to acknowledged.
Supported on: VMstore and TGC (all versions)
-
perform_ha_failover
(appliance_id)Performs HA failover, controller pair state should be REDUNDANT at the time of performing failover operation
Supported on: VMstore (since v310.21)
Parameters: appliance_id (str) – The appliance ID.
-
pin_virtual_disk
(vm_id, virtual_disk_id)Operation will pin the Virtual Disk of the VM to Flash storage in case of hybrid platform. This operation is not advisable. It may degrade the system performance.
Supported on: VMstore (since v310.21)
Parameters:
-
pin_vm
(vm_id)Operation will pin the VM to Flash storage in case of hybrid platform. This operation is not advisable. It may degrade the system performance.
Supported on: VMstore (since v310.21)
Parameters: vm_id (str) – VM Object’s UUID.
-
ping_hypervisor_managers
(datastore_id, hypervisor_manager_configs)Ping hypervisor managers configured on the Datastore
Supported on: VMstore (since v310.21)
Parameters: - datastore_id (str) – Datastore object’s UUID
- hypervisor_manager_configs (List[HypervisorManagerConfigs]) – A list of HypervisorManagerConfigs
Returns: Status of the ping calls to hypervisor managers.
Return type: List[HypervisorManagerConfig]
-
reboot
(appliance_id)Reboots specified appliance
Supported on: VMstore (since v310.11)
Parameters: appliance_id (str) – The appliance ID.
-
reset_recommendation
(vmstore_pool_id, recommendation_id)Reset a Recommendation. If Recommendation is not in Available or Available_Ack state, an error will be returned.
Supported on: TGC (since v310.51)
Parameters:
-
reset_user_password
(cred)Resets the password of a local user.
Supported on: VMstore and TGC (all versions)
Parameters: cred (RestApiCredentials) – RestApiCredentials object
-
restart_webserver
(appliance_id)Restarts the web server
Supported on: VMstore and TGC (since v310.41)
Parameters: appliance_id (str) – The appliance ID.
-
rotate_encryption_key
(appliance_id)Rotates the disk encryption key
Supported on: VMstore (all versions)
Parameters: appliance_id (str) – The appliance ID.
-
shutdown
(appliance_id)Shutsdown appliance
Supported on: VMstore (since v310.11)
Parameters: appliance_id (str) – The appliance ID.
-
sync_vm
(syncspec)Synchronize virtual machine to one of its snapshots.
Supported on: VMstore (since v310.21)
Parameters: syncspec (VirtualMachineSyncSpec) – Sync spec Returns: Task object Return type: Task
-
test_email
(appliance_id, email)Tests alert email. An email is sent to the configured alert email address.
Supported on: VMstore and TGC (all versions)
Parameters: - appliance_id (str) – Appliance object’s UUID
- email (ApplianceEmail) – email
Returns: Response to indicate if test email is successful or not
Return type: Response
-
test_rbac_external_config
(config, appliance_id)Tests the external directory service authentication configuration.
Supported on: VMstore and TGC (all versions)
Parameters: - config (RbacExternalConfig) – Rbac external config
- appliance_id (str) – Appliance object’s UUID
Returns: List of test results
Return type: List[RbacTestResult]
-
test_replication_path
(datastore_id, destinationIp, destionationPassphrase, destionationPort, sourceIp, testType, request)Tests the specified replication path on the specified datastore, provide either request or set other params.
Supported on: VMstore (all versions)
Parameters: - datastore_id – Datastore object’s UUID
- destinationIp – Remote IPv4 address of another datastore where replication data is received.
- destionationPassphrase – Authorization key used on the remote end of this replication link.
- destionationPort – Remote port of another datastore where replication data is received.
- sourceIp – Local IPv4 address used by datastore to send replication data.
- testType – Test to perform
- request – TestReplicationPath request
-
test_smb_config
(datastore_id, smb_config)Tests SMB host name configuration
Supported on: VMstore (since v310.11)
Parameters: Returns: List of test results
Return type: List[SmbResult]
-
test_snmp
(appliance_id, username, targets, users, request)Send a SNMP test trap to a remote trap receiver host, provide either request object or set params.
Supported on: VMstore (all versions)
Parameters: - appliance_id (str) – Appliance object’s UUID
- username (str) – Active SNMP user name
- targets (List[ApplianceSnmpTarget]) – SNMP trap targets and their settings
- users (List[ApplianceSnmpUser]) – SNMP users and their settings
- request (Request<ApplianceSnmp>) – ApplianceSnmp request
Returns: Formatted error message if operation fails
Return type: Response
-
test_syslog_forwarding
(appliance_id, remote_host, request)Send a test log forwarding message to the remote host, provide either request or remote host.
Supported on: VMstore (all versions)
Parameters: - appliance_id (str) – Appliance object’s UUID
- remote_host (str) – remote host name or IP address for syslog forwarding
- request (Request<ApplianceSyslogForwarding>) – ApplicaneSysLogForwarding request
-
unpin_virtual_disk
(vm_id, virtual_disk_id)Operation will unpin the Virtual Disk of the VM from Flash storage in case of hybrid platform. Pinning operation is not advisable.
Supported on: VMstore (since v310.21)
Parameters:
-
unpin_vm
(vm_id)Un-pin VM from Flash storage in case of hybrid platform. Pinning operation is not advised.
Supported on: VMstore (since v310.21)
Parameters: vm_id (str) – VM Object’s UUID.
-
update_alerts
(objs, properties_to_update, request)Updates the specified properties by values of passed alerts instance, either specify updated alerts or Request Alert object
Supported on: VMstore and TGC (all versions)
Parameters:
-
update_appliance
(obj, appliance_id, alert_counts, allow_snapshot_incomplete_vm, components, config_ips, controllers, customization_info, date_time_config, disks, disk_encryption_info, dns_config, email_config, info, ipmi_config, lacp_config, maintenance_mode, operational_info, rbac_external_config, snmp_config, support_config, syslog_forwarding, temperatures, upgrade_info, request)Updates Tintri Appliance’s specified properties, either specify updated object or properties in a Request VMstore object or set the properties to be updated.
Supported on: VMstore and TGC (all versions)
Parameters: - obj (Appliance) – Updated Appliance object
- appliance_id (str) – Appliance Object’s UUID
- alert_counts (ApplianceAlertCounts) – Tintri Appliance’s number of notifications from the boot
- allow_snapshot_incomplete_vm (ApplianceAllowSnapshotIncompleteVm) – Tintri Appliance allow snapshot incomplete VM information
- components (List[ApplianceComponent]) – List of hardware components in the appliance chassis
- config_ips (List[ApplianceIp]) – List of IP configurations
- controllers (List[ApplianceController]) – List of controllers expected in Tintri Appliance
- customization_info (ApplianceCustomizationInfo) – Tintri Appliance customization information
- date_time_config (ApplianceDateTime) – Tintri Appliance date time configuration on node
- disks (List[ApplianceDisk]) – List of hard disks or flash drives installed on Tintri Appliance
- disk_encryption_info (ApplianceDiskEncryptionInfo) – Tintri Appliance disk encryption information
- dns_config (ApplianceDns) – Tintri Appliance DNS configuration
- email_config (ApplianceEmail) – Tintri Appliance e-mail configuration for sending alert
- info (ApplianceInfo) – Tintri Appliance information
- ipmi_config (ApplianceIpmi) – Tintri Appliance IPMI configuration
- lacp_config (ApplianceLacp) – Tintri Appliance LACP configuration
- maintenance_mode (ApplianceMaintenanceMode) – Tintri Appliance maintenance mode information
- operational_info (ApplianceOperationalInfo) – Tintri Appliance operational information
- rbac_external_config (RbacExternalConfig) – Tintri Appliance RBAC External Configuration
- snmp_config (ApplianceSnmp) – Tintri Appliance SNMP configuration
- support_config (ApplianceSupport) – Tintri Appliance auto-support configuration
- syslog_forwarding (ApplianceSyslogForwarding) – Tintri Appliance system log forwarding configuration
- temperatures (List[Temperature]) – List of temperatures detected by sensors of the chassis
- upgrade_info (ApplianceUpgradeInfo) – Tintri Appliance upgrade information
- request (Request<Appliance>) – Appliance Request Object
-
update_appliance_snmp
(obj, appliance_id)Updates the ApplianceSnmp object specified by its ID.
Supported on: VMstore (all versions)
Parameters: - obj (ApplianceSnmp) – An instance of ApplianceSnmp.
- appliance_id (str) – Appliance Object’s UUID
-
update_appliance_snmp_target
(obj, appliance_id, target_id)Updates the ApplianceSnmpTarget object specified by its ID.
Supported on: VMstore (all versions)
Parameters: - obj (ApplianceSnmpTarget) – An instance of ApplianceSnmpTarget.
- appliance_id (str) – Appliance Object’s UUID
- target_id (str) – Target Object’s UUID
-
update_appliance_snmp_user
(obj, appliance_id, snmp_username)Updates the ApplianceSnmpUser object specified by its ID.
Supported on: VMstore (all versions)
Parameters: - obj (ApplianceSnmpUser) – An instance of ApplianceSnmpUser.
- appliance_id (str) – Appliance Object’s UUID
- snmp_username (str) – Snmp Username
-
update_certificate
(obj, appliance_id)Upload a certificate to VMstore
Supported on: VMstore and TGC (all versions)
Parameters: - obj (Certificate) – Updated Certificate object
- appliance_id (str) – Appliance object’s UUID
-
update_cluster_configuration
(obj)Updates the ClusterConfiguration object specified by its ID.
Supported on: TGC (all versions)
Parameters: obj (ClusterConfiguration) – An instance of ClusterConfiguration.
-
update_datastore
(obj, datastore_id, display_name, is_data_from_appliance, last_updated_time, local_alias, snapshot_high_frequency_vms_count, snapshot_high_frequency_vms_max, vaai_thick_support_disabled, appliance_uuid, nfs_accesses, qos_info, replication, snapshot_schedules, stat, list, request)Updates the specified properties of the specified datastore, either specify properties in a Request Datastore object or set the properties to be updated.
Supported on: VMstore (all versions)
Parameters: - obj (Datastore) – Updated Datastore object
- datastore_id (str) – Datastore object’s UUID
- display_name (str) – This name to be used to display in a UI.
- is_data_from_appliance (bool) – Set to true if the current data in the datastore was fetched from the appliance. If the appliance is not accessible set it to false to indicate that the data contained in the datastore is from local system management databases.
- last_updated_time (DateTime) – Last time the entity is updated in the format YYYY-MM-DDThh:mm:ss.ms-/+zz:zz
- local_alias (str) – Alias used for the entity instance in this Tintri API server. If an alias is not set, then localAlias is not returned.
- snapshot_high_frequency_vms_count (int) – Returns the current number of VMs using RPO (high frequency) snapshots
- snapshot_high_frequency_vms_max (int) – Returns the maximum number of VMs permitted to take high frequency snapshots.
- vaai_thick_support_disabled (str) – Option to ensure the VMStore treats all new VMWare VAAI provisioned VMs as Thin-provisioned. A “true” value indicates that VMStore file system will always use thin provisioning to get maximum space savings. But a “false” value indicates that the VMStore file system will use the VAAI setting provided by the user during provisioning.
- appliance_uuid (Uuid) – The Tintri appliance UUID.
- nfs_accesses (DatastoreNfsAccesses) – NFS control access.
- qos_info (DatastoreQoSInfo) – Datastore QOS Info object
- replication (DatastoreReplicationInfo) – The replication links from and to this datastore and other replication related properties at datastore level.
- snapshot_schedules (List[VirtualMachineSnapshotSchedule]) – A list of of default Snapshot schedules.
- stat (DatastoreStat) – Latest performance data at datastore level. It is aggregated for all VMs and artifacts on the datastore.
- list (storage_containers) – A list of storage container information contined within the datastore.
- request (Request<Datastore>) – Datastore request object
-
update_datastore_nfs_accesses
(obj, datastore_id)Updates the DatastoreNfsAccesses object specified by its ID.
Supported on: VMstore (all versions)
Parameters: - obj (DatastoreNfsAccesses) – An instance of DatastoreNfsAccesses.
- datastore_id (str) – Datastore Object’s UUID
-
update_datastore_replication_info
(obj, datastore_id, passphrase, port, paths_incoming, request)Updates the specified replication properties on the specified datastore instance by the incoming replication properties instance, either specify properties in a Request DatastoreReplicationInfo object or set the properties to be updated.
Supported on: VMstore (all versions)
Parameters: - obj (DatastoreReplicationInfo) – Updated DatastoreReplicationInfo object
- datastore_id (str) – Datastore object’s UUID
- passphrase (str) – Authorization key of this datastore which will be used to validate when another datastore attempts to setup replication with this datastore as the destination.
- port (int) – Local listening port of the replication destination which is a 16-bit unsigned integer ranging from 1 to 65535.
- paths_incoming (List[DatastoreReplicationPath]) – List of incoming replication paths for this datastore.
- request (Request<DatastoreReplicationInfo>) – DatastoreReplicationInfo request
-
update_datastore_replication_path
(obj, datastore_id, request)Updates the specified replication link on the specified datastore instance by the incoming replication instance, either specify properties in a Request DatastoreReplicationPath object or use the updated object. In both cases, make sure that ‘id’ attribute is present.
Supported on: VMstore (all versions)
Parameters: - obj (DatastoreReplicationPath) – Updated DatastoreReplicationPath object
- datastore_id (str) – Datastore object’s UUID
- request (Request<DatastoreReplicationPath>) – DatastoreReplicationPath request
-
update_datastore_smb_setting
(obj, datastore_id)Updates the DatastoreSmbSetting object specified by its ID.
Supported on: VMstore (since v310.11)
Parameters: - obj (DatastoreSmbSetting) – An instance of DatastoreSmbSetting.
- datastore_id (str) – Datastore Object’s UUID
-
update_datastore_snapshot_schedule
(datastore_id)Updates system snapshot schedule
Supported on: VMstore (all versions)
Parameters: datastore_id (str) – Datastore object’s UUID
-
update_hf_snapshot_config
(obj, vm_id, is_enabled, request)Update the VM high frequency snapshot configuration properties, either specify properties in a Request HighFrequencySnapshotConfig object or set the properties to be updated.
Supported on: VMstore (since v310.21)
Parameters: - obj (HighFrequencySnapshotConfig) – Updated HighFrequencySnapshotConfig object
- vm_id (str) – VM object’s UUID
- is_enabled (bool) – True if HFS is to be enabled, False otherwise
- request (Request<HighFrequencySnapshotConfig>) – HighFrequencySnapshotConfig request
-
update_high_priority_service_group
(service_group_id, request)Update the service groups that have higher priority than the given service group
Supported on: TGC (all versions)
Parameters: - service_group_id (int) – service group id
- request (CollectionChangeRequest) – CollectionChangeRequest object
-
update_hypervisor_manager_config
(obj, datastore_id, manager_config_id, username, password, request)Updates username or password of already configured hypervisor manager, either specify properties in a Request HypervisorManagerConfig object or set the properties to be updated.
Supported on: VMstore (since v310.21)
Parameters: - obj (HypervisorManagerConfig) – Updated HypervisorManagerConfig object
- datastore_id (str) – Datastore object’s UUID
- manager_config_id (str) – Hypervisor Manager config UUID
- username (str) – Username for the hypervisor manager
- password (str) – Password for the hypervisor manager
- request (Request<HypervisorManagerConfig>) – HypervisorManagerConfig request
-
update_policy_config
(obj, service_group_id)Updates the PolicyConfig object specified by its ID.
Supported on: TGC (since v310.21)
Parameters: - obj (PolicyConfig) – An instance of PolicyConfig.
- service_group_id (str) – Service Group Object’s UUID
-
update_rbac_external_config
(obj, appliance_id)Updates the RbacExternalConfig object specified by its ID.
Supported on: VMstore and TGC (all versions)
Parameters: - obj (RbacExternalConfig) – An instance of RbacExternalConfig.
- appliance_id (str) – Appliance Object’s UUID
-
update_recommendation
(obj, vmstore_pool_id, recommendation_id, accepted_time, acknowledged_time, completion_time, creation_time, execution_state, expiration_time, group_id, last_updated_time, state, state_reason, vm_affinity_not_now_tintri_uuids, action_groups, expected_outcomes, feedback, issues, request)Update attribute of a Recommendation for supported attribute, either specify properties in a Request Recommendation object or set the properties to be updated.
Supported on: TGC (since v310.51)
Parameters: - obj (Recommendation) – Updated Recommendation object
- vmstore_pool_id (str) – VMstorePool Object’s UUID
- recommendation_id (str) – Recommendation Object’s UUID
- accepted_time (DateTime) – Time when recommendation is accepted by user
- acknowledged_time (DateTime) – The acknowledged time by user
- completion_time (DateTime) – Recommendation completion time
- creation_time (DateTime) – Recommendation creation time
- execution_state (str) – Execution state of the Recommendation
- expiration_time (DateTime) – The expiration time
- group_id (str) – Returns the groupId. The attribute is undocumented by default and used only for testing
- last_updated_time (DateTime) – Last time the recommendation was updated
- state (str) – Recommendation state
- state_reason (str) – Reason that the recommendation is unavailable or invalidated
- vm_affinity_not_now_tintri_uuids (str) – The VM affinity “NOT NOW” for this Recommendation. Only applied when Recommendation state is AVAILABLE or AVAILABLE_ACKED
- action_groups (List[RecommendationActionGroup]) – A list of action groups. The group must be executed in the order it is returned. The action inside a group can be safely executed in parallel
- expected_outcomes (List[RecommendationOutcome]) – The expected condition of one or more VMstore if the recommendation is applied
- feedback (RecommendationFeedback) – The user feedback on the recommendation. Only applied when Recommendation state is AVAILABLE or AVAILABLE_ACKED
- issues (List[RecommendationAnalysis]) – The predicted issues of one or more VMstore in the next 7 days
- request (Request<Recommendation>) – Recommendation request
-
update_role
(obj, role_id)Updates the Role object specified by its ID.
Supported on: VMstore and TGC (all versions)
Parameters:
-
update_service_group
(obj)Update an existing service group.
Supported on: VMstore and TGC (all versions)
Parameters: obj (ServiceGroup) – Updated Servicegroup object
-
update_service_group_protection_policy
(service_group_id, policy)Update the protection policy (both snapshot schedules and replication configuration) for the given service group.
Supported on: TGC (since v310.21)
Parameters: - service_group_id (str) – service group id
- policy (PolicyConfig) – protection policy
-
update_service_group_qos_config
(qos_config, service_group_id)Updates the QOS policy of service group with given config
Supported on: TGC (since v310.31)
Parameters: - qos_config (VirtualMachineQoSConfig) – VirtualMachineQoSConfig object
- service_group_id (str) – service group id
-
update_service_group_rules
(rules, service_group_id)Updates rules of given service group
Supported on: TGC (since v310.21)
Parameters: - rules (ServiceGroupRules) – ServiceGroupRules object
- service_group_id (str) – service group id
-
update_service_group_static_members
(service_group_id, request)Update statically assigned members for the given service group. Deleted or non-existent members will be ignored.
Supported on: TGC (since v310.21)
Parameters: - service_group_id (str) – service group id
- request (CollectionChangeRequest) – CollectionChangeRequest object
-
update_user_account
(obj, user_account_id, is_deletable, is_disabled, last_updated_time, local_alias, name, password, role, role_names, request)Updates the specified properties by values of passed UserAccount instance, either specify updated object or properties in a Request VMstore object or set the properties to be updated.
Supported on: VMstore and TGC (all versions)
Parameters: - obj (UserAccount) – Updated UserAccount object
- user_account_id (str) – UserAccount object’s UUID
- is_deletable (bool) – ‘True’ indicates account can be deleted, ‘False’ otherwise
- is_disabled (bool) – ‘True’ indicates account is disabled, ‘False’ otherwise
- last_updated_time (DateTime) – Last time the entity is updated in YYYY-MM-DDThh:mm:ss:ms-/+zz:zz format
- local_alias (str) – Alias used for entity instance
- name (str) – Role name
- password (str) – Password for this user account, its only used when adding or updating user accounts
- role (Role) – Return the access control role assigned for the user account
- role_names (List[str]) – List of role names assigned to this user account
- request (Request<UserAccount>) – Request UserAccount object
-
update_user_agreement
(obj)Updates the UserAgreement object specified by its ID.
Supported on: VMstore and TGC (all versions)
Parameters: obj (UserAgreement) – An instance of UserAgreement.
-
update_vm
(obj, vm_id, request)Updates the Vm object specified by its ID.
Supported on: VMstore and TGC (all versions)
Parameters:
-
update_vm_affinity
(affinity, vm_id)Updates VM affinity rule
Supported on: TGC (since v310.51)
Parameters: - affinity (VirtualMachineAffinityRule) – VirtualMachineAffinityRule to set
- vm_id (str) – VM Object’s UUID
-
update_vm_qos_config
(obj, vm_id, min_normalized_iops, max_normalized_iops, request)Update QoS per VM, either specify properties in a Request VirtualMachineQoSConfig object or set the properties to be updated.
Supported on: VMstore and TGC (since v310.21)
Parameters: - obj (VirtualMachineQoSConfig) – Updated VirtualMachineQoSConfig object
- vm_id (str) – VM object’s UUID
- min_normalized_iops (int) – min IOPS
- max_normalized_iops (int) – max IOPS
- request (Request<VirtualMachineQoSConfig>) – VirtualMachineQoSConfig request
-
update_vm_replication_config
(vm_id, replication_configs)Update the outgoing replication configurations for the VM specified by the guven vmId to the new replication configurations specified.
Supported on: VMstore (all versions)
Parameters: - vm_id (str) – VM Object’s UUID
- replication_configs (List[VirtualMachineReplicationConfig]) – A list of VirtualMachineReplicationConfig objects
-
update_vm_replication_config_from_datastore
(datastore_id, replication_config)Update the system replication configuration, for example, from system disabled to system enabled. While applying the system default replication configuration to the VMs, the VMs with a custom outgoing replication configuration will be ignored. In addition to this, a VM which has an incoming replication configuration, or is a part of service group or is not live and does not have any snapshot or has snapshots but its latest snapshot is a replica, will be marked as ineligible for system default configuration, and a disabled system default replication configuration will be added for such a VM instead.
Supported on: VMstore (all versions)
Parameters: - datastore_id (str) – Datastore object’s UUID
- replication_config (VirtualMachineReplicationConfig) – The updated VirtualMachineReplicationConfig object.
-
update_vm_replication_config_to_default
(vm_ids)Update the outgoing replication configurations for the specified VMs to the system default replication configuration. This will first clean up the existing outgoing replication configurations, before applying the system default replication configuration to the VM.
Supported on: VMstore and TGC (since v310.21)
Parameters: vm_ids (List[str]) – A list of VM IDs.
-
update_vm_snapshot_schedule
(obj, vm_id, consistency, cron_expressions, initial_default_cron_expression, initial_default_retention_minutes, is_system_default_schedule, name, retention_destination_minutes, retention_source_minutes, type, version, is_tgc_service_group_default, request)Update VM snapshot schedule properties, either specify properties in a Request VirtualMachineSnapshotSchedule object or set the properties to be updated.
Supported on: VMstore and TGC (all versions)
Parameters: - obj (VirtualMachineSnapshotSchedule) – Updated VirtualMachineSnapshotSchedule object
- vm_id (str) – VM object’s UUID
- consistency (str) – Snapshot consistency
- cron_expressions (str) – A list of cron expressions describing snapshot schedule
- initial_default_cron_expression (str) – Quartz cron format
- initial_default_retention_minutes (int) – The intial defautlt retention time in minutes.
- is_system_default_schedule (bool) – True if the schedule name matches any of the default schedule names, False otherwise
- name (str) – User assigned name
- retention_destination_minutes (int) – length of time in minutes the snapshot replica on the replication destination is to be retained
- retention_source_minutes (int) – Number of minutes, a snapshot generated as per this schedule is to be retained
- type (str) – Schedule type to indicate whether it is hourly, daily, weekly, monthly or quarterly.
- version (str) – version
- is_tgc_service_group_default (bool) – Boolean value indicates if the requested Snapshot Schedule is Service Group default from TGC.
- request (Request<VirtualMachineSnapshotSchedule>) – VirtualMachineSnapshotSchedule request
-
update_vm_snapshot_schedule_to_default
(vm_ids)Update the outgoing replication configurations for the specified VMs to the system default replication configuration. This will first clean up the existing outgoing replication configurations, before applying the system default replication configuration to the VM.
Supported on: VMstore and TGC (all versions)
Parameters: vm_ids (List[str]) – A list of VM IDs.
-
update_vms_qos_config
(vm_ids, min_normalized_iops, max_normalized_iops, request)Updates the QoS configuration for all specified VMs, either specify properties in a MultipleSelectionRequest object or set the properties to be updated.
Supported on: VMstore (since v310.21)
Parameters: - vm_ids (List[str]) – A list of Virtual Macine object’s UUID
- min_normalized_iops (int) – VM’s minimum configured IOPS. If using default QoS, the minimum normalized IOPS value will be zero.
- max_normalized_iops (int) – VM’s maximum configured IOPS. If using default QoS, the maximum normalized IOPS value will be zero.
- request (MultipleSelectionRequest<VirtualMachineQoSConfig>) – A MultipleSelectionRequest object populated with updated values.
-
update_vmstore_issues
(recommendation_issues, vmstore_pool_id, recommendation_id)Updates Recommendation specified with RecommendationIssueSelection
Supported on: TGC (since v310.51)
Parameters: - recommendation_issues (List[RecommendationIssueSelection]) – List of RecommendationIssueSelection
- vmstore_pool_id (str) – Vmstore pool ID
- recommendation_id (str) – Recommendation ID
-
update_vmstore_pool
(obj, vmstore_pool_id)Updates the VmstorePool object specified by its ID.
Supported on: TGC (since v310.51)
Parameters: - obj (VmstorePool) – An instance of VmstorePool.
- vmstore_pool_id (str) – Vmstore Pool Object’s UUID
-
update_vmstore_pool_members
(vmstore_pool_id, request)Add or delete members of the given VMstore pool.
Supported on: TGC (since v310.51)
Parameters: - vmstore_pool_id (str) – Vmstore pool ID
- request (CollectionChangeRequest) – CollectionChangeRequest object which specifies new and deleted members to be updated
-