Cisco UCS ラックマウント サーバ CIMC XML API プログラマ ガイド
configConfMo メソッドの使用に関する注意事項
configConfMo メソッドの使用に関する注意事項
発行日;2013/01/24   |   ドキュメントご利用ガイド   |   ダウンロード ;   この章 pdf   ,   ドキュメント全体 pdf    |   フィードバック

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」が、MO「equipmentLocatorLed」内に configConfMo メソッド レベルで定義されます。

<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 CIMC XML API の実装でサポートされます。


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

configConfMo 要求が CIMC に送信されると、応答には設定される 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 つの管理対象オブジェクトの設定

リリース 1.4(1x) では、 Cisco CIMC XML API の実装は単一の管理対象オブジェクト(MO)上で動作する configConfMo メソッドだけを受け入れます。 CIMC 管理情報モデルの包含関係で定義されている場合でも、複数の 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 は、管理情報ツリーの「computeRackUnit」MO の子オブジェクトです。 Cisco CIMC 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 CIMC XML API の実装ではサポートされていません。