Skip to content

TrimbleCloud.Processing

TrimbleCloud.Processing.Model

ACR Token

ACR Token login command

ACR Token push command

ACR Token tag command

ACR Token upload status

TrimbleCloud.Processing

Base class for API requests

Extracts the request ID from the HTTP response headers

The request ID if present, otherwise an empty string

Name Type Description
message System.Net.Http.HttpResponseMessage The HTTP response message

Throws a TrimbleServiceException for HTTP error responses

Name Type Description
response System.Net.Http.HttpResponseMessage The HTTP response message
Name Description
TrimbleCloud.Processing.TrimbleServiceException Always thrown with error details (includes ArgumentNullException as inner exception if response is null)

TrimbleCloud.Processing.Model

Latest attempt details for the execution

Mapping of Operation-specified output parameter names to output parameter values for this attempt.

The time the attempt completed

The time the attempt failed

Attempt progress status

The time the attempt was submitted

TrimbleCloud.Processing.Model

Auto-scaling configuration

Maximum count

Minimum count

TrimbleCloud.Processing.Model

Client model

TrimbleCloud.Processing

API Methods relating to Trimble Cloud Platform Processing Framework executions

Read the current client

A Task that resolves to the current client on completion

This method has no parameters.

Name Description
System.Exception Thrown when the current client cannot be read

TrimbleCloud.Processing.Model

The configuration object to define the Engine-compute resources for memory and CPU allocation.

The amount of CPU to assign to a single instance of an Engine.

Optional GPU count for the Engine compute profile.

Optional GPU type for the Engine compute profile.

Whether the compute should be scheduled as interruptible/preemptible.

The amount of Memory to assign to a single instance of an Engine. The unit for this property is megabytes. For example, if an Engine requires 1GB of memory, then the `deployment.computing.memory` specification will be `1024`

Validate the compute parameters.

This method has no parameters.

TrimbleCloud.Processing

Constants used by the Trimble Cloud Processing Framework

TrimbleCloud.Processing.Model

Container upload

ACR Token

TrimbleCloud.Processing.Model

Container upload status

Available

Generating

Image received

Unavailable

Unknown status

TrimbleCloud.Processing.Model

Data type of the parameter

A list of parameters of any type

Boolean true/false (not surrounded by quotes)

An integer or a float

Any valid JSON object

Value must match an item in the options field

String text surrounded by double quotes

Unknown type

Wildcard type

TrimbleCloud.Processing.Model

Deployment create model

The account ID of the Deployment owner

Auto scaling configuration

The client ID of the Deployment owner

The configuration object to define the Engine-compute resources for memory and CPU allocation.

The description of the deployment.

The Engine Identifier to use for this deployment.

A Deployment Identifier is unique within the system.

The name of the deployment.

Optional projection of operations for specialized responses

The owner of the Deployment

region to deploy the deployment

Optional projection of secrets for specialized responses

Deployment status

TRN value of the Deployment

TrimbleCloud.Processing.Model

Deployment create model

Auto scaling configuration

The configuration object to define the Engine-compute resources for memory and CPU allocation.

The description of the deployment.

The Engine Identifier to use for this deployment.

A Deployment Identifier is unique within the system.

The name of the deployment.

The region this Deployment can run in

Validate the deployment creation parameters.

This method has no parameters.

TrimbleCloud.Processing.Model

Deployment List Filters

Filters resources by the Owner’s TID account identifier.

The active engine of a deployment

Filters resources by the Owner’s TID subject identifier (client ID).

Filters a resource based on owner

Filters a resource based on status.

TrimbleCloud.Processing.Model

Represents the Deployment Secret.

The account ID of the Deployment secret owner

The client ID of the Deployment secret owner

Deployment Secret description

The expected identifier of a Deployment Secret.

The name of the Deployment Secret.

The owner of the Deployment secret

The regions where the Deployment Secret is available.

Deployment status

TRN value of the deployment secret

The value of the Deployment Secret.

TrimbleCloud.Processing.Model

Represents a deployment secret creation.

Deployment Secret description

The expected identifier of a Deployment Secret.

The name of the Deployment Secret.

The value of the Deployment Secret.

Validate the deployment secret creation parameters.

This method has no parameters.

TrimbleCloud.Processing.Model

Represents the updation parameters for the deployment secret.

Deployment Secret description

The name of the Deployment Secret.

The value of the Deployment Secret.

Validate the deployment creation parameters.

This method has no parameters.

Name Description
System.ArgumentException

TrimbleCloud.Processing

Deployment Secrets API Resource

Create(deploymentId,deploymentSecretCreate) method

Section titled “Create(deploymentId,deploymentSecretCreate) method”

Create a deployment secret

A Task that resolves to the created deployment secret on completion

