PublishToAzureServiceBus@1 – Publicera till Azure Service Bus v1-uppgift

Artikel
2025-03-24

Använd den här uppgiften för att skicka ett meddelande till Azure Service Bus med hjälp av en tjänstanslutning (ingen agent krävs).

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.

Ingångar

azureSubscription - Azure Service Bus-tjänstanslutning
Indataalias: connectedServiceName. string. Obligatoriskt.

Anger en Azure Service Bus-tjänstanslutning.

messageBody - Meddelandetext
string.

Anger JSON-messageBody.

sessionId - sessions-ID
string.

Anger sessions-ID som meddelandet publiceras med. För sessionsbaserade köer misslyckas publiceringen om ett värde inte har angetts. För icke-sessionsbaserade köer behöver inget värde anges.

signPayload - Signera meddelandet
boolean. Standardvärde: false.

Om värdet är inställt på trueläggs ett privat certifikat till i meddelandet.

certificateString - certifikatvariabel
string. Krävs när signPayload = true.

Anger den hemliga variabel som innehåller certifikatinnehållet. Detta kan också vara ett certifikat som lagras i ett Azure-nyckelvalv som är länkad till en variabelgrupp som används av versionspipelinen.

signatureKey - signaturegenskapsnyckel
string. Valfritt. Använd när signPayload = true. Standardvärde: signature.

I Meddelandeegenskaper anger du nyckeln där signaturen finns. Om det lämnas tomt är standardvärdet signature.

waitForCompletion - Vänta tills uppgiften har slutförts
boolean. Standardvärde: false.

Om den här aktiviteten är inställd på trueväntar den på händelsen TaskCompleted för den angivna tidsgränsen för aktiviteten.

useDataContractSerializer - Använd .NET-datakontraktsserialiserare.
boolean. Standardvärde: true.

Ange useDataContractSerializer till false om du vill skicka meddelandet som en ström i stället för ett objekt.

Kontrollalternativ för aktivitet

Alla aktiviteter har kontrollalternativ utöver sina aktivitetsindata. Mer information finns i Kontrollalternativ och vanliga uppgiftsegenskaper.

Utdatavariabler

Ingen.

Anmärkningar

Använd den här uppgiften i ett agentlöst jobb av en versionspipeline för att skicka ett meddelande till en Azure Service Bus med hjälp av en tjänstanslutning (utan att använda en agent).

Anmärkning

Kan endast användas i ett agentlöst jobb för en versionspipeline.

Var ska en uppgift signalera slutförande?

För att signalera slutförande bör den externa tjänsten POST-slutförandedata till följande REST-slutpunkt för pipelines.

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

Mer information finns i det här enkla cmdline-programmet.

Dessutom finns ett C#-hjälpbibliotek tillgängligt för att aktivera liveloggning och hantera uppgiftsstatus för agentlösa uppgifter. Läs mer om Async HTTP-agentlösa uppgifter.

Krav

Krav	Beskrivning
Pipelinetyper	YAML, klassisk version, klassisk version
Körs på	Server
kräver	Ingen
funktioner	Den här aktiviteten uppfyller inte några krav på efterföljande uppgifter i jobbet.
Kommandobegränsningar	Vilken som helst
variabler som kan	Vilken som helst
Agentversion	Alla agentversioner som stöds.
Aktivitetskategori	Nytta

Dela via