CIM_StorageExtent class (Hyper-V management)

  • Article

Describes the capabilities and management of media that stores data and allows retrieval of the data. This super class is used to represent software and hardware RAID components, or a raw logical extent of physical media.

Syntax

[Abstract, Version("2.13.0"), UMLPackagePath("CIM::Core::StorageExtent"), AMENDMENT]
class CIM_StorageExtent : CIM_LogicalDevice
{
  uint16  DataOrganization;
  string  Purpose;
  uint16  Access;
  string  ErrorMethodology;
  uint64  BlockSize;
  uint64  NumberOfBlocks;
  uint64  ConsumableBlocks;
  boolean IsBasedOnUnderlyingRedundancy;
  boolean SequentialAccess;
  uint16  ExtentStatus[];
  boolean NoSinglePointOfFailure;
  uint16  DataRedundancy;
  uint16  PackageRedundancy;
  uint8   DeltaReservation;
  boolean Primordial = FALSE;
  string  Name;
  uint16  NameFormat;
  uint16  NameNamespace;
  string  OtherNameNamespace;
  string  OtherNameFormat;
};

Members

The CIM_StorageExtent class has these types of members:

Properties

The CIM_StorageExtent class has these properties.

Access

Data type: uint16

Access type: Read-only

A description of the read/write support of the media.

Unknown (0)

Readable (1)

Writeable (2)

Read/Write Supported (3)

Write Once (4)

BlockSize

Data type: uint64

Access type: Read-only

Qualifiers: Units ("Bytes"), MappingStrings ("MIF.DMTF|Host Storage|001.4", "MIB.IETF|HOST-RESOURCES-MIB.hrStorageAllocationUnits", "MIF.DMTF|Storage Devices|001.5")

The size, in bytes, of the blocks that form the storage extent. If variable block sizes are used, then this property should specify the maximum block size. If the block size is unknown or if a block concept is not valid (for example, for CIM_AggregateExtent, CIM_Memory or CIM_LogicalDisk), then this property should be set to "1" (unknow).

ConsumableBlocks

Data type: uint64

Access type: Read-only

The maximum number of blocks, that are available for use when layering CIM_StorageExtent using the CIM_BasedOn class association. This property only has meaning when the storage extent is referenced in the Antecedent property in a CIM_BasedOn object.

DataOrganization

Data type: uint16

Access type: Read-only

The type of data organization used by the media.

Other (0)

Unknown (1)

Fixed Block (2)

Variable Block (3)

Count Key Data (4)

DataRedundancy

Data type: uint16

Access type: Read-only

Qualifiers: ModelCorrespondence ("CIM_StorageSetting.DataRedundancyGoal", "CIM_StorageSetting.DataRedundancyMax", "CIM_StorageSetting.DataRedundancyMin")

The number of complete copies of data that are currently maintained.

DeltaReservation

Data type: uint8

Access type: Read-only

Qualifiers: Units ("Percentage"), MinValue (1), MaxValue (100), ModelCorrespondence ("CIM_StorageSetting.DeltaReservationGoal", "CIM_StorageSetting.DeltaReservationMax", "CIM_StorageSetting.DeltaReservationMin")

The current value for delta reservation. This is a percentage that specifies the amount of space that should be reserved in a replica for caching changes.

ErrorMethodology

Data type: string

Access type: Read-only

The type of error detection and correction supported by the storage extent.

ExtentStatus

Data type: uint16 array

Access type: Read-only

Additional status information.

Other (0)

Unknown (1)

None/Not Applicable (2)

Broken (3)

Data Lost (4)

Dynamic Reconfig (5)

Exposed (6)

Fractionally Exposed (7)

Partially Exposed (8)

Protection Disabled (9)

Readying (10)

Rebuild (11)

Recalculate (12)

Spare in Use (13)

Verify In Progress (14)

In-Band Access Granted (15)

Imported (16)

Exported (17)

DMTF Reserved (18..32767)

Vendor Reserved (32768..65535)