Name Type Description
deploymentId System.String The id of the deployment
deploymentSecretCreate TrimbleCloud.Processing.Model.DeploymentSecretCreate The value of the deployment secret to create
Name Description
System.Exception Thrown when a deployment secret cannot be created
TrimbleCloud.Processing.ValidationException Thrown when the deployment secret is invalid

Delete(deploymentId,deploymentSecretId) method

Section titled “Delete(deploymentId,deploymentSecretId) method”

Delete a deployment secret

An awaitiable Task

Name Type Description
deploymentId System.String The id of the deployment
deploymentSecretId System.String The identifier of the deployment secret to delete
Name Description
System.Exception Thrown when deployment secret cannot be deleted

Get(deploymentId,deploymentSecretId) method

Section titled “Get(deploymentId,deploymentSecretId) method”

Get deployment secret by id

A Task that resolves to the requested deployment secret on completion

Name Type Description
deploymentId System.String The id of the deployment
deploymentSecretId System.String The identifier of the deployment secret to read
Name Description
System.Exception Thrown when deployment secret cannot be read

Get a list of deployment secret

An asynchronous list of deployment secrets for the deployment

Name Type Description
deploymentId System.String The id of the deployment

List(deploymentId,page,pageSize,filters) method

Section titled “List(deploymentId,page,pageSize,filters) method”

Get a list of deployment secrets

An asynchronous list of deployment secrets for the deployment

Name Type Description
deploymentId System.String The id of the deployment
page System.Int32 The page number
pageSize System.Int32 The number of items per page
filters TrimbleCloud.Processing.Model.DeploymentSecretsListFilter Optional filters to apply to the list

Retire(deploymentId,deploymentSecretId) method

Section titled “Retire(deploymentId,deploymentSecretId) method”

Retire a deployment secret

A Task that resolves to the retired deployment secret on completion

Name Type Description
deploymentId System.String The id of the deployment
deploymentSecretId System.String The identifier of the deployment secret to retire
Name Description
System.Exception Thrown when deployment secret cannot be retired

Update(deploymentId,deploymentSecretId,deploymentSecretUpdate) method

Section titled “Update(deploymentId,deploymentSecretId,deploymentSecretUpdate) method”

Update a deployment secret

A Task that resolves to the updated deployment secret on completion

Name Type Description
deploymentId System.String The id of the deployment
deploymentSecretId System.String The identifier of the deployment secret to update
deploymentSecretUpdate TrimbleCloud.Processing.Model.DeploymentSecretUpdate The value of the deployment secret to update
Name Description
System.Exception Thrown when deployment secret cannot be updated

TrimbleCloud.Processing.Model

Deployment Secrets List Filters

Filters resources by the Owner’s TID account identifier.

Filters resources by the Owner’s TID subject identifier (client ID).

Filters resources by the Owner’s internal name. This is a legacy parameter; prefer using ClientId or AccountId instead.

TrimbleCloud.Processing.Model

Deployment status

available

Deleting

failed

Preparing

retired

being retired

submitted

Unknown status

Updating

TrimbleCloud.Processing.Model

Represents the updation parameters for the deployment.

Auto scaling configuration

The configuration object to define the Engine-compute resources for memory and CPU allocation.

Deployment description

The Engine ID that is connected to this Deployment.

The name of the Deployment. Max 64 chars

The region this Deployment can run in

Validate the deployment updation parameters.

This method has no parameters.

Name Description
System.ArgumentException

TrimbleCloud.Processing

Deployments API Resource

Create a deployment

A Task that resolves to the created deployment on completion

Name Type Description
deploymentCreate TrimbleCloud.Processing.Model.DeploymentCreate The value of the deployment to create
Name Description
System.Exception Thrown when an deployment cannot be created
TrimbleCloud.Processing.ValidationException Thrown when the deployment creation parameters are invalid

Delete a deployment

True if deletion succeeded

Name Type Description
id System.String The identifier of the deployment to delete
Name Description
System.Exception Thrown when a deployment cannot be deleted

Get deployment by id

A Task that resolves to the requested deployment on completion

Name Type Description
id System.String The identifier of the deployment to read
Name Description
System.Exception Thrown when the deployment cannot be read

Get a list of deployments

An asynchronous list of deployments

Name Type Description
engineId System.String The id of the engine

Get a list of deployments

An asynchronous list of deployments

Name Type Description
page System.Int32 The page number
pageSize System.Int32 The number of items per page
filters TrimbleCloud.Processing.Model.DeploymentListFilter The filters to apply

Retire a Deployment

A Task that resolves to the retired deployment on completion

Name Type Description
id System.String The identifier of the deployment to retire
Name Description
System.Exception Thrown when a deployment cannot be retired

Update a deployment

A Task that resolves to the updated deployment on completion

Name Type Description
id System.String The identifier of the deployment to update
deploymentUpdate TrimbleCloud.Processing.Model.DeploymentUpdate The value of the deployment to update
Name Description
System.Exception Thrown when the deployment cannot be updated

TrimbleCloud.Processing.Model

Represents the creation parameters for an engine.

The account ID of the Engine owner

The client ID of the Engine owner

Container upload

Engine description

Environment variables that are stored and ingested into the Engine’s container

Engine identifier, unique within the system

Engine ingestion type. Currently the only option is a temporary ACR token upload

The name of the Engine. Max 64 chars

Engine OS build. Specify which OS build to use. This is a required parameter for Windows Engines only. At this time, the Engines API directly supports Windows Server 2019 (10.0.17763), and can optionally support Windows Server 2022 (10.0.20348). If the latter is needed, please contact the team for assistance. Windows Server 2019 Windows Server 2022

Engine OS type

The owner of the Engine

Engine region

Secret files

Secret variables

Engine status

Engine status message

Engine tag

TRN value of the Engine

TrimbleCloud.Processing.Model

Represents the creation parameters for an engine.

Engine description

Environment variables that are stored and ingested into the Engine’s container

Engine identifier, unique within the system

Engine ingestion type. Currently the only option is a temporary ACR token upload

The name of the Engine. Max 64 chars

Engine OS build. Specify which OS build to use. This is a required parameter for Windows Engines only. At this time, the Engines API directly supports Windows Server 2019 (10.0.17763), and can optionally support Windows Server 2022 (10.0.20348). If the latter is needed, please contact the team for assistance. Windows Server 2019 Windows Server 2022

Engine OS type

Engine region

Secret files

Secret variables

Engine tag

Validate the engine creation parameters.

This method has no parameters.

Name Description
System.ArgumentException

TrimbleCloud.Processing.Model

Create Engine List Filters

Filters resources by the Owner’s TID account identifier.

Filters resources by the Owner’s TID subject identifier (client ID).

Filters a resource based on the Operating System name.

Filters a resource based on the owner name.

Filters a resource based on execution status.

TrimbleCloud.Processing.Model

Engine status

Engine is available

Awaiting image upload

Engine is failed

Generating token

Image uploaded

Engine is retired

Engine is being retired

Engine is submitted

Unknown status

TrimbleCloud.Processing.Model

Represents the updation parameters for an engine.

Engine description

The name of the Engine. Max 64 chars

Validate the engine creation parameters.

This method has no parameters.

Name Description
TrimbleCloud.Processing.ValidationException

TrimbleCloud.Processing

Engines API Resource

Create an engine

A Task that resolves to the created engine on completion

Name Type Description
engineCreate TrimbleCloud.Processing.Model.EngineCreate The value of the engine to create
Name Description
System.Exception Thrown when an engine cannot be created
TrimbleCloud.Processing.ValidationException Thrown when the engine update is invalid

Delete an engine

An awaitiable Task

Name Type Description
id System.String The identifier of the engine to delete
Name Description
System.Exception Thrown when engine cannot be deleted

Get an engine by id

A Task that resolves to the requested engine on completion

Name Type Description
id System.String The identifier of the engine to read
Name Description
System.Exception Thrown when an engine cannot be read

Get a list of engines

An asynchronous list of engines

This method has no parameters.

Get a list of engines

An asynchronous list of engines

Name Type Description
page System.Int32 The page number
pageSize System.Int32 The number of items per page
filters TrimbleCloud.Processing.Model.EngineListFilter The filters to apply

Retire an engine

A Task that resolves to the retired engine on completion

Name Type Description
id System.String The identifier of the engine to retire
Name Description
System.Exception Thrown when an engine cannot be retired

Update an engine

A Task that resolves to the updated engine on completion

Name Type Description
id System.String The identifier of the engine to update
engineUpdate TrimbleCloud.Processing.Model.EngineUpdate The value of the engine to update
Name Description
System.Exception Thrown when an engine cannot be updated
TrimbleCloud.Processing.ValidationException Thrown when the engine update is invalid

TrimbleCloud.Processing

Generic converter for enums

Read an enum value from a JSON string

This method has no parameters.

TrimbleCloud.Processing.Helper

Helper class for Enum

Get the EnumMember value of an Enum

This method has no parameters.

TrimbleCloud.Processing.Model

Represents the environment variables.

The name of the environment variable.

The value of the environment variable.

Validate the environment variables.

This method has no parameters.

TrimbleCloud.Processing.Model

Execution model

Mapping of Operation-specified output parameter names to output parameter values. This is where Operation output parameters are written once an Operation within the Execution completes.

The time the execution is completed

Whether or not the execution’s data will be available for export. Default to false.

ID of the execution schedule that created this execution.

The logical execution status (READY/NOT_READY/etc.)

The time the execution is failed

The latest execution attempt summary

