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

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

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

Indata

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

Anger en Azure Service Bus tjänstanslutning.


messageBody - Meddelandetext
string.

Anger JSON messageBody.


sessionId - Sessions-ID
string.

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


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

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


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

Anger den hemliga variabeln som innehåller certifikatinnehållet. Detta kan också vara ett certifikat som lagras i ett Azure-nyckelvalv som är länkat 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 signaturestandardvärdet .


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

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


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

Ange useDataContractSerializer till false om du vill skicka meddelandet som en dataströ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

Inga.

Kommentarer

Använd den här uppgiften i ett agentlöst jobb i 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).

Anteckning

Kan bara användas i ett agentlöst jobb i en versionspipeline.

Var bör en uppgiftssignal slutföras?

För att signalera slutförande ska 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 aktiv loggning och hantering av aktivitetsstatus för agentlösa aktiviteter. Läs mer om Async HTTP-agentlösa uppgifter.

Krav

Krav Beskrivning
Pipelinetyper YAML, klassisk version, klassisk version
Körs på Server
Krav Ingen
Funktioner Den här aktiviteten uppfyller inte några krav för efterföljande uppgifter i jobbet.
Kommandobegränsningar Valfri
Inställningsbara variabler Valfri
Agentversion Alla agentversioner som stöds.
Uppgiftskategori Verktyg