Partilhar via


Iniciar Transição de Nós

Inicia ou para um nó de cluster.

Inicia ou para um nó de cluster. Um nó de cluster é um processo, não a própria instância do SO. Para iniciar um nó, transmita "Iniciar" para o parâmetro NodeTransitionType. Para parar um nó, transmita "Parar" para o parâmetro NodeTransitionType. Esta API inicia a operação - quando a API devolve o nó pode ainda não ter terminado a transição. Chame GetNodeTransitionProgress com o mesmo OperationId para obter o progresso da operação.

Pedir

Método URI do pedido
POST /Faults/Nodes/{nodeName}/$/StartTransition/?api-version=6.0&OperationId={OperationId}&NodeTransitionType={NodeTransitionType}&NodeInstanceId={NodeInstanceId}&StopDurationInSeconds={StopDurationInSeconds}&timeout={timeout}

Parâmetros

Nome Tipo Necessário Localização
nodeName string Yes Caminho
api-version string Yes Consulta
OperationId cadeia (uuid) Sim Consulta
NodeTransitionType cadeia (enumeração) Sim Consulta
NodeInstanceId string Yes Consulta
StopDurationInSeconds número inteiro (int32) Sim Consulta
timeout número inteiro (int64) No Consulta

nodeName

Tipo: cadeia
Obrigatório: Sim

O nome do nó.


api-version

Tipo: cadeia
Obrigatório: Sim
Predefinição: 6.0

A versão da API. Este parâmetro é obrigatório e o respetivo valor tem de ser "6.0".

A versão da API REST do Service Fabric baseia-se na versão de runtime na qual a API foi introduzida ou alterada. O runtime do Service Fabric suporta mais do que uma versão da API. Esta é a versão suportada mais recente da API. Se for transmitida uma versão inferior da API, a resposta devolvida poderá ser diferente da documentada nesta especificação.

Além disso, o runtime aceita qualquer versão superior à versão suportada mais recente até à versão atual do runtime. Por isso, se a versão mais recente da API for a 6.0, mas se o runtime for 6.1, para facilitar a escrita 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 6.0 documentada.


OperationId

Tipo: cadeia (uuid)
Obrigatório: Sim

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


NodeTransitionType

Tipo: cadeia (enumeração)
Obrigatório: Sim

Indica o tipo de transição a executar. NodeTransitionType.Start iniciará um nó parado. NodeTransitionType.Stop irá parar um nó que está em cima. Os valores possíveis incluem: "Inválido", "Iniciar", "Parar"


NodeInstanceId

Tipo: cadeia
Obrigatório: Sim

O ID da instância do nó de destino. Isto pode ser determinado através da API GetNodeInfo.


StopDurationInSeconds

Tipo: número inteiro (int32)
Obrigatório: Sim
InclusiveMinimum: 0

A duração, em segundos, para manter o nó parado. O valor mínimo é 600, o máximo é 14400. Após esta hora expirar, o nó voltará a aparecer automaticamente.


timeout

Tipo: número inteiro (int64)
Obrigatório: Não
Predefinição: 60
InclusiveMaximum: 4294967295
InclusiveMinimum: 1

O tempo limite do servidor para executar a operação em segundos. Este tempo limite especifica a duração de tempo que o cliente está disposto a aguardar que a operação pedida seja concluída. O valor predefinido para este parâmetro é 60 segundos.

Respostas

Código de Estado HTTP Description Esquema de Resposta
202 (Aceite) Um código de estado 202 indica que a operação foi aceite. Chame a API GetNodeTransitionProgress para obter o progresso.
Todos os outros códigos de estado A resposta detalhada ao erro.
FabricError