The metadata of the execution.

Mapping of Procedure-specified parameter names to parameter values.

The underlying Procedure definition. Only included in the Execution response when the details parameter is set to true. This parameter is restricted to BACKEND access level only. Default is false.

ID of the procedure to execute.

The identifier of the Procedure that supports this Operation.

The version of the Procedure that supports this Operation.

region where the execution will be run.

Execution status

The time the execution was submitted

TrimbleCloud.Processing.Model

Execution Activity response class model

Activity Id

Historical Information about the activity

TrimbleCloud.Processing.Model

ExecutionCreate

Mapping of Operation-specified output parameter names to output parameter values. This is where Operation output parameters are written once an Operation within the Execution completes.

Whether or not the execution’s data will be available for export. Default to false.

The metadata of the execution.

Mapping of Procedure-specified parameter names to parameter values.

ID of the procedure to execute.

The identifier of the Procedure that supports this Operation.

The version of the Procedure that supports this Operation.

region where the execution will be run.

Converts the object to a JSON string

This method has no parameters.

Validate the creation of an execution

This method has no parameters.

TrimbleCloud.Processing.Model

Request payload for posting engine data/logs for an execution.

The execution identifier.

Output path provided by the engine.

Validate the request payload.

This method has no parameters.

TrimbleCloud.Processing.Model

Execution Event response class model

The type of Execution Event that is being described. It can be either object or string.

Created At

The type of Execution Event that is being described.

Updated At

TrimbleCloud.Processing.Model

Execution List Filters

Filter results that have a completed_at time that is after the supplied value.

Filter results that have a completed_at time that is before the supplied value.

Filter results that have a created_at time that is after the supplied value.

Filter results that have a created_at time that is before the supplied value.

Filters a resource based on execution status.

Filters a resource based on the procedure identifier.

Sort by field

TrimbleCloud.Processing.Model.Execution

Execution status enumeration

Execution is currently being executed

Execution has failed

Execution has been completed

Execution is queued

Execution has been submitted and is waiting to be processed

Unknown status

Execution has not been submitted yet

Execution is currently being waited

TrimbleCloud.Processing.Model

Sort options for execution list

Sort by completed_at in ascending order

Sort by completed_at in descending order

Sort by created_at in ascending order

Sort by created_at in descending order

TrimbleCloud.Processing.Model

The execution status of the operation.

This Operation cannot be used to create any Procedures and thus cannot be part of an execution.

This Operation can now by used to create Procedures and thus be part of executions.

The processing of this Operation has been suspended and cannot be part of executions.

Unknown status

TrimbleCloud.Processing

API Methods relating to Trimble Cloud Platform Processing Framework executions

Create an execution

A Task that resolves to the created execution on completion

Name Type Description
executionCreate TrimbleCloud.Processing.Model.ExecutionCreate The value of the execution to create
Name Description
System.Exception Thrown when an execution cannot be created

Get an execution by id

A Task that resolves to the requested execution on completion

Name Type Description
id System.String The identifier of the execution to read
details System.Nullable{System.Boolean} Optional flag to request detailed view
Name Description
System.Exception Thrown when an execution cannot be read

GetExecutionData(engineDataRequest) method

Section titled “GetExecutionData(engineDataRequest) method”

Post engine data for executions

A Task that resolves to the execution response on completion

Name Type Description
engineDataRequest TrimbleCloud.Processing.Model.ExecutionEngineRequest Engine data request payload

GetExecutionLogs(engineLogsRequest) method

Section titled “GetExecutionLogs(engineLogsRequest) method”

Post engine logs for executions

A Task that resolves to the execution response on completion

Name Type Description
engineLogsRequest TrimbleCloud.Processing.Model.ExecutionEngineRequest Engine logs request payload

Get a list of executions

An asynchronous list of executions

Name Type Description
page System.Int32 The page number to retrieve
pageSize System.Int32 The number of items per page
filters TrimbleCloud.Processing.Model.ExecutionListFilter The filters to apply to the list

ListActivities(executionId,page,pageSize) method

Section titled “ListActivities(executionId,page,pageSize) method”

Get a list of execution activities

An asynchronous list of execution activities

Name Type Description
executionId System.String The identifier of the execution to retrieve activities for
page System.Int32 The page number to retrieve
pageSize System.Int32 The number of items per page

ListEvents(executionId,page,pageSize) method

Section titled “ListEvents(executionId,page,pageSize) method”

Get the events tied to an Execution. Events are logged by the Log Events for an Execution request.

An asynchronous list of execution events

Name Type Description
executionId System.String The identifier of the execution to retrieve activities for
page System.Int32 The page number to retrieve
pageSize System.Int32 The number of items per page

TrimbleCloud.Processing.Model

Historical Info class

Activity Task Completed

Activity Task Scheduled

Activity Task Started

TrimbleCloud.Processing

HTTP client response implementation for the common Response class

#ctor(requestId,responseMessage) constructor

Section titled “#ctor(requestId,responseMessage) constructor”

Initializes a new instance of the HttpClientResponse class

Name Type Description
requestId System.String The request ID
responseMessage System.Net.Http.HttpResponseMessage The HTTP response message

Gets the content length of the response

Gets a value indicating whether this response represents an error

Gets the response headers as metadata

Gets the HTTP reason phrase

Gets or sets the request ID

Gets the HTTP status code

Disposes the underlying HTTP response message

This method has no parameters.

Returns the string representation of the HTTP response

String representation of the response

This method has no parameters.

TrimbleCloud.Processing

Defines a page interface

Name Description
T The type of item in the page.

The number of items in the page.

The items in the page.

The number of items per page.

The total number of items available.

The total number of pages available.

TrimbleCloud.Processing.Model

Ingestion type

A unique and temporary ACR token will be generated on your behalf so that you may upload a container image into our system. The API will provide a set of commands in the ‘container_upload’ object that will allow you login and upload your container image.

Unknown status

TrimbleCloud.Processing.Model

Input parameters for an operation

List of accepted input data types.

Description of the input

Name of the input

Is the parameter optional. Defaults to false

Validate the inputs

This method has no parameters.

TrimbleCloud.Processing.Model

List Filter Base

Identifier of the resource

Region

TrimbleCloud.Processing.Model

OS Type

Create a linux Engine.

Unknown status

Create a windows Engine.

TrimbleCloud.Processing.Model

Operation input class

TrimbleCloud.Processing.Model.Procedure.OperationChain

Operation input class

TrimbleCloud.Processing.Model

Operation output class

TrimbleCloud.Processing.Model.Procedure.OperationChain

Operation output class

TrimbleCloud.Processing.Model.Procedure.OperationChain

Operation parameter class

Is the parameter optional. Defaults to false

The source of the Operation parameter

TrimbleCloud.Processing.Model

Operation parameter class

Is the parameter optional. Defaults to false

The source of the Operation parameter

TrimbleCloud.Processing.Model

Operation model

The account ID of the Operation owner

The client ID of the Operation owner

The identifier of the Deployment that supports this Operation.

Message given to indicate impending retirement/deprecation

The description of the operation.

Indicates whether or not the Output content is considered dynamic or not. In all cases except for the Switcher Operation, this will be false

The name of the backend engine that supports this Operation. (Deprecated: Use DeploymentIdentifier instead.)

The execution status of the operation.

The identifier of the operation.

Named inputs for the Operation. This is an object containing one or more inputs that describe the data types which will be accepted as input to the Operation.

The state of the Operation’s publication. If true, the Operation is available for public use. This is not unlike sharing it with every other User in the system. If this field is false, then it follows the normal rules with regard to sharing and individual ownership.

The name of the operation.

A list of parameter objects that define values to be output from an Operation.

Named outputs for the Operation. This is an object containing one or more outputs that emit data. Each such output specifies a single output data type.

The owner of the Operation

A list of parameter objects attached to the Operation.

Allowable locations that a particular Operation can run in.

Timestamp indicating when this Operation will move to RETIRED status, and will no longer be executable

List of names of Users with whom this Operation has been shared.

List of identities with whom this Operation has been shared. Each entry contains an account_id (required) and optionally a client_id.

The status of the operation.

The version of the operation.

TrimbleCloud.Processing.Model

OperationChain class

TrimbleCloud.Processing.Model.Procedure

OperationChain class

The description of the operation.

name of the Engine

The identifier of the operation.

The name of the operation.

A list of parameter objects that define values to be output from an Operation.

The version of the operation.

The description of the operation.

List of encrypted parameters

name of the Engine

The identifier of the operation.

The name of the operation.

A list of parameter objects that define values to be output from an Operation.

The version of the operation.

Validate the Operation object.

This method has no parameters.

Name Description
TrimbleCloud.Processing.ValidationException

TrimbleCloud.Processing.Model

Represents OperationCreate.

The identifier of the Deployment that supports this Operation.

The description of the operation.

Indicates whether or not the Output content is considered dynamic or not. In all cases except for the Switcher Operation, this will be false

The name of the backend engine that supports this Operation. (Deprecated: Use DeploymentIdentifier instead.)

The identifier of the operation.

Named inputs for the Operation. This is an object containing one or more inputs that describe the data types which will be accepted as input to the Operation.

The state of the Operation’s publication. (Deprecated: Use Publish method to make an Operation public.)

The name of the operation.

A list of parameter objects that define values to be output from an Operation.

Named outputs for the Operation. This is an object containing one or more outputs that emit data. Each such output specifies a single output data type.

A list of parameter objects attached to the Operation.

