Cisco ASR 1000 シリーズアグリゲーションサービスルータソフトウェアコンフィギュレーションガイド（Cisco IOS XE 17）

Cisco IOS XE CLI を使用した REST API サポートの有効化

REST API サポートのためのデータプレーンデュアル管理インターフェイスの設定

Cisco IOS XE 3.16 以降では、管理コンテナの IP アドレスを次のいずれかに関連付けることができます。

データプレーンインターフェイス（以下の手順を参照）

または

管理プレーンインターフェイス（「{start cross reference}REST API サポートのための管理プレーンデュアル管理インターフェイスの設定{end cross reference}」を参照）

設定に関する注意事項

{start blocklabel}ルータ管理インターフェイスのサブネットの管理コンテナ IP アドレス{end blocklabel}

ルータの管理インターフェイスに関連付ける管理コンテナの IP アドレスを割り当てるには、管理コンテナに設定されている IP アドレスがルータの管理インターフェイスと同じサブネット内にあることを確認します。次に例を示します。

管理コンテナの IP アドレス：192.168.5.225

ルータ管理インターフェイス：192.168.5.224

{start blocklabel}ゲートウェイポート、管理インターフェイス、および IP アドレスの設定順序{end blocklabel}

次の順序で管理コンテナの詳細を設定します。

vNIC ゲートウェイポート（vnic gateway virtualportgroup0）
ゲスト IP アドレス

ゲスト IP アドレスの後に vNIC 管理インターフェイス（vnic management GigabitEthernet0）を設定できます。

手順の概要

enable
configure terminal
interface GigabitEthernet x
ip address ipv4-addr subnet-mask
no shutdown
exit
interface virtualportgroup virtualportgroup-number
configure terminal
interface virtualportgroup 0
ip unnumbered GigabitEthernet0/0/0
exit
ip route ipv4-address ipv4-subnet-mask VirtualPortGroup0
exit
ip unnumbered GigabitEthernet x
no shutdown
exit
virtual-service csr_mgmt
vnic gateway virtualportgroup virtualportgroup_number
guest ip address remote-mgmt-ipv4-addr
exit
vnic management GigabitEthernet0
exit
activate
end
ip route ipaddress subnetmask virtualportgroup virtualportgroupnumber

手順の詳細

	コマンドまたはアクション	目的
ステップ 1	enable 例: `Router> enable`	特権 EXEC モードを有効にします。パスワードを入力します（要求された場合）。
ステップ 2	configure terminal 例: `Router# configure terminal`	グローバルコンフィギュレーションモードを開始します。
ステップ 3	interface GigabitEthernet `x` 例: `Router(config)# interface gigabitethernet1`	`x` で指定されたインターフェイスのインターフェイスコンフィギュレーションモードを開始します。 GigabitEthernet の範囲はプラットフォームによって異なります。
ステップ 4	ip address `ipv4-addr` `subnet-mask` 例: `Router(config-if)# ip address 198.51.100.235 255.255.255.128`	管理インターフェイスの IP アドレスを設定します。
ステップ 5	no shutdown 例: `Router(config-if)# no shutdown`	管理インターフェイスを有効にします。
ステップ 6	exit 例: `Router(config-if)# exit`	インターフェイスコンフィギュレーションモードを終了します。
ステップ 7	interface virtualportgroup `virtualportgroup-number` 例: `Router(config)# interface virtualportgroup 0`	仮想ポートグループを作成し、仮想ポートグループインターフェイスコンフィギュレーションモードを開始します。
ステップ 8	configure terminal 例: `Router(config)# configure terminal`	インターフェイスコンフィギュレーションモードを開始します。
ステップ 9	interface virtualportgroup 0 例: `Router(config)# interface virtualportgroup 0`	仮想ポートグループを作成し、仮想ポートグループインターフェイスコンフィギュレーションモードを開始します。
ステップ 10	ip unnumbered GigabitEthernet0/0/0 例: `Router(config)# ip unnumbered GigabitEthernet0/0/0`	明示的な IP アドレスをインターフェイスに割り当てずにインターフェイス上の IP 処理を有効にします。
ステップ 11	exit 例: `Router(config)# exit`	インターフェイスコンフィギュレーションモードを終了します。
ステップ 12	ip route `ipv4-address` `ipv4-subnet-mask` VirtualPortGroup0 例: `Router# ip route 198.51.100.108 255.255.255.255 VirtualPortGroup0`	仮想ポートグループにマッピングする IP ルートを作成します。guest ip address コマンドを使用して設定したものと同じ IP アドレスを使用します。
ステップ 13	exit 例: `Router# exit`	コンフィギュレーションモードを終了します。
ステップ 14	ip unnumbered GigabitEthernet `x` 例: `router(config-if)# ip unnumbered gigabitethernet1`	明示的な IP アドレスをインターフェイスに割り当てずにインターフェイス上の IP 処理を有効にします。
ステップ 15	no shutdown 例: `router(config-if)# no shutdown`	仮想ポートグループインターフェイスを有効にします。
ステップ 16	exit 例: `router(config-if)# exit`	仮想ポートグループインターフェイスモードを終了します。
ステップ 17	virtual-service csr_mgmt 例: `router(config)# virtual-service csr_mgmt`	仮想サービスコンテナを設定し、仮想サービスコンフィギュレーションモードを開始します。
ステップ 18	vnic gateway virtualportgroup `virtualportgroup_number` 例: `router(config-virt-serv)# vnic gateway virtualportgroup 0`	仮想サービスコンテナ用の vNIC ゲートウェイインターフェイスを作成し、仮想ポートグループにマッピングします。
ステップ 19	guest ip address `remote-mgmt-ipv4-addr` 例: `router(config-virt-serv-intf)# guest ip address 198.51.100.236`	仮想サービスコンテナの vNIC ゲートウェイインターフェイスのリモート管理 IP アドレスを設定します。
ステップ 20	exit 例: `router(config-virt-serv-intf)# exit`	仮想サービスインターフェイスコンフィギュレーションモードを終了し、仮想サービスコンフィギュレーションモードに戻ります。
ステップ 21	vnic management GigabitEthernet0 例: `router(config-virt-serv)# vnic management GigabitEthernet0`	（Cisco IOS XE 3.16S 以降のみ） Cisco IOS XE 3.16S 以降では、2 つの vNIC インターフェイスを設定する必要があります。 vNIC ゲートウェイ vNIC 管理
ステップ 22	exit 例: `router(config-virt-serv-vnic)# exit`	vNIC 管理モードを終了します。
ステップ 23	activate 例: `router(config-virt-serv-vnic)# activate`	csr_mgmt 仮想サービスコンテナをアクティブにします。
ステップ 24	end 例: `router(config-virt-serv)# end`	仮想サービスコンフィギュレーションモードを終了し、グローバルコンフィギュレーションモードを開始します。
ステップ 25	ip route `ipaddress` `subnetmask` virtualportgroup `virtualportgroupnumber` 例: `router(config)# ip route 198.51.100.236 255.255.255.255 VirtualPortGroup0`	仮想ポートグループにマッピングする IP ルートを作成します。 guest ip address コマンドを使用して設定したものと同じ IP アドレスを使用します。

