Partilhar via


Obter Lista de Informações de Partição Carregada

Obtém a lista ordenada de partições.

Obtém partições que são mais/menos carregadas de acordo com a métrica especificada.

Pedir

Método URI do pedido
GET /$/GetLoadedPartitionInfoList?api-version=8.0&MetricName={MetricName}&ServiceName={ServiceName}&Ordering={Ordering}&MaxResults={MaxResults}&ContinuationToken={ContinuationToken}

Parâmetros

Nome Tipo Necessário Localização
api-version string Yes Consulta
MetricName string Yes Consulta
ServiceName cadeia (de carateres) No Consulta
Ordering cadeia (enumeração) No Consulta
MaxResults número inteiro (int64) No Consulta
ContinuationToken cadeia (de carateres) No Consulta

api-version

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

A versão da API. Este parâmetro é obrigatório e o respetivo valor tem de ser "8.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 versão é 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 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 6.0 documentada.


MetricName

Tipo: cadeia
Obrigatório: Sim

Nome da métrica com base na qual obter a lista ordenada de partições.


ServiceName

Tipo: cadeia
Obrigatório: Não

O nome de um serviço.


Ordering

Tipo: cadeia (enumeração)
Obrigatório: Não
Predefinição: Desc

Ordenação da carga das partições. Os valores possíveis incluem: "Desc", "Asc"


MaxResults

Tipo: número inteiro (int64)
Obrigatório: Não
Predefinição: 0
InclusiveMinimum: 0

O número máximo de resultados a devolver como parte das consultas paginadas. Este parâmetro define o limite superior no número de resultados devolvidos. Os resultados devolvidos podem ser inferiores aos resultados máximos especificados se não caberem na mensagem de acordo com as restrições de tamanho máximo de mensagens definidas na configuração. Se este parâmetro for zero ou não for especificado, a consulta paginada inclui o maior número possível de resultados que cabem na mensagem de retorno.


ContinuationToken

Tipo: cadeia
Obrigatório: Não

O parâmetro do token de continuação é utilizado para obter o próximo conjunto de resultados. Um token de continuação com um valor não vazio é incluído na resposta da API quando os resultados do sistema não cabem numa única resposta. Quando este valor é transmitido para a próxima chamada à API, a API devolve o próximo conjunto de resultados. Se não existirem mais resultados, o token de continuação não contém um valor. O valor deste parâmetro não deve ser codificado por URL.

Respostas

Código de Estado HTTP Description Esquema de Resposta
200 (OK) Uma operação bem-sucedida devolverá o código de estado 200 e as informações de carregamento do cluster pedidas.
LoadedPartitionInformationResultList
Todos os outros códigos de estado A resposta detalhada ao erro.
FabricError