Allowable locations that a particular Operation can run in.

List of names of Users with whom this Operation has been shared.

List of identities with whom this Operation has been shared. Each entry contains an account_id (required) and optionally a client_id. An entry with only account_id grants access to all clients in that account. An entry with both client_id and account_id grants access to that specific client only. Sending an array replaces the existing list, not append to it.

The version of the operation.

Validate the operation creation parameters.

This method has no parameters.

TrimbleCloud.Processing.Model

Operation List Filters

Filters a resource based on the Deployment identifier.

Filters a resource based on the Engine name.

Filters a resource based on execution status.

Filters a resource based on the Procedure identifier.

Filters results by public status

Filters a resource based on status

TrimbleCloud.Processing.Model

Represents OperationUpdate.

The identifier of the Deployment that supports this Operation.

The description of the operation.

Indicates whether or not the Output content is considered dynamic or not. In all cases except for the Switcher Operation, this will be false

The name of the backend engine that supports this Operation. (Deprecated: Use DeploymentIdentifier instead.)

The identifier of the operation.

Named inputs for the Operation. This is an object containing one or more inputs that describe the data types which will be accepted as input to the Operation.

The state of the Operation’s publication. If true, the Operation is available for public use. This is not unlike sharing it with every other User in the system. If this field is false, then it follows the normal rules with regard to sharing and individual ownership.

The name of the operation.

A list of parameter objects that define values to be output from an Operation.

Named outputs for the Operation. This is an object containing one or more outputs that emit data. Each such output specifies a single output data type.

A list of parameter objects attached to the Operation.

Allowable locations that a particular Operation can run in.

List of names of Users with whom this Operation has been shared.

List of identities with whom this Operation has been shared. Each entry contains an account_id (required) and optionally a client_id. An entry with only account_id grants access to all clients in that account. An entry with both client_id and account_id grants access to that specific client only. Sending an array replaces the existing list, not append to it.

The version of the operation.

Validate the operation creation parameters.

This method has no parameters.

TrimbleCloud.Processing

API Methods relating to Trimble Cloud Platform Processing Framework operations

Approve an operation

A Task that resolves to the approved operation on completion

Name Type Description
id System.String The identifier of the operation to approve
Name Description
System.Exception Thrown when a operation cannot be approved

Clone an operation

A Task that resolves to the newly cloned operation on completion

Name Type Description
id System.String The identifier of the operation to clone
Name Description
System.Exception Thrown when a operation cannot be cloned

Create an operation

A Task that resolves to the created operation on completion

Name Type Description
operationCreate TrimbleCloud.Processing.Model.OperationCreate The value of the operation to create
Name Description
System.Exception Thrown when an operation cannot be created
TrimbleCloud.Processing.ValidationException Thrown when the operation update is invalid

Delete an operation

An awaitiable Task

Name Type Description
id System.String The identifier of the operation to delete
Name Description
System.Exception Thrown when a operation cannot be deleted

Get an operation by id

A Task that resolves to the requested operation on completion

Name Type Description
id System.String The identifier of the operation to read
Name Description
System.Exception Thrown when a operation cannot be read

Get a list of operations

An asynchronous list of operations

Name Type Description
include_public System.Boolean Whether to include public operations in the returned list

Get a list of operations

An asynchronous list of operations

Name Type Description
page System.Int32 The page number to retrieve
pageSize System.Int32 The number of items per page
filters TrimbleCloud.Processing.Model.OperationListFilter The filters to apply to the list

Publish an operation

A Task that resolves to the published operation on completion

Name Type Description
id System.String The identifier of the operation to publish
Name Description
System.Exception Thrown when a operation cannot be published

Retire an operation

A Task that resolves to the retired operation on completion

Name Type Description
id System.String The identifier of the operation to retire
Name Description
System.Exception Thrown when a operation cannot be retired

Update an operation

A Task that resolves to the updated operation on completion

Name Type Description
id System.String The identifier of the operation to update
operationUpdate TrimbleCloud.Processing.Model.OperationUpdate The value of the operation to update
Name Description
System.Exception Thrown when a operation cannot be updated
TrimbleCloud.Processing.ValidationException Thrown when the operation update is invalid

TrimbleCloud.Processing.Model

Input parameters for an operation

Type of data output from the Operation

Description of the output

Name of the output

Validate the output

This method has no parameters.

TrimbleCloud.Processing.Model

Represents a OutputParameter.

A description of the parameter

Human-readable name for the parameter.

Is the parameter optional. Defaults to false

The type of the parameter.

Validate the parameter.

This method has no parameters.

Name Description
TrimbleCloud.Processing.ValidationException

TrimbleCloud.Processing

Defines a page in responses.

Name Description
T Type of the page content items

The number of items in the page.

The items in the page.

The number of items per page.

The total number of items available.

