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

Elastic Compute Service:DescribeNetworkInterfaceAttribute

最終更新日:Sep 20, 2026

ENI ID を指定して、Elastic Network Interface (ENI) の詳細を照会します。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

  • アクション:特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

  • API:アクションを具体的に実行するための API。

  • アクセスレベル:各 API に対して事前定義されているアクセスの種類。有効な値:create、list、get、update、delete。

  • リソースタイプ:アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

    • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

    • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

  • 条件キー:サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

  • 依存アクション:ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

ecs:DescribeNetworkInterfaceAttribute

get

*NetworkInterface。

acs:ecs:{#regionId}:{#accountId}:eni/{#eniId}

なし なし

リクエストパラメーター

パラメーター

型

必須 / 任意

説明

例

RegionId

string

必須

ネットワークインターフェースコントローラー (NIC) のリージョン ID。 DescribeRegions を呼び出して、最新のリージョンリストをクエリできます。

cn-hangzhou

Tag

array<object>

任意

説明

このパラメーターは使用できません。

object

任意

説明

このパラメーターは使用できません。

Key

string

任意

説明

このパラメーターは使用できません。

TestKey

Value

string

任意

説明

このパラメーターは使用できません。

TestValue

NetworkInterfaceId

string

必須

ネットワークインターフェースコントローラー (NIC) の ID。

eni-bp67acfmxazb4p****

Attribute

string

任意

Elastic Network Interface (ENI) のプロパティ。有効な値:

attachment: トランクネットワークインターフェースコントローラー (NIC) のメンバーネットワークインターフェースコントローラー (NIC) の添付ファイル情報をクエリします。このパラメーターは招待プレビュー中であり、使用できません。

connectionTrackingConfiguration: ネットワーク接続性追跡構成をクエリします。

デフォルト値: 空。

添付ファイル

レスポンスフィールド

フィールド

型

説明

例

object

ENI 情報のコレクション。

CreationTime

string

ネットワークインターフェース (NIC) が作成された時間。時間は ISO 8601 形式で、協定世界時 (UTC) で表示されます。

2019-12-25T12:31:31Z

VpcId

string

ネットワークインターフェース (NIC) が属する VPC の ID。

vpc-bp67acfmxazb4p****

Type

string

Elastic Network Interface (ENI) のタイプ。有効な値:

  • Primary: プライマリネットワークインターフェース (NIC)。

  • Secondary: セカンダリ ENI。

Secondary

Status

string

ネットワークインターフェース (NIC) のステータス。有効な値:

  • Available: アクティブ。

  • Attaching: 接続中。

  • InUse: 使用中。

  • Detaching: 切断中。

  • Deleting: 削除中。

デフォルト値: 空。空は、すべての状態のネットワークインターフェース (NIC) を照会することを示します。

Available

NetworkInterfaceTrafficMode

string

ネットワークインターフェース (NIC) の通信モード。有効な値:

  • Standard: 標準の TCP 通信モードが使用されます。

  • HighPerformance: Elastic RDMA インターフェース (ERI) が有効化され、RDMA 通信モードが使用されます。

説明

HighPerformance パラメーター値は、c7re RDMA 強化インスタンスファミリーでのみサポートされています。

標準

NetworkInterfaceName

string

ネットワークインターフェース (NIC) の名前。

my-eni-name

MacAddress

string

ネットワークインターフェース (NIC) の MAC アドレス。

00:16:3e:12:**:**

QueuePairNumber

integer

説明

このパラメーターは招待プレビュー中であり、一般公開されていません。

22

NetworkInterfaceId

string

ネットワークインターフェース (NIC) の ID。

eni-bp125p95hhdhn3ot****

ServiceID

integer

ネットワークインターフェース (NIC) に関連付けられている Virtual Network Operator (VNO) ID。

12345678910

InstanceId

string

ネットワークインターフェース (NIC) が接続されているインスタンスの ID。

説明

他の Alibaba Cloud サービスによって管理および制御されているネットワークインターフェース (NIC) は、インスタンス ID を返しません。

i-bp1e2l6djkndyuli****

OwnerId

string

ネットワークインターフェース (NIC) を所有するアカウントの ID。

123456****

ServiceManaged

boolean

ネットワークインターフェース (NIC) のユーザーが Alibaba Cloud サービスまたは VNO であるかどうかを示します。

true

VSwitchId

string

ネットワークインターフェース (NIC) が属する vSwitch の ID。

vsw-bp1s5fnvk4gn2tws0****

RequestId

string

リクエスト ID

473469C7-AA6F-4DC5-B3DB-A3DC0DE3****

Description

string

ネットワークインターフェース (NIC) の説明。

testDescription

ResourceGroupId

string

インスタンスが属するリソースグループの ID。このパラメーターを使用してリソースをフィルター処理する場合、リソース数は 1000 を超えることはできません。

説明

デフォルトのリソースグループによるフィルター処理はサポートされていません。

rg-bp67acfmxazb4p****

ZoneId

string

ゾーン ID。

cn-hangzhou-g

PrivateIpAddress

string

ネットワークインターフェース (NIC) の非公開 IP アドレス。

10.1.**.**

QueueNumber

integer

Elastic Network Interface (ENI) のキュー数。

  • ENI がプライマリネットワークインターフェース (NIC) の場合: インスタンスタイプで許可されているプライマリ NIC のデフォルトのキュー数が返されます。

  • ENI がセカンダリ ENI の場合:

    • セカンダリ ENI が InUse 状態の場合:
      • セカンダリ ENI のキュー数が変更されていない場合、インスタンスタイプで許可されているセカンダリ ENI のデフォルトのキュー数が返されます。

      • セカンダリ ENI のキュー数が変更されている場合、変更済みのキュー数が返されます。

    • セカンダリ ENI がアクティブ (Available) 状態の場合:
      • セカンダリ ENI のキュー数が変更されていない場合、空の値が返されます。

      • セカンダリ ENI のキュー数が変更されている場合、変更済みのキュー数が返されます。

8

SecurityGroupIds

object

SecurityGroupId

array

ネットワークインターフェース (NIC) が属するセキュリティグループのコレクション。

string

ネットワークインターフェース (NIC) が属するセキュリティグループ。

sg-bp18kz60mefsicfg****

AssociatedPublicIp

object

ネットワークインターフェース (NIC) のセカンダリ非公開 IP アドレスに関連付けられている EIP。

PublicIpAddress

string

EIP アドレス。

116.62.**.**

AllocationId

string

EIP の ID。

null

Attachment

object

説明

このパラメーターは招待プレビュー中であり、一般公開されていません。

DeviceIndex

integer

説明

このパラメーターは招待プレビュー中であり、一般公開されていません。

hide

InstanceId

string

説明

このパラメーターは招待プレビュー中であり、一般公開されていません。

hide

TrunkNetworkInterfaceId

string

説明

このパラメーターは招待プレビュー中であり、一般公開されていません。

hide

MemberNetworkInterfaceIds

object

MemberNetworkInterfaceId

array

説明

このパラメーターは招待プレビュー中であり、一般公開されていません。

string

説明

このパラメーターは招待プレビュー中であり、一般公開されていません。

hide

NetworkCardIndex

integer

ENI が接続されているネットワークカードのインデックス。

  • ENI が Available 状態であるか、添付ファイルの際にインデックスが指定されなかった場合、この値は返されません。

  • ENI が InUse 状態であり、添付ファイルの際にインデックスが指定された場合、この値は ENI が接続されているネットワークカードのインデックスを示します。

0

PrivateIpSets

object

PrivateIpSet

array<object>

ネットワークインターフェース (NIC) の非公開 IP アドレス情報のコレクション。

array<object>

ネットワークインターフェース (NIC) の非公開 IP アドレス情報。

PrivateIpAddress

string

ネットワークインターフェース (NIC) の非公開 IP アドレス。

172.17.**.**

Primary

boolean

IP アドレスがプライマリ非公開 IP アドレスであるかどうかを示します。有効な値:

  • true: プライマリ非公開 IP アドレス。

  • false: セカンダリ非公開 IP アドレス。

true

AssociatedPublicIp

object

ネットワークインターフェース (NIC) のセカンダリ非公開 IP アドレスに関連付けられている EIP。

PublicIpAddress

string

EIP アドレス。

116.62.**.**

AllocationId

string

説明

このパラメーターは招待プレビュー中であり、一般公開されていません。

null

Ipv6Sets

object

Ipv6Set

array<object>

ネットワークインターフェース (NIC) に割り当てられている IPv6 アドレスのリスト。

object

ネットワークインターフェース (NIC) に割り当てられている IPv6 アドレス。

Ipv6Address

string

ネットワークインターフェース (NIC) に割り当てられている IPv6 アドレス。

2001:db8:1234:1a00::****

Primary

boolean

Ipv4PrefixSets

object

Ipv4PrefixSet

array<object>

ネットワークインターフェース (NIC) に割り当てられている IPv4 プレフィックスのコレクション。

object

ENI に割り当てられている IPv4 プレフィックス。

Ipv4Prefix

string

ネットワークインターフェースに割り当てられた IPv4 プレフィックス。

192.168.**.0/28

Ipv6PrefixSets

object

Ipv6PrefixSet

array<object>

ネットワークインターフェース (NIC) に割り当てられている IPv6 プレフィックスのコレクション。

object

Ipv6Prefix

string

ネットワークインターフェースに割り当てられた IPv6 プレフィックス。

2001:db8:1234:1a00:****::/80

Tags

object

Tag

array<object>

ネットワークインターフェース (NIC) のタグのコレクション。

object

ネットワークインターフェース (NIC) のタグ情報。

TagValue

string

タグ値。

TestValue

TagKey

string

タグキー

TestKey

BondInterfaceSpecification

object

説明

このパラメーターは招待プレビュー中であり、一般公開されていません。

BondMode

string

説明

このパラメーターは招待プレビュー中であり、一般公開されていません。

null

SlaveInterfaceSpecification

object

SlaveInterfaceSpecificationSet

array<object>

説明

このパラメーターは招待プレビュー中であり、一般公開されていません。

object

説明

このパラメーターは招待プレビュー中であり、一般公開されていません。

SlaveNetworkInterfaceId

string

説明

このパラメーターは招待プレビュー中であり、一般公開されていません。

null

WorkState

string

説明

このパラメーターは招待プレビュー中であり、一般公開されていません。

null

BondNetworkInterfaceId

string

説明

このパラメーターは招待プレビュー中であり、一般公開されていません。

null

SlaveInterfaceSpecification

object

説明

このパラメーターは招待プレビュー中であり、一般公開されていません。

SlaveNetworkInterfaceId

string

説明

このパラメーターは招待プレビュー中であり、一般公開されていません。

null

WorkState

string

説明

このパラメーターは招待プレビュー中であり、一般公開されていません。

null

BondNetworkInterfaceId

string

説明

このパラメーターは招待プレビュー中であり、一般公開されていません。

null

DeleteOnRelease

boolean

関連付けられたインスタンスがリリースされるときに ENI を保持するかどうかを示します。有効な値:

  • true: ENI は保持されません。

  • false: ENI は保持されます。

true

TcpOptionAddressEnabled

string

説明

このパラメーターは招待プレビュー中であり、一般公開されていません。

null

NetworkInterfaceTrafficConfig

object

ネットワークインターフェース (NIC) のトラフィックパラメーター。

NetworkInterfaceTrafficMode

string

ネットワークインターフェース (NIC) の通信モード。

HighPerformance

QueueNumber

integer

ネットワークインターフェース (NIC) のキュー数。

8

QueuePairNumber

integer

RDMA キューペアの数。

8

ConnectionTrackingConfiguration

object

ネットワーク接続性追跡構成情報のコレクション。

このパラメーターを使用する前に、接続タイムアウト管理 を参照してください。

説明

このパラメーターは、Attribute 入力パラメーターが connectionTrackingConfiguration に設定されている場合にのみ返されます。

TcpEstablishedTimeout

integer

ESTABLISHED 状態の TCP 接続のタイムアウト期間。単位: 秒。有効な値: [30, 60, 80, 100, 200, 300, 500, 700, 910]。

910

TcpClosedAndTimeWaitTimeout

integer

TIME_WAIT および CLOSED 状態の TCP 接続のタイムアウト期間。単位: 秒。有効な値: 3 から 15 までの整数。

説明

ECS インスタンスを NLB または CLB と共に使用する場合、TIME_WAIT 状態の接続のデフォルトのタイムアウト期間は 15 秒です。

3

UdpTimeout

integer

UDP フローのタイムアウト期間。単位: 秒。有効な値: [10, 20, 30, 60, 80, 100]。

説明

ECS インスタンスを NLB または CLB と共に使用する場合、デフォルト値は 100 秒です。

30

SourceDestCheck

boolean

このパラメーターは一般公開されていません。

false

EnhancedNetwork

object

このパラメーターは一般公開されていません。

EnableSriov

boolean

このパラメーターは一般公開されていません。

false

EnableRss

boolean

説明

このパラメーターは使用できません。

true

VirtualFunctionTotalQueueNumber

integer

VirtualFunctionQuantity

integer

EnableExpress

boolean

QoSConfig

object

QoS レート制限設定。

EnableQoS

boolean

QoS レート制限が有効かどうかを示します。

QoS

object

QoS レート制限設定。

BandwidthTx

integer

アウトバウンド内部帯域幅制限の最大値。

50000

BandwidthRx

integer

インバウンド内部帯域幅制限の最大値。

50000

PpsTx

integer

アウトバウンド内部ネットワークパケット転送レート。

50000

PpsRx

integer

インバウンド内部ネットワークパケット転送レート。

50000

ConcurrentConnections

integer

セッション数の最大値。

50000

例

成功レスポンス

JSONJSON

{
  "CreationTime": "2019-12-25T12:31:31Z",
  "VpcId": "vpc-bp67acfmxazb4p****",
  "Type": "Secondary",
  "Status": "Available",
  "NetworkInterfaceTrafficMode": "標準",
  "NetworkInterfaceName": "my-eni-name",
  "MacAddress": "00:16:3e:12:**:**",
  "QueuePairNumber": 22,
  "NetworkInterfaceId": "eni-bp125p95hhdhn3ot****",
  "ServiceID": 12345678910,
  "InstanceId": "i-bp1e2l6djkndyuli****",
  "OwnerId": "123456****",
  "ServiceManaged": true,
  "VSwitchId": "vsw-bp1s5fnvk4gn2tws0****",
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "Description": "testDescription",
  "ResourceGroupId": "rg-bp67acfmxazb4p****",
  "ZoneId": "cn-hangzhou-g",
  "PrivateIpAddress": "10.1.**.**",
  "QueueNumber": 8,
  "SecurityGroupIds": {
    "SecurityGroupId": [
      "sg-bp18kz60mefsicfg****"
    ]
  },
  "AssociatedPublicIp": {
    "PublicIpAddress": "116.62.**.**",
    "AllocationId": "null"
  },
  "Attachment": {
    "DeviceIndex": 0,
    "InstanceId": "hide",
    "TrunkNetworkInterfaceId": "hide",
    "MemberNetworkInterfaceIds": {
      "MemberNetworkInterfaceId": [
        "hide"
      ]
    },
    "NetworkCardIndex": 0
  },
  "PrivateIpSets": {
    "PrivateIpSet": [
      {
        "PrivateIpAddress": "172.17.**.**",
        "Primary": true,
        "AssociatedPublicIp": {
          "PublicIpAddress": "116.62.**.**",
          "AllocationId": "null"
        }
      }
    ]
  },
  "Ipv6Sets": {
    "Ipv6Set": [
      {
        "Ipv6Address": "2001:db8:1234:1a00::****",
        "Primary": false
      }
    ]
  },
  "Ipv4PrefixSets": {
    "Ipv4PrefixSet": [
      {
        "Ipv4Prefix": "192.168.**.0/28"
      }
    ]
  },
  "Ipv6PrefixSets": {
    "Ipv6PrefixSet": [
      {
        "Ipv6Prefix": "2001:db8:1234:1a00:****::/80"
      }
    ]
  },
  "Tags": {
    "Tag": [
      {
        "TagValue": "TestValue",
        "TagKey": "TestKey"
      }
    ]
  },
  "BondInterfaceSpecification": {
    "BondMode": "null",
    "SlaveInterfaceSpecification": {
      "SlaveInterfaceSpecificationSet": [
        {
          "SlaveNetworkInterfaceId": "null",
          "WorkState": "null",
          "BondNetworkInterfaceId": "null"
        }
      ]
    }
  },
  "SlaveInterfaceSpecification": {
    "SlaveNetworkInterfaceId": "null",
    "WorkState": "null",
    "BondNetworkInterfaceId": "null"
  },
  "DeleteOnRelease": true,
  "TcpOptionAddressEnabled": "null",
  "NetworkInterfaceTrafficConfig": {
    "NetworkInterfaceTrafficMode": "HighPerformance",
    "QueueNumber": 8,
    "QueuePairNumber": 8
  },
  "ConnectionTrackingConfiguration": {
    "TcpEstablishedTimeout": 910,
    "TcpClosedAndTimeWaitTimeout": 3,
    "UdpTimeout": 30
  },
  "SourceDestCheck": false,
  "EnhancedNetwork": {
    "EnableSriov": false,
    "EnableRss": true,
    "VirtualFunctionTotalQueueNumber": 0,
    "VirtualFunctionQuantity": 0,
    "EnableExpress": false
  },
  "QoSConfig": {
    "EnableQoS": false,
    "QoS": {
      "BandwidthTx": 50000,
      "BandwidthRx": 50000,
      "PpsTx": 50000,
      "PpsRx": 50000,
      "ConcurrentConnections": 50000
    }
  }
}

エラーコード

HTTP ステータスコード

エラーコード

エラーメッセージ

説明

400 MissingParameter %s 必須パラメーターが指定されていません。
400 UnsupportedParameter %s 指定されたパラメーターはサポートされていません。パラメーターが正しいかどうかを確認してください。
400 InvalidParameter %s 現在のリクエストパラメーターは無効です。もう一度お試しください。
400 InvalidInstanceID.Malformed %s
400 Forbidden.RegionId %s 現在、このリージョンではサービスを利用できません。
400 InvalidRegionId.MalFormed The specified parameter RegionId is not valid.
403 InvalidUserType.NotSupported %s ユーザータイプが無効です。
403 Abs.InvalidAccount.NotFound %s アカウントが見つからないか、AccessKey は有効期限切れです。
403 Forbidden.NotSupportRAM %s この操作を実行する主体として、Resource Access Management (RAM) ユーザーはサポートされていません。
403 Forbidden.SubUser %s 現在の RAM ユーザーには、このリソースを操作する権限がありません。
403 InvalidParameter %s
404 InvalidEniId.NotFound %s

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。