Tool: delete_subscription
Delete an existing Cloud Pub/Sub subscription.
Parameters
-
subscription: The name of the subscription to delete in the formatprojects/{project_id}/subscriptions/{name}.
Returns
-
google.protobuf.Emptyif the subscription exists. -
A
NOT_FOUNDerror if the subscription does not exist.
Important Notes
-
A subscription is a named resource that represents a stream of messages from a single, specific topic, to be delivered to the subscribing application.
-
A project ID and subscription name must be provided.
-
All messages retained in the subscription are immediately dropped.
-
Calls to
Pullafter deletion will returnNOT_FOUND.
The following sample demonstrate how to use curl
to invoke the delete_subscription
MCP tool.
| Curl Request |
|---|
curl --location 'https://pubsub.googleapis.com/mcp' \ --header 'content-type: application/json' \ --header 'accept: application/json, text/event-stream' \ --data '{ "method": "tools/call", "params": { "name": "delete_subscription", "arguments": { // provide these details according to the tool' s MCP specification } } , "jsonrpc" : "2.0" , "id" : 1 } ' |
Input Schema
Request for the DeleteSubscription method.
DeleteSubscriptionRequest
| JSON representation |
|---|
{ "subscription" : string } |
| Fields | |
|---|---|
subscription
|
Required. The subscription to delete. Format is |
Output Schema
A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance:
service Foo {
rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
}
Tool Annotations
Destructive Hint: ✅ | Idempotent Hint: ✅ | Read Only Hint: ❌ | Open World Hint: ✅
