alicloud_message_service_queue

Provides a Message Service Queue resource.

For information about Message Service Queue and how to use it, see What is Queue.

-> NOTE: Available since v1.188.0.

Example Usage

Basic Usage

variable "name" {
  default = "terraform-example"
}

resource "alicloud_message_service_queue" "default" {
  queue_name               = var.name
  delay_seconds            = "2"
  polling_wait_seconds     = "2"
  message_retention_period = "566"
  maximum_message_size     = "1126"
  visibility_timeout       = "30"
}

Argument Reference

The following arguments are supported:

• delay_seconds - (Optional, Int) The period after which all messages sent to the queue are consumed. Default value: 0. Valid values: 0 to 604800. Unit: seconds.
• dlq_policy - (Optional, Set, Available since v1.244.0) The dead-letter queue policy. See dlq_policy below.
• logging_enabled - (Optional, Bool) Specifies whether to enable the logging feature. Default value: false. Valid values:
  • true: Enable.
  • false: Disable.
• maximum_message_size - (Optional, Int) The maximum length of the message that is sent to the queue. Valid values: 1024 to 65536. Unit: bytes. Default value: 65536.
• message_retention_period - (Optional, Int) The maximum duration for which a message is retained in the queue. After the specified retention period ends, the message is deleted regardless of whether the message is received. Valid values: 60 to 604800. Unit: seconds. Default value: 345600.
• polling_wait_seconds - (Optional, Int) The maximum duration for which long polling requests are held after the ReceiveMessage operation is called. Valid values: 0 to 30. Unit: seconds. Default value: 0.
• queue_name - (Required, ForceNew) The name of the queue.
• tags - (Optional, Map, Available since v1.241.0) A mapping of tags to assign to the resource.
• visibility_timeout - (Optional, Int) The duration for which a message stays in the Inactive state after the message is received from the queue. Valid values: 1 to 43200. Unit: seconds. Default value: 30.

dlq_policy

The dlq_policy supports the following:

• dead_letter_target_queue - (Optional) The queue to which dead-letter messages are delivered.
• enabled - (Optional, Bool) Specifies whether to enable the dead-letter message delivery. Valid values: true, false.
• max_receive_count - (Optional, Int) The maximum number of retries.

Attributes Reference

The following attributes are exported:

• id - The resource ID in terraform of Queue.
• create_time - (Available since v1.223.2) The time when the queue was created.

Timeouts

The timeouts block allows you to specify timeouts for certain actions:

• create - (Defaults to 5 mins) Used when create the Queue.
• delete - (Defaults to 5 mins) Used when delete the Queue.
• update - (Defaults to 5 mins) Used when update the Queue.

Import

Message Service Queue can be imported using the id, e.g.

$ terraform import alicloud_message_service_queue.example <id>