DescribeNetworkInterfaceAttribute - Elastic Compute Service

Mengkueri informasi terperinci tentang sebuah ENI berdasarkan ID ENI yang ditentukan.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.
API: API yang dapat Anda panggil untuk melakukan aksi tersebut.
Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.
Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.
- Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.
- Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.
Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.
Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

ecs:DescribeNetworkInterfaceAttribute

get

*NetworkInterface

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

None

Parameter permintaan

Parameter	Type	Required	Description	Example
RegionId	string	Yes	ID region tempat ENI berada. Anda dapat memanggil DescribeRegions untuk mengkueri daftar terbaru region Alibaba Cloud.	cn-hangzhou
Tag	array<object>	No	Catatan Parameter ini belum tersedia untuk umum.
	object	No	Catatan Parameter ini belum tersedia untuk umum.
Key	string	No	Catatan Parameter ini belum tersedia untuk umum.	TestKey
Value	string	No	Catatan Parameter ini belum tersedia untuk umum.	TestValue
RegionId	string	Yes	ID region tempat ENI berada. Anda dapat memanggil DescribeRegions untuk mengkueri daftar terbaru region Alibaba Cloud.	cn-hangzhou
NetworkInterfaceId	string	Yes	ID ENI.	eni-bp67acfmxazb4p****
Attribute	string	No	Atribut ENI. Nilai yang valid: attachment: mengkueri informasi pemasangan ENI anggota dari trunk ENI (parameter ini sedang dalam pratinjau undangan dan belum tersedia untuk umum). connectionTrackingConfiguration: informasi konfigurasi pelacakan koneksi jaringan. Nilai default:	attachment

Elemen respons

Element	Type	Description	Example
	object	Koleksi informasi ENI.
CreationTime	string	Waktu saat ENI dibuat.	2019-12-25T12:31:31Z
VpcId	string	ID VPC tempat ENI berada.	vpc-bp67acfmxazb4p****
Type	string	Tipe ENI. Nilai yang valid: Primary: ENI utama. Secondary: ENI sekunder.	Secondary
Status	string	Status ENI. Nilai yang valid: Available: tersedia. Attaching: sedang dipasang. InUse: terpasang. Detaching: sedang dilepas. Deleting: sedang dihapus. Nilai default: kosong, yang menunjukkan bahwa ENI dalam semua status akan dikueri.	Available
NetworkInterfaceTrafficMode	string	Mode komunikasi ENI. Nilai yang valid: Standard: menggunakan mode komunikasi TCP. HighPerformance: mengaktifkan Elastic RDMA Interface (ERI) dan menggunakan mode komunikasi RDMA. Catatan Nilai HighPerformance hanya didukung oleh keluarga instance c7re yang ditingkatkan dengan RDMA.	Standard
NetworkInterfaceName	string	Nama ENI.	my-eni-name
MacAddress	string	Alamat MAC ENI.	00:16:3e:12::
QueuePairNumber	integer	Catatan Parameter ini sedang dalam pratinjau undangan dan belum tersedia untuk umum.	22
NetworkInterfaceId	string	ID ENI.	eni-bp125p95hhdhn3ot****
ServiceID	integer	ID penyedia layanan yang berkaitan dengan ENI.	12345678910
InstanceId	string	ID instance tempat ENI dipasang. Catatan ENI yang dikelola dan dikontrol oleh layanan Alibaba Cloud lainnya tidak mengembalikan ID instance.	i-bp1e2l6djkndyuli****
OwnerId	string	ID akun pemilik ENI.	123456****
ServiceManaged	boolean	Menunjukkan apakah pengguna ENI adalah layanan cloud atau penyedia layanan.	true
VSwitchId	string	ID vSwitch tempat ENI berada.	vsw-bp1s5fnvk4gn2tws0****
RequestId	string	ID permintaan.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****
Description	string	Deskripsi ENI.	testDescription
ResourceGroupId	string	ID grup sumber daya enterprise tempat instance berada. Saat Anda menggunakan parameter ini untuk memfilter sumber daya, jumlah sumber daya tidak boleh melebihi 1.000. Catatan Pemfilteran berdasarkan grup sumber daya default tidak didukung.	rg-bp67acfmxazb4p****
ZoneId	string	ID zona.	cn-hangzhou-g
PrivateIpAddress	string	Alamat IP privat ENI.	10.1..
QueueNumber	integer	Jumlah antrian ENI. Jika ENI adalah ENI utama: mengembalikan jumlah default antrian ENI utama untuk tipe instance. Jika ENI adalah ENI sekunder: Jika ENI sekunder dalam status terpasang (InUse): Jika jumlah antrian ENI sekunder belum dimodifikasi, jumlah default antrian ENI sekunder untuk tipe instance dikembalikan. Jika jumlah antrian ENI sekunder telah dimodifikasi, jumlah antrian yang dimodifikasi dikembalikan. Jika ENI sekunder dalam status tersedia (Available): Jika jumlah antrian ENI sekunder belum dimodifikasi, nilai kosong dikembalikan. Jika jumlah antrian ENI sekunder telah dimodifikasi, jumlah antrian yang dimodifikasi dikembalikan.	8
SecurityGroupIds	object
SecurityGroupId	array	Koleksi grup keamanan tempat ENI berada.
	string	Grup keamanan tempat ENI berada.	sg-bp18kz60mefsicfg****
