Udostępnij przez

Wyślij wiadomość wsadowa

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

Prosić

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) firmy Microsoft.
    Przykład: Authorization: Bearer <Azure AD JWT token>.
    Aby uzyskać informacje na temat generowania tokenu entra firmy Microsoft, zobacz Uwierzytelnianie na podstawie aplikacji.
  • Token SYGNATURY dostępu współdzielonego.
    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 SAS.
Typ zawartości Ustaw wartość application/vnd.microsoft.servicebus.json.
x-ms-retrypolicy (Opcjonalnie) Ustaw wartość na NoRetry, aby wyłączyć automatyczne ponawianie prób przy operacjach wysyłania w przypadku błędów przejściowych.

Treść żądania

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

Odpowiedź

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 stan i kody błędów.

Nagłówki odpowiedzi

typu zawartości zgodnie z przekazywaniem.

Treść odpowiedzi

Żaden.

Przykład

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

  • Last updated on