PublishToAzureServiceBus@1 - 發佈至 Azure 服務匯流排 v1 工作

發行項
05/16/2024

使用此工作將訊息傳送至使用服務連線 Azure 服務匯流排， (不需要任何代理程式) 。

使用此工作，使用服務連線將訊息傳送至 Azure 服務匯流排， (不需要代理程式) 。

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.

輸入

azureSubscription - Azure 服務匯流排服務連線
輸入別名： connectedServiceName。 string. 必要。

指定 Azure 服務匯流排服務連線。

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。

false如果您要將訊息當作資料流傳遞，而不是物件，請將設定useDataContractSerializer為。

工作控制選項

除了工作輸入之外，所有工作都有控制選項。如需詳細資訊，請參閱控制選項和一般工作屬性。

輸出變數

無。

備註

在發行管線的無代理程序作業中使用這項工作，使用服務連線 (將訊息傳送至 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、傳統組建、傳統版本
在上執行	伺服器
要求	無
Capabilities	此工作不符合作業中後續工作的任何需求。
命令限制	任何
可設定變數	任何
代理程式版本	所有支援的代理程式版本。
工作類別	公用程式

共用方式為