PublishToAzureServiceBus@1: Veröffentlichen in Azure Service Bus v1-Aufgabe

Artikel
06/11/2024

Verwenden Sie diese Aufgabe, um mithilfe einer Dienstverbindung eine Nachricht an Azure Service Bus zu senden (kein Agent ist erforderlich).

Verwenden Sie diese Aufgabe, um eine Nachricht über eine Dienstverbindung an Azure Service Bus zu senden (kein Agent erforderlich).

Syntax

# 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.

# Publish To Azure Service Bus v1
# Sends a message to azure service bus using a service connection (no agent 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.
  # Signing Properties
    #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.

Eingaben

azureSubscription - Azure Service Bus Dienstverbindung
Eingabealias: connectedServiceName. string. Erforderlich.

Gibt eine Azure Service Bus-Dienstverbindung an.

messageBody - Nachrichtentext
string.

Gibt den JSON-Code an messageBody.

sessionId - Sitzungs-ID
string.

Gibt die Sitzungs-ID an, mit der die Nachricht veröffentlicht wird. Bei sitzungsbasierten Warteschlangen tritt bei der Veröffentlichung ein Fehler auf, wenn kein Wert angegeben wird. Für nicht sitzungsbasierte Warteschlangen muss kein Wert angegeben werden.

signPayload - Signieren der Nachricht
boolean. Standardwert. false.

Wenn auf truefestgelegt ist, wird der Nachricht ein privates Zertifikat hinzugefügt.

certificateString - Zertifikatvariable
string. Erforderlich, wenn signPayload = true.

Gibt die Geheimnisvariable an, die den Zertifikatinhalt enthält. Dies kann auch ein Zertifikat sein, das in einem Azure-Schlüsseltresor gespeichert ist, der mit einer Variablengruppe verknüpft ist, die von der Releasepipeline verwendet wird.

signatureKey - Signatureigenschaftenschlüssel
string. Optional. Verwenden Sie , wenn signPayload = true. Standardwert. signature.

Gibt unter Nachrichteneigenschaften den Schlüssel an, an dem sich die Signatur befindet. Wenn leer gelassen wird, ist signatureder Standardwert .

waitForCompletion - Warten auf den Vorgangsabschluss
boolean. Standardwert. false.

Wenn auf truefestgelegt ist, wartet dieser Task auf das TaskCompleted-Ereignis für das angegebene Tasktimeout.

useDataContractSerializer - Verwenden Sie den .NET-Datenvertragsserialisierer.
boolean. Standardwert. true.

Legen Sie auf fest useDataContractSerializerfalse , wenn Sie Ihre Nachricht als Stream anstelle eines Objekts übergeben möchten.

Optionen für die Vorgangskontrolle

Alle Vorgänge verfügen zusätzlich zu ihren Eingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerungsoptionen und allgemeine Aufgabeneigenschaften.

Ausgabevariablen

Keine.

Hinweise

Verwenden Sie diese Aufgabe in einem agentlosen Auftrag einer Releasepipeline, um eine Nachricht über eine Dienstverbindung (ohne Verwendung eines Agents) an eine Azure Service Bus zu senden.

Hinweis

Kann nur in einem agentlosen Auftrag einer Releasepipeline verwendet werden.

Wo sollte eine Aufgabe die Vervollständigung signalisieren?

Um die Vervollständigung zu signalisieren, sollte der externe Dienst POST-Vervollständigungsdaten an den folgenden Pipelines-REST-Endpunkt senden.

{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" }

Einzelheiten finden Sie in dieser einfachen Cmdline-Anwendung.

Darüber hinaus ist eine C#-Hilfsbibliothek verfügbar, um die Liveprotokollierung zu aktivieren und die Aufgabe status für Aufgaben ohne Agent zu verwalten. Erfahren Sie mehr über Aufgaben ohne Async-HTTP-Agent.

Anforderungen

Anforderung	BESCHREIBUNG
Pipelinetypen	YAML, Klassischer Build, klassische Version
Wird ausgeführt auf	Server
Forderungen	Keine
Capabilities	Diese Aufgabe erfüllt keine Anforderungen an nachfolgende Aufgaben im Auftrag.
Befehlseinschränkungen	Any
Einstellbare Variablen	Any
Agent-Version	Alle unterstützten Agent-Versionen.
Aufgabenkategorie	Hilfsprogramm

Freigeben über