Skip to content

TrimbleCloud.FileService

TrimbleCloud.FileService

Contents

APIBase type

Namespace

TrimbleCloud.FileService

Summary

Base class for API requests

JsonContentType constants

Summary

Content type for JSON requests

JsonWrapperFormat constants

Summary

JSON wrapper format string for API requests/responses

_client constants

Summary

The HTTP client instance for making requests

_wrapperName constants

Summary

The wrapper name for API responses

GetRequestId(message) method

Summary

Extracts the request ID from the HTTP response headers

Returns

The request ID if present, otherwise an empty string

Parameters
NameTypeDescription
messageSystem.Net.Http.HttpResponseMessageThe HTTP response message

ThrowErrorAsync(response) method

Summary

Throws a TrimbleServiceException for HTTP error responses

Parameters
NameTypeDescription
responseSystem.Net.Http.HttpResponseMessageThe HTTP response message
Exceptions
NameDescription
TrimbleCloud.FileService.TrimbleServiceExceptionAlways thrown with error details (includes ArgumentNullException as inner exception if response is null)

Acl type

Namespace

TrimbleCloud.FileService.Models

Summary

Represents the actor role mapping for the resources.

AccessExpiresAt property

Summary

Time when the actor’s access to the resource expires.

Actor property

Summary

The TRN (Trimble Resource Name) of the actor (User/Device/Application).

Role property

Summary

The role assigned to the actor.

AclActor type

Namespace

TrimbleCloud.FileService.Models

Summary

Represents an actor in the ACL (Access Control List).

Actor property

Summary

The TRN (Trimble Resource Name) of the actor (User/Device/Application).

AclApplicationIdentity type

Namespace

TrimbleCloud.FileService.Models

Summary

Represents an application identity in the access control list (ACL).

#ctor(applicationId) constructor

Summary

Creates an application identity.

Parameters
NameTypeDescription
applicationIdSystem.GuidThe application id

FormatEntity() method

Summary

Returns the TRN (Trimble Resource Name) of the application.

Parameters

This method has no parameters.

AclCustomIdentity type

Namespace

TrimbleCloud.FileService.Models

Summary

Represents a custom identity in the access control list (ACL).

#ctor(entityTrn) constructor

Summary

Creates a custom identity.

Parameters
NameTypeDescription
entityTrnSystem.StringThe TRN of the custom entity

FormatEntity() method

Summary

Returns the TRN (Trimble Resource Name) of the custom entity.

Parameters

This method has no parameters.

AclDeviceIdentity type

Namespace

TrimbleCloud.FileService.Models

Summary

Represents a device identity in the access control list (ACL).

#ctor(deviceId) constructor

Summary

Creates a device identity.

Parameters
NameTypeDescription
deviceIdSystem.GuidThe device id

FormatEntity() method

Summary

Returns the TRN (Trimble Resource Name) of the device.

Parameters

This method has no parameters.

AclIdentity type

Namespace

TrimbleCloud.FileService.Models

Summary

Represents an identity in the access control list (ACL).

EntityId property

Summary

The entity ID

Equals(obj) method

Summary

Check if two entities are equal

Returns

True if the entities are equal

Parameters
NameTypeDescription
objSystem.ObjectThe entity to compare

FormatEntity() method

Summary

Format the entity as a TRN string

Returns

The formatted TRN string

Parameters

This method has no parameters.

GetHashCode() method

Summary

Get the hash code for the entity

Returns

The hash code

Parameters

This method has no parameters.

Parse(entityTrn) method

Summary

Construct an ACL identity

Returns

The ACL identity

Parameters
NameTypeDescription
entityTrnSystem.StringThe entity ID

ToString() method

Summary

Create a string representation of the entity

Returns

The string representation

Parameters

This method has no parameters.

AclIdentityConverter type

Namespace

TrimbleCloud.FileService.Models

Summary

Converter for ACLIdentity

CanConvertFrom() method

Summary

Check if the type can be converted from a string

Parameters

This method has no parameters.

ConvertFrom() method

Summary

Convert a string to an ACLIdentity

Parameters

This method has no parameters.

AclRole type

Namespace

TrimbleCloud.FileService.Models

Summary

Permissions types

ContentContributor constants

Summary

ContentContributor has all operations on the file and folder except for the ACL control.

ContentManager constants

Summary

ContentManager almost as many permissions as SpaceManager, but cannot update/delete the file space.

ContentViewer constants

Summary

ContentViewer has all read permissions on the file and folder.

LimitedViewer constants

Summary

LimitedViewer has restricted permissions on files and folders.

SpaceManager constants

Summary

SpaceManager has highest level of permissions in the file space. Can perform all operations on the file space.

SupportFileAdmin constants

Summary

SupportFileAdmin has administrative permissions specifically for support files.

Unknown constants

Summary

Unknown role type

AclUserIdentity type

Namespace

TrimbleCloud.FileService.Models

Summary

Represents a user identity in the access control list (ACL).

#ctor(userId) constructor

Summary

Creates a user identity.

Parameters
NameTypeDescription
userIdSystem.GuidThe user id

FormatEntity() method

Summary

Returns the TRN (Trimble Resource Name) of the user.

Parameters

This method has no parameters.

BatchFolderCreate type

Namespace

TrimbleCloud.FileService.Models

Summary

Create batch folders request

Folders property

Summary

Folders to create in batch

BatchFolderList type

Namespace

TrimbleCloud.FileService.Models

Summary

List of Folders and Invalid Folder Items returned by the Batch Folder List API

InvalidItems property

Summary

List of Invalid Folder Items

Items property

Summary

List of Valid Folder Items

BatchMinimalFolderList type

Namespace

TrimbleCloud.FileService.Models

Summary

Response for Batch Get Minimal Folder List

InvalidItems property

Summary

List of Invalid Folder Items

Items property

Summary

List of Valid Folder Items

BatchResourceListResponse type

Namespace

TrimbleCloud.FileService.Models

Summary

Batch Get Resources Response

InvalidItems property

Summary

List of Invalid Resource Items

Items property

Summary

List of Valid Resource Items

Capabilities type

Namespace

TrimbleCloud.FileService.Models

Summary

Represents a filespace in File Service.

CanCheckIn property

Summary

Whether the user can check in the file. The actor who checked out the file or an actor with the ContentManager role attached to the file or parent resource is allowed to checkout the file.

CanCheckOut property

Summary

Whether the user can check out the file. Checking out a file will prevent other actors from creating a new version or other mutation operations. A checked out file will be deleted in a recursive parent deletion. Support files cannot be checked out.

CanCreate property

Summary

Whether the user can create a child resource (Folder/File) under the given resource.

CanDelete property

Summary

Whether the user can delete the resource.

CanLock property

Summary

Whether the user can lock the given file.

CanManageAccess property

Summary

Whether the user can update the permissions of the resource.

CanRead property

Summary

Whether the user can read the resource.

CanUnlock property

Summary

Whether the user can unlock the given file. For Unlock, a user must have the ContentManager role or have locked the file themselves. Note: The canUnlock capability is true if the user has the ContentManager role, regardless of who locked the file.

CanUpdate property

Summary

Whether the user can perform Update, Move, Rename, or Restore operations on the resource. Note: Move and Restore operations consider destination access for authorization, but canUpdate is determined solely by user roles.

Checkout type

Namespace

TrimbleCloud.FileService.Models

Summary

Represents a checkout of a file in File Service.

CheckedOutAt property

Summary

The date and time when the file was checked out.

CheckedOutBy property

Summary

The actor who checked out the file.

Reason property

Summary

The reason for checking out the file.

CopyFileRequest type

Namespace

TrimbleCloud.FileService.Models

Summary

Request object for file copying operations

CopyAcl property

Summary

Whether to copy the ACL of the file. If true, the copied file will have the same ACL as the original file of permissionLocal and not permissionInherited

FileId property

Summary

The file ID to copy

Headers property

Summary

Custom HTTP headers to include with the request

IncludeSupportFiles property

Summary

Copy support files and links along with the files

Name property

Summary

The new name of the copied file. If not specified, the file will be copied with its original name

OverwriteExisting property

Summary

Whether to overwrite an existing resource. If true, the existing resource will have a new version created with the copied content

PermissionsLocal property

Summary

Update the permissions on the file.

SpaceId property

Summary

The space ID

TargetParentId property

Summary

The target parent ID where the file will be copied to

Version property

Summary

All specified versions will be copied. If not specified, the latest version will be copied

CopyFolderRequest type

Namespace

TrimbleCloud.FileService.Models

Summary

Request object for file copying operations

CopyAcl property

Summary

Whether to copy the ACL of the file. If true, the copied file will have the same ACL as the original file of permissionLocal and not permissionInherited

FolderId property

Summary

The file ID to copy

Headers property

Summary

Custom HTTP headers to include with the request

IncludeSupportFiles property

Summary

Copy support files and links along with the files

Name property

Summary

The new name of the copied file. If not specified, the file will be copied with its original name

OverwriteExisting property

Summary

Whether to overwrite an existing resource. If true, the existing resource will have a new version created with the copied content

PermissionsLocal property

Summary

Update the permissions on the file.

SpaceId property

Summary

The space ID

TargetParentId property

Summary

The target parent ID where the file will be copied to

Download type

Namespace

TrimbleCloud.FileService.Models

Summary

Contains the download URL of a file.

Url property

Summary

The download URL of the file.

DownloadUrlHelper type

Namespace

TrimbleCloud.FileService.Utilities

Summary

Helpers for download URLs returned by the File Service API.

RemoveWildcardFromDownloadUrl(url) method

Summary

Removes a placeholder asterisk from a presigned download URL so HTTP range requests work (for example zip or fileset downloads).

Returns

The URL with the wildcard removed, or the original value if null, empty, or no asterisk is present.

Parameters
NameTypeDescription
urlSystem.StringThe download URL from Download.

EnumConverter`1 type

Namespace

TrimbleCloud.FileService.Models

Summary

Generic converter for enums

ReadJson() method

Summary

Read an enum value from a JSON string

Parameters

This method has no parameters.

EnumHelper`1 type

Namespace

TrimbleCloud.FileService.Utilities

Summary

Helper class for Enum

GetEnumMemberValue() method

Summary

Get the EnumMember value of an Enum

Parameters

This method has no parameters.

Export type

Namespace

TrimbleCloud.FileService.Models

Summary

Represents an Export in File Service.

CreatedAt property

Summary

The date and time when the export was created.

CreatedBy property

Summary

The TRN (Trimble Resource Name) of the user/device/application that created this export.

ExportTrn property

Summary

The TRN (Trimble Resource Name) of the export.

Id property

Summary

The unique identifier of the export.

Output property

Summary

The job output information.

ResourceId property

Summary

The identifier of the target folder to download.

ResourceTrn property

Summary

The TRN (Trimble Resource Name) of the resource.

SpaceId property

Summary

The identifier of the space.

SpaceTrn property

Summary

The TRN (Trimble Resource Name) of the space.

Status property

Summary

The status of the export operation.

UpdatedAt property

Summary

The date and time when the export was last updated.

UpdatedBy property

Summary

The TRN (Trimble Resource Name) of the user/device/application that last updated this export.

File type

Namespace

TrimbleCloud.FileService.Models

Summary

Represents a file in File Service.

Capabilities property

Summary

The actions that can be performed on the resource by the current user.

Checkout property

Summary

The checkout details of the file, if it is checked out.

CreatedBy property

Summary

The TRN (Trimble Resource Name) of the user/device/application that created this file.

Deleted property

Summary

True if the entity has been deleted.

DeletedAt property

Summary

The date and time when the filespace was deleted, if applicable.

Download property

Summary

The download URL of the file.

ExpiresAt property

Summary

The time period when the file object gets automatically removed.

FileSet property

Summary

Whether the object consists of a set of multiple files that should be treated as a single file.

LastMalwareScanDate property

Summary

The date and time of the last malware scan for the file.

Summary

The support file links

Lock property

Summary

The lock details of the file

MD5 property

Summary

MD5 hash of the file.

MalwareScanResult property

Summary

The result of the malware scan for the file. Only applicable when the MalwareScanStatus is INFECTED or CANNOT_SCAN.

MalwareScanStatus property

Summary

The status of the malware scan for the file.

MalwareType property

Summary

The type of malware detected. Only applicable when the MalwareScanStatus is INFECTED. Format is threat type (virus, adware, spyware, pua etc):threat name. For suspicious files the threat type is ‘unknown’.

Metadata property

Summary

Additional information related to the folder.

Multipart property

Summary

True if the client will split the upload into multiple parts.

ParentId property

Summary

The parent folder identifier where the file was created.

ParentTrn property

Summary

The TRN (Trimble Resource Name) of the parent folder.

ParentType property

Summary

The parent type.

Path property

Summary

The path where file is created.

PermissionsEvaluated property

Summary

Permissions evaluated for the actors on the resource. It shows the most permissible role applicable for the actor, considering both the direct and inherited permissions.

PermissionsInherited property

Summary

Permissions inherited from the entire parent hierarchy applicable for the actor.

PermissionsLocal property

Summary

Permissions that are set directly for an actor on the resource itself.

ResourceTrn property

Summary

The TRN (Trimble Resource Name) of the file.

ResponseHeaders property

Summary

Download HTTP response headers.

RestrictedAccess property

Summary

True if the download url of the file should expire as per ExpiresAt property.

Size property

Summary

The size of the file in bytes.

SpaceId property

Summary

The unique identifier for the space where the file is stored.

SpaceTrn property

Summary

The TRN (Trimble Resource Name) of the space where the file is stored.

Statistics property

Summary

The statistics of the file.

UpdatedBy property

Summary

The TRN (Trimble Resource Name) of the user/device/application that last updated this file.

Version property

Summary

The version of the file, represented in a ‘major.minor’ format.

FileAcl type

Namespace

TrimbleCloud.FileService.Models

Summary

Represents the actor role mapping for file resources with version information.

AccessExpiresAt property

Summary

Time when the actor’s access to the resource expires.

Actor property

Summary

The TRN (Trimble Resource Name) of the actor (User/Device/Application).

Role property

Summary

The role assigned to the actor.

Versions property

Summary

List of versions associated with this ACL entry.

FileInputUploadDetails type

Namespace

TrimbleCloud.FileService.Models

Summary

The input file information.

Summary

Whether the support file should be linked to the parent file

ExpiresAt property

Summary

The expiration date of the file.

FileId property

Summary

The unique identifier of the file.

FileSet property

Summary

Whether the object consists of a set of multiple files that should be treated as a single file.

FileTrn property

Summary

The TRN (Trimble Resource Name) of the file.

Metadata property

Summary

Additional information related to the file.

Multipart property

Summary

True if the client will split the upload into multiple parts.

Name property

Summary

The name of the file that was created.

ParentId property

Summary

The parent folder identifier where the file was created.

ParentMajorVersion property

Summary

Parent major version for support files.

ParentTrn property

Summary

The TRN (Trimble Resource Name) of the parent folder where the file was created.

ParentType property

Summary

The parent type.

Path property

Summary

The path where file is created.

PermissionsLocal property

Summary

Permissions that are set directly for an actor on the resource itself.

ResponseHeaders property

Summary

Download HTTP response headers.

RestrictedAccess property

Summary

True if the download url of the file shouldn’t expire.

SpaceId property

Summary

The unique identifier for the space where the file is stored.

SpaceTrn property

Summary

The TRN (Trimble Resource Name) of the space where the file is stored.

Status property

Summary

The status of the file upload.

SupportFileKey property

Summary

The key of the support file

Upload property

Summary

The upload URL and type of upload for the file.

FileOrFolder type

Namespace

TrimbleCloud.FileService.Models

Summary

Represents a file or folder in File Service.

CreatedAt property

Summary

The date and time when the children was created.

CreatedBy property

Summary

The TRN (Trimble Resource Name) of the user/device/application that created.

Deleted property

Summary

True if the entity has been deleted.

DeletedAt property

Summary

The date and time when the filespace was deleted, if applicable.

Id property

Summary

The unique identifier of children. Children can be a file or a folder.

Name property

Summary

The name of the children.

ResourceTrn property

Summary

The Resource Trn of the children

SpaceId property

Summary

The unique identifier for the space where the file/folder is stored.

SpaceTrn property

Summary

The Space Trn for the space

Type property

Summary

The type of the children either it can be file or folder.

UpdatedAt property

Summary

The date and time when the children was last updated.

UpdatedBy property

Summary

The TRN (Trimble Resource Name) of the user/device/application that last updated.

Version property

Summary

The version of the children, represented in a ‘major.minor’ format.

FilePart type

Namespace

TrimbleCloud.FileService.Models

Summary

Represents a part that was uploaded.

ETag property

Summary

Entity tag for the part.

PartNumber property

Summary

The sequence number of the part.

FilePermissionsLocal type

Namespace

TrimbleCloud.FileService.Models

Summary

Represents the permissions explicitly assigned to a file.

Acl property

Summary

The list of actors and their roles.

Remarks

This property is deprecated. Use FileAcl instead, which supports file versions restriction to the acl actor.

FileAcl property

Summary

The list of actors, their roles and versions.

Inherits property

Summary

Specifies if permissions are inherited from the parent folder.

FileServiceClient type

Namespace

TrimbleCloud.FileService

Summary

A client for the Trimble Cloud Platform File Service

#ctor(httpClientProvider) constructor

Summary

Public constructor for File Service client

Parameters
NameTypeDescription
httpClientProviderTrimble.ID.IHttpClientProviderA provider of a pre-configured HttpClient used for API calls made by this client
Exceptions
NameDescription
System.ArgumentNullExceptionThrown when httpClientProvider is null

#ctor(httpClientProvider,clientConfig) constructor

Summary

Public constructor for File Service client

Parameters
NameTypeDescription
httpClientProviderTrimble.ID.IHttpClientProviderA provider of a pre-configured HttpClient used for API calls made by this client
clientConfigTrimbleCloud.FileService.FileServiceClientConfigThe configuration values for the client

#ctor(httpClientProvider,httpMessageHandler) constructor

Summary

Public constructor for File Service client

Parameters
NameTypeDescription
httpClientProviderTrimble.ID.IHttpClientProviderA provider of a pre-configured HttpClient used for API calls made by this client
httpMessageHandlerSystem.Net.Http.HttpMessageHandlerThe HttpMessageHandler to use the custom Http Message handler
Exceptions
NameDescription
System.ArgumentNullExceptionThrown when httpClientProvider is null
System.ArgumentNullExceptionThrown when httpMessageHandler is null

Exports property

Summary

Exports API

Files property

Summary

Files API

Folders property

Summary

Folders API

Jobs property

Summary

Jobs API

ObjectTypes property

Summary

Object Types API

Objects property

Summary

Objects API

Resources property

Summary

Resources API

Spaces property

Summary

Spaces API

_clientConfig property

Summary

Configuration values for the client

_httpClientProvider property

Summary

Provider of a pre-configured HttpClient used for API calls made by this client

FileServiceClientConfig type

Namespace

TrimbleCloud.FileService

Summary

Configuration values for the File Service client

#ctor() constructor

Summary

Public constructor for File Service client configuration

Parameters

This constructor has no parameters.

HttpTimeout property

Summary

The timeout for HTTP requests

Retries property

Summary

The number of times to retry a request if it fails

RetryInterval property

Summary

The interval between retries

FileStatistics type

Namespace

TrimbleCloud.FileService.Models

Summary

Represents the statistics of a file.

DecompressedSize property

Summary

The size of decompressed file in bytes. This field is only applicable for fileset.

SupportFilesCount property

Summary

The count of support files under the main file.

SupportFilesSize property

Summary

The cumulative size of all the latest versions of the support files in bytes.

SupportFilesUpdatedAt property

Summary

The date and time when the support files were last updated.

FileStatus type

Namespace

TrimbleCloud.FileService.Models

Summary

The status of the File upload

Unknown constants

Summary

Unknown status

Uploadable constants

Summary

The file is uploadable

Uploaded constants

Summary

The file has been uploaded

FileUpdate type

Namespace

TrimbleCloud.FileService.Models

Summary

Represents a file update request. Note: Both ReplaceAcl and UpdateAcl cannot be used in the same request.

ExpiresAt property

Summary

Time period when the file object gets automatically removed. Must be at least 1 hour after the current time. Should not exceed 20 years from the current time.

Summary

Update the support file link for the file.

Metadata property

Summary

Update the metadata for the file.

PermissionsLocal property

Summary

Update the permissions on the file.

FileUpdateAcl type

Namespace

TrimbleCloud.FileService.Models

Summary

Represents a request to update file ACL.

Add property

Summary

Add new roles to the existing permissions on the resource. If an actor already has a permission on the resource and is included in the request again, their existing permissions will be replaced with the new ones specified.

Remarks

This property is deprecated. Use AddFileAcl instead, which supports file versions restriction to the acl actor.

AddFileAcl property

Summary

Add new roles with version support to the existing permissions on the resource. If an actor already has a permission on the resource and is included in the request again, their existing permissions will be replaced with the new ones specified.

Remove property

Summary

The actors to be removed from the permissions.

FileUpdatePermissionsLocal type

Namespace

TrimbleCloud.FileService.Models

Summary

Represents a file permissions update request. Note: Both ReplaceAcl and UpdateAcl cannot be used in the same request.

Inherits property

Summary

Specifies if permissions are inherited from the parent folder.

ReplaceAcl property

Summary

Completely replace the existing permissions on the resource. When this field is used, all previous permissions are overwritten by the new ones.

Remarks

This property is deprecated. Use ReplaceFileAcl instead, which supports file versions restriction to the acl actor.

ReplaceFileAcl property

Summary

Completely replace the existing permissions on the resource with file ACL entries that support versions. When this field is used, all previous permissions are overwritten by the new ones.

UpdateAcl property

Summary

Add or remove roles to the existing permissions on the resource.

FileUploadCreate type

Namespace

TrimbleCloud.FileService.Models

Summary

Represents a file creation request.

ExpiresAt property

Summary

Time period when the file object gets automatically removed. Must be at least 1 hour after the current time. Should not exceed 20 years from the current time.

Fileset property

Summary

Whether the object consists of a set of multiple files that should be treated as a single file.

Metadata property

Summary

Additional information related to the file.

Multipart property

Summary

True if the client will split the upload into multiple parts.

Name property

Summary

The name of the file.

ParentId property

Summary

The parent folder identifier to which the file has to be uploaded.

ParentType property

Summary

The parent type.

PermissionsLocal property

Summary

Permissions that are set directly for an actor on the resource itself.

ResponseHeaders property

Summary

Download HTTP response headers.

RestrictedAccess property

Summary

Set to false if the download url of the file shouldn’t be expired. Whereas when true download url expiration takes place according to the configured value.

FilesAPI type

Namespace

TrimbleCloud.FileService

GetDefaultUrlDuration() method

Summary

Gets the default URL duration based on file size. For files larger than 10GB, returns 2 days; otherwise returns 60 minutes.

Parameters

This method has no parameters.

Folder type

Namespace

TrimbleCloud.FileService.Models

Summary

Represents a folder in File Service.

Capabilities property

Summary

The actions that can be performed on the resource by the current user.

Checkout property

Summary

The checkout details of the folder, if it is checked out.

CreatedBy property

Summary

The TRN (Trimble Resource Name) of the user/device/application that created this filespace.

Deleted property

Summary

True if the entity has been deleted.

DeletedAt property

Summary

The date and time when the filespace was deleted, if applicable.

Metadata property

Summary

Additional information related to the folder.

ParentId property

Summary

Folder identifier of the parent folder.

ParentTrn property

Summary

The TRN (Trimble Resource Name) of the parent folder.

Path property

Summary

The path of the folder.

PermissionsEvaluated property

Summary

Permissions evaluated for the actors on the resource. It shows the most permissible role applicable for the actor, considering both the direct and inherited permissions.

PermissionsInherited property

Summary

Permissions inherited from the entire parent hierarchy applicable for the actor.

PermissionsLocal property

Summary

Permissions that are set directly for an actor on the resource itself.

ResourceTrn property

Summary

The TRN (Trimble Resource Name) of the folder.

Size property

Summary

The size of the folder in bytes.

SpaceId property

Summary

The unique identifier of the space where the folder is stored.

SpaceTrn property

Summary

The TRN (Trimble Resource Name) of the space where the folder is stored.

Statistics property

Summary

The statistics of the folder.

UpdatedBy property

Summary

The TRN (Trimble Resource Name) of the user/device/application that last updated this filespace.

Version property

Summary

The folder version.

FolderCreate type

Namespace

TrimbleCloud.FileService.Models

Summary

Represents a folder creation request.

Metadata property

Summary

Additional information related to the folder.

Name property

Summary

The name of the folder.

ParentId property

Summary

The identifier of the parent.

PermissionsLocal property

Summary

Permissions that are set directly for an actor on the resource itself.

FolderCreateChild type

Namespace

TrimbleCloud.FileService.Models

Summary

Create child folder request

Children property

Summary

List of nested child folders to create within this folder

Metadata property

Summary

Metadata associated with the folder

Name property

Summary

Name of the child folder to create

PermissionsLocal property

Summary

The permissions for the folder

FolderCreateWithChildren type

Namespace

TrimbleCloud.FileService.Models

Summary

Create parent folder request

Children property

Summary

List of nested child folders to create within this folder

FolderListChildrenRequest type

Namespace

TrimbleCloud.FileService.Models

Summary

Request object for listing children of a folder. Either FolderId or Path must be specified, but not both.

FilterCriteria property

Summary

The filter criteria to apply to the list. Use FolderListFilterCriteria to filter by resource type.

FolderId property

Summary

The folder ID to list children from. Either FolderId or Path must be specified, but not both.

MaxItems property

Summary

The number of items to return in each page (1-1000). Default is 100.

NextPageToken property

Summary

The token to retrieve the next page of items

Path property

Summary

The folder path to list children from. Either FolderId or Path must be specified, but not both.

Recursive property

Summary

Whether to recursively list children of all subfolders. Default is false.

SortBy property

Summary

The field to sort results by

SortOrder property

Summary

The sort order (asc or desc)

SpaceId property

Summary

The space ID

FolderListFilterCriteria type

Namespace

TrimbleCloud.FileService.Models

Summary

Criteria for filtering a list of files

ResourceType property

Summary

Gets or sets the type of the Resource to filter by.

Status property

Summary

Gets or sets the folder status.

UrlDuration property

Summary

Gets or sets the file URL duration.

FolderPermissionsLocal type

Namespace

TrimbleCloud.FileService.Models

Summary

Represents the permissions explicitly assigned to a folder.

Acl property

Summary

The list of actors and their roles.

Inherits property

Summary

Specifies if permissions are inherited from the parent folder.

FolderStatistics type

Namespace

TrimbleCloud.FileService.Models

Summary

Represents the statistics of a folder.

ContentsUpdatedAt property

Summary

The date and time when the contents of the folder were last updated.

ImmediateFilesCount property

Summary

The count of files directly under the folder.

ImmediateFoldersCount property

Summary

The count of folders directly under the folder.

SupportFilesSize property

Summary

The cumulative size of all the latest versions of the support files in bytes.

FolderUpdate type

Namespace

TrimbleCloud.FileService.Models

Summary

Represents a folder update request. Note: Both ReplaceAcl and UpdateAcl cannot be used in the same request.

Metadata property

Summary

Update the metadata for the folder.

PermissionsLocal property

Summary

Update the permissions on the folder.

FolderUpdateAcl type

Namespace

TrimbleCloud.FileService.Models

Summary

Represents a request to update folder ACL.

Add property

Summary

Add new roles to the existing permissions on the resource. If an actor already has a permission on the resource and is included in the request again, their existing permissions will be replaced with the new ones specified.

Remove property

Summary

The actors to be removed from the permissions.

FolderUpdatePermissionsLocal type

Namespace

TrimbleCloud.FileService.Models

Summary

Represents a folder permissions update request. Note: Both ReplaceAcl and UpdateAcl cannot be used in the same request.

Inherits property

Summary

Specifies if permissions are inherited from the parent folder.

ReplaceAcl property

Summary

Completely replace the existing permissions on the resource. When this field is used, all previous permissions are overwritten by the new ones.

UpdateAcl property

Summary

Add or remove roles to the existing permissions on the resource.

GetJobQueryParams type

Namespace

TrimbleCloud.FileService.Models

Summary

Query parameters for retrieving job details in File Service.

FastCheck property

Summary

Optimize internal polling frequency. Effective only if longpoll is true

LongPoll property

Summary

Performs a long-polling request for the status

GetObjectParams type

Namespace

TrimbleCloud.FileService.Models

Summary

Parameters for getting an object.

Status property

Summary

The status filter for the object.

GetQueryParameters() method

Summary

Gets query parameters for the request.

Returns

Dictionary of query parameters

Parameters

This method has no parameters.

GetObjectVersionParams type

Namespace

TrimbleCloud.FileService.Models

Summary

Parameters for getting a specific object version.

Status property

Summary

The status filter for the object.

GetQueryParameters() method

Summary

Gets query parameters for the request.

Returns

Dictionary of query parameters

Parameters

This method has no parameters.

GetUploadDetailsQueryParams type

Namespace

TrimbleCloud.FileService.Models

Summary

The query parameters for retrieving upload details.

FastCheck property

Summary

Optimize internal polling frequency. Effective only if longpoll is true

LongPoll property

Summary

Performs a long-polling request for the status

UrlDuration property

Summary

Gets or sets the file URL duration.

HttpClientResponse type

Namespace

TrimbleCloud.FileService

Summary

HTTP client response implementation for the common Response class

#ctor(requestId,responseMessage) constructor

Summary

Initializes a new instance of the HttpClientResponse class

Parameters
NameTypeDescription
requestIdSystem.StringThe request ID
responseMessageSystem.Net.Http.HttpResponseMessageThe HTTP response message

ContentLength property

Summary

Gets the content length of the response

IsError property

Summary

Gets a value indicating whether this response represents an error

Metadata property

Summary

Gets the response headers as metadata

ReasonPhrase property

Summary

Gets the HTTP reason phrase

RequestId property

Summary

Gets or sets the request ID

Status property

Summary

Gets the HTTP status code

Dispose() method

Summary

Disposes the response and underlying resources

Parameters

This method has no parameters.

Dispose(disposing) method

Summary

Disposes the underlying HTTP response message

Parameters
NameTypeDescription
disposingSystem.BooleanTrue if called from Dispose(), false if called from finalizer

ToString() method

Summary

Returns the string representation of the HTTP response

Returns

String representation of the response

Parameters

This method has no parameters.

IExportsAPI type

Namespace

TrimbleCloud.FileService

Summary

Interface for the Exports API

Create(spaceId,folderId,includeTopLevel) method

Summary

Start a job to download and zip all children of a folder into a single file

Returns

A Task that resolves to Guid of the export

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
folderIdSystem.GuidThe folder ID
includeTopLevelSystem.Boolean

Get(spaceId,exportId,urlDuration) method

Summary

Get an export by ID

Returns

A Task that resolves to Response that contains Export data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
exportIdSystem.GuidThe export ID
urlDurationSystem.Nullable{System.TimeSpan}The export download URL’s validity duration. Minimum value is 5 minutes and maximum value is 7 days.

IFileServiceClient type

Namespace

TrimbleCloud.FileService

Summary

Interface for the Trimble Cloud Platform File Service Client

Exports property

Summary

Exports API

Files property

Summary

Files API

Folders property

Summary

Folders API

Jobs property

Summary

Jobs API

ObjectTypes property

Summary

Object Types API

Objects property

Summary

Objects API

Resources property

Summary

Resources API

Spaces property

Summary

Spaces API

IFilesAPI type

Namespace

TrimbleCloud.FileService

Summary

Interface for the Files API

CheckInFile(spaceId,fileId) method

Summary

Checking in a file will allow other actors to create a new version or perform other mutation operations

Returns
Parameters
NameTypeDescription
spaceIdSystem.Guid
fileIdSystem.Guid

CheckInFileWithMinimalResponse(spaceId,fileId) method

Summary

Checkin a file with minimal response

Returns
Parameters
NameTypeDescription
spaceIdSystem.Guid
fileIdSystem.Guid

CheckOutFile(spaceId,fileId,reason,headers) method

Summary

Checking out a file will prevent other actors from creating a new version or other mutation operations

Returns
Parameters
NameTypeDescription
spaceIdSystem.Guid
fileIdSystem.Guid
reasonSystem.String
headersSystem.Collections.Generic.IDictionary{System.String,System.String}

CheckOutFileWithMinimalResponse(spaceId,fileId,reason,headers) method

Summary

Checkout a file with minimal response

Returns
Parameters
NameTypeDescription
spaceIdSystem.Guid
fileIdSystem.Guid
reasonSystem.String
headersSystem.Collections.Generic.IDictionary{System.String,System.String}

CompleteMultipartUpload(spaceId,uploadId,parts) method

Summary

Mark the multipart file upload status to be completed

Returns

A Task that resolves to Response that contains UploadDetails data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
uploadIdSystem.GuidThe upload ID
partsSystem.Collections.Generic.IEnumerable{TrimbleCloud.FileService.Models.FilePart}List of parts that are uploaded

Copy(spaceId,fileId,targetParentId,name,includeSupportFiles,overwriteExisting) method

Summary

Copy a file to a new location within the same space

Returns

A Task that resolves to the a Tuple of Response of File data and possible JobId on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
fileIdSystem.GuidThe file ID
targetParentIdSystem.GuidThe target parent ID
nameSystem.StringThe new name of the copied file. If not specified, the file will be copied with its original name
includeSupportFilesSystem.BooleanCopy support files and links along with the files
overwriteExistingSystem.BooleanWhether to overwrite an existing resource. If true, the existing resource will have a new version created with the copied content

Copy(copyFileRequest) method

Summary

Copy a file to a new location within the same space

Returns
Parameters
NameTypeDescription
copyFileRequestTrimbleCloud.FileService.Models.CopyFileRequest

CopyWithMinimalResponse(spaceId,fileId,targetParentId,name,includeSupportFiles,overwriteExisting) method

Summary

Copy a file to a new location within the same space and get minimal response

Returns

A Task that resolves to the a Tuple of Response of MinimalFile data and possible JobId on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
fileIdSystem.GuidThe file ID
targetParentIdSystem.GuidThe target parent ID
nameSystem.StringThe new name of the copied file. If not specified, the file will be copied with its original name
includeSupportFilesSystem.BooleanCopy support files and links along with the file
overwriteExistingSystem.BooleanWhether to overwrite an existing resource. If true, the existing resource will have a new version created with the copied content

CopyWithMinimalResponse(copyFileRequest) method

Summary

Copy a file to a new location within the same space and get minimal response

Returns
Parameters
NameTypeDescription
copyFileRequestTrimbleCloud.FileService.Models.CopyFileRequest

Summary

Create a file upload

Returns

A Task that resolves to Response that contains UploadDetails data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
fileTrimbleCloud.FileService.Models.FileUploadCreateThe information of the file to create
urlDurationSystem.Nullable{System.TimeSpan}The file upload URL’s validity duration. Minimum value is 5 minutes and maximum value is 7 days. Default = 60 minutes
includeLinksSystem.BooleanWhether to include the links from the last version during a parent file’s major version change.

Summary

Create a file upload with custom headers

Returns

A Task that resolves to Response that contains UploadDetails data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
fileTrimbleCloud.FileService.Models.FileUploadCreateThe information of the file to create
headersSystem.Collections.Generic.IDictionary{System.String,System.String}Dictionary of custom headers
urlDurationSystem.Nullable{System.TimeSpan}The file upload URL’s validity duration. Minimum value is 5 minutes and maximum value is 7 days. Default = 60 minutes
includeLinksSystem.BooleanWhether to include the links from the last version during a parent file’s major version change.

Summary

Create or update support file links of a file

Returns

A Task that resolves to Response that contains File data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
fileIdSystem.GuidThe file ID
fileMajorVersionSystem.Int32The major version of the file
linksSystem.Collections.Generic.IDictionary{System.String,TrimbleCloud.FileService.Models.SupportFileLink}The links to create or update as dictionary of key and SupportFileLink

Summary

Create or update support file links of a file and get minimal response

Returns

A Task that resolves to Response that contains MinimalFile data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
fileIdSystem.GuidThe file ID
fileMajorVersionSystem.Int32The major version of the file
linksSystem.Collections.Generic.IDictionary{System.String,TrimbleCloud.FileService.Models.SupportFileLink}The links to create or update as dictionary of key and SupportFileLink

CreatePackageUpload(spaceId,packageUpload,urlDuration) method

Summary

Create a package upload

Returns

A Task that resolves to Response that contains UploadDetails data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
packageUploadTrimbleCloud.FileService.Models.PackageUploadCreateThe information of the package upload to create
urlDurationSystem.Nullable{System.TimeSpan}The package upload URL’s validity duration. Minimum value is 5 minutes and maximum value is 7 days. Default = 60 minutes

CreatePackageUpload(spaceId,packageUpload,headers,urlDuration) method

Summary

Create a package upload with custom headers

Returns

A Task that resolves to Response that contains UploadDetails data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
packageUploadTrimbleCloud.FileService.Models.PackageUploadCreateThe information of the package upload to create
headersSystem.Collections.Generic.IDictionary{System.String,System.String}Dictionary of custom headers
urlDurationSystem.Nullable{System.TimeSpan}The package upload URL’s validity duration. Minimum value is 5 minutes and maximum value is 7 days. Default = 60 minutes

CreateSupportFileUpload(spaceId,supportFile,urlDuration) method

Summary

Create a support file upload

Returns

A Task that resolves to Response that contains UploadDetails data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
supportFileTrimbleCloud.FileService.Models.SupportFileUploadCreateThe information of the support file to create
urlDurationSystem.Nullable{System.TimeSpan}The support file’s upload URL’s validity duration. Minimum value is 5 minutes and maximum value is 7 days. Default = 60 minutes

CreateSupportFileUpload(spaceId,supportFile,headers,urlDuration) method

Summary

Create a support file upload with custom headers

Returns

A Task that resolves to Response that contains UploadDetails data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
supportFileTrimbleCloud.FileService.Models.SupportFileUploadCreateThe information of the support file to create
headersSystem.Collections.Generic.IDictionary{System.String,System.String}Dictionary of custom headers
urlDurationSystem.Nullable{System.TimeSpan}The support file’s upload URL’s validity duration. Minimum value is 5 minutes and maximum value is 7 days. Default = 60 minutes

Delete(spaceId,fileId,permanent) method

Summary

Delete a file

Returns

A Task that resolves to possible JobId on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
fileIdSystem.GuidThe file ID
permanentSystem.BooleanPermanently delete the file

Delete(spaceId,fileId,headers,permanent) method

Summary

Delete a file with custom headers

Returns

A Task that resolves to possible JobId on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
fileIdSystem.GuidThe file ID
headersSystem.Collections.Generic.IDictionary{System.String,System.String}Dictionary of custom headers
permanentSystem.BooleanPermanently delete the file

Download(spaceId,fileId,stream,chunkSize,maxConcurrentRequests) method

Summary

Downloads a file given the file ID

Returns

A Task that resolves to completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
fileIdSystem.GuidThe file ID
streamSystem.IO.StreamThe stream to write content to
chunkSizeSystem.Int32The size of the chunks in bytes if provided; otherwise 15MB chunks are used
maxConcurrentRequestsSystem.Int32The number of concurrent download tasks if provided; otherwise 8 tasks are used

Download(spaceId,path,stream,chunkSize,maxConcurrentRequests) method

Summary

Downloads a file given the file path

Returns

A Task that resolves to completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
pathSystem.StringThe file path
streamSystem.IO.StreamThe stream to write content to
chunkSizeSystem.Int32The size of the chunks in bytes if provided; otherwise 15MB chunks are used
maxConcurrentRequestsSystem.Int32The number of concurrent download tasks if provided; otherwise 8 tasks are used

Download(spaceId,fileId,stream,urlDuration,transferConfiguration) method

Summary

Downloads a file given the file ID with custom URL duration

Returns

A Task that resolves to completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
fileIdSystem.GuidThe file ID
streamSystem.IO.StreamThe stream to write content to
urlDurationSystem.Nullable{System.TimeSpan}The file download URL’s validity duration. Minimum value is 5 minutes and maximum value is 7 days. Default = 60 minutes
transferConfigurationTrimbleCloud.FileService.Models.TransferFileConfigurationChunk size and concurrency for the transfer.

Download(spaceId,path,stream,urlDuration,transferConfiguration) method

Summary

Downloads a file given the file path with custom URL duration

Returns

A Task that resolves to completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
pathSystem.StringThe file path
streamSystem.IO.StreamThe stream to write content to
urlDurationSystem.Nullable{System.TimeSpan}The file download URL’s validity duration. Minimum value is 5 minutes and maximum value is 7 days. Default = 60 minutes
transferConfigurationTrimbleCloud.FileService.Models.TransferFileConfigurationChunk size and concurrency for the transfer.

Get(spaceId,fileId,status,urlDuration,responseContentType) method

Summary

Get a file given the file ID

Returns

A Task that resolves to Response that contains File data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
fileIdSystem.GuidThe file ID
statusTrimbleCloud.FileService.Models.ResourceStatusThe status of the file
urlDurationSystem.Nullable{System.TimeSpan}The file download URL’s validity duration. Minimum value is 5 minutes and maximum value is 7 days. Default = 60 minutes
responseContentTypeSystem.StringSpecify the content type of the response. It overrides the file settings for the response content type which is given when creating the file.

Get(spaceId,path,status,urlDuration,responseContentType) method

Summary

Get a file given the file path

Returns

A Task that resolves to Response that contains File data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
pathSystem.StringThe file path
statusTrimbleCloud.FileService.Models.ResourceStatusThe status of the file
urlDurationSystem.Nullable{System.TimeSpan}The file download URL’s validity duration. Minimum value is 5 minutes and maximum value is 7 days. Default = 60 minutes
responseContentTypeSystem.StringSpecify the content type of the response. It overrides the file settings for the response content type which is given when creating the file.

GetUploadDetails(spaceId,uploadId,urlDuration) method

Summary

Get details of the upload

Returns

A Task that resolves to Response that contains UploadDetails data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
uploadIdSystem.GuidThe upload ID
urlDurationSystem.Nullable{System.TimeSpan}The file upload URL’s validity duration. Minimum value is 5 minutes and maximum value is 7 days. Default = 60 minutes

GetUploadDetails(spaceId,uploadId,queryParams) method

Summary

Get details of the upload

Returns
Parameters
NameTypeDescription
spaceIdSystem.Guid
uploadIdSystem.Guid
queryParamsTrimbleCloud.FileService.Models.GetUploadDetailsQueryParams

GetVersion(spaceId,fileId,versionId,status,urlDuration,responseContentType) method

Summary

Get file version details given the file ID

Returns

A Task that resolves to Response that contains File data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
fileIdSystem.GuidThe file ID
versionIdSystem.StringThe version ID
statusTrimbleCloud.FileService.Models.ResourceStatusThe status of the file
urlDurationSystem.Nullable{System.TimeSpan}The file download URL’s validity duration. Minimum value is 5 minutes and maximum value is 7 days. Default = 60 minutes
responseContentTypeSystem.StringSpecify the content type of the response. It overrides the file settings for the response content type which is given when creating the file.

GetVersion(spaceId,path,versionId,status,urlDuration,responseContentType) method

Summary

Get file version details given the file path

Returns

A Task that resolves to Response that contains File data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
pathSystem.StringThe file path
versionIdSystem.StringThe version ID
statusTrimbleCloud.FileService.Models.ResourceStatusThe status of the file
urlDurationSystem.Nullable{System.TimeSpan}The file download URL’s validity duration. Minimum value is 5 minutes and maximum value is 7 days. Default = 60 minutes
responseContentTypeSystem.StringSpecify the content type of the response. It overrides the file settings for the response content type which is given when creating the file.

GetVersionWithMinimalResponse(spaceId,fileId,versionId,status,urlDuration,responseContentType) method

Summary

Get file version details given the file ID with minimal response

Returns

A Task that resolves to Response that contains MinimalFile data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
fileIdSystem.GuidThe file ID
versionIdSystem.StringThe version ID
statusTrimbleCloud.FileService.Models.ResourceStatusThe status of the file
urlDurationSystem.Nullable{System.TimeSpan}The file download URL’s validity duration. Minimum value is 5 minutes and maximum value is 7 days. Default = 60 minutes
responseContentTypeSystem.StringSpecify the content type of the response. It overrides the file settings for the response content type which is given when creating the file.

GetVersionWithMinimalResponse(spaceId,path,versionId,status,urlDuration,responseContentType) method

Summary

Get file version details given the file path with minimal response

Returns

A Task that resolves to Response that contains MinimalFile data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
pathSystem.StringThe file path
versionIdSystem.StringThe version ID
statusTrimbleCloud.FileService.Models.ResourceStatusThe status of the file
urlDurationSystem.Nullable{System.TimeSpan}The file download URL’s validity duration. Minimum value is 5 minutes and maximum value is 7 days. Default = 60 minutes
responseContentTypeSystem.StringSpecify the content type of the response. It overrides the file settings for the response content type which is given when creating the file.

GetWithMinimalResponse(spaceId,fileId,status,urlDuration,responseContentType) method

Summary

Get a file given the file ID with minimal response

Returns

A Task that resolves to Response that contains MinimalFile data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
fileIdSystem.GuidThe file ID
statusTrimbleCloud.FileService.Models.ResourceStatusThe status of the file
urlDurationSystem.Nullable{System.TimeSpan}The file download URL’s validity duration. Minimum value is 5 minutes and maximum value is 7 days. Default = 60 minutes
responseContentTypeSystem.StringSpecify the content type of the response. It overrides the file settings for the response content type which is given when creating the file.

GetWithMinimalResponse(spaceId,path,status,urlDuration,responseContentType) method

Summary

Get a file given the file path with minimal response

Returns

A Task that resolves to Response that contains MinimalFile data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
pathSystem.StringThe file path
statusTrimbleCloud.FileService.Models.ResourceStatusThe status of the file
urlDurationSystem.Nullable{System.TimeSpan}The file download URL’s validity duration. Minimum value is 5 minutes and maximum value is 7 days. Default = 60 minutes
responseContentTypeSystem.StringSpecify the content type of the response. It overrides the file settings for the response content type which is given when creating the file.

ListManifestFiles(spaceId,fileId,nextPageToken,maxItems,urlDuration) method

Summary

Lists all files from inside the unpacked fileset.

Returns
Parameters
NameTypeDescription
spaceIdSystem.Guid
fileIdSystem.Guid
nextPageTokenSystem.String
maxItemsSystem.Int32
urlDurationSystem.Nullable{System.TimeSpan}

ListSupportFiles(spaceId,fileId,nextPageToken,maxItems,listFilter) method

Summary

List all support files for a file given the file ID

Returns

A Task that resolves to IPage`1 that contains File data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
fileIdSystem.GuidThe file ID
nextPageTokenSystem.StringThe token to retrieve the next page of items
maxItemsSystem.Int32The number of items to return in each page
listFilterTrimbleCloud.FileService.Models.ListFilterCriteriaThe filter to apply to the list

ListSupportFiles(spaceId,path,nextPageToken,maxItems,listFilter) method

Summary

List all support files for a file given the file path

Returns

A Task that resolves toIPage`1 that contains File data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
pathSystem.StringThe file path
nextPageTokenSystem.StringThe token to retrieve the next page of items
maxItemsSystem.Int32The number of items to return in each page
listFilterTrimbleCloud.FileService.Models.ListFilterCriteriaThe filter to apply to the list

ListSupportFilesWithMinimalResponse(spaceId,fileId,nextPageToken,maxItems,listFilter) method

Summary

List all support files for a file given the file ID with minimal response

Returns

A Task that resolves to IPage`1 that contains MinimalFile data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
fileIdSystem.GuidThe file ID
nextPageTokenSystem.StringThe token to retrieve the next page of items
maxItemsSystem.Int32The number of items to return in each page
listFilterTrimbleCloud.FileService.Models.ListFilterCriteriaThe filter to apply to the list

ListSupportFilesWithMinimalResponse(spaceId,path,nextPageToken,maxItems,listFilter) method

Summary

List all support files for a file given the file path with minimal response

Returns

A Task that resolves toIPage`1 that contains MinimalFile data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
pathSystem.StringThe file path
nextPageTokenSystem.StringThe token to retrieve the next page of items
maxItemsSystem.Int32The number of items to return in each page
listFilterTrimbleCloud.FileService.Models.ListFilterCriteriaThe filter to apply to the list

ListVersions(spaceId,fileId,nextPageToken,maxItems,listFilter) method

Summary

List all versions for a file given the file ID

Returns

A Task that resolves to IPage`1 that contains File data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
fileIdSystem.GuidThe file ID
nextPageTokenSystem.StringThe token to retrieve the next page of items
maxItemsSystem.Int32The number of items to return in each page
listFilterTrimbleCloud.FileService.Models.ListFilterCriteriaThe filter to apply to the list

ListVersions(spaceId,path,nextPageToken,maxItems,listFilter) method

Summary

List all versions for a file given the file path

Returns

A Task that resolves to IPage that contains File data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
pathSystem.StringThe file path
nextPageTokenSystem.StringThe token to retrieve the next page of items
maxItemsSystem.Int32The number of items to return in each page
listFilterTrimbleCloud.FileService.Models.ListFilterCriteriaThe filter to apply to the list

ListVersionsWithMinimalResponse(spaceId,fileId,nextPageToken,maxItems,listFilter) method

Summary

List all versions for a file given the file ID with minimal response

Returns

A Task that resolves to IPage`1 that contains MinimalFile data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
fileIdSystem.GuidThe file ID
nextPageTokenSystem.StringThe token to retrieve the next page of items
maxItemsSystem.Int32The number of items to return in each page
listFilterTrimbleCloud.FileService.Models.ListFilterCriteriaThe filter to apply to the list

ListVersionsWithMinimalResponse(spaceId,path,nextPageToken,maxItems,listFilter) method

Summary

List all versions for a file given the file with minimal response

Returns

A Task that resolves to IPage that contains MinimalFile data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
pathSystem.StringThe file path
nextPageTokenSystem.StringThe token to retrieve the next page of items
maxItemsSystem.Int32The number of items to return in each page
listFilterTrimbleCloud.FileService.Models.ListFilterCriteriaThe filter to apply to the list

Lock(spaceId,fileId,reason) method

Summary

Lock a file

Returns

A Task that resolves to Response that contains File data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
fileIdSystem.GuidThe file ID
reasonSystem.StringReason for locking the file

Lock(spaceId,fileId,headers,reason) method

Summary

Lock a file with custom headers

Returns

A Task that resolves to Response that contains File data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
fileIdSystem.GuidThe file ID
headersSystem.Collections.Generic.IDictionary{System.String,System.String}Dictionary of custom headers
reasonSystem.StringReason for locking the file

LockWithMinimalResponse(spaceId,fileId,reason) method

Summary

Lock a file and get minimal response

Returns

A Task that resolves to Response that contains MinimalFile data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
fileIdSystem.GuidThe file ID
reasonSystem.StringReason for locking the file

LockWithMinimalResponse(spaceId,fileId,headers,reason) method

Summary

Lock a file and get minimal response with custom headers

Returns

A Task that resolves to Response that contains MinimalFile data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
fileIdSystem.GuidThe file ID
headersSystem.Collections.Generic.IDictionary{System.String,System.String}Dictionary of custom headers
reasonSystem.StringReason for locking the file

Move(spaceId,fileId,targetParentId,name) method

Summary

Move a file to a new location within the same space

Returns

A Task that resolves to Response that contains File data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
fileIdSystem.GuidThe file ID
targetParentIdSystem.GuidThe target parent ID
nameSystem.StringThe new name of the file. If not specified, the file will be moved with its original name

Move(spaceId,fileId,targetParentId,headers,name) method

Summary

Move a file to a new location within the same space with custom headers

Returns

A Task that resolves to Response that contains File data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
fileIdSystem.GuidThe file ID
targetParentIdSystem.GuidThe target parent ID
headersSystem.Collections.Generic.IDictionary{System.String,System.String}Dictionary of custom headers
nameSystem.StringThe new name of the file. If not specified, the file will be moved with its original name

MoveWithMinimalResponse(spaceId,fileId,targetParentId,name) method

Summary

Move a file to a new location within the same space and get minimal response

Returns

A Task that resolves to Response that contains MinimalFile data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
fileIdSystem.GuidThe file ID
targetParentIdSystem.GuidThe target parent ID
nameSystem.StringThe new name of the file. If not specified, the file will be moved with its original name

MoveWithMinimalResponse(spaceId,fileId,targetParentId,headers,name) method

Summary

Move a file to a new location within the same space and get minimal response with custom headers

Returns

A Task that resolves to Response that contains MinimalFile data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
fileIdSystem.GuidThe file ID
targetParentIdSystem.GuidThe target parent ID
headersSystem.Collections.Generic.IDictionary{System.String,System.String}Dictionary of custom headers
nameSystem.StringThe new name of the file. If not specified, the file will be moved with its original name

PollForMalwareScanCompletion(spaceId,fileId,timeout,interval,callback) method

Summary

Poll for malware scan completion

Returns

A Task that resolves to completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
fileIdSystem.GuidThe file ID
timeoutSystem.Nullable{System.TimeSpan}The maximum time to listen for the malware scan. Default is 3 minutes
intervalSystem.Nullable{System.TimeSpan}The time interval to poll the malware scan status. Default is 5 seconds
callbackSystem.Action{System.Nullable{TrimbleCloud.FileService.Models.MalwareScanStatus}}The callback to be called after each check

Rename(spaceId,fileId,name) method

Summary

Rename a file with a new name

Returns

A Task that resolves to Response that contains File data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
fileIdSystem.GuidThe file ID
nameSystem.StringThe new name of the file

Rename(spaceId,fileId,name,headers) method

Summary

Rename a file with a new name with custom headers

Returns

A Task that resolves to Response that contains File data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
fileIdSystem.GuidThe file ID
nameSystem.StringThe new name of the file
headersSystem.Collections.Generic.IDictionary{System.String,System.String}Dictionary of custom headers

RenameWithMinimalResponse(spaceId,fileId,name) method

Summary

Rename a file with a new name and get minimal response

Returns

A Task that resolves to Response that contains MinimalFile data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
fileIdSystem.GuidThe file ID
nameSystem.StringThe new name of the file

RenameWithMinimalResponse(spaceId,fileId,name,headers) method

Summary

Rename a file with a new name and get minimal response with custom headers

Returns

A Task that resolves to Response that contains MinimalFile data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
fileIdSystem.GuidThe file ID
nameSystem.StringThe new name of the file
headersSystem.Collections.Generic.IDictionary{System.String,System.String}Dictionary of custom headers

Restore(spaceId,fileId,name,targetParentId) method

Summary

Restore a file and any support files linked to it from the deleted state

Returns

A Task that resolves to the a Tuple of Response of File data and possible JobId on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
fileIdSystem.GuidThe file ID
nameSystem.StringThe new name of the restored file. If not specified, the file will be restored with its original name
targetParentIdSystem.Nullable{System.Guid}The target parent ID to restore the file to. If not specified, the file will be restored to its original location

Restore(spaceId,fileId,headers,name,targetParentId) method

Summary

Restore a file and any support files linked to it from the deleted state with custom headers

Returns

A Task that resolves to the a Tuple of Response of File data and possible JobId on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
fileIdSystem.GuidThe file ID
headersSystem.Collections.Generic.IDictionary{System.String,System.String}Dictionary of custom headers
nameSystem.StringThe new name of the restored file. If not specified, the file will be restored with its original name
targetParentIdSystem.Nullable{System.Guid}The target parent ID to restore the file to. If not specified, the file will be restored to its original location

