Partilhar via

Resolver Serviço

Resolver uma partição do Service Fabric.

Resolva uma partição de serviço do Service Fabric para obter os pontos finais das réplicas de serviço.

Pedir

Método URI do pedido
GET /Services/{serviceId}/$/ResolvePartition?api-version=6.0&PartitionKeyType={PartitionKeyType}&PartitionKeyValue={PartitionKeyValue}&PreviousRspVersion={PreviousRspVersion}&timeout={timeout}

Parâmetros

Nome Tipo Necessário Localização
serviceId string Yes Caminho
api-version string Yes Consulta
PartitionKeyType número inteiro No Consulta
PartitionKeyValue cadeia (de carateres) No Consulta
PreviousRspVersion cadeia (de carateres) No Consulta
timeout número inteiro (int64) No Consulta

serviceId

Tipo: cadeia
Obrigatório: Sim

A identidade do serviço. Normalmente, este ID é o nome completo do serviço sem o esquema de URI "fabric:". A partir da versão 6.0, os nomes hierárquicos são delimitados com o caráter "~". Por exemplo, se o nome do serviço for "fabric:/myapp/app1/svc1", a identidade do serviço será "myapp~app1~svc1" em 6.0+ e "myapp/app1/svc1" em versões anteriores.

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.

PartitionKeyType

Tipo: número inteiro
Obrigatório: Não

Tipo de chave para a partição. Este parâmetro é necessário se o esquema de partição do serviço for Int64Range ou Named. Seguem-se os valores possíveis.

  • Nenhum (1) - Indica que o parâmetro PartitionKeyValue não está especificado. Isto é válido para as partições com o esquema de criação de partições como Singleton. Este é o valor predefinido. O valor é 1.
  • Int64Range (2) - Indica que o parâmetro PartitionKeyValue é uma chave de partição int64. Isto é válido para as partições com o esquema de criação de partições como Int64Range. O valor é 2.
  • Nomeado (3) - Indica que o parâmetro PartitionKeyValue é um nome da partição. Isto é válido para as partições com o esquema de criação de partições como Nomeado. O valor é 3.

PartitionKeyValue

Tipo: cadeia
Obrigatório: Não

Chave de partição. Isto é necessário se o esquema de partição do serviço for Int64Range ou Named. Este não é o ID da partição, mas sim o valor da chave de número inteiro ou o nome do ID da partição. Por exemplo, se o seu serviço estiver a utilizar partições entre 0 e 10, partitionKeyValue será um número inteiro nesse intervalo. Consulte a descrição do serviço para ver o intervalo ou o nome.

PreviousRspVersion

Tipo: cadeia
Obrigatório: Não

O valor no campo Versão da resposta que foi recebida anteriormente. Isto é necessário se o utilizador souber que o resultado obtido anteriormente está obsoleto.

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
200 (OK) Uma operação bem-sucedida devolverá o código de estado 200.
 ResolvedServicePartition
Todos os outros códigos de estado A resposta detalhada ao erro.
 FabricError