AMQP 1.0 nel bus di servizio di Microsoft Azure: operazioni basate su richiesta/rispostaAMQP 1.0 in Microsoft Azure Service Bus: request-response-based operations

Questo argomento offre un elenco delle operazioni basate su richiesta/risposta del bus di servizio di Microsoft Azure.This topic defines the list of Microsoft Azure Service Bus request/response-based operations. Le informazioni sono basate sulla bozza di lavoro di AMQP Management versione 1.0.This information is based on the AMQP Management Version 1.0 working draft.

Per una guida dettagliata al protocollo a livello di rete AMQP 1.0, che illustra come il bus di servizio è basato sulla specifica tecnica OASIS AMQP e la implementa, vedere Guida al protocollo AMQP 1.0 nel bus di servizio e in Hub eventi di Azure.For a detailed wire-level AMQP 1.0 protocol guide, which explains how Service Bus implements and builds on the OASIS AMQP technical specification, see the [AMQP 1.0 in Azure Service Bus and Event Hubs protocol guide][AMQP 1.0 protocol guide].

ConcettiConcepts

Descrizione di entitàEntity description

Una descrizione di entità fa riferimento a un oggetto classe QueueDescription, classe TopicDescription o classe SubscriptionDescription del bus di servizio.An entity description refers to either a Service Bus QueueDescription class, TopicDescription class, or SubscriptionDescription class object.

Messaggio negoziatoBrokered message

Rappresenta un messaggio nel bus di servizio mappato a un messaggio AMQP.Represents a message in Service Bus, which is mapped to an AMQP message. Per la definizione del mapping, consultare la Guida al protocollo AMQP nel bus di servizio.The mapping is defined in the Service Bus AMQP protocol guide.

Eseguire il collegamento a un nodo di gestione di entitàAttach to entity management node

Tutte le operazioni descritte in questo documento seguono un modello richiesta/risposta, hanno come ambito un'entità e richiedono il collegamento a un nodo di gestione di entità.All the operations described in this document follow a request/response pattern, are scoped to an entity, and require attaching to an entity management node.

Crea un collegamento al nodo di gestione per l'invio delle richieste.Creates a link to the management node for sending requests.