RestoreWithMinimalResponse(spaceId,fileId,name,targetParentId) method

Summary

Restore a file and any support files linked to it from the deleted state and get minimal response

Returns

A Task that resolves to the a Tuple of Response of MinimalFile data and possible JobId on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
fileIdSystem.GuidThe file ID
nameSystem.StringThe new name of the restored file. If not specified, the file will be restored with its original name
targetParentIdSystem.Nullable{System.Guid}The target parent ID to restore the file to. If not specified, the file will be restored to its original location

RestoreWithMinimalResponse(spaceId,fileId,headers,name,targetParentId) method

Summary

Restore a file and any support files linked to it from the deleted state and get minimal response with custom headers

Returns

A Task that resolves to the a Tuple of Response of MinimalFile data and possible JobId on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
fileIdSystem.GuidThe file ID
headersSystem.Collections.Generic.IDictionary{System.String,System.String}Dictionary of custom headers
nameSystem.StringThe new name of the restored file. If not specified, the file will be restored with its original name
targetParentIdSystem.Nullable{System.Guid}The target parent ID to restore the file to. If not specified, the file will be restored to its original location

Unlock(spaceId,fileId) method

Summary

Unlock a file

Returns

A Task that resolves to Response that contains File data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
fileIdSystem.GuidThe file ID

UnlockWithMinimalResponse(spaceId,fileId) method

Summary

Unlock a file and get minimal response

Returns

A Task that resolves to Response that contains MinimalFile data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
fileIdSystem.GuidThe file ID

Update(spaceId,fileId,file) method

Summary

Update a file given the file ID

Returns

A Task that resolves to Response that contains File data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
fileIdSystem.GuidThe file ID
fileTrimbleCloud.FileService.Models.FileUpdateThe file information to update

Update(spaceId,fileId,file,headers) method

Summary

Update a file given the file ID with custom headers

Returns

A Task that resolves to Response that contains File data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
fileIdSystem.GuidThe file ID
fileTrimbleCloud.FileService.Models.FileUpdateThe file information to update
headersSystem.Collections.Generic.IDictionary{System.String,System.String}Dictionary of custom headers

UpdateWithMinimalResponse(spaceId,fileId,file) method

Summary

Update a file given the file ID and get minimal response

Returns

A Task that resolves to Response that contains MinimalFile data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
fileIdSystem.GuidThe file ID
fileTrimbleCloud.FileService.Models.FileUpdateThe file information to update

UpdateWithMinimalResponse(spaceId,fileId,file,headers) method

Summary

Update a file given the file ID and get minimal response with custom headers

Returns

A Task that resolves to Response that contains MinimalFile data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
fileIdSystem.GuidThe file ID
fileTrimbleCloud.FileService.Models.FileUpdateThe file information to update
headersSystem.Collections.Generic.IDictionary{System.String,System.String}Dictionary of custom headers

Upload(request,chunkSize,maxConcurrentRequests) method

Summary

Upload a file

Returns

A Task that resolves to completion

Parameters
NameTypeDescription
requestTrimbleCloud.FileService.Models.UploadRequestThe upload request
chunkSizeSystem.Int32The size of the chunks in bytes if provided; otherwise 15MB chunks are used
maxConcurrentRequestsSystem.Int32The number of concurrent upload tasks if provided; otherwise 8 tasks are used

Upload(request,chunkSize,maxConcurrentRequests) method

Summary

Upload a package

Returns

A Task that resolves to completion

Parameters
NameTypeDescription
requestTrimbleCloud.FileService.Models.PackageUploadRequestThe package upload request
chunkSizeSystem.Int32The size of the chunks in bytes if provided; otherwise 15MB chunks are used
maxConcurrentRequestsSystem.Int32The number of concurrent upload tasks if provided; otherwise 8 tasks are used

Upload(uploadDetails,stream,transferConfiguration) method

Summary

Upload a file using pre-fetched upload details

Returns

A Task that resolves to completion

Parameters
NameTypeDescription
uploadDetailsTrimbleCloud.FileService.Models.UploadDetailsThe pre-fetched upload details
streamSystem.IO.StreamThe file stream to upload
transferConfigurationTrimbleCloud.FileService.Models.TransferFileConfigurationChunk size and concurrency for the transfer.

Upload(uploadDetails,mainFileStream,supportFiles,transferConfiguration) method

Summary

Upload a package using pre-fetched upload details

Returns

A Task that resolves to completion

Parameters
NameTypeDescription
uploadDetailsTrimbleCloud.FileService.Models.UploadDetailsThe pre-fetched upload details
mainFileStreamSystem.IO.StreamThe main file stream to upload
supportFilesSystem.Collections.Generic.IList{TrimbleCloud.FileService.Models.SupportFileResourceUploadItem}The support files to upload
transferConfigurationTrimbleCloud.FileService.Models.TransferFileConfigurationChunk size and concurrency for the transfer.

WaitForUpload(spaceId,uploadId,timeout,interval,callback) method

Summary

Waits for upload to finish

Returns

A Task that resolves to Response that contains UploadDetails data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
uploadIdSystem.GuidThe upload ID
timeoutSystem.Nullable{System.TimeSpan}The maximum time to wait for the upload to finish. Default is 3 minutes
intervalSystem.Nullable{System.TimeSpan}The time interval to poll the upload status. Default is 5 seconds
callbackSystem.Action{TrimbleCloud.FileService.Models.UploadDetails}The callback to be called after each check

WaitForUpload(spaceId,uploadId,urlDuration,timeout,interval,callback) method

Summary

Waits for upload to finish with custom URL duration

Returns

A Task that resolves to Response that contains UploadDetails data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
uploadIdSystem.GuidThe upload ID
urlDurationSystem.Nullable{System.TimeSpan}The upload URL’s validity duration. Minimum value is 5 minutes and maximum value is 7 days. Default = 60 minutes
timeoutSystem.Nullable{System.TimeSpan}The maximum time to wait for the upload to finish. Default is 3 minutes
intervalSystem.Nullable{System.TimeSpan}The time interval to poll the upload status. Default is 5 seconds
callbackSystem.Action{TrimbleCloud.FileService.Models.UploadDetails}The callback to be called after each check

IFoldersAPI type

Namespace

TrimbleCloud.FileService

Summary

Interface for the Folders API

CheckInFolder(spaceId,folderId) method

Summary

Checking in a folder will allow other actors to create a new version or perform other mutation operations

Returns
Parameters
NameTypeDescription
spaceIdSystem.Guid
folderIdSystem.Guid

CheckInFolderWithMinimalResponse(spaceId,folderId) method

Summary

Checkin a folder with minimal response

Returns
Parameters
NameTypeDescription
spaceIdSystem.Guid
folderIdSystem.Guid

CheckOutFolder(spaceId,folderId,reason,headers) method

Summary

Checking out a folder will prevent other actors from creating a new version or other mutation operations

Returns
Parameters
NameTypeDescription
spaceIdSystem.Guid
folderIdSystem.Guid
reasonSystem.String
headersSystem.Collections.Generic.IDictionary{System.String,System.String}

CheckOutFolderWithMinimalResponse(spaceId,folderId,reason,headers) method

Summary

Checkout a folder with minimal response

Returns
Parameters
NameTypeDescription
spaceIdSystem.Guid
folderIdSystem.Guid
reasonSystem.String
headersSystem.Collections.Generic.IDictionary{System.String,System.String}

Copy(spaceId,folderId,targetParentId,name,includeSupportFiles,overwriteExisting) method

Summary

Copy a folder to a new location within the same space

Returns

A Task that resolves to the a Tuple of Response of Folder data and possible JobId on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
folderIdSystem.GuidThe folder ID
targetParentIdSystem.GuidThe target parent ID
nameSystem.StringThe new name of the copied folder. If not specified, the folder will be copied with its original name
includeSupportFilesSystem.BooleanCopy support files and links along with the files
overwriteExistingSystem.BooleanWhether to overwrite an existing resource. If true, the existing resource will have a new version created with the copied content

Copy(copyFolderRequest) method

Summary

Copy a folder and its children to a new location within the same space

Returns
Parameters
NameTypeDescription
copyFolderRequestTrimbleCloud.FileService.Models.CopyFolderRequest

CopyWithMinimalResponse(spaceId,folderId,targetParentId,name,includeSupportFiles,overwriteExisting) method

Summary

Copy a folder to a new location within the same space and get minimal response

Returns

A Task that resolves to the a Tuple of Response of MinimalFolder data and possible JobId on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
folderIdSystem.GuidThe folder ID
targetParentIdSystem.GuidThe target parent ID
nameSystem.StringThe new name of the copied folder. If not specified, the folder will be copied with its original name
includeSupportFilesSystem.BooleanCopy support files and links along with the files
overwriteExistingSystem.BooleanWhether to overwrite an existing resource. If true, the existing resource will have a new version created with the copied content

CopyWithMinimalResponse(copyFolderRequest) method

Summary

Copy a folder and its children to a new location within the same space with custom headers

Returns
Parameters
NameTypeDescription
copyFolderRequestTrimbleCloud.FileService.Models.CopyFolderRequest

Create(spaceId,folder) method

Summary

Create a folder

Returns

A Task that resolves to Response that contains Folder data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
folderTrimbleCloud.FileService.Models.FolderCreateThe information of the folder to create

CreateBatch(spaceId,folderRequest) method

Summary

Create folders in batch mode. This allows you to create multiple folders at once, including nested folders.

Returns
Parameters
NameTypeDescription
spaceIdSystem.Guid
folderRequestTrimbleCloud.FileService.Models.BatchFolderCreate

CreateBatchWithMinimalResponse(spaceId,folderRequest) method

Summary

Create folders in batch mode with minimal response. This allows you to create multiple folders at once, including nested folders.

Returns
Parameters
NameTypeDescription
spaceIdSystem.Guid
folderRequestTrimbleCloud.FileService.Models.BatchFolderCreate

CreateWithMinimalResponse(spaceId,folder) method

Summary

Create a folder and get minimal response

Returns

A Task that resolves to Response that contains MinimalFolder data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
folderTrimbleCloud.FileService.Models.FolderCreateThe information of the folder to create

Delete(spaceId,folderId,recursive,permanent) method

Summary

Delete a folder

Returns

A Task that resolves to possible JobId on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
folderIdSystem.GuidThe folder ID
recursiveSystem.BooleanDelete descendant folders and files
permanentSystem.BooleanPermanently delete the folder

Delete(spaceId,folderId,headers,recursive,permanent) method

Summary

Delete a folder with custom headers

Returns

A Task that resolves to possible JobId on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
folderIdSystem.GuidThe folder ID
headersSystem.Collections.Generic.IDictionary{System.String,System.String}Custom HTTP headers to include in the request
recursiveSystem.BooleanDelete descendant folders and files
permanentSystem.BooleanPermanently delete the folder

Get(spaceId,folderId,status) method

Summary

Get a folder given the folder ID

Returns

A Task that resolves to Response that contains Folder data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
folderIdSystem.GuidThe folder ID
statusTrimbleCloud.FileService.Models.ResourceStatusThe status of the folder

Get(spaceId,path,status) method

Summary

Get a folder given the folder path

Returns

A Task that resolves to Response that contains Folder data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
pathSystem.StringThe folder path
statusTrimbleCloud.FileService.Models.ResourceStatusThe status of the folder

GetVersion(spaceId,folderId,versionId,status) method

Summary

Get folder version details given the folder ID

Returns

A Task that resolves to Response that contains Folder data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
folderIdSystem.GuidThe folder ID
versionIdSystem.Int32The version ID
statusTrimbleCloud.FileService.Models.ResourceStatusThe status of the folder

GetVersion(spaceId,path,versionId,status) method

Summary

Get folder version details given the folder path

Returns

A Task that resolves to Response that contains Folder data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
pathSystem.StringThe folder path
versionIdSystem.Int32The version ID
statusTrimbleCloud.FileService.Models.ResourceStatusThe status of the folder

GetVersionWithMinimalResponse(spaceId,folderId,versionId,status) method

Summary

Get folder version details given the folder ID with minimal response

Returns

A Task that resolves to Response that contains MinimalFolder data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
folderIdSystem.GuidThe folder ID
versionIdSystem.Int32The version ID
statusTrimbleCloud.FileService.Models.ResourceStatusThe status of the folder

GetVersionWithMinimalResponse(spaceId,path,versionId,status) method

Summary

Get folder version details given the folder path with minimal response

Returns

A Task that resolves to Response that contains MinimalFolder data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
pathSystem.StringThe folder path
versionIdSystem.Int32The version ID
statusTrimbleCloud.FileService.Models.ResourceStatusThe status of the folder

GetWithMinimalResponse(spaceId,folderId,status) method

Summary

Get a folder given the folder ID with minimal response

Returns

A Task that resolves to Response that contains MinimalFolder data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
folderIdSystem.GuidThe folder ID
statusTrimbleCloud.FileService.Models.ResourceStatusThe status of the folder

GetWithMinimalResponse(spaceId,path,status) method

Summary

Get a folder given the folder path with minimal response

Returns

A Task that resolves to Response that contains MinimalFolder data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
pathSystem.StringThe folder path
statusTrimbleCloud.FileService.Models.ResourceStatusThe status of the folder

ListChildren(spaceId,folderId,nextPageToken,maxItems,listFilter,sortBy,sortOrder,recursive) method

Summary

List the children of a folder given the folder ID

Returns

A Task that resolves to IPage`1 that contains FileOrFolder data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
folderIdSystem.GuidThe folder ID
nextPageTokenSystem.StringThe token to retrieve the next page of items
maxItemsSystem.Int32The number of items to return in each page
listFilterTrimbleCloud.FileService.Models.ListFilterCriteriaThe filter to apply to the list
sortBySystem.String
sortOrderSystem.String
recursiveSystem.Boolean

ListChildren(spaceId,path,nextPageToken,maxItems,listFilter,sortBy,sortOrder,recursive) method

Summary

List the children of a folder given the folder path

Returns

A Task that resolves to IPage`1 that contains FileOrFolder data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
pathSystem.StringThe folder path
nextPageTokenSystem.StringThe token to retrieve the next page of items
maxItemsSystem.Int32The number of items to return in each page
listFilterTrimbleCloud.FileService.Models.ListFilterCriteriaThe filter to apply to the list
sortBySystem.String
sortOrderSystem.String
recursiveSystem.Boolean

ListChildren(request) method

Summary

List the children of a folder using a request object. Either FolderId or Path must be specified in the request, but not both.

Returns

A Task that resolves to IPage`1 that contains FileOrFolder data on completion

Parameters
NameTypeDescription
requestTrimbleCloud.FileService.Models.FolderListChildrenRequestThe request object containing all parameters for listing children

ListVersions(spaceId,folderId,nextPageToken,maxItems,status) method

Summary

List all versions for a folder in a space given the folder ID

Returns

A Task that resolves to IPage`1 that contains Folder data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
folderIdSystem.GuidThe folder ID
nextPageTokenSystem.StringThe token to retrieve the next page of items
maxItemsSystem.Int32The number of items to return in each page
statusTrimbleCloud.FileService.Models.ResourceStatusThe status of the folder

ListVersions(spaceId,path,nextPageToken,maxItems,status) method

Summary

List all versions for a folder in a space given the folder path

Returns

A Task that resolves to IPage`1 that contains Folder data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
pathSystem.StringThe folder path
nextPageTokenSystem.StringThe token to retrieve the next page of items
maxItemsSystem.Int32The number of items to return in each page
statusTrimbleCloud.FileService.Models.ResourceStatusThe status of the folder

ListVersionsWithMinimalResponse(spaceId,folderId,nextPageToken,maxItems,status) method

Summary

List all versions for a folder in a space given the folder ID with minimal response

Returns

A Task that resolves to IPage`1 that contains MinimalFolder data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
folderIdSystem.GuidThe folder ID
nextPageTokenSystem.StringThe token to retrieve the next page of items
maxItemsSystem.Int32The number of items to return in each page
statusTrimbleCloud.FileService.Models.ResourceStatusThe status of the folder

ListVersionsWithMinimalResponse(spaceId,path,nextPageToken,maxItems,status) method

Summary

List all versions for a folder in a space given the folder path with minimal response

Returns

