PublishToAzureServiceBus@1 - 发布到 Azure 服务总线 v1 任务
使用此任务可以使用服务连接向Azure 服务总线发送消息, (不需要代理) 。
使用此任务使用服务连接向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.
# 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.
输入
messageBody
- 邮件正文
string
.
指定 JSON messageBody
。
sessionId
- 会话 ID
string
.
指定用于发布消息的会话 ID。 对于基于会话的队列,如果未指定值,发布将失败。 对于非基于会话的队列,无需指定值。
signPayload
- 对消息进行签名
boolean
. 默认值:false
。
如果设置为 true
,则会将私有证书添加到消息中。
certificateString
- 证书变量
string
. 当 signPayload = true
时,需要此选项。
指定包含证书内容的机密变量。 这也可以是存储在 Azure 密钥保管库中的证书,该证书 链接到 发布管道使用的变量组。
signatureKey
- 签名属性密钥
string
. 可选。 在 时 signPayload = true
使用 。 默认值:signature
。
在“消息属性”中,指定签名所在的键。 如果留空,则默认值为 signature
。
waitForCompletion
- 等待任务完成
boolean
. 默认值:false
。
如果设置为 true
,则此任务将等待指定任务超时的 TaskCompleted 事件。
useDataContractSerializer
- 使用 .NET 数据协定序列化程序。
boolean
. 默认值:true
。
false
如果要将消息作为流而不是对象传递,请将 设置为 useDataContractSerializer
。
任务控制选项
除了任务输入,所有任务都有控制选项。 有关详细信息,请参阅 控制选项和常见任务属性。
输出变量
无。
备注
在发布管道的无代理作业中使用此任务,使用服务连接 (向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# 帮助程序库可用于启用实时日志记录和管理无代理任务的任务状态。 详细了解 异步 HTTP 无代理任务。