sistema · Referência do comando

`qzx getDiskHealth`

O que faz

Inspeciona a saúde S.M.A.R.T. de um disco com smartctl e distingue alertas do disco de falhas do comando.

Maturidade do comando: Alpha

Disponível para uso real e feedback enquanto a interface e o comportamento ainda podem evoluir. Esta é a avaliação atual do checkout de desenvolvimento. Cada tag de release imutável futuro preservará a avaliação exata incluída nessa versão. Disponível no PyPI 0.2.2.0.15. A documentação corresponde ao checkout alpha 0.2.2.0.15.

Comportamento e proteções integradas

Inspeciona sem alterar o estado

Execução direta para esta operação

Usa uma ferramenta nativa quando necessário

Funciona sem usar a rede

Usa suas permissões atuais; o resultado pode variar

Valida um identificador de disco, resolve um caminho exato do smartctl e o executa sem shell com limite de 15 segundos. Interpreta o código de saída como bitmask: falhas de sintaxe, abertura, comandos SMART ou checksum abortam, enquanto indicadores de saúde do disco permanecem como observações estruturadas.

Esta classificação de segurança foi revisada por Claude Opus 5.5 (Anthropic) em relação ao digest de implementação sha256:937110a2b7a610a56c492828c626c1bb18e59f35878caab2c56b180de5889318 em 2026-10-08.

Sintaxe exata

qzx getDiskHealth <disk> [view] --json

Parâmetros

Deslize ou use a barra horizontal para ver todas as colunas.

Nome	Tipo	Obrigatório	Padrão	Descrição
disk	str	Sim	Não declarado	Identificador sem separadores de caminho (por exemplo, sda, nvme0n1, disk0 ou PhysicalDrive0)
view	str	Não	"health"	Nível de detalhe: "health" para o resumo ou "full" para o JSON do smartctl

Exemplos de entrada

qzx getDiskHealth sda

Inspecionar a saúde S.M.A.R.T. de /dev/sda

qzx getDiskHealth PhysicalDrive0 --view full

Ler o JSON S.M.A.R.T. completo do PhysicalDrive0 no Windows

Para obter o payload estruturado completo, adicione --json: qzx getDiskHealth <disk> [view] --json

Exemplo de saída representativa

Este JSON ilustrativo deriva do contrato de resultado respaldado pela implementação atual. Mostra o que o comando pode retornar sem afirmar que seja uma execução gravada; os valores variam conforme entradas, máquina, permissões e ferramentas opcionais.

Comando do exemplo: qzx getDiskHealth sda --json

{
    "success": true,
    "message": "Inspects one disk's S.M.A.R.T. health with smartctl and reports status flags without treating health warnings as command failures. In this illustrative example, the command completed successfully.",
    "meta": {
        "command": "getDiskHealth",
        "command_maturity": {
            "stage": "alpha",
            "label": "Alpha",
            "sequence": 2,
            "public_executable": true,
            "stability": "interface_may_change",
            "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
            "promotion_review_required": false,
            "assessment_scope": "development_checkout"
        },
        "duration_ms": 0,
        "schema_version": 1
    },
    "device": "Example value",
    "disk": "Example value",
    "health_status": [
        {
            "name": "example",
            "status": "ok"
        }
    ],
    "output": "Command completed successfully with structured details.",
    "smart_data": "Example value",
    "stdout": "Command completed successfully.",
    "view": "Example value"
}

Ver o contrato de resultado JSON

{
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "type": "object",
    "required": [
        "success",
        "message",
        "meta"
    ],
    "properties": {
        "success": {
            "type": "boolean"
        },
        "message": {
            "type": "string"
        },
        "meta": {
            "type": "object",
            "required": [
                "command",
                "command_maturity",
                "duration_ms",
                "schema_version"
            ],
            "properties": {
                "command": {
                    "type": "string"
                },
                "command_maturity": {
                    "type": "object",
                    "required": [
                        "stage",
                        "label",
                        "sequence",
                        "public_executable",
                        "stability",
                        "summary",
                        "promotion_review_required",
                        "assessment_scope"
                    ],
                    "properties": {
                        "stage": {
                            "type": "string"
                        },
                        "label": {
                            "type": "string"
                        },
                        "sequence": {
                            "type": "integer"
                        },
                        "public_executable": {
                            "type": "boolean"
                        },
                        "stability": {
                            "type": "string"
                        },
                        "summary": {
                            "type": "string"
                        },
                        "promotion_review_required": {
                            "type": "boolean"
                        },
                        "assessment_scope": {
                            "type": "string"
                        },
                        "note": {
                            "type": "string"
                        },
                        "review": {
                            "type": "object",
                            "required": [
                                "reviewed_on",
                                "rationale",
                                "evidence"
                            ],
                            "properties": {
                                "reviewed_on": {
                                    "type": "string",
                                    "format": "date"
                                },
                                "rationale": {
                                    "type": "string"
                                },
                                "evidence": {
                                    "type": "array",
                                    "minItems": 1,
                                    "items": {
                                        "type": "string"
                                    }
                                },
                                "replacement": {
                                    "type": "string"
                                }
                            },
                            "additionalProperties": false
                        }
                    },
                    "additionalProperties": true
                },
                "duration_ms": {
                    "type": "number"
                },
                "schema_version": {
                    "type": "integer"
                }
            },
            "additionalProperties": true
        },
        "device": [],
        "disk": [],
        "error": {
            "type": "string"
        },
        "error_code": {
            "type": "string"
        },
        "health_status": [],
        "output": [],
        "smart_data": [],
        "stdout": [],
        "view": []
    },
    "additionalProperties": true
}

Erros e limites

O contrato público exige success=false e uma message descritiva em caso de falha. Este catálogo ainda não declara uma taxonomia de erros específica para cada comando; revise o resultado e não infira códigos inexistentes.

O QZX está em alpha. Dependências opcionais, permissões e recursos do host podem alterar o resultado.

Fluxo de evidência: requer um ambiente privilegiado controlado.

Evidência e procedência

Implementação: src/qzx/commands/system/get_disk_health.py
Testes: tests/test_system_commands/test_get_disk_health.py
Canal de documentação: Documentação de desenvolvimento 0.2.2.0.15 · main · sha256:b91acee86268edb7cb018a94e089ff8e95835eda3f2cf08b39796c0ab9654693
Disponibilidade: 0.2.2.0.15 ou anterior

Guia prático

Aprenda quando qzx getDiskHealth é adequado à tarefa, como se compara às ferramentas nativas e quais detalhes importam na automação.

7 min de leitura
Diagnóstico de espaço em disco sem começar apagando arquivos
Capacidade, arquivos grandes e duplicados verificados em um fluxo de leitura que entrega evidência antes de qualquer decisão destrutiva.
Ler o guia prático

Continue explorando

Estes comandos também pertencem à categoria sistema. Compare-os para escolher a operação que melhor resolve sua tarefa.

Explorar todos os comandos do QZX