AttachNetworkInterface - - Alibaba Cloud ドキュメントセンター

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 のタイプのため失敗しました。