title | apisections | markdown2extras |
---|---|---|
Manta Storinfo API |
tables, code-friendly |
Returns a list of storage nodes found in the manta_storage
bucket, sorted by the manta_storage_id
field. Because the list of storage nodes
can be quite large, this endpoint enforces pagination to limit the response size.
storagenodes
will implement a cursor-based pagination scheme using the storage node's manta_storage_id
as the cursor value.
Field | Type | Description | Optional? |
---|---|---|---|
after_id | String | return results for the storage node with a storage id greater than "after_id" | Yes (default = "0") |
limit | Number | max number of results to return | Yes (default/max = 500) |
The response to /storagenodes
will include the following metadata:
Field | Type | Description |
---|---|---|
last_id | String | The id of the last result returned |
next_link | String | URL to retrieve the next result set (using limit value from previous request) |
A request where "after_id" is greater than all of the storage nodes will result in an error (404).
A request with an unsupported parameter or a bad parameter value will result in an error (400).
Requesting a limit that is greater than the number of available results will succeed, returning whatever number of results are available.
Get up to the first 100 results:
/storagenodes?limit=100
Get up to the next 100 results:
/storagenodes?limit=100&after_id=<last_id>
Returns just the storage node with the manta_storage_id
specified by "storageid", .
A request where "storageid" does not match any storage nodes will result in an error (404).
Forces the storinfo's cached view of the manta_storage bucket to be immediately invalidated and refreshed. The only intended consumer of this API is the Rebalancer, which will call this API after marking a storage node as read-only, prior to evacuating the objects on it.
This interfaces takes no input parameters.