Compartir vía


PublishToAzureServiceBus@1: tarea Publicar en Azure Service Bus v1

Use esta tarea para enviar un mensaje a Azure Service Bus mediante una conexión de servicio (no se requiere ningún agente).

Use esta tarea para enviar un mensaje a Azure Service Bus mediante una conexión de servicio (no se requiere ningún agente).

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.

Entradas

azureSubscription - conexión de servicio de Azure Service Bus
Alias de entrada: connectedServiceName. string. Obligatorio.

Especifica una conexión de servicio Azure Service Bus.


messageBody - Cuerpo del mensaje
string.

Especifica el json messageBody.


sessionId - Identificador de sesión
string.

Especifica el identificador de sesión con el que se publica el mensaje. En el caso de las colas basadas en sesiones, se produce un error en la publicación si no se especifica un valor. Para las colas no basadas en sesiones, no es necesario especificar un valor.


signPayload - Firmar el mensaje
boolean. Valor predeterminado: false.

Si se establece en true, se agregará un certificado privado al mensaje.


certificateString - Variable de certificado
string. Necesario cuando signPayload = true.

Especifica la variable secreta que contiene el contenido del certificado. También puede ser un certificado almacenado en un almacén de claves de Azure que esté vinculado a un grupo de variables usado por la canalización de versión.


signatureKey - Clave de propiedad Signature
string. Opcional. Use cuando signPayload = true. Valor predeterminado: signature.

En Propiedades del mensaje, especifica la clave donde está la firma. Si se deja vacío, el valor predeterminado es signature.


waitForCompletion - Esperar a que finalice la tarea
boolean. Valor predeterminado: false.

Si se establece en true, esta tarea esperará al evento TaskCompleted para el tiempo de espera de la tarea especificada.


useDataContractSerializer - Use el serializador de contrato de datos de .NET.
boolean. Valor predeterminado: true.

false Establézcalo useDataContractSerializer en si desea pasar el mensaje como una secuencia en lugar de un objeto .


Opciones de control de tareas

Todas las tareas tienen opciones de control además de las entradas de tareas. Para obtener más información, vea Opciones de control y propiedades de tareas comunes.

Variables de salida

Ninguno.

Comentarios

Use esta tarea en un trabajo sin agente de una canalización de versión para enviar un mensaje a un Azure Service Bus mediante una conexión de servicio (sin usar un agente).

Nota

Solo se puede usar en un trabajo sin agente de una canalización de versión.

¿Dónde debe completarse una señal de tarea?

Para indicar la finalización, el servicio externo debe publicar los datos de finalización en el siguiente punto de conexión REST de las canalizaciones.

{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 esta sencilla aplicación cmdline para obtener información específica.

Además, hay disponible una biblioteca auxiliar de C# para habilitar el registro en vivo y administrar el estado de la tarea para las tareas sin agente. Obtenga más información sobre las tareas sin agente HTTP asincrónicas.

Requisitos

Requisito Descripción
Tipos de canalización YAML, compilación clásica, versión clásica
Se ejecuta en Server
Peticiones None
Capabilities Esta tarea no satisface ninguna demanda de tareas posteriores en el trabajo.
Restricciones de comandos Any
Variables que se pueden establecer Any
Versión del agente Todas las versiones de agente compatibles.
Categoría de la tarea: Utilidad