PublishToAzureServiceBus@1 – Publicar na tarefa do Barramento de Serviço do Azure v1

Artigo
03/24/2025

Use essa tarefa para enviar uma mensagem ao Barramento de Serviço do Azure usando uma conexão de serviço (nenhum agente é necessário).

Sintaxe

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

Entradas

azureSubscription - de conexão de serviço do Barramento de Serviço do Azure
Alias de entrada: connectedServiceName. string. Obrigatório

Especifica um de conexão de serviço do Barramento de Serviço do Azure.

corpo da mensagem messageBody -
string.

Especifica o messageBodyJSON.

sessionId - de ID da Sessão
string.

Especifica a ID da sessão com a qual a mensagem é publicada. Para filas baseadas em sessão, a publicação falhará se um valor não for especificado. Para filas não baseadas em sessão, um valor não precisa ser especificado.

signPayload - assinar a mensagem
boolean. Valor padrão: false.

Se definido como true, um certificado privado será adicionado à mensagem.

de variável de certificado certificateString -
string. Necessário quando signPayload = true.

Especifica a variável secreta que contém o conteúdo do certificado. Isso também pode ser um certificado armazenado em um cofre de chaves do Azure vinculado a um grupo de variáveis usado pelo pipeline de lançamento.

de chave de propriedade de assinatura signatureKey -
string. Opcional. Use quando signPayload = true. Valor padrão: signature.

Em Propriedades da Mensagem, especifica a chave em que a assinatura está. Se deixado vazio, o valor padrão será signature.

waitForCompletion - aguardar a conclusão da tarefa
boolean. Valor padrão: false.

Se definido como true, essa tarefa aguardará o evento TaskCompleted para o tempo limite da tarefa especificado.

useDataContractSerializer - usar o serializador de contrato de dados .NET.
boolean. Valor padrão: true.

Defina useDataContractSerializer para false se você quiser passar sua mensagem como um fluxo em vez de um objeto.

Opções de controle de tarefa

Todas as tarefas têm opções de controle além das suas entradas de tarefas. Para obter mais informações, consulte as opções de Controle de e as propriedades comuns da tarefa.

Variáveis de saída

Nenhum.

Observações

Use essa tarefa em um trabalho sem agente de um pipeline de lançamento para enviar uma mensagem para um Barramento de Serviço do Azure usando uma conexão de serviço (sem usar um agente).

Observação

Só pode ser usado em um trabalho sem agente de um pipeline de lançamento.

Onde um sinal de tarefa deve ser concluído?

Para sinalizar a conclusão, o serviço externo deve postar dados de conclusão para o ponto de extremidade REST de pipelines a seguir.

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

Consulte este aplicativo cmdline simples para obter detalhes.

Além disso, uma biblioteca auxiliar do C# está disponível para habilitar o registro em log dinâmico e o gerenciamento do status da tarefa para tarefas sem agente. Saiba mais sobre tarefas sem agente HTTP assíncronas.

Requisitos

Requisito	Descrição
Tipos de pipeline	YAML, build clássico, versão clássica
Execuções em	Servidor
de demandas	Nenhum
recursos	Essa tarefa não atende a nenhuma demanda para tarefas subsequentes no trabalho.
restrições de comando	Qualquer
variáveis settable	Qualquer
Versão do agente	Todas as versões de agente com suporte.
Categoria de tarefa	Utilidade

Compartilhar via