TransactionalBatch.ExecuteAsync Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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
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
Se aplica a
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
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
Se aplica a
Azure SDK for .NET