Cancelar operação

Cancela uma operação com falha induzida pelo usuário.

As seguintes APIs iniciar operações com falha que podem ser canceladas usando CancelOperation: StartDataLoss, StartQuorumLoss, StartPartitionRestart, StartNodeTransition.

Se forçar for false, em seguida, a operação especificada induzido pelo usuário será normalmente interrompida e limpos. Se forçar for true, o comando será anulado e algum estado interno pode ser deixado para trás. Especificar force como verdadeiro deve ser usada com cuidado. Não é permitido chamar essa API com force definido como verdadeiro, até que essa API já foi chamada no mesmo comando de teste com force definido como false, ou a menos que o comando de teste já tem um OperationState de OperationState.RollingBack. Esclarecimento: OperationState.RollingBack significa que o sistema estará/está limpando o estado interno do sistema causado pela execução do comando. Ele não irá restaurar os dados se o comando de teste foi causar perda de dados. Por exemplo, se você chamar StartDataLoss chamar esta API, o sistema só limpará o estado interno da execução do comando. Ele não irá restaurar os dados da partição de destino, se o comando progrediu distante o suficiente para causar perda de dados.

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

Solicitação

Método URI da solicitação
POST /Faults/$/Cancel?api-version=6.0&OperationId={OperationId}&Force={Force}&timeout={timeout}

parâmetros

Nome Type Obrigatório Location
api-version string Sim Consulta
OperationId string (uuid) Sim Consulta
Force booleano Sim Consulta
timeout inteiro (int64) Não Consulta

api-version

Tipo: string
Necessário: Sim
Padrão:6.0

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

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

Além disso, o tempo de execução aceita qualquer versão que seja maior do que a versão suportada mais recente até a versão atual do tempo de execução. Portanto, se a versão mais recente da API for 6.0, mas se o tempo de execução for 6.1, para facilitar a gravação dos clientes, o tempo de execução aceitará a versão 6.1 para essa API. No entanto, o comportamento da API será de acordo com a versão 6.0 documentada.


OperationId

Tipo: string (uuid)
Necessário: Sim

Um GUID que identifica uma chamada dessa API. Isso é passado para a API GetProgress correspondente


Force

Tipo: booleano
Necessário: Sim
Padrão:false

Indica se deve normalmente revertê-lo e limpar o estado do sistema interno modificado executando a operação induzido pelo usuário.


timeout

Tipo: inteiro (inteiro64)
Necessário: Não
Padrão:60
InclusiveMáximo:4294967295
Mínimo inclusivo:1

O tempo de intervalo do servidor para realizar a operação em segundos. Este tempo estipula a duração de tempo que o cliente está disposto a esperar para que a operação solicitada seja concluída. O valor padrão deste parâmetro é de 60 segundos.

Respostas

Código de status HTTP Descrição Esquema de Resposta
200 (OK) Uma operação bem sucedida retornará 200 códigos de status.
Todos os outros códigos de status A resposta detalhada de erro.
Erro de malha