Method: projects.locations.integrations.versions.unpublish

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, actionBy, actionTimestamp.

HTTP request

POST https://integrations.googleapis.com/v1/{name=projects/*/locations/*/integrations/*/versions/*}:unpublish

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
name

string

Required. The version to deactivate. Format: projects/{project}/locations/{location}/integrations/{integration}/versions/{version}

Request body

The request body must be empty.

Response body

If successful, the response body is empty.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform

For more information, see the Authentication Overview.

IAM Permissions

Requires the following IAM permission on the name resource:

  • integrations.integrationVersions.deploy

For more information, see the IAM documentation.