AssociatedPublicIp	object	Alamat IP elastis (EIP) yang terkait dengan alamat IP privat sekunder ENI.
PublicIpAddress	string	Alamat IP elastis (EIP).	116.62..
AllocationId	string	ID EIP.	null
Attachment	object	Catatan Parameter ini sedang dalam pratinjau undangan dan belum tersedia untuk umum.
DeviceIndex	integer	Catatan Parameter ini sedang dalam pratinjau undangan dan belum tersedia untuk umum.	hide
InstanceId	string	Catatan Parameter ini sedang dalam pratinjau undangan dan belum tersedia untuk umum.	hide
TrunkNetworkInterfaceId	string	Catatan Parameter ini sedang dalam pratinjau undangan dan belum tersedia untuk umum.	hide
MemberNetworkInterfaceIds	object
MemberNetworkInterfaceId	array	Catatan This parameter is in invitational preview and unavailable for general users.
	string	Catatan This parameter is in invitational preview and unavailable for general users.	hide
NetworkCardIndex	integer	Indeks kartu jaringan fisik yang ditentukan saat ENI dipasang. Jika ENI dalam status tidak terpasang (Available) atau tidak ada indeks yang ditentukan saat pemasangan, nilai ini tidak dikembalikan. Jika ENI dalam status terpasang (InUse) dan indeks ditentukan saat pemasangan, nilai ini menunjukkan indeks kartu jaringan fisik yang ditentukan saat ENI dipasang.	0
PrivateIpSets	object
PrivateIpSet	array<object>	Koleksi informasi alamat IP privat ENI.
	array<object>	Informasi alamat IP privat ENI.
PrivateIpAddress	string	The private IP address of the ENI.	172.17..
Primary	boolean	Indicates whether the IP address is the primary private IP address. Valid values: true: The IP address is the primary private IP address. false: The IP address is a secondary private IP address.	true
AssociatedPublicIp	object	The EIP that is associated with the secondary private IP address of the ENI.
PublicIpAddress	string	The EIP.	116.62..
AllocationId	string	Catatan This parameter is in invitational preview and is not publicly available.	null
Ipv6Sets	object
Ipv6Set	array<object>	Daftar alamat IPv6 yang ditetapkan ke ENI.
	object	Alamat IPv6 yang ditetapkan ke ENI.
Ipv6Address	string	The IPv6 address of the ENI.	2001:db8:1234:1a00::****
Ipv4PrefixSets	object
Ipv4PrefixSet	array<object>	Koleksi prefiks IPv4 yang ditetapkan ke ENI.
	object	Prefiks IPv4 yang ditetapkan.
Ipv4Prefix	string	The IPv4 prefix of the ENI.	192.168.**.0/28
Ipv6PrefixSets	object
Ipv6PrefixSet	array<object>	Koleksi prefiks IPv6 yang ditetapkan ke ENI.
	object
Ipv6Prefix	string	The IPv6 prefix of the ENI.	2001:db8:1234:1a00:****::/80
Tags	object
Tag	array<object>	Koleksi tag ENI.
	object	Informasi tag ENI.
TagValue	string	The tag value of the ENI.	TestValue
TagKey	string	The tag key of the ENI.	TestKey
BondInterfaceSpecification	object	Catatan Parameter ini sedang dalam pratinjau undangan dan belum tersedia untuk umum.
BondMode	string	Catatan Parameter ini sedang dalam pratinjau undangan dan belum tersedia untuk umum.	null
SlaveInterfaceSpecification	object
SlaveInterfaceSpecificationSet	array<object>	Catatan This parameter is in invitational preview and unavailable for general users.
	object	Catatan This parameter is in invitational preview and unavailable for general users.
