PublishToAzureServiceBus@1 - Attività Pubblica nel bus di servizio di Azure v1

Articolo
2025-03-24

Usare questa attività per inviare un messaggio al bus di servizio di Azure usando una connessione al servizio (non è necessario alcun agente).

Sintassi

# Publish To Azure Service Bus v1
# Sends a message to Azure Service Bus using a service connection (no agent is required).
- task: PublishToAzureServiceBus@1
  inputs:
    azureSubscription: # string. Alias: connectedServiceName. Required. Azure Service Bus service connection. 
    #messageBody: # string. Message body. 
    #waitForCompletion: false # boolean. Wait for task completion. Default: false.
    #useDataContractSerializer: true # boolean. Use .NET data contract serializer. Default: true.
  # Advanced
    #sessionId: # string. Session Id. 
    #signPayload: false # boolean. Sign the Message. Default: false.
    #certificateString: # string. Required when signPayload = true. Certificate Variable. 
    #signatureKey: 'signature' # string. Optional. Use when signPayload = true. Signature Property Key. Default: signature.

# Publish To Azure Service Bus v1
# Sends a message to Azure Service Bus using a service connection (no agent is required).
- task: PublishToAzureServiceBus@1
  inputs:
    azureSubscription: # string. Alias: connectedServiceName. Required. Azure Service Bus service connection. 
    #messageBody: # string. Message body. 
    #waitForCompletion: false # boolean. Wait for task completion. Default: false.
  # Advanced
    #sessionId: # string. Session Id. 
    #signPayload: false # boolean. Sign the Message. Default: false.
    #certificateString: # string. Required when signPayload = true. Certificate Variable. 
    #signatureKey: 'signature' # string. Optional. Use when signPayload = true. Signature Property Key. Default: signature.

Ingressi dati

azureSubscription - connessione al servizio del bus di servizio di Azure
Alias di input: connectedServiceName. string. Obbligatorio.

Specifica una connessione al servizio del bus di servizio di Azure .

messageBody - corpo del messaggio
string.

Specifica il messageBodyJSON .

sessionId - id sessione
string.

Specifica l'ID sessione con cui viene pubblicato il messaggio. Per le code basate su sessione, la pubblicazione ha esito negativo se non viene specificato un valore. Per le code non basate su sessione, non è necessario specificare un valore.

signPayload - Firmare il messaggio
boolean. Valore predefinito: false

Se impostato su true, al messaggio verrà aggiunto un certificato privato.

certificateString - variabile di certificato
string. Obbligatorio quando signPayload = true.

Specifica la variabile segreta che contiene il contenuto del certificato. Può anche trattarsi di un certificato archiviato in un insieme di credenziali delle chiavi di Azure collegato a un gruppo di variabili usato dalla pipeline di versione.

signatureKey - della chiave della proprietà della firma
string. Opzionale. Usare quando signPayload = true. Valore predefinito: signature

In Proprietà messaggio specifica la chiave in cui si trova la firma. Se lasciato vuoto, il valore predefinito è signature.

waitForCompletion - Attendere il completamento dell'attività
boolean. Valore predefinito: false

Se impostato su true, questa attività attenderà l'evento TaskCompleted per il timeout dell'attività specificato.

useDataContractSerializer - Usare il serializzatore di contratti dati .NET.
boolean. Valore predefinito: true

Impostare useDataContractSerializer su false se si vuole passare il messaggio come flusso anziché come oggetto .

Opzioni di controllo delle attività

Tutte le attività dispongono di opzioni di controllo oltre ai relativi input attività. Per altre informazioni, vedere Opzioni di controllo e proprietà comuni delle attività.

Variabili di output

Nessuno.

Osservazioni:

Usare questa attività in un processo senza agente di una pipeline di versione per inviare un messaggio a un bus di servizio di Azure usando una connessione al servizio (senza usare un agente).

Nota

Può essere usato solo in un processo senza agente di una pipeline di versione.

Dove deve essere completato un segnale di attività?

Per segnalare il completamento, il servizio esterno deve inviare i dati di completamento POST all'endpoint REST delle pipeline seguente.

{planUri}/{projectId}/_apis/distributedtask/hubs/{hubName}/plans/{planId}/events?api-version=2.0-preview.1

**Request Body**
 { "name": "TaskCompleted", "taskId": "taskInstanceId", "jobId": "jobId", "result": "succeeded" }

Per informazioni specifiche, vedere questa semplice applicazione cmdline.

Inoltre, è disponibile una libreria helper C# per abilitare la registrazione in tempo reale e gestire lo stato dell'attività per le attività senza agente. Altre informazioni su attività senza agente HTTP asincrone.

Requisiti

Requisito	Descrizione
Tipi di pipeline	YAML, build classica, versione classica
Viene eseguito in	Servitore
richieste	Nessuno
funzionalità di	Questa attività non soddisfa alcuna richiesta di attività successive nel processo.
restrizioni dei comandi	Qualunque
variabili impostabili	Qualunque
Versione dell'agente	Tutte le versioni dell'agente supportate.
Categoria attività	Utilità

Condividi tramite