versions

Overview

Name	versions
Type	Resource
Id	google.integrations.versions

Fields

Name	Datatype	Description
name	string	Output only. Auto-generated primary key. Format: projects/{project}/locations/{location}/products/{product}/integrationtemplates/{integrationtemplate}/versions/{version}
description	string	Optional. The templateversion description. Permitted format is alphanumeric with underscores and no spaces.
createTime	string	Output only. Auto-generated.
databasePersistencePolicy	string	Optional. Flag to disable database persistence for execution data, including event execution info, execution export info, execution metadata index and execution param index.
errorCatcherConfigs	array	Optional. Error Catch Task configuration for the IntegrationTemplateVersion. It's optional.
lastModifierEmail	string	Optional. The last modifier's email address. Generated based on the End User Credentials/LOAS role of the user making the call.
parentIntegrationVersionId	string	Optional. ID of the IntegrationVersion that was used to create this IntegrationTemplateVersion
snapshotNumber	string	Output only. An increasing sequence that is set when a new snapshot is created.
status	string	Optional. Generated by eventbus. User should not set it as an input.
taskConfigs	array	Optional. Task configuration for the IntegrationTemplateVersion. It's optional, but the IntegrationTemplateVersion doesn't do anything without task_configs.
teardown	object
templateParameters	object	LINT.IfChange This is the frontend version of WorkflowParameters. It's exactly like the backend version except that instead of flattening protobuf parameters and treating every field and subfield of a protobuf parameter as a separate parameter, the fields/subfields of a protobuf parameter will be nested as "children" (see 'children' field below) parameters of the parent parameter. Please refer to enterprise/crm/eventbus/proto/workflow_parameters.proto for more information about WorkflowParameters.
triggerConfigs	array	Optional. Trigger configurations.
updateTime	string	Output only. Auto-generated.
userLabel	string	Optional. A user-defined label that annotates an integration version. Typically, this is only set when the integration version is created.

Methods

