Tworzenie lub aktualizowanie rejestracji
Tworzy lub aktualizuje rejestrację w określonej lokalizacji.
Żądanie
Metoda | Identyfikator URI żądania | Wersja PROTOKOŁU HTTP |
---|---|---|
PUT | https://{namespace}.servicebus.windows.net/{NotificationHub}/registrations/<registrationId>?api-version=2015-01 |
HTTP/1.1 |
Nagłówki żądań
W poniższej tabeli opisano wymagane i opcjonalne nagłówki żądań.
Nagłówek żądania | Opis |
---|---|
Content-Type | application/atom+xml;type=entry;charset=utf-8 |
Autoryzacja | Token sygnatury dostępu współdzielonego wygenerowany zgodnie z uwierzytelnianiem sygnatury dostępu współdzielonego za pomocą usługi Service Bus. |
x-ms-version | 2015-01 |
Treść żądania
Wpis Atom z opisem osadzonym w zawartości, jak w sekcji Tworzenie rejestracji.
Reakcja
Odpowiedź zawiera kod stanu HTTP i zestaw nagłówków odpowiedzi.
Kody odpowiedzi
Kod | Opis |
---|---|
201 | Rejestracja została pomyślnie zaktualizowana. |
400 | Nieprawidłowa treść żądania. Nie można utworzyć rejestracji, ponieważ żądanie zostało źle sformułowane. |
401 | Niepowodzenie autoryzacji. Klucz dostępu był niepoprawny. |
403 | Przekroczono limit przydziału; zbyt wiele rejestracji w tej przestrzeni nazw. Rejestracja nie została utworzona. |
404 | W tej lokalizacji nie istnieje żadne centrum powiadomień. |
409 | Żądanie zostało odrzucone, ponieważ wskaźnik operacji rejestracji jest zbyt wysoki. |
410 | Nie można użyć określonej lokalizacji. Użyj innego identyfikatora rejestracji. |
Aby uzyskać informacje o kodach stanu, zobacz Kody stanu i błędów.
Nagłówki odpowiedzi
Nagłówek odpowiedzi | Opis |
---|---|
Typ zawartości | application/atom+xml;type=entry;charset=utf-8 |
Etag | {weak ETag} |
Treść odpowiedzi
Po pomyślnym zakończeniu zwracany jest zweryfikowany wpis Atom, tak jak w sekcji Tworzenie rejestracji.