Отправка пакета сообщений

Статья
08/05/2023

Отправляет пакет сообщений в очередь или раздел служебной шины.

Запрос

Метод	Универсальный код ресурса (URI) запроса	Версия HTTP
POST	`http{s}://{serviceNamespace}.servicebus.windows.net/{queuePath\|topicPath}/messages\|HTTP/1.1`

Заголовки запросов

В следующей таблице перечислены обязательные и необязательные заголовки запросов. Наряду с указанными свойствами заголовок может содержать настраиваемые свойства. См. пример.

Заголовок запроса	Описание
Авторизация	Укажите одно из следующих значений токена: Маркер веб-маркера JSON (Azure AD) Azure Active Directory (Azure AD). Например, `Authorization: Bearer <Azure AD JWT token>`. Сведения о создании маркера Azure AD см. в разделе Проверка подлинности из приложения. Маркер SAS. Например, `Authorization: SharedAccessSignature sr=<NAMESPACE NAME>.servicebus.windows.net&sig=<SHARED ACCESS KEY>&se=<TOKEN EXPIRY INSTANT>&skn=<SHARED KEY NAME>`. Сведения о создании маркера SAS см. в разделах Создание маркера подписанного URL-адреса и Создание маркера SAS.
Content-Type	Задано application/vnd.microsoft.servicebus.json.
x-ms-retrypolicy	(Необязательно) Задайте значение , `NoRetry` чтобы отключить автоматическую повторную попытку при операциях отправки в случае временных ошибок.

Текст запроса

Текст сообщения содержит пакет сообщений, закодированный в формате JSON.

Ответ

Ответ включает код состояния HTTP и набор заголовков ответа.

Коды ответов

Код	Описание
201	Сообщение успешно отправлено в очередь или раздел.
400	Недопустимый запрос.
401	Ошибка авторизации.
403	Превышена квота или сообщение слишком велико.
410	Указанная очередь или раздел не существует.
500	Внутренняя ошибка.

Дополнительные сведения о кодах состояния см. в разделе Коды состояния и ошибок.

Заголовки откликов

Content-type как передано.

Текст ответа

Нет.

Пример

Следующий запрос HTTP отправляет пакет из трех сообщений в очередь или раздел. Первое сообщение имеет значение TimeToLiveTimeSpan , равное 40 секундам, второе сообщение имеет настраиваемое свойство "Priority", а третье сообщение имеет настраиваемые свойства "Priority" и "Customer".

POST https://your-namespace.servicebus.windows.net/HttpClientSampleQueue/messages?timeout=60 HTTP/1.1  
Authorization: SharedAccessSignature sr=your-namespace&sig=Fg8yUyR4MOmXfHfj55f5hY4jGb8x2Yc%2b3%2fULKZYxKZk%3d&se=1404256819&skn=RootManageSharedAccessKey  
Content-Type: application/vnd.microsoft.servicebus.json  
Host: your-namespace.servicebus.windows.net  
Content-Length: 18  
Expect: 100-continue  
  
[  
  {  
    "Body":”This is the first message",  
    "BrokerProperties":{"Label":"M1","TimeToLiveTimeSpan":"0.00:00:40"}  
  },  
  {  
    "Body":”This is the second message",  
    "BrokerProperties":{"Label":"M2"},  
    "UserProperties":{"Priority":"Low"}  
  },  
  {  
    "Body":”This is the third message",  
    "BrokerProperties":{"Label":"M3"},  
    "UserProperties":{"Priority":"Medium","Customer":"ABC"}  
  }  
]

Служебная шина возвращает следующий ответ:

HTTP/1.1 201 Created  
Transfer-Encoding: chunked  
Content-Type: application/xml; charset=utf-8  
Server: Microsoft-HTTPAPI/2.0  
Date: Tue, 01 Jul 2014 23:00:22 GMT  
  
0

См. также:

Образец HTTP-клиента служебной шины

Поделиться через