sistema · Referência do comando

`qzx getDiskSpace`

O que faz

Obtém informações sobre o uso do espaço em disco.

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.9. A documentação corresponde ao checkout alpha 0.2.2.0.9.

Comportamento e proteções integradas

Inspeciona sem alterar o estado

Execução direta para esta operação

Funciona sem invocar programas nativos

Funciona sem usar a rede

Projetado para funcionar sem elevação

Esta classificação de segurança foi revisada por OpenAI GPT-5.6 Pro em relação ao digest de implementação sha256:174a32ca33b3f7d3d5a37d35b145e842916f5f4a29a4e671346ccdc5331f90fc em 2026-08-25.

Sintaxe exata

qzx getDiskSpace [path] --json

Parâmetros

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

Nome	Tipo	Obrigatório	Padrão	Descrição
path	str	Não	Não declarado	Caminho do qual serão obtidas as informações do disco. Se não for fornecido, serão mostrados todos os discos

Exemplos de entrada

qzx getDiskSpace

Obter informações sobre todos os discos disponíveis

qzx getDiskSpace C:

Obter informações sobre a unidade C: (Windows)

qzx getDiskSpace /home

Obter informações sobre a partição /home (Linux ou Mac)

Para obter o payload estruturado completo, adicione --json: qzx getDiskSpace [path] --json

Exemplo de saída observada

Capturado com QZX 0.2.2.0.9 no Windows 11; código de saída 0. Valores dependentes do host e a duração podem variar.

Comando do exemplo: qzx getDiskSpace . --json

{
    "success": true,
    "message": "Disk information for '.': 3.34 TB used of 3.38 TB total (98.7% used), 44.99 GB free.",
    "disk_info": {
        "path": ".",
        "total_bytes": 3718889074688,
        "used_bytes": 3670577057792,
        "free_bytes": 48312016896,
        "total": "3.38 TB",
        "used": "3.34 TB",
        "free": "44.99 GB",
        "percent": 98.7
    },
    "meta": {
        "command": "getDiskSpace",
        "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": 3.378,
        "schema_version": 1
    }
}

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
        },
        "disk_info": [],
        "disks": [],
        "error": {
            "type": "string"
        },
        "summary": {
            "type": "object",
            "properties": {
                "total_disks": [],
                "total_space": [],
                "total_space_readable": [],
                "used_space": [],
                "used_space_readable": [],
                "free_space": [],
                "free_space_readable": [],
                "percent_used": []
            },
            "additionalProperties": true
        }
    },
    "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.

{
    "success": false,
    "error": "Path '../artifacts/qzx-evidence/missing-golden-core-path' does not exist",
    "message": "Failed to get disk information: Path '../artifacts/qzx-evidence/missing-golden-core-path' does not exist.",
    "meta": {
        "command": "getDiskSpace",
        "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": 2.952,
        "schema_version": 1
    }
}

Comando capturado: qzx getDiskSpace ../artifacts/qzx-evidence/missing-golden-core-path --json

Fluxo de evidência: capturada e validada por digest.

Evidência e procedência

Implementação: src/qzx/commands/system/get_disk_space.py
Testes: tests/test_system_commands/test_get_disk_space.py
Canal de documentação: Documentação de desenvolvimento 0.2.2.0.9 · main · sha256:cfba936e39931c286ca23add0ae546693db17d8b316e7cbc3891d26642d9b7e8
Disponibilidade: 0.2.2.0.9 ou anterior

Guia prático

Aprenda quando qzx getDiskSpace é 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