Compartilhar via


Iniciar transição de nó

Inicia ou interrompe um nó de cluster.

Inicia ou interrompe um nó de cluster. Um nó de cluster é um processo, não a própria instância do sistema operacional. Para iniciar um nó, passe "Start" para o parâmetro NodeTransitionType. Para interromper um nó, passe "Stop" para o parâmetro NodeTransitionType. A API começa a operação; quando a API retornar, talvez o nó ainda não tenha terminado a transição. Chame GetNodeTransitionProgress com a mesma OperationId para obter o progresso da operação.

Solicitação

Método URI da solicitação
POST /Faults/Nodes/{nodeName}/$/StartTransition/?api-version=6.0&OperationId={OperationId}&NodeTransitionType={NodeTransitionType}&NodeInstanceId={NodeInstanceId}&StopDurationInSeconds={StopDurationInSeconds}&timeout={timeout}

Parâmetros

Nome Type Obrigatório Location
nodeName string Sim Caminho
api-version string Sim Consulta
OperationId string (uuid) Sim Consulta
NodeTransitionType cadeia de caracteres (enumeração) Sim Consulta
NodeInstanceId string Sim Consulta
StopDurationInSeconds inteiro (int32) Sim Consulta
timeout inteiro (int64) Não Consulta

nodeName

Tipo: string
Obrigatório: sim

O nome do nó.


api-version

Tipo: string
Obrigatório: sim
Padrão: 6.0

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

A versão da API REST do Service Fabric é baseada na versão de runtime na qual a API foi introduzida ou alterada. O runtime do Service Fabric dá suporte a mais de uma versão da API. Esta é a versão mais recente com suporte da API. Se uma versão inferior da API for passada, a resposta retornada poderá ser diferente daquela documentada nessa especificação.

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


OperationId

Tipo: cadeia de caracteres (uuid)
Obrigatório: sim

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


NodeTransitionType

Tipo: cadeia de caracteres (enumeração)
Obrigatório: sim

Indica o tipo de transição a ser executado. NodeTransitionType.Start iniciará um nó parado. NodeTransitionType.Stop interromperá um nó ativo. Os valores possíveis incluem: 'Invalid', 'Start', 'Stop'


NodeInstanceId

Tipo: string
Obrigatório: sim

A ID da instância do nó de destino. Isso pode ser determinado por meio da API GetNodeInfo.


StopDurationInSeconds

Tipo: inteiro (int32)
Obrigatório: sim
InclusiveMinimum: 0

A duração, em segundos, para manter o nó interrompido. O valor mínimo é 600, o máximo é 14400. Depois que esse tempo expirar, o nó automaticamente voltará a funcionar.


timeout

Tipo: inteiro (int64)
Obrigatório: não
Padrão: 60
InclusiveMaximum: 4294967295
InclusiveMinimum: 1

Tempo limite do servidor para executar a operação em segundos. Especifica o tempo que o cliente está disposto a esperar para que operação solicitada seja concluída. O valor padrão desse parâmetro é 60 segundos.

Respostas

Código de status HTTP Descrição Esquema de Resposta
202 (Aceito) Um código de status 202 indica que a operação foi aceita. Chame a API GetNodeTransitionProgress para obter o progresso.
Todos os outros códigos status A resposta de erro detalhada.
FabricError