ProjectsLocationsProductsIntegrationsVersions
class ProjectsLocationsProductsIntegrationsVersions extends Resource (View source)
The "versions" collection of methods.
Typical usage is:
$integrationsService = new Google\Service\Integrations(...);
$versions = $integrationsService->projects_locations_products_integrations_versions;
Methods
Create a integration with a draft version in the specified project.
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. (versions.delete)
Downloads an integration. Retrieves the IntegrationVersion
for a given
integration_id
and returns the response as a string. (versions.download)
Get a integration in the specified project. (versions.get)
Returns the list of all integration versions in the specified project.
Update a integration with a draft version in the specified project.
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. (versions.publish)
Clears the locked_by
and locked_at_timestamp
in 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.
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. (versions.unpublish)
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. (versions.upload)
Details
GoogleCloudIntegrationsV1alphaIntegrationVersion
create(string $parent, GoogleCloudIntegrationsV1alphaIntegrationVersion $postBody, array $optParams = [])
Create a integration with a draft version in the specified project.
(versions.create)
GoogleProtobufEmpty
delete(string $name, array $optParams = [])
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. (versions.delete)
GoogleCloudIntegrationsV1alphaDownloadIntegrationVersionResponse
download(string $name, array $optParams = [])
Downloads an integration. Retrieves the IntegrationVersion
for a given
integration_id
and returns the response as a string. (versions.download)
GoogleCloudIntegrationsV1alphaIntegrationVersion
get(string $name, array $optParams = [])
Get a integration in the specified project. (versions.get)
GoogleCloudIntegrationsV1alphaListIntegrationVersionsResponse
listProjectsLocationsProductsIntegrationsVersions(string $parent, array $optParams = [])
Returns the list of all integration versions in the specified project.
(versions.listProjectsLocationsProductsIntegrationsVersions)
GoogleCloudIntegrationsV1alphaIntegrationVersion
patch(string $name, GoogleCloudIntegrationsV1alphaIntegrationVersion $postBody, array $optParams = [])
Update a integration with a draft version in the specified project.
(versions.patch)
GoogleCloudIntegrationsV1alphaPublishIntegrationVersionResponse
publish(string $name, GoogleCloudIntegrationsV1alphaPublishIntegrationVersionRequest $postBody, array $optParams = [])
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. (versions.publish)
GoogleCloudIntegrationsV1alphaTakeoverEditLockResponse
takeoverEditLock(string $integrationVersion, GoogleCloudIntegrationsV1alphaTakeoverEditLockRequest $postBody, array $optParams = [])
Clears the locked_by
and locked_at_timestamp
in 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.
(versions.takeoverEditLock)
GoogleProtobufEmpty
unpublish(string $name, GoogleCloudIntegrationsV1alphaUnpublishIntegrationVersionRequest $postBody, array $optParams = [])
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. (versions.unpublish)
GoogleCloudIntegrationsV1alphaUploadIntegrationVersionResponse
upload(string $parent, GoogleCloudIntegrationsV1alphaUploadIntegrationVersionRequest $postBody, array $optParams = [])
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. (versions.upload)