REST API サポートのための管理プレーンデュアル管理インターフェイスの設定

Cisco IOS XE 3.16 以降では、管理コンテナの IP アドレスを次のいずれかに関連付けることができます。

管理プレーンインターフェイス（以下の手順を参照）

または

データプレーンインターフェイス（「{start cross reference}REST API サポートのための管理プレーンデュアル管理インターフェイスの設定{end cross reference}」を参照）

設定に関する注意事項

{start blocklabel}ルータ管理インターフェイスのサブネットの管理コンテナ IP アドレス{end blocklabel}

管理コンテナの IP アドレス：192.168.5.225

ルータ管理インターフェイス：192.168.5.224

{start blocklabel}ゲートウェイポート、管理インターフェイス、および IP アドレスの設定順序{end blocklabel}

次の順序で管理コンテナの詳細を設定します。

vNIC ゲートウェイポート（vnic gateway virtualportgroup0）
vNIC 管理インターフェイス（vNIC management GigabitEthernet0）
ゲスト IP アドレス

データプレーンインターフェイスを使用する関連手順とは異なり、この場合は、ゲスト IP アドレスを設定する前に vNIC 管理インターフェイスを設定する必要があります。

手順の概要

enable
configure terminal
interface GigabitEthernet x
ip address ipv4-addr subnet-mask
no shutdown
exit
interface virtualportgroup virtualportgroup-number
configure terminal
interface virtualportgroup 0
ip unnumbered GigabitEthernet0/0/0
exit
ip unnumbered GigabitEthernet x
no shutdown
exit
virtual-service csr_mgmt
vnic gateway virtualportgroup virtualportgroup_number
exit
vnic management GigabitEthernet0
guest ip address guest-mgmt-ipv4-address
exit
activate
end
ip route ipaddress subnetmask virtualportgroup virtualportgroupnumber

手順の詳細

	コマンドまたはアクション	目的
