- はじめに
- 概要
- 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日
章のタイトル： SpanApp サービス
- SpanApp サービスについて
- addDestinationPortsToSpanSession
- addFilteredVlanRangeToSpanSession
- addFilteredVlansToSpanSession
- addPortsToSpanPermitList
- addSourcesToSpanSession
- addSourcesToSpanSessionByRange
- createSpanSessions
- createSpanSessionsInNetworkElement
- deleteSpanSessions
- disableInterfacesMonitor
- enableInterfacesMonitor
- getLocalSpanSessionsInNetwork
- getSpanDestinationPorts
- getSpanPermitListSettingsInNetwork
- getSpanSessions
- getSpanSessionsAssociatedToVlan
- getSpanSessionsInNetwork
- getSpanSources
- modifyFilteredVlanRangeForSpanSession
- modifyFilteredVlansByRangeForSpanSession
- modifyFilteredVlansForSpanSession
- modifySpanPermitListSettingsInNetworkElement
- modifySpanSessions
- modifySpanSourceTrafficDirection
- modifySpanSources
- removeDestinationPortsFromSpanSession
- removeFilteredVlanRangeInSpanSession
- removeFilteredVlansInSpanSession
- removePortsFromSpanPermitList
- removeSourcesFromSpanSession
- removeSourcesInSpanSession
- unbindDestinationPortsFromSpanSession
SpanApp サービス
SpanApp サービスについて
スイッチは、Switch Port Analyzer（SPAN; スイッチ ポート アナライザ）機能を使用して、スイッチの送信元ポートまたは VLAN から宛先ポートにトラフィックをコピーします。この機能によって、ネットワーク アナライザなどのモニタリング デバイスを使用して、宛先ポートでトラフィックを分析できます。API カテゴリは次のとおりです。
•
Query/Get API：永続的なデータベースのデータを照会します。
• Modify API：SPAN セッションの設定またはグローバル設定を変更します。
• Delete API：デバイスから SPAN セッションを削除します。
次のセッションは、Query API および Delete API でサポートされます。
変更できるのはローカル SPAN セッションだけです。RSPAN 送信元または宛先セッションでは、例外がスローされます。
addDestinationPortsToSpanSession
宛先ポートやイーサネット チャネルをローカル SPAN セッションに追加します。リモート SPAN はサポートされません。
ValidationException は、次のいずれかの状況が発生した場合にスローされます。
• sessionNameId がヌルであるか、LocalSpanSession の InstanceNameId ではない場合。
• 指定された LocalSpanSession が存在しない場合。
• すでに SPAN 送信元として使用されている NetworkInterface が宛先として使用される場合。
• NetworkInterface が他の SPAN セッションの SPAN 宛先としてすでに設定されている場合。
• SPAN 許可リストがイネーブルになっていて、NetworkInterface が許可リスト宛先ポートとして設定されていない場合。
• Catalyst 6500 シリーズ スイッチで SwitchedEtherChannelNetworkInterface または RoutedEtherChannelNetworkInterface が SPAN 宛先として使用される場合。
• Etherchannel メンバー ポートが SPAN 宛先として設定されている場合。
• NetworkInterface が SPAN 宛先対応ではない場合。
• dstPortNameIds の InstanceNameId に対応するオブジェクトが存在しない場合。
sessionNameId：LocalSpanSession の InstanceNameId。
addFilteredVlanRangeToSpanSession
フィルタリング済み VLAN をローカル SPAN セッションに追加します。リモート SPAN はサポートされません。デバイスに存在しない VLAN を追加できます（事前プロビジョニング）。
ValidationException は、次のいずれかの状況が発生した場合にスローされます。
• sessionNameId がヌルであるか、LocalSpanSession の InstanceNameId ではない場合。
• 指定された LocalSpanSession が存在しない場合。
• フィルタリング済み VLAN をローカル SPAN に追加する場合、および特定のローカル SPAN セッションで送信元 VLAN が追加されている場合。
sessionNameId：LocalSpanSession の InstanceNameId。
addFilteredVlansToSpanSession
フィルタリング済み VLAN をローカル SPAN セッションに追加します。リモート SPAN はサポートされません。同様にデバイスに存在しない VLAN を追加できます（事前プロビジョニング）。
ValidationException は、次のいずれかの状況が発生した場合にスローされます。
• sessionNameId がヌルであるか、LocalSpanSession の InstanceNameId ではない場合。
• 指定された LocalSpanSession が存在しない場合。
• フィルタリング済み VLAN をローカル SPAN に追加する場合、および特定のローカル SPAN セッションで送信元 VLAN が追加されている場合。
sessionNameId：LocalSpanSession の InstanceNameId。
addPortsToSpanPermitList
ValidationException は、次のいずれかの状況が発生した場合にスローされます。
• neNameId がヌルであるか、AbstractNetworkElement の InstanceNameId ではない場合。
• 指定された AbstractNetworkElement が存在しない場合。
• interfaceNameIds 内の要素の InstanceNameId のタイプが RoutedEtherChannelNetworkInterface または SwitchedEtherChannelNetworkInterface である場合。
neNameId：ネットワーク要素の InstanceNameId。
addSourcesToSpanSession
送信元ポートやイーサネット チャネルをローカル SPAN セッションに追加します。リモート SPAN はサポートされません。
ValidationException は、次のいずれかの状況が発生した場合にスローされます。
• sessionNameId がヌルであるか、LocalSpanSession の InstanceNameId ではない場合。
• 指定された LocalSpanSession が存在しない場合。
• すでに宛先として使用されている NetworkInterface が SPAN 送信元として使用される場合。
• Catalyst 6500 シリーズ スイッチで SwitchedEtherChannelNetworkInterface または RoutedEtherChannelNetworkInterface が SPAN 送信元として使用される場合。
• Etherchannel メンバー ポートが SPAN 送信元として設定されている場合。
• NetworkInterface が SPAN 送信元として追加される場合、Catalyst 6500 シリーズ スイッチにおいてセッションでフィルタリング済み VLAN がすでに設定されている場合。
• NetworkInterface が SPAN 送信元として追加される場合、Catalyst 6500 シリーズ スイッチにおいてセッションで VLAN がすでに SPAN 送信元として設定されている場合。
• VLAN が SPAN 送信元として追加される場合、Catalyst 6500 シリーズ スイッチにおいてセッションでインターフェイスがすでに SPAN 送信元として設定されている場合。
• srcNameIds の InstanceNameId に対応するオブジェクトが存在しない場合。
sessionNameId：LocalSpanSession の InstanceNameId。
srcNameIds：特定の SPAN セッションの送信元として設定する NetworkInterface または VLAN の InstanceNameId のリスト。
addSourcesToSpanSessionByRange
送信元 VLAN をローカル SPAN セッションに追加します。リモート SPAN はサポートされません。
ValidationException は、次のいずれかの状況が発生した場合にスローされます。
• sessionNameId がヌルであるか、LocalSpanSession の InstanceNameId ではない場合。
• 指定された LocalSpanSession が存在しない場合。
• VLAN が SPAN 送信元として追加される場合、Catalyst 6500 シリーズ スイッチにおいてセッションでフィルタリング済み VLAN がすでに設定されている場合。
• VLAN が SPAN 送信元として追加される場合、Catalyst 6500 シリーズ スイッチにおいてセッションでインターフェイスがすでに SPAN 送信元として設定されている場合。
• vlanRange の VLAN ID に対応するオブジェクトが存在しない場合。
sessionNameId：LocalSpanSession の InstanceNameId。
vlanRange：SPAN 送信元として設定する VLAN ID の範囲。例：「2,7-9」。
createSpanSessions
ネットワーク要素で SPAN セッションを作成します。このメソッドは、すべてのタイプの SPAN セッションの作成に使用できます。
このメソッドの呼び出し中に、NetworkElement 参照を、対応するセッションを作成する必要があるセッションに設定する必要があります。
サーバでは、このメソッドによって、セッション ID と NetworkElement に基づいて SPAN セッションの新規 InstanceNameId が作成されます。
ユーザは、SPAN セッションを作成するために、このセッションへの送信元または宛先アソシエーションを少なくとも 1 つ設定する必要があります。
• SpanSource ローカル SPAN 送信元：送信元インターフェイスおよび VLAN
• VLAN ローカル SPAN 送信元：フィルタリング済み VLAN
• NetworkInterfaceLocal SPAN 宛先：宛先インターフェイス
ValidationException は、次のいずれかの状況が発生した場合にスローされます。
• RSPAN 送信元または宛先セッションが作成される場合。
• spanSessionList がヌルまたは空であるか、リストの要素のタイプが LocalSpanSession ではない場合。
• spanSessionList 内の LocalSpanSession オブジェクトに有効なセッション ID がないか、ヌルの AbstractNetworkElement 参照である場合。
• 指定された AbstractNetworkElement での SPAN セッション数の制限を超えた場合。
• 作成する SPAN セッションに送信元または宛先アソシエーションがない場合。
• Catalyst 6500 シリーズ スイッチでは、作成する SPAN セッションに SPAN 送信元として NetworkInterface および VLAN がある場合。
• 作成する SPAN セッションに、すでに他のセッションでの SPAN 宛先である SPAN 宛先インターフェイスとして NetworkInterface がある場合。
PropertiesException は、次のいずれかの状況が発生した場合にスローされます。
• spanSessionList コレクションで、いずれかの SpanSession アトリビュートが無効である場合。
• SpanSession の sessionId が範囲外です。
IntegrityException は、次のいずれかの状況が発生した場合にスローされます。
• spanSessionList コレクションで、いずれかの SpanSession オブジェクトが指定された AbstractNetworkElement にすでに存在する場合。
createSpanSessionsInNetworkElement
ネットワーク要素で SPAN セッションのリストを作成します。このメソッドは、すべてのタイプの SPAN セッションの作成に使用できます。セッション ID および NetworkElement InstanceNameId に基づいて、サーバで InstanceNameId が作成されます。
• SpanSource ローカル SPAN 送信元：送信元インターフェイスおよび VLAN
• VLAN ローカル SPAN 送信元：フィルタリング済み VLAN
• NetworkInterfaceLocal SPAN 宛先：宛先インターフェイス
ValidationException は、次のいずれかの状況が発生した場合にスローされます。
• sessionInstanceNameIds が、SpanSession オブジェクトの有効な InstanceNameId ではない場合。
• neNameId がヌルであるか、AbstractNetworkElement の InstanceNameId ではない場合。
ValidationException は、次のいずれかの状況が発生した場合にスローされます。
• RSPAN 送信元または宛先セッションが作成される場合。
• spanSessionList がヌルまたは空であるか、リストの要素のタイプが LocalSpanSession ではない場合。
• 指定された AbstractNetworkElement が存在しない場合。
• spanSessionList 内の LocalSpanSession オブジェクトに有効なセッション ID がないか、ヌルの AbstractNetworkElement 参照である場合。
• 指定された AbstractNetworkElement での SPAN セッション数の制限を超えた場合。
• 作成する SPAN セッションに送信元または宛先アソシエーションがない場合。
• Catalyst 6500 シリーズ スイッチでは、作成する SPAN セッションに SPAN 送信元として NetworkInterface および VLAN がある場合。
• 作成する SPAN セッションに、すでに他のセッションでの SPAN 宛先である SPAN 宛先インターフェイスとして NetworkInterface がある場合。
PropertiesException は、次のいずれかの状況が発生した場合にスローされます。
• spanSessionList コレクションで、いずれかの SpanSession アトリビュートが無効である場合。
• SpanSession の sessionId が範囲外です。
IntegrityException は、次のいずれかの状況が発生した場合にスローされます。
• spanSessionList コレクションで、いずれかの SpanSession オブジェクトが指定された AbstractNetworkElement にすでに存在する場合。
neNameId：ネットワーク要素の InstanceNameId。
deleteSpanSessions
InstanceNameId の特定のリストに対応する SPAN セッションを削除します。対応する SpanSession およびアソシエーションが削除されます。
ValidationException は、次のいずれかの状況が発生した場合にスローされます。
• sessionNameIds がヌルまたは空であるか、リストの要素が SpanSession の InstanceNameId ではない場合。
sessionNameIds コレクションで、sessionNameIds 内の InstanceNameId に対応するいずれかの SpanSession オブジェクトが存在しない場合。
disableInterfacesMonitor
1 つまたは複数のインターフェイスについてインターフェイス モニタをディセーブルにします。インターフェイスのインスタンス名 ID を指定すると、これらの要素で InterfacesMonitor はディセーブルになります。この API は、Cisco NX-OS デバイスの「InterfacesMonitor」をディセーブルにするためのもので、他の Cisco IOS デバイスには適用できません。
ValidationException は、次のいずれかの状況が発生した場合にスローされます。
• interfaceInstanceNameId のタイプが NetworkInterface ヌルである場合。
• interfaceInstanceNameId に 1 つまたは複数のヌル要素が含まれているか、コレクションが空であるかタイプが InstanceNameId ではない場合。
• 特定のインターフェイスが他の Cisco IOS で実行されている場合。
interfaceInstanceNameId：情報が必要な NetworkInterface の InstanceNameId のリスト
enableInterfacesMonitor
特定のインターフェイスのインターフェイス モニタをイネーブルにします。1 つまたは複数のインターフェイスのインスタンス名 ID を指定すると、「InterfacesMonitor」がこれらの要素でイネーブルになります。この API は、Cisco NX-OS デバイスの InterfacesMonitor をイネーブルにするためのもので、他の Cisco IOS デバイスには適用できません。
ValidationException は、次のいずれかの状況が発生した場合にスローされます。
• interfaceInstanceNameId がヌルの場合。
• タイプが NetworkInterface の interfaceInstanceNameIdis に 1 つまたは複数のヌル要素が含まれているか、コレクションが空であるかタイプが InstanceNameId ではない場合。
• 特定のインターフェイスが他の Cisco IOS で実行されている場合。
interfaceInstanceNameId：情報が必要な NetworkInterface の InstanceNameId のリスト
getLocalSpanSessionsInNetwork
ネットワーク要素リストのセッション ID リストに対応するローカル SPAN セッションを戻します。
ValidationException は、次のいずれかの状況が発生した場合にスローされます。
• neNameIdList の要素が AbstractNetworkElement の InstanceNameId タイプではない場合。
sessionIds：セッション ID の範囲（たとえば、1-2、20、50-53）。ヌルの場合は、すべてのセッションを戻します。
neNameIdList：セッション ID を照会するネットワーク要素の (@link InstanceNameId) のリスト。ヌルまたは空の場合は、すべての管理対象ネットワーク要素からセッションを戻します。
getSpanDestinationPorts
結果のインターフェイスでは次のアソシエーションが使用可能です。
ValidationException は、次のいずれかの状況が発生した場合にスローされます。
• sessionNameId がヌルであるか、SpanSession の InstanceNameId ではない場合。
getSpanPermitListSettingsInNetwork
ネットワーク要素のリストについて SPAN 宛先許可リストを戻します。
ValidationException は、次のいずれかの状況が発生した場合にスローされます。
• neNameIdList の要素が AbstractNetworkElement の InstanceNameId タイプではない場合。
neNameIdList：SpanPermitListSetting を照会するネットワーク要素の InstanceNameId のリスト。ヌルまたは空の場合は、すべての管理対象ネットワーク要素からセッションを戻します。
getSpanSessions
SPAN セッションの特定のインスタンス名 ID リストに関するすべてのアソシエーションとともに、SPAN セッションのリストを戻します。
• SpanSource ローカル SPAN または RSPAN 送信元：送信元インターフェイスおよび VLAN
• VLAN ローカル SPAN または RSPAN 送信元：フィルタリング済み VLAN
• NetworkInterface ローカル SPAN または RSPAN 宛先：宛先インターフェイス
• VlanRSPAN 送信元または RSPAN 宛先 VLAN：RSPAN VLAN
ValidationException は、次のいずれかの状況が発生した場合にスローされます。
• sessionInstanceNameIds がヌルまたは空であるか、タイプが InstanceNameId ではない場合。
• sessionInstanceNameIds が、SpanSession オブジェクトの有効な InstanceNameId ではない場合。
sessionInstanceNameIds：SPAN セッションの (@link InstanceNameId) のリスト。
SpanSession オブジェクトの順序付きリスト。戻されるオブジェクトでは、すべてのアソシエーションが初期化されます。
getSpanSessionsAssociatedToVlan
特定の VLAN が SPAN 送信元として設定されている SPAN セッション オブジェクトを戻します。
SPAN セッションごとに、次のアソシエーションが使用可能です。
25. ローカル SPAN から VLAN へのアソシエーション
LocalSpanSessionAppliesToVlan のもう一方の端では次のアソシエーションが使用可能です。
ValidationException は、次のいずれかの状況が発生した場合にスローされます。
• vlanNameId がヌルであるか、VLAN の InstanceNameId ではない場合。
getSpanSessionsInNetwork
ネットワーク要素リストのセッション ID リストに対応する SPAN セッションを戻します。
• SpanSource ローカル SPAN または RSPAN 送信元：送信元インターフェイスおよび VLAN
• VLAN ローカル SPAN または RSPAN 送信元：フィルタリング済み VLAN
• NetworkInterface ローカル SPAN または RSPAN 宛先：宛先インターフェイス
• VLAN RSPAN 送信元または RSPAN 宛先 VLAN：RSPAN VLAN
ValidationException は、次のいずれかの状況が発生した場合にスローされます。
• neNameIdList の要素が AbstractNetworkElement の InstanceNameId タイプではない場合。
sessionIds：セッション ID の範囲（たとえば、1-2、20、50-53）。ヌルの場合は、すべてのセッションを戻します。
neNameIdList：セッション ID を照会するネットワーク要素の (@link InstanceNameId) のリスト。ヌルまたは空の場合は、すべての管理対象ネットワーク要素からセッションを戻します。
SpanSession オブジェクトの順序付きリスト。戻されるオブジェクトでは、すべてのアソシエーションが初期化されます。
getSpanSources
ローカル SPAN セッションまたはリモート SPAN 送信元セッションに関連付けられたすべての送信元ポートまたは EtherChannel または VLAN を戻します。
戻りタイプには、ローカル SPAN セッションに対する次のオブジェクトのリストがあります。
LocalSpanSessionAppliesToNetworkInterface では次のアソシエーションが使用可能です。
LocalSpanSessionAppliesToVlan では次のアソシエーションが使用可能です。
ValidationException は、次のいずれかの状況が発生した場合にスローされます。
• sessionNameId がヌルであるか、SpanSession の InstanceNameId ではない場合。
modifyFilteredVlanRangeForSpanSession
ローカル SPAN セッションに関連するフィルタリング済み VLAN を変更します。既存のフィルタリング済み VLAN は、特定の VLAN で置き換えられます。リモート SPAN はサポートされません。
ValidationException は、次のいずれかの状況が発生した場合にスローされます。
• sessionNameId がヌルであるか、LocalSpanSession の InstanceNameId ではない場合。
• 指定された LocalSpanSession が存在しない場合。
• vlanInstanceNameIds の InstanceNameId に対応するオブジェクトが存在しない場合。
• フィルタリング済み VLAN をローカル SPAN に追加する場合、および特定のローカル SPAN セッションで送信元 VLAN が追加されている場合。
sessionNameId：LocalSpanSession の InstanceNameId。
modifyFilteredVlansByRangeForSpanSession
ローカル SPAN セッションに関連するフィルタリング済み VLAN を変更します。既存のフィルタリング済み VLAN は、特定の VLAN で置き換えられます。リモート SPAN はサポートされません。
ValidationException は、次のいずれかの状況が発生した場合にスローされます。
• sessionNameId がヌルであるか、LocalSpanSession の InstanceNameId ではない場合。
• 指定された LocalSpanSession が存在しない場合。
• フィルタリング済み VLAN をローカル SPAN に追加する場合、および特定のローカル SPAN セッションで送信元 VLAN が追加されている場合。
sessionNameId：LocalSpanSession の InstanceNameId。
modifyFilteredVlansForSpanSession
ローカル SPAN セッションに関連するフィルタリング済み VLAN を変更します。既存のフィルタリング済み VLAN は、特定の VLAN で置き換えられます。リモート SPAN はサポートされません。
ValidationException は、次のいずれかの状況が発生した場合にスローされます。
• sessionNameId がヌルであるか、LocalSpanSession の InstanceNameId ではない場合。
• 指定された LocalSpanSession が存在しない場合。
• vlanInstanceNameIds の InstanceNameId に対応するオブジェクトが存在しない場合。
• フィルタリング済み VLAN をローカル SPAN に追加する場合、および特定のローカル SPAN セッションで送信元 VLAN が追加されている場合。
sessionNameId：LocalSpanSession の InstanceNameId。
vlanInstanceNameIds：フィルタリング済み VLAN として特定の SPAN セッションに置き換えられる VLAN の InstanceNameId のリスト。
modifySpanPermitListSettingsInNetworkElement
特定のネットワーク要素の許可リストを変更します。このメソッドには、SpanPermitListSetting に関連する宛先ポートへの変更が含まれます。
• 許可リストに関連する NetworkInterface 宛先インターフェイス
ValidationException は、次のいずれかの状況が発生した場合にスローされます。
• neNameId がヌルであるか、AbstractNetworkElement の InstanceNameId ではない場合。
• 指定された AbstractNetworkElement が存在しない場合。
• modifiedPermitListSetting がヌルの場合。
• ポートを許可リスト宛先ポートに関連付けることなく permitlist がイネーブルになっている場合。
• 設定されている NetworkInterface のタイプが RoutedEtherChannelNetworkInterface または SwitchedEtherChannelNetworkInterface である場合。
neNameId：AbstractNetworkElement の InstanceNameId。
modifiedPermitListSetting：変更した SpanPermitListSetting オブジェクト。
modifySpanSessions
既存の SPAN セッションを変更します。このメソッドは、SPAN セッションに対応するアソシエーションを変更しません。
ValidationException は、次のいずれかの状況が発生した場合にスローされます。
• modifiedSpanSessions がヌルまたは空であるか、リストの要素のタイプが SpanSession ではない場合。
PropertiesException は、次のいずれかの状況が発生した場合にスローされます。
• SpanSession オブジェクト modifiedSpanSessions のすべてのアトリビュートが無効な場合。
• SpanSession の説明は、Cisco NX-OS プラットフォームだけに適用可能です。
• SpanSession の sessionId が範囲外です。
IntegrityException は、次のいずれかの状況が発生した場合にスローされます。
• modifiedSpanSessions コレクション SpanSession オブジェクト内のオブジェクトの誰かが存在しない場合。
modifySpanSourceTrafficDirection
SPAN 送信元ポートまたは EtherChannel または VLAN から流れるトラフィックの方向を変更します。リモート SPAN はサポートされません。
ValidationException は、次のいずれかの状況が発生した場合にスローされます。
• sessionNameId がヌルであるか、LocalSpanSession の InstanceNameId ではない場合。
• 指定された LocalSpanSession が存在しない場合。
• 指定された送信元 VLAN または NetworkInterface が存在しない場合。
sessionNameId：LocalSpanSession の InstanceNameId。
srcNameId：ポートまたは EtherChannel または VLAN の InstanceNameId。
modifySpanSources
SpanSource アソシエーションのリストを変更します。これによって、ユーザは、既存の VLAN またはインターフェイスのリストのトラフィック方向を SPAN アソシエーションに変更できます。
ValidationException は、次のいずれかの状況が発生した場合にスローされます。
• spanSources がヌルまたは空であるか、タイプが SpanSource ではない場合。
• spanSources で SpanSource に対応するオブジェクトが存在しない場合。
• spanSources のすべてのオブジェクトが LocalSpanSessionAppliesToNetworkInterface または LocalSpanSessionAppliesToVlan ではない場合。
removeDestinationPortsFromSpanSession
宛先ポートまたは Etherchannel をローカル SPAN セッションまたはリモート SPAN 宛先セッションから削除します。
ValidationException は、次のいずれかの状況が発生した場合にスローされます。
• sessionNameId がヌルであるか、LocalSpanSession の InstanceNameId ではない場合。
• 指定された LocalSpanSession が存在しない場合。
• NetworkInterface が完全に削除されるか、セッションに他のアソシエーション（フィルタリング済み VLAN または送信元）がない場合
• dstPortNameIds の InstanceNameId に対応するオブジェクトが存在しない場合。
dstPortNameIds：特定の SPAN セッションから削除するインターフェイスの InstanceNameId のリスト。
removeFilteredVlanRangeInSpanSession
フィルタリング済み VLAN をローカル SPAN セッションから削除します。リモート SPAN はサポートされません。
ValidationException は、次のいずれかの状況が発生した場合にスローされます。
• sessionNameId がヌルであるか、LocalSpanSession の InstanceNameId ではない場合。
• 指定された LocalSpanSession が存在しない場合。
• VLAN が完全に削除されるか、セッションに他のアソシエーション（送信元または宛先）がない場合
• dstPortNameIds の InstanceNameId に対応するオブジェクトが存在しない場合。
sessionNameId：LocalSpanSession の InstanceNameId。
removeFilteredVlansInSpanSession
フィルタリング済み VLAN をローカル SPAN セッションから削除します。リモート SPAN はサポートされません。
ValidationException は、次のいずれかの状況が発生した場合にスローされます。
• sessionNameId がヌルであるか、LocalSpanSession の InstanceNameId ではない場合。
• 指定された LocalSpanSession が存在しない場合。
• VLAN が完全に削除されるか、セッションに他のアソシエーション（送信元または宛先）がない場合
• dstPortNameIds の InstanceNameId に対応するオブジェクトが存在しない場合。
sessionNameId：LocalSpanSession の InstanceNameId。
removePortsFromSpanPermitList
ValidationException は、次のいずれかの状況が発生した場合にスローされます。
• neNameId がヌルであるか、AbstractNetworkElement の InstanceNameId ではない場合。
• 指定された AbstractNetworkElement が存在しない場合。
• interfaceNameIds 内の要素の InstanceNameId が SPAN 宛先として SPAN セッションに関連付けられている場合。
14. 対応するデバイスのセッションの SPAN 宛先として使用される場合は、インターフェイスの削除は許可されません。
removeSourcesFromSpanSession
送信元ポートまたは Etherchannel または VLAN をローカル SPAN セッションから削除します。リモート SPAN はサポートされません。
ValidationException は、次のいずれかの状況が発生した場合にスローされます。
• sessionNameId がヌルであるか、LocalSpanSession の InstanceNameId ではない場合。
• 指定された LocalSpanSession が存在しない場合。
• NetworkInterface または VLAN が完全に削除されるか、セッションに他のアソシエーション（フィルタリング済み VLAN または宛先ポート）がない場合
• srcNameIds の InstanceNameId に対応するオブジェクトが存在しない場合。
sessionNameId：LocalSpanSession の InstanceNameId。
removeSourcesInSpanSession
送信元ポートまたは Etherchannel または VLAN をローカル SPAN セッションから削除します。リモート SPAN セッションはサポートされません。
ValidationException は、次のいずれかの状況が発生した場合にスローされます。
• sessionNameId がヌルであるか、LocalSpanSession の InstanceNameId ではない場合。
• 指定された LocalSpanSession が存在しない場合。
• VLAN が完全に削除されるか、セッションに他のアソシエーション（フィルタリング済み VLAN または宛先ポート）がない場合
sessionNameId：LocalSpanSession の InstanceNameId。
unbindDestinationPortsFromSpanSession
宛先ポートまたは Etherchannel をローカル SPAN セッションまたはリモート SPAN 宛先セッションから削除します。
ValidationException は、次のいずれかの状況が発生した場合にスローされます。
• sessionNameId がヌルであるか、LocalSpanSession の InstanceNameId ではない場合。
• 指定された LocalSpanSession が存在しない場合。
• VLAN が完全に削除されるか、セッションに他のアソシエーション（フィルタリング済み VLAN または宛先ポート）がない場合
• dstPortNameIds で InstanceNameId に対応するオブジェクトが存在しない場合。
sessionNameId：LocalSpanSession の InstanceNameId。
dstPortNameIds：特定の SPAN セッションから削除するインターフェイスの InstanceNameId のリスト。
フィードバック