Iniciar transição de nó

Artigo
08/05/2023

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

Compartilhar via