For each metadata item in a data system, there is an actual value that the offering is able to achieve at this time, as shown in Table 118.
cdmi_sanitization_ method
JSON String
If this data system metadata item is present and not an empty string, it indicates that the client is requesting that the system use a specific sanitization method to delete data such that the data is unrecoverable after an update or delete operation. Supported sanitization method values are provided by the cdmi_sanitization_method capability.
When this data system metadata item is absent, this data system metadata item shall not be used.
If this data system metadata item is present but does not contain a valid sanitization method string, the system is free to choose to ignore the data system metadata, to fail with an HTTP status code of 400 Bad Request, or to select a sanitization method of the system's choice.
Supported sanitization methods are defined as system- specific strings.
Optional
cdmi_RPO JSON
String
If this data system metadata item is present and set to a positive numeric string, it indicates that the client is requesting a largest acceptable duration in time between an update or create and when the object may be recovered, specified in seconds. This metadata is used to indicate the desired backup frequency from the primary copy or copies of the data to the secondary copy or copies. It is the maximum acceptable time period before a failure or disaster during which changes to data may be lost as a consequence of recovery. When this data system metadata item is absent, or is present and is not set to a positive numeric string, this data system metadata item shall not be used.
Optional
cdmi_RTO JSON
String
If this data system metadata item is present and set to a positive numeric string, it indicates that the client is requesting the largest acceptable duration in time to restore data, specified in seconds. This metadata is used to indicate the desired maximum acceptable duration to restore the primary copy or copies of the data from a secondary backup copy or copies. When this data system metadata item is absent, or is present and is not set to a positive numeric string, this data system metadata item shall not be used.
Optional
Table 118 - Provided Values of Data Systems Metadata Items (Sheet 1 of 2)
Metadata Name Type Description Requirement
cdmi_data_redundancy_provided JSON
String
Contains the current number of complete copies of the data object at this time
Optional
cdmi_immediate_redundancy_provided JSON String
If present and set to "true", indicates if immediate redundancy is provided for the object
Optional
Table 117 - Data System Metadata (Sheet 6 of 6)
Metadata Name Type Description Requirement
241
242 243
cdmi_infrastructure_redundancy_provided JSON String
Contains the current number of independent storage infrastructures supporting the data currently operating.
Optional
cdmi_data_dispersion_provided JSON
String
Contains the current lowest distance (km) between any two infrastructures hosting the data
Optional
cdmi_geographic_placement_provided JSON Array of JSON Strings
Contains an ISO-3166 identifier that corresponds to a geopolitical region where the object is stored
Optional
cdmi_retention_period_provided JSON String
Contains an ISO 8601:2004 time interval (as described in 5.14) specifying the period the object is protected by retention
Optional
cdmi_retention_autodelete_provided JSON String
Contains "true" if the object will automatically be deleted when retention expires Optional cdmi_hold_id_provided JSON Array of JSON Strings
Contains the user-specified hold identifiers for active holds
Optional
cdmi_encryption_provided JSON
String
Contains the algorithm used for encryption, the mode of operation, and the key size. (See cdmi_encryption in
Table 117 for the format.)
Optional
cdmi_value_hash_provided JSON
String
Contains the algorithm and length being used to hash the object value
Optional
cdmi_latency_provided JSON
String
Contains the provided maximum time to first byte
Optional
cdmi_throughput_provided JSON
String
Contains the provided maximum data rate on retrieve
Optional
cdmi_sanitization_method_provided JSON String
Contains the sanitization method used Optional
cdmi_RPO_provided JSON
String
Contains the provided duration, in seconds, between an update and when the update may be recovered
Optional
cdmi_RTO_provided JSON
String
Contains the provided duration, in seconds, to restore data
Optional
Table 118 - Provided Values of Data Systems Metadata Items (Sheet 2 of 2)
17 Retention and Hold Management
17.1
Introduction
A cloud storage system may optionally implement retention management disciplines into the system management functionality of the cloud-based storage system. The implementation of retention and hold capabilities is indicated by the presence of the cloud storage system-wide capabilities for retention and hold capabilities.
Retention management includes implementing a retention policy, defining a hold policy to enable objects to be held for specific purposes (e.g., litigation), and defining how the rules for deleting objects are affected by placing either a retention policy and/or a hold on an object. CDMI™ object deletion is not a capability of retention management, per se, but rather is a general system capability. However, this clause describes what happens when placing either a retention policy and/or a hold on an object.
Retention management may be applied to the following object types: • data objects,
• queue objects, and • container objects.