configConfMo メソッドの使用に関する注意事項

この付録は、次の項で構成されています。

configConfMo メソッドを使用した識別名の定義

configConfMo メソッドを使用して、管理対象オブジェクト（MO）の 1 つ以上のプロパティを設定します。設定する MO は識別名（DN）によって一意に識別されます。この章は、configConfMo メソッドを使用して DN を提供する 2 つの方法を示します。

管理対象オブジェクト レベル

管理対象オブジェクト レベルで DN を提供できます。次の例では、DN「sys/rack-unit-1/locator-led」が MO「equipmentLocatorLed」内に定義されます。 


<configConfMo
    cookie="<real_cookie>">
    <inConfig>
        <equipmentLocatorLed
            adminState='on'
            dn='sys/rack-unit-1/locator-led'>                          <== MO level
        </equipmentLocatorLed>
    </inConfig>
</configConfMo>

メソッドおよび管理対象オブジェクト レベル

メソッドおよび管理対象オブジェクト レベルで DN を提供できます。次の例では、DN「sys/rack-unit-1/locator-led」が、configConfMo メソッド レベルで MO「equipmentLocatorLed」内に定義されます。 


<configConfMo
    cookie="<real_cookie>"
    dn='sys/rack-unit-1/locator-led'>                                 <== Method level
    <inConfig>
        <equipmentLocatorLed
            adminState='on'
            dn='sys/rack-unit-1/locator-led'>                         <== MO Level
        </equipmentLocatorLed>
    </inConfig>
</configConfMo>

（注）  

メソッド レベルでの DN の指定はオプションで、Cisco UCS Manager XML API の実装と同一になるように Cisco IMC XML API の実装でサポートされます。

オプションの inHierarchical 属性の使用

configConfMo 要求が Cisco IMC に送信されると、応答には設定される MO の直接のプロパティだけが含まれます。

オプションの inHierarchical 属性が configConfMo 要求に含まれている場合、応答は true に設定された inHierarchical 属性を持つ configResolveDn 要求の応答と同様になります。応答には、設定される MO のプロパティとともに、その子 MO のプロパティがすべて含まれます。

要求: 


<configConfMo
    cookie="<real_cookie>"
    inHierarchical="true"
    dn='sys/rack-unit-1/locator-led'>
    <inConfig>
        <equipmentLocatorLed
            adminState='on'
            dn='sys/rack-unit-1/locator-led'>
        </equipmentLocatorLed>
    </inConfig>
</configConfMo>

応答： 


<configConfMo
    dn="sys/rack-unit-1/locator-led"
    cookie="<real_cookie>"
    response="yes">
    <outConfig>
        <equipmentLocatorLed
            dn="sys/rack-unit-1/locator-led"
            adminState="inactive"
            color="unknown"
            id="1"
            name=""
            operState="on">
        </equipmentLocatorLed>
    </outConfig>
</configConfMo>

1 つの管理対象オブジェクトの設定

Cisco IMC XML API 実装は、単一の管理対象オブジェクト（MO）に対して動作する configConfMo メソッドのみを受け入れます。Cisco IMC 管理情報モデルの包含関係で定義されている場合でも、複数の MO を含む configConfMo メソッドを指定することは無効です。

次に、単一の MO「lsbootLan」を構成する有効な configConfMo メソッドの例を示します。この例では、最初のブート オプションとして PXE 起動を使用するようにホストが構成されます。 


<configConfMo
    cookie="<real_cookie>">
    <inConfig>
        <lsbootLan                                             <== Single MO
            order="1"
            status="modified"
            dn="sys/rack-unit-1/boot-policy/lan" >
        </lsbootLan>
    </inConfig>
</configConfMo>

次の例の configConfMo メソッドは、親 MO と子 MO が同時に指定されているため無効です。「equipmentLocatorLed」および「solIf」の MO は、管理情報ツリー内の MO「computeRackUnit」の子オブジェクトです。Cisco IMC XML API の実装は configConfMo メソッドがサブツリーの設定を行うことを許可しません。

要求: 


<configConfMo 
    cookie="1313084260/40ea8058-aa3e-1a3e-8004-5e61c2e14388" 
    dn="sys/rack-unit-1" inHierarchical="false">
     <inConfig>
         <computeRackUnit                                       <== Parent MO
             adminPower="cycle-immediate" 
             usrLbl="Cisco C210 Server" 
             dn="sys/rack-unit-1">
                  <equipmentLocatorLed                          <== Child MO
                      adminState="on" 
                      dn="sys/rack-unit-1/locator-led"/>
                  <solIf                                        <== Child MO
                      dn="sys/rack-unit-1/solif" 
                      adminState="enable" 
                      speed="9600"/>
         </computeRackUnit>
      </inConfig>
</configConfMo>

応答： 


XML PARSING ERROR: Element 'equipmentLocatorLed': This element is not expected.

（注）  

このメソッドは、Cisco UCS Manager XML API の実装では有効ですが、Cisco IMC XML API の実装ではサポートされていません。