ITaskOperations.AddCollectionWithHttpMessagesAsync Methode

Referenz

Definition

Namespace:: Microsoft.Azure.Batch.Protocol

Assembly:: Microsoft.Azure.Batch.dll

Paket:: Microsoft.Azure.Batch v16.2.0

Quelle:: ITaskOperations.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 System.Threading.Tasks.Task<Microsoft.Rest.Azure.AzureOperationResponse<Microsoft.Azure.Batch.Protocol.Models.TaskAddCollectionResult,Microsoft.Azure.Batch.Protocol.Models.TaskAddCollectionHeaders>> AddCollectionWithHttpMessagesAsync (string jobId, System.Collections.Generic.IList<Microsoft.Azure.Batch.Protocol.Models.TaskAddParameter> value, Microsoft.Azure.Batch.Protocol.Models.TaskAddCollectionOptions taskAddCollectionOptions = default, System.Collections.Generic.Dictionary<string,System.Collections.Generic.List<string>> customHeaders = default, System.Threading.CancellationToken cancellationToken = default);

abstract member AddCollectionWithHttpMessagesAsync : string * System.Collections.Generic.IList<Microsoft.Azure.Batch.Protocol.Models.TaskAddParameter> * Microsoft.Azure.Batch.Protocol.Models.TaskAddCollectionOptions * System.Collections.Generic.Dictionary<string, System.Collections.Generic.List<string>> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Rest.Azure.AzureOperationResponse<Microsoft.Azure.Batch.Protocol.Models.TaskAddCollectionResult, Microsoft.Azure.Batch.Protocol.Models.TaskAddCollectionHeaders>>

Public Function AddCollectionWithHttpMessagesAsync (jobId As String, value As IList(Of TaskAddParameter), Optional taskAddCollectionOptions As TaskAddCollectionOptions = Nothing, Optional customHeaders As Dictionary(Of String, List(Of String)) = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of AzureOperationResponse(Of TaskAddCollectionResult, TaskAddCollectionHeaders))

Parameter

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 jede Aufgabe über 100 Ressourcendateien oder Umgebungsvariablen verfügt), schlägt die Anforderung mit dem Code "RequestBodyTooLarge" fehl und sollte mit weniger Tasks wiederholt werden.

taskAddCollectionOptions: TaskAddCollectionOptions

Zusätzliche Parameter für den Vorgang

customHeaders: Dictionary<String,List<String>>

Die Header, die der Anforderung hinzugefügt werden.

cancellationToken: CancellationToken

Das Abbruchtoken.

Gibt zurück

Task<AzureOperationResponse<TaskAddCollectionResult,TaskAddCollectionHeaders>>

Ausnahmen

BatchErrorException

Wird ausgelöst, wenn der Vorgang einen ungültigen status Code zurückgegeben hat.

SerializationException

Wird ausgelöst, wenn die Antwort nicht deserialisiert werden kann

ValidationException

Wird ausgelöst, wenn ein erforderlicher Parameter NULL ist

Hinweise

Beachten Sie, dass jede Aufgabe über eine eindeutige ID verfügen muss. Der Batch-Dienst gibt möglicherweise nicht die Ergebnisse für jeden Vorgang in derselben Reihenfolge zurück, in der die Aufgaben in dieser Anforderung übermittelt wurden. Wenn für den Server ein Timeout auftritt 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 der Benutzer Fehler beim erneuten Ausstellen einer Anforderung ordnungsgemäß behandeln kann. Beispielsweise sollten Sie während eines Wiederholungsversuchs die gleichen Aufgaben-IDs verwenden, damit bei erfolgreicher Ausführung des vorherigen Vorgangs bei der Wiederholung nicht unerwartet zusätzliche Aufgaben erstellt werden. Wenn die Antwort Tasks enthält, die nicht hinzugefügt werden konnten, kann ein Client die Anforderung wiederholen. Bei einer Wiederholung ist es am effizientesten, nur Aufgaben erneut zu übermitteln, die nicht hinzugefügt werden konnten, und Aufgaben auszulassen, 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 einem beliebigen Zustand belassen, in dem er sich zu diesem Zeitpunkt befand.

Gilt für:

Freigeben über