PublishToAzureServiceBus@1 - Publiceren naar Azure Service Bus v1-taak

Artikel
06/11/2024

Gebruik deze taak om een bericht te verzenden naar Azure Service Bus met behulp van een serviceverbinding (er is geen agent vereist).

Gebruik deze taak om een bericht te verzenden naar Azure Service Bus met behulp van een serviceverbinding (geen agent vereist).

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.

Invoerwaarden

azureSubscription - Azure Service Bus serviceverbinding
Invoeralias: connectedServiceName. string. Vereist.

Hiermee geeft u een Azure Service Bus serviceverbinding.

messageBody - Berichttekst
string.

Hiermee geeft u de JSON messageBodyop.

sessionId - Sessie-id
string.

Hiermee geeft u de sessie-id waarmee het bericht wordt gepubliceerd. Voor op sessies gebaseerde wachtrijen mislukt het publiceren als er geen waarde is opgegeven. Voor wachtrijen die niet op sessies zijn gebaseerd, hoeft er geen waarde te worden opgegeven.

signPayload - Het bericht ondertekenen
boolean. Standaardwaarde: false.

Als dit is ingesteld op true, wordt er een persoonlijk certificaat toegevoegd aan het bericht.

certificateString - Certificaatvariabele
string. Vereist wanneer signPayload = true.

Hiermee geeft u de geheime variabele die de certificaatinhoud bevat. Dit kan ook een certificaat zijn dat is opgeslagen in een Azure-sleutelkluis dat is gekoppeld aan een variabelegroep die wordt gebruikt door de release-pijplijn.

signatureKey - Sleutel van handtekeningeigenschap
string. Optioneel. Gebruik wanneer signPayload = true. Standaardwaarde: signature.

In Berichteigenschappen geeft u de sleutel op waar de handtekening zich bevindt. Als u dit leeg laat, is signaturede standaardwaarde .

waitForCompletion - Wachten totdat de taak is voltooid
boolean. Standaardwaarde: false.

Als dit is ingesteld op true, wacht deze taak op de gebeurtenis TaskCompleted voor de opgegeven time-out van de taak.

useDataContractSerializer - Gebruik de serialisatiefunctie voor .NET-gegevenscontracten.
boolean. Standaardwaarde: true.

Stel in useDataContractSerializer op false als u uw bericht wilt doorgeven als een stream in plaats van een object.

Opties voor taakbeheer

Alle taken hebben besturingsopties naast hun taakinvoer. Zie Opties voor besturingselementen en algemene taakeigenschappen voor meer informatie.

Uitvoervariabelen

Geen.

Opmerkingen

Gebruik deze taak in een taak zonder agent van een release-pijplijn om een bericht te verzenden naar een Azure Service Bus met behulp van een serviceverbinding (zonder een agent).

Notitie

Kan alleen worden gebruikt in een taak zonder agent van een release-pijplijn.

Waar moet een taak voltooiing aangeven?

Om voltooiing aan te geven, moet de externe service post-voltooiingsgegevens naar het volgende pijplijn REST-eindpunt.

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

Zie deze eenvoudige cmdline-toepassing voor meer informatie.

Daarnaast is er een C#-helperbibliotheek beschikbaar voor het inschakelen van livelogboekregistratie en het beheren van de taakstatus voor taken zonder agent. Meer informatie over Asynchrone HTTP-taken zonder agent.

Vereisten

Vereiste	Beschrijving
Pijplijntypen	YAML, klassieke build, klassieke release
Wordt uitgevoerd op	Server
Eisen	Geen
Functies	Deze taak voldoet niet aan eventuele vereisten voor volgende taken in de taak.
Opdrachtbeperkingen	Alle
Instelbare variabelen	Alle
Agentversie	Alle ondersteunde agentversies.
Taakcategorie	Hulpprogramma

Share via