すべてのプロダクト
Search
ドキュメントセンター

Elastic Container Instance:ECI インスタンスの固定 IP の設定

最終更新日:Jun 22, 2026

デフォルトでは、ECI インスタンスの IP アドレスは、インスタンスがリリースされると同時にリリースされます。ご利用のアプリケーションで永続的な IP アドレスが必要な場合は、固定 IP アドレス機能を有効にできます。この機能により、インスタンスがリリースされた後も、指定された期間 IP アドレスが保持されます。この期間内に、保持されている IP アドレスを新しいインスタンスに再割り当てすることで、サービスの IP の継続性を確保できます。このトピックでは、ECI インスタンスで固定 IP アドレスを使用するように設定する方法について説明します。

仕組み

デフォルトでは、ECI インスタンスを作成すると、指定された vSwitch の CIDR ブロックから IP アドレスがランダムに割り当てられます。インスタンスがリリースされると、その IP アドレスもリリースされ、新しいインスタンスには異なる IP アドレスが割り当てられます。IP アドレスを介して直接公開されるサービスなど、特定のビジネスシナリオでは、業務継続性を確保するために永続的な IP アドレスが必要になります。

この要件に対応するため、ECI は固定 IP アドレス機能を提供しています。この機能を有効にして ECI インスタンスを作成すると、指定された vSwitch の CIDR ブロックから、動的 IP アドレス (内部の非表示アドレス) と固定 IP アドレスの 2 つの IP アドレスが割り当てられます。インスタンスがリリースされた後、システムはその固定 IP アドレスを保持します。保持期間 (デフォルトでは 48 時間) 内に、同じインスタンス名、同じ vSwitch で、固定 IP アドレス機能を有効にして新しいインスタンスを作成すると、システムは保持されている IP アドレスを新しいインスタンスに再割り当てします。これにより、サービスの IP アドレスは同じままになります。

パラメーター

CreateContainerGroup API オペレーションを呼び出して ECI インスタンスを作成する際に、FixedIp などのパラメーターを使用して固定 IP アドレス機能を有効にできます。次の表に、関連するパラメーターを示します。詳細については、「CreateContainerGroup」をご参照ください。

パラメーター

タイプ

説明

VSwitchId

string

vsw-bp1xpiowfm5vo8o3c****

インスタンスが属する vSwitch の ID。

固定 IP アドレス機能を有効にする場合は、vSwitch を指定する必要があります。

SecurityGroupId

string

sg-2ze468xqmne3u4ak*

インスタンスが属するセキュリティグループの ID。

vSwitch を指定する場合は、セキュリティグループを指定する必要があります。

FixedIp

string

true

このパラメーターを true に設定すると、インスタンスの固定 IP アドレス機能が有効になります。

FixedIpRetainHour

integer

24

インスタンスがリリースされた後の固定 IP アドレスの保持期間を時間単位で指定します。デフォルト値は 48 です。

  1. 固定 IP アドレス機能を有効にして、A という名前の ECI インスタンスを作成します。

    次の例は、CreateContainerGroup API オペレーションを呼び出してインスタンス A を作成するためのパラメーターを示しています。

    RegionId=cn-beijing
    SecurityGroupId=sg-bp1daxpbz9lzpvvc****
    VSwitchId=vsw-bp1gds63lmlm7ib05****
    ContainerGroupName=test
    Container.1.Name=nginx1
    Container.1.Image=registry-vpc.cn-beijing.aliyuncs.com/eci_open/nginx:1.14.2
    FixedIp=true
  2. インスタンス A の IP アドレスを確認します。

    返されたインスタンス ID を使用して DescribeContainerGroups API オペレーションを呼び出すか、コンソールで IP アドレスを表示できます。

    ECI インスタンスのリストページで、[IP アドレス] 列にインスタンス A の内部 IP アドレス (例:172.16.11.71) が表示されます。

  3. インスタンス A を削除します。

  4. B という名前の ECI インスタンスを作成します。

    次のパラメーターを使用して CreateContainerGroup API オペレーションを呼び出し、インスタンス B を作成します。インスタンス名と vSwitch はインスタンス A と同じで、固定 IP アドレス機能が有効になっています。

    RegionId=cn-beijing
    SecurityGroupId=sg-bp1daxpbz9lzpvvc****
    VSwitchId=vsw-bp1gds63lmlm7ib05****
    ContainerGroupName=test
    Container.1.Name=nginx2
    Container.1.Image=registry-vpc.cn-beijing.aliyuncs.com/eci_open/nginx:1.15.10
    FixedIp=true
  5. インスタンス B の IP アドレスがインスタンス A と同じであることを確認します。

    ECI インスタンスのリストページで、[IP アドレス] 列にあるインスタンス B の内部 IP アドレスが、インスタンス A のもの (例:172.16.11.71) と同じであることを確認します。