This predefined role contains
the permissions required to delete subscription SMTs. To see the exact permissions that are
required, expand theRequired permissionssection:
Required permissions
The following permissions are required to delete subscription SMTs:
Grant the delete a subscription permission on the subscription:pubsub.subscriptions.delete
Grant the view a subscription permission on the project. This permission is only required if you are using the Google Cloud console:pubsub.subscriptions.view
At the bottom of the Google Cloud console, aCloud Shellsession starts and displays a command-line prompt. Cloud Shell is a shell environment
with the Google Cloud CLI
already installed and with values already set for
your current project. It can take a few seconds for the session to initialize.
This command deletes all SMTs associated with the specified subscription.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-04 UTC."],[],[],null,["# Delete subscription SMTs\n\nThis document explains how to delete Single Message Transforms (SMTs) from an\nexisting Pub/Sub subscription.\n\nTo delete subscription SMTs, you can use the Google Cloud console, the Google Cloud CLI,\nthe client library, or the Pub/Sub API.\n\nRequired roles and permissions\n------------------------------\n\n\nTo get the permissions that\nyou need to delete subscription SMTs,\n\nask your administrator to grant you the\n\n\n[Pub/Sub Editor](/iam/docs/roles-permissions/pubsub#pubsub.editor) (`roles/pubsub.editor`)\nIAM role on your project.\n\n\nFor more information about granting roles, see [Manage access to projects, folders, and organizations](/iam/docs/granting-changing-revoking-access).\n\n\nThis predefined role contains\n\nthe permissions required to delete subscription SMTs. To see the exact permissions that are\nrequired, expand the **Required permissions** section:\n\n\n#### Required permissions\n\nThe following permissions are required to delete subscription SMTs:\n\n- Grant the delete a subscription permission on the subscription: ` ``pubsub.subscriptions.delete`\n- Grant the view a subscription permission on the project. This permission is only required if you are using the Google Cloud console: ` ``pubsub.subscriptions.view`\n\n\nYou might also be able to get\nthese permissions\nwith [custom roles](/iam/docs/creating-custom-roles) or\nother [predefined roles](/iam/docs/roles-overview#predefined).\n\nYou can configure access control at the project level and at the individual\nresource level.\n\nDelete subscription SMTs\n------------------------\n\nTo delete subscription SMTs, follow these steps: \n\n### Console\n\n1. In the Google Cloud console, go to the Pub/Sub **Subscriptions** page.\n\n [Go to Subscriptions](https://console.cloud.google.com/cloudpubsub/subscriptions)\n2. Click the subscription for which you want to delete an SMT.\n\n3. In the subscription details page, click **Edit**.\n\n The **Transforms** tab lists all the SMTs that are attached to the\n subscription.\n4. Click the delete button for the SMT you would like to delete.\n\n5. Click **Update**.\n\n### gcloud\n\n1. In the Google Cloud console, activate Cloud Shell.\n\n [Activate Cloud Shell](https://console.cloud.google.com/?cloudshell=true)\n\n\n At the bottom of the Google Cloud console, a\n [Cloud Shell](/shell/docs/how-cloud-shell-works)\n session starts and displays a command-line prompt. Cloud Shell is a shell environment\n with the Google Cloud CLI\n already installed and with values already set for\n your current project. It can take a few seconds for the session to initialize.\n2. This command deletes all SMTs associated with the specified subscription.\n\n Run the\n [`gcloud pubsub subscriptions update`](/sdk/gcloud/reference/pubsub/subscriptions/update) command with the `--clear-message-transforms` flag:\n\n \u003cbr /\u003e\n\n ```bash\n gcloud pubsub subscriptions update SUBSCRIPTION_ID \\\n --clear-message-transforms\n ```\n\n Replace the following:\n - \u003cvar translate=\"no\"\u003eSUBSCRIPTION_ID\u003c/var\u003e: The ID or name of the subscription you want to update.\n\n To instead remove a single SMT, refer to [Update subscription SMTs](/pubsub/docs/smts/update-subscription-smt) and create a new `message-transforms-file` that excludes the SMT you wish to delete.\n\n \u003cbr /\u003e\n\n\u003cbr /\u003e\n\nWhat's next\n-----------\n\n- [Create a subscription with SMTs](/pubsub/docs/smts/create-subscription-smt)\n\n- [Update subscription SMTs](/pubsub/docs/smts/update-subscription-smt)"]]
