PublishToAzureServiceBus@1 – úloha Publikovat do Azure Service Bus v1

Článek
05/16/2024

Pomocí této úlohy odešlete zprávu Azure Service Bus pomocí připojení služby (nevyžaduje se žádný agent).

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.

Vstupy

azureSubscription - připojení služby Azure Service Bus
Vstupní alias: connectedServiceName. string. Povinná hodnota.

Určuje připojení služby Azure Service Bus.

messageBody - Text zprávy
string.

Určuje JSON messageBody.

sessionId - ID relace
string.

Určuje ID relace, se kterou se zpráva publikuje. U front založených na relacích se publikování nezdaří, pokud není zadána hodnota. Pro fronty, které nejsou založené na relacích, není nutné zadávat hodnotu.

signPayload - Podepsat zprávu
boolean. Výchozí hodnota: false.

Pokud je nastavená hodnota true, přidá se do zprávy privátní certifikát.

certificateString - Proměnná certifikátu
string. Vyžaduje se, když signPayload = true.

Určuje proměnnou tajného kódu, která obsahuje obsah certifikátu. Může to být také certifikát uložený v trezoru klíčů Azure, který je propojený se skupinou proměnných používanou kanálem verze.

signatureKey - Podpis – klíč vlastnosti
string. Nepovinný parametr. Použijte, když signPayload = true. Výchozí hodnota: signature.

V okně Vlastnosti zprávy určuje klíč, ve kterém je podpis. Pokud ponecháte prázdnou hodnotu, výchozí hodnota je signature.

waitForCompletion - Čekání na dokončení úkolu
boolean. Výchozí hodnota: false.

Pokud je nastavená hodnota true, bude tento úkol čekat na událost TaskCompleted pro zadaný časový limit úkolu.

useDataContractSerializer - Použijte serializátor kontraktu dat .NET.
boolean. Výchozí hodnota: true.

Nastavte useDataContractSerializer na hodnotu false , pokud chcete zprávu předat jako datový proud místo objektu.

Možnosti ovládání úloh

Všechny úlohy mají kromě vstupů také možnosti ovládání. Další informace najdete v tématu Možnosti ovládacího prvku a běžné vlastnosti úlohy.

Výstupní proměnné

Žádné

Poznámky

Tuto úlohu použijte v úloze bez agenta kanálu verze k odeslání zprávy Azure Service Bus pomocí připojení služby (bez použití agenta).

Poznámka

Dá se použít pouze v úloze bez agentů kanálu verze.

Kde by měl signalizovat dokončení úkolu?

Aby externí služba signalizovala dokončení, měla by data dokončení post do následujícího koncového bodu REST kanálů.

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

Podrobnosti najdete v této jednoduché aplikaci cmdline .

Kromě toho je k dispozici pomocná knihovna jazyka C#, která umožňuje protokolování za provozu a správu stavu úloh pro úlohy bez agentů. Přečtěte si další informace o úlohách protokolu HTTP bez agentů.

Požadavky

Požadavek	Popis
Typy kanálů	YAML, classic build, verze Classic
Spustí se	Server
Požadavky	Žádné
Možnosti	Tento úkol nesplňuje žádné požadavky na následné úkoly v úloze.
Omezení příkazů	Všechny
Nastavitelné proměnné	Všechny
Verze agenta	Všechny podporované verze agenta.
Kategorie úloh	Nástroj

Share via