Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Эта задача предназначена для отправки сообщения в служебную шину 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 | Любое |
| Версия агента | Все поддерживаемые версии агента. |
| Категория задач | Полезность |