19 IPネットワーク
IPネットワークを使用すると、アカウントにIPサブネットを定義できます。 IPサブネットのサイズおよびサブネットに設定されるIPアドレスは、IPネットワークの作成時に指定したIPアドレス・プレフィックスによって決定されます。 これらのIPアドレスは、共有ネットワークによって使用されるオラクル社提供のIPアドレスの共通プールの一部ではありません。 インスタンスをIPネットワークに接続すると(インスタンスの起動プランにネットワークを指定することによって)、インスタンスにはそのサブネットのIPアドレスが割り当てられます。 IPアドレスは、ビジネスのニーズに応じて、静的または動的にインスタンスに割り当てることができます。 このため、インスタンスに割り当てられるIPアドレスを完全に制御できます。 詳細については、「Oracle Cloud Infrastructure Compute Classicの使用」の「IPネットワークの管理」を参照してください。
この節で説明するCLIコマンドを実行する前に、CLIクライアントをインストールして、「CLIを使用するための準備」で説明されているように必要な環境変数を設定していることを確認してください。
ip-network add
IPネットワークを作成します。 IPネットワークを使用すると、アカウントにIPサブネットを定義できます。 IPネットワークを使用すると、個別のIPネットワークを作成して、インスタンスを特定のネットワークに追加することによって、インスタンスを分離できます。 トラフィックは同じIPネットワーク内のインスタンス間をフローできますが、デフォルトでは各ネットワークは他のネットワークおよびパブリックなインターネットから分離されています。
必要なロール
このタスクを実行するには、Compute_Operationsのロールが必要です。 このロールが自分に割り当てられていない場合または不確実な場合は、システム管理者にOracle Cloud 「Infrastructure Classicコンソール」でそのロールが割り当てられていることを確認するように依頼してください。 「Oracle Cloudの管理とモニタリング」の「ユーザー・ロールの変更」を参照してください。
構文
opc compute ip-network add name ip-address-prefix [--ipnetworkexchange IP-network-exchange] [--description description] [--tags tags]
このコマンドのパラメータとオプションのヘルプについては、-hオプションを指定してコマンドを実行してください。
例
opc -f json compute ip-network add /Compute-acme/jack.jones@example.com/ipnet1 192.168.0.0/24
サンプル出力
{
"uri": "https://api-z999.compute.us0.oraclecloud.com:443/network/v1/ipnetwork/Compute-acme/jack.jones@example.com/ipnet1",
"ipNetworkExchange": null,
"ipAddressPrefix": "192.168.0.0/24",
"name": "/Compute-acme/jack.jones@example.com/ipnet1"
}
ip-network list
指定したコンテナ内のすべてのIPネットワークの詳細を取得します。
必要なロール
このタスクを実行するには、Compute_MonitorまたはCompute_Operationsのロールが必要です。 このロールが自分に割り当てられていない場合または不確実な場合は、システム管理者にOracle Cloud 「Infrastructure Classicコンソール」でそのロールが割り当てられていることを確認するように依頼してください。 「Oracle Cloudの管理とモニタリング」の「ユーザー・ロールの変更」を参照してください。
構文
opc compute ip-network list container
このコマンドのパラメータとオプションのヘルプについては、-hオプションを指定してコマンドを実行してください。
例
opc -f json compute ip-network list /Compute-acme/jack.jones@example.com
サンプル出力
{
"result": [
{
"uri": "https://api-z999.compute.us0.oraclecloud.com:443/network/v1/ipnetwork/Compute-acme/jack.jones@example.com/ipnet1",
"ipNetworkExchange": null,
"ipAddressPrefix": "192.168.0.0/24",
"name": "/Compute-acme/jack.jones@example.com/ipnet1"
}
]
}ip-network get
指定したIPネットワークの詳細を取得します。
getコマンドを使用して、addおよびupdate操作が正常に完了したかどうかを確認できます。
必要なロール
このタスクを実行するには、Compute_MonitorまたはCompute_Operationsのロールが必要です。 このロールが自分に割り当てられていない場合または不確実な場合は、システム管理者にOracle Cloud 「Infrastructure Classicコンソール」でそのロールが割り当てられていることを確認するように依頼してください。 「Oracle Cloudの管理とモニタリング」の「ユーザー・ロールの変更」を参照してください。
構文
opc compute ip-network get name
このコマンドのパラメータとオプションのヘルプについては、-hオプションを指定してコマンドを実行してください。
例
opc -f json compute ip-network get /Compute-acme/jack.jones@example.com/ipnet1
サンプル出力
{
"uri": "https://api-z999.compute.us0.oraclecloud.com:443/network/v1/ipnetwork/Compute-acme/jack.jones@example.com/ipnet1",
"ipNetworkExchange": null,
"ipAddressPrefix": "192.168.0.0/24",
"name": "/Compute-acme/jack.jones@example.com/ipnet1"
}
ip-network update
ネットワークを作成してインスタンスをそのネットワークに接続した後に、IPネットワークを更新してネットワークに指定したIPアドレス・プレフィックスを変更できます。 ただし、IPアドレス・プレフィックスを変更する場合、既存のインスタンスに現在割り当てられているIPアドレスが指定したIPネットワークの外側になることがあります。 これが発生した場合、それらのvNICで送受信されるすべてのトラフィックは削除されます。
インスタンスのIPアドレスが動的に割り当てられる場合、インスタンス・オーケストレーションを停止して再起動すると、有効なIPアドレスがIPネットワークからインスタンスに再割当てされます。
ただし、インスタンスのIPアドレスが静的な場合(つまり、インスタンスの作成時にインスタンス・オーケストレーションにIPアドレスが指定された場合)、インスタンス・オーケストレーションを停止して再起動することによって、IPアドレスは更新できません。 そのIPネットワークに接続されているvNICに有効なIPアドレスを割り当てるには、オーケストレーションを手動で更新する必要があります。
このため、IPネットワークを更新する場合は、より短いプレフィックス長で同じIPアドレス・プレフィックスを指定することによってのみ、ネットワークを拡張することをお薦めします。 たとえば、192.168.1.0/24を192.168.1.0/20に拡張できます。 ただし、IPアドレスは変更しないでください。 これにより、インスタンスに現在割り当てられているすべてのIPアドレスが、更新されたIPネットワークで有効な状態で維持されます。
必要なロール
このタスクを実行するには、Compute_Operationsのロールが必要です。 このロールが自分に割り当てられていない場合または不確実な場合は、システム管理者にOracle Cloud 「Infrastructure Classicコンソール」でそのロールが割り当てられていることを確認するように依頼してください。 「Oracle Cloudの管理とモニタリング」の「ユーザー・ロールの変更」を参照してください。
構文
opc compute ip-network update name ipaddressprefix [--ip-network-exchange ip-Network-Exchange] [--description description] [--tags tags]
このコマンドのパラメータとオプションのヘルプについては、-hオプションを指定してコマンドを実行してください。
例
このコマンドは、IPネットワーク/Compute-acme/jack.jones@example.com/ipnet1のIPアドレス・プレフィックスを192.168.0.0/24から192.168.0.0/20に更新し、そのIPネットワークを指定したIPネットワーク交換に追加します。
opc -f json compute ip-network update --ip-network-exchange /Compute-acme/jack.jones@example.com/ipexchange1 /Compute-acme/jack.jones@example.com/ipnet1 192.168.0.0/20
サンプル出力
{
"uri": "https://api-z999.compute.us0.oraclecloud.com:443/network/v1/ipnetwork/Compute-acme/jack.jones@example.com/ipnet1",
"ipNetworkExchange": "/Compute-acme/jack.jones@example.com/ipNetworkExchange1",
"ipAddressPrefix": "192.168.0.0/20",
"name": "/Compute-acme/jack.jones@example.com/ipnet1"
}
ip-network delete
指定したIPネットワークを削除します。 レスポンスは返されません。
インスタンスが含まれているIPネットワークを削除した場合、そのIPネットワーク内のインスタンスで送信されるパケットは削除されます。
必要なロール
このタスクを実行するには、Compute_Operationsのロールが必要です。 このロールが自分に割り当てられていない場合または不確実な場合は、システム管理者にOracle Cloud 「Infrastructure Classicコンソール」でそのロールが割り当てられていることを確認するように依頼してください。 「Oracle Cloudの管理とモニタリング」の「ユーザー・ロールの変更」を参照してください。
構文
opc compute ip-network delete name
このコマンドのパラメータとオプションのヘルプについては、-hオプションを指定してコマンドを実行してください。
例
opc compute ip-network delete /Compute-acme/jack.jones@example.com/ipnet1