Share via


Creare o aggiornare una registrazione

Crea o aggiorna una registrazione nel percorso specificato.

Richiesta

Metodo URI richiesta Versione HTTP
PUT https://{namespace}.servicebus.windows.net/{NotificationHub}/registrations/<registrationId>?api-version=2015-01 HTTP/1.1

Intestazioni della richiesta

Nella seguente tabella vengono descritte le intestazioni di richiesta obbligatorie e facoltative.

Intestazione della richiesta Descrizione
Content-Type application/atom+xml;type=entry;charset=utf-8
Autorizzazione Token di firma di accesso condiviso generato come specificato in Autenticazione firma di accesso condiviso con il bus di servizio.
x-ms-version 2015-01

Testo della richiesta

Voce Atom con la descrizione incorporata nel contenuto, come in Creare una registrazione.

Risposta

Nella risposta sono inclusi un codice di stato HTTP e un set di intestazioni per la risposta.

Codici di risposta

Codice Descrizione
201 Registrazione aggiornata correttamente.
400 Corpo della richiesta non valido. Impossibile creare la registrazione perché la richiesta è stata formattata in modo non corretto.
401 Errore di autorizzazione. La chiave di accesso non è corretta.
403 Quota superata; troppe registrazioni in questo spazio dei nomi. Registrazione non creata.
404 Nessun hub di notifica esiste in questa posizione.
409 Richiesta rifiutata perché la frequenza delle operazioni di registrazione è troppo elevata.
410 Impossibile usare la posizione specificata. Usare un ID di registrazione diverso.

Per informazioni sui codici di stato, vedere Codici di stato e di errore.

Intestazioni di risposta

Intestazione risposta Descrizione
Tipo di contenuto application/atom+xml;type=entry;charset=utf-8
ETag {ETag debole}

Corpo della risposta

Al termine dell'operazione, viene restituita una voce Atom convalidata, come in Crea registrazione.