ENI(Elastic Network Interfaces)のリストを照会します。

説明

  • パラメータを指定した場合、結果をフィルタリングできます。
  • パラメータを指定しない場合、すべての ENI を含むリストが返されます。
  • 一度最大 100 ENI を照会することができます。

リクエストパラメータ

名前 必須かどうか 説明
Action String はい インタフェースの名前。値: DescribeNetworkInterfaces
RegionId String はい リージョン ID。
VSwitchId String いいえ VPC の VSwitch ID。
PrimaryIpAddress String いいえ ENI のプライマリープライベート IP アドレス。
SecurityGroupId String いいえ セキュリティグループ ID。
NetworkInterfaceName String いいえ ENI 名。
Type String いいえ ENI タイプ。オプションの値:
  • Primary
  • Secondary
InstanceId String いいえ >ENI に現在関連付けられているインスタンスの ID。
NetworkInterfaceId.N String いいえ ENI ID。一度に最大 100 ENI を表示できます。
PageNumber Integer いいえ 照会結果のページ番号。ページ番号は正の整数である必要です。

デフォルト値: 1

PageSize Integer いいえ 照会結果のページサイズ。値の範囲: [1,100]

デフォルト値: 10

レスポンスパラメータ

名前 説明
NetworkInterfaceSet NetworkInterfaceSet ネットワークインターフェイスに関する情報
TotalCount Integer インスタンスの総数
PageNumber Integer インスタンスリストのページ番号
PageSize Integer 入力時の 1 ページあたりの行数

リクエストの例
  1. https://ecs.aliyuncs.com/?Action=DescribeNetworkInterfaces&RegionId=cn-hangzhou&<Common Request Parameters>

XML 形式

  1. <DescribeNetworkInterfacesResponse> <NetworkInterfaceSets> <NetworkInterfaceSet> <AssociatedPublicIp /> <CreationTime>2017-11-24T06:14:22Z</CreationTime> <InstanceId>AY121018033933eaxxxxx</InstanceId> <MacAddress>00:16:3e:0f:XX:XX</MacAddress> <NetworkInterfaceId>eni-bp17pdijfczaxZZZZxxxxx</NetworkInterfaceId> XXX. XXX. xx. xx <PrivateIpSets> <PrivateIpSet> <AssociatedPublicIp /> <Primary>true</Primary> <PrivateIpAddress>XXX.XXX.XX.XX</PrivateIpAddress> </PrivateIpSet> </PrivateIpSets> <SecurityGroupIds> <SecurityGroupId>sg-bp144yr32sx6ndwxxxxx</SecurityGroupId> </SecurityGroupIds> <Status>Available</Status> <Type>Secondary</Type> <VpcId>vpc-bp1j7w3gc1cexjqdxxxxx</VpcId> <VSwitchId>vsw-bp16usj2p27htro3xxxxx</VSwitchId> <ZoneId>cn-hangzhou-e</ZoneId> </NetworkInterfaceSet> </NetworkInterfaceSets> <PageNumber>1</PageNumber> <PageSize>100</PageSize> <RequestId>CEE5C347-0B64-4535-A061-95BE95Axxxxx</RequestId> <TotalCount>1</TotalCount></DescribeNetworkInterfacesResponse>
JSON 形式
  1. { NetworkInterfaceSets”: { NetworkInterfaceSet”: [ { AssociatedPublicIp”: { }, CreationTime”: 2017-11-24T06:14:22Z”, InstanceId”: AY121018033933eaxxxxx”, MacAddress”: 00:16:3e:0f:XX:XX”, NetworkInterfaceId”: eni-bp17pdijfczaxZZZZxxxxx”, PrivateIpAddress”: XXX.XXX.XX.XX”, PrivateIpSets”: { PrivateIpSet”: [ { AssociatedPublicIp”: { }, Primary”: true, PrivateIpAddress”: XXX.XXX.XX.XX } ] }, SecurityGroupIds”: { SecurityGroupId”: [ sg-bp144yr32sx6ndwxxxxx ] }, Status”: Available”, Type”: Secondary”, VpcId”: vpc-bp1j7w3gc1cexjqdxxxxx”, VSwitchId”: vsw-bp16usj2p27htro3xxxxx”, ZoneId”: cn-hangzhou-e } ] }, PageNumber”: 1, PageSize”: 100, RequestId”: CEE5C347-0B64-4535-A061-95BE95Axxxxx”, TotalCount”: 1}

エラーコード

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

エラーコード エラーメッセージ HTTP ステータスコード 意味
Abs.InvalidAccount.NotFound 意味 403 指定された Alibaba Cloud アカウントは存在しません。または、AccessKey の有効期限が切れています。
UnsupportedParameter パラメータはサポートされていません。 400 指定されたパラメータは存在しません。あるいは、指定されたパラメータはサポートされていません。
MissingParameter この要求を処理するために必須の入力パラメーターは指定されていません。 400 必要なパラメーターを指定する必要があります。
InvalidEcsId.NotFound 指定された EcsId が見つかりません。 404 指定された InstanceId は存在しません。
InvalidVSwitchId.NotFound 指定された VSwitchId が見つかりません。 404 指定された VSwitchId は存在しません。
InvalidSecurityGroupId.NotFound 指定された SecurityGroupId が見つかりません。 404 指定された SecurityGroupId は存在しません。
InvalidOperation.AvailabilityZoneMismatch 指定された ENI および ECS インスタンスの VPC VS スイッチは、同じアベイラビリティゾーンにありません。 403 指定された VSwitchId、ENI、および InstanceId は同じゾーンにありません。
InvalidOperation.VpcMismatch 指定された ENI とセキュリティグループの VPC が同じ VPC にありません。 403 指定された ENI と SecurityGroupId は同じ VPC にありません。
InvalidSecurityGroupId.NotVpc 指定された SecurityGroupId は VPC にありません。 403 指定された SecurityGroupId は VPC にありません。