Create pull subscriptions

Console

To create a pull subscription, complete the following steps.

1. In the Google Cloud console, go to the Subscriptions page.

   Go to Subscriptions

2. Click Create subscription.

3. For the Subscription ID field, enter a name.

   For information on how to name a subscription, see Guidelines to name a topic or a subscription.

4. Choose or create a topic from the drop-down menu. The subscription receives messages from the topic.
5. Retain the Delivery type as Pull.
6. Retain all other default values.
7. Click Create.

You can also create a subscription from the Topics section. This shortcut is useful for associating topics with subscriptions.

1. In the Google Cloud console, go to the Topics page.

   Go to Topics

2. Click more_vert next to the topic on which to create a subscription.
3. From the context menu, select Create subscription.

4. Enter the Subscription ID.

   For information on how to name a subscription, see Guidelines to name a topic or a subscription.

5. Retain the Delivery type as Pull.
6. Retain all other default values.
7. Click Create.

gcloud

1. In the Google Cloud console, activate Cloud Shell.

   Activate Cloud Shell

   At the bottom of the Google Cloud console, a Cloud Shell session 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.

2. To create a pull subscription, run the gcloud pubsub subscriptions create command.

   gcloud pubsub subscriptions create SUBSCRIPTION_ID --topic=TOPIC_ID

   Replace the following:

   • SUBSCRIPTION_ID: The name or ID of your new pull subscription.
   • TOPIC_ID: The name or ID of your topic.

REST

To create a pull subscription, use the projects.subscriptions.create method:

Request:

The request must be authenticated with an access token in the Authorization header. To obtain an access token for the current Application Default Credentials: gcloud auth application-default print-access-token.

PUT https://pubsub.googleapis.com/v1/projects/PROJECT_ID/subscriptions/SUBSCRIPTION_ID
Authorization: Bearer ACCESS_TOKEN

Request body:

{
"topic": "projects/PROJECT_ID/topics/TOPIC_ID"
}

Where:

• PROJECT_ID is your project ID.
• SUBSCRIPTION_ID is your subscription ID.
• TOPIC_ID is your topic ID.

Response:

{
"name": "projects/PROJECT_ID/subscriptions/SUBSCRIPTION_ID",
"topic": "projects/PROJECT_ID/topics/TOPIC_ID",
"pushConfig": {},
"ackDeadlineSeconds": 10,
"messageRetentionDuration": "604800s",
"expirationPolicy": {
"ttl": "2678400s"
}
}

C++

Before trying this sample, follow the C++ setup instructions in Quickstart: Using Client Libraries. For more information, see the Pub/Sub C++ API reference documentation.

namespace pubsub_admin = ::google::cloud::pubsub_admin;
namespace pubsub = ::google::cloud::pubsub;
[](pubsub_admin::SubscriptionAdminClient client,
   std::string const& project_id, std::string const& topic_id,
   std::string const& subscription_id) {
  google::pubsub::v1::Subscription request;
  request.set_name(
      pubsub::Subscription(project_id, subscription_id).FullName());
  request.set_topic(pubsub::Topic(project_id, topic_id).FullName());
  auto sub = client.CreateSubscription(request);
  if (sub.status().code() == google::cloud::StatusCode::kAlreadyExists) {
    std::cout << "The subscription already exists\n";
    return;
  }
  if (!sub) throw std::move(sub).status();

  std::cout << "The subscription was successfully created: "
            << sub->DebugString() << "\n";
}

C#

Before trying this sample, follow the C# setup instructions in Quickstart: Using Client Libraries. For more information, see the Pub/Sub C# API reference documentation.

using Google.Cloud.PubSub.V1;
using Grpc.Core;

public class CreateSubscriptionSample
{
    public Subscription CreateSubscription(string projectId, string topicId, string subscriptionId)
    {
        SubscriberServiceApiClient subscriber = SubscriberServiceApiClient.Create();
        TopicName topicName = TopicName.FromProjectTopic(projectId, topicId);

        SubscriptionName subscriptionName = SubscriptionName.FromProjectSubscription(projectId, subscriptionId);
        Subscription subscription = null;

        try
        {
            subscription = subscriber.