The total number of pages available.

Returns an enumerator that iterates through the collection.

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

This method has no parameters.

System#Collections#IEnumerable#GetEnumerator() method

Section titled “System#Collections#IEnumerable#GetEnumerator() method”

Returns an enumerator that iterates through the collection.

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

This method has no parameters.

TrimbleCloud.Processing.Model

Represents a parameter.

A description of the parameter

Indicates that the parameter contains sensitive information. Defaults to false

Human-readable name for the parameter.

Is the parameter optional. Defaults to false

List of options for the parameter

The type of the parameter.

Validate the parameter.

This method has no parameters.

Name Description
TrimbleCloud.Processing.ValidationException

TrimbleCloud.Processing.Model

Procedure model

The account ID of the Procedure owner

The client ID of the Procedure owner

The default region for the Procedure

Description of the Procedure

URL to external documentation for the Procedure

The execution status of the Procedure

Identifier of the Procedure

IsPublic

The name of the Procedure

This is the definition of Procedure contents and how inputs & outputs are linked together between individual Operations

The owner of the Procedure

The user will specify parameter values via these mapping names

regions

Timestamp indicating when this Operation will move to RETIRED status, and will no longer be executable

List of names of Users with whom this Procedure has been shared.

List of identities with whom this Procedure has been shared. Each entry contains an account_id (required) and optionally a client_id.

The status of the Procedure

List of tags (as strings) associated with the Procedure.

The version of the Procedure

TrimbleCloud.Processing.Model

ProcedureCreate model

The default region for the Procedure

Description of the Procedure

URL to external documentation for the Procedure

Identifier of the Procedure

The name of the Procedure

This is the definition of Procedure contents and how inputs & outputs are linked together between individual Operations

The user will specify parameter values via these mapping names

List of names of Users with whom this Procedure has been shared.

List of identities with whom this Procedure has been shared. Each entry contains an account_id (required) and optionally a client_id. An entry with only account_id grants access to all clients in that account. An entry with both client_id and account_id grants access to that specific client only. Sending an array replaces the existing list, not append to it.

List of tags (as strings) associated with the Procedure.

The version of the Procedure

Validate the ProcedureCreate object.

This method has no parameters.

Name Description
TrimbleCloud.Processing.ValidationException

TrimbleCloud.Processing.Model

Procedure List Filters

Filters a resource based on execution status.

Filters a resource based on the operation id.

Filters results by public status

Filters a resource based on status

TrimbleCloud.Processing.Model

Parmeter class

TrimbleCloud.Processing.Model

ProcedureUpdate model

The default region for the Procedure

Description of the Procedure

URL to external documentation for the Procedure

Identifier of the Procedure

The name of the Procedure

This is the definition of Procedure contents and how inputs & outputs are linked together between individual Operations

The user will specify parameter values via these mapping names

List of names of Users with whom this Procedure has been shared.

List of identities with whom this Procedure has been shared. Each entry contains an account_id (required) and optionally a client_id. An entry with only account_id grants access to all clients in that account. An entry with both client_id and account_id grants access to that specific client only. Sending an array replaces the existing list, not append to it.

List of tags (as strings) associated with the Procedure.

The version of the Procedure

Validate the ProcedureCreate object.

This method has no parameters.

Name Description
TrimbleCloud.Processing.ValidationException

TrimbleCloud.Processing

API Methods relating to Trimble Cloud Platform Processing Framework procedures

Approve a procedure

A Task that resolves to the approved procedure on completion

Name Type Description
id System.String The identifier of the procedure to approve
Name Description
System.Exception Thrown when a procedure cannot be approved

Create a procedure

A Task that resolves to the created procedure on completion

Name Type Description
procedureCreate TrimbleCloud.Processing.Model.ProcedureCreate The value of the procedure to create
Name Description
System.Exception Thrown when a procedure cannot be created

Delete a procedure

An awaitiable Task

Name Type Description
id System.String The identifier of the procedure to delete
Name Description
System.Exception Thrown when a procedure cannot be deleted

Get a procedure by id

A Task that resolves to the requested procedure on completion

Name Type Description
id System.String The identifier of the procedure to read
procedureView System.String Optional procedure view (passed as procedure-view)
Name Description
System.Exception Thrown when a procedure cannot be read

Get a list of procedures

An asynchronous list of procedures

Name Type Description
include_public System.Boolean Whether to include public procedures in the returned list

Get a list of procedures

An asynchronous list of procedures

Name Type Description
page System.Int32 The page number to retrieve
pageSize System.Int32 The number of items per page
filters TrimbleCloud.Processing.Model.ProcedureListFilter The filters to apply to the list

Publish a procedure

A Task that resolves to the published procedure on completion

Name Type Description
id System.String The identifier of the procedure to publish
Name Description
System.Exception Thrown when a procedure cannot be published

