Integridade do nó de relatório
Envia um relatório de integridade sobre o nó do Service Fabric.
Relata o estado de integridade do nó do Service Fabric especificado. O relatório deve conter as informações sobre a origem do relatório de integridade e propriedade na qual ele será relatado. O relatório é enviado a um nó de gateway do Service Fabric, que encaminha para o repositório de integridade. O relatório pode ser aceito pelo gateway, mas rejeitado pelo repositório de integridade após validação adicional. Por exemplo, o repositório de integridade pode rejeitar o relatório devido a um parâmetro inválido, como um número de sequência obsoleto. Para ver se o relatório foi aplicado no repositório de integridade, execute GetNodeHealth e marcar que o relatório aparece na seção HealthEvents.
Solicitação
Método | URI da solicitação |
---|---|
POST | /Nodes/{nodeName}/$/ReportHealth?api-version=6.0&Immediate={Immediate}&timeout={timeout} |
Parâmetros
Nome | Type | Obrigatório | Location |
---|---|---|---|
nodeName |
string | Sim | Caminho |
api-version |
string | Sim | Consulta |
Immediate |
booleano | Não | Consulta |
timeout |
inteiro (int64) | Não | Consulta |
HealthInformation |
HealthInformation | Sim | Corpo |
nodeName
Tipo: string
Obrigatório: sim
O nome do nó.
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 é 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 é 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 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.
Immediate
Tipo: booliano
Obrigatório: não
Padrão: false
Um sinalizador que indica se o relatório deve ser enviado imediatamente.
Um relatório de integridade é enviado a um Aplicativo de gateway do Service Fabric, que encaminha para o repositório de integridade.
Se "Immediate" for definido como "true", o relatório será enviado imediatamente do Gateway de HTTP para o repositório de integridade, independentemente das configurações de cliente que o Aplicativo de Gateway de HTTP estiver usando.
Isso é útil para relatórios importantes que precisam ser enviados assim que possível.
Dependendo do tempo e de outras condições, enviar o relatório ainda pode falhar se, por exemplo, o Gateway de HTTP estiver fechado ou a mensagem não alcançar o Gateway.
Se "Immediate" for definido como "false", o relatório será enviado com base nas configurações do cliente de integridade do Gateway de HTTP. Portanto, ele será agrupado de acordo com a configuração de HealthReportSendInterval.
Esta é a configuração recomendada, pois ela permite que o cliente de integridade otimize a integridade relatando mensagens para o repositório de integridade, bem como para o processamento de relatório de integridade.
Por padrão, relatórios não são enviados imediatamente.
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.
HealthInformation
Tipo: HealthInformation
Obrigatório: sim
Descreve as informações de integridade do relatório de integridade. Essas informações precisam estar presentes em todos os relatórios de integridade enviados ao gerente de integridade.
Respostas
Código de status HTTP | Descrição | Esquema de Resposta |
---|---|---|
200 (OK) | Uma operação bem-sucedida retornará 200 status código. |
|
Todos os outros códigos status | A resposta de erro detalhada. |
FabricError |