PublishToAzureServiceBus@1 - 發佈至 Azure 服務總線 v1 工作
使用此工作,使用服務連線將訊息傳送至 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.
輸入
messageBody
-
訊息本文
string
。
指定 JSON messageBody
。
sessionId
-
工作話標識碼
string
。
指定發佈訊息的會話標識碼。 針對會話型佇列,如果未指定值,發佈就會失敗。 針對非會話型佇列,不需要指定值。
signPayload
-
簽署訊息
boolean
。 預設值:false
。
如果設定為 true
,則會將私人憑證新增至訊息。
certificateString
-
憑證變數
string
。
signPayload = true
時為必要項。
指定包含憑證內容的秘密變數。 這也可以是儲存在 Azure 金鑰保存庫中的憑證,連結 發行管線所使用的變數群組。
signatureKey
-
Signature 屬性金鑰
string
。 選擇性。
signPayload = true
時使用 。 預設值:signature
。
在 [訊息屬性] 中,指定簽章所在的索引鍵。 如果保留空白,則預設值為 signature
。
waitForCompletion
-
等候工作完成
boolean
。 預設值:false
。
如果設定為 true
,此工作會等候 TaskCompleted 事件,以取得指定的工作逾時。
useDataContractSerializer
-
使用 .NET 數據合約串行化程式。
boolean
。 預設值:true
。
如果您想要將訊息當做數據流而非對象傳遞,請將 useDataContractSerializer
設定為 false
。
工作控制選項
除了工作輸入之外,所有工作都有控制選項。 如需詳細資訊,請參閱 控制項選項和一般工作屬性。
輸出變數
沒有。
備註
在發行管線 無代理程式作業中使用此工作,使用服務連線將訊息傳送至 Azure 服務總線(不使用代理程式)。
工作應該在何處發出訊號完成?
若要發出完成訊號,外部服務應該會將完成數據張貼到下列管線 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 無代理程式工作。
需求
要求 | 說明 |
---|---|
管線類型 | YAML、傳統組建、傳統版本 |
執行於 | 伺服器 |
需求 | 沒有 |
功能 | 此工作不符合作業中後續工作的任何需求。 |
命令限制 | 任意 |
Settable 變數 | 任意 |
代理程式版本 | 所有支援的代理程式版本。 |
工作類別 | 效用 |