REST API for Oracle Messaging Cloud Service

Create a Temporary Queue

post

/temporaryQueues

Create a temporary queue on the session parameter.

Request

Query Parameters

session: string

Required. The name of the session in which to create the temporary queue.

Response

201 Response

Temporary queue created.

The content of the element is a pseudorandom name generated by the service for the newly created temporary queue or topic.


<temporaryQueue>
  <name>queue name</name>
  <connection>name of the connection with which the queue is associated</connection>
  <canonicalLink>relative path to temporary queue</canonicalLink>
</temporaryQueue>

Headers

Location: string

Contains the URL for the newly created temporary queue.

400 Response

Error Codes

sessionNotFound: There is no session with the specified name.

500 Response

Error Codes

operationFailed:A low-level exception occurred in attempting to create the temporary queue.

Examples

cURL Command

Temporary Queues are created on a session and a randomly generated name is assigned and returned in the response.

cookie=/tmp/messaging-cookie
curl -s -u $USER:$PASS -c $cookie -b $cookie \
     -H "X-OC-ID-TOKEN-STATUS: disabled" \
     -X POST "https://messaging.us2.oraclecloud.com/myService-myTenant/api/v1/temporaryQueues?session=myFirstSession"

There is no request body to submit with the HTTP request.

Example of Response Body

<?xml version='1.0' encoding='UTF-8'?>
<temporaryQueue>
  <name>CFDF99EE0C424C21</name>
  <connection>myFirstConnection</connection>
  <canonicalLink>/myService-myTenant/api/v1/temporaryQueues/CFDF99EE0C424C21</canonicalLink>
</temporaryQueue>