# Class CIM_TierService
extends CIM_Service

The TierService class provides methods to allow a client to manage storage tiers.

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

## Class Hierarchy

CIM_ManagedElement
|
+--CIM_ManagedSystemElement
|
+--CIM_LogicalElement
|
+--CIM_EnabledLogicalElement
|
+--CIM_Service
|
+--CIM_TierService

## Direct Known Subclasses

CIM_TierPolicyService

## Class Qualifiers

Name | Data Type | Value
--- | --- | ---
Description | string | The TierService class provides methods to allow a client to manage storage tiers.
Experimental | boolean | true
UMLPackagePath | string | CIM::Device::StorageServices
Version | string | 2.35.0

## Class Properties

### Inherited Properties

Name | Data Type | Class Origin
--- | --- | ---
Caption | string | CIM_ManagedElement
CommunicationStatus | uint16 | CIM_ManagedSystemElement
CreationClassName | string | CIM_Service
Description | string | CIM_ManagedElement
DetailedStatus | uint16 | CIM_ManagedSystemElement
ElementName | string | CIM_ManagedElement
EnabledDefault | uint16 | CIM_EnabledLogicalElement
EnabledState | uint16 | CIM_EnabledLogicalElement
Generation | uint64 | CIM_ManagedElement
HealthState | uint16 | CIM_ManagedSystemElement
InstallDate | datetime | CIM_ManagedSystemElement
InstanceID | string | CIM_ManagedElement
LoSID | string | CIM_Service
LoSOrgID | string | CIM_Service
Name | string | CIM_Service
OperatingStatus | uint16 | CIM_ManagedSystemElement
OtherEnabledState | string | CIM_EnabledLogicalElement
PrimaryOwnerContact | string | CIM_Service
PrimaryOwnerName | string | CIM_Service
PrimaryStatus | uint16 | CIM_ManagedSystemElement
RequestedState | uint16 | CIM_EnabledLogicalElement
Started | boolean | CIM_Service
StartMode | string | CIM_Service
Status | string | CIM_ManagedSystemElement
SystemCreationClassName | string | CIM_Service
SystemName | string | CIM_Service
TimeOfLastStateChange | datetime | CIM_EnabledLogicalElement
TransitioningToState | uint16 | CIM_EnabledLogicalElement
AvailableRequestedStates | uint16[] | CIM_EnabledLogicalElement
OperationalStatus | uint16[] | CIM_ManagedSystemElement
StatusDescriptions | string[] | CIM_ManagedSystemElement

## Class Methods

### Local Class Methods

#### CreateStorageTier (uint32)

#### Method Qualifiers (CreateStorageTier)

Name | Data Type | Value
--- | --- | ---
Description | string | Create a new storage tier based on supplied storage objects. For example, a storage tier based on all storage extents of a storage pool, i.e. ConcreteComponents, that utilize solid state technology. The more parameters specified, the narrower the criteria for selecting the storage objects.
ValueMap | string | 0, 1, 2, 3, 4, 5, 6, .., 4096, 4097..32767, 0x8000..
Values | string | Completed with No Error, Not Supported, Unknown, Timeout, Failed, Invalid Parameter, In Use, DMTF Reserved, Method Parameters Checked - Job Started, Method Reserved, Vendor Specific

#### Method Parameters (CreateStorageTier)

Name | Type | Qualifiers
--- | --- | ---
Name | Data Type | Value
ElementName | string
Description | string | A end user relevant name for created storage tier. If null, then a system supplied default name may be used.
IN | boolean | true
TierSettingData | string
Description | string | If provided, it overrides the default tier setting data that is used. For example, create a storage tier based on performance of underlying technology of components considered.
EmbeddedInstance | string | CIM_TierSettingData
IN | boolean | true
Members | CIM_LogicalElement[]
Description | string | List of elements to use to create a storage tier. If null, other specified parameters are considered, such as TierSettingData and Goal.
IN | boolean | true
TierDomain | CIM_AdminDomain[]
Description | string | Input: The created StorageTier to be associated to given array of TierDomains. If null, system associates created storage tier to a TierDomain and returns a reference to the TierDomain the system used.
IN | boolean | true
OUT | boolean | true
Goal | REF CIM_ManagedElement
Description | string | The Quality of Service per the properties of supplied StorageSetting.
IN | boolean | true
Job | REF CIM_ConcreteJob
Description | string | Reference to the job (may be NULL if job is completed).
IN | boolean | false
OUT | boolean | true
StorageTier | REF CIM_StorageTier
Description | string | Reference to the created StorageTier.
IN | boolean | false
OUT | boolean | true

#### DeleteStorageTier (uint32)

#### Method Qualifiers (DeleteStorageTier)

Name | Data Type | Value
--- | --- | ---
Description | string | Delete a storage tier. The storage objects associated to the storage tier are unaffected.
ValueMap | string | 0, 1, 2, 3, 4, 5, 6, .., 4096, 4097..32767, 0x8000..
Values | string | Completed with No Error, Not Supported, Unknown, Timeout, Failed, Invalid Parameter, In Use, DMTF Reserved, Method Parameters Checked - Job Started, Method Reserved, Vendor Specific