A Task that resolves to IPage`1 that contains MinimalFolder data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
pathSystem.StringThe folder path
nextPageTokenSystem.StringThe token to retrieve the next page of items
maxItemsSystem.Int32The number of items to return in each page
statusTrimbleCloud.FileService.Models.ResourceStatusThe status of the folder

Move(spaceId,folderId,targetParentId,name) method

Summary

Move a folder to a new location within the same space

Returns

A Task that resolves to the a Tuple of Response of Folder data and possible JobId on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
folderIdSystem.GuidThe folder ID
targetParentIdSystem.GuidThe target parent ID
nameSystem.String

Move(spaceId,folderId,targetParentId,name,headers) method

Summary

Move a folder to a new location within the same space with custom headers

Returns

A Task that resolves to the a Tuple of Response of Folder data and possible JobId on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
folderIdSystem.GuidThe folder ID
targetParentIdSystem.GuidThe target parent ID
nameSystem.Collections.Generic.IDictionary{System.String,System.String}
headersSystem.StringCustom HTTP headers to include in the request

MoveWithMinimalResponse(spaceId,folderId,targetParentId,name) method

Summary

Move a folder to a new location within the same space and get minimal response

Returns

A Task that resolves to the a Tuple of Response of MinimalFolder data and possible JobId on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
folderIdSystem.GuidThe folder ID
targetParentIdSystem.GuidThe target parent ID
nameSystem.String

MoveWithMinimalResponse(spaceId,folderId,targetParentId,name,headers) method

Summary

Move a folder to a new location within the same space and get minimal response with custom headers

Returns

A Task that resolves to the a Tuple of Response of MinimalFolder data and possible JobId on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
folderIdSystem.GuidThe folder ID
targetParentIdSystem.GuidThe target parent ID
nameSystem.Collections.Generic.IDictionary{System.String,System.String}
headersSystem.StringCustom HTTP headers to include in the request

Rename(spaceId,folderId,name) method

Summary

Rename a folder with a new name

Returns

A Task that resolves to the a Tuple of Response of Folder data and possible JobId on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
folderIdSystem.GuidThe folder ID
nameSystem.StringThe new name of the folder

Rename(spaceId,folderId,name,headers) method

Summary

Rename a folder with a new name with custom headers

Returns

A Task that resolves to the a Tuple of Response of Folder data and possible JobId on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
folderIdSystem.GuidThe folder ID
nameSystem.StringThe new name of the folder
headersSystem.Collections.Generic.IDictionary{System.String,System.String}Custom HTTP headers to include in the request

RenameWithMinimalResponse(spaceId,folderId,name) method

Summary

Rename a folder with a new name and get minimal response

Returns

A Task that resolves to the a Tuple of Response of MinimalFolder data and possible JobId on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
folderIdSystem.GuidThe folder ID
nameSystem.StringThe new name of the folder

RenameWithMinimalResponse(spaceId,folderId,name,headers) method

Summary

Rename a folder with a new name and get minimal response with custom headers

Returns

A Task that resolves to the a Tuple of Response of MinimalFolder data and possible JobId on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
folderIdSystem.GuidThe folder ID
nameSystem.StringThe new name of the folder
headersSystem.Collections.Generic.IDictionary{System.String,System.String}Custom HTTP headers to include in the request

Restore(spaceId,folderId,name,targetParentId) method

Summary

Restore a folder and its children from the deleted state

Returns

A Task that resolves to the a Tuple of Response of Folder data and possible JobId on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
folderIdSystem.GuidThe folder ID
nameSystem.StringThe new name of the restored folder. If not specified, the folder will be restored with its original name
targetParentIdSystem.Nullable{System.Guid}The target parent ID to restore the folder to. If not specified, the folder will be restored to its original location

Restore(spaceId,folderId,headers,name,targetParentId) method

Summary

Restore a folder and its children from the deleted state with custom headers

Returns

A Task that resolves to the a Tuple of Response of Folder data and possible JobId on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
folderIdSystem.GuidThe folder ID
headersSystem.Collections.Generic.IDictionary{System.String,System.String}Custom HTTP headers to include in the request
nameSystem.StringThe new name of the restored folder. If not specified, the folder will be restored with its original name
targetParentIdSystem.Nullable{System.Guid}The target parent ID to restore the folder to. If not specified, the folder will be restored to its original location

RestoreWithMinimalResponse(spaceId,folderId,name,targetParentId) method

Summary

Restore a folder and its children from the deleted state and get minimal response

Returns

A Task that resolves to the a Tuple of Response of MinimalFolder data and possible JobId on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
folderIdSystem.GuidThe folder ID
nameSystem.StringThe new name of the restored folder. If not specified, the folder will be restored with its original name
targetParentIdSystem.Nullable{System.Guid}The target parent ID to restore the folder to. If not specified, the folder will be restored to its original location

RestoreWithMinimalResponse(spaceId,folderId,headers,name,targetParentId) method

Summary

Restore a folder and its children from the deleted state and get minimal response with custom headers

Returns

A Task that resolves to the a Tuple of Response of MinimalFolder data and possible JobId on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
folderIdSystem.GuidThe folder ID
headersSystem.Collections.Generic.IDictionary{System.String,System.String}Custom HTTP headers to include in the request
nameSystem.StringThe new name of the restored folder. If not specified, the folder will be restored with its original name
targetParentIdSystem.Nullable{System.Guid}The target parent ID to restore the folder to. If not specified, the folder will be restored to its original location

Update(spaceId,folderId,folder) method

Summary

Update a folder

Returns

A Task that resolves to Response that contains Folder data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
folderIdSystem.GuidThe folder ID
folderTrimbleCloud.FileService.Models.FolderUpdateThe folder information to update

Update(spaceId,folderId,folder,headers) method

Summary

Update a folder with custom headers

Returns

A Task that resolves to Response that contains Folder data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
folderIdSystem.GuidThe folder ID
folderTrimbleCloud.FileService.Models.FolderUpdateThe folder information to update
headersSystem.Collections.Generic.IDictionary{System.String,System.String}Custom HTTP headers to include in the request

UpdateWithMinimalResponse(spaceId,folderId,folder) method

Summary

Update a folder and get minimal response

Returns

A Task that resolves to Response that contains MinimalFolder data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
folderIdSystem.GuidThe folder ID
folderTrimbleCloud.FileService.Models.FolderUpdateThe folder information to update

UpdateWithMinimalResponse(spaceId,folderId,folder,headers) method

Summary

Update a folder and get minimal response with custom headers

Returns

A Task that resolves to Response that contains MinimalFolder data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
folderIdSystem.GuidThe folder ID
folderTrimbleCloud.FileService.Models.FolderUpdateThe folder information to update
headersSystem.Collections.Generic.IDictionary{System.String,System.String}Custom HTTP headers to include in the request

IJobsAPI type

Namespace

TrimbleCloud.FileService

Summary

Interface for the Jobs API

Get(id) method

Summary

Get a job given the job id

Returns

A Task that resolves to Response that contains Job data on completion

Parameters
NameTypeDescription
idSystem.GuidThe job id

Get(jobId,queryParams) method

Summary

Get a job given the job id

Returns
Parameters
NameTypeDescription
jobIdSystem.Guid
queryParamsTrimbleCloud.FileService.Models.GetJobQueryParams

WaitForJob(id,timeout,interval,callback) method

Summary

Waits for job to finish

Returns

A Task that resolves to Response that contains Job data on completion

Parameters
NameTypeDescription
idSystem.GuidThe job id
timeoutSystem.Nullable{System.TimeSpan}The maximum time to wait for the job to finish. Default is 3 minutes
intervalSystem.Nullable{System.TimeSpan}The time interval to poll the job status. Default is 5 seconds
callbackSystem.Action{TrimbleCloud.FileService.Models.Job}The callback function to be called when the job status is polled

IObjectTypesAPI type

Namespace

TrimbleCloud.FileService

Summary

Interface for Object Types API.

Create(request) method

Summary

Creates a new object type definition.

Returns

A Task that resolves to Response that contains ObjectType data on completion

Parameters
NameTypeDescription
requestTrimbleCloud.FileService.Models.ObjectTypeCreateThe object type to create.
Exceptions
NameDescription
TrimbleCloud.FileService.TrimbleServiceExceptionThrown when an API or network error occurs
System.ArgumentNullExceptionThrown when request is null

Get(objectTypeId) method

Summary

Gets an object type by ID.

Returns

A Task that resolves to Response that contains ObjectType data on completion

Parameters
NameTypeDescription
objectTypeIdSystem.StringThe object type ID.
Exceptions
NameDescription
TrimbleCloud.FileService.TrimbleServiceExceptionThrown when an API or network error occurs
System.ArgumentExceptionThrown when objectTypeId is null or empty

IObjectsAPI type

Namespace

TrimbleCloud.FileService

Summary

Interface for Objects API. Objects are containers for external resources made accessible through Connect.

Checkin(spaceId,objectId) method

Summary

Checks in an object by ID.

Returns

A Task that resolves to Response that contains ObjectEntity data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID.
objectIdSystem.GuidThe object ID.

Checkin(spaceId,objectId,headers) method

Summary

Checks in an object by ID with custom headers.

Returns

A Task that resolves to Response that contains ObjectEntity data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID.
objectIdSystem.GuidThe object ID.
headersSystem.Collections.Generic.IDictionary{System.String,System.String}Custom headers (e.g., If-Match).

CheckinWithMinimalResponse(spaceId,objectId) method

Summary

Checks in an object by ID with minimal response.

Returns

A Task that resolves to Response that contains MinimalObjectEntity data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID.
objectIdSystem.GuidThe object ID.

CheckinWithMinimalResponse(spaceId,objectId,headers) method

Summary

Checks in an object by ID with custom headers and minimal response.

Returns

A Task that resolves to Response that contains MinimalObjectEntity data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID.
objectIdSystem.GuidThe object ID.
headersSystem.Collections.Generic.IDictionary{System.String,System.String}Custom headers (e.g., If-Match).

Checkout(spaceId,objectId,reason) method

Summary

Checks out an object by ID.

Returns

A Task that resolves to Response that contains ObjectEntity data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID.
objectIdSystem.GuidThe object ID.
reasonSystem.StringThe reason for checkout.

Checkout(spaceId,objectId,reason,headers) method

Summary

Checks out an object by ID with custom headers.

Returns

A Task that resolves to Response that contains ObjectEntity data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID.
objectIdSystem.GuidThe object ID.
reasonSystem.StringThe reason for checkout.
headersSystem.Collections.Generic.IDictionary{System.String,System.String}Custom headers (e.g., If-Match).

CheckoutWithMinimalResponse(spaceId,objectId,reason) method

Summary

Checks out an object by ID with minimal response.

Returns

A Task that resolves to Response that contains MinimalObjectEntity data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID.
objectIdSystem.GuidThe object ID.
reasonSystem.StringThe reason for checkout.

CheckoutWithMinimalResponse(spaceId,objectId,reason,headers) method

Summary

Checks out an object by ID with custom headers and minimal response.

Returns

A Task that resolves to Response that contains MinimalObjectEntity data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID.
objectIdSystem.GuidThe object ID.
reasonSystem.StringThe reason for checkout.
headersSystem.Collections.Generic.IDictionary{System.String,System.String}Custom headers (e.g., If-Match).

Create(spaceId,request) method

Summary

Creates a new object.

Returns

A Task that resolves to Response that contains ObjectEntity data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID.
requestTrimbleCloud.FileService.Models.ObjectCreateThe create object request.

CreateWithMinimalResponse(spaceId,request) method

Summary

Creates a new object with minimal response.

Returns

A Task that resolves to Response that contains MinimalObjectEntity data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID.
requestTrimbleCloud.FileService.Models.ObjectCreateThe create object request.

Delete(spaceId,objectId,permanent) method

Summary

Deletes an object by ID.

Returns

A Task that resolves to Response on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID.
objectIdSystem.GuidThe object ID.
permanentSystem.BooleanWhether to permanently delete the object.

Delete(spaceId,objectId,permanent,headers) method

Summary

Deletes an object by ID with custom headers.

Returns

A Task that resolves to Response on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID.
objectIdSystem.GuidThe object ID.
permanentSystem.BooleanWhether to permanently delete the object.
headersSystem.Collections.Generic.IDictionary{System.String,System.String}Custom headers (e.g., If-Match).

Get(spaceId,objectId) method

Summary

Gets an object by ID.

Returns

A Task that resolves to Response that contains ObjectEntity data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID.
objectIdSystem.GuidThe object ID.

Get(spaceId,objectId,parameters) method

Summary

Gets an object by ID with parameters.

Returns

A Task that resolves to Response that contains ObjectEntity data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID.
objectIdSystem.GuidThe object ID.
parametersTrimbleCloud.FileService.Models.GetObjectParamsThe get parameters.

Get(spaceId,objectPath) method

Summary

Gets an object by path.

Returns

A Task that resolves to Response that contains ObjectEntity data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID.
objectPathSystem.StringThe object path.

Get(spaceId,objectPath,parameters) method

Summary

Gets an object by path with parameters.

Returns

A Task that resolves to Response that contains ObjectEntity data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID.
objectPathSystem.StringThe object path.
parametersTrimbleCloud.FileService.Models.GetObjectParamsThe get parameters.

GetVersion(spaceId,objectId,versionId) method

Summary

Gets a specific version of an object by ID.

Returns

A Task that resolves to Response that contains ObjectEntity data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID.
objectIdSystem.GuidThe object ID.
versionIdSystem.Int32The version ID.

GetVersion(spaceId,objectId,versionId,parameters) method

Summary

Gets a specific version of an object by ID with parameters.

Returns

A Task that resolves to Response that contains ObjectEntity data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID.
objectIdSystem.GuidThe object ID.
versionIdSystem.Int32The version ID.
parametersTrimbleCloud.FileService.Models.GetObjectVersionParamsThe get parameters.

GetVersion(spaceId,objectPath,versionId) method

Summary

Gets a specific version of an object by path.

Returns

A Task that resolves to Response that contains ObjectEntity data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID.
objectPathSystem.StringThe object path.
versionIdSystem.Int32The version ID.

GetVersion(spaceId,objectPath,versionId,parameters) method

Summary

Gets a specific version of an object by path with parameters.

Returns

A Task that resolves to Response that contains ObjectEntity data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID.
objectPathSystem.StringThe object path.
versionIdSystem.Int32The version ID.
parametersTrimbleCloud.FileService.Models.GetObjectVersionParamsThe get parameters.

GetWithMinimalResponse(spaceId,objectId) method

Summary

Gets an object by ID with minimal response.

Returns

A Task that resolves to Response that contains MinimalObjectEntity data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID.
objectIdSystem.GuidThe object ID.

GetWithMinimalResponse(spaceId,objectId,parameters) method

Summary

Gets an object by ID with parameters and minimal response.

Returns

A Task that resolves to Response that contains MinimalObjectEntity data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID.
objectIdSystem.GuidThe object ID.
parametersTrimbleCloud.FileService.Models.GetObjectParamsThe get parameters.

GetWithMinimalResponse(spaceId,objectPath) method

Summary

Gets an object by path with minimal response.

Returns

A Task that resolves to Response that contains MinimalObjectEntity data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID.
objectPathSystem.StringThe object path.

GetWithMinimalResponse(spaceId,objectPath,parameters) method

Summary

Gets an object by path with parameters and minimal response.

Returns

A Task that resolves to Response that contains MinimalObjectEntity data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID.
objectPathSystem.StringThe object path.
parametersTrimbleCloud.FileService.Models.GetObjectParamsThe get parameters.

LinkSupportFiles(spaceId,objectId,request) method

Summary

Links support files to a specific object version and returns the full object entity.

Returns

A Task that resolves to Response`1 on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID.
objectIdSystem.GuidThe object ID.
requestTrimbleCloud.FileService.Models.ObjectLinkThe link request.

LinkSupportFilesWithMinimalResponse(spaceId,objectId,request) method

Summary

Links support files to an object and returns a minimal object entity.

Returns

A Task that resolves to Response`1 on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID.
objectIdSystem.GuidThe object ID.
requestTrimbleCloud.FileService.Models.ObjectLinkThe link request.

ListResources(spaceId,objectId) method

Summary

Lists resources (support files) for an object by ID.

Returns

A Task that resolves to IPage`1 of File on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID.
objectIdSystem.GuidThe object ID.

ListResources(spaceId,objectId,parameters) method

Summary

Lists resources (support files) for an object by ID with parameters.

Returns

A Task that resolves to IPage`1 of File on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID.
objectIdSystem.GuidThe object ID.
parametersTrimbleCloud.FileService.Models.ListObjectResourcesParamsThe list parameters.

ListResources(spaceId,objectPath) method

Summary

Lists resources (support files) for an object by path.

Returns

A Task that resolves to IPage`1 of File on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID.
objectPathSystem.StringThe object path.

ListResources(spaceId,objectPath,parameters) method

Summary

Lists resources (support files) for an object by path with parameters.

Returns

A Task that resolves to IPage`1 of File on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID.
objectPathSystem.StringThe object path.
parametersTrimbleCloud.FileService.Models.ListObjectResourcesParamsThe list parameters.

ListResourcesWithMinimalResponse(spaceId,objectId) method

Summary

Lists resources (support files) for an object by ID and returns a minimal file response.

Returns

A Task that resolves to IPage`1 of MinimalFile on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID.
objectIdSystem.GuidThe object ID.

ListResourcesWithMinimalResponse(spaceId,objectId,parameters) method

Summary

Lists resources (support files) for an object by ID with parameters and returns a minimal file response.

Returns

A Task that resolves to IPage`1 of MinimalFile on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID.
objectIdSystem.GuidThe object ID.
parametersTrimbleCloud.FileService.Models.ListObjectResourcesParamsThe list parameters.

ListResourcesWithMinimalResponse(spaceId,objectPath) method

Summary

Lists resources (support files) for an object by path and returns a minimal file response.

Returns

A Task that resolves to IPage`1 of MinimalFile on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID.
objectPathSystem.StringThe object path.

ListResourcesWithMinimalResponse(spaceId,objectPath,parameters) method

Summary

Lists resources (support files) for an object by path with parameters and returns a minimal file response.

Returns

A Task that resolves to IPage`1 of MinimalFile on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID.
objectPathSystem.StringThe object path.
parametersTrimbleCloud.FileService.Models.ListObjectResourcesParamsThe list parameters.

ListVersions(spaceId,objectId) method

Summary

Lists all versions of an object by ID.

Returns

A Task that resolves to IPage`1 of ObjectEntity on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID.
objectIdSystem.GuidThe object ID.

ListVersions(spaceId,objectId,parameters) method

Summary

Lists all versions of an object by ID with parameters.

Returns

A Task that resolves to IPage`1 of ObjectEntity on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID.
objectIdSystem.GuidThe object ID.
parametersTrimbleCloud.FileService.Models.ListObjectVersionsParamsThe list parameters.

ListVersions(spaceId,objectPath) method

Summary

Lists all versions of an object by path.

Returns

A Task that resolves to IPage`1 of ObjectEntity on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID.
objectPathSystem.StringThe object path.

ListVersions(spaceId,objectPath,parameters) method

Summary

Lists all versions of an object by path with parameters.

Returns

A Task that resolves to IPage`1 of ObjectEntity on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID.
objectPathSystem.StringThe object path.
parametersTrimbleCloud.FileService.Models.ListObjectVersionsParamsThe list parameters.

ListVersionsWithMinimalResponse(spaceId,objectId) method

Summary

Lists all versions of an object by ID with minimal response.

Returns

A Task that resolves to IPage`1 of MinimalObjectEntity on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID.
objectIdSystem.GuidThe object ID.

ListVersionsWithMinimalResponse(spaceId,objectId,parameters) method

Summary

Lists all versions of an object by ID with parameters and minimal response.

Returns

A Task that resolves to IPage`1 of MinimalObjectEntity on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID.
objectIdSystem.GuidThe object ID.
parametersTrimbleCloud.FileService.Models.ListObjectVersionsParamsThe list parameters.

ListVersionsWithMinimalResponse(spaceId,objectPath) method

Summary

Lists all versions of an object by path with minimal response.

Returns

A Task that resolves to IPage`1 of MinimalObjectEntity on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID.
objectPathSystem.StringThe object path.

ListVersionsWithMinimalResponse(spaceId,objectPath,parameters) method

Summary

Lists all versions of an object by path with parameters and minimal response.

Returns

A Task that resolves to IPage`1 of MinimalObjectEntity on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID.
objectPathSystem.StringThe object path.
parametersTrimbleCloud.FileService.Models.ListObjectVersionsParamsThe list parameters.

Move(spaceId,objectId,targetParentId,name) method

Summary

Moves an object to a new location.

Returns

A Task that resolves to Response that contains ObjectJobResponse data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID.
objectIdSystem.GuidThe object ID.
targetParentIdSystem.GuidThe target parent folder ID.
nameSystem.StringThe new name (optional).

Move(spaceId,objectId,targetParentId,name,headers) method

Summary

Moves an object to a new location with custom headers.

Returns

A Task that resolves to Response that contains ObjectJobResponse data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID.
objectIdSystem.GuidThe object ID.
targetParentIdSystem.GuidThe target parent folder ID.
nameSystem.StringThe new name (optional).
headersSystem.Collections.Generic.IDictionary{System.String,System.String}Custom headers (e.g., If-Match).

MoveWithMinimalResponse(spaceId,objectId,targetParentId,name) method

Summary

Moves an object to a new location with minimal response.

Returns

A Task that resolves to Response that contains MinimalObjectJobResponse data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID.
objectIdSystem.GuidThe object ID.
targetParentIdSystem.GuidThe target parent folder ID.
nameSystem.StringThe new name (optional).

MoveWithMinimalResponse(spaceId,objectId,targetParentId,name,headers) method

Summary

Moves an object to a new location with custom headers and minimal response.

Returns

A Task that resolves to Response that contains MinimalObjectJobResponse data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID.
objectIdSystem.GuidThe object ID.
targetParentIdSystem.GuidThe target parent folder ID.
nameSystem.StringThe new name (optional).
headersSystem.Collections.Generic.IDictionary{System.String,System.String}Custom headers (e.g., If-Match).

Rename(spaceId,objectId,name) method

Summary

Renames an object.

Returns

A Task that resolves to Response that contains ObjectJobResponse data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID.
objectIdSystem.GuidThe object ID.
nameSystem.StringThe new name.

Rename(spaceId,objectId,name,headers) method

Summary

Renames an object with custom headers.

Returns

A Task that resolves to Response that contains ObjectJobResponse data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID.
objectIdSystem.GuidThe object ID.
nameSystem.StringThe new name.
headersSystem.Collections.Generic.IDictionary{System.String,System.String}Custom headers (e.g., If-Match).

RenameWithMinimalResponse(spaceId,objectId,name) method

Summary

Renames an object with minimal response.

Returns

A Task that resolves to Response that contains MinimalObjectJobResponse data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID.
objectIdSystem.GuidThe object ID.
nameSystem.StringThe new name.

RenameWithMinimalResponse(spaceId,objectId,name,headers) method

Summary

Renames an object with custom headers and minimal response.

Returns

A Task that resolves to Response that contains MinimalObjectJobResponse data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID.
objectIdSystem.GuidThe object ID.
nameSystem.StringThe new name.
headersSystem.Collections.Generic.IDictionary{System.String,System.String}Custom headers (e.g., If-Match).

Restore(spaceId,objectId,targetParentId,name) method

Summary

Restores a deleted object.

Returns

A Task that resolves to Response that contains ObjectJobResponse data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID.
objectIdSystem.GuidThe object ID.
targetParentIdSystem.Nullable{System.Guid}The target parent folder ID (optional).
nameSystem.StringThe new name (optional).

Restore(spaceId,objectId,targetParentId,name,headers) method

Summary

Restores a deleted object with custom headers.

Returns

A Task that resolves to Response that contains ObjectJobResponse data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID.
objectIdSystem.GuidThe object ID.
targetParentIdSystem.Nullable{System.Guid}The target parent folder ID (optional).
nameSystem.StringThe new name (optional).
headersSystem.Collections.Generic.IDictionary{System.String,System.String}Custom headers (e.g., If-Match).

RestoreWithMinimalResponse(spaceId,objectId,targetParentId,name) method

Summary

Restores a deleted object with minimal response.

Returns

A Task that resolves to Response that contains MinimalObjectJobResponse data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID.
objectIdSystem.GuidThe object ID.
targetParentIdSystem.Nullable{System.Guid}The target parent folder ID (optional).
nameSystem.StringThe new name (optional).

RestoreWithMinimalResponse(spaceId,objectId,targetParentId,name,headers) method

Summary

Restores a deleted object with custom headers and minimal response.

Returns

A Task that resolves to Response that contains MinimalObjectJobResponse data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID.
objectIdSystem.GuidThe object ID.
targetParentIdSystem.Nullable{System.Guid}The target parent folder ID (optional).
nameSystem.StringThe new name (optional).
headersSystem.Collections.Generic.IDictionary{System.String,System.String}Custom headers (e.g., If-Match).

Update(spaceId,objectId,request) method

Summary

Updates an object by ID.

Returns

A Task that resolves to Response that contains ObjectEntity data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID.
objectIdSystem.GuidThe object ID.
requestTrimbleCloud.FileService.Models.ObjectUpdateThe update request.

Update(spaceId,objectId,request,headers) method

Summary

Updates an object by ID with custom headers.

Returns

A Task that resolves to Response that contains ObjectEntity data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID.
objectIdSystem.GuidThe object ID.
requestTrimbleCloud.FileService.Models.ObjectUpdateThe update request.
headersSystem.Collections.Generic.IDictionary{System.String,System.String}Custom headers (e.g., If-Match).

UpdateWithMinimalResponse(spaceId,objectId,request) method

Summary

Updates an object by ID with minimal response.

Returns

A Task that resolves to Response that contains MinimalObjectEntity data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID.
objectIdSystem.GuidThe object ID.
requestTrimbleCloud.FileService.Models.ObjectUpdateThe update request.

UpdateWithMinimalResponse(spaceId,objectId,request,headers) method

Summary

Updates an object by ID with custom headers and minimal response.

Returns

A Task that resolves to Response that contains MinimalObjectEntity data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID.
objectIdSystem.GuidThe object ID.
requestTrimbleCloud.FileService.Models.ObjectUpdateThe update request.
headersSystem.Collections.Generic.IDictionary{System.String,System.String}Custom headers (e.g., If-Match).

IPage`1 type

Namespace

TrimbleCloud.FileService

Summary

Defines a page interface in responses.

Generic Types
NameDescription
TThe type of the items in the page.

NextPageToken property

Summary

Gets the link to the next page.

IResourcesAPI type

Namespace

TrimbleCloud.FileService

Summary

Interface for accessing resources in the Trimble Cloud File Service API.

BatchGet(spaceId,resourceIds,status,urlDuration,responseContentType) method

Summary

batch gets resources by their IDs or paths

Returns
Parameters
NameTypeDescription
spaceIdSystem.Guid
resourceIdsSystem.Collections.Generic.IList{System.Guid}
statusTrimbleCloud.FileService.Models.ResourceStatus
urlDurationSystem.Nullable{System.TimeSpan}
responseContentTypeSystem.String

BatchGet(spaceId,resourcePaths,status,urlDuration,responseContentType) method

Summary

batch gets resources by their paths

Returns
Parameters
NameTypeDescription
spaceIdSystem.Guid
resourcePathsSystem.Collections.Generic.IList{System.String}
statusTrimbleCloud.FileService.Models.ResourceStatus
urlDurationSystem.Nullable{System.TimeSpan}
responseContentTypeSystem.String

BatchGetWithMinimalResponse(spaceId,resourceIds,status,urlDuration,responseContentType) method

Summary

batch gets resources by their IDs with minimal response

Returns
Parameters
NameTypeDescription
spaceIdSystem.Guid
resourceIdsSystem.Collections.Generic.IList{System.Guid}
statusTrimbleCloud.FileService.Models.ResourceStatus
urlDurationSystem.Nullable{System.TimeSpan}
responseContentTypeSystem.String

BatchGetWithMinimalResponse(spaceId,resourcePaths,status,urlDuration,responseContentType) method

Summary

batch gets resources by their paths with minimal response

Returns
Parameters
NameTypeDescription
spaceIdSystem.Guid
resourcePathsSystem.Collections.Generic.IList{System.String}
statusTrimbleCloud.FileService.Models.ResourceStatus
urlDurationSystem.Nullable{System.TimeSpan}
responseContentTypeSystem.String

Get(spaceId,resourceId,status,urlDuration,responseContentType) method

Summary

gets a resource by its ID

Returns
Parameters
NameTypeDescription
spaceIdSystem.Guid
resourceIdSystem.Guid
statusTrimbleCloud.FileService.Models.ResourceStatus
urlDurationSystem.Nullable{System.TimeSpan}
responseContentTypeSystem.String

Get(spaceId,resourcePath,status,urlDuration,responseContentType) method

Summary

gets a resource by its path

Returns
Parameters
NameTypeDescription
spaceIdSystem.Guid
resourcePathSystem.String
statusTrimbleCloud.FileService.Models.ResourceStatus
urlDurationSystem.Nullable{System.TimeSpan}
responseContentTypeSystem.String

GetWithMinimalResponse(spaceId,resourceId,status,urlDuration,responseContentType) method

Summary

gets a resource by its ID with minimal response

Returns
Parameters
NameTypeDescription
spaceIdSystem.Guid
resourceIdSystem.Guid
statusTrimbleCloud.FileService.Models.ResourceStatus
urlDurationSystem.Nullable{System.TimeSpan}
responseContentTypeSystem.String

GetWithMinimalResponse(spaceId,resourcePath,status,urlDuration,responseContentType) method

Summary

gets a resource by its path with minimal response

Returns
Parameters
NameTypeDescription
spaceIdSystem.Guid
resourcePathSystem.String
statusTrimbleCloud.FileService.Models.ResourceStatus
urlDurationSystem.Nullable{System.TimeSpan}
responseContentTypeSystem.String

ISpacesAPI type

Namespace

TrimbleCloud.FileService

Summary

Interface for the Spaces API

Create(space) method

Summary

Create a space

Returns

A Task that resolves to Response that contains Space data on completion

Parameters
NameTypeDescription
spaceTrimbleCloud.FileService.Models.SpaceCreateThe information of the space to create

CreateWithMinimalResponse(space) method

Summary

Create a space and get minimal response

Returns

A Task that resolves to Response that contains MinimalSpace data on completion

Parameters
NameTypeDescription
spaceTrimbleCloud.FileService.Models.SpaceCreateThe information of the space to create

Delete(id,recursive,permanent) method

Summary

Delete a space given the space ID

Returns

A Task that resolves to possible JobId on completion

Parameters
NameTypeDescription
idSystem.GuidThe space ID
recursiveSystem.BooleanDelete descendant folders and files
permanentSystem.BooleanPermanently delete the space

Get(id,status) method

Summary

Get a space given the space ID

Returns

A Task that resolves to Response that contains Space data on completion

Parameters
NameTypeDescription
idSystem.GuidThe space ID
statusTrimbleCloud.FileService.Models.ResourceStatusThe status of the space

GetWithMinimalResponse(id,status) method

Summary

Get a space with minimal response given the space ID

Returns

A Task that resolves to Response that contains MinimalSpace data on completion

Parameters
NameTypeDescription
idSystem.GuidThe space ID
statusTrimbleCloud.FileService.Models.ResourceStatusThe status of the space

ListChildren(spaceId,nextPageToken,maxItems,includeSupportFiles,listFilter,sortOrder) method

Summary

List the children of a space given the space ID

Returns

A Task that resolves to IPage`1 that contains FileOrFolder data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
nextPageTokenSystem.StringThe token to retrieve the next page of items
maxItemsSystem.Int32The number of items to return in each page
includeSupportFilesSystem.Boolean
listFilterTrimbleCloud.FileService.Models.SpaceListFilterCriteriaThe filter to apply to the list
sortOrderSystem.String

ListPublicResources(spaceId,nextPageToken,maxItems) method

Summary

Get list of public resources in space with anonymous access

Returns

A Task that resolves to IPage`1 that contains FileOrFolder data on completion

Parameters
NameTypeDescription
spaceIdSystem.GuidThe space ID
nextPageTokenSystem.StringThe token to retrieve the next page of items
maxItemsSystem.Int32The number of items to return in each page

Restore(id) method

Summary

Restore a deleted space, given the space ID, within 30 days of its deletion

Returns

A Task that resolves to the a Tuple of Response of Space data and possible JobId on completion

Parameters
NameTypeDescription
idSystem.GuidThe space ID

RestoreWithMinimalResponse(id) method

Summary

Restore a deleted space given the space ID, within 30 days of its deletion and get minimal response

Returns

A Task that resolves to the a Tuple of Response of MinimalSpace data and possible JobId on completion

Parameters
NameTypeDescription
idSystem.GuidThe space ID

Update(id,space) method

Summary

Update a space given the space ID

Returns

A Task that resolves to Response that contains Space data on completion

Parameters
NameTypeDescription
idSystem.GuidThe space ID
spaceTrimbleCloud.FileService.Models.SpaceUpdateThe space information to update

UpdateWithMinimalResponse(id,space) method

Summary

Update a space given the space ID and get minimal response

Returns

A Task that resolves to Response that contains MinimalSpace data on completion

Parameters
NameTypeDescription
idSystem.GuidThe space ID
spaceTrimbleCloud.FileService.Models.SpaceUpdateThe space information to update

InheritedAcl type

Namespace

TrimbleCloud.FileService.Models

Summary

Represents the actor role mapping for the resources that are inherited.

Actor property

Summary

The TRN (Trimble Resource Name) of the actor (User/Device/Application).

InheritedFrom property

Summary

Indicates the source of the inherited permission.

InheritedFromTrn property

Summary

The TRN (Trimble Resource Name) of the resource from which the permission is inherited.

Role property

Summary

The role assigned to the actor.

Versions property

Summary

List of versions associated with this ACL entry.

InvalidFolderItem type

Namespace

TrimbleCloud.FileService.Models

Summary

Invalid Folder Item

Code property

Summary

represents a error code that can be used for programmatic handling of the error

Detail property

Summary

represents a detailed explanation of the error

Path property

Summary

Path of the invalid folder item

Status property

Summary

represents the HTTP status code for the error

Title property

Summary

represents a short, human-readable summary of the problem SERVICE_ERROR, API_ERROR etc.,

Type property

Summary

represents the type of error that occurred

InvalidResourceItem type

Namespace

TrimbleCloud.FileService.Models

Summary

api invalid resource item

Code property

Summary

represents a error code that can be used for programmatic handling of the error

Detail property

Summary

represents a detailed explanation of the error

Id property

Summary

represents the unique identifier of the resource item

Status property

Summary

represents the HTTP status code for the error

Title property

Summary

represents a short, human-readable summary of the problem SERVICE_ERROR, API_ERROR etc.,

Type property

Summary

represents the type of error that occurred

Job type

Namespace

TrimbleCloud.FileService.Models

Summary

Represents a job in File Service.

CreatedAt property

Summary

The date and time when the job was created.

CreatedBy property

Summary

The TRN (Trimble Resource Name) of the user/device/application that created this job.

Id property

Summary

The unique identifier of the job.

Message property

Summary

The message of the job.

ResourceTrn property

Summary

The TRN (Trimble Resource Name) of the job.

Status property

Summary

The status of the job.

Type property

Summary

The type of job.

JobStatus type

Namespace

TrimbleCloud.FileService.Models

Summary

The status of the job

Completed constants

Summary

Job completed

Failed constants

Summary

Job failed

Queued constants

Summary

Job queued

Running constants

Summary

Job running

Unknown constants

Summary

Unknown job status

JobType type

Namespace

TrimbleCloud.FileService.Models

Summary

The type of job

Copy constants

Summary

Copy job

Delete constants

Summary

Delete job

Export constants

Summary

Export job

FileDeletion constants

Summary

File delete job

FileRestore constants

Summary

File restore job

FolderDeletion constants

Summary

Folder delete job

Move constants

Summary

Move job

Rename constants

Summary

Rename job

Restore constants

Summary

Restore job

Unknown constants

Summary

Unknown job type

Upload constants

Summary

Upload job

JsonRawStringConverter type

Namespace

TrimbleCloud.FileService.Utilities

Summary

JSON converter that serializes a string property as a raw JSON object/array instead of a double-encoded JSON string, and deserializes a JSON object/array back into a compact JSON string.

Remarks

The converter validates the string is valid JSON during serialization.

ReadJson() method

Summary

Reads a JSON object/array token and converts it to a compact JSON string.

Parameters

This method has no parameters.

WriteJson() method

Summary

Validates the string is valid JSON, then writes it as a raw JSON object/array instead of as a double-encoded string.

Parameters

This method has no parameters.

Exceptions
NameDescription
Newtonsoft.Json.JsonSerializationExceptionThrown when the string is not valid JSON.

ListFilterBase type

Namespace

TrimbleCloud.FileService.Models

Summary

Base class for list filters

ListFilterCriteria type

Namespace

TrimbleCloud.FileService.Models

Summary

Criteria for filtering a list of files

Status property

Summary

Gets or sets the file status.

UrlDuration property

Summary

Gets or sets the file URL duration.

ListObjectResourcesParams type

Namespace

TrimbleCloud.FileService.Models

Summary

Parameters for listing object resources (support files).

NextPageToken property

Summary

The token for the next page of results.

PageSize property

Summary

The maximum number of items to return per page.

Status property

Summary

The status filter for resources.

UrlDuration property

Summary

The validity duration for download URLs.

GetQueryParameters() method

Summary

Gets query parameters for the request.

Returns

Dictionary of query parameters

Parameters

This method has no parameters.

ListObjectVersionsParams type

Namespace

TrimbleCloud.FileService.Models

Summary

Parameters for listing object versions.

NextPageToken property

Summary

The token for the next page of results.

PageSize property

Summary

The maximum number of items to return per page.

Status property

Summary

The status filter for objects.

GetQueryParameters() method

Summary

Gets query parameters for the request.

Returns

Dictionary of query parameters

Parameters

This method has no parameters.

