群集

群集命令用于设置群集和管理群集资源。

请求 路径 /hardware/v1 描述 GET /cluster 获取群集属性和群集资源列表 GET /cluster/resources /<resource:path> 获取指定的群集资源的属性 PUT /cluster/resources /<resource:path> 修改指定的群集资源 PUT /cluster/failback 对分配给群集对等设备的所有资源都执行故障恢复 PUT /cluster/takeover 接管所有分配给群集对等设备的资源 PUT /cluster/unconfigure 取消群集设备的单机模式配置 GET /cluster/links 获取群集卡链路状态 PUT /cluster/setup 执行初始群集设置

获取群集属性

获取当前的群集配置状态和资源属性。

请求示例：

GET /api/hardware/v1/cluster HTTP/1.1
Authorization: Basic abcd45sMWE=
Host: tanana:215
Accept: application/json

响应示例：

HTTP/1.1 200 OK
X-Zfssa-Appliance-Api: 1.0
Content-Type: application/json
Content-Length: 529
X-Zfssa-Api: 1.0

{
    "cluster": {
        "description": "Clustering is not configured",
        "peer_asn": "",
        "peer_description": "",
        "peer_hostname": "",
        "peer_state": "",
        "resources": {
            "net/ixgbe0": {
                "details": ["10.80.231.58"],
                "href": "/hardware/v1/cluster/resources/resources/net/ixgbe0",
                "owner": "tanana",
                "type": "singleton",
                "user_label": "Untitled Interface"
            },
            "zfs/gold": {
                "details": ["821G"],
                "href": "/hardware/v1/cluster/resources/resources/zfs/gold",
                "owner": "tanana",
                "type": "singleton",
                "user_label": ""
            }
        },
        "state": "AKCS_UNCONFIGURED"
    }
}

获取群集资源

根据群集资源中的 href 属性，可以获取该单个群集资源的数据。上例中有两个可用资源：/hardware/v1/cluster/resources/resources/zfs/gold 和 /hardware/v1/cluster/resources/resources/net/ixgbe0

修改群集资源

当系统完成群集设置后，可以使用此命令修改各个群集资源的属性。有关更多信息，请参见 CLI "configuration cluster resources"（配置群集资源）。

群集命令

群集支持的命令有 failover、takeback 和 unconfigure。所有命令都会向群集资源发出 PUT 请求，并附上该命令的名称。成功后，两个命令都返回 HTTP 状态 202 (Accepted)。

请求示例：

PUT /api/hardware/v1/cluster/failback HTTP/1.1
Authorization: Basic abcd123MWE=
Host: zfssa.example.com:215

结果示例：

HTTP/1.1 202 Accepted
X-Zfssa-Appliance-Api: 1.0

如果群集未处于正确状态，无法接受命令，则返回 HTTP 状态 409 (Conflict)。

群集链路

此命令返回群集卡的当前链路状态。输出的结果与 aksh 命令 "configuration cluster links" 的输出相同。建议在运行群集设置之前运行此命令，以确保群集布线没有问题。运行设置之前，所有链路都应处于 AKCIOS_ACTIVE 状态。

请求示例：

GET /api/hardware/v1/cluster/links HTTP/1.1
Authorization: Basic abcd123MWE=
Host: zfssa.example.com:215
Accept: application/json

响应示例：

HTTP/1.1 200 OK
X-Zfssa-Appliance-Api: 1.0
Content-Type: application/json
Content-Length: 181

{
    "links": {
        "clustron2_embedded:0/clustron_uart:0 = AKCIOS_TIMEDOUT\n
         clustron2_embedded:0/clustron_uart:1 = AKCIOS_TIMEDOU\n
         clustron2_embedded:0/dlpi:0 = AKCIOS_TIMEDOUT"
    }
}

设置群集

setup cluster 命令可为系统设置初始群集。所有群集链路都应处于 AKCIOS_ACTIVE 状态，且应打开对等设备系统的电源但不进行配置，否则此命令将失败。

请求示例：

PUT /api/hardware/v1/cluster/setup HTTP/1.1
Authorization: Basic abcd123MWE=
Host: zfssa.example.com:215
Accept: application/json

{"nodename": "zfssa-storage-2", "password": "letmein"}

结果示例：

HTTP/1.1 202 Accepted
X-Zfssa-Appliance-Api: 1.0