- はじめに
- 概要
- AaaApp サービス
- AclApp サービス
- ClusterApp サービス
- CollectorApp サービス
- CollectorExtendedApp サービス
- ConfigTemplateApp サービス
- ConfigArchiveApp サービス
- ConfigDeliveryApp サービス
- DaiApp サービス
- DataPurgingApp サービス
- DeviceGroupApp サービス
- DeviceListApp サービス
- DhcpSnoopingApp サービス
- Dot1xApp サービス
- EtherChannelApp サービス
- EventApp サービス
- FabricPathResourcesApp サービス
- FabricPathTopologyApp サービス
- FcApp サービス
- FcoeApp サービス
- FeatureSetApp サービス
- FexApp サービス
- FipSnoopingApp サービス
- GlbpApp サービス
- HsrpApp サービス
- IgmpSnoopingApp サービス
- ImageInstallApp サービス
- InterfacesApp サービス
- InventoryApp サービス
- IpSourceGuardApp サービス
- KeyChainApp サービス
- Interface L2IsisApp サービス
- LicensingApp サービス
- LogApp サービス
- LstApp サービス
- NacLpIpApp サービス
- ObjectGroupApp サービス
- ObjectTrackingApp サービス
- PollerApp サービス
- PortProfileApp サービス
- PortSecurityApp サービス
- RbacApp サービス
- RepositoryApp サービス
- SecurityApp サービス
- ServerAdminApp サービス
- ServerApp サービス
- SoftwareApp サービス
- SpanApp サービス
- StpApp サービス
- SvsConnectionApp サービス
- SvsDomainApp サービス
- ThresholdActionApp サービス
- TrafficStormControlApp サービス
- TunnelApp サービス
- UserApp サービス
- VdcApp サービス
- VlanApp サービス
- VpcApp サービス
- VrfApp サービス
Cisco DCNM Web サービス API ガイド リリース 5.1(1a)
偏向のない言語
この製品のマニュアルセットは、偏向のない言語を使用するように配慮されています。このマニュアルセットでの偏向のない言語とは、年齢、障害、性別、人種的アイデンティティ、民族的アイデンティティ、性的指向、社会経済的地位、およびインターセクショナリティに基づく差別を意味しない言語として定義されています。製品ソフトウェアのユーザーインターフェイスにハードコードされている言語、RFP のドキュメントに基づいて使用されている言語、または参照されているサードパーティ製品で使用されている言語によりドキュメントに例外が存在する場合があります。シスコのインクルーシブランゲージに対する取り組みの詳細は、こちらをご覧ください。
翻訳について
このドキュメントは、米国シスコ発行ドキュメントの参考和訳です。リンク情報につきましては、日本語版掲載時点で、英語版にアップデートがあり、リンク先のページが移動/変更されている場合がありますことをご了承ください。あくまでも参考和訳となりますので、正式な内容については米国サイトのドキュメントを参照ください。
- Updated:
- 2017年8月2日
章のタイトル： InterfacesApp サービス
- InterfacesApp サービスについて
- createLoopbackNetworkInterfaces
- createRoutedSubNetworkInterfaces
- createVirtualSwitchedNetworkInterfaces
- createVlanNetworkInterfaces
- deleteLogicalNetworkInterfaces
- disableLldpService
- disableSviService
- disableUdldService
- enableLldpService
- enableSviService
- enableUdldService
- fetchCurrentTransceiverStatusForPorts
- getAclAssociations
- getActiveRoutedPortsCountInNetworkElement
- getActiveSwitchedPortsCountInNetworkElement
- getAdminDownRoutedPortsCountInNetworkElement
- getAdminDownSwitchedPortsCountInNetworkElement
- getAllFibreChannelInterfacesInNetworkElement
- getAllInterfacesInNetworkElement
- getAllMgmtInterfaces
- getAllVirtualEthernetPorts
- getControlInterfaces
- getErrorDetectionSettings
- getErrorRecoverySettings
- getIpAclAssociationsForNetworkInterface
- getLldpGlobalSetting
- getLldpSettingsForNetworkInterface
- getLogicalInterfacesInNetworkElement
- getLoopbackInterfacesInNetworkElement
- getMacAclAssociationsForNetworkInterface
- getMgmtInterfaces
- getMissingPortGroupMembers
- getNetworkInterfaces
- getNetworkInterfacesByName
- getNetworkInterfaceSettings
- getOperDownRoutedPortsCountInNetworkElement
- getOperDownSwitchedPortsCountInNetworkElement
- getPortsInCards
- getPortsInModule
- getPortsInNetworkElement
- getPortStatusSummary
- getPortsWithErrorVlanAssociations
- getPortsWithFabricPortStatusAssociations
- getPortsWithLogicalIntfAssociation
- getPortsWithLsgAssociations
- getPortsWithPortChannelAssociations
- getPortsWithSecurityAssociations
- getPortsWithSpanAssocations
- getPortsWithVlanAssociations
- getPortUsedForDiscovery
- getRoutedPortsInModule
- getRoutedPortsInNetworkElement
- getRoutedPortsWithSecurityAssociations
- getRoutedSubNetworkInterfacesInNetworkElement
- getSubInterfacesForRoutedNetworkInterface
- getSviServiceStateForNetworkElements
- getSvsVirtualEthGlobalSetting
- getSwicthedPortsCountInModule
- getSwitchedPortsInModule
- getSwitchedPortsInModuleByMode
- getSwitchedPortsInNetworkElement
- getSwitchedPortsWithSecurityAssociations
- getSystemDefaultSettings
- getTotalPortsCountInNetworkElement
- getTotalRoutedPortsCountInNetworkElement
- getTotalSwitchedPortsCountInNetworkElement
- getTunnelInterfacesInNetworkElement
- getUdldServiceStateForNetworkElements
- getVirtualEthernetPortsInNetworkElement
- getVirtualPortsInCard
- getVirtualPortsInVirtualComputerSystem
- getVirtualPortsWithNoCardAssoc
- getVlanNetworkInterfacesInNetworkElement
- modifyAdminStateForNetworkInterfaces
- modifyErrorDetectionSettingInNetworkElement
- modifyErrorRecoverySettingInNetworkElement
- modifyNetworkInterfaces
- modifyNetworkInterfaceSetting
- modifyPortModeToRouted
- modifyPortModeToSwitched
- modifyRoutedSubNetworkInterfaces
- modifySvsVethGlobalSettingInNetworkElement
- modifySwitchPortMode
- modifySystemDefaultSetting
InterfacesApp サービス
この章では、DCNM Web サービスの、InterfacesApp サービスに対応する API メソッドについて説明します。
InterfacesApp サービスについて
createLoopbackNetworkInterfaces
ネットワーク要素に 1 つまたは複数のループバック インターフェイス オブジェクトを作成します。
ValidationException は、次のいずれかの状況が発生した場合にスローされます。
•
neInstanceNameId がネットワーク要素の有効な InstanceNameId ではない場合。
• loopBackIns がヌルの場合、またはこのコレクションが空の場合。
• loopBackIns に 1 つまたは複数のヌル要素が含まれる場合、またはこのコレクションに LoopBackNetworkInterface タイプではないオブジェクトが含まれる場合。
PropertiesException は、次のいずれかの状況が発生した場合にスローされます。
• loopBackIns コレクションで、LoopBackNetworkInterface アトリビュートが有効ではない場合。
neInstanceNameId：ネットワーク要素のインスタンス名 ID。
createRoutedSubNetworkInterfaces
ルーテッド物理インターフェイスに対し 1 つまたは複数のルーテッド サブインターフェイス オブジェクトを作成します。
ValidationException は、次のいずれかの状況が発生した場合にスローされます。
• niId が有効な InstanceNameId ではない場合。
• subInfs がヌルの場合、またはこのコレクションが空の場合。
• subInfs に 1 つまたは複数のヌル要素が含まれる場合、またはこのコレクションに RoutedSubNetworkInterface タイプではないオブジェクトが含まれる場合。
• InstanceNameId に対応するオブジェクトがデータベースに存在しない場合。
• カプセル化 VLAN（Vlan）アソシエーションを作成せずに、インターフェイスに IP アドレス（Ipv4AddressPrefix）を設定しようとした場合。
• 設定対象の IP アドレス（Ipv4AddressPrefix）が、デバイスに存在する他のレイヤ 3 インターフェイスのプライマリまたはセカンダリ IP アドレスと重複する場合。
• 設定対象のカプセル化 VLAN（Vlan）が使用できない場合、または他のインターフェイスですでに使用されている場合。
• カプセル化 VLAN を指定せずに、カプセル化方式（SubInterfaceEncapsulationType）を設定した場合。
PropertiesException は、次のいずれかの状況が発生した場合にスローされます。
• subInfs コレクションで、RoutedSubNetworkInterface アトリビュートが有効ではない場合。
networkInterfaceInstanceNameIds：ネットワーク インターフェイスの InstanceNameId のリスト。
niId：RoutedNetworkInterface のインスタンス名 ID。
createVirtualSwitchedNetworkInterfaces
ネットワーク要素に 1 つまたは複数の仮想スイッチド インターフェイス オブジェクトを作成します。
ValidationException は、次のいずれかの状況が発生した場合にスローされます。
• neInstanceNameId がネットワーク要素の有効な InstanceNameId ではない場合。
• vsnifs がヌルの場合、またはこのコレクションが空の場合。
• vsnifs に 1 つまたは複数のヌル要素が含まれる場合、またはこのコレクションに VirtualSwitchedNetworkInterface タイプではないオブジェクトが含まれる場合。
PropertiesException は、次のいずれかの状況が発生した場合にスローされます。
• vsnifs コレクションで、VirtualSwitchedNetworkInterface アトリビュートが有効ではない場合。
createVlanNetworkInterfaces
ネットワーク要素に 1 つまたは複数の VLAN インターフェイス（SVI）オブジェクトを作成します。
ValidationException は、次のいずれかの状況が発生した場合にスローされます。
• neInstanceNameId がネットワーク要素の有効な InstanceNameId ではない場合。
• vlanIns がヌルの場合、またはこのコレクションが空の場合。
• vlanIns に 1 つまたは複数のヌル要素が含まれる場合、またはこのコレクションに VlanNetworkInterface タイプではないオブジェクトが含まれる場合。
PropertiesException は、次のいずれかの状況が発生した場合にスローされます。
• vlanIns コレクションで、VlanNetworkInterface アトリビュートが有効ではない場合。
deleteLogicalNetworkInterfaces
1 つまたは複数の既存のレイヤ 3 論理ネットワーク インターフェイス オブジェクトを削除します。このメソッドは、次の論理インターフェイスに対して使用できます。
ValidationException は、次のいずれかの状況が発生した場合にスローされます。
• niInstanceNameIds コレクションがヌル、または空の場合。
• niInstanceNameIds コレクションに、IpNetworkInterface InstanceNameId タイプではない要素が含まれる場合。
• niInstanceNameIds コレクションに、データベースに存在しない NetworkInterface が含まれる場合。
disableLldpService
デバイスの LldpService をディセーブルにします。1 つまたは複数のネットワーク要素のインスタンス名 ID を指定すると、それらの要素で lldp がディセーブルになります。
ValidationException は、次のいずれかの状況が発生した場合にスローされます。
• neInstanceNameIdCol がヌルまたは空の場合、あるいはタイプ InstanceNameId ではない場合。
• neInstanceNameIdCol が有効な AbstractNetworkElement の InstanceNameId ではない場合。
neInstanceNameIdCol：lldp をディセーブルにする AbstractNetworkElement の InstanceNameId のリスト。
disableSviService
指定したデバイス ID に関連する SVI サービスをディセーブルにします。
ValidationException は、次のいずれかの状況が発生した場合にスローされます。
• neInstanceNameIdCol コレクションが空の場合、またはこのコレクションに、ネットワーク要素の有効な InstanceNameId ではないオブジェクトが含まれる場合。
disableUdldService
指定したデバイス ID に関連する UDLD サービスをディセーブルにします。
ValidationException は、次のいずれかの状況が発生した場合にスローされます。
• neInstanceNameIdCol が有効な AbstractNetworkElement の InstanceNameId ではない場合。
enableLldpService
デバイスの LldpService をイネーブルにします。1 つまたは複数のネットワーク要素のインスタンス名 ID を指定すると、それらの要素で lldp がイネーブルになります。この API は、デバイスで「lldp 機能」オプションをグローバルにイネーブルにするための API です。
ValidationException は、次のいずれかの状況が発生した場合にスローされます。
• neInstanceNameIdCol がヌルまたは空の場合、あるいはタイプ InstanceNameId ではない場合。
• neInstanceNameIdCol が有効な AbstractNetworkElement の InstanceNameId ではない場合。
neInstanceNameIdCol：AbstractNetworkElement の InstanceNameId のリスト。
enableSviService
指定したデバイス ID に関連する SVI サービスをイネーブルにします。
ValidationException は、次のいずれかの状況が発生した場合にスローされます。
• neInstanceNameIdCol コレクションが空の場合、またはこのコレクションに、ネットワーク要素の有効な InstanceNameId ではないオブジェクトが含まれる場合。
enableUdldService
指定したデバイス ID に関連する UDLD サービスをイネーブルにします。
ValidationException は、次のいずれかの状況が発生した場合にスローされます。
• neInstanceNameIdCol コレクションが空の場合、またはこのコレクションに、ネットワーク要素の有効な InstanceNameId ではないオブジェクトが含まれる場合。
fetchCurrentTransceiverStatusForPorts
すべてのトランシーバ ステータス アソシエーションを読み込んだネットワーク インターフェイス オブジェクトのリストを戻します。
ValidationException は、渡された引数がヌルの場合、または有効なネットワーク インターフェイス要素 InstanceNameId ではない場合にスローされます。
ifInstanceNameIdCol：NetworkInterface に対応する InstanceNameId
セキュリティ アソシエーションを読み込んだ NetworkInterface インスタンスのリスト。
インターフェイスごとに次のアソシエーションが読み込まれます（指定したインターフェイスに対しアソシエーションが存在する場合）。
getAclAssociations
指定したインターフェイス オブジェクトに対応する ACL アソシエーション オブジェクトのインターフェイスのコレクションを戻します。
ValidationException は、次のいずれかの状況が発生した場合にスローされます。
• vlanInstanceNameId に無効な VLAN InstanceNameId またはヌル値が含まれている場合。
• vlanInstanceNameId に特定の InstanceNameId がある同等の VLAN オブジェクトがない場合。
neInstanceNameIds：ネットワーク要素に対応する InstanceNameId。
指定したネットワーク インターフェイスに関連付けられている AclAppliesToNetworkInterface オブジェクトのセット。
次のオブジェクトが AclAppliesToNetworkInterface アソシエーションの他のエンドで読み込まれます。
getActiveRoutedPortsCountInNetworkElement
デバイスに存在するアクティブ ルーテッド ポートの数を戻します。
ValidationException は、次のいずれかの状況が発生した場合にスローされます。
• mstInstanceNameIds がヌル、または空の場合。
• mstInstanceNameIds に無効な MstSetting InstanceNameId またはヌル値が含まれている場合。
• mstInstanceNameIds に特定の InstanceNameId がある同等の MstSetting オブジェクトがない場合。
getActiveSwitchedPortsCountInNetworkElement
デバイスに存在する、指定したスイッチ ポート モードのアクティブ スイッチド ポートの数を戻します。
ValidationException は、次のいずれかの状況が発生した場合にスローされます。
• neInstanceNameId がヌルまたはネットワーク要素の有効な InstanceNameId ではない場合。
neInstanceNameId：ネットワーク要素に対応する InstanceNameId
getAdminDownRoutedPortsCountInNetworkElement
デバイスに存在する管理上ダウン状態のルーテッド ポートの数を戻します。
ValidationException は、渡された引数がヌルの場合、または有効なネットワーク要素 InstanceNameId ではない場合にスローされます。
getAdminDownSwitchedPortsCountInNetworkElement
デバイスに存在する、指定したスイッチ ポート モードの、管理上ダウン状態のスイッチド ポートの数を戻します。
ValidationException は、次のいずれかの状況が発生した場合にスローされます。
• neInstanceNameId がヌルの場合、または neInstanceNameId がネットワーク要素の有効な InstanceNameId ではない場合。
neInstanceNameId：ネットワーク要素に対応する InstanceNameId
getAllFibreChannelInterfacesInNetworkElement
ネットワーク要素に存在するすべてのタイプのファイバ チャネル インターフェイスを戻します。ネットワーク要素のインスタンス名 ID を指定すると、インターフェイス オブジェクトのコレクションを戻します。このメソッドは、Cisco NX-OS Release 5.1(1) 以降を実行する Cisco Nexus 7000 シリーズ スイッチで使用可能です。
渡された引数がヌルの場合、またはリスト内の要素がネットワーク要素の有効な InstanceNameId ではない場合、ValidationException がスローされます。
getAllInterfacesInNetworkElement
ネットワーク要素に存在するすべてのタイプのインターフェイスを戻します。ネットワーク要素のインスタンス名 ID を指定すると、インターフェイス オブジェクト（物理インターフェイスと論理インターフェイスの両方）のコレクションを戻します。
ValidationException は、渡された引数がヌルの場合、または有効なネットワーク要素 InstanceNameId ではない場合にスローされます。
getAllMgmtInterfaces
指定した neInstanceNameIdCol に対応する mgmt インターフェイスのリストのリストを戻します。このメソッドは、Cisco NX-OS Release 5.1(1) 以降を実行する Cisco Nexus 7000 シリーズ スイッチで使用可能です。
getAllVirtualEthernetPorts
渡された引数がヌルの場合、またはネットワーク要素の InstanceNameId ではない場合、ValidationException がスローされます。
neInstanceNameId：ネットワーク要素に対応する InstanceNameId
getControlInterfaces
指定したリスト内のデバイスの ControlNetworkInterface を戻します。neInstanceNameIdCol に対応する NetworkElement に ControlNetworkInterface が含まれない場合、戻されるリストにヌル エントリが含まれる場合があります。
getErrorDetectionSettings
リスト内のネットワーク要素のポート エラー検出設定のコレクションを戻します。
ValidationException は、次のいずれかの状況が発生した場合にスローされます。
• neInstanceNameIds コレクションが空の場合、またはこのコレクションに、ネットワーク要素の有効な InstanceNameId ではないオブジェクトが含まれる場合。
neInstanceNameIds：ネットワーク要素に対応する InstanceNameId。
指定したリスト内のデバイスの PortErrorDisableDetectionSetting のリスト。他のアソシエーションは取得できません。
getErrorRecoverySettings
リスト内のネットワーク要素のポート エラー回復設定のコレクションを戻します。
ValidationException は、次のいずれかの状況が発生した場合にスローされます。
• neInstanceNameIds コレクションが空の場合、またはこのコレクションに、ネットワーク要素の有効な InstanceNameId ではないオブジェクトが含まれる場合。
neInstanceNameIds：ネットワーク要素に対応する InstanceNameId。
指定したリスト内のデバイスの PortErrorDisableRecoverySetting のリスト。他のアソシエーションは取得できません。
getIpAclAssociationsForNetworkInterface
指定したインターフェイス オブジェクトに対応する、IP ACL アソシエーション オブジェクトのインターフェイスのコレクションを戻します。
ValidationException は、渡された引数がヌルの場合、またはネットワーク インターフェイスの有効な InstanceNameId ではない場合にスローされます。
interfaceId：RoutedNetworkInterface に対応する InstanceNameId。
指定したネットワーク インターフェイスに関連付けられている AclAppliesToNetworkInterface オブジェクトのリスト。
次のオブジェクトが AclAppliesToNetworkInterface アソシエーションの他のエンドで読み込まれます。
getLldpGlobalSetting
LldpGlobalSetting オブジェクトのリストを戻します。各 LldpGlobalSetting オブジェクトには、ブール アトリビュートの lldpServiceEnable が読み込まれ、該当デバイスで LLDP サービスがイネーブルであるか、またはディセーブルであるかが示されます。
getLldpSettingsForNetworkInterface
リスト内のネットワーク インターフェイスに関連付けられている LLDP 設定オブジェクトのリストを戻します。
ValidationException は、渡された引数がヌルの場合、またはネットワーク インターフェイスの有効な InstanceNameId ではない場合にスローされます。
getLogicalInterfacesInNetworkElement
ネットワーク要素に存在するすべての論理インターフェイスを戻します。ネットワーク要素のインスタンス名 ID を指定すると、論理インターフェイス オブジェクトのコレクションを戻します。
ValidationException は、渡された引数がヌルの場合、または有効なネットワーク要素 InstanceNameId ではない場合にスローされます。
neInstanceNameIds：ネットワーク要素の InstanceNameId のリスト。
getLoopbackInterfacesInNetworkElement
ネットワーク要素に存在するすべてのループバック インターフェイスを戻します。ネットワーク要素のインスタンス名 ID を指定すると、ループバック インターフェイス オブジェクトのコレクションを戻します。
ValidationException は、渡された引数がヌルの場合、または有効なネットワーク要素 InstanceNameId ではない場合にスローされます。
neInstanceNameIds：ネットワーク要素の InstanceNameId のリスト。
ネットワーク要素に存在するすべての LoopBackNetworkInterface のリスト
getMacAclAssociationsForNetworkInterface
指定したインターフェイス オブジェクトに対応する、MAC ACL アソシエーション オブジェクトのインターフェイスのコレクションを戻します。
ValidationException は、渡された引数がヌルの場合、またはネットワーク インターフェイスの有効な InstanceNameId ではない場合にスローされます。
interfaceId：SwitchedNetworkInterface に対応する InstanceNameId。
指定したネットワーク インターフェイスに関連付けられている AclAppliesToNetworkInterface オブジェクトのリスト。
getMgmtInterfaces
指定したリスト内のデバイスに関連する MgmtNetworkInterface を戻します。neInstanceNameIdCol に対応する NetworkElement に MgmtNetworkInterface が含まれない場合、戻されるリストにヌル エントリが含まれる場合があります。
getMissingPortGroupMembers
指定したリスト内のインターフェイス InstanceNameId で欠落しているポート グループ メンバーのリストを戻します。指定したリストにポート グループのすべてのメンバーが含まれる場合、または指定したインターフェイスがポート グループのメンバーではない場合、空のリストを戻します。
ValidationException は、次のいずれかの状況が発生した場合にスローされます。
• interfaceIds に NetworkInterface の無効な InstanceNameId またはヌル値が含まれる場合。
• interfaceIds に、特定の InstanceNameId を持つ同等の NetworkInterface オブジェクトが存在しない場合。
interfaceId：SwitchedNetworkInterface に対応する InstanceNameId。
RoutedNetworkInterface オブジェクトのリストを戻します。
getNetworkInterfaces
指定したリスト内のインターフェイス ID に関連するネットワーク インターフェイス オブジェクトのコレクションを戻します。
ValidationException は、次のいずれかの状況が発生した場合にスローされます。
• interfaceIds コレクションが空の場合、またはこのコレクションに、ネットワーク インターフェイスの有効な InstanceNameId ではないオブジェクトが含まれる場合。
interfaceId：SwitchedNetworkInterface に対応する InstanceNameId。
NetworkInterface インスタンスのインスタンス ID のリスト。
• ルーテッド ポートの場合、ルーテッド サブネットワーク インターフェイス
ルーテッド サブネットワーク インターフェイスの場合、次のアソシエーションが使用可能です。
getNetworkInterfacesByName
NetworkInterface の名前または範囲を指定すると、NetworkInterface オブジェクトのリストを戻します。
渡した neInstanceNameId がヌルの場合、またはネットワーク要素の有効な InstanceNameId ではない場合、ValidationException がスローされます。
neInstanceNameId：ネットワーク要素に対応する InstanceNameId
getNetworkInterfaceSettings
指定したリスト内のデバイス ID に関連するネットワーク インターフェイスのグローバル設定のコレクションを戻します。
ValidationException は、次のいずれかの状況が発生した場合にスローされます。
• neInstanceNameIds コレクションが空の場合、またはこのコレクションに、ネットワーク要素の有効な InstanceNameId ではないオブジェクトが含まれる場合。
neInstanceNameIds：ネットワーク要素に対応する InstanceNameId。
指定したリスト内のデバイスの NetworkInterfaceSetting のリスト。アソシエーションは取得できません。
getOperDownRoutedPortsCountInNetworkElement
デバイスに存在する動作上ダウン状態のルーテッド ポートの数を戻します。
ValidationException は、渡された引数がヌルの場合、または有効なネットワーク要素 InstanceNameId ではない場合にスローされます。
getOperDownSwitchedPortsCountInNetworkElement
デバイスに存在する、指定したスイッチ ポート モードの、動作上ダウン状態のスイッチド ポートの数を戻します。
ValidationException は、次のいずれかの状況が発生した場合にスローされます。
• neInstanceNameId がヌルまたはネットワーク要素の有効な InstanceNameId ではない場合。
neInstanceNameId：ネットワーク要素に対応する InstanceNameId
getPortsInCards
カードに存在する SwitchedNetworkInterface インスタンスと RoutedNetworkInterface インスタンスのリストを戻します。
ValidationException は、渡された引数がヌルの場合、または有効なルーテッド ポート InstanceNameId ではない場合にスローされます。
cardInstanceNameIdCol：リスト内のカードに対応する InstanceNameId。
カードに存在する SwitchedNetworkInterface インスタンスと RoutedNetworkInterface インスタンスのリスト。
• ルーテッド ポートの場合、ルーテッド サブネットワーク インターフェイス
getPortsInModule
指定したスロットのモジュールに存在するすべての物理ポートを戻します。ネットワーク要素のインスタンス名 ID およびモジュールのスロット番号を指定すると、そのモジュールに対応する物理インターフェイス オブジェクトのコレクションを戻します。
ValidationException は、渡された引数がヌルの場合、または有効なルーテッド ポート InstanceNameId ではない場合にスローされます。
neInstanceNameId：ネットワーク要素に対応する InstanceNameId
モジュールに存在する SwitchedNetworkInterface インスタンスと RoutedNetworkInterface インスタンスのリスト。
• ルーテッド ポートの場合、ルーテッド サブネットワーク インターフェイス
getPortsInNetworkElement
ネットワーク要素に存在するスイッチド物理インターフェイス オブジェクトとルーテッド物理インターフェイス オブジェクトのコレクションを戻します。ネットワーク要素のインスタンス名 ID を指定すると、インターフェイス オブジェクトのコレクションを戻します。
ValidationException は、渡された引数がヌルの場合、または有効なネットワーク要素 InstanceNameId ではない場合にスローされます。
neInstanceNameIds：照会されるネットワーク要素の InstanceNameId のリスト。
デバイスに存在する SwitchedNetworkInterface インスタンスと RoutedNetworkInterface インスタンスのリスト。戻されるオブジェクト リストでは、次のアソシエーションだけが使用可能で、その他のアソシエーションはすべてクリアされます。
• ルーテッド ポートの場合、ルーテッド サブネットワーク インターフェイス
getPortStatusSummary
スイッチド ポートとルーテッド ポートの両方のステータス サマリーを戻します。このステータス サマリーには、動作上アップ/ダウン状態、および管理上アップ/ダウン状態であるポートの数と、スイッチド/ルーテッド ポートの総数が含まれます。
ValidationException は、次のいずれかの状況が発生した場合にスローされます。
• neInstanceNameIds コレクションが空の場合、またはこのコレクションに、ネットワーク要素の有効な InstanceNameId ではないオブジェクトが含まれる場合。
neInstanceNameIds：ネットワーク要素に対応する InstanceNameId
getPortsWithErrorVlanAssociations
エラー VLAN アソシエーションを読み込んだスイッチド ネットワーク インターフェイス オブジェクトのリストを戻します。
ValidationException は、渡された引数がヌルの場合、または有効なスイッチド ネットワーク インターフェイス InstanceNameId ではない場合にスローされます。
interfaceIdCol：SwitchedNetworkInterface に対応する InstanceNameId。
getPortsWithFabricPortStatusAssociations
fabricPortStatus アソシエーションを読み込んだネットワーク インターフェイス オブジェクトを戻します。
ValidationException は、次のいずれかの状況が発生した場合にスローされます。
• interfaceIds に NetworkInterface の無効な InstanceNameId またはヌル値が含まれる場合。
• interfaceIds に、特定の InstanceNameId を持つ同等の NetworkInterface オブジェクトが存在しない場合。
interfaceIdCol：SwitchedNetworkInterface に対応する InstanceNameId。
getPortsWithLogicalIntfAssociation
論理インターフェイス アソシエーションを読み込んだネットワーク インターフェイス オブジェクトのリストを戻します。このメソッドは、Cisco NX-OS Release 5.1(1) 以降を実行する Cisco Nexus 7000 シリーズ スイッチで使用可能です。
interfaceIdCol：SwitchedNetworkInterface に対応する InstanceNameId。
getPortsWithLsgAssociations
LinkStateGroupAppliesToSwitchedNetworkInterface アソシエーションを読み込んだスイッチド ネットワーク インターフェイス オブジェクトを戻します。
ValidationException は、次のいずれかの状況が発生した場合にスローされます。
• interfaceIds に、SwitchedNetworkInterface の無効な InstanceNameId またはヌル値が含まれる場合。
• interfaceIds に、特定の InstanceNameId を持つ同等の SwitchedNetworkInterface オブジェクトが存在しない場合。
interfaceIds：LinkStateGroupAppliesToSwitchedNetworkInterface アソシエーションが必要な SwitchedNetworkInterface オブジェクトの InstanceNameId オブジェクトのリスト。
リンクステート グループ アソシエーションを読み込んだ SwitchedNetworkInterface オブジェクトのリストを戻します。
getPortsWithPortChannelAssociations
ポートチャネル アソシエーションを読み込んだネットワーク インターフェイス オブジェクトを戻します。
ValidationException は、次のいずれかの状況が発生した場合にスローされます。
• interfaceIds に NetworkInterface の無効な InstanceNameId またはヌル値が含まれる場合。
• interfaceIds に、特定の InstanceNameId を持つ同等の NetworkInterface オブジェクトが存在しない場合。
interfaceIds：ポートチャネル アソシエーションが必要な SwitchedNetworkInterface オブジェクトと RoutedNetworkInterface オブジェクトの InstanceNameId オブジェクトのリスト。
ポートチャネル アソシエーションを読み込んだ SwitchedNetworkInterface オブジェクトと RoutedNetworkInterface オブジェクトのリストを戻します。
getPortsWithSecurityAssociations
すべてのセキュリティ アソシエーションを読み込んだネットワーク インターフェイス オブジェクトのリストを戻します。
ValidationException は、渡された引数がヌルの場合、またはネットワーク インターフェイスの有効な InstanceNameId ではない場合にスローされます。
interfaceIdCol：NetworkInterface に対応する InstanceNameId。
セキュリティ アソシエーションを読み込んだ NetworkInterface インスタンスのリスト。
インターフェイスごとに、次のアソシエーションが読み込まれます（指定したインターフェイスに対しアソシエーションが存在する場合）。
getPortsWithSpanAssocations
指定したネットワーク インターフェイスに関連する SPAN アソシエーションを読み込んだネットワーク インターフェイス オブジェクトを戻します。
ValidationException は、渡された引数がヌルの場合、またはネットワーク インターフェイスの有効な InstanceNameId ではない場合にスローされます。
getPortsWithVlanAssociations
VLAN アソシエーションを読み込んだスイッチド ネットワーク インターフェイス オブジェクトのリストを戻します。
ValidationException は、渡された引数がヌルの場合、または有効なスイッチド ネットワーク インターフェイス InstanceNameId ではない場合にスローされます。
interfaceIdCol：SwitchedNetworkInterface に対応する InstanceNameId。
SwitchedNetworkInterface のインスタンス
次のアソシエーションが、SwitchedNetworkInterface に読み込まれます。
• アクセス VLAN、ネイティブ VLAN、Voice VLAN を含む SwitchedNetworkInterfaceBelongsToVlan
• PromiscuousPvlanMapping プライマリ VLAN および対応するセカンダリ VLAN
getPortUsedForDiscovery
neInstanceNameId に対応するネットワーク要素の管理 IP アドレスと等しい IP アドレス（IPv4 または IPv6 プライマリ アドレス）を持つネットワーク インターフェイスのインスタンスを戻します。
neInstanceNameId がヌルの場合、ValidationException がスローされます。
getRoutedPortsInModule
指定したスロットのモジュールに存在するすべてのルーテッド物理ポートを戻します。ネットワーク要素のインスタンス名 ID およびモジュールのスロット番号を指定すると、指定したモジュールに対応するルーテッド インターフェイス オブジェクトのコレクションを戻します。
渡された引数がヌルの場合、またはネットワーク要素の InstanceNameId ではない場合、ValidationException がスローされます。
neInstanceNameId：ネットワーク要素に対応する InstanceNameId
モジュールに存在する RoutedNetworkInterface インスタンスのリスト
• ルーテッド ポートの場合、ルーテッド サブネットワーク インターフェイス
getRoutedPortsInNetworkElement
デバイスに存在するすべてのルーテッド物理ポートを戻します。ネットワーク要素のインスタンス名 ID を指定すると、デバイスに存在するルーテッド インターフェイス オブジェクトのコレクションを戻します。
渡された引数がヌルの場合、またはネットワーク要素の InstanceNameId ではない場合、ValidationException がスローされます。
neInstanceNameId：ネットワーク要素に対応する InstanceNameId。
モジュールに存在する RoutedNetworkInterface インスタンスのセット
• ルーテッド ポートの場合、ルーテッド サブネットワーク インターフェイス
getRoutedPortsWithSecurityAssociations
すべてのセキュリティ アソシエーションを読み込んだルーテッド ネットワーク インターフェイス オブジェクトを戻します。
渡された引数がヌルの場合、またはルーテッド ネットワーク インターフェイスの有効な InstanceNameId ではない場合、ValidationException がスローされます。
interfaceIdCol：RoutedNetworkInterface に対応する InstanceNameId。
セキュリティ アソシエーションを読み込んだ RoutedNetworkInterface のインスタンス。インターフェイスごとに、次のアソシエーションが読み込まれます。
getRoutedSubNetworkInterfacesInNetworkElement
ネットワーク要素に存在するすべてのルーテッド サブインターフェイス オブジェクトを戻します。ネットワーク要素のインスタンス名 ID を指定すると、ルーテッド サブインターフェイス オブジェクトのコレクションを戻します。
ValidationException は、渡された引数がヌルの場合、または有効なネットワーク要素 InstanceNameId ではない場合にスローされます。
getSubInterfacesForRoutedNetworkInterface
ルーテッド ポートに関連付けられているすべてのルーテッド サブインターフェイス オブジェクトを戻します。物理ルーテッド ポートのインスタンス名 ID を指定すると、それに関連付けられているルーテッド サブインターフェイス オブジェクトのコレクションを戻します。
ValidationException は、渡された引数がヌルの場合、または有効なルーテッド ポート InstanceNameId ではない場合にスローされます。
routedInfId：ルーテッド インターフェイスの InstanceNameId。
ルーテッド ポートに関連付けられているすべての RoutedSubNetworkInterface オブジェクトのリスト。
getSviServiceStateForNetworkElements
指定したデバイス ID に関連する SVI サービスの状態（イネーブルまたはディセーブル）を表すブールのコレクションを戻します。Cat6k デバイスの場合、SVI サービス状態はヌルです。
ValidationException は、次のいずれかの状況が発生した場合にスローされます。
• neInstanceNameIdCol コレクションが空の場合、またはこのコレクションに、ネットワーク要素の有効な InstanceNameId ではないオブジェクトが含まれる場合。
getSvsVirtualEthGlobalSetting
1 つまたは複数のネットワーク要素のデバイス レベルの SvsVirtualEthGlobalSetting を戻します。1 つまたは複数のネットワーク要素の InstanceNameId を指定すると、それらのネットワーク要素に対応する SvsVirtualEthGlobalSetting オブジェクトを戻します。
ValidationException は、次のいずれかの状況が発生した場合にスローされます。
• neInstanceNameIdCol がヌルまたは空の場合、あるいはタイプ InstanceNameId ではない場合。
• neInstanceNameIdCol が AbstractNetworkElement オブジェクトの有効な InstanceNameId ではない場合。
neInstanceNameIdCol：1 つまたは複数の AbstractNetworkElement オブジェクトの InstanceNameId
getSwicthedPortsCountInModule
指定したスロットのデバイスに存在するすべてのスイッチド ポートを戻します。ネットワーク要素のインスタンス名 ID およびモジュールのスロット番号を指定すると、指定したモジュールに対応するスイッチド インターフェイス オブジェクトのコレクションを戻します。
渡された引数がヌルの場合、またはネットワーク要素の InstanceNameId ではない場合、ValidationException がスローされます。
neInstanceNameId：ネットワーク要素に対応する InstanceNameId
getSwitchedPortsInModule
指定したスロットのデバイスに存在するすべてのスイッチド ポートを戻します。ネットワーク要素のインスタンス名 ID およびモジュールのスロット番号を指定すると、指定したモジュールに対応するスイッチド インターフェイス オブジェクトのコレクションを戻します。このメソッドは、Cisco NX-OS Release 5.1(1) 以降を実行する Cisco Nexus 7000 シリーズ スイッチで使用可能です。
渡された引数がヌルの場合、またはネットワーク要素の InstanceNameId ではない場合、ValidationException がスローされます。
neInstanceNameId：ネットワーク要素に対応する InstanceNameId
getSwitchedPortsInModuleByMode
指定したスロットのモジュールに存在する特定スイッチド ポートを戻します。ネットワーク要素のインスタンス名 ID、モジュールのスロット番号、およびスイッチポート モードを指定すると、指定したモジュールおよびモードに対応するスイッチド インターフェイス オブジェクトのコレクションを戻します。
渡された引数がヌルの場合、またはネットワーク要素の InstanceNameId ではない場合、ValidationException がスローされます。
neInstanceNameId：ネットワーク要素に対応する InstanceNameId
mode：スイッチ ポート モード。mode がヌルの場合、モジュールに存在する、すべてのモードのスイッチ ポートが戻されます。
getSwitchedPortsInNetworkElement
指定したモードのモジュールに存在する特定スイッチド ポートを戻します。ネットワーク要素のインスタンス名 ID およびスイッチポート モードを指定すると、指定したモードのスイッチド インターフェイス オブジェクトのコレクションを戻します。
渡された引数がヌルの場合、またはネットワーク要素の InstanceNameId ではない場合、ValidationException がスローされます。
neInstanceNameId：ネットワーク要素に対応する InstanceNameId
mode：スイッチ ポート モード。mode がヌルの場合、モジュールに存在する、すべてのモードのスイッチ ポートが戻されます。
getSwitchedPortsWithSecurityAssociations
すべてのセキュリティ アソシエーションを読み込んだスイッチド ネットワーク インターフェイス オブジェクトのリストを戻します。
ValidationException は、渡された引数がヌルの場合、または有効なスイッチド ネットワーク インターフェイス InstanceNameId ではない場合にスローされます。
interfaceIdCol：SwitchedNetworkInterface に対応する InstanceNameId
セキュリティ アソシエーションを読み込んだ SwitchedNetworkInterface のインスタンス。
インターフェイスごとに、次のアソシエーションが読み込まれます。
getSystemDefaultSettings
指定したリスト内のデバイス ID に関連するシステム デフォルト設定のコレクションを戻します。
ValidationException は、次のいずれかの状況が発生した場合にスローされます。
• neInstanceNameIds コレクションが空の場合、またはこのコレクションに、ネットワーク要素の有効な InstanceNameId ではないオブジェクトが含まれる場合。
getTotalPortsCountInNetworkElement
ValidationException は、渡された引数がヌルの場合、または有効なネットワーク要素 InstanceNameId ではない場合にスローされます。
getTotalRoutedPortsCountInNetworkElement
ValidationException は、渡された引数がヌルの場合、または有効なネットワーク要素 InstanceNameId ではない場合にスローされます。
getTotalSwitchedPortsCountInNetworkElement
デバイスに存在する、指定したスイッチ ポート モードのスイッチド ポートの数を戻します。
ValidationException は、渡された引数がヌルの場合、または有効なネットワーク要素 InstanceNameId ではない場合にスローされます。
neInstanceNameIds：ネットワーク要素に対応する InstanceNameId
getTunnelInterfacesInNetworkElement
ネットワーク要素に存在するすべてのトンネル インターフェイスを戻します。ネットワーク要素のインスタンス名 ID を指定すると、トンネル インターフェイス オブジェクトのコレクションを戻します。
ValidationException は、渡された引数がヌルの場合、または有効なネットワーク要素 InstanceNameId ではない場合にスローされます。
neInstanceNameIds：ネットワーク要素に対応する InstanceNameId
getUdldServiceStateForNetworkElements
指定したデバイス ID に関連する UDLD サービスの状態（イネーブルまたはディセーブル）を表すブールのコレクションを戻します。Cat6k デバイスの場合、UDLD サービス状態はヌルです。
ValidationException は、次のいずれかの状況が発生した場合にスローされます。
• neInstanceNameIdCol コレクションが空の場合、またはこのコレクションに、ネットワーク要素の有効な InstanceNameId ではないオブジェクトが含まれる場合
getVirtualEthernetPortsInNetworkElement
ネットワーク要素に存在する、指定したモードの特定仮想イーサネット ポートを戻します。ネットワーク要素のインスタンス名 ID およびスイッチポート モードを指定すると、指定したモードの仮想インターフェイス オブジェクトのコレクションを戻します。
渡された引数がヌルの場合、またはネットワーク要素の InstanceNameId ではない場合、ValidationException がスローされます。
neInstanceNameIds：ネットワーク要素に対応する InstanceNameId
mode：スイッチ ポート モード。mode がヌルの場合、モジュールに存在する、すべてのモードの仮想スイッチド ポートが戻されます。
モジュールに存在する SwitchedNetworkInterface インスタンスのリスト。
getVirtualPortsInCard
指定したリスト内のカードに存在する仮想イーサネット ポートのリストを戻します。
ValidationException は、次のいずれかの状況が発生した場合にスローされます。
• 渡された引数がヌルの場合、または有効な InstanceNameId ではない場合
• 有効だが、存在しないカード InstanceNameId が渡された場合。
cardIdCol：リスト内のカードに対応する InstanceNameId
getVirtualPortsInVirtualComputerSystem
指定したリスト内の仮想コンピュータ システムに関連付けられている仮想イーサネット ポートのリストを戻します。
ValidationException は、次のいずれかの状況が発生した場合にスローされます。
• 渡された引数がヌルの場合、または有効な InstanceNameId ではない場合
• 有効だが、存在しないカード InstanceNameId が渡された場合。
vmIdCol：リスト内の仮想コンピュータ システム ID に対応する InstanceNameId
指定した VM（VirtualComputerSystem）に関連付けられている VirtualSwitchedNetworkInterface インスタンスのリスト。
getVirtualPortsWithNoCardAssoc
カード アソシエーションを含まない仮想イーサネット ポートのリストを戻します。これらは、ユーザが作成した仮想イーサネット ポートです。
ValidationException は、次のいずれかの状況が発生した場合にスローされます。
• 渡された引数がヌルの場合、または有効な InstanceNameId ではない場合
• 有効だが、存在しないカード InstanceNameId が渡された場合。
neIdCol：リスト内の ANE に対応する InstanceNameId
getVlanNetworkInterfacesInNetworkElement
ネットワーク要素に存在するすべての VLAN ネットワーク インターフェイス（SVI）を戻します。ネットワーク要素のインスタンス名 ID を指定すると、VLAN インターフェイス オブジェクトのコレクションを戻します。
ValidationException は、渡された引数がヌルの場合、または有効なネットワーク要素 InstanceNameId ではない場合にスローされます。
neInstanceNameId：ネットワーク要素の InstanceNameId
modifyAdminStateForNetworkInterfaces
ネットワーク インターフェイスの管理状態を指定した状態にアップデートします。パラメータとしてポート チャネル ネットワーク インターフェイスを渡すと、この API は、そのメンバー ポートの管理状態を同じ状態にアップデートします。
ValidationException は、次のいずれかの状況が発生した場合にスローされます。
• niInstanceNameIds がヌルの場合、またはコレクションが空の場合。
• niInstanceNameIds に 1 つまたは複数のヌル要素が含まれる場合、またはこのコレクションに、InstanceNameId タイプではないオブジェクトが含まれる場合。
modifyErrorDetectionSettingInNetworkElement
指定したネットワーク要素 ID に関連する既存のエラー検出設定を変更します。
ValidationException は、次のいずれかの状況が発生した場合にスローされます。
• neInstanceNameId がネットワーク要素の有効な InstanceNameId ではない場合。
• modifiedErrorDetection がヌルの場合。
neInstanceNameId：ネットワーク要素に対応する InstanceNameId
modifiedErrorDetection：変更対象の PortErrorDisableDetectionSetting
modifyErrorRecoverySettingInNetworkElement
指定したネットワーク要素 ID に関連する既存のエラー検出設定を変更します。
ValidationException は、次のいずれかの状況が発生した場合にスローされます。
• neInstanceNameId がネットワーク要素の有効な InstanceNameId ではない場合。
• modifiedErrorRecovery がヌルの場合。
PropertiesException は、次のいずれかの状況が発生した場合にスローされます。
• recoveryInterval で、アトリビュートが無効の場合。
neInstanceNameId：ネットワーク要素に対応する InstanceNameId
modifiedErrorRecovery：変更対象の PortErrorDisableRecoverySetting。
modifyNetworkInterfaces
1 つまたは複数の物理および論理インターフェイス（ポートチャネルを除く）オブジェクトを変更します。インターフェイスが IpNetworkInterface の一種の場合、セカンダリおよびヘルパー IP アドレス コレクションがアップデートされます。インターフェイスでモードが変更される場合（スイッチドからルーテッド、またはルーテッドからスイッチド）、AbstractNetworkElement リファレンスを設定する必要があります。
ValidationException は、次のいずれかの状況が発生した場合にスローされます。
• modifiedNetworkInterfaceCol がヌルの場合、またはこのコレクションが空の場合。
• modifiedNetworkInterfaceCol に 1 つまたは複数のヌル要素が含まれる場合、またはこのコレクションに NetworkInterface タイプではないオブジェクトが含まれる場合。
• modifiedNetworkInterfaceCol に、AbstractNetworkElement アソシエーションを含まない 1 つまたは複数の NetworkInterface オブジェクトが含まれる場合。
• modifiedNetworkInterfaceCol に、SwitchedEtherChannelNetworkInterface タイプまたは RoutedEtherChannelNetworkInterface タイプのオブジェクトが含まれる場合。ポートチャネルは、この API ではサポートされていません。
• 設定対象の IP アドレス（Ipv4AddressPrefix）が、デバイスに存在する他のレイヤ 3 インターフェイスのプライマリまたはセカンダリ IP アドレスと重複する場合。
• 変更対象のインターフェイスが RoutedSubNetworkInterface の場合、次の状況では ValidationException が発生します。
– カプセル化 VLAN（Vlan）アソシエーションを作成せずに、インターフェイスに IP アドレス（Ipv4AddressPrefix）を設定しようとした場合。
– 設定対象のカプセル化 VLAN（Vlan）が使用できない場合、または他のインターフェイスですでに使用されている場合。
– カプセル化 VLAN を指定せずに、カプセル化方式（SubInterfaceEncapsulationType）を設定した場合。
PropertiesException は、次のいずれかの状況が発生した場合にスローされます。
• modifiedNetworkInterfaceCol コレクションで、NetworkInterface アトリビュートが有効ではない場合。
modifyNetworkInterfaceSetting
指定したネットワーク要素 ID に関連するネットワーク インターフェイスのグローバル設定を変更します。
ValidationException は、次のいずれかの状況が発生した場合にスローされます。
• neInstanceNameId がネットワーク要素の有効な InstanceNameId ではない場合。
PropertiesException は、次のいずれかの状況が発生した場合にスローされます。
modifyPortModeToRouted
指定したネットワーク インターフェイスのポート モードをスイッチドからルーテッドに変更します。サーバでこのメソッドを呼び出すと、すべてのレイヤ 2 アソシエーションが、デバイス プラットフォームに基づきクリアまたは保持されます。残りのアソシエーションは、新しいオブジェクトに再度関連付けられます。古いオブジェクトに存在するすべてのアトリビュートが新しいオブジェクトに割り当てられます。
ValidationException は、次のいずれかの状況が発生した場合にスローされます。
• switchedInterfaceNameIdCol コレクションがヌル、または空の場合。
• switchedInterfaceNameIdCol コレクションに、SwitchedNetworkInterface InstanceName id タイプではないオブジェクトが含まれる場合。
• switchedInterfaceNameIdCol コレクションに、データベースに存在しない SwitchedNetworkInterface が含まれる場合。
PropertiesException は、次のいずれかの状況が発生した場合にスローされます。
modifyPortModeToSwitched
指定したネットワーク インターフェイスのポート モードをルーテッドからスイッチドに変更します。サーバでこのメソッドを呼び出すと、すべてのレイヤ 3 アソシエーションが、デバイス プラットフォームに基づきクリアまたは保持されます。残りのアソシエーションは、新しいオブジェクトに再度関連付けられます。古いオブジェクトに存在するすべてのアトリビュートが新しいオブジェクトに割り当てられます。
ValidationException は、次のいずれかの状況が発生した場合にスローされます。
• routedInterfaceNameIdCol コレクションがヌル、または空の場合。
• routedInterfaceNameIdCol コレクションに、RoutedNetworkInterface InstanceName id タイプではないオブジェクトが含まれる場合。
• routedInterfaceNameIdCol コレクションに、データベースに存在しない RoutedNetworkInterface が含まれる場合。
PropertiesException は、次のいずれかの状況が発生した場合にスローされます。
routedInterfaceNameIdCol：ルーテッド ポートのインスタンス名 ID のリスト。
trunkMode：トランク ポート モード。このモードに基づいて、トランクのカプセル化と非ネゴシエーションは対応するデフォルトに設定されます。トランク モードがスタティックの場合、カプセル化は dot1q に変更され、非ネゴシエーションは true に変更されます。
modifyRoutedSubNetworkInterfaces
1 つまたは複数の既存のルーテッド サブインターフェイス オブジェクトを変更します。
ValidationException は、次のいずれかの状況が発生した場合にスローされます。
• modifiedRoutedSubNetworkInfs がヌルの場合、またはこのコレクションが空の場合。
• modifiedRoutedSubNetworkInfs に 1 つまたは複数のヌル要素が含まれる場合、またはこのコレクションに RoutedSubNetworkInterface タイプではないオブジェクトが含まれる場合。
• カプセル化 VLAN（Vlan）アソシエーションを作成せずに、インターフェイスに IP アドレス（Ipv4AddressPrefix）を設定しようとした場合。
• 設定対象の IP アドレス（Ipv4AddressPrefix）が、デバイスに存在する他のレイヤ 3 インターフェイスのプライマリまたはセカンダリ IP アドレスと重複する場合。
• 設定対象のカプセル化 VLAN（Vlan）が使用できない場合、または他のインターフェイスですでに使用されている場合。
• カプセル化 VLAN を指定せずに、カプセル化方式（SubInterfaceEncapsulationType）を設定した場合。
PropertiesException は、次のいずれかの状況が発生した場合にスローされます。
• subInfs コレクションで、RoutedSubNetworkInterface アトリビュートが有効ではない場合。
modifiedRoutedSubNetworkInfs：変更対象の RoutedSubNetworkInterface オブジェクトのリスト。
modifySvsVethGlobalSettingInNetworkElement
指定したネットワーク要素 ID に関連する SvsVirtualEthGlobalSetting を変更します。
ValidationException は、次のいずれかの状況が発生した場合にスローされます。
• neInstanceNameId がネットワーク要素の有効な InstanceNameId ではない場合。
PropertiesException は、次のいずれかの状況が発生した場合にスローされます。
• subInfs コレクションで、RoutedSubNetworkInterface アトリビュートが有効ではない場合。
modifySwitchPortMode
指定したリスト内のスイッチ ポートのスイッチ ポート モードを変更します。これにより、新しいスイッチ ポート モードを指定できます。この API は、新しいインスタンス名 ID を再作成しません。この API は、指定した新しいアトリビュートを既存のオブジェクトに適用します。ポート モードをトランク モードに変更する場合、トランク モードを指定できます。トランク モードを指定しないと、デフォルト トランク モードはスタティック モードに変更されます。ポート モードをトランク以外のモードに変更する場合、トランク モードは無視されます。
ValidationException は、次のいずれかの状況が発生した場合にスローされます。
• switchedInterfaceNameIdCol コレクションがヌル、または空の場合。
• switchedInterfaceNameIdCol コレクションに、SwitchedNetworkInterface InstanceName id タイプではないオブジェクトが含まれる場合。
• switchedInterfaceNameIdCol コレクションに、データベースに存在しない SwitchedNetworkInterface が含まれる場合。
PropertiesException は、次のいずれかの状況が発生した場合にスローされます。
• subInfs コレクションで、RoutedSubNetworkInterface アトリビュートが有効ではない場合。
switchedInterfaceNameIdCol：ルーテッド ポートのインスタンス名 ID のリスト
trunkMode：トランク ポート モード。これは、モードをトランク モードに変更する場合に限り適用できます。このモード セットに基づいて、トランクのカプセル化と非ネゴシエーションは対応するデフォルトに設定されます。トランク モードがスタティックの場合、カプセル化は dot1q（インターフェイスでサポートされている場合）に変更され、非ネゴシエーションは true に変更されます。同様に、トランク モードを dynamic auto または desirable に変更する場合、非ネゴシエーションは false に設定され、カプセル化は negotiate（インターフェイスでサポートされている場合）に設定されます。
modifySystemDefaultSetting
指定したネットワーク要素 ID に関連するシステム デフォルト設定を変更します。システム デフォルト状態の変更は、次のタイプのネットワーク要素のインスタンスに影響します。
• SwitchedEtherChannelNetworkInterface
（注） SystemDefaultSetting の switchPortModeEnabled アトリビュートを変更すると、その特定デバイスの再検出がトリガーされます。
ValidationException は、次のいずれかの状況が発生した場合にスローされます。
• sysDefaultSettingsCol がヌルの場合。
• sysDefaultSettingsCol が空の場合。
PropertiesException は、次のいずれかの状況が発生した場合にスローされます。
• subInfs コレクションで、RoutedSubNetworkInterface アトリビュートが有効ではない場合。
フィードバック