Oracle Cloud Infrastructure Documentation

Updating Messages

Updating a message extends or reduces the visibility of a message for the current consumer.

You might want to extend the visibility timeout for a message if a consumer needs more time processing the message. The visibility timeout of a message can't extend beyond the message's retention.

A request to update messages requires the receipt of the message. The receipt is provided in a response to the previous GetMessages request.

If the consumer doesn't update or delete the message before its visibility timeout passes, the message returns to the queue or is transferred to the dead letter queue.

  • You can't use the Console to update a message.

  • Use the oci queue messages update-message command and required parameters to update a message:

    oci queue messages update-message --message-receipt <message_receipt> --queue-id <queue_id> --visibility-in-seconds <visibility_in_seconds>

    Use the oci queue messages update-messages command to update messages in the queue.

    oci queue messages update-messages --entries file://entries.json --queue-id <queue_id>

    For a complete list of parameters and values for CLI commands, see the CLI Command Reference.

  • Use the UpdateMessage or UpdateMessages operation to update messages.

    For information about using the API and signing requests, see REST API documentation and Security Credentials. For information about SDKs, see SDKs and the CLI.