dcloud queue queues create

Create a queue

IAM queue:CreateQueueChanges state

Unset attributes take the defaults: visibility timeout 30 s, retention 4 days, no delay, no long polling, 256 KiB messages. deadLetterQueue names another queue of the organization; after maxReceiveCount receives a message moves there. 409 QueueAlreadyExists when the name is taken. fifo: true makes a FIFO queue (the name must end in .fifo, and a .fifo name requires it; fixed at creation): sends name a messageGroupId, each group is delivered in order with one batch in flight at a time, and sends are deduplicated for five minutes by messageDeduplicationId, or by the body with contentBasedDeduplication. A FIFO queue's dead-letter queue must be FIFO.

Synopsis

dcloud queue queues create --name name [flags]

Flags

  • --nameRequired

    string

    Name of the queue, unique in the organization and region; a FIFO queue’s name ends in .fifo

    Constraints: max 80 chars, /^[A-Za-z0-9_-]+(\.fifo)?$/

  • --fifoOptional

    boolean (--fifo / --no-fifo)

    Create a FIFO queue, which delivers each message group in order and deduplicates sends; cannot be changed later (default false)

  • --tagsOptional

    map of string

    Tags for the new resource, e.g. {"env": "prod", "project": "shop"}. Keys your organization marks required must be present, or the create is refused with the missing keys (GET /tags/api/keys lists them).

    Constraints: key=value

  • --visibility-timeout-secondsOptional

    number

    Seconds a received message stays hidden from other consumers before it can be received again; 30 for a new queue

    Constraints: integer, 0-43200

  • --retention-secondsOptional

    number

    Seconds a message is kept before it is deleted unreceived; applies to messages sent afterwards; 4 days for a new queue

    Constraints: integer, 60-1209600

  • --delay-secondsOptional

    number

    Seconds a newly sent message stays invisible before it can be received; 0 for a new queue

    Constraints: integer, 0-900

  • --receive-wait-secondsOptional

    number

    Seconds a receive waits for a message when it names no wait of its own; 0 answers at once; 0 for a new queue

    Constraints: integer, 0-20

  • --maximum-message-bytesOptional

    number

    Largest message the queue accepts, in bytes, counting the body and attributes; 256 KiB for a new queue

    Constraints: integer, 1024-262144

  • --dead-letter-queueOptional

    object

    Another queue of the organization (name) that receives a message after it has been received maxReceiveCount times without being deleted; null removes it; none for a new queue

    Constraints: JSON

    May be null.

  • --content-based-deduplicationOptional

    boolean (--content-based-deduplication / --no-content-based-deduplication)

    FIFO queues only: a send without messageDeduplicationId is deduplicated by the SHA-256 of its body; false for a new queue

Example

dcloud queue queues create --name example

Generated from the API description, the same one the API checks requests against and the CLI is built from.