Retire a procedure

A Task that resolves to the retired procedure on completion

Name Type Description
id System.String The identifier of the procedure to retire
Name Description
System.Exception Thrown when a procedure cannot be retired

Update a procedure

A Task that resolves to the updated procedure on completion

Name Type Description
id System.String The identifier of the procedure to update
procedureUpdate TrimbleCloud.Processing.Model.ProcedureUpdate The value of the procedure to update
Name Description
System.Exception Thrown when a procedure cannot be updated

TrimbleCloud.Processing

A client for the Trimble Cloud Platform Processing Framework

const TOKEN = "...";
const BASE_URL = "https://api-usw2.trimblepaas.com/processing-v1.0";
var tokenProvider = new FixedTokenProvider(TOKEN);
var httpclientProvider = new BearerTokenHttpClientProvider(tokenProvider, new Uri(BASE_URL, UriKind.Absolute));
var processingClient = new ProcessingClient(httpclientProvider);
var operations = await processingClient.Operations.GetList().GetItems();
var proceduress = await processingClient.Procedures.GetList().GetItems();
var execution = await processingClient.Executions.Create(new Execution() { ... });
var engine = await processingClient.Engines.Create(new Engine() { ... });
var deployment = await processingClient.Deployments.Create(new Deployment() { ... });
var deploymentSecret = await processingClient.DeploymentSecrets.Create(new DeploymentSecret() { ... });

Public constructor for a Processing Client

Name Type Description
clientProvider Trimble.ID.IHttpClientProvider A provider of a pre-configured HttpClient used for API calls made by this client

TrimbleCloud.Processing.Helper

Query String Formatter

Convert the filter to query string

This method has no parameters.

TrimbleCloud.Processing.Model

Represents a resource.

Resouce creation date time

Gets resource Id

Resouce updation date time

TrimbleCloud.Processing

Represents a response.

Returns the content length of the HTTP response.

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

Get the HTTP response headers.

Gets the HTTP reason phrase.

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

Gets or sets the response content body.

Gets the HTTP status code.

Frees resources held by this Response instance.

This method has no parameters.

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

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

Name Type Description
value ``0 The value.
response TrimbleCloud.Processing.Response The HTTP response.
Name Description
T The type of the value.

Returns the string representation of this Response.

The string representation of this Response

This method has no parameters.

TrimbleCloud.Processing

Represents a response.

Name Description
T The type of returned value.

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

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

Get HTTP raw response

This method has no parameters.

Returns the value of this Response`1 object.

Name Type Description
response TrimbleCloud.Processing.Response{`0})~`0 The Response`1 instance.

TrimbleCloud.Processing.Model

Secret files

The file path of an ingested Deployment Secret file.

The expected identifier of a Deployment Secret.

TrimbleCloud.Processing.Model

Secret variables

The expected identifier of a Deployment Secret.

The name of the environment variable inside the container.

TrimbleCloud.Processing.Model

Represents an identity with whom a resource has been shared. An entry with only AccountId grants access to all clients in that account. An entry with both ClientId and AccountId grants access to that specific client only.

The TID account identifier to share with. Required.

The TID subject identifier (client ID) to share with. When provided alongside AccountId, shares with that specific client. When omitted, shares with all clients in the specified account.

TrimbleCloud.Processing.Model

The status of the operation.

DELETING status

EXECUTABLE status

MUTABLE status

RETIRED status

Unknown status

TrimbleCloud.Processing

Exception for Trimble service API errors

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

Name Type Description
message System.String Error message
response TrimbleCloud.Processing.Response Response object that led to the exception

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

This constructor has no parameters.

#ctor(message,response,innerException) constructor

Section titled “#ctor(message,response,innerException) constructor”

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

Name Type Description
message System.String Error message
response TrimbleCloud.Processing.Response Response object that led to the exception
innerException System.Exception Inner exception if any

Constructor for deserialization

Name Type Description
info System.Runtime.Serialization.SerializationInfo The SerializationInfo that holds the serialized object data
context System.Runtime.Serialization.StreamingContext The StreamingContext that contains contextual information about the source or destination

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

Gets the request ID for tracking and support purposes.

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

Inherit from parent.

This method has no parameters.

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

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

This method has no parameters.

Returns a string representation of the exception

Formatted error message

This method has no parameters.

TrimbleCloud.Processing

Represents an exception that occurs during validation.

Initializes a new instance of the ValidationException class.

Name Type Description
message System.String Exception message.

Initializes a new instance of the ValidationException class.

Name Type Description
message System.String Exception message.
innerException System.Exception Inner exception.

Initializes a new instance of the ValidationException class.

Name Type Description
message System.String Exception message.
errors System.Collections.Generic.IEnumerable{System.String} List of errors.

Gets the list of errors.