TransactionalBatch.ExecuteAsync Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Sobrecargas
| ExecuteAsync(CancellationToken) |
Executa o lote transacional no serviço do Azure Cosmos como uma operação assíncrona. |
| ExecuteAsync(TransactionalBatchRequestOptions, CancellationToken) |
Executa o lote transacional no serviço do Azure Cosmos como uma operação assíncrona. |
ExecuteAsync(CancellationToken)
- Origem:
- TransactionalBatch.cs
Executa o lote transacional no serviço do Azure Cosmos como uma operação assíncrona.
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 cancelamento que representa o cancelamento da solicitação.
Retornos
Uma resposta aguardada que contém detalhes da execução do lote transacional.
Se o lote transacional for executado com êxito, o StatusCode na resposta retornada será definido OKcomo .
Se uma operação no lote transacional falhar durante a StatusCodeexecução, nenhuma alteração do lote será confirmada e o status da operação com falha será disponibilizado no . Para obter mais detalhes sobre a operação que falhou, a resposta pode ser enumerada – isso retorna TransactionalBatchOperationResult instâncias correspondentes a cada operação no lote transacional na ordem em que foram adicionadas ao lote transacional. Para um resultado correspondente a uma operação dentro do lote transacional, o StatusCode indica o status da operação – se a operação não foi executada ou foi anulada devido à falha de outra operação dentro do lote transacional, o valor desse campo será HTTP 424 (Dependência com Falha); para a operação que causou a anulação do lote, o valor desse campo indicará a causa da falha como um código de status HTTP.
O StatusCode na resposta retornada também pode ter valores como HTTP 5xx no caso de erros de servidor e HTTP 429 (Muitas solicitações).
Comentários
Essa API só gera exceções do lado do cliente. Isso é para aumentar o desempenho e evitar a sobrecarga de gerar exceções. Use IsSuccessStatusCode na resposta retornada para garantir que o lote transacional tenha sido bem-sucedido. Limites em solicitações TransactionalBatch
Aplica-se a
ExecuteAsync(TransactionalBatchRequestOptions, CancellationToken)
- Origem:
- TransactionalBatch.cs
Executa o lote transacional no serviço do Azure Cosmos como uma operação assíncrona.
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
Opções que se aplicam especificamente à solicitação em lote.
- cancellationToken
- CancellationToken
(Opcional) Token de cancelamento que representa o cancelamento da solicitação.
Retornos
Uma resposta aguardada que contém detalhes da execução do lote transacional.
Se o lote transacional for executado com êxito, o StatusCode na resposta retornada será definido OKcomo .
Se uma operação no lote transacional falhar durante a StatusCodeexecução, nenhuma alteração do lote será confirmada e o status da operação com falha será disponibilizado no . Para obter mais detalhes sobre a operação que falhou, a resposta pode ser enumerada – isso retorna TransactionalBatchOperationResult instâncias correspondentes a cada operação no lote transacional na ordem em que foram adicionadas ao lote transacional. Para um resultado correspondente a uma operação dentro do lote transacional, o StatusCode indica o status da operação – se a operação não foi executada ou foi anulada devido à falha de outra operação dentro do lote transacional, o valor desse campo será HTTP 424 (Dependência com Falha); para a operação que causou a anulação do lote, o valor desse campo indicará a causa da falha como um código de status HTTP.
O StatusCode na resposta retornada também pode ter valores como HTTP 5xx no caso de erros de servidor e HTTP 429 (Muitas solicitações).
Comentários
Essa API só gera exceções do lado do cliente. Isso é para aumentar o desempenho e evitar a sobrecarga de gerar exceções. Use IsSuccessStatusCode na resposta retornada para garantir que o lote transacional tenha sido bem-sucedido. Limites em solicitações TransactionalBatch
Aplica-se a
Azure SDK for .NET