ListQueryStringFormatter`1 type

Namespace

TrimbleCloud.FileService.Utilities

Summary

Query String Formatter

ToQueryString() method

Summary

Convert the filter to query string

Parameters

This method has no parameters.

Lock type

Namespace

TrimbleCloud.FileService.Models

Summary

Contains the lock details of a file

LockedAt property

Summary

The date and time when the file was locked.

LockedBy property

Summary

The TRN (Trimble Resource Name) of the user/device/application that locked this file.

Reason property

Summary

The reason for locking the file.

MalwareScanStatus type

Namespace

TrimbleCloud.FileService.Models

Summary

Represents the status of a malware scan.

CannotScan constants

Summary

File cannot be scanned

Clean constants

Summary

Malware scan clean

Failed constants

Summary

Malware scan failed

Infected constants

Summary

Malware scan infected

QueuedForScan constants

Summary

Malware scan queued

Scanning constants

Summary

Malware scan scanning

Unknown constants

Summary

Unknown malware scan status

Unscanned constants

Summary

File is unscanned

ManifestFile type

Namespace

TrimbleCloud.FileService.Models

Summary

A manifest file from a fileset.

Download property

Summary

The download URL of the file.

MD5 property

Summary

MD5 hash of the file.

Path property

Summary

The path where file is created.

Size property

Summary

The size of the file in bytes.

MinimalFile type

Namespace

TrimbleCloud.FileService.Models

Summary

Represents a minimal representation of a file.

CreatedBy property

Summary

The TRN (Trimble Resource Name) of the user/device/application that created this file.

Deleted property

Summary

True if the entity has been deleted.

DeletedAt property

Summary

The date and time when the filespace was deleted, if applicable.

ResourceTrn property

Summary

The TRN (Trimble Resource Name) of the file.

SpaceId property

Summary

The unique identifier for the space where the file is stored.

SpaceTrn property

Summary

The TRN (Trimble Resource Name) of the space where the file is stored.

UpdatedBy property

Summary

The TRN (Trimble Resource Name) of the user/device/application that last updated this file.

Version property

Summary

The version of the file, represented in a ‘major.minor’ format.

MinimalFolder type

Namespace

TrimbleCloud.FileService.Models

Summary

Represents a minimal representation of a folder.

CreatedBy property

Summary

The TRN (Trimble Resource Name) of the user/device/application that created this filespace.

Deleted property

Summary

True if the entity has been deleted.

DeletedAt property

Summary

The date and time when the filespace was deleted, if applicable.

ResourceTrn property

Summary

The TRN (Trimble Resource Name) of the folder.

SpaceId property

Summary

The unique identifier of the space where the folder is stored.

SpaceTrn property

Summary

The TRN (Trimble Resource Name) of the space where the folder is stored.

UpdatedBy property

Summary

The TRN (Trimble Resource Name) of the user/device/application that last updated this filespace.

Version property

Summary

The folder version.

MinimalObjectEntity type

Namespace

TrimbleCloud.FileService.Models

Summary

Represents a minimal object entity response. Contains only essential fields for performance optimization.

CreatedBy property

Summary

The TRN (Trimble Resource Name) of the user/device/application that created this object.

Deleted property

Summary

True if the entity has been deleted.

ResourceTrn property

Summary

The TRN (Trimble Resource Name) of the object.

SpaceId property

Summary

The unique identifier of the space in which the object is stored.

SpaceTrn property

Summary

The TRN (Trimble Resource Name) of the space in which the object is stored.

UpdatedBy property

Summary

The TRN (Trimble Resource Name) of the user/device/application that last updated this object.

Version property

Summary

The version of the object. Whole numbers only (e.g., “1”, “2”, “3”).

MinimalObjectJobResponse type

Namespace

TrimbleCloud.FileService.Models

Summary

Represents a minimal job response for object operations (move, rename, restore). Contains the job ID and minimal object details for performance optimization.

JobId property

Summary

The job ID for tracking the async operation. Extracted from the Location header in the response.

Resource property

Summary

The object resource with minimal details returned by the operation.

MinimalSpace type

Namespace

TrimbleCloud.FileService.Models

Summary

Represents a minimal representation of a filespace.

CreatedAt property

Summary

The date and time when the filespace was created.

CreatedBy property

Summary

The TRN (Trimble Resource Name) of the user/device/application that created this filespace.

Deleted property

Summary

True if the space has been deleted.

DeletedAt property

Summary

The date and time when the filespace was deleted, if applicable.

Id property

Summary

The unique identifier of the filespace.

Name property

Summary

The name of the filespace.

ResourceTrn property

Summary

The TRN (Trimble Resource Name) of the filespace.

RootId property

Summary

The unique identifier of the root folder.

RootTrn property

Summary

The TRN (Trimble Resource Name) of the root folder.

Type property

Summary

The type of the resource.

UpdatedAt property

Summary

The date and time when the filespace was last updated.

UpdatedBy property

Summary

The TRN (Trimble Resource Name) of the user/device/application that last updated this filespace.

MinimalSpaceList type

Namespace

TrimbleCloud.FileService.Models

Summary

Represents the minimal File or Folder including Space

CreatedAt property

Summary

The date and time when the children was created.

CreatedBy property

Summary

The TRN (Trimble Resource Name) of the user/device/application that created.

Deleted property

Summary

True if the entity has been deleted.

DeletedAt property

Summary

The date and time when the filespace was deleted, if applicable.

Id property

Summary

The unique identifier of children. Children can be a file or a folder.

Name property

Summary

The name of the children.

ResourceTrn property

Summary

The Resource Trn of the children

RootId property

Summary

The unique identifier for the root

RootTrn property

Summary

The Root Trn for the space

SpaceId property

Summary

The unique identifier for the space where the file/folder is stored.

SpaceTrn property

Summary

The Space Trn for the space

Type property

Summary

The type of the children either it can be file or folder.

UpdatedAt property

Summary

The date and time when the children was last updated.

UpdatedBy property

Summary

The TRN (Trimble Resource Name) of the user/device/application that last updated.

Version property

Summary

The version of the children, represented in a ‘major.minor’ format.

ObjectAcl type

Namespace

TrimbleCloud.FileService.Models

Summary

Represents the actor role mapping for object resources with version information.

AccessExpiresAt property

Summary

Time when the actor’s access to the resource expires.

Actor property

Summary

The TRN (Trimble Resource Name) of the actor (User/Device/Application).

Role property

Summary

The role assigned to the actor.

Versions property

Summary

List of versions associated with this ACL entry. For objects, versions are whole numbers (e.g., “1”, “2”, “3”).

ObjectCheckin type

Namespace

TrimbleCloud.FileService.Models

Summary

Represents a request to checkin an object. Checking in an object releases the checkout and allows other actors to perform operations.

ObjectId property

Summary

The object ID.

SpaceId property

Summary

The space ID.

ObjectCheckout type

Namespace

TrimbleCloud.FileService.Models

Summary

Represents a request to checkout an object. Checking out an object prevents other actors from creating a new version or performing mutation operations.

ObjectId property

Summary

The object ID.

Reason property

Summary

The reason for checkout (optional).

SpaceId property

Summary

The space ID.

ObjectCreate type

Namespace

TrimbleCloud.FileService.Models

Summary

Represents a request to create an object.

Content property

Summary

The content variables defined by the object type schema. This is a freeform JSON object that must conform to the schema defined by the object type.

Metadata property

Summary

The metadata of the object.

Name property

Summary

The name of the object.

ObjectTypeId property

Summary

The ID of the object type definition.

ParentId property

Summary

The folder or root ID in which the object resides.

PermissionsLocal property

Summary

Permissions to be set on the object.

Size property

Summary

The size of the object in bytes.

ObjectDelete type

Namespace

TrimbleCloud.FileService.Models

Summary

Represents a request to delete an object.

ObjectId property

Summary

The object ID.

Permanent property

Summary

Whether to permanently delete the object.

SpaceId property

Summary

The space ID.

ObjectEntity type

Namespace

TrimbleCloud.FileService.Models

Summary

Represents an object entity response. Objects are containers for resources stored outside of Connect but made accessible through Connect.

Actions property

Summary

The actions available for this object, as defined by the object type. Actions define how users can interact with the object and its external resources.

Capabilities property

Summary

The actions that can be performed on the resource by the current user.

Checkout property

Summary

Checkout attached to the object.

Content property

Summary

The content variables defined by the object type schema. This is a freeform JSON object that can contain any structure.

CreatedBy property

Summary

The TRN (Trimble Resource Name) of the user/device/application that created this object.

Deleted property

Summary

True if the entity has been deleted.

DeletedAt property

Summary

The date and time when the object was deleted, if applicable.

Summary

The support file links.

Metadata property

Summary

The metadata of the object.

ObjectType property

Summary

The name/identifier of the object type.

ObjectTypeId property

Summary

The ID of the object type definition.

ParentId property

Summary

The unique identifier of the parent folder.

ParentTrn property

Summary

The TRN (Trimble Resource Name) of the parent folder.

ParentType property

Summary

The parent type.

Path property

Summary

The path of the object.

PermissionsEvaluated property

Summary

Permissions evaluated for the actors on the resource. It shows the most permissible role applicable for the actor, considering both the direct and inherited permissions.

PermissionsInherited property

Summary

Permissions inherited from the entire parent hierarchy applicable for the actor.

PermissionsLocal property

Summary

Permissions that are set directly for an actor on the resource itself.

ResourceTrn property

Summary

The TRN (Trimble Resource Name) of the object.

Size property

Summary

The size of the object in bytes.

SpaceId property

Summary

The unique identifier of the space in which the object is stored.

SpaceTrn property

Summary

The TRN (Trimble Resource Name) of the space in which the object is stored.

Statistics property

Summary

The statistics of the object.

UpdatedBy property

Summary

The TRN (Trimble Resource Name) of the user/device/application that last updated this object.

Version property

Summary

The version of the object. Whole numbers only (e.g., “1”, “2”, “3”).

ObjectJobResponse type

Namespace

TrimbleCloud.FileService.Models

Summary

Represents a job response for object operations (move, rename, restore). Contains the job ID for tracking async operations and the resulting object.

InvalidResources property

Summary

List of invalid resources encountered during the operation.

JobId property

Summary

The job ID for tracking the async operation. Extracted from the Location header in the response.

Resource property

Summary

The object resource returned by the operation.

Namespace

TrimbleCloud.FileService.Models

Summary

Represents a request to link support files to an object.

Summary

The support file links to create or update. Key is the link name, value is the support file details.

ObjectMove type

Namespace

TrimbleCloud.FileService.Models

Summary

Represents a request to move an object to a new location.

Name property

Summary

The new name for the object (optional). If not specified, the object retains its current name.

ObjectId property

Summary

The object ID.

SpaceId property

Summary

The space ID.

TargetParentId property

Summary

The target parent folder ID.

ObjectPermissionsLocal type

Namespace

TrimbleCloud.FileService.Models

Summary

Represents the permissions explicitly assigned to an object.

Acl property

Summary

The list of actors, their roles, and version restrictions.

Inherits property

Summary

Specifies if permissions are inherited from the parent folder.

ObjectRename type

Namespace

TrimbleCloud.FileService.Models

Summary

Represents a request to rename an object.

Name property

Summary

The new name for the object.

ObjectId property

Summary

The object ID.

SpaceId property

Summary

The space ID.

ObjectRestore type

Namespace

TrimbleCloud.FileService.Models

Summary

Represents a request to restore a deleted object.

Name property

Summary

The new name for the restored object (optional). If not specified, the object retains its original name.

ObjectId property

Summary

The object ID.

SpaceId property

Summary

The space ID.

TargetParentId property

Summary

The target parent folder ID (optional). If not specified, the object is restored to its original location.

ObjectStatistics type

Namespace

TrimbleCloud.FileService.Models

Summary

Statistics about support files linked to an object.

SupportFilesCount property

Summary

The total count of support files.

SupportFilesSize property

Summary

The total size of all support files in bytes.

SupportFilesUpdatedAt property

Summary

The date and time when the support files were last updated.

ObjectSupportFileDetails type

Namespace

TrimbleCloud.FileService.Models

Summary

Represents support file details for linking to an object.

Id property

Summary

The unique identifier of the support file.

Version property

Summary

The major version of the object to link the support file to.

ObjectType type

Namespace

TrimbleCloud.FileService.Models

Summary

Represents an Object Type definition. Object Types define the schema, actions, and display configuration for objects. They act as blueprints that specify what data fields an object can have, how users can interact with objects, and how objects appear in Connect UI.

Actions property

Summary

Actions configuration defining how users can interact with objects of this type. Actions are objects where each key is an action type and the value is an array of action definitions. Stored as a JSON string. Examples: Connect:download, Connect:actionMenu, Connect:displayComponent

CreatedAt property

Summary

Creation timestamp (ISO 8601 format). This field is required and automatically set by the server.

CreatedBy property

Summary

The TRN (Trimble Resource Name) of the user/application that created this object type. This field is required and automatically set by the server. Format: trn:2:fileservice:{region}:{resourceType}:{uuid}

DisplayName property

Summary

The human-readable display name for the object type. Between 1-255 characters.

Id property

Summary

The unique identifier of the object type.

Name property

Summary

The internal name/identifier for the object type. This is used to reference the object type. Must be between 1-255 characters.

Schema property

Summary

JSON Schema defining the structure and validation for object content. This should be a valid JSON Schema (draft 2020-12 or compatible). Stored as a JSON string. Example: ”{“type”: “object”, “properties”: {…}, “required”: […]}”

UpdatedAt property

Summary

Last update timestamp (ISO 8601 format). Optional - may not be present if the object type has never been updated. Note: Update operations are not currently supported by the API.

UpdatedBy property

Summary

The TRN (Trimble Resource Name) of the user/application that last updated this object type. Optional - may not be present if the object type has never been updated. Format: trn:2:fileservice:{region}:{resourceType}:{uuid} Note: Update operations are not currently supported by the API.

ObjectTypeCreate type

Namespace

TrimbleCloud.FileService.Models

Summary

Request to create a new object type definition. Object types define the schema, actions, and display configuration for objects.

Actions property

Summary

Actions configuration for objects of this type as a JSON string. Defines how users can interact with objects (e.g., download, view, custom menu items).

DisplayName property

Summary

The human-readable display name for the object type.

Name property

Summary

The internal unique name/identifier for the object type.

Schema property

Summary

JSON Schema defining the structure for object content as a JSON string. This should be a valid JSON Schema (draft 2020-12 or compatible).

ObjectUpdate type

Namespace

TrimbleCloud.FileService.Models

Summary

Represents a request to update an object.

Content property

Summary

The content variables defined by the object type schema.

Summary

The support file links.

Metadata property

Summary

The metadata of the object.

PermissionsLocal property

Summary

Update the permissions on the resource.

Size property

Summary

The size of the object in bytes.

ObjectUpdateAcl type

Namespace

TrimbleCloud.FileService.Models

Summary

Represents a request to update object ACL.

Add property

Summary

Add new roles to the existing permissions on the resource. If an actor already has a permission on the resource and is included in the request again, their existing permissions will be replaced with the new ones specified.

Remove property

Summary

The actors to be removed from the permissions.

ObjectUpdatePermissionsLocal type

Namespace

TrimbleCloud.FileService.Models

Summary

Represents permissions update request for an object. Either ReplaceAcl or UpdateAcl can be set, but not both.

Inherits property

Summary

Specifies if permissions are inherited from the parent folder.

ReplaceAcl property

Summary

Replace the entire ACL with this list of entries. Mutually exclusive with UpdateAcl.

UpdateAcl property

Summary

Update specific ACL entries (add or remove actors). Mutually exclusive with ReplaceAcl.

ObjectUpdateSupportFileDetails type

Namespace

TrimbleCloud.FileService.Models

Summary

Represents support file details for updating links on an object.

Id property

Summary

The unique identifier of the support file.

Version property

Summary

The major version of the object to link the support file to.

Output type

Namespace

TrimbleCloud.FileService.Models

Summary

Contains the download URL of an export.

Url property

Summary

The URL to download the export from.

PackageUploadCreate type

Namespace

TrimbleCloud.FileService.Models

Summary

Represents a package upload creation.

ExpiresAt property

Summary

Time period when the file object gets automatically removed. Must be at least 1 hour after the current time. Should not exceed 20 years from the current time.

Fileset property

Summary

Whether the object consists of a set of multiple files that should be treated as a single file.

Metadata property

Summary

Additional information related to the file.

Multipart property

Summary

True if the client will split the upload into multiple parts.

Name property

Summary

The name of the file.

ParentId property

Summary

The parent folder identifier to which the file has to be uploaded.

ParentType property

Summary

The parent type.

PermissionsLocal property

Summary

Permissions that are set directly for an actor on the resource itself.

ResponseHeaders property

Summary

Download HTTP response headers.

RestrictedAccess property

Summary

True if the download url of the file shouldn’t expire.

SupportFileResources property

Summary

The support file resources.

PackageUploadRequest type

Namespace

TrimbleCloud.FileService.Models

Summary

Represents an upload request.

MainFileStream property

Summary

The file stream.

SpaceId property

Summary

The space identifier.

SupportFiles property

Summary

The support files.

UploadId property

Summary

The upload identifier.

Url property

Summary

The upload URL.

UrlDuration property

Summary

The upload URL’s validity duration. If not specified, defaults to 60 minutes (or 2 days for files larger than 10GB).

Page`1 type

Namespace

TrimbleCloud.FileService

Summary

Defines a page in responses.

Generic Types
NameDescription
TType of the page content items

Items property

Summary

The items in the page.

NextPageToken property

Summary

Gets the link to the next page.

GetEnumerator() method

Summary

Returns an enumerator that iterates through the collection.

Returns

A an enumerator that can be used to iterate through the collection.

Parameters

This method has no parameters.

System#Collections#IEnumerable#GetEnumerator() method

Summary

Returns an enumerator that iterates through the collection.

Returns

A an enumerator that can be used to iterate through the collection.

Parameters

This method has no parameters.

ParentType type

Namespace

TrimbleCloud.FileService.Models

Summary

The type of parent

File constants

Summary

Parent is a file

Folder constants

Summary

Parent is a folder

Object constants

Summary

Parent is an object

Unknown constants

Summary

Unknown parent type

PermissionsEvaluated type

Namespace

TrimbleCloud.FileService.Models

Summary

Represents the permissions evaluated for the actors on the resource. It shows the most permissible role applicable for the actor, considering both the direct and inherited permissions.

Acl property

Summary

The list of actors, their roles and the source of the inherited permission (if any).

PermissionsInherited type

Namespace

TrimbleCloud.FileService.Models

Summary

Represents the permissions inherited from the entire parent hierarchy applicable for the actor.

Acl property

Summary

The list of actors, their roles and the source of the inherited permission.

Provider type

Namespace

TrimbleCloud.FileService.Models

Summary

The cloud provider

AWS constants

Summary

Use AWS as the cloud provider

Azure constants

Summary

Use Azure as the cloud provider

Unknown constants

Summary

Unknown cloud provider

ResourceBase type

Namespace

TrimbleCloud.FileService.Models

Summary

Represents a resource of type File/Folder

CreatedAt property

Summary

The date and time when the file was created.

Id property

Summary

The unique identifier of the file.

Name property

Summary

The name of the file.

Type property

Summary

The type of the resource.

UpdatedAt property

Summary

The date and time when the file was last updated.

ResourceConverter type

Namespace

TrimbleCloud.FileService.Utilities

Summary

Utility class for converting resources in the File Service.

#ctor(complete) constructor

Summary

Constructor for ResourceConverter.

Parameters
NameTypeDescription
completeSystem.Boolean

CanConvert() method

Summary

Determines whether this converter can convert the specified object type

Parameters

This method has no parameters.

ReadJson() method

Summary

Reads JSON and converts it to a ResourceBase object based on the “type” field in the JSON

Parameters

This method has no parameters.

WriteJson() method

Summary

Writes JSON from the specified value.

Parameters

This method has no parameters.

ResourceListConverter type

Namespace

TrimbleCloud.FileService.Utilities

Summary

converts a JSON array of resources into a list of ResourceBase objects.

#ctor(complete) constructor

Summary

Constructor for ResourceListConverter.

Parameters
NameTypeDescription
completeSystem.Boolean