ステップ 1	enable 例: `Router> enable`	特権 EXEC モードを有効にします。パスワードを入力します（要求された場合）。
ステップ 2	configure terminal 例: `Router# configure terminal`	グローバルコンフィギュレーションモードを開始します。
ステップ 3	interface GigabitEthernet `x` 例: `Router(config)# interface gigabitethernet1`	`x` で指定されたインターフェイスのインターフェイスコンフィギュレーションモードを開始します。 GigabitEthernet の範囲はプラットフォームによって異なります。
ステップ 4	ip address `ipv4-addr` `subnet-mask` 例: `Router(config-if)# ip address 198.51.100.235 255.255.255.128`	管理インターフェイスの IP アドレスを設定します。
ステップ 5	no shutdown 例: `Router(config-if)# no shutdown`	管理インターフェイスを有効にします。
ステップ 6	exit 例: `Router(config-if)# exit`	インターフェイスコンフィギュレーションモードを終了します。
ステップ 7	interface virtualportgroup `virtualportgroup-number` 例: `Router(config)# interface virtualportgroup 0`	仮想ポートグループを作成し、仮想ポートグループインターフェイスコンフィギュレーションモードを開始します。
ステップ 8	configure terminal 例: `Router(config)# configure terminal`	インターフェイスコンフィギュレーションモードを開始します。
ステップ 9	interface virtualportgroup 0 例: `Router(config)# interface virtualportgroup 0`	仮想ポートグループを作成し、仮想ポートグループインターフェイスコンフィギュレーションモードを開始します。
ステップ 10	ip unnumbered GigabitEthernet0/0/0 例: `Router(config)# ip unnumbered GigabitEthernet0/0/0`	明示的な IP アドレスをインターフェイスに割り当てずにインターフェイス上の IP 処理を有効にします。
ステップ 11	exit 例: `Router(config)# exit`	インターフェイスコンフィギュレーションモードを終了します。
ステップ 12	ip unnumbered GigabitEthernet `x` 例: `router(config-if)# ip unnumbered gigabitethernet1`	明示的な IP アドレスをインターフェイスに割り当てずにインターフェイス上の IP 処理を有効にします。
ステップ 13	no shutdown 例: `router(config-if)# no shutdown`	仮想ポートグループインターフェイスを有効にします。
ステップ 14	exit 例: `router(config-if)# exit`	仮想ポートグループインターフェイスモードを終了します。
ステップ 15	virtual-service csr_mgmt 例: `router(config)# virtual-service csr_mgmt`	仮想サービスコンテナを設定し、仮想サービスコンフィギュレーションモードを開始します。
ステップ 16	vnic gateway virtualportgroup `virtualportgroup_number` 例: `router(config-virt-serv)# vnic gateway virtualportgroup 0`	仮想サービスコンテナ用の vNIC ゲートウェイインターフェイスを作成し、仮想ポートグループにマッピングします。
ステップ 17	exit 例: `router(config-virt-serv-intf)# exit`	仮想サービスインターフェイスコンフィギュレーションモードを終了し、仮想サービスコンフィギュレーションモードに戻ります。
ステップ 18	vnic management GigabitEthernet0 例: `router(config-virt-serv)# vnic management GigabitEthernet0`	（Cisco IOS XE 3.16S 以降のみ） Cisco IOS XE 3.16S 以降では、2 つの vNIC インターフェイスを設定する必要があります。 vNIC ゲートウェイ vNIC 管理
ステップ 19	guest ip address `guest-mgmt-ipv4-address` 例: `guest ip address 198.51.100.225`	仮想サービスコンテナの vNIC ゲートウェイインターフェイスのリモート管理 IP アドレスを設定します。
ステップ 20	exit 例: `router(config-virt-serv-vnic)# exit`	vNIC 管理モードを終了します。
ステップ 21	activate 例: `router(config-virt-serv)# activate`	csr_mgmt 仮想サービスコンテナをアクティブにします。
ステップ 22	end 例: `router(config-virt-serv)# end`	仮想サービスコンフィギュレーションモードを終了し、グローバルコンフィギュレーションモードを開始します。
ステップ 23	ip route `ipaddress` `subnetmask` virtualportgroup `virtualportgroupnumber` 例: `router(config)# ip route 198.51.100.236 255.255.255.255 VirtualPortGroup0`	仮想ポートグループにマッピングする IP ルートを作成します。 guest ip address コマンドを使用して設定したものと同じ IP アドレスを使用します。

REST API ローカルポートと自動保存オプションの設定

Cisco IOS XE リリース 3.13S 以降では、REST API ローカルポートと自動保存オプションを設定できます。

手順の概要

remote-management
restful-api local-port local-port-number
restful-api autosave 間隔

手順の詳細

コマンドまたはアクション目的

	コマンドまたはアクション	目的
