Cancelar Operação

Cancela uma operação de avaria induzida pelo utilizador.

As seguintes operações de falha de início de APIs que podem ser canceladas através da Operação De cancelamento: StartDataLoss, StartQuorumLoss, StartPartitionRestart, StartNodeTransition.

Se a força for falsa, então a operação especificada induzida pelo utilizador será graciosamente interrompida e limpa. Se a força for verdadeira, o comando será abortado, e algum estado interno pode ser deixado para trás. Especificar a força como verdadeira deve ser utilizada com cuidado. Chamar a esta API com força definida para verdade não é permitido até que esta API já tenha sido chamada no mesmo comando de teste com força definida para falso primeiro, ou a menos que o comando de teste já tenha uma Operação State of OperationState.RollingBack. Esclarecimento: OperationState.RollingBack significa que o sistema será/está a limpar o estado do sistema interno causado pela execução do comando. Não restaurará os dados se o comando de teste causar a perda de dados. Por exemplo, se ligar para o StartDataLoss e depois chamar a esta API, o sistema apenas limpará o estado interno de executar o comando. Não restaurará os dados da partilha do alvo, se o comando progrediu o suficiente para causar a perda de dados.

Nota importante: se esta API for invocada com força==verdade, o estado interno pode ser deixado para trás.

Pedir

Método URI do pedido
POST /Faults/$/Cancel?api-version=6.0&OperationId={OperationId}&Force={Force}&timeout={timeout}

Parâmetros

Nome Tipo Necessário Localização
api-version string Sim Consulta
OperationId corda (uuide) Sim Consulta
Force boolean Sim Consulta
timeout inteiro (int64) Não Consulta

api-version

Tipo: corda
Obrigatório: Sim
Padrão:6.0

A versão da API. Este parâmetro é necessário e o seu valor deve ser '6.0'.

A versão API do Service Fabric REST baseia-se na versão tempo de execução em que a API foi introduzida ou foi alterada. O tempo de execução do Tecido de Serviço suporta mais de uma versão da API. Esta é a mais recente versão suportada da API. Se for aprovada uma versão API inferior, a resposta devolvida pode ser diferente da documentada nesta especificação.

Além disso, o tempo de execução aceita qualquer versão superior à versão suportada mais recente até à versão atual do tempo de execução. Portanto, se a versão Mais recente da API for de 6.0, mas se o tempo de execução for de 6.1, de forma a facilitar a escrita dos clientes, o tempo de execução aceitará a versão 6.1 para essa API. No entanto, o comportamento da API será conforme a versão 6.0 documentada.


OperationId

Tipo: corda (uuide)
Obrigatório: Sim

Um GUID que identifica uma chamada desta API. Isto é passado para a API GetProgress correspondente


Force

Tipo: boolean
Obrigatório: Sim
Padrão:false

Indica se deve reverter graciosamente e limpar o estado interno do sistema modificado executando a operação induzida pelo utilizador.


timeout

Tipo: inteiro (int64)
Obrigatório: Não
Padrão:60
InclusiveMaximum:4294967295
Inclusive Mínimo:1

O tempo de funcionamento do servidor para a execução da operação em segundos. Este prazo especifica a duração do tempo que o cliente está disposto a esperar que a operação solicitada esteja concluída. O valor padrão para este parâmetro é de 60 segundos.

Respostas

Código de Estado HTTP Descrição Esquema de Resposta
200 (OK) Uma operação bem sucedida devolverá 200 códigos de estado.
Todos os outros códigos de estado A resposta detalhada ao erro.
Erro de Tecido