Ir para o conteúdo principal

sistema · Referência do comando

qzx listDiskDevices

O que faz

Obtém o nome ou modelo de um disco ou de todos os discos.

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

Usa uma ferramenta nativa quando necessário

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:7d07e05b84ef4206f64f20977ad20e9e603c30ce3b355e8c4b27a4c6f523ebf7 em 2026-08-25.

Sintaxe exata

qzx listDiskDevices [disk_path] --json

Parâmetros

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

NomeTipoObrigatórioPadrãoDescrição
disk_pathstrNãoNão declaradoCaminho do disco do qual serão obtidas informações. Se não for fornecido, serão mostradas informações de todos os discos

Exemplos de entrada

qzx listDiskDevices

Obter informações sobre todos os discos

qzx listDiskDevices C:

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

qzx listDiskDevices /dev/sda

Obter informações sobre o disco /dev/sda (Linux)

Para obter o payload estruturado completo, adicione --json: qzx listDiskDevices [disk_path] --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 listDiskDevices --json

{
    "success": true,
    "message": "Gets disk name/model information for a disk or all disks. In this illustrative example, the command completed successfully.",
    "meta": {
        "command": "listDiskDevices",
        "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
    },
    "block_devices": [
        {
            "name": "example",
            "status": "ok"
        }
    ],
    "block_devices_error": "Example value",
    "block_devices_raw": "Example value",
    "details": {
        "disk_path": "C:\\project\\example.txt"
    },
    "disk_list": "Example value",
    "disk_list_error": "Example value",
    "disk_list_raw": "Example value",
    "disks": [
        {
            "name": "C:",
            "total_space_readable": "931.51 GiB",
            "free_space_readable": "440.00 GiB",
            "percent_used": 52.8
        }
    ],
    "os_type": "Windows",
    "physical_disks": [
        {
            "name": "example",
            "status": "ok"
        }
    ],
    "physical_disks_error": "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
        },
        "block_devices": [],
        "block_devices_error": [],
        "block_devices_raw": [],
        "details": {
            "type": "object",
            "properties": {
                "disk_path": []
            },
            "additionalProperties": true
        },
        "disk_list": [],
        "disk_list_error": [],
        "disk_list_raw": [],
        "disks": {
            "type": "array"
        },
        "error": {
            "type": "string"
        },
        "error_code": {
            "type": "string"
        },
        "os_type": [],
        "physical_disks": {
            "type": "array"
        },
        "physical_disks_error": []
    },
    "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 a matriz de sistemas operacionais compatíveis.

Evidência e procedência

Testes
Não foi encontrado um arquivo de teste específico com o mesmo nome do módulo; isso não demonstra ausência total de cobertura.
Canal de documentação
Documentação de desenvolvimento 0.2.2.0.9 · main · sha256:cfba936e39931c286ca23add0ae546693db17d8b316e7cbc3891d26642d9b7e8
Disponibilidade
0.2.2.0.9 ou anterior

Continue explorando

Comandos relacionados

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