Storage fabric
The replication network that high-availability block storage runs on. API v2.10.
Who can call this
Every command on this page requires the platform customer (customer id 1).
A reseller or child-customer key is rejected.
Post to https://api.rackcorp.net/api/rest/v2.10/json.php.
A fabric is a VLAN, an IPv4 CIDR, a controller VIP, and the hosts that use addresses in that CIDR.
Assigning a host is what starts config sync: the host agent picks the assignment up on its next run.
Fabric
| Command | Parameters |
|---|---|
storage.fabric.getall | No parameters. Returns fabrics. |
storage.fabric.get | fabricId. Returns fabric. |
storage.fabric.create | name, vlan (1–4094), networkCidr (IPv4 CIDR, prefix 8–30; cidr is accepted). Optional notes. The controller VIP is the first usable address of the CIDR. Sync keys are generated. |
storage.fabric.update | fabricId. Any of name, vlan, networkCidr, notes (empty clears notes). Refused while state is TRANSITIONING. The CIDR cannot change while hosts are assigned. |
storage.fabric.delete | fabricId. Refused while a controller host is still active. |
storage.fabric.sync.keys.regenerate | fabricId. Replaces the sync key pair and bumps syncKeyVersion. Hosts pick the new keys up on the next agent run. |
A fabric object includes fabricId, name, vlan, networkCidr, controllerVip, controllerDeviceId, state, primaryDown, syncGeneration, pendingAction, hosts, hostCount, barrierReadyCount, hasSyncPublicKey, and syncKeyVersion.
The private key is not in this object.
Each host includes deviceId, storageIp, syncedGeneration, lastError, haAvailable, and autoplaceOverride (AUTO, ALLOW, or DENY).
{
"cmd": "storage.fabric.create",
"name": "syd-fabric",
"vlan": 400,
"networkCidr": "10.255.255.0/24"
}Hosts
| Command | Parameters |
|---|---|
storage.fabric.host.set | fabricId, deviceId, storageIp. The address must be usable inside the fabric CIDR and must not be the controller VIP. A host can belong to one fabric. Calling it again updates that host's address. The same address is written onto the host's storage-domain membership. |
storage.fabric.host.clear | deviceId. Removes the host. Refused while that host is the active controller. |
storage.fabric.host.autoplace.set | deviceId, autoplaceOverride: AUTO, ALLOW, or DENY. AUTO follows HA health. ALLOW and DENY stick until changed. This does not move replicas that already exist. The response may include warnings. |