IsBasedOnUnderlyingRedundancy

Data type: boolean

Access type: Read-only

true if the underlying storage extents are members of a CIM_StorageRedundancyGroup; otherwise, false.

Name

Data type: string

Access type: Read-only

Qualifiers: Override ("Name"), MappingStrings ("SPC.INCITS-T10| VPD 83, Association 0 | Identifier"), ModelCorrespondence ("CIM_StorageExtent.NameFormat", "CIM_StorageExtent.NameNamespace")

A unique identifier for the storage extent. The NameFormat property specifies the naming format to use in the Name property.

NameFormat

Data type: uint16

Access type: Read-only

Qualifiers: ModelCorrespondence ("CIM_StorageExtent.Name", "CIM_StorageExtent.NameNamespace", "CIM_StorageExtent.OtherNameFormat")

The naming format for the Name property.

Unknown (0)

Other (1)

VPD83NAA6 (2)

VPD83NAA5 (3)

VPD83Type2 (4)

VPD83Type1 (5)

VPD83Type0 (6)

SNVM (7)

NodeWWN (8)

NAA (9)

EUI64 (10)

T10VID (11)

OS Device Name (12)

NameNamespace

Data type: uint16

Access type: Read-only

Qualifiers: MappingStrings ("SPC.INCITS-T10| VPD 83, Association 0 | Identifier"), ModelCorrespondence ("CIM_StorageExtent.Name", "CIM_StorageExtent.OtherNameNamespace", "CIM_StorageExtent.NameFormat")

The namespace of the name property.

Unknown (0)

Other (1)

VPD83Type3 (2)

VPD83Type2 (3)

VPD83Type1 (4)

VPD80 (5)

NodeWWN (6)

SNVM (7)

OS Device Namespace (8)

NoSinglePointOfFailure

Data type: boolean

Access type: Read-only

Qualifiers: ModelCorrespondence ("CIM_StorageSetting.NoSinglePointOfFailure")

true if there are not any single points of failure; otherwise, false.

NumberOfBlocks

Data type: uint64

Access type: Read-only

Qualifiers: MappingStrings ("MIF.DMTF|Host Storage|001.5", "MIB.IETF|HOST-RESOURCES-MIB.hrStorageSize")

The total number of logically contiguous blocks that form the storage extent. The total size of the storage extent is calculated by multiplying BlockSize by NumberOfBlocks. If the BlockSize is "1", this property is the total size of the storage extent.

OtherNameFormat

Data type: string

Access type: Read-only

Qualifiers: ModelCorrespondence ("CIM_StorageExtent.NameFormat")

The format of the Name property when the NameFormat property is set to "1" (Other).

OtherNameNamespace

Data type: string

Access type: Read-only

Qualifiers: ModelCorrespondence ("CIM_StorageExtent.NameNamespace")

A description of the namespace of the Name property when the NameNamespace property is set to "1" (Other).

PackageRedundancy

Data type: uint16

Access type: Read-only

Qualifiers: ModelCorrespondence ("CIM_StorageSetting.PackageRedundancyGoal", "CIM_StorageSetting.PackageRedundancyMax", "CIM_StorageSetting.PackageRedundancyMin")

The current number of physical packages that can fail without data loss. For example, in a storage domain, this might be the number of disk spindles.

Primordial

Data type: boolean

Access type: Read-only

true if the storage extent is primordial; otherwise, false.

Purpose

Data type: string

Access type: Read-only

Qualifiers: MappingStrings ("MIB.IETF|HOST-RESOURCES-MIB.hrStorageDescr")

A description of the media usage.

SequentialAccess

Data type: boolean

Access type: Read-only

true if storage is sequentially accessed by a CIM_MediaAccessDevice object; otherwise, false.

Requirements

Requirement Value
Minimum supported client
 Windows 8
Minimum supported server
 Windows Server 2012
Namespace
 Root\virtualization\v2
MOF
WindowsVirtualization.V2.mof
DLL
Vmms.exe

See also

CIM_LogicalDevice