# Class CIM_ConfigurationData
extends CIM_SettingData

Captures the configuration information of the element as an octet string (that is, a "blob"). The configuration data is element-specific and generalizes (for any element) the semantically similar Save/RestoreProperties methods that are currently defined as part of the LogicalDevice class. Various types of configurations can be instantiated for an element, such as a currently running config, a startup config, or other possible configurations. The configuration type is specified in the association of the instance to a ManagedElement using the properties of the ElementSettingData association: - When the configuration is currently running, then the IsCurrent Boolean of the association is true. - When the configuration is the initial or startup config, then the IsDefault Boolean is true. - If the IsCurrent and IsDefault Booleans are false, then the configuration is assumed to be a "possible" config (configuration workspace) for the element. Note: This class has an "apply" method only with no corresponding "extract". It has no extract because an application or client can query for and enumerate any existing configurations using existing CIM Operations. It is the responsibility of the client to reuse or reapply the configurations that are returned by such a request because the configuration data itself is opaque and element-specific. Only one "running" configuration can exist at any time. In addition, this configuration can be the only configuration reported by an element. However, elements can also have one "startup" configuration and can have multiple possible/workspace configurations. The configurations can be identical. For example, if a possible configuration is applied to an element (and therefore made the running/current configuration), then the two configs would be identical upon a subsequent query or enumerate instances request.

### Table of Contents
Hierarchy
Direct Known Subclasses
Class Qualifiers
Class Properties
Class Methods

## Class Hierarchy

CIM_ManagedElement
|
+--CIM_SettingData
|
+--CIM_ConfigurationData

## Direct Known Subclasses

## Class Qualifiers

Name | Data Type | Value
--- | --- | ---
Description | string | Captures the configuration information of the element as an octet string (that is, a "blob"). The configuration data is element-specific and generalizes (for any element) the semantically similar Save/RestoreProperties methods that are currently defined as part of the LogicalDevice class. Various types of configurations can be instantiated for an element, such as a currently running config, a startup config, or other possible configurations. The configuration type is specified in the association of the instance to a ManagedElement using the properties of the ElementSettingData association: - When the configuration is currently running, then the IsCurrent Boolean of the association is true. - When the configuration is the initial or startup config, then the IsDefault Boolean is true. - If the IsCurrent and IsDefault Booleans are false, then the configuration is assumed to be a "possible" config (configuration workspace) for the element. Note: This class has an "apply" method only with no corresponding "extract". It has no extract because an application or client can query for and enumerate any existing configurations using existing CIM Operations. It is the responsibility of the client to reuse or reapply the configurations that are returned by such a request because the configuration data itself is opaque and element-specific. Only one "running" configuration can exist at any time. In addition, this configuration can be the only configuration reported by an element. However, elements can also have one "startup" configuration and can have multiple possible/workspace configurations. The configurations can be identical. For example, if a possible configuration is applied to an element (and therefore made the running/current configuration), then the two configs would be identical upon a subsequent query or enumerate instances request.
Experimental | boolean | true
UMLPackagePath | string | CIM::Core::Settings
Version | string | 2.10.0

## Class Properties

### Local Class Properties

Name | Data Type | Default Value | Qualifiers
--- | --- | --- | ---
Name | Data Type | Value
ConfigurationTimestamp | datetime |
Description | string | The datetime when the configuration information was obtained.
Required | boolean | true
ConfigurationInformation | uint8[] |
Description | string | The configuration information stored as an octet string.
OctetString | boolean | true
Required | boolean | true

### Inherited Properties

Name | Data Type | Class Origin
--- | --- | ---
Caption | string | CIM_ManagedElement
ChangeableType | uint16 | CIM_SettingData
ConfigurationName | string | CIM_SettingData
Description | string | CIM_ManagedElement
ElementName | string | CIM_SettingData
Generation | uint64 | CIM_ManagedElement
InstanceID | string | CIM_SettingData
SoID | string | CIM_SettingData
SoOrgID | string | CIM_SettingData
ComponentSetting | string[] | CIM_SettingData

## Class Methods

### Local Class Methods

#### ApplyConfiguration (uint32)

#### Method Qualifiers (ApplyConfiguration)

Name | Data Type | Value
--- | --- | ---
Description | string | This method processes the configuration data for an element. In this case, the data in the ConfigurationInformation property of the instance is validated for the specified element (if the ValidateOnly parameter is true), or is actually set as a configuration on the element. If the method is successful, then the appropriate ElementSettingData associations are created or modified. Note: It is not necessary for the element to be associated with the ConfigurationData instance at the time that this method is called.
ValueMap | string | 0, 1, 2, 3, 4, 5, 6..15999, 16000, 16001, 16002, 16003, 16004, 16005, 16006..32767, 32768..65535
Values | string | Success, Not Supported, Unknown, Timeout, Failed, Invalid Parameter, DMTF Reserved, Validate Only Request Not Supported, Configuration Data Would Not Validate, Element Does Not Support Initial/Default Configs, Element Does Not Support Possible Configs/Config Workspaces, Element Does Not Support Setting of the Running/Current Config, Element Would Not Accept Configuration, Method Reserved, Vendor Specific

#### Method Parameters (ApplyConfiguration)

Name | Type | Qualifiers
--- | --- | ---
Name | Data Type | Value
TypeOfConfiguration | uint16
Description | string | The type of configuration information, indicating whether the ConfigurationInformation property holds an initial/default configuration, a running/current configuration, or a configuration for a temporary/ possible workspace. This information affects the values of the IsDefault and IsCurrent properties of the association, ElementSettingData.
IN | boolean | true
ValueMap | string | 2, 3, 4
Values | string | Running/Current Configuration, Initial/Default Configuration, Possible Configuration/Config Workspace
ValidateOnly | boolean
Description | string | Indicates that the request is to validate the format and syntax of the configuration data but not apply it to the referenced ManagedElement.
IN | boolean | true
ManagedElement | REF CIM_ManagedElement
Description | string | A reference to the ManagedElement whose configuration data is validated or applied. This reference is necessary because a configuration could apply to multiple elements simultaneously, but this processing request is more restrictive.
IN | boolean | true
Required | boolean | true