PublishToAzureServiceBus@1 - Pubblicare in bus di servizio di Azure attività v1

Articolo
06/11/2024

Usare questa attività per inviare un messaggio a bus di servizio di Azure usando una connessione al servizio (non è necessario alcun agente).

Usare questa attività per inviare un messaggio a bus di servizio di Azure usando una connessione al servizio (nessun agente richiesto).

Sintassi

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

Input

azureSubscription - connessione al servizio bus di servizio di Azure
Alias di input: connectedServiceName. string. Obbligatorio.

Specifica una connessione al servizio bus di servizio di Azure.

messageBody - Corpo del messaggio
string.

Specifica l'oggetto JSON messageBody.

sessionId - ID sessione
string.

Specifica l'ID sessione con cui viene pubblicato il messaggio. Per le code basate su sessione, la pubblicazione ha esito negativo se non è specificato un valore. Per le code non basate su sessione, non è necessario specificare un valore.

signPayload - Firmare il messaggio
boolean. Valore predefinito: false.

Se impostato su true, verrà aggiunto un certificato privato al messaggio.

certificateString - Variabile certificato
string. Obbligatorio quando signPayload = true.

Specifica la variabile privata contenente il contenuto del certificato. Può anche essere un certificato archiviato in un insieme di credenziali delle chiavi di Azure collegato a un gruppo di variabili usato dalla pipeline di versione.

signatureKey - Chiave della proprietà Signature
string. facoltativo. Usare quando signPayload = true. Valore predefinito: signature.

In Proprietà messaggio specifica la chiave in cui è la firma. Se lasciato vuoto, il valore predefinito è signature.

waitForCompletion - Attendere il completamento dell'attività
boolean. Valore predefinito: false.

Se impostato su true, questa attività attenderà l'evento TaskCompleted per il timeout dell'attività specificato.

useDataContractSerializer - Usare il serializzatore di contratti dati .NET.
boolean. Valore predefinito: true.

Impostare useDataContractSerializer su false se si vuole passare il messaggio come flusso anziché un oggetto.

Opzioni di controllo delle attività

Tutte le attività dispongono di opzioni di controllo oltre ai relativi input attività. Per altre informazioni, vedere Opzioni di controllo e proprietà comuni delle attività.

Variabili di output

Nessuno.

Osservazioni

Usare questa attività in un processo senza agente di una pipeline di versione per inviare un messaggio a un bus di servizio di Azure usando una connessione al servizio (senza usare un agente).

Nota

Può essere usato solo in un processo senza agente di una pipeline di versione.

Dove deve essere completato un segnale di attività?

Per segnalare il completamento, il servizio esterno deve INVIARE i dati di completamento all'endpoint REST delle pipeline seguenti.

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

Per specifiche, vedere questa semplice applicazione cmdline .

Inoltre, è disponibile una libreria helper C# per abilitare la registrazione dinamica e gestire lo stato dell'attività per le attività senza agente. Altre informazioni sulle attività senza agente HTTP asincrone.

Requisiti

Requisito	Descrizione
Tipi di pipeline	YAML, build classica, versione classica
Esecuzione in	Server
Richieste	Nessuno
Capabilities	Questa attività non soddisfa le richieste per le attività successive nel processo.
Restrizioni dei comandi	Qualsiasi
Variabili impostabili	Qualsiasi
Versione agente	Tutte le versioni dell'agente supportate.
Categoria attività	Utilità

Condividi tramite