列出项目

此命令列出给定池中的所有项目。每个返回的项目都包含上述可修改属性的列表以及池名称、创建时间、装入状态、复制操作和数据使用情况。

"Query Parameters"（查询参数）过滤器－一个简单的字符串匹配过滤器，要求项目中的属性在其值中包含相同的过滤器字符串。

表 12-5  URI 参数

参数 描述 pool 存储池名称

请求示例：

GET /api/storage/v1/pools/gold/projects HTTP/1.1
Host: zfs-storage.example.com
Accept: application/json

成功获取后，将返回 HTTP 代码 200 (OK) 以及项目属性数组（使用 JSON 格式）。

结果示例：

HTTP/1.1 200 OK
Content-Type: application/json

{
    “projects”: [{
        “name”: “proj-01”,
        ...
    }, {
        “name”: “proj-02”,
        ...
    }
}

系统也支持所有池中的所有项目的列表；URI 将仅包含 /projects 路径。

获取所有项目并以 "backup" 作为其部分属性的请求示例：

GET /projects?filter=backup HTTP/1.1
Host: zfs-storage.example.com
Accept: application/json

获取项目属性

此命令列出给定池中单个项目的属性。成功获取后，将返回 HTTP 代码 200 (OK) 以及项目属性（使用 JSON 格式）。

表 12-6  获取项目 URI 参数

参数 描述 pool 存储池名称 project 项目名称

列出 "gold" 池中名为 "proj-01" 的项目的请求示例：

GET /api/storage/v1/pools/gold/projects/proj-01 HTTP/1.1
Host: zfs-storage.example.com
Accept: application/json

响应示例：

HTTP/1.1 200 OK
Content-Type: application/json

{
    "project": {
        "default_volblocksize": 8192.0,
        "logbias": "latency",
        "creation": "20130411T20:02:35",
        "nodestroy": false,
        "dedup": false,
        "sharenfs": "on",
        "sharesmb": "off",
        "default_permissions": "700",
        "mountpoint": "/export",
        "snaplabel": "",
        "id": "042919bb-0882-d903-0000-000000000000",
        "readonly": false,
        "rrsrc_actions": [],
        "compression": "off",
        "sharetftp": "",
        "default_sparse": false,
        "snapdir": "hidden",
        "aclmode": "discard",
        "copies": 1,
        "aclinherit": "restricted",
        "shareftp": "",
        "canonical_name": "gold/local/default",
        "recordsize": 131072.0,
        "usage": {
            "available": 1758424767306.0,
            "loading": false,
            "quota": 0.0,
            "snapshots": 0.0,
           "compressratio": 100.0,
           "child_reservation": 0.0,
           "reservation": 0.0,
           "total": 45960.0,
            "data": 45960.0
        },
        "default_volsize": 0.0,
        "secondarycache": "all",
        "collection": "local",
        "exported": true,
        "vscan": false,
        "reservation": 0.0,
        "atime": true,
        "pool": "gold",
        "default_user": "nobody",
        "name": "default",
        "checksum": "fletcher4",
        "default_group": "other",
        "sharesftp": "",
        "nbmand": false,
        "sharedav": "",
        "rstchown": true
    }
}