Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Descrizione della coda

 

La descrizione della coda è costituita da un documento AtomPub XML in cui è definita la semantica desiderata per una coda Nella descrizione della coda sono contenute le proprietà riportate di seguito.Per altre informazioni, vedere il proprietà QueueDescription argomento.

MaxSizeInMegaBytes: Number

Specifica la dimensione massima consentita per la coda in megabyte. Avrà esito negativo qualsiasi tentativo di accodare un messaggio che causi un superamento di tale valore da parte della coda. È possibile impostare questo parametro solo al momento della creazione della coda usando i seguenti valori:

  • Intervallo: 1 - 1024 (i valori validi sono 1024, 2048, 3072, 4096, 5120)

  • Valore predefinito: 1*1024 (i valori validi sono 1024, 2048, 3072, 4096, 5120)

SizeinBytes: Number

Indica il numero effettivo di byte attualmente occupati dai messaggi nella coda rispetto alla quota relativa alla coda.

MessageCount: Number

Visualizza il numero di messaggi attualmente presenti nella coda.

DefaultMessageTimeToLive: XML datetime

A seconda del fatto che la funzionalità DeadLettering sia abilitata o meno, un messaggio viene spostato automaticamente nella coda DeadLetterQueue oppure eliminato se è rimasto archiviato nella coda più a lungo del periodo di tempo specificato. Questo valore viene sovrascritto dalla durata (TTL) specificata per il messaggio solo se tale durata è inferiore a quella specificata per la coda. Questo valore non può essere modificato dopo la creazione della coda:

  • Intervallo: 1 secondo - TimeSpan.MaxValue

  • Valore predefinito: TimeSpan.MaxValue

LockDuration: XML datetime

Determina l'intervallo di tempo, in secondi, in cui un messaggio deve essere bloccato per consentire l'elaborazione da parte di un ricevitore. Dopo questo periodo, il messaggio viene sbloccato ed è disponibile per il ricevitore successivo:

  • Intervallo: 0 - 5 minuti. Il valore 0 indica che il messaggio non è bloccato.

  • Valore predefinito: 30 secondi

RequiresSession: True, False

Può essere impostata solo al momento della creazione della coda. Se è impostata su true, la coda sarà in grado di riconoscere le sessioni e sarà supportato solo SessionReceiver. Le code in grado di riconoscere le sessioni non sono supportate tramite REST.

  • Valore predefinito per una coda permanente: false

RequiresDuplicateDetection: True, False

Può essere impostata solo al momento della creazione della coda.

  • Valore predefinito per una coda permanente: false

EnableDeadLetteringOnMessageExpiration: True, False

Questo campo controlla il modo in cui Bus di servizio gestisce un messaggio con durata (TTL) scaduta. Se è abilitata e un messaggio scade, Bus di servizio sposta il messaggio dalla coda nella coda secondaria dei messaggi non recapitabili. Se è disabilitata, il messaggio viene eliminato definitivamente dalla coda. Può essere impostata solo al momento della creazione della coda.

  • Impostazione predefinita: false

DuplicateDetectionHistoryTimeWindow

Specifica l'intervallo di tempo durante il quale Bus di servizio deve rilevare i messaggi duplicati:

  • Intervallo: 1 secondo - 7 giorni

  • Valore predefinito: 10 minuti

EnableBatchedOperations

Abilita o disabilita il comportamento di invio in batch sul lato servizio durante l'esecuzione di operazioni per la coda specifica. Quando la proprietà è abilitata, Bus di servizio raccoglie/invia in batch più operazioni al sistema back-end per incrementare l'efficienza di connessione. È possibile disabilitare questa funzionalità se si desidera ridurre la latenza tra un'operazione e un'altra.

ForwardTo

Percorso al destinatario a cui viene inoltrato il messaggio.

MaxDeliveryCount

Numero massimo di volte in cui Bus di servizio tenta di recapitare un messaggio prima che questo risulti non recapitabile o venga rimosso.

IsAnonymousAccessible

Ottiene un valore che indica se l'accesso anonimo è consentito.

AuthorizationRules

Ottiene le regole di autorizzazione per la sottoscrizione.

Stato

Ottiene o imposta lo stato corrente della coda (abilitato o disabilitato). Una coda disabilitata non può inviare né ricevere messaggi.

SupportOrdering

Ottiene o imposta un valore che indica se la coda supporta l'ordinamento.

È importante notare che sulla convalida dello schema per la descrizione durante la creazione della coda influisce l'ordine dei relativi elementi figlio. La seguente ad esempio non viene accettata come una descrizione della coda valida.

<QueueDescription xmlns=\"http://schemas.microsoft.com/netservices/2010/10/servicebus/connect\"> <MaxSizeInMegaBytes>10000</MaxSizeInMegaBytes> <DefaultMessageTimeToLive>PT5M</DefaultMessageTimeToLive> <LockDuration>PT2M</LockDuration> <RequiresGroupedReceives>False</RequiresGroupedReceives> <SupportsDuplicateDetection>False</SupportsDuplicateDetection> </QueueDescription>

Se invece gli elementi sono ordinati nel modo seguente, la descrizione della coda viene accettata come valida:

<QueueDescription xmlns=\"http://schemas.microsoft.com/netservices/2010/10/servicebus/connect\"> <LockDuration>PT2M</LockDuration> <MaxSizeInMegaBytes>1024</MaxSizeInMegaBytes> <SupportsDuplicateDetection>false</SupportsDuplicateDetection> <RequiresGroupedReceives>false</RequiresGroupedReceives> <DefaultMessageTimeToLive>PT5M</DefaultMessageTimeToLive> </QueueDescription>

  • Elenco di tutte le code in un percorso determinato:

    http://<serviceBusAddress>/$Resources/Queues?$filter=startswith(path, ‘/my/test’)
    
  • Elenco di tutte le code aggiornate negli ultimi 5 minuti:

    http://<serviceBusAddress>/$Resources/Queues?$filter=lastModifiedTime Gt  2011-08-09T21:44:36.2481552Z
    
  • Elenco di tutte le code con almeno un messaggio:

    http://<serviceBusAddress>/$Resources/Queues?$filter=MessageCount Gt 0
    
Mostra: