群集命令用于设置群集和管理群集资源。
|
获取当前的群集配置状态和资源属性。
请求示例:
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