PublishToAzureServiceBus@1 — zadanie Publikowanie do Azure Service Bus w wersji 1

Artykuł
06/11/2024

Użyj tego zadania, aby wysłać komunikat do Azure Service Bus przy użyciu połączenia z usługą (nie jest wymagany żaden agent).

Użyj tego zadania, aby wysłać komunikat do Azure Service Bus przy użyciu połączenia z usługą (bez wymaganego agenta).

Składnia

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

Dane wejściowe

azureSubscription - Azure Service Bus połączenie z usługą
Alias wejściowy: connectedServiceName. string. Wymagane.

Określa połączenie usługi Azure Service Bus.

messageBody - Treść wiadomości
string.

Określa kod JSON messageBody.

sessionId - Identyfikator sesji
string.

Określa identyfikator sesji, z którym jest publikowany komunikat. W przypadku kolejek opartych na sesji publikowanie kończy się niepowodzeniem, jeśli nie określono wartości. W przypadku kolejek niezwiązanych z sesją nie trzeba określać wartości.

signPayload - Podpisywanie wiadomości
boolean. Wartość domyślna: false.

Jeśli ustawiono wartość true, do komunikatu zostanie dodany certyfikat prywatny.

certificateString - Zmienna certyfikatu
string. Wymagane, gdy signPayload = true.

Określa zmienną wpisu tajnego, która zawiera zawartość certyfikatu. Może to być również certyfikat przechowywany w magazynie kluczy platformy Azure połączony z grupą zmiennych używaną przez potok wydania.

signatureKey - Klucz właściwości Signature
string. Opcjonalny. Użyj polecenia , gdy signPayload = true. Wartość domyślna: signature.

W obszarze Właściwości komunikatu określa klucz, w którym znajduje się podpis. Jeśli pozostawiono puste, wartość domyślna to signature.

waitForCompletion - Oczekiwanie na ukończenie zadania
boolean. Wartość domyślna: false.

Jeśli zostanie ustawiona wartość true, to zadanie będzie czekać na zdarzenie TaskCompleted dla określonego limitu czasu zadania.

useDataContractSerializer - Użyj serializatora kontraktu danych platformy .NET.
boolean. Wartość domyślna: true.

Ustaw useDataContractSerializer wartość na false , jeśli chcesz przekazać wiadomość jako strumień zamiast obiektu.

Opcje sterowania zadania

Wszystkie zadania mają opcje sterowania oprócz danych wejściowych zadań. Aby uzyskać więcej informacji, zobacz Opcje sterowania i typowe właściwości zadań.

Zmienne wyjściowe

Brak.

Uwagi

Użyj tego zadania w zadaniu bez agenta potoku wydania, aby wysłać komunikat do Azure Service Bus przy użyciu połączenia usługi (bez użycia agenta).

Uwaga

Może być używany tylko w zadaniu bez agenta potoku wydania.

Gdzie powinno zostać ukończone sygnał zadania?

Aby zasygnalizować ukończenie, usługa zewnętrzna powinna wykonać dane ukończenia post do następujących potoków punktu końcowego 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" }

Zobacz tę prostą aplikację cmdline , aby uzyskać szczegółowe informacje.

Ponadto dostępna jest biblioteka pomocnika języka C#, która umożliwia rejestrowanie na żywo i zarządzanie stanem zadania dla zadań bez agenta. Dowiedz się więcej o zadaniach bez agenta HTTP asynchronicznego.

Wymagania

Wymaganie	Opis
Typy potoków	YAML, kompilacja klasyczna, wersja klasyczna
Działa na	Serwer
Wymagania	Brak
Możliwości	To zadanie nie spełnia żadnych wymagań dotyczących kolejnych zadań w zadaniu.
Ograniczenia poleceń	Dowolne
Zmienne w formie tabeli settable	Dowolne
Wersja agenta	Wszystkie obsługiwane wersje agentów.
Kategoria zadania	Narzędzie

Udostępnij za pośrednictwem