Creare o aggiornare l'entità

  • Articolo

Crea o aggiorna un'entità di messaggistica.

Richiesta

Metodo URI richiesta Versione HTTP
PUT https://{Spazionomiservizio}.servicebus.windows.net/{percorso entità} HTTP/1.1

Il percorso dell'entità può essere un nome multi-segmento, con segmenti separati da '/'. L'intero percorso costituisce il nome delle entità. Più entità possono condividere gli stessi segmenti di prefisso.

Intestazioni richiesta

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

Intestazione della richiesta Descrizione
Autorizzazione Specifica un token firma di accesso condiviso con diritti "Gestisci". Per informazioni dettagliate, vedere Autenticazione del bus di servizio con firme di accesso condiviso .
Content-Type Viene impostata su application/atom+xml;type=entry;charset=utf-8.
If-Match Impostare questa intestazione su "*" per aggiornare l'entità. Devono essere forniti tutti i valori della proprietà che si desidera specificare nell'entità aggiornata. In alternativa, vengono impostati i valori predefiniti del servizio. Se questa intestazione manca, la chiamata di aggiornamento restituisce un errore per segnalare che l'entità è già esistente.

Corpo della richiesta

Il corpo della richiesta deve contenere una voce Atom XML valida che incorpora la descrizione dell'entità che deve essere creata

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

In cui il {description} descrive una coda o un argomento per le entità di primo livello o una sottoscrizione o una regola rispetto alle entità padre.

Una coda, ad esempio, viene descritta con un QueueDescription elemento. Il payload XML per la creazione o l'aggiornamento di una coda potrebbe quindi assumere il formato seguente, in cui tutte le proprietà omesse presuppongono i valori predefiniti:

<?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>

Per altre informazioni sulle entità e su come sono correlate ai percorsi, vedere Panoramica .

Risposta

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

Codici di risposta

Nota

Se si aggiorna un'entità con un nome contenente caratteri speciali o codificati, ad esempio "test? Name=value&"), che ottiene la codifica "test%3FName%3Dvalue%26"), verrà generata un'eccezione non autorizzata (401).

Codice Descrizione
201 Entità aggiornata.
400 Corpo della richiesta non valido.
401 Errore di autorizzazione.
403 Quota superata, entità non aggiornata.
500 Errore interno.

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

Intestazioni della risposta

Nessuno.

Corpo della risposta

Viene restituita la descrizione dell'entità. È possibile che alcune proprietà della descrizione, se mancanti nella richiesta PUT, contengano valori predefiniti.