TaskOperationsExtensions.AddCollectionAsync Methode

Referenz

Definition

Namespace:: Microsoft.Azure.Batch.Protocol

Assembly:: Microsoft.Azure.Batch.dll

Paket:: Microsoft.Azure.Batch v16.2.0

Quelle:: TaskOperationsExtensions.cs

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Fügt dem angegebenen Auftrag eine Auflistung von Tasks hinzu.

public static System.Threading.Tasks.Task<Microsoft.Azure.Batch.Protocol.Models.TaskAddCollectionResult> AddCollectionAsync (this Microsoft.Azure.Batch.Protocol.ITaskOperations operations, string jobId, System.Collections.Generic.IList<Microsoft.Azure.Batch.Protocol.Models.TaskAddParameter> value, Microsoft.Azure.Batch.Protocol.Models.TaskAddCollectionOptions taskAddCollectionOptions = default, System.Threading.CancellationToken cancellationToken = default);

static member AddCollectionAsync : Microsoft.Azure.Batch.Protocol.ITaskOperations * string * System.Collections.Generic.IList<Microsoft.Azure.Batch.Protocol.Models.TaskAddParameter> * Microsoft.Azure.Batch.Protocol.Models.TaskAddCollectionOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Batch.Protocol.Models.TaskAddCollectionResult>

<Extension()>
Public Function AddCollectionAsync (operations As ITaskOperations, jobId As String, value As IList(Of TaskAddParameter), Optional taskAddCollectionOptions As TaskAddCollectionOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of TaskAddCollectionResult)

Parameter

operations: ITaskOperations

Die Vorgangsgruppe für diese Erweiterungsmethode.

jobId: String

Die ID des Auftrags, dem die Task-Auflistung hinzugefügt werden soll.

value: IList<TaskAddParameter>

Die Auflistung der hinzuzufügenden Aufgaben. Die maximale Anzahl von Aufgaben beträgt 100. Die serialisierte Gesamtgröße dieser Sammlung muss kleiner als 1 MB sein. Wenn sie größer als 1 MB ist (z. B. wenn jeder Task über 100 Ressourcendateien oder Umgebungsvariablen verfügt), schlägt die Anforderung mit dem Code "RequestBodyTooLarge" fehl und sollte mit weniger Aufgaben erneut durchgeführt werden.

taskAddCollectionOptions: TaskAddCollectionOptions

Zusätzliche Parameter für den Vorgang

cancellationToken: CancellationToken

Das Abbruchtoken.

Gibt zurück

Task<TaskAddCollectionResult>

Hinweise

Beachten Sie, dass jede Aufgabe über eine eindeutige ID verfügen muss. Der Batch-Dienst gibt die Ergebnisse für jeden Vorgang möglicherweise nicht in derselben Reihenfolge zurück, in der die Aufgaben in dieser Anforderung übermittelt wurden. Wenn für den Server ein Timeout besteht oder die Verbindung während der Anforderung geschlossen wird, wurde die Anforderung möglicherweise teilweise oder vollständig oder gar nicht verarbeitet. In einem solchen Fall sollte der Benutzer die Anforderung erneut senden. Beachten Sie, dass es am Benutzer liegt, Fehler beim erneuten Ausstellen einer Anforderung ordnungsgemäß zu behandeln. Beispielsweise sollten Sie während eines Wiederholungsversuchs dieselben Aufgaben-IDs verwenden, damit bei erfolgreicher Ausführung des vorherigen Vorgangs nicht unerwartet zusätzliche Aufgaben erstellt werden. Wenn die Antwort Aufgaben enthält, die nicht hinzugefügt werden konnten, kann ein Client die Anforderung wiederholen. In einem Wiederholungsversuch ist es am effizientesten, nur Aufgaben erneut zu übermitteln, die nicht hinzugefügt werden konnten, und Aufgaben wegzulassen, die beim ersten Versuch erfolgreich hinzugefügt wurden. Die maximale Lebensdauer eines Vorgangs vom Hinzufügen bis zum Abschluss beträgt 180 Tage. Wenn ein Task nicht innerhalb von 180 Tagen nach dem Hinzufügen abgeschlossen wurde, wird er vom Batch-Dienst beendet und in dem Zustand belassen, in dem er sich zu diesem Zeitpunkt befand.

Gilt für:

Freigeben über