Compartilhar via

Obter versão do cluster

  • Artigo

Obtenha a versão atual do cluster do Service Fabric.

Se uma atualização de cluster estiver acontecendo, essa API retornará a versão mais baixa (mais antiga) das versões atuais e de runtime do cluster de destino.

Solicitação

Método URI da solicitação
GET /$/GetClusterVersion?api-version=6.4&timeout={timeout}

Parâmetros

Nome Type Obrigatório Location
api-version string Sim Consulta
timeout inteiro (int64) No Consulta

api-version

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

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

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 versão é 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 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 e o runtime for 6.1, 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.

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
200 (OK) Uma operação bem-sucedida retornará 200 status código e as informações de versão do cluster solicitadas.
 ClusterVersion
Todos os outros códigos status A resposta de erro detalhada.
 FabricError

Exemplos

Obter a versão do cluster

Este exemplo recupera a versão atual (ou a versão mais baixa durante a atualização) do cluster.

Solicitação

GET http://localhost:19080/$/GetClusterVersion?api-version=6.4

Resposta 200

Corpo
{
  "Version": "6.4.514.9494"
}