Wysyłanie usługi Batch komunikatów

Artykuł
07/19/2023

Wysyła partię komunikatów do kolejki lub tematu usługi Service Bus.

Żądanie

Metoda	Identyfikator URI żądania	Wersja PROTOKOŁU HTTP
POST	`http{s}://{serviceNamespace}.servicebus.windows.net/{queuePath\|topicPath}/messages\|HTTP/1.1`

Nagłówki żądań

W poniższej tabeli opisano wymagane i opcjonalne nagłówki żądań. Oprócz wymienionych właściwości nagłówek może zawierać właściwości niestandardowe. Zobacz przykład.

Nagłówek żądania	Opis
Autoryzacja	Określ jedną z następujących wartości tokenu: Token tokenu internetowego JSON (JWT) usługi Azure Active Directory (Azure AD). Przykład: `Authorization: Bearer <Azure AD JWT token>`. Aby uzyskać informacje na temat generowania tokenu Azure AD, zobacz Uwierzytelnianie z aplikacji. Token SAS. Przykład: `Authorization: SharedAccessSignature sr=<NAMESPACE NAME>.servicebus.windows.net&sig=<SHARED ACCESS KEY>&se=<TOKEN EXPIRY INSTANT>&skn=<SHARED KEY NAME>`. Aby uzyskać informacje na temat generowania tokenu SAS, zobacz Generowanie tokenu sygnatury dostępu współdzielonego i Generowanie tokenu SYGNATURy dostępu współdzielonego.
Content-Type	Ustaw wartość application/vnd.microsoft.servicebus.json.
x-ms-retrypolicy	(Opcjonalnie) Ustaw wartość , aby `NoRetry` wyłączyć automatyczne ponawianie prób w przypadku operacji wysyłania w przypadku błędów przejściowych.

Treść żądania

Treść żądania zawiera partię komunikatów zakodowanych w formacie JSON.

Reakcja

Odpowiedź zawiera kod stanu HTTP i zestaw nagłówków odpowiedzi.

Kody odpowiedzi

Kod	Opis
201	Komunikat został pomyślnie wysłany do kolejki lub tematu.
400	Nieprawidłowe żądanie.
401	Niepowodzenie autoryzacji.
403	Przekroczono limit przydziału lub zbyt duży komunikat.
410	Określona kolejka lub temat nie istnieje.
500	Błąd wewnętrzny.

Aby uzyskać informacje o kodach stanu, zobacz Status and Error Codes (Kody stanu i błędów).

Nagłówki odpowiedzi

Typ zawartości w postaci przekazanej.

Treść odpowiedzi

Brak.

Przykład

Następujące żądanie HTTP wysyła partię trzech komunikatów do kolejki lub tematu. Pierwszy komunikat ma wartość TimeToLiveTimeSpan 40 sekund, drugi komunikat ma niestandardową właściwość komunikatu "Priority", a trzeci komunikat ma niestandardowe właściwości komunikatu "Priority" i "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"}  
  }  
]

Usługa Service Bus zwraca następującą odpowiedź:

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

Zobacz też

Przykład klienta HTTP usługi Service Bus

Udostępnij za pośrednictwem