element <key> (local)
Namespace:
http://schemas.microsoft.com/hs/2001/10/core
Type:
anonymous complexType
Content:
empty, 3 attributes
Defined:
locally within requestType complexType in hsinfra.xsd; see XML source
Includes:
definitions of 3 attributes
XML Representation Summary
<key
   
 = 
xsd:string
 = 
xsd:string
 = 
xsd:string
/>
Included in content model of elements (1):
request
Annotation
This element specifies key information used to zoom in on the document being manipulated. This information includes the PUID that owns the document, the instance ID of the document, and the cluster or partition key used to locate the machine resources that hold the document. <p/> In certain situations, a client will want to send the same message to a number a instances of a particular service. To do this, the client can repeat this element multiple times. The <b>cluster</b> attributes in all elements must match each other, but the <b>puid</b> and <b>instance</b> attributes may differ. A unique response message is generated for each key specified. <p/> The entire contents of this element come from the .NET Services service.
XML Source (see within schema source)
<xsd:element maxOccurs="100" minOccurs="1" name="key">
<xsd:annotation>
<xsd:documentation>
This element specifies key information used to zoom in on the document being manipulated.
This information includes the PUID that owns the document, the instance ID of the document,
and the cluster or partition key used to locate the machine resources that hold the document.
<p/>
In certain situations, a client will want to send the same message to a number a instances of a particular
service. To do this, the client can repeat this element multiple times. The
<b>cluster</b>
attributes in all elements must match each other, but the
<b>puid</b>
and
<b>instance</b>
attributes may differ. A
unique response message is generated for each key specified.
<p/>
The entire contents of this element come from the .NET Services service.
</xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:attribute name="puid" type="puidType" use="required">
<xsd:annotation>
<xsd:documentation>
This element specifies the PUID of the entity that "owns" the service being accessed.
<!-- In
the case of a .NET Address service, this element is equivalent to the "my".-->
</xsd:documentation>
</xsd:annotation>
</xsd:attribute>
<xsd:attribute name="instance" type="string" use="required">
<xsd:annotation>
<xsd:documentation>
This element specifies the particular instance of the service for the ID being accessed.
For example, if a given ID is provisioned with multiple .NET Calendar documents on the same
cluster and in the same data center, the documents would differ only by this value.
</xsd:documentation>
</xsd:annotation>
</xsd:attribute>
<xsd:attribute name="cluster" type="string" use="required">
<xsd:annotation>
<xsd:documentation>
This element specifies information used by the .NET My Services system to locate the document on
a particular back-end server or database. It is used as the virtual partition key for the
document being addressed. This technique is preferable to computing this partition key based
on some hash of the
<b>puid</b>
/
<b>instance</b>
.
</xsd:documentation>
</xsd:annotation>
</xsd:attribute>
</xsd:complexType>
</xsd:element>
Attribute Detail (all declarations; 3/3)
cluster
Type:
string
Use:
required
Defined:
locally within (this) key element
This element specifies information used by the .NET My Services system to locate the document on a particular back-end server or database. It is used as the virtual partition key for the document being addressed. This technique is preferable to computing this partition key based on some hash of the <b>puid</b>/<b>instance</b>.
XML Source (see within schema source)
<xsd:attribute name="cluster" type="string" use="required">
<xsd:annotation>
<xsd:documentation>
This element specifies information used by the .NET My Services system to locate the document on
a particular back-end server or database. It is used as the virtual partition key for the
document being addressed. This technique is preferable to computing this partition key based
on some hash of the
<b>puid</b>
/
<b>instance</b>
.
</xsd:documentation>
</xsd:annotation>
</xsd:attribute>
instance
Type:
string
Use:
required
Defined:
locally within (this) key element
This element specifies the particular instance of the service for the ID being accessed. For example, if a given ID is provisioned with multiple .NET Calendar documents on the same cluster and in the same data center, the documents would differ only by this value.
XML Source (see within schema source)
<xsd:attribute name="instance" type="string" use="required">
<xsd:annotation>
<xsd:documentation>
This element specifies the particular instance of the service for the ID being accessed.
For example, if a given ID is provisioned with multiple .NET Calendar documents on the same
cluster and in the same data center, the documents would differ only by this value.
</xsd:documentation>
</xsd:annotation>
</xsd:attribute>
puid
Type:
puidType
Use:
required
Defined:
locally within (this) key element
This element specifies the PUID of the entity that "owns" the service being accessed.
XML Source (see within schema source)
<xsd:attribute name="puid" type="puidType" use="required">
<xsd:annotation>
<xsd:documentation>
This element specifies the PUID of the entity that "owns" the service being accessed.
<!-- In
the case of a .NET Address service, this element is equivalent to the "my".-->
</xsd:documentation>
</xsd:annotation>
</xsd:attribute>