Obter parte de integridade do cluster usando política e filtros avançados
Obtém a integridade de um cluster do Service Fabric usando partes de integridade.
Obtém a integridade de um cluster do Service Fabric usando partes de integridade. A avaliação de integridade é feita com base na descrição da consulta da parte de integridade do cluster de entrada. A descrição da consulta permite que os usuários especifiquem políticas de integridade para avaliar o cluster e seus filhos. Os usuários podem especificar filtros muito flexíveis para selecionar quais entidades de cluster retornar. A seleção pode ser feita com base no estado de integridade das entidades e com base na hierarquia. A consulta pode retornar filhos de vários níveis das entidades com base nos filtros especificados. Por exemplo, ele pode retornar um aplicativo com um nome especificado e, para esse aplicativo, retornar somente os serviços que estão em Erro ou Aviso e todas as partições e réplicas de um desses serviços.
Solicitação
| Método | URI da solicitação |
|---|---|
| POST | /$/GetClusterHealthChunk?api-version=6.0&timeout={timeout} |
Parâmetros
| Nome | Type | Obrigatório | Location |
|---|---|---|---|
api-version |
string | Sim | Consulta |
timeout |
inteiro (int64) | Não | Consulta |
ClusterHealthChunkQueryDescription |
ClusterHealthChunkQueryDescription | Não | Corpo |
api-version
Tipo: string
Obrigatório: sim
Padrão: 6.0
A versão da API. Esse parâmetro é necessário e seu valor deve 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 foi alterada. O runtime do Service Fabric dá suporte a mais de uma versão da API. Esta é 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 nesta especificação.
Além disso, o runtime aceita qualquer versão que seja maior do 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, mas se o runtime for 6.1, para facilitar a gravação 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 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.
ClusterHealthChunkQueryDescription
Tipo: ClusterHealthChunkQueryDescription
Obrigatório: não
Descreve as políticas de integridade do cluster e do aplicativo usadas para avaliar a integridade do cluster e os filtros para selecionar quais entidades de cluster serão retornadas.
Se a política de integridade do cluster estiver presente, ela será usada para avaliar os eventos de cluster e os nós de cluster. Se não estiver presente, a avaliação de integridade usará a política de integridade do cluster definida no manifesto do cluster ou na política de integridade do cluster padrão.
Por padrão, cada aplicativo é avaliado usando sua política de integridade de aplicativo específica, definida no manifesto do aplicativo ou a política de integridade padrão, se nenhuma política for definida no manifesto.
Se o mapa da política de integridade do aplicativo for especificado e tiver uma entrada para um aplicativo, a política de integridade do aplicativo especificada será usada para avaliar a integridade do aplicativo.
Os usuários podem especificar filtros muito flexíveis para selecionar quais entidades de cluster incluir em resposta. A seleção pode ser feita com base no estado de integridade das entidades e com base na hierarquia.
A consulta pode retornar filhos de vários níveis das entidades com base nos filtros especificados. Por exemplo, ele pode retornar um aplicativo com um nome especificado e, para esse aplicativo, retornar somente os serviços que estão em Erro ou Aviso e todas as partições e réplicas de um desses serviços.
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 da parte de integridade do cluster solicitadas. |
ClusterHealthChunk |
| Todos os outros códigos de status | A resposta de erro detalhada. |
FabricError |