CanConvert() method

Summary

Determines whether this converter can convert the specified object type

Parameters

This method has no parameters.

ReadJson() method

Summary

Reads JSON and converts to List

Parameters

This method has no parameters.

WriteJson() method

Summary

Writes JSON from the specified value.

Parameters

This method has no parameters.

ResourceNotFoundException type

Namespace

TrimbleCloud.FileService

Summary

Exception thrown when a resource is not found

#ctor() constructor

Summary

Initializes a new instance of the ResourceNotFoundException class.

Parameters

This constructor has no parameters.

ResourceStatus type

Namespace

TrimbleCloud.FileService.Models

Summary

Represents the status of a resource.

Active constants

Summary

Active resources

All constants

Summary

Both active and deleted resources

Deleted constants

Summary

Deleted resources

Unknown constants

Summary

Unknown resource status

ResourceType type

Namespace

TrimbleCloud.FileService.Models

Summary

The type of resource

Export constants

Summary

Export

File constants

Summary

File

Folder constants

Summary

Folder

Job constants

Summary

Job

Object constants

Summary

Object

Space constants

Summary

Space

Unknown constants

Summary

Unknown

Upload constants

Summary

Upload

Response type

Namespace

TrimbleCloud.FileService

Summary

Represents a response.

ContentLength property

Summary

Returns the content length of the HTTP response.

IsError property

Summary

Indicates whether the status code of the returned response is considered an error code.

Metadata property

Summary

Get the HTTP response headers.

ReasonPhrase property

Summary

Gets the HTTP reason phrase.

RequestId property

Summary

Gets the client request id that was sent to the server as tcp-request-id headers.

ResponseContent property

Summary

Gets or sets the response content body.

Status property

Summary

Gets the HTTP status code.

Dispose() method

Summary

Frees resources held by this Response instance.

Parameters

This method has no parameters.

Dispose(disposing) method

Summary

Frees resources held by this Response instance.

Parameters
NameTypeDescription
disposingSystem.BooleanTrue if called from Dispose(), false if called from finalizer

FromValue“1(value,response) method

Summary

Creates a new instance of Response`1 with the provided value and HTTP response.

Returns

A new instance of Response`1 with the provided value and HTTP response.

Parameters
NameTypeDescription
value“0The value.
responseTrimbleCloud.FileService.ResponseThe HTTP response.
Generic Types
NameDescription
TThe type of the value.

ToString() method

Summary

Returns the string representation of this Response.

Returns

The string representation of this Response

Parameters

This method has no parameters.

Response`1 type

Namespace

TrimbleCloud.FileService

Summary

Represents a response.

Generic Types
NameDescription
TThe type of returned value.

Data property

Summary

Gets the value returned by the service. Accessing this property will throw if HasData is false.

HasData property

Summary

Gets a value indicating whether the current instance has a valid value of its underlying type.

GetResponse() method

Summary

Get HTTP raw response

Parameters

This method has no parameters.

op_Implicit(response) method

Summary

Returns the value of this Response`1 object.

Parameters
NameTypeDescription
responseTrimbleCloud.FileService.Response{`0})~`0The Response`1 instance.

Result type

Namespace

TrimbleCloud.FileService.Models

Summary

The input file information.

Message property

Summary

The additional information about the upload job. If the upload failed for any reason, the message will contain the error message.

Status property

Summary

The status of the upload operation.

RetentionPeriod type

Namespace

TrimbleCloud.FileService.Models

Summary

Represents the retention period for soft deleted resources in a filespace.

NeverDelete constants

Summary

Never delete resources

OneYear constants

Summary

Delete resources after 1 year

SixMonths constants

Summary

Delete resources after 180 days

ThirtyDays constants

Summary

Delete resources after 30 days

Unknown constants

Summary

Unknown retention period

Space type

Namespace

TrimbleCloud.FileService.Models

Summary

Represents a filespace in File Service.

AccountId property

Summary

The unique identifier of the CDH account.

AllowAnonymousShares property

Summary

Flag to allow anonymous access to resources in this space. When enabled, resources with anonymous ACL permissions (AclCustomIdentity(“anonymous”) with LimitedViewer role) can be accessed without authentication.

Capabilities property

Summary

The actions that can be performed on the resource by the current user.

CreatedAt property

Summary

The date and time when the filespace was created.

CreatedBy property

Summary

The TRN (Trimble Resource Name) of the user/device/application that created this filespace.

Deleted property

Summary

True if the space has been deleted.

DeletedAt property

Summary

The date and time when the filespace was deleted, if applicable.

Id property

Summary

The unique identifier of the filespace.

Name property

Summary

The name of the filespace.

PermissionsEvaluated property

Summary

Permissions evaluated for the actors on the resource. It shows the most permissible role applicable for the actor, considering both the direct and inherited permissions.

PermissionsLocal property

Summary

Permissions that are set directly for an actor on the resource itself.

Provider property

Summary

The cloud provider of the space.

ResourceTrn property

Summary

The TRN (Trimble Resource Name) of the filespace.

RootId property

Summary

The unique identifier of the root folder.

RootTrn property

Summary

The TRN (Trimble Resource Name) of the root folder.

SoftDeleteRetention property

Summary

Duration of soft deleted resources being retained before being permanently removed

SpaceMembershipBoundary property

Summary

The membership boundary configuration for the space. Defines group-based access controls and viewer permissions outside the boundary group.

Statistics property

Summary

The statistics of the space.

StorageMode property

Summary

The storage mode of the space

StorageModeUpdatedAt property

Summary

The date and time when the storage mode was last updated.

StorageModeUpdatedBy property

Summary

The TRN of the user who last updated the storage mode

Type property

Summary

The type of the resource.

UpdatedAt property

Summary

The date and time when the filespace was last updated.

UpdatedBy property

Summary

The TRN (Trimble Resource Name) of the user/device/application that last updated this filespace.

SpaceCreate type

Namespace

TrimbleCloud.FileService.Models

Summary

Represents a filespace creation request.

AccountId property

Summary

The unique identifier of the CDH account.

AllowAnonymousShares property

Summary

Flag to allow anonymous access to resources in this space. When enabled, resources with anonymous ACL permissions (AclCustomIdentity(“anonymous”) with LimitedViewer role) can be accessed without authentication.

Name property

Summary

The name of the filespace.

PermissionsLocal property

Summary

Permissions that are set directly for an actor on the resource itself.

Provider property

Summary

The cloud provider where the filespace will be created. Supported values are ‘AWS’ and ‘Azure’. Default: ‘AWS’

SoftDeleteRetention property

Summary

Duration of soft deleted resources being retained before being permanently removed. Supported values are ‘ThirtyDays’, ‘SixMonths’, ‘OneYear’, ‘NeverDelete’. Default: ‘ThirtyDays’

SpaceMembershipBoundary property

Summary

The membership boundary configuration for the space. Defines group-based access controls and viewer permissions outside the boundary group.

SpaceListFilterCriteria type

Namespace

TrimbleCloud.FileService.Models

Summary

Represents the criteria for filtering a list children of space.

ResourceType property

Summary

Gets or sets the type of the Resource to filter by.

SinceTime property

Summary

Gets or sets the time to filter the resources based on their last update time

Status property

Summary

Gets or sets the status of the space.

UrlDuration property

Summary

Gets or sets the duration for which the space URL is valid.

SpaceMembershipBoundary type

Namespace

TrimbleCloud.FileService.Models

Summary

Represents the membership boundary configuration for a space.

AllowLimitedViewerOutsideBoundaryGroup property

Summary

Indicates whether limited viewers outside the boundary group are allowed.

Group property

Summary

The TRN (Trimble Resource Name) of the group that defines the membership boundary.

SpacePermissionsLocal type

Namespace

TrimbleCloud.FileService.Models

Summary

Represents the permissions explicitly assigned to a space.

Acl property

Summary

The list of actors and their roles.

SpaceStatistics type

Namespace

TrimbleCloud.FileService.Models

Summary

Represents the statistics of a space.

ContentsUpdatedAt property

Summary

The date and time when the contents of the space were last updated.

DeletedFilesCount property

Summary

The count of all soft deleted files in the space.

DeletedFoldersCount property

Summary

The count of all soft deleted folders in the space.

DeletedSize property

Summary

The sum of sizes of all the soft deleted resources in the space in bytes.

DeletedSupportFilesSize property

Summary

The sum of sizes of all the soft deleted support files in the space in bytes.

FilesCount property

Summary

The count of all active files in the space.

FoldersCount property

Summary

The count of all active folders in the space.

Size property

Summary

The sum of sizes of all the active resources in the space in bytes.

SupportFilesSize property

Summary

The sum of size of all the active support files in the space in bytes.

TotalStorageUsed property

Summary

The total storage used by the space and its contents, including versions, in bytes.

SpaceUpdate type

Namespace

TrimbleCloud.FileService.Models

Summary

Represents a space update request.

AllowAnonymousShares property

Summary

Update flag to allow anonymous access to resources in this space. When enabled, resources with anonymous ACL permissions (AclCustomIdentity(“anonymous”) with LimitedViewer role) can be accessed without authentication.

Name property

Summary

Update the name of the space.

PermissionsLocal property

Summary

Update the permissions on the space.

SoftDeleteRetention property

Summary

Update the duration of soft deleted resources being retained before being permanently removed. Supported values are ‘ThirtyDays’, ‘SixMonths’, ‘OneYear’, ‘NeverDelete’. Default: ‘ThirtyDays’

SpaceMembershipBoundary property

Summary

Update the membership boundary configuration for the space. Defines group-based access controls and viewer permissions outside the boundary group.

StorageMode property

Summary

The storage mode of the space. Supported values are “active” (default - allows all operations) and “read-only” (restricts to read-only operations).

SpaceUpdateAcl type

Namespace

TrimbleCloud.FileService.Models

Summary

Represents a request to update space ACL.

Add property

Summary

Add new roles to the existing permissions on the resource. If an actor already has a permission on the resource and is included in the request again, their existing permissions will be replaced with the new ones specified.

Remove property

Summary

The actors to be removed from the permissions.

SpaceUpdatePermissionsLocal type

Namespace

TrimbleCloud.FileService.Models

Summary

Represents a space permissions update request. Note: Both ReplaceAcl and UpdateAcl cannot be used in the same request.

ReplaceAcl property

Summary

Completely replace the existing permissions on the resource. When this field is used, all previous permissions are overwritten by the new ones.

UpdateAcl property

Summary

Add or remove roles to the existing permissions on the resource.

SupportFileDetails type

Namespace

TrimbleCloud.FileService.Models

Summary

Represents support file details.

DownloadUrl property

Summary

The download url of the support file.

Id property

Summary

The unique identifier of the support file.

ResourceTrn property

Summary

The TRN (Trimble Resource Name) of the support file.

Version property

Summary

The version of the support file.

Namespace

TrimbleCloud.FileService.Models

Summary

Represents support file link.

Id property

Summary

The unique identifier of the support file.

Version property

Summary

The version of the support file.

SupportFileResource type

Namespace

TrimbleCloud.FileService.Models

Summary

Represents a support file resource for a package upload creation.

Metadata property

Summary

Additional information related to the support file.

Name property

Summary

The name of the support file.

ResponseHeaders property

Summary

Download HTTP response headers can be set here.

RestrictedAccess property

Summary

Set to false if the download url of the support file shouldn’t be expired. Whereas when true download url expiration takes place according to the configured value. Default: true

SupportFileKey property

Summary

The key of the support file.

SupportFileResourceDetails type

Namespace

TrimbleCloud.FileService.Models

Summary

Represents a support file resource details in package upload.

FileId property

Summary

The support file ID.

FileTrn property

Summary

The TRN (Trimble Resource Name) of the support file.

MD5 property

Summary

MD5 hash of the support file.

Metadata property

Summary

Additional information related to the support file.

Name property

Summary

The name of the support file.

ResponseHeaders property

Summary

Download HTTP response headers.

RestrictedAccess property

Summary

True if the download url of the support file shouldn’t expire.

Size property

Summary

The support file size in bytes.

Status property

Summary

The status of the support file upload.

SupportFileKey property

Summary

The key of the support file.

Upload property

Summary

The upload URL and type of upload for the support file.

Version property

Summary

The support file version.

SupportFileResourceUploadItem type

Namespace

TrimbleCloud.FileService.Models

Summary

Represents a support file upload item.

SupportFileKey property

Summary

The key of the support file.

SupportFileStream property

Summary

The corresponding support file stream.

SupportFileUploadCreate type

Namespace

TrimbleCloud.FileService.Models

Summary

Represents a support file creation request.

Summary

Whether the support file should be linked to the parent file

ExpiresAt property

Summary

Time period when the file object gets automatically removed. Must be at least 1 hour after the current time. Should not exceed 20 years from the current time.

Metadata property

Summary

Additional information related to the file.

Multipart property

Summary

True if the client will split the upload into multiple parts.

Name property

Summary

The name of the file.

ParentId property

Summary

The parent folder identifier to which the file has to be uploaded.

ParentMajorVersion property

Summary

Parent major version for support files.

ParentType property

Summary

The parent type. Defaults to File for support files linked to a file. Use Object when uploading support files for an object.

ResponseHeaders property

Summary

Download HTTP response headers.

RestrictedAccess property

Summary

True if the download url of the file shouldn’t expire.

SupportFileKey property

Summary

The key of the support file

TransferFileConfiguration type

Namespace

TrimbleCloud.FileService.Models

Summary

Configuration for chunked file upload and download transfers.

ChunkSize property

Summary

The size of the chunks in bytes. Default is 15MB.

MaxConcurrentRequests property

Summary

The number of concurrent upload or download tasks. Default is 8.

TrimbleServiceException type

Namespace

TrimbleCloud.FileService

Summary

Exception for Trimble service API errors

#ctor(message,response) constructor

Summary

Constructor used by the SDK to create service exceptions with complete error information.

Parameters
NameTypeDescription
messageSystem.StringError message
responseTrimbleCloud.FileService.ResponseResponse object that led to the exception

#ctor() constructor

Summary

Constructor used by the SDK to create service exceptions with complete error information.

Parameters

This constructor has no parameters.

#ctor(message,response,innerException) constructor

Summary

Constructor used by the SDK to create service exceptions with complete error information.

Parameters
NameTypeDescription
messageSystem.StringError message
responseTrimbleCloud.FileService.ResponseResponse object that led to the exception
innerExceptionSystem.ExceptionInner exception if any

#ctor(info,context) constructor

Summary

Protected constructor for deserialization

Parameters
NameTypeDescription
infoSystem.Runtime.Serialization.SerializationInfoSerialization info
contextSystem.Runtime.Serialization.StreamingContextStreaming context

_response constants

Summary

Gets the response, if any, that led to the exception.

RequestId property

Summary

Gets the request ID for tracking and support purposes.

StatusCode property

Summary

Gets the HTTP status code of the response. Returns 0 if response was not received.

GetObjectData() method

Summary

Inherit from parent.

Parameters

This method has no parameters.

GetRawResponse() method

Summary

Gets the response, if any, that led to the exception.

Returns

The response that caused this exception, or null if not available

Parameters

This method has no parameters.

ToString() method

Summary

Returns a string representation of the exception

Returns

Formatted error message

Parameters

This method has no parameters.

Upload type

Namespace

TrimbleCloud.FileService.Models

Summary

Contains the upload URL and upload type of a file.

Type property

Summary

The type of the file upload URL.

Url property

Summary

The URL to upload the file to.

UploadDetails type

Namespace

TrimbleCloud.FileService.Models

Summary

Represents an upload in File Service.

CreatedAt property

Summary

The date and time when the upload was created.

CreatedBy property

Summary

The TRN (Trimble Resource Name) of the user/device/application that created this upload.

FileInputUploadDetails property

Summary

Describes the structure of a file.

Id property

Summary

The unique identifier of the upload.

MD5 property

Summary

MD5 hash of the file.

ResourceTrn property

Summary

The TRN (Trimble Resource Name) of the upload.

Result property

Summary

The input file information.

Size property

Summary

The file size in bytes.

SupportFileResources property

Summary

The support file resources. Note: This field should be used only for package upload.

UpdatedAt property

Summary

The date and time when the upload was last updated.

UpdatedBy property

Summary

The TRN (Trimble Resource Name) of the user/device/application that last updated this upload.

Version property

Summary

The file version.

UploadRequest type

Namespace

TrimbleCloud.FileService.Models

Summary

Represents an upload request.

SpaceId property

Summary

The space identifier.

Stream property

Summary

The file stream.

UploadId property

Summary

The upload identifier.

Url property

Summary

The upload URL.

UrlDuration property

Summary

The upload URL’s validity duration. If not specified, defaults to 60 minutes (or 2 days for files larger than 10GB).

UploadStatus type

Namespace

TrimbleCloud.FileService.Models

Summary

The status of the upload operation

Completed constants

Summary

The file upload is completed

Failed constants

Summary

The file upload is failed

Running constants

Summary

The file is being uploaded

Unknown constants

Summary

Unknown status

Uploadable constants

Summary

The file is uploadable

UploadType type

Namespace

TrimbleCloud.FileService.Models

Summary

The type of the file upload URL

Multipart constants

Summary

Multipart upload

Singlepart constants

Summary

Singlepart upload

Unknown constants

Summary

Unknown type

Utility type

Namespace

TrimbleCloud.FileService.Utilities

ConvertUrlDuration(urlDuration) method

Summary

Converts a TimeSpan to a string in the format “Xm” where X is the number of minutes in the TimeSpan

Returns

The string representation of the TimeSpan

Parameters
NameTypeDescription
urlDurationSystem.Nullable{System.TimeSpan}The TimeSpan to convert to a string

ExtractExportId(input) method

Summary

Extracts a Guid representing the exportId from a string with the format “/spaces/{spaceId}/exports/{exportId}”.

Returns

The extracted exportId if the input is in the correct format and contains a valid Guid; otherwise, null.

Parameters
NameTypeDescription
inputSystem.StringThe input string from which the exportId should be extracted from.

ExtractJobId(input) method

Summary

Extracts a Guid representing the jobId from a string with the format “/jobs/{jobId}”.

Returns

The extracted Guid if the input is in the correct format and contains a valid Guid; otherwise, null.

Parameters
NameTypeDescription
inputSystem.StringThe input string from which to extract the jobId.

GetRetryPolicy(config) method

Summary

Gets retry policy for HTTP requests

Returns

The retry policy

Parameters
NameTypeDescription
configTrimbleCloud.FileService.FileServiceClientConfigThe configuration values

ToQueryString(parameters) method

Summary

Converts a dictionary of parameters to a query string

Returns

The query string

Parameters
NameTypeDescription
parametersSystem.Collections.Generic.IDictionary{System.String,System.String}The dictionary of parameters to convert to a query string