terraform/website/source/docs/providers/google/r/pubsub_subscription.html.ma...

2.3 KiB

layout page_title sidebar_current description
google Google: google_pubsub_subscription docs-google-pubsub-subscription Creates a subscription in Google's pubsub queueing system

google_pubsub_subscription

Creates a subscription in Google's pubsub queueing system. For more information see the official documentation and API.

Example Usage

resource "google_pubsub_subscription" "default" {
  name  = "default-subscription"
  topic = "default-topic"

  ack_deadline_seconds = 20

  push_config {
    endpoint = "https://example.com/push"

    attributes {
      x-goog-version = "v1"
    }
  }
}

Argument Reference

The following arguments are supported:

  • name - (Required) A unique name for the resource, required by pubsub. Changing this forces a new resource to be created.

  • topic - (Required) A topic to bind this subscription to, required by pubsub. Changing this forces a new resource to be created.


  • ack_deadline_seconds - (Optional) The maximum number of seconds a subscriber has to acknowledge a received message, otherwise the message is redelivered. Changing this forces a new resource to be created.

  • project - (Optional) The project in which the resource belongs. If it is not provided, the provider project is used.

  • push_config - (Optional) Block configuration for push options. More configuration options are detailed below.

The optional push_config block supports:

  • push_endpoint - (Optional) The URL of the endpoint to which messages should be pushed. Changing this forces a new resource to be created.

  • attributes - (Optional) Key-value pairs of API supported attributes used to control aspects of the message delivery. Currently, only x-goog-version is supported, which controls the format of the data delivery. For more information, read the API docs here. Changing this forces a new resource to be created.

Attributes Reference

  • path - Path of the subscription in the format projects/{project}/subscriptions/{sub}