3.1.3.3 Cluster Registry Key Associated with an Object

Each cluster object, with the exception of cluster registry keys, is associated with a key in the cluster registry. The hierarchical name of the registry key, relative to the root key that is obtained by using the ApiGetRootKey (section 3.1.4.1.29) and the ApiGetRootKey (section 3.1.4.2.29) methods, MUST be as follows: a null-terminated Unicode string that is specific to the object type, followed by the Unicode character "\", followed by the object ID that is obtained by using the object appropriate method for obtaining the object's ID:

  • For resources, ApiGetResourceId (Opnum 14): section 3.1.4.1.15 for protocol version 2, and 3.1.4.2.15 for protocol version 3.0.

  • For groups, ApiGetGroupId (Opnum 47): section 3.1.4.1.48 for protocol version 2, and 3.1.4.2.48 for protocol version 3.0.

  • For nodes, ApiGetNodeId (Opnum 48): section 3.1.4.1.49 for protocol version 2, and 3.1.4.2.49 for protocol version 3.0.

  • For cluster networks, ApiGetNetworkId (Opnum 86): section 3.1.4.1.86 for protocol version 2, and 3.1.4.2.86 for protocol version 3.0.

  • For cluster network interfaces, ApiGetNetInterfaceId (Opnum 96): section 3.1.4.1.96 for protocol version 2, and 3.1.4.2.96 for protocol version 3.0.

For example, consider a resource with the following ID.

 "186cd9dc4fd84c728e3e-239d3719a5cf"

This resource has its non-volatile cluster state stored under the path represented by the following null-terminated Unicode string.

 "Resources"

This is followed by the Unicode character "\". Finally, the preceding strings are followed by the resource ID obtained by using the ApiGetResourceId method (see section 3.1.4.1.15 for ClusAPI Protocol version 2 and section 3.1.4.2.15 for ClusAPI Protocol version 3).

 "186cd9dc4fd84c728e3e-239d3719a5cf"

The private properties of an object MUST be stored in the cluster registry in a key whose parent key is the key that is associated with the object (as specified in the introductory paragraph in this section) and whose name is the null-terminated Unicode string "Parameters". For each private property, the private property data MUST be accessible via the cluster registry as a value under the object's "Parameters" key.

Show: