edit-icon download-icon

CreateNetworkInterface

最終更新日: Aug 01, 2018

Elastic Network Interface(ENI)を作成します。

説明

  • 新しい ENI のデフォルトステータスは Available です。

  • ENI は、 ENI の同じゾーンにある VPC 接続インスタンスにのみ接続できます。

  • ENI は 1 つのインスタンスにのみ接続できるため、別のインスタンスに接続する前に ENI をインスタンスから切り離す必要があります。

  • ENI のプロパティは、ENI がどのインスタンスに接続されても変更されません。さらに、ENI が接続されているインスタンスが変更された場合、ネットワークトラフィックは新しいインスタンスにリダイレクトされます。

  • デフォルトでは、1 つのアカウントで 1 つのリージョンで最大 100 の ENI を所有できます。より多く割り当てたい場合は, チケットを起票してください。

リクエストパラメータ

名前 必須かどうか 説明
Action String はい インタフェースの名前。値: CreateNetworkInterface
RegionId String はい インスタンスのリージョン ID。リージョン ID リストの詳細については、リージョンとゾーンを参照し、またはDescribeRegionsを照会することによってリージョンリストを表示します。
VSwitchId String はい 指定された VPC の VSwitch ID。
PrimaryIpAddress String いいえ ENI のプライマリープライベート IP アドレス。指定された IP アドレスは、VSwitch と同じホスト ID を持つ必要があります。IP アドレスが指定されていない場合は、ENI にランダムなネットワーク ID が割り当てられます。
SecurityGroupId String はい ENIが属するセキュリティグループの ID。セキュリティグループと ENI は同じ VPC 内である必要があります。
NetworkInterfaceName String いいえ ENI の名前。
  • [2,128]の漢字または英文字の文字列です。文字で始まり、数字、アンダースコア(_)、コロン(:)、ハイフン( - )を含めることができます。
  • ENI 名がコンソールに表示されます。
  • http:// または https:// で始めることはできません。
  • このパラメータを指定しないと、デフォルトでは NULL になります。
Description String いいえ ENI の説明。
  • [2,256]の漢字または英文字の文字列です
  • http:// または https:// で始めることはできません。
  • このパラメーターを指定しないと、デフォルトでは NULL になります。
ClientToken String いいえ リクエストのべき等性を保証するために使用されます。値はクライアントによって生成されます。すべての要求で一意でなければならず、最大64文字の ASCII 文字を含めることができます。
詳細は、べき等性を確保する方法を参照してください。

レスポンスパラメータ

Name Type Description
NetworkInterfaceId String ネットワークインタフェースの ID。

リクエストの例

  1. https://ecs.aliyuncs.com/?Action=CreateNetworkInterface
  2. &RegionId=cn-hangzhou
  3. &VSwitchId=[vswitchid]
  4. &SecurityGroupId=sg-c0003exxxxx
  5. &<Common Request Parameters>

レスポンスの例

XML 形式

  1. <CreateNetworkInterfaceResponse>
  2. <RequestId>04F0F334-1335-436C-A1D7-6C044FExxxxx</RequestId>
  3. <NetworkInterfaceId>eni-eniIxxxxx</NetworkInterfaceId>
  4. </CreateNetworkInterfaceResponse>

JSON 形式

  1. {
  2. "RequestId": "04F0F334-1335-436C-A1D7-6C044FExxxxx",
  3. "NetworkInterfaceId": "eni-eniIxxxxx"
  4. }

エラーコード

エラーコード エラーメッセージ HTTP ステータスコード 意味
Abs.InvalidAccount.NotFound アカウントが見つからないか、AK が期限切れです。 403 指定された Alibaba Cloud アカウントは存在しません。または、AccessKey の有効期限が切れています。
Forbedden.NotSupportRAM このアクションは、RAM モードではアクセスできません。 403 RAM ユーザーは、リソースへのアクセスに制限されています。
UnsupportedParameter パラメータはサポートされていません。 400 指定されたパラメータは存在しません。あるいは、指定されたパラメータはサポートされていません。
Forbbiden.SubUser 指定された操作は使用できません。 403 RAM ユーザーは、リソースへのアクセスに制限されています。
MissingParameter この要求を処理するために必須の入力パラメーターは指定されていません。 400 必要なパラメーターを指定する必要があります。
InvalidEcsId.NotFound 指定された EcsId が見つかりません。 404 指定された InstanceId は存在しません。
InvalidVSwitchId.NotFound 指定された VSwitchId が見つかりません。 404 指定された VSwitchId は存在しません。
InvalidSecurityGroupId.NotFound 指定された SecurityGroupId が見つかりません。 404 指定された SecurityGroupId は存在しません。
MaxEniCountExceeded ENI の数がリージョンごとの制限を超えています。 403 指定されたリージョンの ENI の最大数を超えています。
InvalidOperation.availabilityzonemismatch 指定された ENI および ECS インスタンスの VPC VS スイッチは、同じアベイラビリティゾーンにありません。 403 指定された VSwitchId、ENI、および InstanceId は同じゾーンにありません。
InvalidOperation.VpcMismatch 指定された ENI とセキュリティグループの VPC が同じ VPC にありません。 403 指定された ENI と SecurityGroupId は同じ VPC にありません。
SecurityGroupInstanceLimitExceed セキュリティグループ内のインスタンスの最大数を超えています。 403 指定した SecurityGroupId のインスタンスの最大数を超えています。
InvalidSecurityGroupId.NotVpc 指定された SecurityGroupId は VPC にありません。 403 指定された SecurityGroupId は VPC にありません。