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.