#### Method Parameters (DeleteStorageTier)

Name | Type | Qualifiers
--- | --- | ---
Name | Data Type | Value
Force | boolean
Description | string | The implementation may not allow a storage tier to be deleted if the storage tier is associated with underlying storage elements. In such situations specify "True" to force the deletion of the storage tier.
Experimental | boolean | true
IN | boolean | true
TierSettingData | string
Description | string | If provided, it overrides the default tier setting data that is used.
EmbeddedInstance | string | CIM_TierSettingData
IN | boolean | true
Job | REF CIM_ConcreteJob
Description | string | Reference to the job (may be NULL if job is completed).
IN | boolean | false
OUT | boolean | true
StorageTier | REF CIM_StorageTier
Description | string | Reference to StorageTier to delete.
IN | boolean | true

#### AddToStorageTier (uint32)

#### Method Qualifiers (AddToStorageTier)

Name | Data Type | Value
--- | --- | ---
Description | string | Add members, i.e. components, to a storage tier to expand the capacity of storage tier.
ValueMap | string | 0, 1, 2, 3, 4, 5, 6, .., 4096, 4097..32767, 0x8000..
Values | string | Completed with No Error, Not Supported, Unknown, Timeout, Failed, Invalid Parameter, In Use, DMTF Reserved, Method Parameters Checked - Job Started, Method Reserved, Vendor Specific

#### Method Parameters (AddToStorageTier)

Name | Type | Qualifiers
--- | --- | ---
Name | Data Type | Value
TierSettingData | string
Description | string | If provided, it overrides the default tier setting data that is used.
EmbeddedInstance | string | CIM_TierSettingData
IN | boolean | true
Members | CIM_LogicalElement[]
Description | string | List of elements to add to storage tier.
IN | boolean | true
Goal | REF CIM_ManagedElement
Description | string | The Quality of Service per the properties of supplied StorageSetting.
IN | boolean | true
Job | REF CIM_ConcreteJob
Description | string | Reference to the job (may be NULL if job is completed).
IN | boolean | false
OUT | boolean | true
StorageTier | REF CIM_StorageTier
Description | string | Reference to StorageTier to add to.
IN | boolean | true

#### RemoveFromStorageTier (uint32)

#### Method Qualifiers (RemoveFromStorageTier)

Name | Data Type | Value
--- | --- | ---
Description | string | Remove members, i.e. components, from a storage tier to reduce the capacity of storage tier.
ValueMap | string | 0, 1, 2, 3, 4, 5, 6, 7, 8, .., 0x8000..
Values | string | Completed with No Error, Not Supported, Unknown, Timeout, Failed, Invalid Parameter, In Use, DMTF Reserved, Method Parameters Checked - Job Started, Method Reserved, Vendor Specific

#### Method Parameters (RemoveFromStorageTier)

Name | Type | Qualifiers
--- | --- | ---
Name | Data Type | Value
TierSettingData | string
Description | string | If provided, it overrides the default tier setting data that is used.
EmbeddedInstance | string | CIM_TierSettingData
IN | boolean | true
Members | CIM_LogicalElement[]
Description | string | List of elements to remove from storage tier.
IN | boolean | true
Job | REF CIM_ConcreteJob
Description | string | Reference to the job (may be NULL if job is completed).
IN | boolean | false
OUT | boolean | true
StorageTier | REF CIM_StorageTier
Description | string | Reference to the StorageTier to remove from.
IN | boolean | true

#### CreateTierDomain (uint32)

#### Method Qualifiers (CreateTierDomain)

Name | Data Type | Value
--- | --- | ---
Description | string | Create a TierDomain and associate it to top-level ComputerSystem -- via SystemComponent association.
ValueMap | string | 0, 1, 2, 3, 4, 5, 6, .., 4096, 4097..32767, 0x8000..
Values | string | Completed with No Error, Not Supported, Unknown, Timeout, Failed, Invalid Parameter, In Use, DMTF Reserved, Method Parameters Checked - Job Started, Method Reserved, Vendor Specific

#### Method Parameters (CreateTierDomain)

Name | Type | Qualifiers
--- | --- | ---
Name | Data Type | Value
ElementName | string
Description | string | If nameable, an end user relevant name for the TierDomain. If null or not nameable, then system assigns a name.
IN | boolean | true
TierSettingData | string
Description | string | If provided, it overrides the default tier setting data that is used.
EmbeddedInstance | string | CIM_TierSettingData
IN | boolean | true
Job | REF CIM_ConcreteJob
Description | string | Reference to the job (may be NULL if job is completed).
IN | boolean | false
OUT | boolean | true
TierDomain | REF CIM_AdminDomain
Description | string | Reference to the created TierDomain.
IN | boolean | false
OUT | boolean | true

#### DeleteTierDomain (uint32)

#### Method Qualifiers (DeleteTierDomain)