Name	Accessible by	Required Params	Description
projects_locations_integrations_versions_get	SELECT	integrationsId, locationsId, projectsId, versionsId	Get a integration in the specified project.
projects_locations_integrations_versions_list	SELECT	integrationsId, locationsId, projectsId	Returns the list of all integration versions in the specified project.
projects_locations_products_integrations_versions_get	SELECT	integrationsId, locationsId, productsId, projectsId, versionsId	Get a integration in the specified project.
projects_locations_products_integrations_versions_list	SELECT	integrationsId, locationsId, productsId, projectsId	Returns the list of all integration versions in the specified project.
projects_locations_products_integrationtemplates_versions_get	SELECT	integrationtemplatesId, locationsId, productsId, projectsId, versionsId	Returns an IntegrationTemplateVersion in the specified project.
projects_locations_products_integrationtemplates_versions_list	SELECT	integrationtemplatesId, locationsId, productsId, projectsId	Returns the list of all IntegrationTemplateVersions in the specified project.
projects_locations_integrations_versions_create	INSERT	integrationsId, locationsId, projectsId	Create a integration with a draft version in the specified project.
projects_locations_products_integrations_versions_create	INSERT	integrationsId, locationsId, productsId, projectsId	Create a integration with a draft version in the specified project.
projects_locations_products_integrationtemplates_versions_create	INSERT	integrationtemplatesId, locationsId, productsId, projectsId	Creates an IntegrationTemplateVersion.
projects_locations_integrations_versions_delete	DELETE	integrationsId, locationsId, projectsId, versionsId	Soft-deletes the integration. Changes the status of the integration to ARCHIVED. If the integration being ARCHIVED is tagged as "HEAD", the tag is removed from this snapshot and set to the previous non-ARCHIVED snapshot. The PUBLISH_REQUESTED, DUE_FOR_DELETION tags are removed too. This RPC throws an exception if the version being deleted is DRAFT, and if the locked_by user is not the same as the user performing the Delete. Audit fields updated include last_modified_timestamp, last_modified_by. Any existing lock is released when Deleting a integration. Currently, there is no undelete mechanism.
projects_locations_products_integrations_versions_delete	DELETE	integrationsId, locationsId, productsId, projectsId, versionsId	Soft-deletes the integration. Changes the status of the integration to ARCHIVED. If the integration being ARCHIVED is tagged as "HEAD", the tag is removed from this snapshot and set to the previous non-ARCHIVED snapshot. The PUBLISH_REQUESTED, DUE_FOR_DELETION tags are removed too. This RPC throws an exception if the version being deleted is DRAFT, and if the locked_by user is not the same as the user performing the Delete. Audit fields updated include last_modified_timestamp, last_modified_by. Any existing lock is released when Deleting a integration. Currently, there is no undelete mechanism.
_projects_locations_integrations_versions_list	EXEC	integrationsId, locationsId, projectsId	Returns the list of all integration versions in the specified project.
_projects_locations_products_integrations_versions_list	EXEC	integrationsId, locationsId, productsId, projectsId	Returns the list of all integration versions in the specified project.
_projects_locations_products_integrationtemplates_versions_list	EXEC	integrationtemplatesId, locationsId, productsId, projectsId	Returns the list of all IntegrationTemplateVersions in the specified project.
projects_locations_integrations_versions_download	EXEC	integrationsId, locationsId, projectsId, versionsId	Downloads an integration. Retrieves the IntegrationVersion for a given integration_id and returns the response as a string.
projects_locations_integrations_versions_patch	EXEC	integrationsId, locationsId, projectsId, versionsId	Update a integration with a draft version in the specified project.
projects_locations_integrations_versions_publish	EXEC	integrationsId, locationsId, projectsId, versionsId	This RPC throws an exception if the integration is in ARCHIVED or ACTIVE state. This RPC throws an exception if the version being published is DRAFT, and if the locked_by user is not the same as the user performing the Publish. Audit fields updated include last_published_timestamp, last_published_by, last_modified_timestamp, last_modified_by. Any existing lock is on this integration is released.
projects_locations_integrations_versions_takeover_edit_lock	EXEC	integrationsId, locationsId, projectsId, versionsId	Clears the locked_by and locked_at_timestampin the DRAFT version of this integration. It then performs the same action as the CreateDraftIntegrationVersion (i.e., copies the DRAFT version of the integration as a SNAPSHOT and then creates a new DRAFT version with the locked_by set to the user_taking_over and the locked_at_timestamp set to the current timestamp). Both the locked_by and user_taking_over are notified via email about the takeover. This RPC throws an exception if the integration is not in DRAFT status or if the locked_by and locked_at_timestamp fields are not set.The TakeoverEdit lock is treated the same as an edit of the integration, and hence shares ACLs with edit. Audit fields updated include last_modified_timestamp, last_modified_by.
projects_locations_integrations_versions_unpublish	EXEC	integrationsId, locationsId, projectsId, versionsId	Sets the status of the ACTIVE integration to SNAPSHOT with a new tag "PREVIOUSLY_PUBLISHED" after validating it. The "HEAD" and "PUBLISH_REQUESTED" tags do not change. This RPC throws an exception if the version being snapshot is not ACTIVE. Audit fields added include action, action_by, action_timestamp.
projects_locations_integrations_versions_upload	EXEC	integrationsId, locationsId, projectsId	Uploads an integration. The content can be a previously downloaded integration. Performs the same function as CreateDraftIntegrationVersion, but accepts input in a string format, which holds the complete representation of the IntegrationVersion content.
projects_locations_products_integrations_versions_download	EXEC	integrationsId, locationsId, productsId, projectsId, versionsId	Downloads an integration. Retrieves the IntegrationVersion for a given integration_id and returns the response as a string.
projects_locations_products_integrations_versions_patch	EXEC	integrationsId, locationsId, productsId, projectsId, versionsId	Update a integration with a draft version in the specified project.
projects_locations_products_integrations_versions_publish	EXEC	integrationsId, locationsId, productsId, projectsId, versionsId	This RPC throws an exception if the integration is in ARCHIVED or ACTIVE state. This RPC throws an exception if the version being published is DRAFT, and if the locked_by user is not the same as the user performing the Publish. Audit fields updated include last_published_timestamp, last_published_by, last_modified_timestamp, last_modified_by. Any existing lock is on this integration is released.
projects_locations_products_integrations_versions_takeover_edit_lock	EXEC	integrationsId, locationsId, productsId, projectsId, versionsId	Clears the locked_by and locked_at_timestampin the DRAFT version of this integration. It then performs the same action as the CreateDraftIntegrationVersion (i.e., copies the DRAFT version of the integration as a SNAPSHOT and then creates a new DRAFT version with the locked_by set to the user_taking_over and the locked_at_timestamp set to the current timestamp). Both the locked_by and user_taking_over are notified via email about the takeover. This RPC throws an exception if the integration is not in DRAFT status or if the locked_by and locked_at_timestamp fields are not set.The TakeoverEdit lock is treated the same as an edit of the integration, and hence shares ACLs with edit. Audit fields updated include last_modified_timestamp, last_modified_by.
projects_locations_products_integrations_versions_unpublish	EXEC	integrationsId, locationsId, productsId, projectsId, versionsId	Sets the status of the ACTIVE integration to SNAPSHOT with a new tag "PREVIOUSLY_PUBLISHED" after validating it. The "HEAD" and "PUBLISH_REQUESTED" tags do not change. This RPC throws an exception if the version being snapshot is not ACTIVE. Audit fields added include action, action_by, action_timestamp.
projects_locations_products_integrations_versions_upload	EXEC	integrationsId, locationsId, productsId, projectsId	Uploads an integration. The content can be a previously downloaded integration. Performs the same function as CreateDraftIntegrationVersion, but accepts input in a string format, which holds the complete representation of the IntegrationVersion content.