Iniciar a transição do nó

Começa ou para um nó de aglomerado.

Começa ou para um nó de aglomerado. Um nó de cluster é um processo, não o próprio caso so. Para iniciar um nó, passe em "Iniciar" para o parâmetro NodeTransitionType. Para parar um nó, passe em "Stop" para o parâmetro NodeTransitionType. Esta API inicia a operação - quando a API retorna o nó pode ainda não ter terminado a transição. Ligue para GetNodeTransitionProgress com a mesma OperaçãoId 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 Sim Consulta
OperationId corda (uuid) Sim Consulta
NodeTransitionType corda (enum) Sim Consulta
NodeInstanceId string Sim Consulta
StopDurationInSeconds inteiro (int32) Sim Consulta
timeout inteiro (int64) No Consulta

nodeName

Tipo: corda
Obrigatório: Sim

O nome do nó.


api-version

Tipo: corda
Obrigatório: Sim
Predefiniçã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 de tempo de execução em que a API foi introduzida ou foi alterada. O tempo de funcionação do Tecido de Serviço suporta mais de uma versão da API. Esta é a mais recente versão suportada da API. Se uma versão API mais baixa for aprovada, 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 mais recente suportada até à 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, de forma a facilitar a escrita dos clientes, o tempo de execução aceitará a versão 6.1 para a API. No entanto, o comportamento da API será conforme a versão 6.0 documentada.


OperationId

Tipo: corda (uuid)
Obrigatório: Sim

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


NodeTransitionType

Tipo: corda (enum)
Obrigatório: Sim

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


NodeInstanceId

Tipo: corda
Obrigatório: Sim

A identificação do nó do nó-alvo. Isto pode ser determinado através da API GetNodeInfo.


StopDurationInSeconds

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

A duração, em segundos, para manter o nó parado. O valor mínimo é de 600, o máximo é de 14400. Após o termo deste tempo, o nó voltará automaticamente para cima.


timeout

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

O tempo limite do servidor para a realização da operação em segundos. Este prazo estipula a duração que o cliente está disposto a esperar pela conclusão da operação solicitada. O valor predefinido para este parâmetro é de 60 segundos.

Respostas

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