ENI(Elastic Network Interface)を VPC インスタンスに接続します。

  • ENI は「使用可能」の状態でなければなりません。

  • インスタンスは StoppedまたはRunningステータスでなければなりません。

  • 1つのENIをVPC接続インスタンスに接続することができ、ENIはインスタンスと同じVPCになければなりません。

  • 1つのENIは1つのインスタンスにのみ接続できます。

  • 1つのインスタンスを複数のENIに同時にアタッチすることができます。 各インスタンスタイプに接続できるENIの数については、Elastic network interfacesを参照してください。

  • 異なるゾーンからのVSwitchを1つのVPCに展開することはできないため、インスタンスに接続されているENIは、ENIが属するVSwitchと同じゾーンになければなりません。

リクエストパラメータ

名前 タイプ 必須 説明
Action String はい このインタフェースの名前。値:AttachNetworkInterface
RegionId String はい ECS インスタンスのリージョン ID。詳細については、 リージョン IDリスト、DescribeRegionsを照会することによってリスト。
NetworkInterfaceId String はい ENI ID
InstanceId String はい インスタンス ID

レスポンスパラメータ

すべてが共通の応答パラメータです。詳細は、共通パラメータを参照してください。

リクエストの例

https://ecs.aliyuncs.com/?Action=AttachNetworkInterface
&RegionId=cn-hangzhou
&NetworkInterfaceId=[networkInterfaceId]
&InstanceId=AY121018033933eaxxxxx
&<Common Request Parameters>

レスポンスの例

XML形式

<AttachNetworkInterfaceResponse>
    <RequestId>04F0F334-1335-436C-A1D7-6C044FExxxxx</RequestId>
</AttachNetworkInterfaceResponse>

JSON形式

{
    "RequestId": "04F0F334-1335-436C-A1D7-6C044FExxxxx"
}

エラーコード

次のエラーコードは、このインタフェースに固有のものです。その他のエラーコードについては、API エラーコードセンターをご参照ください。

エラーコード エラーメッセージ HTTPステータスコード 意味
Abs.InvalidAccount.NotFound アカウントが見つからないか、ak が期限切れです。 403 指定された Alibaba Cloud アカウントは存在しません。または、AccessKey の有効期限が切れています。
Forbidden.NotSupportRAM このアクションは、RAM モードではアクセスできません。 403 RAM ユーザーは、リソースへのアクセスに制限されています。
UnsupportedParameter パラメータはサポートされていません。 400 指定されたパラメータは存在しません。あるいは、指定されたパラメータはサポートされていません。
Forbidden.SubUser 指定された操作は使用できません。 403 RAMユーザーは、リソースへのアクセスに制限されています。
InvalidOperation.InvalidEcsState この操作は、現在の ECS 状態では許可されていません。 400 指定されたアクションは、インスタンスの状況のために失敗しました。
InvalidOperation.DetachPrimaryEniNotAllowed ECS インスタンスからプライマリ ENI を削除することはできません。 400 プライマリネットワークインターフェイスを ECS インスタンスから切り離すことはできません。
MissingParameter この要求を処理するために必須の入力パラメーターは指定されていません。 400 必要なパラメーターを指定する必要があります。
InvalidEcsId.NotFound 指定された EcsId が見つかりません。 404 指定されたInstanceIdは存在しません。
EniPerInstanceLimitExceeded ENI の数が、起動しようとしているインスタンスのタイプの上限を超えています。 403 指定されたタイプの ECS インスタンスでは、ENI の最大数を超えています。
InvalidOperation.VpcMismatch 指定された ENI とセキュリティグループの VPC が同じ VPC にありません。 403 指定された ENI と SecurityGroupId は同じ VPC にありません。
SecurityGroupInstanceLimitExceed セキュリティグループ内のインスタンスの最大数を超えています。 403 指定した SecurityGroupId のインスタンスの最大数を超えています。
InvalidOperation.InvalidEniType この操作は、現在の ENI タイプでは許可されていません。 403 指定されたアクションは ENI のタイプのため失敗しました。