ステップ 1	remote-management 例: `router(config)# remote-management`	リモート管理コンフィギュレーションモードを開始します。
ステップ 2	restful-api local-port `local-port-number` 例: `router(cfg-remote-mgmt)# restful-api local-port 55443`	REST API ローカルポート番号を設定します。有効な範囲は、REST API 仮想サービスコンテナが管理インターフェイスと同じ IP アドレスを使用するか、別の IP アドレスを使用するかによって異なります。デュアル管理インターフェイスが設定されている場合の有効な範囲は 1 ～ 61000 です。共有管理インターフェイスが設定されている場合の有効な範囲は 55001 ～ 61000 です。どちらの場合も、デフォルト値は 55443 です。
ステップ 3	restful-api autosave `間隔` 例: `Router(cfg-remote-mgmt)# restful-api autosave 60`	REST API の自動保存間隔を設定します。範囲は 30 ～ 300 秒で、デフォルトは 30 秒です。

ステップ 1

remote-management

例:


router(config)# remote-management

リモート管理コンフィギュレーションモードを開始します。

ステップ 2

restful-api local-port local-port-number

例:


router(cfg-remote-mgmt)# restful-api local-port 55443

REST API ローカルポート番号を設定します。有効な範囲は、REST API 仮想サービスコンテナが管理インターフェイスと同じ IP アドレスを使用するか、別の IP アドレスを使用するかによって異なります。

デュアル管理インターフェイスが設定されている場合の有効な範囲は 1 ～ 61000 です。
共有管理インターフェイスが設定されている場合の有効な範囲は 55001 ～ 61000 です。

どちらの場合も、デフォルト値は 55443 です。

ステップ 3

restful-api autosave 間隔

例:


Router(cfg-remote-mgmt)# restful-api autosave 60

REST API の自動保存間隔を設定します。範囲は 30 ～ 300 秒で、デフォルトは 30 秒です。

ONEP の設定

オープンネットワーク環境プログラミングインターフェイス（ONEP）は、Cisco IOS および REST API のサービスセットを定義するために使用されます。次の手順で ONEP を設定します。

手順の概要

conf t
onep
service set vty
end

手順の詳細

	コマンドまたはアクション	目的
ステップ 1	conf t 例: `asr1k#conf t` 例: `Enter configuration commands, one per line. End with CNTL/Z.`	コンフィギュレーションモードに入ります。
ステップ 2	onep 例: `asr1k(config)#onep`	ONEP モードを開始します。
ステップ 3	service set vty 例: `asr1k(config-onep)#service set vty`	VTY サービスセットを選択します。
ステップ 4	end 例: `asr1k(config-onep)#end` 例: `asr1k#`	ONEP モードを終了します。

REST API サポートの無効化

REST API のサポートはデフォルトで有効になっています。次の手順で REST API を無効にします。

手順の概要

enable
configure terminal
remote-management
no restful-api
end

手順の詳細

	コマンドまたはアクション	目的
ステップ 1	enable 例: `router> enable`	特権 EXEC モードを有効にします。パスワードを入力します（要求された場合）。
ステップ 2	configure terminal 例: `router# configure terminal`	グローバルコンフィギュレーションモードを開始します。
ステップ 3	remote-management 例: `router(config)# remote-management`	リモート管理コンフィギュレーションモードを開始します。
ステップ 4	no restful-api 例: `router(cfg-remote-mgmt)# no restful-api`	REST API のサポートを無効にします。
ステップ 5	end 例: `router(cfg-remote-mgmt)# end`	リモート管理コンフィギュレーションモードを終了し、コンフィギュレーションモードを開始します。

次のタスク

（注）

no restful-api コマンドを使用して REST API サポートを無効にすると、REST API の PUT、POST、および DELETE 操作が無効になります。ただし、GET 操作は引き続き使用できます。

REST API コンテナステータスの表示

show virtual-service detail コマンドを使用して、REST API コンテナのステータスを表示します。

Cisco ASR 1000 シリーズ アグリゲーション サービス ルータ ソフトウェア コンフィギュレーション ガイド（Cisco IOS XE 17）

偏向のない言語

翻訳について

検索結果

章のタイトル： REST API による管理の有効化

REST API による管理の有効化

はじめに

インストールの概要

Cisco IOS XE CLI を使用した REST API サポートの有効化

REST API サポートのためのデータプレーンデュアル管理インターフェイスの設定

設定に関する注意事項

手順の概要

手順の詳細

例:

例:

例:

例:

例:

例:

例:

例:

例:

例:

例:

例:

例:

例:

例:

例:

例:

例:

例:

例:

例:

例:

例:

例:

例:

REST API サポートのための管理プレーンデュアル管理インターフェイスの設定

設定に関する注意事項

手順の概要

手順の詳細

例:

例:

例:

例:

例:

例:

例:

例:

例:

例:

例:

例:

例:

例:

例:

例:

例:

例:

例:

例:

例:

例:

例:

REST API ローカルポートと自動保存オプションの設定

手順の概要

手順の詳細

例:

例:

例:

ONEP の設定

手順の概要

手順の詳細

例:

例:

例:

例:

例:

例: