Tworzenie lub aktualizowanie jednostki

Tworzy lub aktualizuje jednostkę obsługi komunikatów.

Żądanie

Metoda	Identyfikator URI żądania	Wersja protokołu HTTP
PUT	https://{serviceNamespace}.servicebus.windows.net/{Ścieżka jednostki}	HTTP/1.1

Ścieżka jednostki może być nazwą wielosegmentową z segmentami oddzielonymi ciągiem "/". Cała ścieżka składa się z nazwy jednostek. Wiele jednostek może współdzielić te same segmenty prefiksów.

Nagłówki żądań

W poniższej tabeli opisano wymagane i opcjonalne nagłówki żądań.

Nagłówek żądania	Opis
Autoryzacja	Określa token sygnatury dostępu współdzielonego (SAS) z prawami "Zarządzaj". Aby uzyskać szczegółowe informacje , zobacz Uwierzytelnianie usługi Service Bus z sygnaturami dostępu współdzielonego .
Content-Type	Ustaw na wartość application/atom+xml;type=entry; charset=utf-8.
If-Match	Ustaw ten nagłówek na "*", aby zaktualizować jednostkę. Musisz podać wszystkie żądane wartości właściwości w zaktualizowanej jednostce. Wszystkie wartości, które nie zostały podane, są ustawione na wartości domyślne usługi. Jeśli brakuje tego nagłówka, wywołanie aktualizacji zwraca błąd wskazujący, że ta jednostka już istnieje.

Treść żądania

Treść żądania musi zawierać prawidłowy wpis XML Atom, który osadza opis jednostki, która zostanie utworzona

<?xml version="1.0" encoding="utf-8" ?>  
<entry xmlns='http://www.w3.org/2005/Atom'>  
  <content type='application/xml'>  
    {description}  
  </content>  
</entry>  

Gdzie {description} opisał kolejkę lub temat dla jednostek najwyższego poziomu albo subskrypcję lub regułę względem ich jednostek nadrzędnych.

Kolejka, na przykład, jest opisywana za pomocą QueueDescription elementu. Ładunek XML do tworzenia lub aktualizowania kolejki może zatem mieć następującą formę, w której wszystkie pominięte właściwości zakładają ich wartości domyślne:

<?xml version="1.0" encoding="utf-8" ?>  
<entry xmlns="http://www.w3.org/2005/Atom">  
  <content type="application/xml">  
    <QueueDescription xmlns="http://schemas.microsoft.com/netservices/2010/10/servicebus/connect">
       <LockDuration>T1M</LockDuration>
    </QueueDescription>
  </content>  
</entry>  

Zobacz Omówienie , aby uzyskać więcej informacji na temat jednostek i sposobu ich powiązania ze ścieżkami.

Reakcja

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

Kody odpowiedzi

Uwaga

Jeśli zaktualizujesz jednostkę o nazwie zawierającej znaki specjalne lub zakodowane (na przykład "test? Name=value&"), który jest kodowany do "test%3FName%3Dvalue%26"), zostanie wygenerowany nieautoryzowany wyjątek (401).

Kod	Opis
201	Zaktualizowano jednostkę.
400	Nieprawidłowa treść żądania.
401	Niepowodzenie autoryzacji.
403	Przekroczono limit przydziału; jednostka nie została zaktualizowana.
500	Błąd wewnętrzny.

Aby uzyskać informacje o kodach stanu, zobacz Kody stanu i błędów.

Nagłówki odpowiedzi

Brak.

Treść odpowiedzi

Zwracany jest opis jednostki. Niektóre właściwości opisu mogą zawierać wartości domyślne, jeśli brakuje ich w żądaniu PUT.