TrimbleCloud.FileService
TrimbleCloud.FileService
Contents
- APIBase
- Acl
- AclActor
- AclApplicationIdentity
- AclCustomIdentity
- AclDeviceIdentity
- AclIdentity
- AclIdentityConverter
- AclRole
- AclUserIdentity
- BatchFolderCreate
- BatchFolderList
- BatchMinimalFolderList
- BatchResourceListResponse
- Capabilities
- Checkout
- CopyFileRequest
- CopyFolderRequest
- Download
- DownloadUrlHelper
- EnumConverter`1
- EnumHelper`1
- Export
- File
- Capabilities
- Checkout
- CreatedBy
- Deleted
- DeletedAt
- Download
- ExpiresAt
- FileSet
- LastMalwareScanDate
- Links
- Lock
- MD5
- MalwareScanResult
- MalwareScanStatus
- MalwareType
- Metadata
- Multipart
- ParentId
- ParentTrn
- ParentType
- Path
- PermissionsEvaluated
- PermissionsInherited
- PermissionsLocal
- ResourceTrn
- ResponseHeaders
- RestrictedAccess
- Size
- SpaceId
- SpaceTrn
- Statistics
- UpdatedBy
- Version
- FileAcl
- FileInputUploadDetails
- FileOrFolder
- FilePart
- FilePermissionsLocal
- FileServiceClient
- FileServiceClientConfig
- FileStatistics
- FileStatus
- FileUpdate
- FileUpdateAcl
- FileUpdatePermissionsLocal
- FileUploadCreate
- FilesAPI
- Folder
- FolderCreate
- FolderCreateChild
- FolderCreateWithChildren
- FolderListChildrenRequest
- FolderListFilterCriteria
- FolderPermissionsLocal
- FolderStatistics
- FolderUpdate
- FolderUpdateAcl
- FolderUpdatePermissionsLocal
- GetJobQueryParams
- GetObjectParams
- GetObjectVersionParams
- GetUploadDetailsQueryParams
- HttpClientResponse
- IExportsAPI
- IFileServiceClient
- IFilesAPI
- CheckInFile(spaceId,fileId)
- CheckInFileWithMinimalResponse(spaceId,fileId)
- CheckOutFile(spaceId,fileId,reason,headers)
- CheckOutFileWithMinimalResponse(spaceId,fileId,reason,headers)
- CompleteMultipartUpload(spaceId,uploadId,parts)
- Copy(spaceId,fileId,targetParentId,name,includeSupportFiles,overwriteExisting)
- Copy(copyFileRequest)
- CopyWithMinimalResponse(spaceId,fileId,targetParentId,name,includeSupportFiles,overwriteExisting)
- CopyWithMinimalResponse(copyFileRequest)
- CreateFileUpload(spaceId,file,urlDuration,includeLinks)
- CreateFileUpload(spaceId,file,headers,urlDuration,includeLinks)
- CreateOrUpdateLinks(spaceId,fileId,fileMajorVersion,links)
- CreateOrUpdateLinksWithMinimalResponse(spaceId,fileId,fileMajorVersion,links)
- CreatePackageUpload(spaceId,packageUpload,urlDuration)
- CreatePackageUpload(spaceId,packageUpload,headers,urlDuration)
- CreateSupportFileUpload(spaceId,supportFile,urlDuration)
- CreateSupportFileUpload(spaceId,supportFile,headers,urlDuration)
- Delete(spaceId,fileId,permanent)
- Delete(spaceId,fileId,headers,permanent)
- Download(spaceId,fileId,stream,chunkSize,maxConcurrentRequests)
- Download(spaceId,path,stream,chunkSize,maxConcurrentRequests)
- Download(spaceId,fileId,stream,urlDuration,transferConfiguration)
- Download(spaceId,path,stream,urlDuration,transferConfiguration)
- Get(spaceId,fileId,status,urlDuration,responseContentType)
- Get(spaceId,path,status,urlDuration,responseContentType)
- GetUploadDetails(spaceId,uploadId,urlDuration)
- GetUploadDetails(spaceId,uploadId,queryParams)
- GetVersion(spaceId,fileId,versionId,status,urlDuration,responseContentType)
- GetVersion(spaceId,path,versionId,status,urlDuration,responseContentType)
- GetVersionWithMinimalResponse(spaceId,fileId,versionId,status,urlDuration,responseContentType)
- GetVersionWithMinimalResponse(spaceId,path,versionId,status,urlDuration,responseContentType)
- GetWithMinimalResponse(spaceId,fileId,status,urlDuration,responseContentType)
- GetWithMinimalResponse(spaceId,path,status,urlDuration,responseContentType)
- ListManifestFiles(spaceId,fileId,nextPageToken,maxItems,urlDuration)
- ListSupportFiles(spaceId,fileId,nextPageToken,maxItems,listFilter)
- ListSupportFiles(spaceId,path,nextPageToken,maxItems,listFilter)
- ListSupportFilesWithMinimalResponse(spaceId,fileId,nextPageToken,maxItems,listFilter)
- ListSupportFilesWithMinimalResponse(spaceId,path,nextPageToken,maxItems,listFilter)
- ListVersions(spaceId,fileId,nextPageToken,maxItems,listFilter)
- ListVersions(spaceId,path,nextPageToken,maxItems,listFilter)
- ListVersionsWithMinimalResponse(spaceId,fileId,nextPageToken,maxItems,listFilter)
- ListVersionsWithMinimalResponse(spaceId,path,nextPageToken,maxItems,listFilter)
- Lock(spaceId,fileId,reason)
- Lock(spaceId,fileId,headers,reason)
- LockWithMinimalResponse(spaceId,fileId,reason)
- LockWithMinimalResponse(spaceId,fileId,headers,reason)
- Move(spaceId,fileId,targetParentId,name)
- Move(spaceId,fileId,targetParentId,headers,name)
- MoveWithMinimalResponse(spaceId,fileId,targetParentId,name)
- MoveWithMinimalResponse(spaceId,fileId,targetParentId,headers,name)
- PollForMalwareScanCompletion(spaceId,fileId,timeout,interval,callback)
- Rename(spaceId,fileId,name)
- Rename(spaceId,fileId,name,headers)
- RenameWithMinimalResponse(spaceId,fileId,name)
- RenameWithMinimalResponse(spaceId,fileId,name,headers)
- Restore(spaceId,fileId,name,targetParentId)
- Restore(spaceId,fileId,headers,name,targetParentId)
- RestoreWithMinimalResponse(spaceId,fileId,name,targetParentId)
- RestoreWithMinimalResponse(spaceId,fileId,headers,name,targetParentId)
- Unlock(spaceId,fileId)
- UnlockWithMinimalResponse(spaceId,fileId)
- Update(spaceId,fileId,file)
- Update(spaceId,fileId,file,headers)
- UpdateWithMinimalResponse(spaceId,fileId,file)
- UpdateWithMinimalResponse(spaceId,fileId,file,headers)
- Upload(request,chunkSize,maxConcurrentRequests)
- Upload(request,chunkSize,maxConcurrentRequests)
- Upload(uploadDetails,stream,transferConfiguration)
- Upload(uploadDetails,mainFileStream,supportFiles,transferConfiguration)
- WaitForUpload(spaceId,uploadId,timeout,interval,callback)
- WaitForUpload(spaceId,uploadId,urlDuration,timeout,interval,callback)
- IFoldersAPI
- CheckInFolder(spaceId,folderId)
- CheckInFolderWithMinimalResponse(spaceId,folderId)
- CheckOutFolder(spaceId,folderId,reason,headers)
- CheckOutFolderWithMinimalResponse(spaceId,folderId,reason,headers)
- Copy(spaceId,folderId,targetParentId,name,includeSupportFiles,overwriteExisting)
- Copy(copyFolderRequest)
- CopyWithMinimalResponse(spaceId,folderId,targetParentId,name,includeSupportFiles,overwriteExisting)
- CopyWithMinimalResponse(copyFolderRequest)
- Create(spaceId,folder)
- CreateBatch(spaceId,folderRequest)
- CreateBatchWithMinimalResponse(spaceId,folderRequest)
- CreateWithMinimalResponse(spaceId,folder)
- Delete(spaceId,folderId,recursive,permanent)
- Delete(spaceId,folderId,headers,recursive,permanent)
- Get(spaceId,folderId,status)
- Get(spaceId,path,status)
- GetVersion(spaceId,folderId,versionId,status)
- GetVersion(spaceId,path,versionId,status)
- GetVersionWithMinimalResponse(spaceId,folderId,versionId,status)
- GetVersionWithMinimalResponse(spaceId,path,versionId,status)
- GetWithMinimalResponse(spaceId,folderId,status)
- GetWithMinimalResponse(spaceId,path,status)
- ListChildren(spaceId,folderId,nextPageToken,maxItems,listFilter,sortBy,sortOrder,recursive)
- ListChildren(spaceId,path,nextPageToken,maxItems,listFilter,sortBy,sortOrder,recursive)
- ListChildren(request)
- ListVersions(spaceId,folderId,nextPageToken,maxItems,status)
- ListVersions(spaceId,path,nextPageToken,maxItems,status)
- ListVersionsWithMinimalResponse(spaceId,folderId,nextPageToken,maxItems,status)
- ListVersionsWithMinimalResponse(spaceId,path,nextPageToken,maxItems,status)
- Move(spaceId,folderId,targetParentId,name)
- Move(spaceId,folderId,targetParentId,name,headers)
- MoveWithMinimalResponse(spaceId,folderId,targetParentId,name)
- MoveWithMinimalResponse(spaceId,folderId,targetParentId,name,headers)
- Rename(spaceId,folderId,name)
- Rename(spaceId,folderId,name,headers)
- RenameWithMinimalResponse(spaceId,folderId,name)
- RenameWithMinimalResponse(spaceId,folderId,name,headers)
- Restore(spaceId,folderId,name,targetParentId)
- Restore(spaceId,folderId,headers,name,targetParentId)
- RestoreWithMinimalResponse(spaceId,folderId,name,targetParentId)
- RestoreWithMinimalResponse(spaceId,folderId,headers,name,targetParentId)
- Update(spaceId,folderId,folder)
- Update(spaceId,folderId,folder,headers)
- UpdateWithMinimalResponse(spaceId,folderId,folder)
- UpdateWithMinimalResponse(spaceId,folderId,folder,headers)
- IJobsAPI
- IObjectTypesAPI
- IObjectsAPI
- Checkin(spaceId,objectId)
- Checkin(spaceId,objectId,headers)
- CheckinWithMinimalResponse(spaceId,objectId)
- CheckinWithMinimalResponse(spaceId,objectId,headers)
- Checkout(spaceId,objectId,reason)
- Checkout(spaceId,objectId,reason,headers)
- CheckoutWithMinimalResponse(spaceId,objectId,reason)
- CheckoutWithMinimalResponse(spaceId,objectId,reason,headers)
- Create(spaceId,request)
- CreateWithMinimalResponse(spaceId,request)
- Delete(spaceId,objectId,permanent)
- Delete(spaceId,objectId,permanent,headers)
- Get(spaceId,objectId)
- Get(spaceId,objectId,parameters)
- Get(spaceId,objectPath)
- Get(spaceId,objectPath,parameters)
- GetVersion(spaceId,objectId,versionId)
- GetVersion(spaceId,objectId,versionId,parameters)
- GetVersion(spaceId,objectPath,versionId)
- GetVersion(spaceId,objectPath,versionId,parameters)
- GetWithMinimalResponse(spaceId,objectId)
- GetWithMinimalResponse(spaceId,objectId,parameters)
- GetWithMinimalResponse(spaceId,objectPath)
- GetWithMinimalResponse(spaceId,objectPath,parameters)
- LinkSupportFiles(spaceId,objectId,request)
- LinkSupportFilesWithMinimalResponse(spaceId,objectId,request)
- ListResources(spaceId,objectId)
- ListResources(spaceId,objectId,parameters)
- ListResources(spaceId,objectPath)
- ListResources(spaceId,objectPath,parameters)
- ListResourcesWithMinimalResponse(spaceId,objectId)
- ListResourcesWithMinimalResponse(spaceId,objectId,parameters)
- ListResourcesWithMinimalResponse(spaceId,objectPath)
- ListResourcesWithMinimalResponse(spaceId,objectPath,parameters)
- ListVersions(spaceId,objectId)
- ListVersions(spaceId,objectId,parameters)
- ListVersions(spaceId,objectPath)
- ListVersions(spaceId,objectPath,parameters)
- ListVersionsWithMinimalResponse(spaceId,objectId)
- ListVersionsWithMinimalResponse(spaceId,objectId,parameters)
- ListVersionsWithMinimalResponse(spaceId,objectPath)
- ListVersionsWithMinimalResponse(spaceId,objectPath,parameters)
- Move(spaceId,objectId,targetParentId,name)
- Move(spaceId,objectId,targetParentId,name,headers)
- MoveWithMinimalResponse(spaceId,objectId,targetParentId,name)
- MoveWithMinimalResponse(spaceId,objectId,targetParentId,name,headers)
- Rename(spaceId,objectId,name)
- Rename(spaceId,objectId,name,headers)
- RenameWithMinimalResponse(spaceId,objectId,name)
- RenameWithMinimalResponse(spaceId,objectId,name,headers)
- Restore(spaceId,objectId,targetParentId,name)
- Restore(spaceId,objectId,targetParentId,name,headers)
- RestoreWithMinimalResponse(spaceId,objectId,targetParentId,name)
- RestoreWithMinimalResponse(spaceId,objectId,targetParentId,name,headers)
- Update(spaceId,objectId,request)
- Update(spaceId,objectId,request,headers)
- UpdateWithMinimalResponse(spaceId,objectId,request)
- UpdateWithMinimalResponse(spaceId,objectId,request,headers)
- IPage`1
- IResourcesAPI
- BatchGet(spaceId,resourceIds,status,urlDuration,responseContentType)
- BatchGet(spaceId,resourcePaths,status,urlDuration,responseContentType)
- BatchGetWithMinimalResponse(spaceId,resourceIds,status,urlDuration,responseContentType)
- BatchGetWithMinimalResponse(spaceId,resourcePaths,status,urlDuration,responseContentType)
- Get(spaceId,resourceId,status,urlDuration,responseContentType)
- Get(spaceId,resourcePath,status,urlDuration,responseContentType)
- GetWithMinimalResponse(spaceId,resourceId,status,urlDuration,responseContentType)
- GetWithMinimalResponse(spaceId,resourcePath,status,urlDuration,responseContentType)
- ISpacesAPI
- Create(space)
- CreateWithMinimalResponse(space)
- Delete(id,recursive,permanent)
- Get(id,status)
- GetWithMinimalResponse(id,status)
- ListChildren(spaceId,nextPageToken,maxItems,includeSupportFiles,listFilter,sortOrder)
- ListPublicResources(spaceId,nextPageToken,maxItems)
- Restore(id)
- RestoreWithMinimalResponse(id)
- Update(id,space)
- UpdateWithMinimalResponse(id,space)
- InheritedAcl
- InvalidFolderItem
- InvalidResourceItem
- Job
- JobStatus
- JobType
- JsonRawStringConverter
- ListFilterBase
- ListFilterCriteria
- ListObjectResourcesParams
- ListObjectVersionsParams
- ListQueryStringFormatter`1
- Lock
- MalwareScanStatus
- ManifestFile
- MinimalFile
- MinimalFolder
- MinimalObjectEntity
- MinimalObjectJobResponse
- MinimalSpace
- MinimalSpaceList
- ObjectAcl
- ObjectCheckin
- ObjectCheckout
- ObjectCreate
- ObjectDelete
- ObjectEntity
- ObjectJobResponse
- ObjectLink
- ObjectMove
- ObjectPermissionsLocal
- ObjectRename
- ObjectRestore
- ObjectStatistics
- ObjectSupportFileDetails
- ObjectType
- ObjectTypeCreate
- ObjectUpdate
- ObjectUpdateAcl
- ObjectUpdatePermissionsLocal
- ObjectUpdateSupportFileDetails
- Output
- PackageUploadCreate
- PackageUploadRequest
- Page`1
- ParentType
- PermissionsEvaluated
- PermissionsInherited
- Provider
- ResourceBase
- ResourceConverter
- ResourceListConverter
- ResourceNotFoundException
- ResourceStatus
- ResourceType
- Response
- Response`1
- Result
- RetentionPeriod
- Space
- SpaceCreate
- SpaceListFilterCriteria
- SpaceMembershipBoundary
- SpacePermissionsLocal
- SpaceStatistics
- SpaceUpdate
- SpaceUpdateAcl
- SpaceUpdatePermissionsLocal
- SupportFileDetails
- SupportFileLink
- SupportFileResource
- SupportFileResourceDetails
- SupportFileResourceUploadItem
- SupportFileUploadCreate
- TransferFileConfiguration
- TrimbleServiceException
- Upload
- UploadDetails
- UploadRequest
- UploadStatus
- UploadType
- Utility
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
| Name | Type | Description |
|---|---|---|
| message | System.Net.Http.HttpResponseMessage | The HTTP response message |
ThrowErrorAsync(response) method
Summary
Throws a TrimbleServiceException for HTTP error responses
Parameters
| Name | Type | Description |
|---|---|---|
| response | System.Net.Http.HttpResponseMessage | The HTTP response message |
Exceptions
| Name | Description |
|---|---|
| TrimbleCloud.FileService.TrimbleServiceException | Always 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
| Name | Type | Description |
|---|---|---|
| applicationId | System.Guid | The 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
| Name | Type | Description |
|---|---|---|
| entityTrn | System.String | The 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
| Name | Type | Description |
|---|---|---|
| deviceId | System.Guid | The 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
| Name | Type | Description |
|---|---|---|
| obj | System.Object | The 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
| Name | Type | Description |
|---|---|---|
| entityTrn | System.String | The 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
| Name | Type | Description |
|---|---|---|
| userId | System.Guid | The 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
| Name | Type | Description |
|---|---|---|
| url | System.String | The 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.
Links property
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.
AddToLinks property
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
| Name | Type | Description |
|---|---|---|
| httpClientProvider | Trimble.ID.IHttpClientProvider | A provider of a pre-configured HttpClient used for API calls made by this client |
Exceptions
| Name | Description |
|---|---|
| System.ArgumentNullException | Thrown when httpClientProvider is null |
#ctor(httpClientProvider,clientConfig) constructor
Summary
Public constructor for File Service client
Parameters
| Name | Type | Description |
|---|---|---|
| httpClientProvider | Trimble.ID.IHttpClientProvider | A provider of a pre-configured HttpClient used for API calls made by this client |
| clientConfig | TrimbleCloud.FileService.FileServiceClientConfig | The configuration values for the client |
#ctor(httpClientProvider,httpMessageHandler) constructor
Summary
Public constructor for File Service client
Parameters
| Name | Type | Description |
|---|---|---|
| httpClientProvider | Trimble.ID.IHttpClientProvider | A provider of a pre-configured HttpClient used for API calls made by this client |
| httpMessageHandler | System.Net.Http.HttpMessageHandler | The HttpMessageHandler to use the custom Http Message handler |
Exceptions
| Name | Description |
|---|---|
| System.ArgumentNullException | Thrown when httpClientProvider is null |
| System.ArgumentNullException | Thrown 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.
Links property
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
| Name | Type | Description |
|---|---|---|
| requestId | System.String | The request ID |
| responseMessage | System.Net.Http.HttpResponseMessage | The 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
| Name | Type | Description |
|---|---|---|
| disposing | System.Boolean | True 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| folderId | System.Guid | The folder ID |
| includeTopLevel | System.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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| exportId | System.Guid | The export ID |
| urlDuration | System.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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | |
| fileId | System.Guid |
CheckInFileWithMinimalResponse(spaceId,fileId) method
Summary
Checkin a file with minimal response
Returns
Parameters
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | |
| fileId | System.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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | |
| fileId | System.Guid | |
| reason | System.String | |
| headers | System.Collections.Generic.IDictionary{System.String,System.String} |
CheckOutFileWithMinimalResponse(spaceId,fileId,reason,headers) method
Summary
Checkout a file with minimal response
Returns
Parameters
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | |
| fileId | System.Guid | |
| reason | System.String | |
| headers | System.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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| uploadId | System.Guid | The upload ID |
| parts | System.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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| fileId | System.Guid | The file ID |
| targetParentId | System.Guid | The target parent ID |
| name | System.String | The new name of the copied file. If not specified, the file will be copied with its original name |
| includeSupportFiles | System.Boolean | Copy support files and links along with the files |
| overwriteExisting | System.Boolean | Whether 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
| Name | Type | Description |
|---|---|---|
| copyFileRequest | TrimbleCloud.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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| fileId | System.Guid | The file ID |
| targetParentId | System.Guid | The target parent ID |
| name | System.String | The new name of the copied file. If not specified, the file will be copied with its original name |
| includeSupportFiles | System.Boolean | Copy support files and links along with the file |
| overwriteExisting | System.Boolean | Whether 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
| Name | Type | Description |
|---|---|---|
| copyFileRequest | TrimbleCloud.FileService.Models.CopyFileRequest |
CreateFileUpload(spaceId,file,urlDuration,includeLinks) method
Summary
Create a file upload
Returns
A Task that resolves to Response that contains UploadDetails data on completion
Parameters
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| file | TrimbleCloud.FileService.Models.FileUploadCreate | The information of the file to create |
| urlDuration | System.Nullable{System.TimeSpan} | The file upload URL’s validity duration. Minimum value is 5 minutes and maximum value is 7 days. Default = 60 minutes |
| includeLinks | System.Boolean | Whether to include the links from the last version during a parent file’s major version change. |
CreateFileUpload(spaceId,file,headers,urlDuration,includeLinks) method
Summary
Create a file upload with custom headers
Returns
A Task that resolves to Response that contains UploadDetails data on completion
Parameters
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| file | TrimbleCloud.FileService.Models.FileUploadCreate | The information of the file to create |
| headers | System.Collections.Generic.IDictionary{System.String,System.String} | Dictionary of custom headers |
| urlDuration | System.Nullable{System.TimeSpan} | The file upload URL’s validity duration. Minimum value is 5 minutes and maximum value is 7 days. Default = 60 minutes |
| includeLinks | System.Boolean | Whether to include the links from the last version during a parent file’s major version change. |
CreateOrUpdateLinks(spaceId,fileId,fileMajorVersion,links) method
Summary
Create or update support file links of a file
Returns
A Task that resolves to Response that contains File data on completion
Parameters
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| fileId | System.Guid | The file ID |
| fileMajorVersion | System.Int32 | The major version of the file |
| links | System.Collections.Generic.IDictionary{System.String,TrimbleCloud.FileService.Models.SupportFileLink} | The links to create or update as dictionary of key and SupportFileLink |
CreateOrUpdateLinksWithMinimalResponse(spaceId,fileId,fileMajorVersion,links) method
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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| fileId | System.Guid | The file ID |
| fileMajorVersion | System.Int32 | The major version of the file |
| links | System.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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| packageUpload | TrimbleCloud.FileService.Models.PackageUploadCreate | The information of the package upload to create |
| urlDuration | System.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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| packageUpload | TrimbleCloud.FileService.Models.PackageUploadCreate | The information of the package upload to create |
| headers | System.Collections.Generic.IDictionary{System.String,System.String} | Dictionary of custom headers |
| urlDuration | System.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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| supportFile | TrimbleCloud.FileService.Models.SupportFileUploadCreate | The information of the support file to create |
| urlDuration | System.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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| supportFile | TrimbleCloud.FileService.Models.SupportFileUploadCreate | The information of the support file to create |
| headers | System.Collections.Generic.IDictionary{System.String,System.String} | Dictionary of custom headers |
| urlDuration | System.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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| fileId | System.Guid | The file ID |
| permanent | System.Boolean | Permanently 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| fileId | System.Guid | The file ID |
| headers | System.Collections.Generic.IDictionary{System.String,System.String} | Dictionary of custom headers |
| permanent | System.Boolean | Permanently 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| fileId | System.Guid | The file ID |
| stream | System.IO.Stream | The stream to write content to |
| chunkSize | System.Int32 | The size of the chunks in bytes if provided; otherwise 15MB chunks are used |
| maxConcurrentRequests | System.Int32 | The 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| path | System.String | The file path |
| stream | System.IO.Stream | The stream to write content to |
| chunkSize | System.Int32 | The size of the chunks in bytes if provided; otherwise 15MB chunks are used |
| maxConcurrentRequests | System.Int32 | The 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| fileId | System.Guid | The file ID |
| stream | System.IO.Stream | The stream to write content to |
| urlDuration | System.Nullable{System.TimeSpan} | The file download URL’s validity duration. Minimum value is 5 minutes and maximum value is 7 days. Default = 60 minutes |
| transferConfiguration | TrimbleCloud.FileService.Models.TransferFileConfiguration | Chunk 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| path | System.String | The file path |
| stream | System.IO.Stream | The stream to write content to |
| urlDuration | System.Nullable{System.TimeSpan} | The file download URL’s validity duration. Minimum value is 5 minutes and maximum value is 7 days. Default = 60 minutes |
| transferConfiguration | TrimbleCloud.FileService.Models.TransferFileConfiguration | Chunk 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| fileId | System.Guid | The file ID |
| status | TrimbleCloud.FileService.Models.ResourceStatus | The status of the file |
| urlDuration | System.Nullable{System.TimeSpan} | The file download URL’s validity duration. Minimum value is 5 minutes and maximum value is 7 days. Default = 60 minutes |
| responseContentType | System.String | Specify 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| path | System.String | The file path |
| status | TrimbleCloud.FileService.Models.ResourceStatus | The status of the file |
| urlDuration | System.Nullable{System.TimeSpan} | The file download URL’s validity duration. Minimum value is 5 minutes and maximum value is 7 days. Default = 60 minutes |
| responseContentType | System.String | Specify 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| uploadId | System.Guid | The upload ID |
| urlDuration | System.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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | |
| uploadId | System.Guid | |
| queryParams | TrimbleCloud.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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| fileId | System.Guid | The file ID |
| versionId | System.String | The version ID |
| status | TrimbleCloud.FileService.Models.ResourceStatus | The status of the file |
| urlDuration | System.Nullable{System.TimeSpan} | The file download URL’s validity duration. Minimum value is 5 minutes and maximum value is 7 days. Default = 60 minutes |
| responseContentType | System.String | Specify 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| path | System.String | The file path |
| versionId | System.String | The version ID |
| status | TrimbleCloud.FileService.Models.ResourceStatus | The status of the file |
| urlDuration | System.Nullable{System.TimeSpan} | The file download URL’s validity duration. Minimum value is 5 minutes and maximum value is 7 days. Default = 60 minutes |
| responseContentType | System.String | Specify 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| fileId | System.Guid | The file ID |
| versionId | System.String | The version ID |
| status | TrimbleCloud.FileService.Models.ResourceStatus | The status of the file |
| urlDuration | System.Nullable{System.TimeSpan} | The file download URL’s validity duration. Minimum value is 5 minutes and maximum value is 7 days. Default = 60 minutes |
| responseContentType | System.String | Specify 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| path | System.String | The file path |
| versionId | System.String | The version ID |
| status | TrimbleCloud.FileService.Models.ResourceStatus | The status of the file |
| urlDuration | System.Nullable{System.TimeSpan} | The file download URL’s validity duration. Minimum value is 5 minutes and maximum value is 7 days. Default = 60 minutes |
| responseContentType | System.String | Specify 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| fileId | System.Guid | The file ID |
| status | TrimbleCloud.FileService.Models.ResourceStatus | The status of the file |
| urlDuration | System.Nullable{System.TimeSpan} | The file download URL’s validity duration. Minimum value is 5 minutes and maximum value is 7 days. Default = 60 minutes |
| responseContentType | System.String | Specify 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| path | System.String | The file path |
| status | TrimbleCloud.FileService.Models.ResourceStatus | The status of the file |
| urlDuration | System.Nullable{System.TimeSpan} | The file download URL’s validity duration. Minimum value is 5 minutes and maximum value is 7 days. Default = 60 minutes |
| responseContentType | System.String | Specify 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | |
| fileId | System.Guid | |
| nextPageToken | System.String | |
| maxItems | System.Int32 | |
| urlDuration | System.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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| fileId | System.Guid | The file ID |
| nextPageToken | System.String | The token to retrieve the next page of items |
| maxItems | System.Int32 | The number of items to return in each page |
| listFilter | TrimbleCloud.FileService.Models.ListFilterCriteria | The 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| path | System.String | The file path |
| nextPageToken | System.String | The token to retrieve the next page of items |
| maxItems | System.Int32 | The number of items to return in each page |
| listFilter | TrimbleCloud.FileService.Models.ListFilterCriteria | The 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| fileId | System.Guid | The file ID |
| nextPageToken | System.String | The token to retrieve the next page of items |
| maxItems | System.Int32 | The number of items to return in each page |
| listFilter | TrimbleCloud.FileService.Models.ListFilterCriteria | The 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| path | System.String | The file path |
| nextPageToken | System.String | The token to retrieve the next page of items |
| maxItems | System.Int32 | The number of items to return in each page |
| listFilter | TrimbleCloud.FileService.Models.ListFilterCriteria | The 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| fileId | System.Guid | The file ID |
| nextPageToken | System.String | The token to retrieve the next page of items |
| maxItems | System.Int32 | The number of items to return in each page |
| listFilter | TrimbleCloud.FileService.Models.ListFilterCriteria | The 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| path | System.String | The file path |
| nextPageToken | System.String | The token to retrieve the next page of items |
| maxItems | System.Int32 | The number of items to return in each page |
| listFilter | TrimbleCloud.FileService.Models.ListFilterCriteria | The 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| fileId | System.Guid | The file ID |
| nextPageToken | System.String | The token to retrieve the next page of items |
| maxItems | System.Int32 | The number of items to return in each page |
| listFilter | TrimbleCloud.FileService.Models.ListFilterCriteria | The 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| path | System.String | The file path |
| nextPageToken | System.String | The token to retrieve the next page of items |
| maxItems | System.Int32 | The number of items to return in each page |
| listFilter | TrimbleCloud.FileService.Models.ListFilterCriteria | The 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| fileId | System.Guid | The file ID |
| reason | System.String | Reason 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| fileId | System.Guid | The file ID |
| headers | System.Collections.Generic.IDictionary{System.String,System.String} | Dictionary of custom headers |
| reason | System.String | Reason 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| fileId | System.Guid | The file ID |
| reason | System.String | Reason 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| fileId | System.Guid | The file ID |
| headers | System.Collections.Generic.IDictionary{System.String,System.String} | Dictionary of custom headers |
| reason | System.String | Reason 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| fileId | System.Guid | The file ID |
| targetParentId | System.Guid | The target parent ID |
| name | System.String | The 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| fileId | System.Guid | The file ID |
| targetParentId | System.Guid | The target parent ID |
| headers | System.Collections.Generic.IDictionary{System.String,System.String} | Dictionary of custom headers |
| name | System.String | The 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| fileId | System.Guid | The file ID |
| targetParentId | System.Guid | The target parent ID |
| name | System.String | The 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| fileId | System.Guid | The file ID |
| targetParentId | System.Guid | The target parent ID |
| headers | System.Collections.Generic.IDictionary{System.String,System.String} | Dictionary of custom headers |
| name | System.String | The 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| fileId | System.Guid | The file ID |
| timeout | System.Nullable{System.TimeSpan} | The maximum time to listen for the malware scan. Default is 3 minutes |
| interval | System.Nullable{System.TimeSpan} | The time interval to poll the malware scan status. Default is 5 seconds |
| callback | System.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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| fileId | System.Guid | The file ID |
| name | System.String | The 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| fileId | System.Guid | The file ID |
| name | System.String | The new name of the file |
| headers | System.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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| fileId | System.Guid | The file ID |
| name | System.String | The 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| fileId | System.Guid | The file ID |
| name | System.String | The new name of the file |
| headers | System.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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| fileId | System.Guid | The file ID |
| name | System.String | The new name of the restored file. If not specified, the file will be restored with its original name |
| targetParentId | System.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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| fileId | System.Guid | The file ID |
| headers | System.Collections.Generic.IDictionary{System.String,System.String} | Dictionary of custom headers |
| name | System.String | The new name of the restored file. If not specified, the file will be restored with its original name |
| targetParentId | System.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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| fileId | System.Guid | The file ID |
| name | System.String | The new name of the restored file. If not specified, the file will be restored with its original name |
| targetParentId | System.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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| fileId | System.Guid | The file ID |
| headers | System.Collections.Generic.IDictionary{System.String,System.String} | Dictionary of custom headers |
| name | System.String | The new name of the restored file. If not specified, the file will be restored with its original name |
| targetParentId | System.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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| fileId | System.Guid | The 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| fileId | System.Guid | The 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| fileId | System.Guid | The file ID |
| file | TrimbleCloud.FileService.Models.FileUpdate | The 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| fileId | System.Guid | The file ID |
| file | TrimbleCloud.FileService.Models.FileUpdate | The file information to update |
| headers | System.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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| fileId | System.Guid | The file ID |
| file | TrimbleCloud.FileService.Models.FileUpdate | The 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| fileId | System.Guid | The file ID |
| file | TrimbleCloud.FileService.Models.FileUpdate | The file information to update |
| headers | System.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
| Name | Type | Description |
|---|---|---|
| request | TrimbleCloud.FileService.Models.UploadRequest | The upload request |
| chunkSize | System.Int32 | The size of the chunks in bytes if provided; otherwise 15MB chunks are used |
| maxConcurrentRequests | System.Int32 | The 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
| Name | Type | Description |
|---|---|---|
| request | TrimbleCloud.FileService.Models.PackageUploadRequest | The package upload request |
| chunkSize | System.Int32 | The size of the chunks in bytes if provided; otherwise 15MB chunks are used |
| maxConcurrentRequests | System.Int32 | The 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
| Name | Type | Description |
|---|---|---|
| uploadDetails | TrimbleCloud.FileService.Models.UploadDetails | The pre-fetched upload details |
| stream | System.IO.Stream | The file stream to upload |
| transferConfiguration | TrimbleCloud.FileService.Models.TransferFileConfiguration | Chunk 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
| Name | Type | Description |
|---|---|---|
| uploadDetails | TrimbleCloud.FileService.Models.UploadDetails | The pre-fetched upload details |
| mainFileStream | System.IO.Stream | The main file stream to upload |
| supportFiles | System.Collections.Generic.IList{TrimbleCloud.FileService.Models.SupportFileResourceUploadItem} | The support files to upload |
| transferConfiguration | TrimbleCloud.FileService.Models.TransferFileConfiguration | Chunk 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| uploadId | System.Guid | The upload ID |
| timeout | System.Nullable{System.TimeSpan} | The maximum time to wait for the upload to finish. Default is 3 minutes |
| interval | System.Nullable{System.TimeSpan} | The time interval to poll the upload status. Default is 5 seconds |
| callback | System.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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| uploadId | System.Guid | The upload ID |
| urlDuration | System.Nullable{System.TimeSpan} | The upload URL’s validity duration. Minimum value is 5 minutes and maximum value is 7 days. Default = 60 minutes |
| timeout | System.Nullable{System.TimeSpan} | The maximum time to wait for the upload to finish. Default is 3 minutes |
| interval | System.Nullable{System.TimeSpan} | The time interval to poll the upload status. Default is 5 seconds |
| callback | System.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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | |
| folderId | System.Guid |
CheckInFolderWithMinimalResponse(spaceId,folderId) method
Summary
Checkin a folder with minimal response
Returns
Parameters
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | |
| folderId | System.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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | |
| folderId | System.Guid | |
| reason | System.String | |
| headers | System.Collections.Generic.IDictionary{System.String,System.String} |
CheckOutFolderWithMinimalResponse(spaceId,folderId,reason,headers) method
Summary
Checkout a folder with minimal response
Returns
Parameters
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | |
| folderId | System.Guid | |
| reason | System.String | |
| headers | System.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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| folderId | System.Guid | The folder ID |
| targetParentId | System.Guid | The target parent ID |
| name | System.String | The new name of the copied folder. If not specified, the folder will be copied with its original name |
| includeSupportFiles | System.Boolean | Copy support files and links along with the files |
| overwriteExisting | System.Boolean | Whether 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
| Name | Type | Description |
|---|---|---|
| copyFolderRequest | TrimbleCloud.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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| folderId | System.Guid | The folder ID |
| targetParentId | System.Guid | The target parent ID |
| name | System.String | The new name of the copied folder. If not specified, the folder will be copied with its original name |
| includeSupportFiles | System.Boolean | Copy support files and links along with the files |
| overwriteExisting | System.Boolean | Whether 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
| Name | Type | Description |
|---|---|---|
| copyFolderRequest | TrimbleCloud.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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| folder | TrimbleCloud.FileService.Models.FolderCreate | The 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | |
| folderRequest | TrimbleCloud.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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | |
| folderRequest | TrimbleCloud.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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| folder | TrimbleCloud.FileService.Models.FolderCreate | The 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| folderId | System.Guid | The folder ID |
| recursive | System.Boolean | Delete descendant folders and files |
| permanent | System.Boolean | Permanently 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| folderId | System.Guid | The folder ID |
| headers | System.Collections.Generic.IDictionary{System.String,System.String} | Custom HTTP headers to include in the request |
| recursive | System.Boolean | Delete descendant folders and files |
| permanent | System.Boolean | Permanently 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| folderId | System.Guid | The folder ID |
| status | TrimbleCloud.FileService.Models.ResourceStatus | The 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| path | System.String | The folder path |
| status | TrimbleCloud.FileService.Models.ResourceStatus | The 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| folderId | System.Guid | The folder ID |
| versionId | System.Int32 | The version ID |
| status | TrimbleCloud.FileService.Models.ResourceStatus | The 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| path | System.String | The folder path |
| versionId | System.Int32 | The version ID |
| status | TrimbleCloud.FileService.Models.ResourceStatus | The 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| folderId | System.Guid | The folder ID |
| versionId | System.Int32 | The version ID |
| status | TrimbleCloud.FileService.Models.ResourceStatus | The 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| path | System.String | The folder path |
| versionId | System.Int32 | The version ID |
| status | TrimbleCloud.FileService.Models.ResourceStatus | The 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| folderId | System.Guid | The folder ID |
| status | TrimbleCloud.FileService.Models.ResourceStatus | The 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| path | System.String | The folder path |
| status | TrimbleCloud.FileService.Models.ResourceStatus | The 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| folderId | System.Guid | The folder ID |
| nextPageToken | System.String | The token to retrieve the next page of items |
| maxItems | System.Int32 | The number of items to return in each page |
| listFilter | TrimbleCloud.FileService.Models.ListFilterCriteria | The filter to apply to the list |
| sortBy | System.String | |
| sortOrder | System.String | |
| recursive | System.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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| path | System.String | The folder path |
| nextPageToken | System.String | The token to retrieve the next page of items |
| maxItems | System.Int32 | The number of items to return in each page |
| listFilter | TrimbleCloud.FileService.Models.ListFilterCriteria | The filter to apply to the list |
| sortBy | System.String | |
| sortOrder | System.String | |
| recursive | System.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
| Name | Type | Description |
|---|---|---|
| request | TrimbleCloud.FileService.Models.FolderListChildrenRequest | The 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| folderId | System.Guid | The folder ID |
| nextPageToken | System.String | The token to retrieve the next page of items |
| maxItems | System.Int32 | The number of items to return in each page |
| status | TrimbleCloud.FileService.Models.ResourceStatus | The 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| path | System.String | The folder path |
| nextPageToken | System.String | The token to retrieve the next page of items |
| maxItems | System.Int32 | The number of items to return in each page |
| status | TrimbleCloud.FileService.Models.ResourceStatus | The 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| folderId | System.Guid | The folder ID |
| nextPageToken | System.String | The token to retrieve the next page of items |
| maxItems | System.Int32 | The number of items to return in each page |
| status | TrimbleCloud.FileService.Models.ResourceStatus | The 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| path | System.String | The folder path |
| nextPageToken | System.String | The token to retrieve the next page of items |
| maxItems | System.Int32 | The number of items to return in each page |
| status | TrimbleCloud.FileService.Models.ResourceStatus | The 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| folderId | System.Guid | The folder ID |
| targetParentId | System.Guid | The target parent ID |
| name | System.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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| folderId | System.Guid | The folder ID |
| targetParentId | System.Guid | The target parent ID |
| name | System.Collections.Generic.IDictionary{System.String,System.String} | |
| headers | System.String | Custom 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| folderId | System.Guid | The folder ID |
| targetParentId | System.Guid | The target parent ID |
| name | System.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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| folderId | System.Guid | The folder ID |
| targetParentId | System.Guid | The target parent ID |
| name | System.Collections.Generic.IDictionary{System.String,System.String} | |
| headers | System.String | Custom 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| folderId | System.Guid | The folder ID |
| name | System.String | The 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| folderId | System.Guid | The folder ID |
| name | System.String | The new name of the folder |
| headers | System.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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| folderId | System.Guid | The folder ID |
| name | System.String | The 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| folderId | System.Guid | The folder ID |
| name | System.String | The new name of the folder |
| headers | System.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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| folderId | System.Guid | The folder ID |
| name | System.String | The new name of the restored folder. If not specified, the folder will be restored with its original name |
| targetParentId | System.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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| folderId | System.Guid | The folder ID |
| headers | System.Collections.Generic.IDictionary{System.String,System.String} | Custom HTTP headers to include in the request |
| name | System.String | The new name of the restored folder. If not specified, the folder will be restored with its original name |
| targetParentId | System.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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| folderId | System.Guid | The folder ID |
| name | System.String | The new name of the restored folder. If not specified, the folder will be restored with its original name |
| targetParentId | System.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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| folderId | System.Guid | The folder ID |
| headers | System.Collections.Generic.IDictionary{System.String,System.String} | Custom HTTP headers to include in the request |
| name | System.String | The new name of the restored folder. If not specified, the folder will be restored with its original name |
| targetParentId | System.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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| folderId | System.Guid | The folder ID |
| folder | TrimbleCloud.FileService.Models.FolderUpdate | The 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| folderId | System.Guid | The folder ID |
| folder | TrimbleCloud.FileService.Models.FolderUpdate | The folder information to update |
| headers | System.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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| folderId | System.Guid | The folder ID |
| folder | TrimbleCloud.FileService.Models.FolderUpdate | The 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| folderId | System.Guid | The folder ID |
| folder | TrimbleCloud.FileService.Models.FolderUpdate | The folder information to update |
| headers | System.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
| Name | Type | Description |
|---|---|---|
| id | System.Guid | The job id |
Get(jobId,queryParams) method
Summary
Get a job given the job id
Returns
Parameters
| Name | Type | Description |
|---|---|---|
| jobId | System.Guid | |
| queryParams | TrimbleCloud.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
| Name | Type | Description |
|---|---|---|
| id | System.Guid | The job id |
| timeout | System.Nullable{System.TimeSpan} | The maximum time to wait for the job to finish. Default is 3 minutes |
| interval | System.Nullable{System.TimeSpan} | The time interval to poll the job status. Default is 5 seconds |
| callback | System.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
| Name | Type | Description |
|---|---|---|
| request | TrimbleCloud.FileService.Models.ObjectTypeCreate | The object type to create. |
Exceptions
| Name | Description |
|---|---|
| TrimbleCloud.FileService.TrimbleServiceException | Thrown when an API or network error occurs |
| System.ArgumentNullException | Thrown 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
| Name | Type | Description |
|---|---|---|
| objectTypeId | System.String | The object type ID. |
Exceptions
| Name | Description |
|---|---|
| TrimbleCloud.FileService.TrimbleServiceException | Thrown when an API or network error occurs |
| System.ArgumentException | Thrown 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID. |
| objectId | System.Guid | The 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID. |
| objectId | System.Guid | The object ID. |
| headers | System.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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID. |
| objectId | System.Guid | The 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID. |
| objectId | System.Guid | The object ID. |
| headers | System.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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID. |
| objectId | System.Guid | The object ID. |
| reason | System.String | The 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID. |
| objectId | System.Guid | The object ID. |
| reason | System.String | The reason for checkout. |
| headers | System.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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID. |
| objectId | System.Guid | The object ID. |
| reason | System.String | The 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID. |
| objectId | System.Guid | The object ID. |
| reason | System.String | The reason for checkout. |
| headers | System.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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID. |
| request | TrimbleCloud.FileService.Models.ObjectCreate | The 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID. |
| request | TrimbleCloud.FileService.Models.ObjectCreate | The create object request. |
Delete(spaceId,objectId,permanent) method
Summary
Deletes an object by ID.
Returns
A Task that resolves to Response on completion
Parameters
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID. |
| objectId | System.Guid | The object ID. |
| permanent | System.Boolean | Whether 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID. |
| objectId | System.Guid | The object ID. |
| permanent | System.Boolean | Whether to permanently delete the object. |
| headers | System.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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID. |
| objectId | System.Guid | The 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID. |
| objectId | System.Guid | The object ID. |
| parameters | TrimbleCloud.FileService.Models.GetObjectParams | The 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID. |
| objectPath | System.String | The 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID. |
| objectPath | System.String | The object path. |
| parameters | TrimbleCloud.FileService.Models.GetObjectParams | The 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID. |
| objectId | System.Guid | The object ID. |
| versionId | System.Int32 | The 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID. |
| objectId | System.Guid | The object ID. |
| versionId | System.Int32 | The version ID. |
| parameters | TrimbleCloud.FileService.Models.GetObjectVersionParams | The 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID. |
| objectPath | System.String | The object path. |
| versionId | System.Int32 | The 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID. |
| objectPath | System.String | The object path. |
| versionId | System.Int32 | The version ID. |
| parameters | TrimbleCloud.FileService.Models.GetObjectVersionParams | The 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID. |
| objectId | System.Guid | The 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID. |
| objectId | System.Guid | The object ID. |
| parameters | TrimbleCloud.FileService.Models.GetObjectParams | The 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID. |
| objectPath | System.String | The 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID. |
| objectPath | System.String | The object path. |
| parameters | TrimbleCloud.FileService.Models.GetObjectParams | The 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID. |
| objectId | System.Guid | The object ID. |
| request | TrimbleCloud.FileService.Models.ObjectLink | The 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID. |
| objectId | System.Guid | The object ID. |
| request | TrimbleCloud.FileService.Models.ObjectLink | The 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID. |
| objectId | System.Guid | The 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID. |
| objectId | System.Guid | The object ID. |
| parameters | TrimbleCloud.FileService.Models.ListObjectResourcesParams | The 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID. |
| objectPath | System.String | The 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID. |
| objectPath | System.String | The object path. |
| parameters | TrimbleCloud.FileService.Models.ListObjectResourcesParams | The 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID. |
| objectId | System.Guid | The 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID. |
| objectId | System.Guid | The object ID. |
| parameters | TrimbleCloud.FileService.Models.ListObjectResourcesParams | The 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID. |
| objectPath | System.String | The 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID. |
| objectPath | System.String | The object path. |
| parameters | TrimbleCloud.FileService.Models.ListObjectResourcesParams | The 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID. |
| objectId | System.Guid | The 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID. |
| objectId | System.Guid | The object ID. |
| parameters | TrimbleCloud.FileService.Models.ListObjectVersionsParams | The 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID. |
| objectPath | System.String | The 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID. |
| objectPath | System.String | The object path. |
| parameters | TrimbleCloud.FileService.Models.ListObjectVersionsParams | The 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID. |
| objectId | System.Guid | The 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID. |
| objectId | System.Guid | The object ID. |
| parameters | TrimbleCloud.FileService.Models.ListObjectVersionsParams | The 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID. |
| objectPath | System.String | The 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID. |
| objectPath | System.String | The object path. |
| parameters | TrimbleCloud.FileService.Models.ListObjectVersionsParams | The 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID. |
| objectId | System.Guid | The object ID. |
| targetParentId | System.Guid | The target parent folder ID. |
| name | System.String | The 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID. |
| objectId | System.Guid | The object ID. |
| targetParentId | System.Guid | The target parent folder ID. |
| name | System.String | The new name (optional). |
| headers | System.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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID. |
| objectId | System.Guid | The object ID. |
| targetParentId | System.Guid | The target parent folder ID. |
| name | System.String | The 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID. |
| objectId | System.Guid | The object ID. |
| targetParentId | System.Guid | The target parent folder ID. |
| name | System.String | The new name (optional). |
| headers | System.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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID. |
| objectId | System.Guid | The object ID. |
| name | System.String | The 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID. |
| objectId | System.Guid | The object ID. |
| name | System.String | The new name. |
| headers | System.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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID. |
| objectId | System.Guid | The object ID. |
| name | System.String | The 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID. |
| objectId | System.Guid | The object ID. |
| name | System.String | The new name. |
| headers | System.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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID. |
| objectId | System.Guid | The object ID. |
| targetParentId | System.Nullable{System.Guid} | The target parent folder ID (optional). |
| name | System.String | The 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID. |
| objectId | System.Guid | The object ID. |
| targetParentId | System.Nullable{System.Guid} | The target parent folder ID (optional). |
| name | System.String | The new name (optional). |
| headers | System.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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID. |
| objectId | System.Guid | The object ID. |
| targetParentId | System.Nullable{System.Guid} | The target parent folder ID (optional). |
| name | System.String | The 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID. |
| objectId | System.Guid | The object ID. |
| targetParentId | System.Nullable{System.Guid} | The target parent folder ID (optional). |
| name | System.String | The new name (optional). |
| headers | System.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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID. |
| objectId | System.Guid | The object ID. |
| request | TrimbleCloud.FileService.Models.ObjectUpdate | The 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID. |
| objectId | System.Guid | The object ID. |
| request | TrimbleCloud.FileService.Models.ObjectUpdate | The update request. |
| headers | System.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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID. |
| objectId | System.Guid | The object ID. |
| request | TrimbleCloud.FileService.Models.ObjectUpdate | The 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID. |
| objectId | System.Guid | The object ID. |
| request | TrimbleCloud.FileService.Models.ObjectUpdate | The update request. |
| headers | System.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
| Name | Description |
|---|---|
| T | The 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | |
| resourceIds | System.Collections.Generic.IList{System.Guid} | |
| status | TrimbleCloud.FileService.Models.ResourceStatus | |
| urlDuration | System.Nullable{System.TimeSpan} | |
| responseContentType | System.String |
BatchGet(spaceId,resourcePaths,status,urlDuration,responseContentType) method
Summary
batch gets resources by their paths
Returns
Parameters
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | |
| resourcePaths | System.Collections.Generic.IList{System.String} | |
| status | TrimbleCloud.FileService.Models.ResourceStatus | |
| urlDuration | System.Nullable{System.TimeSpan} | |
| responseContentType | System.String |
BatchGetWithMinimalResponse(spaceId,resourceIds,status,urlDuration,responseContentType) method
Summary
batch gets resources by their IDs with minimal response
Returns
Parameters
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | |
| resourceIds | System.Collections.Generic.IList{System.Guid} | |
| status | TrimbleCloud.FileService.Models.ResourceStatus | |
| urlDuration | System.Nullable{System.TimeSpan} | |
| responseContentType | System.String |
BatchGetWithMinimalResponse(spaceId,resourcePaths,status,urlDuration,responseContentType) method
Summary
batch gets resources by their paths with minimal response
Returns
Parameters
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | |
| resourcePaths | System.Collections.Generic.IList{System.String} | |
| status | TrimbleCloud.FileService.Models.ResourceStatus | |
| urlDuration | System.Nullable{System.TimeSpan} | |
| responseContentType | System.String |
Get(spaceId,resourceId,status,urlDuration,responseContentType) method
Summary
gets a resource by its ID
Returns
Parameters
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | |
| resourceId | System.Guid | |
| status | TrimbleCloud.FileService.Models.ResourceStatus | |
| urlDuration | System.Nullable{System.TimeSpan} | |
| responseContentType | System.String |
Get(spaceId,resourcePath,status,urlDuration,responseContentType) method
Summary
gets a resource by its path
Returns
Parameters
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | |
| resourcePath | System.String | |
| status | TrimbleCloud.FileService.Models.ResourceStatus | |
| urlDuration | System.Nullable{System.TimeSpan} | |
| responseContentType | System.String |
GetWithMinimalResponse(spaceId,resourceId,status,urlDuration,responseContentType) method
Summary
gets a resource by its ID with minimal response
Returns
Parameters
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | |
| resourceId | System.Guid | |
| status | TrimbleCloud.FileService.Models.ResourceStatus | |
| urlDuration | System.Nullable{System.TimeSpan} | |
| responseContentType | System.String |
GetWithMinimalResponse(spaceId,resourcePath,status,urlDuration,responseContentType) method
Summary
gets a resource by its path with minimal response
Returns
Parameters
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | |
| resourcePath | System.String | |
| status | TrimbleCloud.FileService.Models.ResourceStatus | |
| urlDuration | System.Nullable{System.TimeSpan} | |
| responseContentType | System.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
| Name | Type | Description |
|---|---|---|
| space | TrimbleCloud.FileService.Models.SpaceCreate | The 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
| Name | Type | Description |
|---|---|---|
| space | TrimbleCloud.FileService.Models.SpaceCreate | The 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
| Name | Type | Description |
|---|---|---|
| id | System.Guid | The space ID |
| recursive | System.Boolean | Delete descendant folders and files |
| permanent | System.Boolean | Permanently 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
| Name | Type | Description |
|---|---|---|
| id | System.Guid | The space ID |
| status | TrimbleCloud.FileService.Models.ResourceStatus | The 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
| Name | Type | Description |
|---|---|---|
| id | System.Guid | The space ID |
| status | TrimbleCloud.FileService.Models.ResourceStatus | The 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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| nextPageToken | System.String | The token to retrieve the next page of items |
| maxItems | System.Int32 | The number of items to return in each page |
| includeSupportFiles | System.Boolean | |
| listFilter | TrimbleCloud.FileService.Models.SpaceListFilterCriteria | The filter to apply to the list |
| sortOrder | System.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
| Name | Type | Description |
|---|---|---|
| spaceId | System.Guid | The space ID |
| nextPageToken | System.String | The token to retrieve the next page of items |
| maxItems | System.Int32 | The 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
| Name | Type | Description |
|---|---|---|
| id | System.Guid | The 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
| Name | Type | Description |
|---|---|---|
| id | System.Guid | The 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
| Name | Type | Description |
|---|---|---|
| id | System.Guid | The space ID |
| space | TrimbleCloud.FileService.Models.SpaceUpdate | The 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
| Name | Type | Description |
|---|---|---|
| id | System.Guid | The space ID |
| space | TrimbleCloud.FileService.Models.SpaceUpdate | The 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
| Name | Description |
|---|---|
| Newtonsoft.Json.JsonSerializationException | Thrown 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.
Links property
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.
ObjectLink type
Namespace
TrimbleCloud.FileService.Models
Summary
Represents a request to link support files to an object.
Links property
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.
Links property
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
| Name | Description |
|---|---|
| T | Type 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
| Name | Type | Description |
|---|---|---|
| complete | System.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
| Name | Type | Description |
|---|---|---|
| complete | System.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
| Name | Type | Description |
|---|---|---|
| disposing | System.Boolean | True 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
| Name | Type | Description |
|---|---|---|
| value | “0 | The value. |
| response | TrimbleCloud.FileService.Response | The HTTP response. |
Generic Types
| Name | Description |
|---|---|
| T | The 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
| Name | Description |
|---|---|
| T | The 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
| Name | Type | Description |
|---|---|---|
| response | TrimbleCloud.FileService.Response{`0})~`0 | The 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.
SupportFileLink type
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.
AddToLinks property
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
| Name | Type | Description |
|---|---|---|
| message | System.String | Error message |
| response | TrimbleCloud.FileService.Response | Response 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
| Name | Type | Description |
|---|---|---|
| message | System.String | Error message |
| response | TrimbleCloud.FileService.Response | Response object that led to the exception |
| innerException | System.Exception | Inner exception if any |
#ctor(info,context) constructor
Summary
Protected constructor for deserialization
Parameters
| Name | Type | Description |
|---|---|---|
| info | System.Runtime.Serialization.SerializationInfo | Serialization info |
| context | System.Runtime.Serialization.StreamingContext | Streaming 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
| Name | Type | Description |
|---|---|---|
| urlDuration | System.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
| Name | Type | Description |
|---|---|---|
| input | System.String | The 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
| Name | Type | Description |
|---|---|---|
| input | System.String | The input string from which to extract the jobId. |
GetRetryPolicy(config) method
Summary
Gets retry policy for HTTP requests
Returns
The retry policy
Parameters
| Name | Type | Description |
|---|---|---|
| config | TrimbleCloud.FileService.FileServiceClientConfig | The configuration values |
ToQueryString(parameters) method
Summary
Converts a dictionary of parameters to a query string
Returns
The query string
Parameters
| Name | Type | Description |
|---|---|---|
| parameters | System.Collections.Generic.IDictionary{System.String,System.String} | The dictionary of parameters to convert to a query string |