SlaveNetworkInterfaceId	string	Catatan This parameter is in invitational preview and is not publicly available.	null
WorkState	string	Catatan This parameter is in invitational preview and is not publicly available.	null
BondNetworkInterfaceId	string	Catatan This parameter is in invitational preview and is not publicly available.	null
SlaveInterfaceSpecification	object	Catatan Parameter ini sedang dalam pratinjau undangan dan belum tersedia untuk umum.
SlaveNetworkInterfaceId	string	Catatan Parameter ini sedang dalam pratinjau undangan dan belum tersedia untuk umum.	null
WorkState	string	Catatan Parameter ini sedang dalam pratinjau undangan dan belum tersedia untuk umum.	null
BondNetworkInterfaceId	string	Catatan Parameter ini sedang dalam pratinjau undangan dan belum tersedia untuk umum.	null
DeleteOnRelease	boolean	Menunjukkan apakah akan mempertahankan ENI ketika instance dilepaskan. Nilai yang valid: true: tidak dipertahankan. false: dipertahankan.	true
TcpOptionAddressEnabled	string	Catatan Parameter ini sedang dalam pratinjau undangan dan belum tersedia untuk umum.	null
NetworkInterfaceTrafficConfig	object	Parameter komunikasi ENI.
NetworkInterfaceTrafficMode	string	Mode komunikasi ENI.	HighPerformance
QueueNumber	integer	Jumlah antrian ENI.	8
QueuePairNumber	integer	Jumlah antrian kartu jaringan RDMA.	8
ConnectionTrackingConfiguration	object	Koleksi informasi konfigurasi pelacakan koneksi jaringan. Sebelum Anda menggunakan parameter ini, baca dengan cermat Manajemen waktu habis koneksi. Catatan Parameter ini dikembalikan hanya ketika parameter permintaan `Attribute` diatur ke `connectionTrackingConfiguration`.
TcpEstablishedTimeout	integer	Periode waktu habis untuk koneksi TCP yang telah dibuat. Satuan: detik (s). Nilai yang valid: [30, 60, 80, 100, 200, 300, 500, 700, 910].	910
TcpClosedAndTimeWaitTimeout	integer	Periode waktu habis untuk koneksi TCP close dan TIME_WAIT. Satuan: detik (s). Nilai yang valid: bilangan bulat dari 3 hingga 15. Catatan Jika instance ECS Anda digunakan bersama NLB/CLB, waktu habis default untuk koneksi dalam status `TIME_WAIT` adalah 15 detik.	3
UdpTimeout	integer	Periode waktu habis untuk aliran UDP. Satuan: detik (s). Nilai yang valid: [10, 20, 30, 60, 80, 100]. Catatan Jika instance ECS Anda digunakan bersama NLB/CLB, nilai default adalah 100 detik.	30
SourceDestCheck	boolean	Parameter ini belum tersedia untuk umum.	false
EnhancedNetwork	object	Parameter ini belum tersedia untuk umum.
EnableSriov	boolean	Parameter ini belum tersedia untuk umum.	false
EnableRss	boolean	Catatan Parameter ini belum tersedia untuk umum.	true
VirtualFunctionTotalQueueNumber	integer
VirtualFunctionQuantity	integer
QoSConfig	object	Pengaturan pembatasan kecepatan QoS.
EnableQoS	boolean	Menunjukkan apakah pengaturan pembatasan kecepatan QoS diaktifkan.
QoS	object	Pengaturan pembatasan kecepatan QoS.
BandwidthTx	integer	Maximum outbound internal bandwidth	50000
BandwidthRx	integer	maximum inbound internal bandwidth	50000
PpsTx	integer	Outbound packet forwarding rate over the internal network	50000
PpsRx	integer	Inbound packet forwarding rate over the internal network	50000
ConcurrentConnections	integer	Maximum number of sessions	50000

Contoh

Respons sukses

JSONformat

{
  "CreationTime": "2019-12-25T12:31:31Z",
  "VpcId": "vpc-bp67acfmxazb4p****",
  "Type": "Secondary",
  "Status": "Available",
  "NetworkInterfaceTrafficMode": "Standard",
  "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::****"
      }
    ]
  },
  "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
  },
  "QoSConfig": {
    "EnableQoS": false,
    "QoS": {
      "BandwidthTx": 50000,
      "BandwidthRx": 50000,
      "PpsTx": 50000,
      "PpsRx": 50000,
      "ConcurrentConnections": 50000
    }
  }
}

Kode kesalahan

HTTP status code	Error code	Error message
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
403	Forbidden.NotSupportRAM	%s
403	Forbidden.SubUser	%s
403	InvalidParameter	%s
404	InvalidEniId.NotFound	%s

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.