PublishToAzureServiceBus@1. Публикация в служебной шине Azure версии 1

Статья
03/24/2025

Эта задача предназначена для отправки сообщения в служебную шину Azure с помощью подключения к службе (агент не требуется).

Синтаксис

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

Входные данные

azureSubscription - подключение служебной шины Azure
Псевдоним ввода: connectedServiceName. string. Обязательное.

Указывает подключение служебной шины Azure.

текст сообщения messageBody -
string.

Указывает messageBodyJSON.

sessionId - идентификатор сеанса
string.

Указывает идентификатор сеанса, с которым публикуется сообщение. Для очередей на основе сеансов публикация завершается ошибкой, если значение не указано. Для очередей, не основанных на сеансах, не требуется указывать значение.

signPayload - подписать сообщение
boolean. Значение по умолчанию: false.

Если задано значение true, в сообщение будет добавлен закрытый сертификат.

Переменная сертификата certificateString -
string. Требуется, если signPayload = true.

Указывает секретную переменную, содержащую содержимое сертификата. Это также может быть сертификат, хранящийся в хранилище ключей Azure, который связан с группой переменных, используемой конвейером выпуска.

ключа свойства подписи signatureKey -
string. Необязательно. Используется при signPayload = true. Значение по умолчанию: signature.

В свойствах сообщения указывает ключ, в котором находится подпись. Если осталось пустым, значение по умолчанию signature.

waitForCompletion - ожидание завершения задачи
boolean. Значение по умолчанию: false.

Если задано значение true, эта задача ожидает события TaskCompleted для указанного времени ожидания задачи.

useDataContractSerializer - Использовать сериализатор контракта данных .NET.
boolean. Значение по умолчанию: true.

Задайте для useDataContractSerializer значение false, если вы хотите передать сообщение в виде потока вместо объекта.

Параметры управления задачами

Помимо входных данных, все задачи имеют параметры управления. Дополнительные сведения см. в разделе Параметры управления и общие свойства задач.

Выходные переменные

Нет.

Замечания

Используйте эту задачу в задании без агента конвейера выпуска для отправки сообщения в служебную шину Azure с помощью подключения службы (без использования агента).

Примечание.

Можно использовать только в задании без агента конвейера выпуска.

Где должно быть завершение задачи?

Чтобы сигнализировать о завершении, внешняя служба должна отправлять данные о завершении POST в следующую конечную точку REST конвейеров.

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

Дополнительные сведения см. в этом простом приложения cmdline.

Кроме того, вспомогающая библиотека C# доступна для включения динамического ведения журнала и управления состоянием задачи без агента. Дополнительные сведения о задачах без агента Async HTTP.

Требования

Требование	Описание
Типы конвейеров	YAML, классическая сборка, классический выпуск
Выполняется в	Сервер
требования	Нет
возможностей	Эта задача не удовлетворяет требованиям к последующим задачам в задании.
ограничения команд	Любое
переменные settable	Любое
Версия агента	Все поддерживаемые версии агента.
Категория задач	Полезность

Поделиться через