Create a queue

Creates a queue.

Explore further

For detailed documentation that includes this code sample, see the following:

• Getting started with the Cloud Tasks API (Python)

Code sample

Java

To learn how to install and use the client library for Cloud Tasks, see Cloud Tasks client libraries.

To authenticate to Cloud Tasks, set up Application Default Credentials. For more information, see Set up authentication for a local development environment.

import com.google.cloud.tasks.v2.CloudTasksClient;
import com.google.cloud.tasks.v2.LocationName;
import com.google.cloud.tasks.v2.Queue;
import com.google.cloud.tasks.v2.QueueName;
import java.io.IOException;

public class CreateQueue {

  public static void main(String[] args) throws IOException {
    // TODO(developer): Replace these variables before running the sample.
    String projectId = "my-project-id";
    String locationId = "us-central1";
    String queueId = "my-queue";
    createQueue(projectId, locationId, queueId);
  }

  // Create a queue using the Cloud Tasks client.
  public static void createQueue(String projectId, String locationId, String queueId)
      throws IOException {

    // Instantiates a client.
    try (CloudTasksClient client = CloudTasksClient.create()) {

      // Construct the fully qualified location.
      String parent = LocationName.of(projectId, locationId).toString();

      // Construct the fully qualified queue path.
      String queuePath = QueueName.of(projectId, locationId, queueId).toString();

      // Send create queue request.
      Queue queue = client.createQueue(parent, Queue.newBuilder().setName(queuePath).build());

      System.out.println("Queue created: " + queue.getName());
    }
  }
}

Node.js

To learn how to install and use the client library for Cloud Tasks, see Cloud Tasks client libraries.

To authenticate to Cloud Tasks, set up Application Default Credentials. For more information, see Set up authentication for a local development environment.

// Imports the Google Cloud Tasks library.
const cloudTasks = require('@google-cloud/tasks');

// Instantiates a client.
const client = new cloudTasks.CloudTasksClient();

async function createQueue() {
  // Send create queue request.
  const [response] = await client.createQueue({
    // The fully qualified path to the location where the queue is created
    parent: client.locationPath(project, location),
    queue: {
      // The fully qualified path to the queue
      name: client.queuePath(project, location, queue),
      appEngineHttpQueue: {
        appEngineRoutingOverride: {
          // The App Engine service that will receive the tasks.
          service: 'default',
        },
      },
    },
  });
  console.log(`Created queue ${response.name}`);
}
createQueue();

Python

To learn how to install and use the client library for Cloud Tasks, see Cloud Tasks client libraries.

To authenticate to Cloud Tasks, set up Application Default Credentials. For more information, see Set up authentication for a local development environment.

from google.cloud import tasks_v2


def create_queue(project: str, location: str, queue_id: str) -> tasks_v2.Queue:
    """Create a queue.
    Args:
        project: The project ID to create the queue in.
        location: The location to create the queue in.
        queue_id: The ID to use for the new queue.

    Returns:
        The newly created queue.
    """

    # Create a client.
    client = tasks_v2.CloudTasksClient()

    # Use the client to send a CreateQueueRequest.
    return client.create_queue(
        tasks_v2.CreateQueueRequest(
            parent=client.common_location_path(project, location),
            queue=tasks_v2.Queue(name=client.queue_path(project, location, queue_id)),
        )
    )

What's next

To search and filter code samples for other Google Cloud products, see the Google Cloud sample browser.