Vaults

View information about the COS Vaults in IBM Cloud Object Storage, such as the amount of storage capacity that is used and the Information Dispersal Algorithm (IDA) that is configured for each vault. See whether any vaults are violating the capacity quota limits and which vaults are protected from COS Accesser and COS Slicestor node failures.

A vault is a defined collection of data that is stored in one logical container, across a defined set of COS Slicestor nodes in IBM Cloud Object Storage. The vault is where you can grant permissions and configure data storage options such as encryption, compression, and the IDA.

Additional information is provided about the following attributes of vaults:

Access Pools

The number of access pools that are configured to access the vault.

Accessibility

The number of COS Accesser nodes that can fail before the vault data becomes inaccessible.

For example, if five COS Accesser nodes are configured for a vault and the nodes are all operating normally, then the value is five. If five COS Accesser nodes fail, then you cannot read or write the vault data.

The following values might be shown:

Accessibility	Description
0	The vault is inaccessible because no COS Accesser nodes are configured.
0	The vault is inaccessible because none of the COS Accesser nodes that are configured for the vault are available.
1	One COS Accesser node is configured for the vault and the node is available.
1	More than one COS Accesser node is configured for the vault, but only one node is available.

Acknowledged

Shows whether a user marked the status of the vault as acknowledged. An acknowledged status indicates that the status was reviewed and is either resolved or can be ignored.

Capacity Quota (%)

Illustrates used capacity and soft limits and hard limits.

The percentage of the capacity quota for the vault that is already used. A value is shown only if a nonzero hard quota is defined for the vault.

The used capacity, soft limit, and hard limit values represent usable capacity, and not raw capacity. The values do not include capacity that is reserved for disk overhead and dispersal overhead.

Drive Failure Tolerance

The tolerance of the vault to drive failures across all of the available COS Slicestor nodes in the storage pool that the vault belongs to. The lower the value for failure tolerance, the greater the risk that write operations can no longer be completed for the vault. A value of 0 means that write operations cannot be completed. Learn more about how failure tolerance is calculated for vaults.

The following values might be shown:

Drive Failure Tolerance	Description
0	The vault is not available for write operations because the number of available COS Slicestor nodes in the storage pool < the IDA write threshold value.
3	The vault is at risk of write failure because the number of available COS Slicestor nodes in the storage pool = the IDA write threshold value. If one more node fails, the vault will not be available for write operations. The value 3 indicates that the node with the least tolerance to drive failures will not be able to store vault data if 3 drives fail in the node.
24	The vault is available for write operations and has a high tolerance to drive failures across the COS Slicestor nodes in the storage pool. The value 24 indicates that the vault will not be available for write operations if 24 drives fail in the nodes with the least tolerance to drive failures.

IDA

The Information Dispersal Algorithm (IDA) that is configured for the vault. The IDA value determines the number of COS Slicestor nodes that are used to store vault data and the number of COS Slicestor that are required for read and write operations on the vault.

The IDA uses the following format: width-threshold-write threshold.

The width of the vault is the number of COS Slicestor nodes into which all data in the vault is split. The threshold is the minimum number of COS Slicestor nodes that must be available to complete read operations on the vault. The write threshold is the minimum number of COS Slicestor nodes that must be available to complete write operations on the vault.

Sites

The number of locations that the COS Accesser and COS Slicestor nodes for the vault are distributed to. To ensure high availability for the vault data in IBM Cloud Object Storage, you can distribute the nodes to multiple locations.

Status

The status of the vault. Use the status to determine the condition of the vault, and if any actions must be taken.

A Warning status is shown if one or more of the access pools fail or the number of operational COS Slicestor nodes in the storage pool falls below the alert level. The alert level is configured in IBM Cloud Object Storage and is normally set slightly higher than the IDA write threshold value.

An Error status is shown if all of the access pools fail or the number of operational COS Slicestor nodes in the storage pool falls below the IDA threshold value.

Storage Pool

The name of the storage pool that the vault belongs to.

Used Capacity (GiB)

The capacity on the COS Slicestor nodes that is used to store the vault data. This value does not include capacity that is reserved for disk overhead and dispersal overhead.

The used capacity can exceed the hard quota if quota checking is not activated or is activated after the objects are stored in the vault.