Name | Data Type | Value
--- | --- | ---
Description | string | Delete an instance of TierDomain. If the Force parameter is true, the SystemComponents (i.e. StorageTier) of this domain that are not associated to another TierDomain will also be deleted.
ValueMap | string | 0, 1, 2, 3, 4, 5, 6, .., 4096, 4097..32767, 0x8000..
Values | string | Completed with No Error, Not Supported, Unknown, Timeout, Failed, Invalid Parameter, In Use, DMTF Reserved, Method Parameters Checked - Job Started, Method Reserved, Vendor Specific

#### Method Parameters (DeleteTierDomain)

Name | Type | Qualifiers
--- | --- | ---
Name | Data Type | Value
Force | boolean
Description | string | If true, delete a non-empty TierDomain and its associated StorageTiers, as long as the associated StorageTiers are not associated to other TierDomains; otherwise, return an error.
IN | boolean | true
Job | REF CIM_ConcreteJob
Description | string | Reference to the job (may be NULL if job is completed).
IN | boolean | false
OUT | boolean | true
TierDomain | REF CIM_AdminDomain
Description | string | Reference to TierDomain to delete.
IN | boolean | true

#### ModifyStorageTierDomainAssociation (uint32)

#### Method Qualifiers (ModifyStorageTierDomainAssociation)

Name | Data Type | Value
--- | --- | ---
Description | string | Modify a StorageTier association to a TierDomain. A StorageTier shall always be associated to at least one TierDomain. This call ensures a StorageTier's association to a TierDomain is maintained especially when a StorageTier 'moves' from one TierDomain to another TierDomain. By setting the parameter RemoveFromTierDomain to null and setting the parameter AddToTierDomain to a TierDomain, this call associates a StorageTier to additional TierDomains.
ValueMap | string | 0, 1, 2, 3, 4, 5, 6, .., 4096, 4097..32767, 0x8000..
Values | string | Completed with No Error, Not Supported, Unknown, Timeout, Failed, Invalid Parameter, In Use, DMTF Reserved, Method Parameters Checked - Job Started, Method Reserved, Vendor Specific

#### Method Parameters (ModifyStorageTierDomainAssociation)

Name | Type | Qualifiers
--- | --- | ---
Name | Data Type | Value
TierSettingData | string
Description | string | If provided, it overrides the default tier setting data that is used.
EmbeddedInstance | string | CIM_TierSettingData
IN | boolean | true
AddToTierDomain | REF CIM_AdminDomain
Description | string | Associate StorageTier to this TierDomain. If null, the association will not be added to an existing TierDomain.
IN | boolean | true
Job | REF CIM_ConcreteJob
Description | string | Reference to the job (may be NULL if job is completed).
IN | boolean | false
OUT | boolean | true
RemoveFromTierDomain | REF CIM_AdminDomain
Description | string | Remove StorageTier's association to this TierDomain.If null, the association will not be removed from an existing TierDomain.
IN | boolean | true
StorageTier | REF CIM_StorageTier
Description | string | Reference to the StorageTier to manipulate.
IN | boolean | true

#### GetStorageTierCandidateObjects (uint32)

#### Method Qualifiers (GetStorageTierCandidateObjects)

Name | Data Type | Value
--- | --- | ---
Description | string | This method returns an array of storage objects that can form a storage tier. The selection criteria is based on the input parameters. The more input parameters, the narrower the search criteria. For example, it is possible to specify to return the candidate storage objects based on all storage extents of a storage pool, i.e. ConcreteComponents, that utilize solid state technology by supplying the appropriate InPools and TierSettingData.
ValueMap | string | 0, 1, 2, 3, 4, 5, 6, .., 4096, 4097..32767, 0x8000..
Values | string | Completed with No Error, Not Supported, Unknown, Timeout, Failed, Invalid Parameter, In Use, DMTF Reserved, Method Parameters Checked - Job Started, Method Reserved, Vendor Specific

#### Method Parameters (GetStorageTierCandidateObjects)

Name | Type | Qualifiers
--- | --- | ---
Name | Data Type | Value
TierSettingData | string
Description | string | If provided, it overrides the default tier setting data that is used. For example, a storage tier based on performance of underlying technology of components considered.
EmbeddedInstance | string | CIM_TierSettingData
IN | boolean | true
Candidates | CIM_LogicalElement[]
Description | string | An array of storage objects that can form a storage tier.
IN | boolean | false
OUT | boolean | true
InElements | CIM_LogicalElement[]
Description | string | List of elements to consider. For example, a list of storage pools.
IN | boolean | true
Goal | REF CIM_ManagedElement
Description | string | The Quality of Service per the properties of supplied StorageSetting.
IN | boolean | true
Job | REF CIM_ConcreteJob
Description | string | Reference to the job (may be NULL if job is completed).
IN | boolean | false
OUT | boolean | true

### Inherited Class Methods

Name | Return Type | Class Origin
--- | --- | ---
ChangeAffectedElementsAssignedSequence | uint32 | CIM_Service
RequestStateChange | uint32 | CIM_EnabledLogicalElement
StartService | uint32 | CIM_Service
StopService | uint32 | CIM_Service