TransactionalBatch.ExecuteAsync Método

Definición

Espacio de nombres:

Microsoft.Azure.Cosmos

Ensamblado:

Microsoft.Azure.Cosmos.Client.dll

Paquete:

Microsoft.Azure.Cosmos v3.39.0

Sobrecargas

ExecuteAsync(CancellationToken)	Ejecuta el lote transaccional en el servicio Azure Cosmos como una operación asincrónica.
ExecuteAsync(TransactionalBatchRequestOptions, CancellationToken)	Ejecuta el lote transaccional en el servicio Azure Cosmos como una operación asincrónica.

ExecuteAsync(CancellationToken)

Source:

TransactionalBatch.cs

Ejecuta el lote transaccional en el servicio Azure Cosmos como una operación asincrónica.

public abstract System.Threading.Tasks.Task<Microsoft.Azure.Cosmos.TransactionalBatchResponse> ExecuteAsync (System.Threading.CancellationToken cancellationToken = default);

abstract member ExecuteAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Cosmos.TransactionalBatchResponse>

Public MustOverride Function ExecuteAsync (Optional cancellationToken As CancellationToken = Nothing) As Task(Of TransactionalBatchResponse)

Parámetros

cancellationToken

CancellationToken

(Opcional) Token de cancelación que representa la cancelación de la solicitud.

Devoluciones

Task<TransactionalBatchResponse>

Respuesta esperada que contiene detalles de ejecución del lote transaccional.

Si el lote transaccional se ejecuta correctamente, en StatusCode la respuesta devuelta se establecerá OKen .

Si se produce un error en una operación dentro del lote transaccional durante la ejecución, no se confirmará ningún cambio del lote y el estado de la operación con errores estará disponible en StatusCode. Para obtener más detalles sobre la operación que produjo un error, la respuesta se puede enumerar: devuelve TransactionalBatchOperationResult instancias correspondientes a cada operación del lote transaccional en el orden en que se agregaron al lote transaccional. Para obtener un resultado correspondiente a una operación dentro del lote transaccional, StatusCode indica el estado de la operación: si la operación no se ejecutó o se anuló debido al error de otra operación dentro del lote transaccional, el valor de este campo será HTTP 424 (dependencia con error); para la operación que provocó la anulación del lote, el valor de este campo indicará la causa del error como código de estado HTTP.

En StatusCode la respuesta devuelta también puede tener valores como HTTP 5xx en caso de errores del servidor y HTTP 429 (demasiadas solicitudes).

Comentarios

Esta API solo se inicia en excepciones del lado cliente. Esto es para aumentar el rendimiento y evitar la sobrecarga de iniciar excepciones. Use IsSuccessStatusCode en la respuesta devuelta para asegurarse de que el lote transaccional se realizó correctamente. Límites de solicitudes TransactionalBatch

ExecuteAsync(TransactionalBatchRequestOptions, CancellationToken)

Source:

TransactionalBatch.cs

Ejecuta el lote transaccional en el servicio Azure Cosmos como una operación asincrónica.

public abstract System.Threading.Tasks.Task<Microsoft.Azure.Cosmos.TransactionalBatchResponse> ExecuteAsync (Microsoft.Azure.Cosmos.TransactionalBatchRequestOptions requestOptions, System.Threading.CancellationToken cancellationToken = default);

abstract member ExecuteAsync : Microsoft.Azure.Cosmos.TransactionalBatchRequestOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Cosmos.TransactionalBatchResponse>

Public MustOverride Function ExecuteAsync (requestOptions As TransactionalBatchRequestOptions, Optional cancellationToken As CancellationToken = Nothing) As Task(Of TransactionalBatchResponse)

Parámetros

requestOptions

TransactionalBatchRequestOptions

Opciones que se aplican específicamente a la solicitud por lotes.

cancellationToken

CancellationToken

(Opcional) Token de cancelación que representa la cancelación de la solicitud.

Devoluciones

Task<TransactionalBatchResponse>

Respuesta esperada que contiene detalles de ejecución del lote transaccional.

Si el lote transaccional se ejecuta correctamente, en StatusCode la respuesta devuelta se establecerá OKen .

Si se produce un error en una operación dentro del lote transaccional durante la ejecución, no se confirmará ningún cambio del lote y el estado de la operación con errores estará disponible en StatusCode. Para obtener más detalles sobre la operación que produjo un error, la respuesta se puede enumerar: devuelve TransactionalBatchOperationResult instancias correspondientes a cada operación del lote transaccional en el orden en que se agregaron al lote transaccional. Para obtener un resultado correspondiente a una operación dentro del lote transaccional, StatusCode indica el estado de la operación: si la operación no se ejecutó o se anuló debido al error de otra operación dentro del lote transaccional, el valor de este campo será HTTP 424 (dependencia con error); para la operación que provocó la anulación del lote, el valor de este campo indicará la causa del error como código de estado HTTP.

En StatusCode la respuesta devuelta también puede tener valores como HTTP 5xx en caso de errores del servidor y HTTP 429 (demasiadas solicitudes).

Comentarios

Esta API solo se inicia en excepciones del lado cliente. Esto es para aumentar el rendimiento y evitar la sobrecarga de iniciar excepciones. Use IsSuccessStatusCode en la respuesta devuelta para asegurarse de que el lote transaccional se realizó correctamente. Límites de solicitudes TransactionalBatch