Update Queue

Importante

Questa API è obsoleta e ritirata a partire dal 11/1/2021 e non deve più essere usata.

Aggiornamenti la descrizione della coda e invia lo stato degli aggiornamenti a FE/BE per aggiornare le voci del database corrispondenti.

Richiesta

Metodo	URI richiesta	Versione HTTP
PUT	https://management.core.windows.net/{subscription ID}/services/ServiceBus/Namespaces/{Namespace}/Queues/{Queue Path}	HTTP/1.1

Intestazioni richiesta

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

Intestazione della richiesta	Descrizione
Content-Type	application/xml;type=entry;charset=utf-8
If-Match	*
x-ms-version	2012-03-01

La richiesta richiede anche un certificato client. Questo certificato deve corrispondere a quello caricato per la sottoscrizione specifica.

Corpo della richiesta

La tabella seguente descrive gli elementi chiave del corpo della richiesta. Queste sono le uniche proprietà che è possibile aggiornare. Il corpo deve includere la descrizione completa della coda, anche se si modifica una sola proprietà. Il flusso consigliato è il seguente:

Ottenere la descrizione della coda.
Aggiornare gli elementi richiesti.
Passare la descrizione aggiornata.

Nome proprietà	Tipo	Descrizione

authorizationRules	AuthorizationRule[]	Matrice di regole di autorizzazione.
autoDeleteOnIdle	string	Indica se un'entità da eliminare automaticamente quando è inattiva per un determinato periodo di tempo.
deadLetteringOnMessageExpiration	Boolean	Può essere impostata solo al momento della creazione della coda. - Impostazione predefinita: False. Questo campo determina il modo in cui il bus di servizio gestisce un messaggio con un TTL scaduto. Se true e un messaggio scade, il bus di servizio sposta il messaggio dalla coda nella coda secondaria dei messaggi non recapitabili della coda. Se false, il messaggio viene eliminato definitivamente dalla coda.
defaultMessageTtl	Datetime XML	In base al fatto che l'invio di messaggi non recapitabili sia abilitato, se un messaggio è stato archiviato nella coda per più del tempo specificato, viene automaticamente spostato nella coda dei messaggi non recapitabili o eliminato. Questo valore viene sovrascritto dalla durata TTL specificata per il messaggio se tale durata è inferiore a quella specificata per la coda. Questo valore non può essere modificato dopo la creazione della coda: - Intervallo: 1 secondo - 14 giorni. - Impostazione predefinita: 14 giorni.
duplicateDetectionHistoryTimeWindow	Intervallo di tempo	Proprietà che specifica l'intervallo di tempo durante il quale il bus di servizio rileva la duplicazione dei messaggi. - Intervallo: 1 secondo-7 giorni. - Impostazione predefinita: 10 minuti.
enableBatchedOperations	Boolean	Indicare se si desidera che le operazioni in batch siano abilitate o meno.
forwardDeadLetteredMessagesTo	string	Specificare dove si desidera che i messaggi non recapitati vengano inoltrati.
forwardTo	string	Specificare dove si desidera che i messaggi vengano inoltrati.
lockDuration	Datetime XML	Questa impostazione determina l'intervallo di tempo, in secondi, durante il quale un messaggio deve essere bloccato per consentire l'elaborazione da parte di un ricevitore. Trascorso questo intervallo di tempo, il messaggio viene sbloccato ed è disponibile per il ricevitore successivo. Può essere impostata solo al momento della creazione della coda: - Intervallo: 0-5 minuti indica che il messaggio non è bloccato. - Impostazione predefinita: 30 secondi.
maxDeliveryCount	Unsigned Integer	Numero massimo di tentativi del bus di servizio di recapitare un messaggio prima di essere recapitati o eliminati senza messaggi non recapitabili. Il valore predefinito è 10.
maxSizeInMegabytes	Unsigned Integer	Dimensione massima in mega byte.
Stato	EntityStatus	Stato dell'entità.
userMetadata	string	Metadati utente.

Queste proprietà non possono essere aggiornate: requireSession, requiresDuplicateDetection, enablePartitioninge name.

Risposta

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

Codici di risposta

Nota

Se si crea una coda con un nome contenente caratteri speciali o codificati, ad esempio "test? Name=value&", che viene codificato in "test%3FName%3Dvalue%26"), verrà generata un'eccezione non autorizzata (401).

Codice	Descrizione
200	Descrizione della coda aggiornata correttamente.
401	Errore di autorizzazione.
404	L'entità non esiste in questo spazio dei nomi.
500	Errore interno.

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

Intestazioni della risposta

Nessuno.

Corpo della risposta