requestLink = session.attach(     
role: SENDER,   
    target: { address: "<entity address>/$management" },   
    source: { address: ""<my request link unique address>" }   
)  

Crea un collegamento per la ricezione delle risposte dal nodo di gestione.Creates a link for receiving responses from the management node.

responseLink = session.attach(    
role: RECEIVER,   
    source: { address: "<entity address>/$management" }   
    target: { address: "<my response link unique address>" }   
)  

Trasferire un messaggio di richiestaTransfer a request message

Trasferisce un messaggio di richiesta.Transfers a request message.

requestLink.sendTransfer(  
        Message(  
                properties: {  
                        message-id: <request id>,  
                        reply-to: "<my response link unique address>"  
                },  
                application-properties: {  
                        "operation" -> "<operation>",  
                },  
        )  

Ricevere un messaggio di rispostaReceive a response message

Riceve il messaggio di risposta dal collegamento per le risposte.Receives the response message from the response link.

responseMessage = responseLink.receiveTransfer()  

Il messaggio di risposta è nel modulo seguente:The response message is in the following form:

Message(  
properties: {     
        correlation-id: <request id>  
    },  
    application-properties: {  
            "statusCode" -> <status code>,  
            "statusDescription" -> <status description>,  
           },         
)  

Indirizzo delle entità del bus di servizioService Bus entity address

L'indirizzo delle entità del bus di servizio deve essere definito come segue:Service Bus entities must be addressed as follows:

Tipo di entitàEntity type IndirizzoAddress EsempioExample
codaqueue <queue_name> “myQueue”

“site1/myQueue”
argomentotopic <topic_name> “myTopic”

“site2/page1/myQueue”
sottoscrizionesubscription <topic_name>/Subscriptions/<subscription_name> “myTopic/Subscriptions/MySub”

Operazioni sui messaggiMessage operations

Rinnovo del blocco del messaggioMessage Renew Lock

Estende il blocco di un messaggio per il tempo specificato nella descrizione dell'entità.Extends the lock of a message by the time specified in the entity description.

RichiestaRequest

Il messaggio di richiesta deve includere le proprietà di applicazione seguenti:The request message must include the following application properties:

ChiaveKey Tipo di valoreValue Type ObbligatorioRequired Contenuti del valoreValue Contents
operationoperation stringstring Yes com.microsoft:renew-lock
com.microsoft:server-timeout uintuint NoNo Timeout del server per l'operazione, in millisecondi.Operation server timeout in milliseconds.

Il corpo del messaggio di richiesta deve essere costituito da una sezione amqp-value contenente un mapping con le voci seguenti:The request message body must consist of an amqp-value section containing a map with the following entries:

ChiaveKey Tipo di valoreValue Type ObbligatorioRequired Contenuti del valoreValue Contents
lock-tokens matrice di UUIDarray of uuid Yes Token di blocco del messaggio da rinnovare.Message lock tokens to renew.

RispostaResponse

Il messaggio di risposta deve includere le proprietà di applicazione seguenti:The response message must include the following application properties:

ChiaveKey Tipo di valoreValue Type ObbligatorioRequired Contenuti del valoreValue Contents
statusCodestatusCode intint Yes Codice di risposta HTTP [RFC2616]HTTP response code [RFC2616]

200 (OK) in caso di esito positivo, altro valore in caso di esito negativo.200: OK – success, otherwise failed.
statusDescriptionstatusDescription stringstring NoNo Descrizione dello stato.Description of the status.

Il corpo del messaggio di risposta deve essere costituito da una sezione amqp-value contenente un mapping con le voci seguenti:The response message body must consist of an amqp-value section containing a map with the following entries:

ChiaveKey Tipo di valoreValue Type ObbligatorioRequired Contenuti del valoreValue Contents
expirationsexpirations matrice di timestamparray of timestamp Yes Nuova scadenza del token di blocco del messaggio corrispondente ai token di blocco della richiesta.Message lock token new expiration corresponding to the request lock tokens.

Visualizzazione del messaggioPeek Message

Visualizza i messaggi senza blocco.Peeks messages without locking.

RichiestaRequest

Il messaggio di richiesta deve includere le proprietà di applicazione seguenti:The request message must include the following application properties:

ChiaveKey Tipo di valoreValue Type ObbligatorioRequired Contenuti del valoreValue Contents
operationoperation stringstring Yes com.microsoft:peek-message
com.microsoft:server-timeout uintuint NoNo Timeout del server per l'operazione, in millisecondi.Operation server timeout in milliseconds.

Il corpo del messaggio di richiesta deve essere costituito da una sezione amqp-value contenente un mapping con le voci seguenti:The request message body must consist of an amqp-value section containing a map with the following entries:

ChiaveKey Tipo di valoreValue Type ObbligatorioRequired Contenuti del valoreValue Contents
from-sequence-number longlong Yes Numero di sequenza da cui iniziare la visualizzazione.Sequence number from which to start peek.
message-count intint Yes Numero massimo di messaggi da visualizzare.Maximum number of messages to peek.

ResponseResponse

Il messaggio di risposta deve includere le proprietà di applicazione seguenti:The response message must include the following application properties:

ChiaveKey Tipo di valoreValue Type ObbligatorioRequired Contenuti del valoreValue Contents
statusCodestatusCode intint Yes Codice di risposta HTTP [RFC2616]HTTP response code [RFC2616]

200 (OK) se sono presenti altri messaggi200: OK – has more messages

0xcc (nessun contenuto) se non sono presenti altri messaggi0xcc: No content – no more messages
statusDescriptionstatusDescription stringstring NoNo Descrizione dello stato.Description of the status.

Il corpo del messaggio di risposta deve essere costituito da una sezione amqp-value contenente un mapping con le voci seguenti:The response message body must consist of an amqp-value section containing a map with the following entries:

ChiaveKey Tipo di valoreValue Type ObbligatorioRequired Contenuti del valoreValue Contents
del cloud al dispositivomessages elenco di mappinglist of maps Yes Elenco di messaggi in cui ogni mapping rappresenta un messaggio.List of messages in which every map represents a message.

Il mapping che rappresenta un messaggio deve contenere le voci seguenti:The map representing a message must contain the following entries:

ChiaveKey Tipo di valoreValue Type ObbligatorioRequired Contenuti del valoreValue Contents
messagemessage matrice di bytearray of byte Yes Messaggio con codifica in transito AMQP 1.0.AMQP 1.0 wire-encoded message.

Pianificazione del messaggioSchedule Message

Pianifica i messaggi.Schedules messages.

RichiestaRequest

Il messaggio di richiesta deve includere le proprietà di applicazione seguenti:The request message must include the following application properties:

ChiaveKey Tipo di valoreValue Type ObbligatorioRequired Contenuti del valoreValue Contents
operationoperation stringstring Yes com.microsoft:schedule-message
com.microsoft:server-timeout uintuint NoNo Timeout del server per l'operazione, in millisecondi.Operation server timeout in milliseconds.

Il corpo del messaggio di richiesta deve essere costituito da una sezione amqp-value contenente un mapping con le voci seguenti:The request message body must consist of an amqp-value section containing a map with the following entries:

ChiaveKey Tipo di valoreValue Type ObbligatorioRequired Contenuti del valoreValue Contents
del cloud al dispositivomessages elenco di mappinglist of maps Yes Elenco di messaggi in cui ogni mapping rappresenta un messaggio.List of messages in which every map represents a message.

Il mapping che rappresenta un messaggio deve contenere le voci seguenti:The map representing a message must contain the following entries:

ChiaveKey Tipo di valoreValue Type ObbligatorioRequired Contenuti del valoreValue Contents
message-idmessage-id stringstring Yes amqpMessage.Properties.MessageId in formato stringaamqpMessage.Properties.MessageId as string
session-idsession-id stringstring Yes amqpMessage.Properties.GroupId as string
partition-keypartition-key stringstring Yes amqpMessage.MessageAnnotations.”x-opt-partition-key"
messagemessage matrice di bytearray of byte Yes Messaggio con codifica in transito AMQP 1.0.AMQP 1.0 wire-encoded message.

RispostaResponse

Il messaggio di risposta deve includere le proprietà di applicazione seguenti:The response message must include the following application properties:

ChiaveKey Tipo di valoreValue Type ObbligatorioRequired Contenuti del valoreValue Contents
statusCodestatusCode intint Yes Codice di risposta HTTP [RFC2616]HTTP response code [RFC2616]

200 (OK) in caso di esito positivo, altro valore in caso di esito negativo.200: OK – success, otherwise failed.
statusDescriptionstatusDescription stringstring NoNo Descrizione dello stato.Description of the status.

Il corpo del messaggio di risposta deve essere costituito da una sezione amqp-value contenente un mapping con le voci seguenti:The response message body must consist of an amqp-value section containing a map with the following entries:

ChiaveKey Tipo di valoreValue Type ObbligatorioRequired Contenuti del valoreValue Contents
sequence-numberssequence-numbers matrice di longarray of long Yes Numero di sequenza dei messaggi pianificati.Sequence number of scheduled messages. Il numero di sequenza viene usato per l'annullamento.Sequence number is used to cancel.

Annullamento del messaggio pianificatoCancel Scheduled Message

Annulla i messaggi pianificati.Cancels scheduled messages.

RichiestaRequest

Il messaggio di richiesta deve includere le proprietà di applicazione seguenti:The request message must include the following application properties:

ChiaveKey Tipo di valoreValue Type ObbligatorioRequired Contenuti del valoreValue Contents
operationoperation stringstring Yes com.microsoft:cancel-scheduled-message
com.microsoft:server-timeout uintuint NoNo Timeout del server per l'operazione, in millisecondi.Operation server timeout in milliseconds.

Il corpo del messaggio di richiesta deve essere costituito da una sezione amqp-value contenente un mapping con le voci seguenti:The request message body must consist of an amqp-value section containing a map with the following entries:

ChiaveKey Tipo di valoreValue Type ObbligatorioRequired Contenuti del valoreValue Contents
sequence-numberssequence-numbers matrice di longarray of long Yes Numero di sequenza dei messaggi pianificati da annullare.Sequence numbers of scheduled messages to cancel.

ResponseResponse

Il messaggio di risposta deve includere le proprietà di applicazione seguenti:The response message must include the following application properties:

ChiaveKey Tipo di valoreValue Type ObbligatorioRequired Contenuti del valoreValue Contents
statusCodestatusCode intint Yes Codice di risposta HTTP [RFC2616]HTTP response code [RFC2616]

200 (OK) in caso di esito positivo, altro valore in caso di esito negativo.200: OK – success, otherwise failed.
statusDescriptionstatusDescription stringstring NoNo Descrizione dello stato.Description of the status.

Il corpo del messaggio di risposta deve essere costituito da una sezione amqp-value contenente un mapping con le voci seguenti:The response message body must consist of an amqp-value section containing a map with the following entries:

ChiaveKey Tipo di valoreValue Type ObbligatorioRequired Contenuti del valoreValue Contents
sequence-numberssequence-numbers matrice di longarray of long Yes Numero di sequenza dei messaggi pianificati.Sequence number of scheduled messages. Il numero di sequenza viene usato per l'annullamento.Sequence number is used to cancel.

Operazioni sulle sessioniSession Operations

Rinnovo del blocco della sessioneSession Renew Lock

Estende il blocco di un messaggio per il tempo specificato nella descrizione dell'entità.Extends the lock of a message by the time specified in the entity description.

RichiestaRequest

Il messaggio di richiesta deve includere le proprietà di applicazione seguenti:The request message must include the following application properties:

ChiaveKey Tipo di valoreValue Type ObbligatorioRequired Contenuti del valoreValue Contents
operationoperation stringstring Yes com.microsoft:renew-session-lock
com.microsoft:server-timeout uintuint NoNo Timeout del server per l'operazione, in millisecondi.Operation server timeout in milliseconds.

Il corpo del messaggio di richiesta deve essere costituito da una sezione amqp-value contenente un mapping con le voci seguenti:The request message body must consist of an amqp-value section containing a map with the following entries:

ChiaveKey Tipo di valoreValue Type ObbligatorioRequired Contenuti del valoreValue Contents
session-idsession-id stringstring Yes ID sessione.Session ID.

ResponseResponse

Il messaggio di risposta deve includere le proprietà di applicazione seguenti:The response message must include the following application properties:

ChiaveKey Tipo di valoreValue Type ObbligatorioRequired Contenuti del valoreValue Contents
statusCodestatusCode intint Yes Codice di risposta HTTP [RFC2616]HTTP response code [RFC2616]

200 (OK) se sono presenti altri messaggi200: OK – has more messages

0xcc (nessun contenuto) se non sono presenti altri messaggi0xcc: No content – no more messages
statusDescriptionstatusDescription stringstring NoNo Descrizione dello stato.Description of the status.

Il corpo del messaggio di risposta deve essere costituito da una sezione amqp-value contenente un mapping con le voci seguenti:The response message body must consist of an amqp-value section containing a map with the following entries:

ChiaveKey Tipo di valoreValue Type ObbligatorioRequired Contenuti del valoreValue Contents
expirationexpiration timestamptimestamp Yes Nuova scadenza.New expiration.

Visualizzazione del messaggio di sessionePeek Session Message

Visualizza i messaggi di sessione senza blocco.Peeks session messages without locking.

RichiestaRequest

Il messaggio di richiesta deve includere le proprietà di applicazione seguenti:The request message must include the following application properties:

ChiaveKey Tipo di valoreValue Type ObbligatorioRequired Contenuti del valoreValue Contents
operationoperation stringstring Yes com.microsoft:peek-message
com.microsoft:server-timeout uintuint NoNo Timeout del server per l'operazione, in millisecondi.Operation server timeout in milliseconds.

Il corpo del messaggio di richiesta deve essere costituito da una sezione amqp-value contenente un mapping con le voci seguenti:The request message body must consist of an amqp-value section containing a map with the following entries:

ChiaveKey Tipo di valoreValue Type ObbligatorioRequired Contenuti del valoreValue Contents
from-sequence-numberfrom-sequence-number longlong Yes Numero di sequenza da cui iniziare la visualizzazione.Sequence number from which to start peek.
message-countmessage-count intint Yes Numero massimo di messaggi da visualizzare.Maximum number of messages to peek.
session-idsession-id stringstring Yes ID sessione.Session ID.

ResponseResponse

Il messaggio di risposta deve includere le proprietà di applicazione seguenti:The response message must include the following application properties:

ChiaveKey Tipo di valoreValue Type ObbligatorioRequired Contenuti del valoreValue Contents
statusCodestatusCode intint Yes Codice di risposta HTTP [RFC2616]HTTP response code [RFC2616]

200 (OK) se sono presenti altri messaggi200: OK – has more messages

0xcc (nessun contenuto) se non sono presenti altri messaggi0xcc: No content – no more messages
statusDescriptionstatusDescription stringstring NoNo Descrizione dello stato.Description of the status.

Il corpo del messaggio di risposta deve essere costituito da una sezione amqp-value contenente un mapping con le voci seguenti:The response message body must consist of an amqp-value section containing a map with the following entries:

ChiaveKey Tipo di valoreValue Type ObbligatorioRequired Contenuti del valoreValue Contents
del cloud al dispositivomessages elenco di mappinglist of maps Yes Elenco di messaggi in cui ogni mapping rappresenta un messaggio.List of messages in which every map represents a message.

Il mapping che rappresenta un messaggio deve contenere le voci seguenti:The map representing a message must contain the following entries:

ChiaveKey Tipo di valoreValue Type ObbligatorioRequired Contenuti del valoreValue Contents
messagemessage matrice di bytearray of byte Yes Messaggio con codifica in transito AMQP 1.0.AMQP 1.0 wire-encoded message.

Impostazione dello stato della sessioneSet Session State

Imposta lo stato di una sessione.Sets the state of a session.

RichiestaRequest

Il messaggio di richiesta deve includere le proprietà di applicazione seguenti:The request message must include the following application properties:

ChiaveKey Tipo di valoreValue Type ObbligatorioRequired Contenuti del valoreValue Contents
operationoperation stringstring Yes com.microsoft:peek-message
com.microsoft:server-timeout uintuint NoNo Timeout del server per l'operazione, in millisecondi.Operation server timeout in milliseconds.

Il corpo del messaggio di richiesta deve essere costituito da una sezione amqp-value contenente un mapping con le voci seguenti:The request message body must consist of an amqp-value section containing a map with the following entries:

ChiaveKey Tipo di valoreValue Type ObbligatorioRequired Contenuti del valoreValue Contents
session-idsession-id stringstring Yes ID sessione.Session ID.
session-statesession-state matrice di bytearray of bytes Yes Dati binari opachi.Opaque binary data.

ResponseResponse

Il messaggio di risposta deve includere le proprietà di applicazione seguenti:The response message must include the following application properties:

ChiaveKey Tipo di valoreValue Type ObbligatorioRequired Contenuti del valoreValue Contents
statusCodestatusCode intint Yes Codice di risposta HTTP [RFC2616]HTTP response code [RFC2616]

200 (OK) in caso di esito positivo, altro valore in caso di esito negativo200: OK – success, otherwise failed
statusDescriptionstatusDescription stringstring NoNo Descrizione dello stato.Description of the status.

Recupero dello stato della sessioneGet Session State

Recupera lo stato di una sessione.Gets the state of a session.

RichiestaRequest

Il messaggio di richiesta deve includere le proprietà di applicazione seguenti:The request message must include the following application properties:

ChiaveKey Tipo di valoreValue Type ObbligatorioRequired Contenuti del valoreValue Contents
operationoperation stringstring Yes com.microsoft:get-session-state
com.microsoft:server-timeout uintuint NoNo Timeout del server per l'operazione, in millisecondi.Operation server timeout in milliseconds.

Il corpo del messaggio di richiesta deve essere costituito da una sezione amqp-value contenente un mapping con le voci seguenti:The request message body must consist of an amqp-value section containing a map with the following entries:

ChiaveKey Tipo di valoreValue Type ObbligatorioRequired Contenuti del valoreValue Contents
session-idsession-id stringstring Yes ID sessione.Session ID.

ResponseResponse

Il messaggio di risposta deve includere le proprietà di applicazione seguenti:The response message must include the following application properties:

ChiaveKey Tipo di valoreValue Type ObbligatorioRequired Contenuti del valoreValue Contents
statusCodestatusCode intint Yes Codice di risposta HTTP [RFC2616]HTTP response code [RFC2616]

200 (OK) in caso di esito positivo, altro valore in caso di esito negativo200: OK – success, otherwise failed
statusDescriptionstatusDescription stringstring NoNo Descrizione dello stato.Description of the status.

Il corpo del messaggio di risposta deve essere costituito da una sezione amqp-value contenente un mapping con le voci seguenti:The response message body must consist of an amqp-value section containing a map with the following entries:

ChiaveKey Tipo di valoreValue Type ObbligatorioRequired Contenuti del valoreValue Contents
session-statesession-state matrice di bytearray of bytes Yes Dati binari opachi.Opaque binary data.

Enumerazione delle sessioniEnumerate Sessions

Enumera le sessioni per un'entità di messaggistica.Enumerates sessions on a messaging entity.

RichiestaRequest

Il messaggio di richiesta deve includere le proprietà di applicazione seguenti:The request message must include the following application properties:

ChiaveKey Tipo di valoreValue Type ObbligatorioRequired Contenuti del valoreValue Contents
operationoperation stringstring Yes com.microsoft:get-message-sessions
com.microsoft:server-timeout uintuint NoNo Timeout del server per l'operazione, in millisecondi.Operation server timeout in milliseconds.

Il corpo del messaggio di richiesta deve essere costituito da una sezione amqp-value contenente un mapping con le voci seguenti:The request message body must consist of an amqp-value section containing a map with the following entries:

ChiaveKey Tipo di valoreValue Type ObbligatorioRequired Contenuti del valoreValue Contents
last-updated-timelast-updated-time timestamptimestamp Yes Filtro per includere solo le sessioni aggiornate dopo un determinato momento.Filter to include only sessions updated after a given time.
skipskip intint Yes Numero di sessioni da ignorare.Skip a number of sessions.
toptop intint Yes Numero massimo di sessioni.Maximum number of sessions.

RispostaResponse

Il messaggio di risposta deve includere le proprietà di applicazione seguenti:The response message must include the following application properties:

ChiaveKey Tipo di valoreValue Type ObbligatorioRequired Contenuti del valoreValue Contents
statusCodestatusCode intint Yes Codice di risposta HTTP [RFC2616]HTTP response code [RFC2616]

200 (OK) se sono presenti altri messaggi200: OK – has more messages

0xcc (nessun contenuto) se non sono presenti altri messaggi0xcc: No content – no more messages
statusDescriptionstatusDescription stringstring NoNo Descrizione dello stato.Description of the status.

Il corpo del messaggio di risposta deve essere costituito da una sezione amqp-value contenente un mapping con le voci seguenti:The response message body must consist of an amqp-value section containing a map with the following entries:

ChiaveKey Tipo di valoreValue Type ObbligatorioRequired Contenuti del valoreValue Contents
skipskip intint Yes Numero di sessioni ignorate se il codice di stato è 200.Number of skipped sessions if status code is 200.
sessions-idssessions-ids matrice di stringhearray of strings Yes Matrice di ID sessione se il codice di stato è 200.Array of session IDs if status code is 200.

Operazioni sulle regoleRule operations

Aggiunta di una regolaAdd Rule

RichiestaRequest

Il messaggio di richiesta deve includere le proprietà di applicazione seguenti:The request message must include the following application properties:

ChiaveKey Tipo di valoreValue Type ObbligatorioRequired Contenuti del valoreValue Contents
operationoperation stringstring Yes com.microsoft:add-rule
com.microsoft:server-timeout uintuint NoNo Timeout del server per l'operazione, in millisecondi.Operation server timeout in milliseconds.

Il corpo del messaggio di richiesta deve essere costituito da una sezione amqp-value contenente un mapping con le voci seguenti:The request message body must consist of an amqp-value section containing a map with the following entries:

ChiaveKey Tipo di valoreValue Type ObbligatorioRequired Contenuti del valoreValue Contents
rule-namerule-name stringstring Yes Nome della regola, senza nomi di sottoscrizione e argomento.Rule name, not including subscription and topic names.
rule-descriptionrule-description mapmap Yes Descrizione della regola, come specificato nella sezione successiva.Rule description as specified in next section.

Il mapping rule-description deve includere le voci seguenti, in cui sql-filter e correlation-filter si escludono a vicenda:The rule-description map must include the following entries, where sql-filter and correlation-filter are mutually exclusive:

ChiaveKey Tipo di valoreValue Type ObbligatorioRequired Contenuti del valoreValue Contents
sql-filtersql-filter mapmap Yes sql-filter, come specificato nella sezione successiva.sql-filter, as specified in the next section.
correlation-filtercorrelation-filter mapmap Yes correlation-filter, come specificato nella sezione successiva.correlation-filter, as specified in the next section.
sql-rule-actionsql-rule-action mapmap Yes sql-rule-action, come specificato nella sezione successiva.sql-rule-action, as specified in the next section.

Il mapping sql-filter deve includere le voci seguenti:The sql-filter map must include the following entries:

ChiaveKey Tipo di valoreValue Type ObbligatorioRequired Contenuti del valoreValue Contents
expressionexpression stringstring Yes Espressione di filtro SQL.Sql filter expression.

Il mapping correlation-filter deve includere almeno una delle voci seguenti:The correlation-filter map must include at least one of the following entries:

ChiaveKey Tipo di valoreValue Type ObbligatorioRequired Contenuti del valoreValue Contents
correlation-idcorrelation-id stringstring NoNo
message-idmessage-id stringstring NoNo
toto stringstring NoNo
reply-toreply-to stringstring NoNo
labellabel stringstring NoNo
session-idsession-id stringstring NoNo
reply-to-session-idreply-to-session-id stringstring NoNo
content-typecontent-type stringstring NoNo
propertiesproperties mapmap NoNo Mapping alle proprietà della classe BrokeredMessage del bus di servizio.Maps to Service Bus BrokeredMessage.Properties.

Il mapping sql-rule-action deve includere le voci seguenti:The sql-rule-action map must include the following entries:

ChiaveKey Tipo di valoreValue Type ObbligatorioRequired Contenuti del valoreValue Contents
expressionexpression stringstring Yes Espressione di azione SQL.Sql action expression.

RispostaResponse

Il messaggio di risposta deve includere le proprietà di applicazione seguenti:The response message must include the following application properties:

ChiaveKey Tipo di valoreValue Type ObbligatorioRequired Contenuti del valoreValue Contents
statusCodestatusCode intint Yes Codice di risposta HTTP [RFC2616]HTTP response code [RFC2616]

200 (OK) in caso di esito positivo, altro valore in caso di esito negativo200: OK – success, otherwise failed
statusDescriptionstatusDescription stringstring NoNo Descrizione dello stato.Description of the status.

Rimozione di una regolaRemove Rule

RichiestaRequest

Il messaggio di richiesta deve includere le proprietà di applicazione seguenti:The request message must include the following application properties:

ChiaveKey Tipo di valoreValue Type ObbligatorioRequired Contenuti del valoreValue Contents
operationoperation stringstring Yes com.microsoft:remove-rule
com.microsoft:server-timeout uintuint NoNo Timeout del server per l'operazione, in millisecondi.Operation server timeout in milliseconds.

Il corpo del messaggio di richiesta deve essere costituito da una sezione amqp-value contenente un mapping con le voci seguenti:The request message body must consist of an amqp-value section containing a map with the following entries:

ChiaveKey Tipo di valoreValue Type ObbligatorioRequired Contenuti del valoreValue Contents
rule-namerule-name stringstring Yes Nome della regola, senza nomi di sottoscrizione e argomento.Rule name, not including subscription and topic names.

ResponseResponse

Il messaggio di risposta deve includere le proprietà di applicazione seguenti:The response message must include the following application properties:

ChiaveKey Tipo di valoreValue Type ObbligatorioRequired Contenuti del valoreValue Contents
statusCodestatusCode intint Yes Codice di risposta HTTP [RFC2616]HTTP response code [RFC2616]

200 (OK) in caso di esito positivo, altro valore in caso di esito negativo200: OK – success, otherwise failed
statusDescriptionstatusDescription stringstring NoNo Descrizione dello stato.Description of the status.

Operazioni sui messaggi rinviatiDeferred message operations

Ricezione in base al numero di sequenzaReceive by sequence number

Riceve i messaggi rinviati in base al numero di sequenza.Receives deferred messages by sequence number.

RichiestaRequest

Il messaggio di richiesta deve includere le proprietà di applicazione seguenti:The request message must include the following application properties:

ChiaveKey Tipo di valoreValue Type ObbligatorioRequired Contenuti del valoreValue Contents
operationoperation stringstring Yes com.microsoft:receive-by-sequence-number
com.microsoft:server-timeout uintuint NoNo Timeout del server per l'operazione, in millisecondi.Operation server timeout in milliseconds.

Il corpo del messaggio di richiesta deve essere costituito da una sezione amqp-value contenente un mapping con le voci seguenti:The request message body must consist of an amqp-value section containing a map with the following entries:

ChiaveKey Tipo di valoreValue Type ObbligatorioRequired Contenuti del valoreValue Contents
sequence-numberssequence-numbers matrice di longarray of long Yes Numeri di sequenza.Sequence numbers.
receiver-settle-modereceiver-settle-mode ubyteubyte Yes Modalità di finalizzazione del ricevitore, come indicata nella specifica di base AMQP versione 1.0.Receiver settle mode as specified in AMQP core v1.0.

RispostaResponse

Il messaggio di risposta deve includere le proprietà di applicazione seguenti:The response message must include the following application properties:

ChiaveKey Tipo di valoreValue Type ObbligatorioRequired Contenuti del valoreValue Contents
statusCodestatusCode intint Yes Codice di risposta HTTP [RFC2616]HTTP response code [RFC2616]

200 (OK) in caso di esito positivo, altro valore in caso di esito negativo200: OK – success, otherwise failed
statusDescriptionstatusDescription stringstring NoNo Descrizione dello stato.Description of the status.

Il corpo del messaggio di risposta deve essere costituito da una sezione amqp-value contenente un mapping con le voci seguenti:The response message body must consist of an amqp-value section containing a map with the following entries:

ChiaveKey Tipo di valoreValue Type ObbligatorioRequired Contenuti del valoreValue Contents
del cloud al dispositivomessages elenco di mappinglist of maps Yes Elenco di messaggi in cui ogni mapping rappresenta un messaggio.List of messages where every map represents a message.

Il mapping che rappresenta un messaggio deve contenere le voci seguenti:The map representing a message must contain the following entries:

ChiaveKey Tipo di valoreValue Type ObbligatorioRequired Contenuti del valoreValue Contents
lock-tokenlock-token uuiduuid Yes Token di blocco se il valore di receiver-settle-mode è 1.Lock token if receiver-settle-mode is 1.
messagemessage matrice di bytearray of byte Yes Messaggio con codifica in transito AMQP 1.0.AMQP 1.0 wire-encoded message.

Aggiornamento dello stato di ricezioneUpdate disposition status

Aggiorna lo stato di ricezione dei messaggi rinviati.Updates the disposition status of deferred messages.

RichiestaRequest

Il messaggio di richiesta deve includere le proprietà di applicazione seguenti:The request message must include the following application properties:

ChiaveKey Tipo di valoreValue Type ObbligatorioRequired Contenuti del valoreValue Contents
operationoperation stringstring Yes com.microsoft:update-disposition
com.microsoft:server-timeout uintuint NoNo Timeout del server per l'operazione, in millisecondi.Operation server timeout in milliseconds.

Il corpo del messaggio di richiesta deve essere costituito da una sezione amqp-value contenente un mapping con le voci seguenti:The request message body must consist of an amqp-value section containing a map with the following entries:

ChiaveKey Tipo di valoreValue Type ObbligatorioRequired Contenuti del valoreValue Contents
disposition-statusdisposition-status stringstring Yes completedcompleted

abandonedabandoned

suspendedsuspended
lock-tokenslock-tokens matrice di UUIDarray of uuid Yes Token di blocco dei messaggi per aggiornare lo stato di ricezione.Message lock tokens to update disposition status.
deadletter-reasondeadletter-reason stringstring NoNo Può essere impostato se lo stato di ricezione è suspended.May be set if disposition status is set to suspended.
deadletter-descriptiondeadletter-description stringstring NoNo Può essere impostato se lo stato di ricezione è suspended.May be set if disposition status is set to suspended.
properties-to-modifyproperties-to-modify mapmap NoNo Elenco delle proprietà dei messaggi negoziati del bus di servizio da modificare.List of Service Bus brokered message properties to modify.

ResponseResponse

Il messaggio di risposta deve includere le proprietà di applicazione seguenti:The response message must include the following application properties:

ChiaveKey Tipo di valoreValue Type ObbligatorioRequired Contenuti del valoreValue Contents
statusCodestatusCode intint Yes Codice di risposta HTTP [RFC2616]HTTP response code [RFC2616]

200 (OK) in caso di esito positivo, altro valore in caso di esito negativo200: OK – success, otherwise failed
statusDescriptionstatusDescription stringstring NoNo Descrizione dello stato.Description of the status.

Passaggi successiviNext steps

Per altre informazioni su AMQP e sul bus di servizio, visitare i collegamenti seguenti:To learn more about AMQP and Service Bus, visit the following links: